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

# List Invoices

`GET /v5/invoices`

Retrieve a list of all invoices for the merchant with optional filtering and pagination.

## Query parameters

- `status` 'open' | 'closed' | 'paid' | 'overdue' | 'draft'
- `customer_id` string
- `date_from` string, date
- `date_to` string, date
- `cursor` integer
- `per_page` integer

## Response `200`

Success

- object
  - `invoices` InvoiceResponse[]
    - `object` 'invoice', required — Resource type identifier
    - `id` integer, required — Invoice ID
    - `status` 'open' | 'partially_paid' | 'paid' | 'closed' | 'overdue' — Current status of the invoice
    - `amount` string — Total amount of the invoice. Format: `x.xx`
    - `subtotal` number, nullable — Subtotal amount before tax and shipping
    - `payment_terms` string — Payment terms for the invoice (e.g., 'Due Upon Receipt', '30 days')
    - `payment_methods_allowed` string[] — Allowed payment methods: 'cc' = Credit Card, 'ck' = Check, 'cs' = Cash
    - `processor_id` string, nullable — Processor ID for payment processing
    - `currency` string — Currency code (ISO 4217, e.g., USD, EUR)
    - `created_date` string, date-time, nullable — Date and time when the invoice was created in UTC ISO 8601 format
    - `updated_date` string, date-time, nullable — Date and time when the invoice was last updated in UTC ISO 8601 format
    - `billing_address` object — Billing address information
      - `first_name` string — First name
      - `last_name` string — Last name
      - `company` string — Company name
      - `email` string, email — Email address
      - `phone` string — Phone number
      - `fax` string — Fax number
      - `website` string — Website
      - `address1` string — Address line 1
      - `address2` string — Address line 2
      - `city` string — City
      - `state` string — State or province
      - `zip` string — ZIP or postal code
      - `country` string — Country code (ISO 3166-1 alpha-2)
    - `shipping_address` object — Shipping address information
      - `first_name` string — First name
      - `last_name` string — Last name
      - `company` string — Company name
      - `email` string, email — Email address
      - `address1` string — Address line 1
      - `address2` string — Address line 2
      - `city` string — City
      - `state` string — State or province
      - `zip` string — ZIP or postal code
      - `country` string — Country code (ISO 3166-1 alpha-2)
    - `order_details` object — Order details
      - `order_id` string — Order ID
      - `ip_address` string — IP address
      - `order_description` string — Order description
      - `po_number` string — Purchase order number
      - `customer_id` string — Customer ID
      - `customer_tax_id` string — Customer tax ID
      - `tax` string — Tax amount. Format: `x.xx`
      - `shipping` string — Shipping amount. Format: `x.xx`
      - `discount_amount` string — Discount amount. Format: `x.xx`
      - `surcharge` string — Surcharge amount. Format: `x.xx`
      - `tip` string — Tip amount. Format: `x.xx`
      - `shipping_carrier` string — Shipping carrier
      - `tracking_number` string — Tracking number
      - `shipping_date` string, date-time, nullable — Shipping date in UTC ISO 8601 format
    - `merchant_defined_fields` object — Merchant defined fields
  - `next_cursor` integer, nullable — Cursor for the next page. Use this value in the cursor parameter for the next request. Null if there are no more results.
  - `per_page` integer — Number of invoices per page

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/nmi/apis/embedded-components-api.md) · [All operations](https://skmtc.net/nmi/apis/embedded-components-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nmi/embedded-components-api/versions/45c2ecda3685/schema)