---
title: "List all inventory codes for a clinic"
method: GET
path: "/ext/v2/clinics/{clinic_id}/inventory-codes/"
tags: ["Inventory"]
---

# List all inventory codes for a clinic

`GET /ext/v2/clinics/{clinic_id}/inventory-codes/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/clinics/{clinic_id}/inventory-codes/`
- Auth: HTTP bearer

This endpoint is available to Group API Keys only.

Returns a clinic-specific view of all relevant inventory codes, including clinic-level configuration such as pricing, stock levels, and enabled/disabled status. The inventory codes are sorted by creation date, with the most recent appearing first.

A **clinic inventory code** is the clinic-level view of an inventory code, including clinic-specific overrides to pricing, stock quantities, reorder points, and enabled/disabled status.

## Path parameters

- `clinic_id` integer, required: The ID of the clinic to fetch inventory codes for

## 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.
- `code` string, nullable: When provided, filters inventory codes by the code
- `is_enabled` boolean, nullable: When provided, filters inventory codes by their enabled status for the clinic. When true, returns only enabled inventory codes. When false, returns only disabled inventory codes.
- `status` 'OUT_OF_STOCK' | 'LOW_STOCK' | 'IN_STOCK' | 'UNKNOWN'
- `category_id` integer, nullable: When provided, limits results to inventory codes whose global inventory belongs to this category.

## Response `200`

OK

- ExternalClinicInventoryCodeSchemaList
  - `data` ExternalClinicInventoryCodeSchema[], required: A single page of data contained within this list.
    - `category_id` integer, required: The ID of the inventory category for this inventory code
    - `clinic_preferences` ClinicInventoryPreferenceSchema, required
      - `is_enabled` boolean, required: Whether this inventory code is enabled for this clinic
      - `last_unit_price_update` string, date-time, nullable, required: The last time this inventory's unit price was updated, in UTC
      - `min_quantity` union, required: The minimum quantity below which the clinic considers this inventory to be out of stock
        - number
        - string
      - `name` string, nullable, required: The name assigned to this type of inventory by the clinic. Can be null if the clinic is inheriting your organization's default or Vetcove's default
      - `reorder_point` union, required: The quantity of this inventory at which a reorder should be made
        - number
        - string
      - `should_track_lot_number` boolean, required: Whether use of this inventory requires lot numbers to be tracked
      - `status` 'OUT_OF_STOCK' | 'LOW_STOCK' | 'IN_STOCK' | 'UNKNOWN', required
      - `target_quantity` union, required: The quantity this inventory should be replenished to on reorder
        - number
        - string
      - `unit_price` integer, nullable, required: The unit price of this inventory, in cents
    - `code` string, required: The global code assigned to this type of inventory at Vetcove
    - `effective_preferences` ClinicEffectiveInventoryPreference, required
      - `grade` union, required: The grade (importance) assigned to this type of inventory by this clinic
        - 'A' | 'B' | 'C' | 'D' | 'X'
        - ''
      - `is_enabled` boolean, required: Whether this inventory code is enabled for this clinic
      - `min_quantity` union, required: The minimum quantity below which the clinic considers this inventory to be out of stock
        - number
        - string
      - `name` string, required: The name assigned to this type of inventory for this clinic
      - `reorder_point` union, required: The quantity of this inventory at which a reorder should be made
        - number
        - string
      - `should_track_lot_number` boolean, required: Whether use of this inventory requires lot numbers to be tracked
      - `target_quantity` union, required: The quantity this inventory should be replenished to on reorder
        - number
        - string
      - `unit_of_measure` 'APPLICATOR' | 'BAG' | 'BOTTLE' | 'BOX' | 'BUCKET' | 'CAN' | 'CAPLET' | 'CAPSULE' | 'CASE' | 'CATHETER' | 'CHEW' | 'COLLAR' | 'DOSE' | 'EACH' | 'GRAM' | 'GALLON' | 'JAR' | 'KIT' | 'POUND' | 'LITER' | 'MILLILITER' | 'NEEDLE' | 'OUNCE' | 'PACKET' | 'PAIR' | 'PIPETTE' | 'PURCHASING_UNIT' | 'QUART' | 'ROLL' | 'SUTURE' | 'SYRINGE' | 'TABLET' | 'TEST' | 'TRAY' | 'TUB' | 'TUBE' | 'VIAL' | 'YARD', required
      - `unit_price` integer, nullable, required: The unit price of this inventory, in cents
    - `global_preferences` GlobalInventoryPreference, required
      - `name` string, required: The global name assigned to this type of inventory at Vetcove
      - `unit_of_measure` 'APPLICATOR' | 'BAG' | 'BOTTLE' | 'BOX' | 'BUCKET' | 'CAN' | 'CAPLET' | 'CAPSULE' | 'CASE' | 'CATHETER' | 'CHEW' | 'COLLAR' | 'DOSE' | 'EACH' | 'GRAM' | 'GALLON' | 'JAR' | 'KIT' | 'POUND' | 'LITER' | 'MILLILITER' | 'NEEDLE' | 'OUNCE' | 'PACKET' | 'PAIR' | 'PIPETTE' | 'PURCHASING_UNIT' | 'QUART' | 'ROLL' | 'SUTURE' | 'SYRINGE' | 'TABLET' | 'TEST' | 'TRAY' | 'TUB' | 'TUBE' | 'VIAL' | 'YARD', required
    - `id` integer, required: The unique identifier for the inventory code
    - `in_transit_quantity` string, required: The number of inventory units currently in transit for this clinic
    - `is_controlled` boolean, required: Whether this inventory code is controlled or not
    - `kind` union, required: The kind of the inventory code
      - 'STANDARD' | 'CUSTOM_ROLLUP' | 'CUSTOM'
      - ''
    - `on_hold_quantity` string, required: The number of inventory units currently on hold for this clinic
    - `organization_preferences` OrganizationInventoryPreference, required
      - `clinic_location_group_ids` integer[], required: Which clinic location groups this inventory code is relevant to within your organization
      - `grade` union, required: The grade (importance) assigned to this type of inventory by your organization
        - 'A' | 'B' | 'C' | 'D' | 'X'
        - ''
      - `is_enabled` boolean, required: Whether this inventory code is enabled for your organization
      - `name` string, nullable, required: The name assigned to this type of inventory by your organization. Can be null if you are inheriting Vetcove's default
      - `unit_of_measure` 'APPLICATOR' | 'BAG' | 'BOTTLE' | 'BOX' | 'BUCKET' | 'CAN' | 'CAPLET' | 'CAPSULE' | 'CASE' | 'CATHETER' | 'CHEW' | 'COLLAR' | 'DOSE' | 'EACH' | 'GRAM' | 'GALLON' | 'JAR' | 'KIT' | 'POUND' | 'LITER' | 'MILLILITER' | 'NEEDLE' | 'OUNCE' | 'PACKET' | 'PAIR' | 'PIPETTE' | 'PURCHASING_UNIT' | 'QUART' | 'ROLL' | 'SUTURE' | 'SYRINGE' | 'TABLET' | 'TEST' | 'TRAY' | 'TUB' | 'TUBE' | 'VIAL' | 'YARD', required
    - `stock_quantity` string, required: The number of stock items available for this inventory code
  - `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)