---
title: "Fetch an inventory code"
method: GET
path: "/ext/v2/inventory-codes/{inventory_code_id}/"
tags: ["Inventory"]
---

# Fetch an inventory code

`GET /ext/v2/inventory-codes/{inventory_code_id}/`

## Request

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

This endpoint is available to Group API Keys only.

Fetches an inventory code by its ID.

An **inventory code** represents a trackable supply item used within a clinic (e.g., a specific medication, vaccine vial, or consumable) and can be configured at the organization level with clinic-specific overrides.

## Path parameters

- `inventory_code_id` integer, required: The ID of the inventory code to fetch

## Response `200`

OK

- ExternalInventoryCodeDetailSchema
  - `category_id` integer, required: The ID of the inventory category for this inventory code
  - `code` string, required: The global code assigned to this type of inventory at Vetcove
  - `effective_preferences` EffectiveInventoryPreference, 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, required: The name assigned to this type of inventory for your organization
    - `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
  - `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
  - `kind` union, required: The kind of the inventory code
    - 'STANDARD' | 'CUSTOM_ROLLUP' | 'CUSTOM'
    - ''
  - `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

---

[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)