--- title: "List Order Items" method: GET path: "/ext/v2/order-items/" tags: ["Orders"] --- # List Order Items `GET /ext/v2/order-items/` ## Request - Base URL: `https://connect.vetcove.com` - URL: `https://connect.vetcove.com/ext/v2/order-items/` - Auth: HTTP bearer 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. ## Query parameters - `ids` integer[], nullable: When provided, filters to objects with these IDs. - `ending_before` integer, nullable: 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`. - `starting_after` integer, nullable: 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`. - `limit` integer: The maximum number of items to return per page. - `cursor` string, nullable: 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. - `modified__gte` string, date-time, nullable: 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. - `modified__lte` string, date-time, nullable: 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. - `order_id` integer, nullable: ID of the order to filter by ## Response `200` OK - ExternalOrderItemList - `data` ExternalOrderItemSchema[], required: A single page of data contained within this list. - `authorizing_vet` string, nullable: Name of prescribing vet - `authorizing_vet_doctor_id` integer, nullable: 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. - `client_price` integer, required: Subtotal charged to the client for this item, in cents. - `client_service_fee` integer, required: 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. - `clinic_discounts` integer: Incentive-based clinic discount - `created` string, date-time, required: The datetime this object was created. - `credit_card_processing_fee` integer, required: Credit card processing fee in cents - `current_chewy_price` integer, nullable: The current price of this item on chewy.com, in cents. Used for price comparison. - `delivered_date` string, date, nullable, required: Delivery date of the order item - `diet_fulfillment_fee` integer, required: Amortized diet fulfillment fee paid to vendor - `dvm_authorization_date` string, date, nullable: Date DVM authorized the prescription - `gl_codes` string[], nullable: Associated GL codes - `handling_fee` integer, required: Handling fees your clinic charged for compounded medications - `id` integer, required: Unique identifier for the order item. - `is_pickup` boolean, required: Indicates if this is a pickup item - `is_subscription` boolean, required: Whether the item is part of a subscription - `item_id` integer, required: ID of the catalog item that was ordered. - `loyalty_savings` integer, required: Loyalty program discount on clinic's COGS in cents - `margin` union: 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. - number - string - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field. - `net_payout` integer, nullable: Total amount paid out to clinic - `note_to_client` string, nullable, required: Client-facing note entered by the clinic for this item. - `order_processing_fee` integer, required: Vetcove service fee in cents - `patient_id` integer, nullable, required: ID of the clinic patient this order item is for. - `pharmacy_fulfillment_fee` integer, required: Pharmacy fulfillment fee in cents - `prescription_history_id` integer, nullable: ID of the individual prescription history entry associated with this order item. - `prescription_id` integer, nullable: ID of the prescription record associated with this item and patient, reflecting the latest prescription details. - `profit` integer, nullable: Clinic profit for this item, in cents. Profit = Revenue - Costs. Zero when canceled. - `quantity` integer, required: The quantity of the item ordered. - `rebate_discounts` integer: Promotions funded by Vetcove or manufacturers; decreases client price but does not impact clinic profits - `refunded_amount` integer, required: Total amortized refund amount, including non-clinic sponsored refunds - `revenue` integer, required: Clinic revenue for this item, in cents, including wholesale tax. Zero when the item is canceled. - `ship_date` string, date, nullable, required: Date the item was shipped - `shipping` integer, required: Amortized shipping amount paid by the client on the order item - `sponsored_refund_amount` integer, required: Amortized refund amount sponsored by clinics - `status` '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', required - `stripe_payouts` ExternalOrderItemRevenuePayoutSchema[], required: Sorted Stripe payouts - `created` string, date, nullable, required: Date the payout was created. - `stripe_id` string, nullable, required: Stripe ID for the payout. - `unit_price` integer, required: The unit price of the item, in cents. - `urgency_fee` integer: Not applicable to home delivery orders; only pertains to buy online, pickup in clinic orders - `vc_marketplace_facilitator_tax` integer, required: Tax charged to client on total order; this is collected and remitted by Vetcove - `vendor_fees` integer, nullable: Fees charged by the vendor for this item, in cents. Zero when the item is canceled. - `vendor_name` string, nullable: Vendor name - `vendor_shipping` integer, nullable: Shipping cost paid to the vendor for this item, in cents. Zero when the item is canceled. - `vendor_subtotal` integer, nullable: Subtotal charged by the vendor for this item, in cents. Zero when the item is canceled. - `wholesale_tax` integer, required: Amortized amount paid by clinic in wholesale tax upon item sale to the clinic - `has_more` boolean: Whether there are more pages or data in this list. - `next_page` string, required: A URL linking to the next page of this list. - `type` string: Type of this object. Always `list`. --- [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)