---
title: "List all subscriptions"
method: GET
path: "/ext/v2/subscriptions/"
tags: ["Subscriptions"]
---

# List all subscriptions

`GET /ext/v2/subscriptions/`

## Request

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

Returns a list of all subscriptions across all clinics in the organization. The subscriptions are sorted by creation date, with the most recent subscriptions appearing first. When using modified filters, results are sorted in descending modification date instead.

A **subscription** represents a recurring autoship order for a product (e.g., monthly flea and tick prevention). Each subscription is tied to a specific clinic patient and clinic client, and tracks the delivery frequency, status, and associated clinic.

## 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: When provided, filters to subscriptions for this clinic
- `clinic_client_id` integer, nullable: When provided, filters to subscriptions for this clinic client
- `clinic_patient_id` integer, nullable: When provided, filters to subscriptions for this clinic patient
- `status` 'ACTIVE' | 'CANCELED_VIA_CLINIC' | 'CANCELED_VIA_CLIENT' | 'CANCELED_DENIED' | 'CANCELED_VIA_ADMIN' | 'FAILED_PAYMENT' | 'PAUSED_VIA_CLIENT' | 'PAUSED_VIA_CLINIC' | 'PAUSED_BAD_ADDRESS' | 'PAUSED_PRESCRIPTION' | 'PAUSED_OUT_OF_STOCK' | 'PAUSED_MISSING_CLIENT_INFO' | 'PAUSED_FLAVOR_UNAVAILABLE' | 'PAUSED_OTHER' | 'IMPORTED'

## Response `200`

OK

- ExternalSubscriptionSchemaList
  - `data` ExternalSubscriptionSchema[], required: A single page of data contained within this list.
    - `autoship_url_client` string, required: The client url for this subscription.
    - `autoship_url_clinic` string, required: The clinic url for this subscription.
    - `clinic_client_id` integer, required: The ID of the client this subscription belongs to.
    - `clinic_id` integer, required: The ID of the clinic this subscription belongs to.
    - `clinic_patient_id` integer, required: The ID of the patient for this subscription.
    - `created` string, date-time, required: The datetime this object was created.
    - `frequency` integer, required: The number of interval units between subscription orders.
    - `id` integer, required: The unique identifier for this subscription.
    - `interval_unit` union, required: The unit of time between subscription orders.
      - 'DAY' | 'WEEK' | 'MONTH' | 'YEAR'
      - ''
    - `is_imported` boolean, required: Whether this subscription was imported from an external site.
    - `item_id` integer, required: The ID of the item for this subscription.
    - `last_order_date` string, date-time, nullable, required: The date of the most recent order for this subscription.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `next_order_date` string, date-time, required: The date of the next scheduled order for this subscription.
    - `quantity` integer, required: The quantity of the item for this subscription.
    - `status` 'ACTIVE' | 'CANCELED_VIA_CLINIC' | 'CANCELED_VIA_CLIENT' | 'CANCELED_DENIED' | 'CANCELED_VIA_ADMIN' | 'FAILED_PAYMENT' | 'PAUSED_VIA_CLIENT' | 'PAUSED_VIA_CLINIC' | 'PAUSED_BAD_ADDRESS' | 'PAUSED_PRESCRIPTION' | 'PAUSED_OUT_OF_STOCK' | 'PAUSED_MISSING_CLIENT_INFO' | 'PAUSED_FLAVOR_UNAVAILABLE' | 'PAUSED_OTHER' | 'IMPORTED', required
    - `status_changed` string, date-time, required: The time at which the subscription status was last changed.
  - `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)