# Operations resource
> \[!IMPORTANT]
>
> The Push Notifications API is currently available as a
> Private Beta product. The information contained in this document is subject to change. You acknowledge
> and agree that your use of the Twilio Push Notifications API is subject to the terms of the [Services in
> Private Beta](https://www.twilio.com/en-us/legal/service-country-specific-terms/private-beta). This
> means that some features are not yet implemented and others may be changed before the product is
> declared as Generally Available. Private Beta products are not covered by the Twilio Support Terms or
> Twilio Service Level Agreement.
An Operation resource represents a push notification request that targets one or more recipients. When you [send a notification](/docs/push-notifications/api/notification-resource#send-a-notification), the API validates the input and returns an HTTP `202 Accepted` response with an `operationId` in the response body. Use the `operationId` to monitor the status and delivery progress of the request.
As the Operation is processed, it generates a [PushNotification](/docs/push-notifications/api/notification-resource) with an associated `pushNotificationId` for each recipient. Each PushNotification then creates at least one delivery attempt for each provider (FCM or APNs) that is tried.
> \[!NOTE]
>
> Records are available for 7 days after creation. Requests for data older than 7 days may return incomplete results.
## Operation Properties
## Operation status values
| Status | Description |
| ------------ | ------------------------------------------------------- |
| `SCHEDULED` | The operation is scheduled for future processing. |
| `PROCESSING` | The operation is currently being processed. |
| `COMPLETED` | All notifications in the operation have been processed. |
| `CANCELED` | The operation was canceled. |
## Operation stats
The `stats` object in the response provides aggregated delivery metrics:
| Field | Description |
| --------------- | -------------------------------------------- |
| `total` | Total push notifications in the operation. |
| `recipients` | Total targeted recipients. |
| `unaddressable` | Recipients with no valid device token found. |
| `scheduled` | Notifications scheduled for future sending. |
| `queued` | Notifications queued for sending. |
| `sent` | Notifications sent to the provider. |
| `failed` | Notifications that failed during processing. |
| `canceled` | Notifications canceled via the API. |
## Fetch an Operation
`GET https://comms.twilio.com/v1/PushNotifications/Operations/{operationId}`
Retrieve the status and delivery statistics of a push notification operation by making an HTTP `GET` request to the Operation resource URI with the Operation ID.
### 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":""},"x-twilio-version":1,"name":"operationId","in":"path","required":true}]
```
### Responses
Fetch a PushNotification Operation
```ts
import { TwilioClient } from "twilio-comms";
async function main() {
const client = new TwilioClient({
accountId: "",
authToken: "",
});
await client.pushNotifications.fetchOperation("comms_operation_01h9krwprkeee8fzqspvwy6nq8");
}
main();
```
```py
from twilio import TwilioComms
client = TwilioComms(
account_id="",
auth_token="",
)
client.push_notifications.fetch_operation(
operation_id="comms_operation_01h9krwprkeee8fzqspvwy6nq8",
)
```
```cs
using TwilioComms;
using System.Threading.Tasks;
public partial class Examples
{
public async Task Example() {
var client = new TwilioCommsClient(
accountId: "",
authToken: ""
);
await client.PushNotifications.FetchOperationAsync(
"comms_operation_01h9krwprkeee8fzqspvwy6nq8"
);
}
}
```
```java
package com.example.usage;
import com.twilio.comms.TwilioCommsClient;
public class Example {
public static void main(String[] args) {
TwilioCommsClient client = TwilioCommsClient
.builder()
.credentials("", "")
.build();
client.pushNotifications().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(
"",
"",
),
)
client.PushNotifications.FetchOperation(
context.TODO(),
"comms_operation_01h9krwprkeee8fzqspvwy6nq8",
)
}
```
```php
',
authToken: '',
);
$client->pushNotifications->fetchOperation(
'comms_operation_01h9krwprkeee8fzqspvwy6nq8',
);
```
```rb
require "twilio"
client = Twilio::Client.new(
account_id: "",
auth_token: ""
)
client.push_notifications.fetch_operation(operation_id: "comms_operation_01h9krwprkeee8fzqspvwy6nq8")
```
```bash
curl 'https://comms.twilio.com/v1/PushNotifications/Operations/{operationId}' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```
## List Operations
`GET https://comms.twilio.com/v1/PushNotifications/Operations`
Returns a list of Operations. You can filter by date range or status.
### Query parameters
```json
[{"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":""}},{"in":"query","name":"startDate","description":"Filter to Operations created after the specified date and time.","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"endDate","description":"Filter to Operations created before the specified date and time.","schema":{"type":"string","format":"date-time"}},{"in":"query","name":"status","description":"Filter to Operations with the specified status.","schema":{"x-twilio-version":1,"title":"CommunicationOperationStatus","type":"string","description":"The status of an Operation.","enum":["SCHEDULED","PROCESSING","COMPLETED","CANCELED"],"refName":"CommunicationOperationStatus","modelName":"CommunicationOperationStatus"}}]
```
### Responses
List PushNotification Operations
```ts
import { TwilioClient } from "twilio-comms";
async function main() {
const client = new TwilioClient({
accountId: "",
authToken: "",
});
await client.pushNotifications.listOperations({
pageToken: "pageToken",
pageSize: 50,
startDate: new Date("2024-01-15T09:30:00Z"),
endDate: new Date("2024-01-15T09:30:00Z"),
status: "SCHEDULED",
});
}
main();
```
```py
from twilio import TwilioComms
import datetime
client = TwilioComms(
account_id="",
auth_token="",
)
client.push_notifications.list_operations(
page_token="pageToken",
page_size=50,
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",
)
```
```cs
using TwilioComms;
using System.Threading.Tasks;
using System;
using System.Globalization;
public partial class Examples
{
public async Task Example() {
var client = new TwilioCommsClient(
accountId: "",
authToken: ""
);
await client.PushNotifications.ListOperationsAsync(
new PushNotificationsListOperationsRequest {
PageToken = "pageToken",
PageSize = 50,
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
}
);
}
}
```
```java
package com.example.usage;
import com.twilio.comms.TwilioCommsClient;
import com.twilio.comms.resources.pushnotifications.requests.PushNotificationsListOperationsRequest;
import com.twilio.comms.types.CommunicationOperationStatus;
import java.time.OffsetDateTime;
public class Example {
public static void main(String[] args) {
TwilioCommsClient client = TwilioCommsClient
.builder()
.credentials("", "")
.build();
client.pushNotifications().listOperations(
PushNotificationsListOperationsRequest
.builder()
.pageToken("pageToken")
.pageSize(50)
.startDate(OffsetDateTime.parse("2024-01-15T09:30:00Z"))
.endDate(OffsetDateTime.parse("2024-01-15T09:30:00Z"))
.status(CommunicationOperationStatus.SCHEDULED)
.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(
"",
"",
),
)
request := &twiliocomms.PushNotificationsListOperationsRequest{
PageToken: twiliocomms.String(
"pageToken",
),
PageSize: twiliocomms.Int(
50,
),
StartDate: twiliocomms.Time(
twiliocomms.MustParseDateTime(
"2024-01-15T09:30:00Z",
),
),
EndDate: twiliocomms.Time(
twiliocomms.MustParseDateTime(
"2024-01-15T09:30:00Z",
),
),
Status: twiliocomms.CommunicationOperationStatusScheduled.Ptr(),
}
client.PushNotifications.ListOperations(
context.TODO(),
request,
)
}
```
```php
',
authToken: '',
);
$client->pushNotifications->listOperations(
new PushNotificationsListOperationsRequest([
'pageToken' => 'pageToken',
'pageSize' => 50,
'startDate' => new DateTime('2024-01-15T09:30:00Z'),
'endDate' => new DateTime('2024-01-15T09:30:00Z'),
'status' => CommunicationOperationStatus::Scheduled->value,
]),
);
```
```rb
require "twilio"
client = Twilio::Client.new(
account_id: "",
auth_token: ""
)
client.push_notifications.list_operations(
page_token: "pageToken",
page_size: 50,
start_date: "2024-01-15T09:30:00Z",
end_date: "2024-01-15T09:30:00Z",
status: "SCHEDULED"
)
```
```bash
curl 'https://comms.twilio.com/v1/PushNotifications/Operations?pageSize=50' \
-u $TWILIO_ACCOUNT_SID:$TWILIO_AUTH_TOKEN
```