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

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

The Vetcove catalog has a three-level hierarchy: **Product Line → Product → Item**. An **item** is the most specific level — a particular SKU with a specific size, count, or formulation (e.g., "Heartgard Plus 26-50 lbs, 6-pack"). Each item belongs to a product, which in turn belongs to a product line.



## OpenAPI

````yaml get /ext/v2/items/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/items/:
    get:
      tags:
        - Catalog
      summary: List all items
      description: >-
        Returns a list of all catalog items. The items are sorted by creation
        date, with the most recent items appearing first. When using modified
        filters, results are sorted in descending modification date instead.


        The Vetcove catalog has a three-level hierarchy: **Product Line →
        Product → Item**. An **item** is the most specific level — a particular
        SKU with a specific size, count, or formulation (e.g., "Heartgard Plus
        26-50 lbs, 6-pack"). Each item belongs to a product, which in turn
        belongs to a product line.
      operationId: items_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
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalItemSchemaList'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalItemSchemaList:
      properties:
        data:
          description: A single page of data contained within this list.
          items:
            $ref: '#/components/schemas/ExternalItemSchema'
          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: ExternalItemSchemaList
      type: object
    ExternalItemSchema:
      description: Schema for catalog item details.
      properties:
        alt_image_url:
          anyOf:
            - type: string
            - type: 'null'
          description: Alternative URL to the item's image
          title: Alt Image Url
        created:
          description: The datetime this object was created.
          format: date-time
          title: Created
          type: string
        duration_unit:
          description: >-
            Unit of time used to measure the duration value field (days, weeks,
            months, or years)
          title: Duration Unit
          type: string
        duration_value:
          description: 'Duration the item is expected to last '
          title: Duration Value
          type: integer
        etailer_price:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            The price of this item at major online retailers, in cents. Used for
            price comparison.
          title: Etailer Price
        full_name:
          description: Complete name of the item
          title: Full Name
          type: string
        id:
          description: Unique identifier for the catalog item
          title: Id
          type: integer
        image_url:
          anyOf:
            - type: string
            - type: 'null'
          description: URL to the item's image
          title: Image Url
        is_active:
          description: Whether the item is active
          title: Is Active
          type: boolean
        manufacturer_no:
          anyOf:
            - type: string
            - type: 'null'
          description: Manufacturer number of the item
          title: Manufacturer No
        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
        msrp:
          anyOf:
            - type: integer
            - type: 'null'
          description: Manufacturer's suggested retail price (MSRP) of the item, in cents.
          title: Msrp
        name:
          description: >-
            Name of the Item itself. For the complete name of the Item, see the
            full_name field.
          title: Name
          type: string
        product_id:
          description: ID of the associated product
          title: Product Id
          type: integer
        shopping_path:
          description: URL path to the item's page in the Vetcove client shopping portal
          title: Shopping Path
          type: string
        sku:
          description: Stock keeping unit (SKU) identifier for the item
          title: Sku
          type: string
        vendor_stock_availability:
          anyOf:
            - $ref: '#/components/schemas/VendorSupplyAvailability'
            - type: 'null'
          description: >-
            The current stock availability status from the vendor supplying this
            item.
        weight:
          description: The weight of the Item in ounces
          title: Weight
          type: number
      required:
        - created
        - modified
        - id
        - full_name
        - name
        - sku
        - product_id
        - shopping_path
        - is_active
        - msrp
        - weight
        - duration_unit
        - duration_value
      title: ExternalItemSchema
      type: object
    VendorSupplyAvailability:
      enum:
        - IN_STOCK
        - BACKORDERED
        - UNAVAILABLE
        - UNKNOWN
        - LOW_STOCK
      title: VendorSupplyAvailability
      type: string
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````