---
title: "List all SMS notifications"
method: GET
path: "/ext/v2/sms-notifications/"
tags: ["Inbox"]
---

# List all SMS notifications

`GET /ext/v2/sms-notifications/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/sms-notifications/`
- Auth: HTTP bearer

Returns a list of all SMS notifications across all clinics in the organization. The notifications are sorted by creation date, with the most recent appearing first.

An **SMS notification** represents a text message sent to a clinic client's primary phone number on behalf of a clinic via the API.

Only SMS notifications initiated through the API are included in this resource. Transactional notifications sent automatically by Vetcove (e.g. order confirmations, appointment reminders) are not returned.

## Query parameters

- `ids` integer[], nullable: When provided, filters to objects with these IDs.
- `ending_before` integer, nullable: A cursor used for pagination. Fetches the page of results ending immediately before the object with the given ID. Cannot be used at the same time as `starting_after`.
- `starting_after` integer, nullable: A cursor used for pagination. Fetches the page of results starting immediately after the given ID. Cannot be used at the same time as `ending_before`.
- `limit` integer: The maximum number of items to return per page.
- `cursor` string, nullable: A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__gte` string, date-time, nullable: Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `modified__lte` string, date-time, nullable: Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters.
- `clinic_id` integer, nullable: Filters to SMS notifications for the clinic with this ID. At least one of `clinic_id` or `clinic_client_id` is required.
- `clinic_client_id` integer, nullable: Filters to SMS notifications for the clinic client with this ID. At least one of `clinic_id` or `clinic_client_id` is required.

## Response `200`

OK

- ExternalSmsNotificationSchemaList
  - `data` ExternalSmsNotificationSchema[], required: A single page of data contained within this list.
    - `body` string, required: The SMS message body.
    - `client_communication_number_id` integer, required: The ID of the client communication number the SMS was sent to.
    - `clinic_client_id` integer, required: The ID of the clinic client the SMS was sent to.
    - `clinic_id` integer, required: The ID of the clinic the SMS was sent from.
    - `created_at` string, date-time, required: When the SMS notification was created.
    - `error_code` string, nullable, required: Error code from the SMS provider if sending failed.
    - `error_reason` string, nullable, required: Human-readable reason for the error, if the error code is recognized.
    - `id` integer, required: The ID of the SMS notification.
    - `status` 'SENT' | 'DELIVERED' | 'FAILED_TO_SEND', required: Delivery status of an SMS notification sent via the Connect API.
  - `has_more` boolean: Whether there are more pages or data in this list.
  - `next_page` string, required: A URL linking to the next page of this list.
  - `type` string: Type of this object. Always `list`.

---

[API](https://skmtc.dev/vetcove/apis/ninjaapi.md) - [All operations](https://skmtc.dev/vetcove/apis/ninjaapi/llms.txt) - [OpenAPI document](https://skmtc.dev/vetcove/apis/ninjaapi/revisions/4ceaed956e15?raw)