> ## 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 inventory codes for a clinic > 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. ## OpenAPI ````yaml get /ext/v2/clinics/{clinic_id}/inventory-codes/ 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/: get: tags: - Inventory summary: List all inventory codes for a clinic description: >- 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. operationId: clinic_inventory_code_list parameters: - description: The ID of the clinic to fetch inventory codes for in: path name: clinic_id required: true schema: description: The ID of the clinic to fetch inventory codes for title: Clinic Id type: integer - 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: When provided, filters inventory codes by the code in: query name: code required: false schema: anyOf: - type: string - type: 'null' description: When provided, filters inventory codes by the code title: Code - description: >- 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. in: query name: is_enabled required: false schema: anyOf: - type: boolean - type: 'null' description: >- 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. title: Is Enabled - description: When provided, filters inventory codes by their stock status in: query name: status required: false schema: anyOf: - $ref: '#/components/schemas/InventoryStatus' - type: 'null' description: When provided, filters inventory codes by their stock status - description: >- When provided, limits results to inventory codes whose global inventory belongs to this category. in: query name: category_id required: false schema: anyOf: - type: integer - type: 'null' description: >- When provided, limits results to inventory codes whose global inventory belongs to this category. title: Category Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/ExternalClinicInventoryCodeSchemaList' description: OK security: - ExternalAPIAuth: [] components: schemas: InventoryStatus: enum: - OUT_OF_STOCK - LOW_STOCK - IN_STOCK - UNKNOWN title: InventoryStatus type: string ExternalClinicInventoryCodeSchemaList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalClinicInventoryCodeSchema' 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: ExternalClinicInventoryCodeSchemaList type: object ExternalClinicInventoryCodeSchema: 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: ExternalClinicInventoryCodeSchema 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 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 ````