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

# List all invoices

`GET /invoices`

## Request

- Base URL: `https://app-sandbox.resolvepay.com/api`
- URL: `https://app-sandbox.resolvepay.com/api/invoices`
- Auth: one of:
  - HTTP bearer
  - HTTP basic
- TypeScript: <https://skmtc.dev/resolvepay/apis/resolve-api-reference/docs/invoices/get.ts> (a function with typed inputs; its response is checked against the schema)

Return a list of invoices.

## Query parameters

- `limit` integer
- `page` string
- `invoice_status` 'ready_to_send' | 'open' | 'paid' | 'captured' | 'processing_payment' | 'past-due'
- `filter` object
  - `number` object
    - `eq` string
  - `order_number` object
    - `eq` string
  - `po_number` object
    - `eq` string
  - `customer_id` object
    - `eq` string
  - `created_at` object
    - `eq` string, date-time
    - `gt` string, date-time
    - `lt` string, date-time
    - `gte` string, date-time
    - `lte` string, date-time
  - `fully_paid` object
    - `eq` boolean
    - `ne` boolean
  - `fully_paid_at` object
    - `eq` string, date-time
    - `gt` string, date-time
    - `lt` string, date-time
    - `gte` string, date-time
    - `lte` string, date-time
  - `amount_due` object
    - `eq` number
    - `gt` number
    - `lt` number
    - `gte` number
    - `lte` number
  - `amount_balance` object
    - `eq` number
    - `gt` number
    - `lt` number
    - `gte` number
    - `lte` number
  - `amount_pending` object
    - `eq` number
    - `gt` number
    - `lt` number
    - `gte` number
    - `lte` number
  - `amount_refunded` object
    - `eq` number
    - `gt` number
    - `lt` number
    - `gte` number
    - `lte` number
  - `archived` object
    - `eq` boolean
    - `ne` boolean

## Response `200`

An object with an array of results containing up to the limit. If no invoices are found, the results array will be empty.

- InvoiceListResponse
  - `count` integer
  - `limit` integer
  - `page` integer
  - `results` Invoice[]
    - `id` string: Unique identifier for the invoice.
    - `source` 'QUICKBOOKS' | 'MERCHANT_USER' | 'ADMIN_USER' | 'CUSTOMER_USER' | 'API'
    - `customer_id` string: ID of the customer being charged.
    - `order_number` string: Order number identifier.
    - `number` string: Invoice number identifier.
    - `po_number` string: PO number identifier.
    - `notes` string: Additional notes for the Customer
    - `line_items` unknown[]: Line item data
      - unknown
    - `merchant_invoice_url` string: The invoice PDF that you've uploaded to Resolve.
    - `resolve_invoice_url` string: Resolve-issued invoice PDF with your invoice attached.
    - `resolve_invoice_status` 'not_generated' | 'processing' | 'completed': Shows current status of the Resolve-issued invoice PDF. - `not_generated` - PDF wasn't created or queued for creation. Resolve PDFs are generated when an invoice is sent. - `processing` - PDF is in the process of being generated. Try to refetch the invoice in a minute to get a `resolve_invoice_url` link. - `completed` - PDF is generated, `resolve_invoice_url` points to the generated file.
    - `fully_paid` boolean: Indicates whether the invoice is fully paid.
    - `fully_paid_at` string, date-time: The date the invoice has been fully paid.
    - `advanced` boolean: Indicates whether the invoice has been advanced.
    - `due_at` string, date-time: The current due date for this invoice's payment.
    - `original_due_at` string, date-time: The due date for this invoice at the time an advance was issued.
    - `invoiced_at` string, date-time: The date this invoice was created in your system of record (Resolve or Quickbooks).
    - `advance_requested` boolean: Indicated if advance was requested.
    - `terms` 'due_upon_receipt' | 'net7' | 'net10' | 'net10th' | 'net15' | 'net20' | 'net30' | 'net45' | 'net60' | 'net75' | 'net90' | 'net120' | 'net180': The terms selected for this invoice.
    - `amount_payout_due` number, double: The original amount that Resolve owed on this invoice on the advance date.
    - `amount_payout_paid` number, double: The amount that Resolve has paid out.
    - `amount_payout_pending` number, double: The amount that Resolve has currently pending to be paid out.
    - `amount_payout_refunded` number, double: The amount that Resolve has debited from due to refunds.
    - `amount_payout_balance` number, double: The amount remaining to be paid out.
    - `payout_fully_paid` boolean: The status of whether or not this invoice has been fully paid out.
    - `payout_fully_paid_at` string, date-time: The date of when this invoice has been fully paid out.
    - `amount_balance` number, double: Current balance due.
    - `amount_due` number, double: Original amount due.
    - `amount_refunded` number, double: Amount that has been refunded.
    - `amount_pending` number, double: Amount of total payments pending.
    - `amount_paid` number, double: Amount of total payments applied to this invoice.
    - `amount_advance` number, double: Amount of advance received.
    - `amount_additional_advance` number, double: Amount of additional advance received.
    - `amount_advance_fee` number, double: Fee for the amount of advance.
    - `amount_advance_fee_refund` number, double: Refunded fees for the amount of advance.
    - `advance_rate` number, double: The advance rate that was used to determine amount of advance.
    - `advanced_at` string, date-time: The date this invoice was advanced.
    - `amount_customer_fee_total` number, double: The total amount of customer fees accrued.
    - `amount_customer_fee_waived` number, double: The total amount of customer fees waived.
    - `amount_customer_fee_paid` number, double: The total amount of customer fees paid.
    - `amount_customer_fee_balance` number, double: The current amount of customer fees owed.
    - `created_at` string, date-time: Date the invoice was created.
    - `updated_at` string, date-time: Date the invoice was last updated.
    - `archived` boolean: Boolean indicating if invoice is archived.
    - `invoice_payment_url` string: Link to make invoice payments.
    - `canceled` boolean: Indicates whether the invoice is canceled.
    - `canceled_at` string, date-time: Date the invoice was canceled.
    - `voided` boolean: Indicates whether the invoice is voided.
    - `voided_at` string, date-time: Date the invoice was voided.
    - `amount_canceled` number, double: Amount that has been canceled.
    - `amount_voided` number, double: Amount that has been voided.

## Other responses

- `400`: Bad request error
- `401`: Unauthorized error
- `429`: Rate limit error

---

[API](https://skmtc.dev/resolvepay/apis/resolve-api-reference.md) - [All operations](https://skmtc.dev/resolvepay/apis/resolve-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/resolvepay/apis/resolve-api-reference/revisions/c62edc454aaa?raw)