List invoices

Operation ID: invoices

Group: Accounting › Invoices

Open in the interactive reference

GET /accounting/invoices

Read-only: Reads and returns; changes nothing.

Lists invoices. The collection doesn't include lines, billToAddress, soldToAddress, purchaseOrders, or externalIdentifiers. To get these fields, use GET accounting/invoices/:id or POST accounting/invoices/search.

To filter by invoiceNumber, customerName, customerNumber, entityName, salesOrderNumber, billToAddress, soldToAddress, invoiceEmail, purchaseOrderOverride, externalInvoiceId, customerMessage, or externalIdentifier, use POST accounting/invoices/search.

Parameters

Query surface

• id — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• invoiceDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• dueDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• lastPaidDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• invoiceStatus — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• approvalStatus — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• deliveryStatus — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• disputeStatus — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• dataSource — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• currency — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• paymentTermDays — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• exchangeRate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• excludeFromTaxEngine — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• customerId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• entityId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• salesOrderId — filter by eq, ne, gt, gte, lt, lte, in, notIn, between, like
• subtotal — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• totalTax — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• totalDutiesAndCustoms — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• totalAmount — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• totalAmountDue — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• totalCredited — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• totalLateFeeAmount — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• lineDiscounts — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• oneTimeDiscount — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• paymentsApplied — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• adjustments — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• lastModifiedDate — filter by eq, ne, gt, gte, lt, lte, in, notIn, between
• Orderable: id, invoiceDate, dueDate, lastPaidDate, invoiceStatus, approvalStatus, deliveryStatus, disputeStatus, dataSource, currency, customerId, entityId, salesOrderId, paymentTermDays, exchangeRate, excludeFromTaxEngine, subtotal, totalTax, totalDutiesAndCustoms, totalAmount, totalAmountDue, totalCredited, totalLateFeeAmount, lineDiscounts, oneTimeDiscount, paymentsApplied, adjustments, lastModifiedDate
• Selectable: id, invoiceNumber, invoiceDate, dueDate, lastPaidDate, invoiceStatus, approvalStatus, deliveryStatus, disputeStatus, dataSource, currency, customerMessage, externalInvoiceId, invoiceEmail, purchaseOrderOverride, paymentTermDays, exchangeRate, excludeFromTaxEngine, customerId, customerName, customerNumber, entityId, entityName, salesOrderId, salesOrderNumber, subtotal, totalTax, totalDutiesAndCustoms, totalAmount, totalAmountDue, totalCredited, totalLateFeeAmount, lineDiscounts, oneTimeDiscount, paymentsApplied, adjustments, lastModifiedDate
• page[size] — Page size
• page[cursor] — Opaque continuation cursor

Response

200 Success

Under data, an array of invoicesRow:

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "invoiceNumber": "<invoiceNumber>",
      "invoiceDate": "2026-01-15",
      "dueDate": "2026-01-15",
      "lastPaidDate": "2026-01-15",
      "invoiceStatus": "<invoiceStatus>",
      "approvalStatus": "<approvalStatus>",
      "deliveryStatus": "<deliveryStatus>",
      "disputeStatus": "<disputeStatus>",
      "dataSource": "<dataSource>",
      "currency": "<currency>",
      "customerMessage": "<customerMessage>",
      "externalInvoiceId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "invoiceEmail": "<invoiceEmail>",
      "purchaseOrderOverride": "<purchaseOrderOverride>",
      "paymentTermDays": 0,
      "exchangeRate": "19.99",
      "excludeFromTaxEngine": true,
      "customerId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "customerName": "<customerName>",
      "customerNumber": "<customerNumber>",
      "entityId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "entityName": "<entityName>",
      "salesOrderId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "salesOrderNumber": "<salesOrderNumber>",
      "subtotal": "19.99",
      "totalTax": "19.99",
      "totalDutiesAndCustoms": "19.99",
      "totalAmount": "19.99",
      "totalAmountDue": "19.99",
      "totalCredited": "19.99",
      "totalLateFeeAmount": "19.99",
      "lineDiscounts": "19.99",
      "oneTimeDiscount": "19.99",
      "paymentsApplied": "19.99",
      "adjustments": "19.99",
      "lastModifiedDate": "2026-01-15T09:30:00.000Z"
    }
  ],
  "pagination": {
    "hasMore": true,
    "nextCursor": "<nextCursor>"
  }
}

Statuses

• 400 — Invalid request or business failure
• 401 — The request carries no valid access token.
• 403 — Not authorized
• 404 — Not found
• 429 — Too many requests from this client address. The response has no body and no Retry-After header.
• 500 — Internal server error