---
title: "List invoices"
method: GET
path: "/accounting/invoices"
tags: ["Accounting"]
---

# List invoices

`GET /accounting/invoices`

## Request

- Base URL: `https://unify.apideck.com`
- URL: `https://unify.apideck.com/accounting/invoices`
- Auth: API key in header `Authorization`

Returns a paginated list of invoices from the connected accounting platform.

## Query parameters

- `cursor` string, nullable
- `limit` integer

## Headers

- `x-apideck-consumer-id` string, required
- `x-apideck-app-id` string, required
- `x-apideck-service-id` string

## Response `200`

Invoices returned

- InvoicesResponse
  - `status_code` integer
  - `status` string
  - `data` Invoice[]
    - `id` string
    - `number` string
    - `status` 'draft' | 'submitted' | 'authorised' | 'paid' | 'voided'
    - `currency` string
    - `total_amount` number
    - `balance` number
    - `invoice_date` string, date-time
    - `due_date` string, date-time
    - `updated_at` string, date-time
  - `meta` Meta: Cursor-based pagination metadata.
    - `items_on_page` integer
    - `cursors` object
      - `previous` string, nullable
      - `current` string, nullable
      - `next` string, nullable

## Other responses

- `400`: Request validation failed.
- `401`: Missing or invalid API key.
- `404`: The requested resource, connection, or connector could not be found.

---

[API](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api.md) · [All operations](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api/llms.txt) · [OpenAPI document](https://skmtc.dev/apideck-libraries/apis/apideck-unified-api/revisions/1814558af2d7?raw)