Sign in

v1

latestOpenAPI 3.0.3RingCentral API License Agreement2026-08-064871,2921.5 MB
High Volume SMS

List A2P SMS Statuses

Retrieves a set of message counts by message status and error codes filtered by dates, batchId and message direction.

get/restapi/v1.0/account/{accountId}/a2p-sms/statuses

Path parameters

accountIdstring required

Internal identifier of the RingCentral account (can be set to "~" to indicate that the account associated with current authorization session should be used)

Query parameters

batchIdstring

Internal identifier of a message batch to filter the response

direction'Inbound' | 'Outbound'

Direction of the SMS message

Direction of a message to filter the message list result. By default, there is no filter applied - both Inbound and Outbound messages are returned

dateFromstring date-time

The end of the time range to filter the results in ISO 8601 format including timezone. Default is the 'dateTo' minus 24 hours

dateTostring date-time

The end of the time range to filter the results in ISO 8601 format including timezone. Default is the current time

phoneNumberstring[]

List of phone numbers (specified in 'to' or 'from' fields of a message) to filter the results. Maximum number of phone numbers allowed to be specified as filters is 15

Response

The statuses of the messages sent by the account filtered by criteria specified in the query

Example response

{
  "queued": {
    "count": 7
  },
  "delivered": {
    "count": 7
  },
  "deliveryFailed": {
    "count": 7
  },
  "sent": {
    "count": 7
  },
  "sendingFailed": {
    "count": 7
  }
}