---
title: "List all invoice refunds"
method: GET
path: "/ext/v2/invoice-refunds/"
tags: ["Invoices"]
---

# List all invoice refunds

`GET /ext/v2/invoice-refunds/`

## Request

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

Returns a list of all invoice 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 by modification date instead.

An invoice refund represents a reversal of a payment made on a clinic invoice. Refunds can be issued as store credit, a credit card reversal, or through an external payment processor. Each refund is tied to a specific invoice payment and records the amount returned to the client. Invoice refunds are never deleted.

## 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.
- `clinic_id` integer, nullable: When provided, filters to invoice refunds for this clinic.
- `clinic_client_id` integer, nullable: When provided, filters to invoice refunds for this clinic client.
- `invoice_id` integer, nullable: When provided, filters to invoice refunds on this invoice.

## Response `200`

OK

- ExternalInvoiceRefundTopLevelSchemaList
  - `data` ExternalInvoiceRefundTopLevelSchema[], required: A single page of data contained within this list.
    - `amount` integer, required: The amount refunded, in cents.
    - `clinic_client_id` integer, required: The ID of the client (pet parent) on the invoice.
    - `clinic_id` integer, required: The ID of the clinic that issued the invoice.
    - `created` string, date-time, required: The datetime this object was created.
    - `currency` 'USD' | 'CAD', required
    - `id` integer, required: The unique identifier for the invoice refund.
    - `invoice_id` integer, required: The ID of the invoice this refund is associated with.
    - `invoice_payment_id` integer, required: The ID of the invoice payment this refund is against.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `refund_type` 'CLIENT_CREDIT' | 'STRIPE' | 'EXTERNAL', required
  - `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)