# Operations resource
Operations represents an asynchronous request that creates one or more resources, such as sending a message to multiple recipients. When you submit a Send Messages request, the API returns an `operationId` that you can use to monitor the status and progress of the operation.
## Operation Properties
## Fetch a Message Operation
`GET https://comms.twilio.com/v1/Messages/Operations/{operationId}`
Retrieve an Operation by its ID, including its current status and aggregate delivery statistics.
### Path parameters
```json
[{"schema":{"x-twilio-version":1,"description":"The Operation ID is an identifier that can be used to correlate all of the\nresources created in a request.\n\nIssue a GET request to the resource list location, using the Operation ID as a query parameter\nto retrieve the resources that correlate with the Operation.","title":"OperationId","type":"string","pattern":"^comms_operation_[0-7][a-hjkmnpqrstv-z0-9]{25,34}","example":"comms_operation_01h9krwprkeee8fzqspvwy6nq8","refName":"OperationId","modelName":""},"name":"operationId","in":"path","required":true,"x-twilio-version":1}]
```
### Responses
Fetch a Message Operation
```ts
import { TwilioClient } from "twilio-comms";
async function main() {
const client = new TwilioClient({
accountId: "TWILIO_ACCOUNT_SID",
authToken: "TWILIO_AUTH_TOKEN",
});
await client.messages.fetchOperation("comms_operation_01h9krwprkeee8fzqspvwy6nq8");
}
main();
```
```py
from twilio_comms import TwilioComms
client = TwilioComms(
account_id="TWILIO_ACCOUNT_SID",
auth_token="TWILIO_AUTH_TOKEN",
)
client.messages.fetch_operation(
operation_id="comms_operation_01h9krwprkeee8fzqspvwy6nq8",
)
```
```cs
using Twilio.Comms;
using System.Threading.Tasks;
public partial class Examples
{
public async Task Example() {
var client = new TwilioComms(
accountId: "TWILIO_ACCOUNT_SID",
authToken: "TWILIO_AUTH_TOKEN"
);
await client.Messages.FetchOperationAsync(
"comms_operation_01h9krwprkeee8fzqspvwy6nq8"
);
}
}
```
```java
package com.example.usage;
import com.twilio.sdk.TwilioComms;
public class Example {
public static void main(String[] args) {
TwilioComms client = TwilioComms
.builder()
.credentials("TWILIO_ACCOUNT_SID", "TWILIO_AUTH_TOKEN")
.build();
client.messages().fetchOperation("comms_operation_01h9krwprkeee8fzqspvwy6nq8");
}
}
```
```go
package example
import (
context "context"
client "github.com/twilio/twilio-comms-go/twilio/client"
option "github.com/twilio/twilio-comms-go/twilio/option"
)
func do() {
client := client.NewWithOptions(
option.WithBasicAuth(
"TWILIO_ACCOUNT_SID",
"TWILIO_AUTH_TOKEN",
),
)
client.Messages.FetchOperation(
context.TODO(),
"comms_operation_01h9krwprkeee8fzqspvwy6nq8",
)
}
```
```php
messages->fetchOperation(
'comms_operation_01h9krwprkeee8fzqspvwy6nq8',
);
```
```rb
require "twiliocomms"
client = TwilioComms::Client.new(
account_id: "TWILIO_ACCOUNT_SID",
auth_token: "TWILIO_AUTH_TOKEN"
)
client.messages.fetch_operation(operation_id: "comms_operation_01h9krwprkeee8fzqspvwy6nq8")
```
```bash
curl -X GET "https://comms.twilio.com/v1/Messages/Operations/comms_operation_01h9krwprkeee8fzqspvwy6nq8" \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```
## List Message Operations
`GET https://comms.twilio.com/v1/Messages/Operations`
Retrieve a list of Operations. Use query parameters to filter results by status and date range.
### Query parameters
```json
[{"in":"query","name":"startDate","description":"Filter to Operations created after the specified date and time in ISO 8601 format.","x-twilio-version":1,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"endDate","description":"Filter to Operations created before the specified date and time in ISO 8601 format.","x-twilio-version":1,"schema":{"type":"string","format":"date-time"}},{"in":"query","name":"status","description":"Filter to Operations with the specified status.","x-twilio-version":1,"schema":{"x-twilio-version":1,"title":"CommunicationOperationStatus","type":"string","description":"The status of an Operation.","enum":["SCHEDULED","PROCESSING","COMPLETED","CANCELED"],"refName":"CommunicationOperationStatus","modelName":"CommunicationOperationStatus"}},{"in":"query","name":"pageToken","description":"The token to retrieve the next page of results.","x-twilio-version":1,"schema":{"x-twilio-version":1,"description":"The token that identifies the page of resources to fetch.","title":"PageToken","type":"string","refName":"PageToken","modelName":""}},{"in":"query","name":"pageSize","description":"The number of resources to return in a page.","x-twilio-version":1,"schema":{"x-twilio-version":1,"description":"Total number of items returned in a single page, the minimum is 1 and maximum is 1000. Default is 50.","title":"PageSize","type":"integer","minimum":1,"maximum":1000,"default":50,"example":50,"refName":"PageSize","modelName":""}}]
```
### Responses
List Message Operations
```ts
import { TwilioClient } from "twilio-comms";
async function main() {
const client = new TwilioClient({
accountId: "TWILIO_ACCOUNT_SID",
authToken: "TWILIO_AUTH_TOKEN",
});
await client.messages.listOperations({
startDate: new Date("2024-01-15T09:30:00Z"),
endDate: new Date("2024-01-15T09:30:00Z"),
status: "SCHEDULED",
pageToken: "pageToken",
pageSize: 50,
});
}
main();
```
```py
from twilio_comms import TwilioComms
import datetime
client = TwilioComms(
account_id="TWILIO_ACCOUNT_SID",
auth_token="TWILIO_AUTH_TOKEN",
)
client.messages.list_operations(
start_date=datetime.datetime.fromisoformat("2024-01-15T09:30:00+00:00"),
end_date=datetime.datetime.fromisoformat("2024-01-15T09:30:00+00:00"),
status="SCHEDULED",
page_token="pageToken",
page_size=50,
)
```
```cs
using Twilio.Comms;
using System.Threading.Tasks;
using System;
using System.Globalization;
public partial class Examples
{
public async Task Example() {
var client = new TwilioComms(
accountId: "TWILIO_ACCOUNT_SID",
authToken: "TWILIO_AUTH_TOKEN"
);
await client.Messages.ListOperationsAsync(
new MessagesListOperationsRequest {
StartDate = DateTime.Parse("2024-01-15T09:30:00Z", null, DateTimeStyles.AdjustToUniversal),
EndDate = DateTime.Parse("2024-01-15T09:30:00Z", null, DateTimeStyles.AdjustToUniversal),
Status = CommunicationOperationStatus.Scheduled,
PageToken = "pageToken",
PageSize = 50
}
);
}
}
```
```java
package com.example.usage;
import com.twilio.sdk.TwilioComms;
import com.twilio.sdk.resources.messages.requests.MessagesListOperationsRequest;
import com.twilio.sdk.types.CommunicationOperationStatus;
import java.time.OffsetDateTime;
public class Example {
public static void main(String[] args) {
TwilioComms client = TwilioComms
.builder()
.credentials("TWILIO_ACCOUNT_SID", "TWILIO_AUTH_TOKEN")
.build();
client.messages().listOperations(
MessagesListOperationsRequest
.builder()
.startDate(OffsetDateTime.parse("2024-01-15T09:30:00Z"))
.endDate(OffsetDateTime.parse("2024-01-15T09:30:00Z"))
.status(CommunicationOperationStatus.SCHEDULED)
.pageToken("pageToken")
.pageSize(50)
.build()
);
}
}
```
```go
package example
import (
context "context"
twiliocomms "github.com/twilio/twilio-comms-go/twilio"
client "github.com/twilio/twilio-comms-go/twilio/client"
option "github.com/twilio/twilio-comms-go/twilio/option"
)
func do() {
client := client.NewWithOptions(
option.WithBasicAuth(
"TWILIO_ACCOUNT_SID",
"TWILIO_AUTH_TOKEN",
),
)
request := &twiliocomms.MessagesListOperationsRequest{
StartDate: twiliocomms.Time(
twiliocomms.MustParseDateTime(
"2024-01-15T09:30:00Z",
),
),
EndDate: twiliocomms.Time(
twiliocomms.MustParseDateTime(
"2024-01-15T09:30:00Z",
),
),
Status: twiliocomms.CommunicationOperationStatusScheduled.Ptr(),
PageToken: twiliocomms.String(
"pageToken",
),
PageSize: twiliocomms.Int(
50,
),
}
client.Messages.ListOperations(
context.TODO(),
request,
)
}
```
```php
messages->listOperations(
new MessagesListOperationsRequest([
'startDate' => new DateTime('2024-01-15T09:30:00Z'),
'endDate' => new DateTime('2024-01-15T09:30:00Z'),
'status' => CommunicationOperationStatus::Scheduled->value,
'pageToken' => 'pageToken',
'pageSize' => 50,
]),
);
```
```rb
require "twiliocomms"
client = TwilioComms::Client.new(
account_id: "TWILIO_ACCOUNT_SID",
auth_token: "TWILIO_AUTH_TOKEN"
)
client.messages.list_operations(
start_date: "2024-01-15T09:30:00Z",
end_date: "2024-01-15T09:30:00Z",
status: "SCHEDULED",
page_token: "pageToken",
page_size: 50
)
```
```bash
curl -X GET "https://comms.twilio.com/v1/Messages/Operations?startDate=2024-01-15&endDate=2024-01-15&status=SCHEDULED&pageToken=pageToken&pageSize=50" \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```