> ## 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 for a clinic

> This endpoint is available to Group API Keys only.

Fetches a clinic-specific view of an inventory code by its ID.

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. 



## OpenAPI

````yaml get /ext/v2/clinics/{clinic_id}/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/clinics/{clinic_id}/inventory-codes/{inventory_code_id}/:
    get:
      tags:
        - Inventory
      summary: Fetch an inventory code for a clinic
      description: >-
        This endpoint is available to Group API Keys only.


        Fetches a clinic-specific view of an inventory code by its ID.


        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. 
      operationId: clinic_inventory_code_get
      parameters:
        - description: The ID of the clinic to fetch an inventory code for
          in: path
          name: clinic_id
          required: true
          schema:
            description: The ID of the clinic to fetch an inventory code for
            title: Clinic Id
            type: integer
        - 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/ExternalClinicInventoryCodeDetailSchema'
          description: OK
      security:
        - ExternalAPIAuth: []
components:
  schemas:
    ExternalClinicInventoryCodeDetailSchema:
      properties:
        category_id:
          description: The ID of the inventory category for this inventory code
          title: Category Id
          type: integer
        clinic_preferences:
          anyOf:
            - $ref: '#/components/schemas/ClinicInventoryPreferenceSchema'
            - type: 'null'
          description: >-
            The settings for this type of inventory set by the clinic. Will be
            null if the clinic does not have its own settings for this type of
            inventory
        code:
          description: The global code assigned to this type of inventory at Vetcove
          title: Code
          type: string
        effective_preferences:
          $ref: '#/components/schemas/ClinicEffectiveInventoryPreference'
          description: >-
            The effective settings for this type of inventory, favoring the
            clinic's settings first, followed by your organization's settings,
            then falling back to Vetcove's defaults when there is no 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
        in_transit_quantity:
          description: The number of inventory units currently in transit for this clinic
          title: In Transit Quantity
          type: string
        is_controlled:
          description: Whether this inventory code is controlled or not
          title: Is Controlled
          type: boolean
        kind:
          anyOf:
            - $ref: '#/components/schemas/GlobalInventoryKind'
            - const: ''
              type: string
          description: The kind of the inventory code
          title: Kind
        on_hold_quantity:
          description: The number of inventory units currently on hold for this clinic
          title: On Hold Quantity
          type: string
        organization_preferences:
          $ref: '#/components/schemas/OrganizationInventoryPreference'
          description: >-
            The settings for this type of inventory set by your organization.
            This cannot be null when viewing inventory codes at the clinic level
            - no inventory code is accessible at the clinic level if there are
            no organization level preferences
        stock_quantity:
          description: The number of stock items available for this inventory code
          title: Stock Quantity
          type: string
      required:
        - id
        - code
        - kind
        - category_id
        - global_preferences
        - organization_preferences
        - clinic_preferences
        - effective_preferences
        - stock_quantity
        - in_transit_quantity
        - on_hold_quantity
        - is_controlled
      title: ExternalClinicInventoryCodeDetailSchema
      type: object
    ClinicInventoryPreferenceSchema:
      properties:
        is_enabled:
          description: Whether this inventory code is enabled for this clinic
          title: Is Enabled
          type: boolean
        last_unit_price_update:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          description: The last time this inventory's unit price was updated, in UTC
          title: Last Unit Price Update
        min_quantity:
          anyOf:
            - type: number
            - type: string
          description: >-
            The minimum quantity below which the clinic considers this inventory
            to be out of stock
          title: Min Quantity
        name:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            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
          title: Name
        reorder_point:
          anyOf:
            - type: number
            - type: string
          description: The quantity of this inventory at which a reorder should be made
          title: Reorder Point
        should_track_lot_number:
          description: Whether use of this inventory requires lot numbers to be tracked
          title: Should Track Lot Number
          type: boolean
        status:
          $ref: '#/components/schemas/InventoryStatus'
          description: The current status of this inventory for this clinic
        target_quantity:
          anyOf:
            - type: number
            - type: string
          description: The quantity this inventory should be replenished to on reorder
          title: Target Quantity
        unit_price:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          description: The unit price of this inventory, in cents
          title: Unit Price
      required:
        - status
        - is_enabled
        - name
        - min_quantity
        - reorder_point
        - target_quantity
        - should_track_lot_number
        - unit_price
        - last_unit_price_update
      title: ClinicInventoryPreferenceSchema
      type: object
    ClinicEffectiveInventoryPreference:
      properties:
        grade:
          anyOf:
            - $ref: '#/components/schemas/InventoryGrade'
            - const: ''
              type: string
          description: >-
            The grade (importance) assigned to this type of inventory by this
            clinic
          title: Grade
        is_enabled:
          description: Whether this inventory code is enabled for this clinic
          title: Is Enabled
          type: boolean
        min_quantity:
          anyOf:
            - type: number
            - type: string
            - type: 'null'
          description: >-
            The minimum quantity below which the clinic considers this inventory
            to be out of stock
          title: Min Quantity
        name:
          description: The name assigned to this type of inventory for this clinic
          title: Name
          type: string
        reorder_point:
          anyOf:
            - type: number
            - type: string
            - type: 'null'
          description: The quantity of this inventory at which a reorder should be made
          title: Reorder Point
        should_track_lot_number:
          description: Whether use of this inventory requires lot numbers to be tracked
          title: Should Track Lot Number
          type: boolean
        target_quantity:
          anyOf:
            - type: number
            - type: string
            - type: 'null'
          description: The quantity this inventory should be replenished to on reorder
          title: Target Quantity
        unit_of_measure:
          $ref: '#/components/schemas/InventoryUnitOfMeasure'
          description: >-
            The settings for how units of this inventory are measured for this
            clinic
        unit_price:
          anyOf:
            - minimum: 0
              type: integer
            - type: 'null'
          description: The unit price of this inventory, in cents
          title: Unit Price
      required:
        - is_enabled
        - name
        - unit_of_measure
        - grade
        - min_quantity
        - reorder_point
        - target_quantity
        - should_track_lot_number
        - unit_price
      title: ClinicEffectiveInventoryPreference
      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
    InventoryStatus:
      enum:
        - OUT_OF_STOCK
        - LOW_STOCK
        - IN_STOCK
        - UNKNOWN
      title: InventoryStatus
      type: string
    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

````