---
title: "List Refunds"
method: GET
path: "/ext/v2/refunds/"
tags: ["Payment Methods"]
---

# List Refunds

`GET /ext/v2/refunds/`

## Request

- Base URL: `https://connect.vetcove.com`
- URL: `https://connect.vetcove.com/ext/v2/refunds/`
- Auth: HTTP bearer

Returns a list of all refunds across all clinics in the organization. The refunds are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted in descending modification date instead.

A **refund** represents money returned to a client for a product order.

## 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: Filter refunds by order ID

## Response `200`

OK

- ExternalRefundSchemaList
  - `data` ExternalRefundSchema[], required: A single page of data contained within this list.
    - `amount` integer, required: Refund amount in cents
    - `amount_display` string, required: Human-readable refund amount (e.g., $10.00)
    - `created` string, date-time, required: The datetime this object was created.
    - `currency` union, required: The currency of the refund
      - 'USD' | 'CAD'
      - ''
    - `id` integer, required: Unique ID of the refund
    - `is_urgency_fee_refund` boolean, required: Indicates if this refund was for an urgency fee
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `num_order_items` integer, required: Number of order items associated with this refund
    - `sponsored_by` string, nullable, required: Entity sponsoring the refund, if any
  - `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)