invoices

List invoices

Get a list of invoices for the organization

get/invoices/

Request

  • Base URL: https://api.agentpaid.io/api/v2
  • URL: https://api.agentpaid.io/api/v2/invoices/
  • Auth: HTTP bearer

Query parameters

limitinteger
offsetinteger
customerIdstring

Filter by customer ID.

externalCustomerIdstring

Filter by customer external ID.

orderIdstring

Filter by the order this invoice was generated from.

status'building' | 'draft' | 'pending' | 'posted' | 'voided' | 'canceled' | 'error'

Filter by invoice status.

paymentStatus'pending' | 'paid' | 'partiallyPaid' | 'overdue' | 'error'

Filter by payment status.

issueDateFromstring

Only invoices whose issue date is on or after this date. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters.

issueDateTostring

Only invoices whose issue date is on or before this date. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters.

dueDateFromstring

Only invoices whose due date is on or after this date. Invoices without a due date are not matched. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters.

dueDateTostring

Only invoices whose due date is on or before this date. Invoices without a due date are not matched. Accepts an ISO 8601 date or date-time. Date-only values (e.g. 2026-06-30) are treated as UTC; date-times without an explicit timezone offset are ambiguous, so include one (e.g. 2026-06-30T00:00:00-05:00) when precision matters.

displayNumberstring

Filter by the invoice number shown on the invoice, whether draft or posted (exact match).

purchaseOrderReferencestring

Filter by purchase order reference (exact match, whitespace-sensitive).

currencystring

Filter by invoice currency code (case-insensitive, e.g. USD).

Response

200

Changes

No recorded changes to this operation across all 1 revision of this API.