> ## 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 an inventory code

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



## OpenAPI

````yaml get /ext/v2/inventory-codes/{inventory_code_id}/
openapi: 3.1.0
info:
  description: ''
  title: NinjaAPI
  version: 2.0.0
servers:
  - url: https://connect.vetcove.com/
security: []
paths:
  /ext/v2/inventory-codes/{inventory_code_id}/:
    get:
      tags:
        - Inventory
      summary: Fetch an inventory code
      description: >-
        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.
      operationId: inventory_code_get
      parameters:
        - description: The ID of the inventory code to fetch
          in: path
          name: inventory_code_id
          required: true
          schema:
            description: The ID of the inventory code to fetch
            title: Inventory Code Id
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalInventoryCodeDetailSchema'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalInventoryCodeDetailSchema:
      properties:
        category_id:
          description: The ID of the inventory category for this inventory code
          title: Category Id
          type: integer
        code:
          description: The global code assigned to this type of inventory at Vetcove
          title: Code
          type: string
        effective_preferences:
          $ref: '#/components/schemas/EffectiveInventoryPreference'
          description: >-
            The effective settings for this type of inventory, favoring your
            organization's settings but falling back to Vetcove's defaults when
            you do not have an override set
        global_preferences:
          $ref: '#/components/schemas/GlobalInventoryPreference'
          description: Vetcove's default settings for this type of inventory
        id:
          description: The unique identifier for the inventory code
          title: Id
          type: integer
        kind:
          anyOf:
            - $ref: '#/components/schemas/GlobalInventoryKind'
            - const: ''
              type: string
          description: The kind of the inventory code
          title: Kind
        organization_preferences:
          anyOf:
            - $ref: '#/components/schemas/OrganizationInventoryPreference'
            - type: 'null'
          description: >-
            The settings for this type of inventory set by your organization.
            Will be null if your organization does not have its own settings for
            this type of inventory
      required:
        - id
        - code
        - kind
        - category_id
        - global_preferences
        - organization_preferences
        - effective_preferences
      title: ExternalInventoryCodeDetailSchema
      type: object
    EffectiveInventoryPreference:
      properties:
        clinic_location_group_ids:
          description: >-
            Which clinic location groups this inventory code is relevant to
            within your organization
          items:
            type: integer
          title: Clinic Location Group Ids
          type: array
        grade:
          anyOf:
            - $ref: '#/components/schemas/InventoryGrade'
            - const: ''
              type: string
          description: >-
            The grade (importance) assigned to this type of inventory by your
            organization
          title: Grade
        is_enabled:
          description: Whether this inventory code is enabled for your organization
          title: Is Enabled
          type: boolean
        name:
          description: The name assigned to this type of inventory for your organization
          title: Name
          type: string
        unit_of_measure:
          $ref: '#/components/schemas/InventoryUnitOfMeasure'
          description: >-
            The settings for how units of this inventory are measured for your
            organization
      required:
        - is_enabled
        - name
        - unit_of_measure
        - grade
        - clinic_location_group_ids
      title: EffectiveInventoryPreference
      type: object
    GlobalInventoryPreference:
      properties:
        name:
          description: The global name assigned to this type of inventory at Vetcove
          title: Name
          type: string
        unit_of_measure:
          $ref: '#/components/schemas/InventoryUnitOfMeasure'
          description: >-
            The global settings for how units of this inventory are measured at
            Vetcove
      required:
        - name
        - unit_of_measure
      title: GlobalInventoryPreference
      type: object
    GlobalInventoryKind:
      enum:
        - STANDARD
        - CUSTOM_ROLLUP
        - CUSTOM
      title: GlobalInventoryKind
      type: string
    OrganizationInventoryPreference:
      properties:
        clinic_location_group_ids:
          description: >-
            Which clinic location groups this inventory code is relevant to
            within your organization
          items:
            type: integer
          title: Clinic Location Group Ids
          type: array
        grade:
          anyOf:
            - $ref: '#/components/schemas/InventoryGrade'
            - const: ''
              type: string
          description: >-
            The grade (importance) assigned to this type of inventory by your
            organization
          title: Grade
        is_enabled:
          description: Whether this inventory code is enabled for your organization
          title: Is Enabled
          type: boolean
        name:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            The name assigned to this type of inventory by your organization.
            Can be null if you are inheriting Vetcove's default
          title: Name
        unit_of_measure:
          anyOf:
            - $ref: '#/components/schemas/InventoryUnitOfMeasure'
            - type: 'null'
          description: >-
            The settings for how units of this inventory are measured as set by
            your organization. Can be null if you are inheriting Vetcove's
            default
      required:
        - is_enabled
        - name
        - unit_of_measure
        - grade
        - clinic_location_group_ids
      title: OrganizationInventoryPreference
      type: object
    InventoryGrade:
      enum:
        - A
        - B
        - C
        - D
        - X
      title: InventoryGrade
      type: string
    InventoryUnitOfMeasure:
      enum:
        - 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
      title: InventoryUnitOfMeasure
      type: string
  securitySchemes:
    ExternalAPIAuth:
      scheme: bearer
      type: http

````