> ## 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 Order Items > This endpoint is available to Group API Keys only. Returns a list of all order items across all clinics in the organization. The order items are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted in descending modification date instead. An **order item** represents a single product line within an order. Each order item corresponds to a specific product purchased by a clinic client and tracks its pricing, shipping, and fulfillment lifecycle. ## OpenAPI ````yaml get /ext/v2/order-items/ openapi: 3.1.0 info: description: '' title: NinjaAPI version: 2.0.0 servers: - url: https://connect.vetcove.com/ security: [] paths: /ext/v2/order-items/: get: tags: - Orders summary: List Order Items description: >- This endpoint is available to Group API Keys only. Returns a list of all order items across all clinics in the organization. The order items are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted in descending modification date instead. An **order item** represents a single product line within an order. Each order item corresponds to a specific product purchased by a clinic client and tracks its pricing, shipping, and fulfillment lifecycle. operationId: order_items_list parameters: - 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: >- A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters. in: query name: cursor required: false schema: anyOf: - type: string - type: 'null' description: >- A cursor token used for pagination. This token contains encoded information about the last seen record in order to continue pagination. Cannot be used with `starting_after` or `ending_before` parameters. title: Cursor - description: >- Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. in: query name: modified__gte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- Filters to objects modified on or after this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. title: Modified Gte - description: >- Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. in: query name: modified__lte required: false schema: anyOf: - format: date-time type: string - type: 'null' description: >- Filters to objects modified on or before this datetime (ISO8601 UTC, e.g. 2025-08-25T10:30:00Z). Cannot be used with `starting_after` or `ending_before` parameters. title: Modified Lte - description: ID of the order to filter by in: query name: order_id required: false schema: anyOf: - type: integer - type: 'null' description: ID of the order to filter by title: Order Id responses: '200': content: application/json: schema: $ref: '#/components/schemas/External_Order_ItemList' description: OK security: - ExternalAPIAuth: [] components: schemas: External_Order_ItemList: properties: data: description: A single page of data contained within this list. items: $ref: '#/components/schemas/ExternalOrderItemSchema' 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: External Order ItemList type: object ExternalOrderItemSchema: properties: authorizing_vet: anyOf: - type: string - type: 'null' description: Name of prescribing vet title: Authorizing Vet authorizing_vet_doctor_id: anyOf: - type: integer - type: 'null' description: >- ID of the prescribing vet (Doctor). Use with the Doctors endpoint to look up full doctor details and disambiguate vets who share the same name. title: Authorizing Vet Doctor Id client_price: description: Subtotal charged to the client for this item, in cents. title: Client Price type: integer client_service_fee: description: >- This fee is configured by your clinic and can cover additional expenses such as order processing, administrative support, or compliance costs. Often referred to as 'Service Fees' in your storefront. title: Client Service Fee type: integer clinic_discounts: default: 0 description: Incentive-based clinic discount title: Clinic Discounts type: integer created: description: The datetime this object was created. format: date-time title: Created type: string credit_card_processing_fee: description: Credit card processing fee in cents title: Credit Card Processing Fee type: integer current_chewy_price: anyOf: - type: integer - type: 'null' description: >- The current price of this item on chewy.com, in cents. Used for price comparison. title: Current Chewy Price delivered_date: anyOf: - format: date type: string - type: 'null' description: Delivery date of the order item title: Delivered Date diet_fulfillment_fee: description: Amortized diet fulfillment fee paid to vendor title: Diet Fulfillment Fee type: integer dvm_authorization_date: anyOf: - format: date type: string - type: 'null' description: Date DVM authorized the prescription title: Dvm Authorization Date gl_codes: anyOf: - items: type: string type: array - type: 'null' description: Associated GL codes title: Gl Codes handling_fee: description: Handling fees your clinic charged for compounded medications title: Handling Fee type: integer id: description: Unique identifier for the order item. title: Id type: integer is_pickup: description: Indicates if this is a pickup item title: Is Pickup type: boolean is_subscription: description: Whether the item is part of a subscription title: Is Subscription type: boolean item_id: description: ID of the catalog item that was ordered. title: Item Id type: integer loyalty_savings: description: Loyalty program discount on clinic's COGS in cents title: Loyalty Savings type: integer margin: anyOf: - type: number - type: string - type: 'null' description: >- Profit margin as a percentage. Margin = Net Profit / Revenue. Revenue includes product revenue, client-paid shipping fees, and client-paid handling fees. Null when profit is unavailable or revenue is zero. title: Margin modified: description: >- The datetime this object was last modified; changes to related entities will not update this field. format: date-time title: Modified type: string net_payout: anyOf: - type: integer - type: 'null' description: Total amount paid out to clinic title: Net Payout note_to_client: anyOf: - type: string - type: 'null' description: Client-facing note entered by the clinic for this item. title: Note To Client order_processing_fee: description: Vetcove service fee in cents title: Order Processing Fee type: integer patient_id: anyOf: - type: integer - type: 'null' description: ID of the clinic patient this order item is for. title: Patient Id pharmacy_fulfillment_fee: description: Pharmacy fulfillment fee in cents title: Pharmacy Fulfillment Fee type: integer prescription_history_id: anyOf: - type: integer - type: 'null' description: >- ID of the individual prescription history entry associated with this order item. title: Prescription History Id prescription_id: anyOf: - type: integer - type: 'null' description: >- ID of the prescription record associated with this item and patient, reflecting the latest prescription details. title: Prescription Id profit: anyOf: - type: integer - type: 'null' description: >- Clinic profit for this item, in cents. Profit = Revenue - Costs. Zero when canceled. title: Profit quantity: description: The quantity of the item ordered. title: Quantity type: integer rebate_discounts: default: 0 description: >- Promotions funded by Vetcove or manufacturers; decreases client price but does not impact clinic profits title: Rebate Discounts type: integer refunded_amount: description: >- Total amortized refund amount, including non-clinic sponsored refunds title: Refunded Amount type: integer revenue: description: >- Clinic revenue for this item, in cents, including wholesale tax. Zero when the item is canceled. title: Revenue type: integer ship_date: anyOf: - format: date type: string - type: 'null' description: Date the item was shipped title: Ship Date shipping: description: Amortized shipping amount paid by the client on the order item title: Shipping type: integer sponsored_refund_amount: description: Amortized refund amount sponsored by clinics title: Sponsored Refund Amount type: integer status: $ref: '#/components/schemas/OrderItemStatus' description: Status of the order item stripe_payouts: description: Sorted Stripe payouts items: $ref: '#/components/schemas/ExternalOrderItemRevenuePayoutSchema' title: Stripe Payouts type: array unit_price: description: The unit price of the item, in cents. title: Unit Price type: integer urgency_fee: default: 0 description: >- Not applicable to home delivery orders; only pertains to buy online, pickup in clinic orders title: Urgency Fee type: integer vc_marketplace_facilitator_tax: description: >- Tax charged to client on total order; this is collected and remitted by Vetcove title: Vc Marketplace Facilitator Tax type: integer vendor_fees: anyOf: - type: integer - type: 'null' description: >- Fees charged by the vendor for this item, in cents. Zero when the item is canceled. title: Vendor Fees vendor_name: anyOf: - type: string - type: 'null' description: Vendor name title: Vendor Name vendor_shipping: anyOf: - type: integer - type: 'null' description: >- Shipping cost paid to the vendor for this item, in cents. Zero when the item is canceled. title: Vendor Shipping vendor_subtotal: anyOf: - type: integer - type: 'null' description: >- Subtotal charged by the vendor for this item, in cents. Zero when the item is canceled. title: Vendor Subtotal wholesale_tax: description: >- Amortized amount paid by clinic in wholesale tax upon item sale to the clinic title: Wholesale Tax type: integer required: - created - modified - id - item_id - quantity - unit_price - handling_fee - status - is_subscription - is_pickup - patient_id - client_price - revenue - ship_date - vc_marketplace_facilitator_tax - diet_fulfillment_fee - refunded_amount - stripe_payouts - delivered_date - credit_card_processing_fee - order_processing_fee - sponsored_refund_amount - loyalty_savings - pharmacy_fulfillment_fee - wholesale_tax - shipping - client_service_fee - note_to_client title: External Order Item type: object OrderItemStatus: enum: - APPROVAL_NEEDED - APPROVED - CLINIC_CANCELED - CLIENT_CANCELED - CLINIC_CANCELED_REFUNDED - CLINIC_CANCELED_CREDITED - FAILED_SEND_TO_VENDOR - SENT_TO_VENDOR - TRIAGED - VENDOR_CANCELED - FULLY_SHIPPED - PARTIALLY_SHIPPED - DELIVERED title: OrderItemStatus type: string ExternalOrderItemRevenuePayoutSchema: properties: created: anyOf: - format: date type: string - type: 'null' description: Date the payout was created. title: Created stripe_id: anyOf: - type: string - type: 'null' description: Stripe ID for the payout. title: Stripe Id required: - stripe_id - created title: ExternalOrderItemRevenuePayoutSchema type: object securitySchemes: ExternalAPIAuth: scheme: bearer type: http ````