> ## 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 subscriptions > 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. ## OpenAPI ````yaml get /ext/v2/subscriptions/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/subscriptions/: get: tags: - Subscriptions summary: List all subscriptions description: >- 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. operationId: subscriptions_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: When provided, filters to subscriptions for this clinic in: query name: clinic_id required: false schema: anyOf: - type: integer - type: 'null' description: When provided, filters to subscriptions for this clinic title: Clinic Id - description: When provided, filters to subscriptions for this clinic client in: query name: clinic_client_id required: false schema: anyOf: - type: integer - type: 'null' description: When provided, filters to subscriptions for this clinic client title: Clinic Client Id - description: When provided, filters to subscriptions for this clinic patient in: query name: clinic_patient_id required: false schema: anyOf: - type: integer - type: 'null' description: When provided, filters to subscriptions for this clinic patient title: Clinic Patient Id - description: When provided, filters to subscriptions for this status in: query name: status required: false schema: anyOf: - $ref: '#/components/schemas/SubscriptionStatus' - type: 'null' description: When provided, filters to subscriptions for this status responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExternalSubscriptionSchemaList' description: OK security: - ExternalAPIAuth: [] components: schemas: SubscriptionStatus: enum: - 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 title: SubscriptionStatus type: string ExternalSubscriptionSchemaList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalSubscriptionSchema' 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: ExternalSubscriptionSchemaList type: object ExternalSubscriptionSchema: properties: autoship_url_client: description: The client url for this subscription. title: Autoship Url Client type: string autoship_url_clinic: description: The clinic url for this subscription. title: Autoship Url Clinic type: string clinic_client_id: description: The ID of the client this subscription belongs to. title: Clinic Client Id type: integer clinic_id: description: The ID of the clinic this subscription belongs to. title: Clinic Id type: integer clinic_patient_id: description: The ID of the patient for this subscription. title: Clinic Patient Id type: integer created: description: The datetime this object was created. format: date-time title: Created type: string frequency: description: The number of interval units between subscription orders. title: Frequency type: integer id: description: The unique identifier for this subscription. title: Id type: integer interval_unit: anyOf: - $ref: '#/components/schemas/FrequencyUnit' - const: '' type: string description: The unit of time between subscription orders. title: Interval Unit is_imported: description: Whether this subscription was imported from an external site. title: Is Imported type: boolean item_id: description: The ID of the item for this subscription. title: Item Id type: integer last_order_date: anyOf: - format: date-time type: string - type: 'null' description: The date of the most recent order for this subscription. title: Last Order Date modified: description: >- The datetime this object was last modified; changes to related entities will not update this field. format: date-time title: Modified type: string next_order_date: description: The date of the next scheduled order for this subscription. format: date-time title: Next Order Date type: string quantity: description: The quantity of the item for this subscription. title: Quantity type: integer status: $ref: '#/components/schemas/SubscriptionStatus' description: The status of the subscription. status_changed: description: The time at which the subscription status was last changed. format: date-time title: Status Changed type: string required: - created - modified - id - clinic_id - clinic_client_id - clinic_patient_id - item_id - quantity - interval_unit - frequency - status - status_changed - last_order_date - next_order_date - is_imported - autoship_url_clinic - autoship_url_client title: ExternalSubscriptionSchema type: object FrequencyUnit: enum: - DAY - WEEK - MONTH - YEAR title: FrequencyUnit type: string securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````