> ## 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.

# Fetch a subscription

> Fetches a subscription by its ID.

A **subscription** represents a recurring autoship order for a product (e.g., monthly flea and tick prevention). Each subscription is associated with a clinic, client, patient, and a specific catalog item, and defines the delivery frequency and quantity.



## OpenAPI

````yaml get /ext/v2/subscriptions/{subscription_id}/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/subscriptions/{subscription_id}/:
    get:
      tags:
        - Subscriptions
      summary: Fetch a subscription
      description: >-
        Fetches a subscription by its ID.


        A **subscription** represents a recurring autoship order for a product
        (e.g., monthly flea and tick prevention). Each subscription is
        associated with a clinic, client, patient, and a specific catalog item,
        and defines the delivery frequency and quantity.
      operationId: subscriptions_get
      parameters:
        - description: The ID of the subscription to fetch
          in: path
          name: subscription_id
          required: true
          schema:
            description: The ID of the subscription to fetch
            title: Subscription Id
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalSubscriptionDetailSchema'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalSubscriptionDetailSchema:
      description: >-
        A subscription represents a recurring autoship order for a product, such
        as monthly flea medication delivery. Subscriptions are associated with a
        specific clinic, client, patient, and item, and define the frequency and
        quantity of each recurring order.
      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: Subscription
      type: object
    FrequencyUnit:
      enum:
        - DAY
        - WEEK
        - MONTH
        - YEAR
      title: FrequencyUnit
      type: string
    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
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````