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

# List all invoice payments

`GET /ext/v2/invoice-payments/`

## Request

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

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

An **invoice payment** represents a payment allocation applied toward a specific clinic invoice. When a client (pet parent) makes a payment, it is split across one or more invoices as individual invoice payment records, each tracking the amount applied. Invoice payments 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 payments for this clinic.
- `clinic_client_id` integer, nullable: When provided, filters to invoice payments for this clinic client.
- `invoice_id` integer, nullable: When provided, filters to invoice payments on this invoice.

## Response `200`

OK

- ExternalInvoicePaymentSchemaList
  - `data` ExternalInvoicePaymentSchema[], required: A single page of data contained within this list.
    - `amount` integer, required: The payment amount applied to the invoice, 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.
    - `id` integer, required: The unique identifier for the invoice payment.
    - `invoice_id` integer, required: The ID of the invoice this payment is applied to.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `payment_id` integer, nullable, required: The ID of the payment this invoice payment is linked to, 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)