mercury_list_invoices
List invoices with cursor-based pagination to support AR audits, locate invoice IDs for updates or cancellations, and generate dunning reports.
Instructions
List invoices in your Mercury workspace, with cursor-based pagination.
USE WHEN: enumerating invoices for an AR audit, finding the ID of an invoice to update/cancel, or building a dunning report. Use startAfter / endBefore to page beyond the limit.
DO NOT USE: for one invoice whose ID is known (prefer mercury_get_invoice). Mercury does not currently support filtering by status or customer at the API level — filter client-side after listing.
RETURNS: { invoices: [{ id, status, amount, customerId, dueDate, ... }] }.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max results to return (1-1000). Default: 1000 | |
| order | No | Sort order. Default: asc | |
| startAfter | No | Pagination: return invoices after this ID | |
| endBefore | No | Pagination: return invoices before this ID |