> ## Documentation Index > Fetch the complete documentation index at: https://developer.vetcove.com/llms.txt > Use this file to discover all available pages before exploring further. # List all SMS notifications > 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. ## OpenAPI ````yaml get /ext/v2/sms-notifications/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/sms-notifications/: get: tags: - Inbox summary: List all SMS notifications description: >- 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. operationId: sms_notifications_list parameters: - description: When provided, filters to objects with these IDs. in: query name: ids required: false schema: anyOf: - items: type: integer type: array - type: 'null' description: When provided, filters to objects with these IDs. title: Ids - description: >- 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`. in: query name: ending_before required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Ending Before - description: >- 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`. in: query name: starting_after required: false schema: anyOf: - type: integer - type: 'null' description: >- 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`. title: Starting After - description: The maximum number of items to return per page. in: query name: limit required: false schema: default: 10 description: The maximum number of items to return per page. maximum: 100 minimum: 1 title: Limit type: integer - description: >- 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. in: query name: cursor required: false schema: anyOf: - type: string - type: 'null' description: >- 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. title: Cursor - description: >- 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. in: query name: modified__gte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- 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. title: Modified Gte - description: >- 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. in: query name: modified__lte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- 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. title: Modified Lte - description: >- Filters to SMS notifications for the clinic with this ID. At least one of `clinic_id` or `clinic_client_id` is required. in: query name: clinic_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filters to SMS notifications for the clinic with this ID. At least one of `clinic_id` or `clinic_client_id` is required. title: Clinic Id - description: >- Filters to SMS notifications for the clinic client with this ID. At least one of `clinic_id` or `clinic_client_id` is required. in: query name: clinic_client_id required: false schema: anyOf: - type: integer - type: 'null' description: >- Filters to SMS notifications for the clinic client with this ID. At least one of `clinic_id` or `clinic_client_id` is required. title: Clinic Client Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExternalSmsNotificationSchemaList' description: OK security: - ExternalAPIAuth: [] components: schemas: ExternalSmsNotificationSchemaList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalSmsNotificationSchema' title: Data type: array has_more: default: false description: Whether there are more pages or data in this list. title: Has More type: boolean next_page: description: A URL linking to the next page of this list. title: Next Page type: string type: default: list description: Type of this object. Always `list`. title: Type type: string required: - data - next_page title: ExternalSmsNotificationSchemaList type: object ExternalSmsNotificationSchema: properties: body: description: The SMS message body. title: Body type: string client_communication_number_id: description: The ID of the client communication number the SMS was sent to. title: Client Communication Number Id type: integer clinic_client_id: description: The ID of the clinic client the SMS was sent to. title: Clinic Client Id type: integer clinic_id: description: The ID of the clinic the SMS was sent from. title: Clinic Id type: integer created_at: description: When the SMS notification was created. format: date-time title: Created At type: string error_code: anyOf: - type: string - type: 'null' description: Error code from the SMS provider if sending failed. title: Error Code error_reason: anyOf: - type: string - type: 'null' description: >- Human-readable reason for the error, if the error code is recognized. title: Error Reason id: description: The ID of the SMS notification. title: Id type: integer status: $ref: '#/components/schemas/ExternalSmsNotificationStatus' description: |- The delivery status of the SMS. - `SENT`: Message was sent but delivery is not yet confirmed. - `DELIVERED`: Message was successfully delivered. - `FAILED_TO_SEND`: Message failed to send. required: - id - clinic_client_id - client_communication_number_id - clinic_id - body - status - created_at - error_code - error_reason title: ExternalSmsNotificationSchema type: object ExternalSmsNotificationStatus: description: Delivery status of an SMS notification sent via the Connect API. enum: - SENT - DELIVERED - FAILED_TO_SEND title: ExternalSmsNotificationStatus type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````