---
title: "List A2P SMS Statuses"
method: GET
path: "/restapi/v1.0/account/{accountId}/a2p-sms/statuses"
tags: ["High Volume SMS"]
---

# List A2P SMS Statuses

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

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

## Path parameters

- `accountId` string, required

## Query parameters

- `batchId` string
- `direction` 'Inbound' | 'Outbound' — Direction of the SMS message
- `dateFrom` string, date-time
- `dateTo` string, date-time
- `phoneNumber` string[]

## Response `200`

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

- MessageStatusesResponse — The messages status object with details of each status
  - `queued` MessageStatusCounts — Message status parameters
    - `cost` number, float — Total cost of all messages with this status code
    - `count` integer — Count of messages with this status code
    - `errorCodeCounts` object — Message sending/delivery errors. Returned in `deliveryFailed` and `sendingFailed` resources
  - `delivered` MessageStatusCounts — Message status parameters
    - `cost` number, float — Total cost of all messages with this status code
    - `count` integer — Count of messages with this status code
    - `errorCodeCounts` object — Message sending/delivery errors. Returned in `deliveryFailed` and `sendingFailed` resources
  - `deliveryFailed` MessageStatusCounts — Message status parameters
    - `cost` number, float — Total cost of all messages with this status code
    - `count` integer — Count of messages with this status code
    - `errorCodeCounts` object — Message sending/delivery errors. Returned in `deliveryFailed` and `sendingFailed` resources
  - `sent` MessageStatusCounts — Message status parameters
    - `cost` number, float — Total cost of all messages with this status code
    - `count` integer — Count of messages with this status code
    - `errorCodeCounts` object — Message sending/delivery errors. Returned in `deliveryFailed` and `sendingFailed` resources
  - `sendingFailed` MessageStatusCounts — Message status parameters
    - `cost` number, float — Total cost of all messages with this status code
    - `count` integer — Count of messages with this status code
    - `errorCodeCounts` object — Message sending/delivery errors. Returned in `deliveryFailed` and `sendingFailed` resources

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — No resource found for the account
- `500` — Service Unavailable

---

[API](https://skmtc.net/ringcentral/apis/ringcentral-api.md) · [All operations](https://skmtc.net/ringcentral/apis/ringcentral-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ringcentral/ringcentral-api/revisions/8d602198ec97/schema)