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

# List all payments

`GET /ext/v2/payments/`

## Request

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

Returns a list of all 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.

A **payment** represents a payment made by a clinic client (pet parent). Payments can be made via credit card, cash, check, client credit, or other external payment methods. Each payment records the amount, type, and current status of the transaction. 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 payments for this clinic.
- `clinic_client_id` integer, nullable: When provided, filters to payments for this clinic client.

## Response `200`

OK

- ExternalPaymentSchemaList
  - `data` ExternalPaymentSchema[], required: A single page of data contained within this list.
    - `amount` integer, required: The payment amount in cents.
    - `clinic_client_id` integer, required: The ID of the clinic client who made this payment.
    - `clinic_id` integer, required: The ID of the clinic associated with this payment.
    - `created` string, date-time, required: The datetime this object was created.
    - `currency` 'USD' | 'CAD', required
    - `id` integer, required: The unique identifier for the payment.
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `payment_link_id` integer, nullable, required: The ID of the payment link used for this payment, if any.
    - `payment_type` 'CARD_SAVED' | 'CARD_READER' | 'CLIENT_CREDIT' | 'CASH' | 'CHECK' | 'CUSTOM', required
    - `recorded_at` string, date-time, required: When this payment was officially recorded.
    - `status` 'PENDING' | 'COMPLETED' | 'CANCELED' | 'FAILED' | 'VOIDED', required
    - `void_reason` string, required: The reason this payment was voided, if applicable.
    - `voided_at` string, date-time, nullable, required: When this payment was voided, if applicable.
  - `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)