---
title: "List all Invoices"
method: POST
path: "/list"
---

# List all Invoices

`POST /list`

## Request

- Base URL: `https://api.tap.company/v2/invoices`
- URL: `https://api.tap.company/v2/invoices/list`
- Auth: API key in header `Authorization`

## Request body

- object
  - `period` object: Retrieve invoices for a selected period
    - `date` object: Retrieve invoices for a selected period
      - `from` string: From date (invoice created date), Measured in Unix Epoch Timestamp (milliseconds).
      - `to` string: To date (invoice created date), Measured in Unix Epoch Timestamp (milliseconds).
  - `reference` object
    - `invoice` string[]
    - `order` string[]
  - `track` string[]: The value by which the list of invoices needs to be retrieved. Accepted values: VIEWED, DELIVERED, NOT_DELIVERED, REMINDED, CREATED, UPDATED, PAYMENT_ATTEMPT, PAYMENT_FAILED, PAID, EXPIRED, REFUNDED, CANCELLED, DRAFT
  - `page` integer
  - `limit` integer: The maximum number of invoices to return in a single call. Default: 25; Maximum: 50.
  - `order_by` string
  - `order` string: Accepted values: reverse_chronological, chronological

## Response `200`

200

- object

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/tap/apis/invoices.md) - [All operations](https://skmtc.dev/tap/apis/invoices/llms.txt) - [OpenAPI document](https://skmtc.dev/tap/apis/invoices/revisions/cbf5bdc1152b?raw)