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

# List invoices

`GET /invoices`

Returns a paginated list of invoices with filtering and statistics

## Query parameters

- `year` string
- `clients` integer[]
- `client_id` integer
- `projects` integer[]
- `statuses` string[]
- `search` string
- `sort` 'document_id' | 'issue_date' | 'project_name' | 'client_name' | 'total' | 'amount_paid' | 'amount_outstanding' | 'invoice_status'
- `direction` 'asc' | 'desc'
- `per_page` integer

## Response `200`

Successful response

- object
  - `data` Invoice[]
    - `id` integer
    - `client_id` integer, nullable
    - `project_id` integer, nullable
    - `uuid` string, uuid
    - `document_id` string
    - `po_number` string, nullable
    - `subject` string, nullable
    - `issue_date` string, date
    - `payment_due` integer — Days until payment due
    - `due_date` string, date
    - `status` 'draft' | 'sent' | 'viewed' | 'partial' | 'paid' | 'processing'
    - `shipping` number
    - `discount` number
    - `total` number
    - `amount_paid` number
    - `amount_due` number
    - `outstanding` number
    - `company_name` string, nullable
    - `address` string, nullable
    - `email` string, email, nullable
    - `phone` string, nullable
    - `note` string, nullable
    - `send_at` string, date-time, nullable
    - `auto_billing` boolean
    - `online_payment` boolean
    - `accept_ach` boolean
    - `hide_qty_price_columns` boolean
    - `automatically_send_payment_reminders` boolean
    - `created_at` string, date-time
  - `meta` object

## Other responses

- `401` — Unauthenticated

---

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