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

# List all invoices

`GET /ext/v2/invoices/`

## Request

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

Returns a list of invoices across all clinics in the organization. By default, only finalized invoices (FINALIZED, LOCKED, IMPORTED) are returned. Use the `status` parameter to filter by specific statuses. The invoices are sorted by creation date, with the most recent appearing first. When using modified filters, results are sorted in descending modification date instead.

An **invoice** represents a bill for services rendered to a clinic patient during a visit. Each invoice is associated with a clinic, a client (pet parent), and contains line items for the services and products provided. Invoices track totals, discounts, payments, and remaining balance.

## 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.
- `is_deleted` 'FALSE' | 'TRUE' | 'ALL': When 'FALSE' (default), filters to non-deleted records only. When 'TRUE', filters to soft-deleted records only. When 'ALL', returns both deleted and non-deleted records.
- `clinic_id` integer, nullable: When provided, filters to invoices for this clinic
- `clinic_client_id` integer, nullable: When provided, filters to invoices for this clinic client
- `status` string[]: List of invoice status values to filter by.

## Response `200`

OK

- ExternalInvoiceSchemaList
  - `data` ExternalInvoiceSchema[], required: A single page of data contained within this list.
    - `amount_paid` integer, required: The amount paid so far for this invoice
    - `clinic_client_id` integer, required: The ID of the client this invoice is for
    - `clinic_id` integer, required: The ID of the clinic which issued this invoice
    - `created` string, date-time, required: The datetime this object was created.
    - `date_posted` string, date-time, required: The datetime this invoice was posted
    - `deleted` string, date-time, nullable, required: The datetime this record was soft deleted.
    - `discount` integer, required: The discount given to the client for this invoice, if any
    - `finalized_at` string, date-time, nullable, required: The datetime at which this invoice was marked as finalized and became due
    - `id` integer, required: The unique identifier for the invoice
    - `is_deleted` boolean, required: Whether this record is soft deleted or not.
    - `locked_at` string, date-time, nullable, required: The datetime at which this invoice was marked as locked
    - `marked_as_collections_at` string, date-time, nullable, required: The datetime at which this invoice was marked as collections (a.k.a. written off)
    - `marked_not_rendered_at` string, date-time, nullable, required: The datetime at which this invoice was marked as not-rendered
    - `modified` string, date-time, required: The datetime this object was last modified; changes to related entities will not update this field.
    - `remaining_balance` integer, required: The remaining balance for this invoice
    - `status` union, required: The status of the invoice
      - 'IN_PROGRESS' | 'READY_FOR_PAYMENT' | 'FINALIZED' | 'LOCKED' | 'IMPORTED'
      - ''
    - `subtotal` integer, required: The subtotal due for this invoice
    - `tax` integer, required: The amount of tax charged to the client for this invoice
    - `total` integer, required: The total amount billed to the client for this invoice
  - `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)