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

# List all invoices

`GET /invoices`

Retrieve a list of invoices for the authenticated team.

## Query parameters

- `cursor` string, nullable — A cursor for pagination, representing the last item from the previous page.
- `sort` string[], nullable — Sort as [column, direction]. Columns: created_at, due_date, issue_date, amount, status, customer, invoice_number. Direction: asc or desc.
- `pageSize` number — Number of invoices to return per page (1-100).
- `q` string, nullable — Search query string to filter invoices by text.
- `start` string, nullable — Start date (inclusive) for filtering invoices, in ISO 8601 format.
- `end` string, nullable — End date (inclusive) for filtering invoices, in ISO 8601 format.
- `statuses` string[], nullable — List of invoice statuses to filter by (e.g., 'paid', 'unpaid', 'overdue').
- `customers` string[], nullable — List of customer IDs to filter invoices.
- `ids` string[], nullable — List of invoice IDs to filter by.
- `recurringIds` string[], nullable — List of recurring series IDs to filter invoices by (shows all invoices from these series).
- `recurring` boolean, nullable — Filter by recurring status. true = only recurring invoices, false = only non-recurring invoices.

## Response `200`

A list of invoices for the authenticated team.

- object — Response containing a list of invoices and pagination metadata
  - `meta` object, required — Pagination metadata
    - `cursor` string, nullable, required — Cursor for pagination; null if there is no next page
    - `hasPreviousPage` boolean, required — Indicates if there is a previous page of results
    - `hasNextPage` boolean, required — Indicates if there is a next page of results
  - `data` object[], required — Array of invoice objects
    - `id` string, uuid, required — Unique identifier for the invoice
    - `status` 'draft' | 'overdue' | 'paid' | 'unpaid' | 'canceled' | 'scheduled', required — Current status of the invoice
    - `dueDate` string, required — Due date of the invoice in ISO 8601 format
    - `issueDate` string, required — Issue date of the invoice in ISO 8601 format
    - `invoiceNumber` string — Invoice number as shown to the customer (auto-generated if not provided)
    - `amount` number, nullable, required — Total amount of the invoice, or null if not yet calculated
    - `currency` string, nullable, required — Currency code (ISO 4217) for the invoice amount
    - `customer` object, nullable, required — Customer details
      - `id` string, uuid, required — Unique identifier for the customer
      - `name` string, required — Name of the customer
      - `website` string, nullable, required — Website URL of the customer
      - `email` string, email, nullable, required — Email address of the customer
    - `paidAt` string, nullable, required — Timestamp when the invoice was paid (ISO 8601), or null if unpaid
    - `reminderSentAt` string, nullable, required — Timestamp when a payment reminder was sent (ISO 8601), or null if never sent
    - `note` string, nullable, required — Optional note attached to the invoice
    - `vat` number, nullable, required — Value-added tax amount, or null if not applicable
    - `tax` number, nullable, required — Tax amount, or null if not applicable
    - `discount` number, nullable, required — Discount amount applied to the invoice, or null if none
    - `subtotal` number, nullable, required — Subtotal before taxes and discounts, or null if not calculated
    - `viewedAt` string, nullable, required — Timestamp when the invoice was viewed by the customer (ISO 8601), or null if never viewed
    - `customerName` string, nullable, required — Name of the customer as shown on the invoice, or null if not set
    - `sentTo` string, email, nullable, required — Email address to which the invoice was sent, or null if not sent
    - `sentAt` string, nullable, required — Timestamp when the invoice was sent (ISO 8601), or null if not sent
    - `createdAt` string, required — Timestamp when the invoice was created (ISO 8601)
    - `updatedAt` string, required — Timestamp when the invoice was last updated (ISO 8601)
    - `pdfUrl` string, uri, nullable, required — URL to download the invoice PDF, or null if not generated
    - `previewUrl` string, uri, nullable, required — URL to preview the invoice in the browser, or null if not generated

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.net/midday-ai/apis/midday-api.md) · [All operations](https://skmtc.net/midday-ai/apis/midday-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/midday-ai/midday-api/versions/c0df9243c1b0/schema)