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

# List all invoices

`GET /ar/invoices`

Retrieve a paginated list of invoices. Supports cursor-based pagination with limit, order, start_after, and end_before query parameters.

## Query parameters

- `limit` integer — Maximum number of results to return. Allowed range: 1 to 1000. Defaults to 1000
- `order` 'asc' | 'desc' — Sort order. Can be 'asc' or 'desc'. Defaults to 'asc'
- `start_after` string, uuid — The ID of the invoice to start the page after (exclusive). When provided, results will begin with the invoice immediately following this ID. Use this for standard forward pagination to get the next page of results. Cannot be combined with end_before.
- `end_before` string, uuid — The ID of the invoice to end the page before (exclusive). When provided, results will end just before this ID and work backwards. Use this for reverse pagination or to retrieve previous pages. Cannot be combined with start_after.

## Response `200`

- ApiV1ArInvoicesPaginatedResponse — Paginated response containing a list of invoices. | Use the page cursor information to fetch additional pages of invoices.
  - `invoices` ApiV1ArInvoicesData[], required — List of invoices in the current page
    - `achDebitEnabled` boolean, required — Whether or not the invoice can be paid via ach debit.
    - `amount` number, required — The total amount of the invoice line items plus taxes
    - `canceledAt` string, yyyy-mm-ddThh:MM:ssZ, nullable — The time when the invoice was canceled.
    - `ccEmails` Email[], required — Emails to be CCed on invoice notifications/reminders.
    - `createdAt` string, yyyy-mm-ddThh:MM:ssZ, required — The timestamp when the invoice was created.
    - `creditCardEnabled` boolean, required — Whether or not the invoice can be paid via credit card. Requires stripe to be setup for the Mercury account.
    - `currencyCode` string, required — ISO 4217 currency code for the invoice (e.g. "USD", "EUR").
    - `customerId` string, uuid, required — Id of the customer the invoice was sent to.
    - `destinationAccountId` string, uuid, required — The Mercury account where invoice payments will be deposited. Use the /api/v1/accounts endpoint to list your accounts and find the corresponding id. Only checking and savings accounts are supported.
    - `dueDate` string, date, required — The due date the invoice should be paid by.
    - `id` string, uuid, required — The ID of the invoice.
    - `internalNote` string, nullable — Internal note for the invoice, visible by users in the mercury organization but not visible to payers.
    - `invoiceDate` string, date, required — The date of the invoice, set by the invoice creator and likely to be context specific to the type of transaction. i.e. it could be a date a service was performed, it does not need to be the date the invoice was created.
    - `invoiceNumber` string, required — The payer facing invoice number/identifier.
    - `payerMemo` string, nullable — Memo for the payer of the invoice.
    - `poNumber` string, nullable — Purchase order number for the invoice if applicable.
    - `slug` string, required — A unique identifier used to build public URLs for this invoice. Use it to construct the payment page URL (https://app.mercury.com/pay/{slug}) or fetch the invoice PDF via /api/v1/ar/invoices/{slug}/pdf.
    - `status` 'Unpaid' | 'Paid' | 'Cancelled' | 'Processing', required — The status of the invoice.
    - `updatedAt` string, yyyy-mm-ddThh:MM:ssZ, required — The timestamp when the invoice was updated.
    - `useRealAccountNumber` boolean, required — Whether or not the invoice payment instructions will show the real account and routing number for the destination account or use virtual account numbers instead.
  - `page` object, required — Pagination information including cursors for navigating to next/previous pages
    - `nextPage` string, uuid — ID for the invoice.
    - `previousPage` string, uuid — ID for the invoice.

## Other responses

- `400` — Invalid `end_before` or `start_after` or `order` or `limit`

---

[API](https://skmtc.net/mercurytechnologies/apis/mercury-api.md) · [All operations](https://skmtc.net/mercurytechnologies/apis/mercury-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mercurytechnologies/mercury-api/revisions/0bdf4a496e03/schema)