---
title: "List invoices you’ve sent (money in). Filter server-side rather than paging and filtering client-side."
method: GET
path: "/invoices"
tags: ["Invoices"]
---

# List invoices you’ve sent (money in). Filter server-side rather than paging and filtering client-side.

`GET /invoices`

## Query parameters

- `limit` string — Page size, 1–100 (default 25).
- `cursor` string — Opaque cursor from a prior response nextCursor.
- `from` string — Inclusive lower bound, YYYY-MM-DD.
- `to` string — Inclusive upper bound, YYYY-MM-DD.
- `recipient` string — Case-insensitive substring match on the recipient name.
- `dueFrom` string — Inclusive lower bound on the due date, YYYY-MM-DD.
- `dueTo` string — Inclusive upper bound on the due date, YYYY-MM-DD.
- `overdue` boolean — Set to true to keep only invoices due strictly before today (UTC). Invoices carry no payment status, so this is a due-date test only.
- `number` string — Case-insensitive exact match on the invoice number.

## Response `200`

A page of invoices.

- object
  - `data` Invoice[], required
    - `id` string, required
    - `number` string, required — The customer-facing invoice number.
    - `title` string, required — The invoice title/description the sender set.
    - `recipient` object, required — Who the invoice is billed to.
      - `name` string, required
      - `email` string, required
    - `dateIssued` string, required — Issue date, 'yyyy-MM-dd'.
    - `dueDate` string, nullable, required — Due date, 'yyyy-MM-dd', or null when the sender left it open.
    - `subtotal` Money, required — An amount as integer minor units plus its currency.
      - `minorUnits` integer, required — Integer minor units (e.g. cents for USD); never a float.
      - `currency` string, required — ISO 4217 currency code, e.g. "USD".
    - `taxTotal` Money, required — An amount as integer minor units plus its currency.
      - `minorUnits` integer, required — Integer minor units (e.g. cents for USD); never a float.
      - `currency` string, required — ISO 4217 currency code, e.g. "USD".
    - `total` Money, required — An amount as integer minor units plus its currency.
      - `minorUnits` integer, required — Integer minor units (e.g. cents for USD); never a float.
      - `currency` string, required — ISO 4217 currency code, e.g. "USD".
  - `nextCursor` string, nullable, required — Pass back as ?cursor for the next page; null on the last page.

---

[API](https://skmtc.dev/joinarc/apis/arc-api.md) · [All operations](https://skmtc.dev/joinarc/apis/arc-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/joinarc/arc-api/revisions/f0dc4aa0fe84/schema)