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

# List Invoices

`GET /billing/invoices`

## Request

- Base URL: `https://api.meow.com/v1`
- URL: `https://api.meow.com/v1/billing/invoices`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/meow/apis/meow-api/docs/billing/invoices/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists all invoices.

## Headers

- `x-entity-id` string, uuid

## Response `200`

Successful Response

- Invoice[]
  - `id` string, uuid, required: The unique identifier for the invoice.
  - `name` string, nullable: The name of the invoice.
  - `customer_id` string, uuid, required: The unique identifier for the customer.
  - `status` 'Draft' | 'Open' | 'Pending' | 'Scheduled' | 'Partially Paid' | 'Paid' | 'Canceled' | 'Expired' | 'Overdue', required
  - `amount` string, required: The total amount of the invoice.
  - `amount_paid` string, required: The amount that has been paid on the invoice.
  - `amount_due` string, required: The remaining amount due on the invoice.
  - `invoice_number` string, nullable: The public-facing invoice number.
  - `line_item_ids` string[], required: List of line item IDs associated with the invoice.
  - `invoice_date` string, date: ISO 8601 full-date in the format `YYYY-MM-DD` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
  - `due_date` string, date: ISO 8601 full-date in the format `YYYY-MM-DD` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
  - `payment_method_types` PaymentMethodType[], required: List of allowed payment method types for the invoice.
  - `send_email_on_creation` boolean, required: Whether to send an email upon invoice creation.
  - `additional_recipient_emails` string[], required: List of additional email addresses to receive the invoice.
  - `note` string, nullable: A note associated with the invoice.
  - `collection_account_id` string, uuid, required: The collection account ID where funds will be collected.
  - `created_at` string, date-time, required: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
  - `updated_at` string, date-time: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
  - `paid_at` string, date-time: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
  - `canceled_at` string, date-time: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
  - `sent_at` string, date-time: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).
  - `expired_at` string, date-time: ISO 8601 date-time in the format `YYYY-MM-DDThh:mm:ss.nnn[Z|[+|-]hh:mm]` (per [IETF RFC 3339](https://xml2rfc.tools.ietf.org/public/rfc/html/rfc3339.html#anchor14)).

## Other responses

- `400`: The request could not be processed.
- `401`: Authentication failed.
- `403`: The API key is not authorized for this operation, or the user of a global API key is an admin or controller without approved KYC. The KYC case returns the message `KYC is required for controllers and admins.` until that user completes KYC in the Meow dashboard.
- `429`: Too many requests.

---

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