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

# List invoices

`GET /invoices`

## Query parameters

- `page` integer
- `per_page` integer
- `sort` string[]
- `order` 'asc' | 'desc'
- `q[]` string[]

## Response `200`

successful operation

- object
  - `invoices` Invoice[]
    - `appointment` object
      - `links` object
        - `self` string, uri
    - `archived_at` string, date-time, nullable
    - `attendee` object
      - `links` object
        - `self` string, uri
    - `business` object
      - `links` object
        - `self` string, uri
    - `calculation_method` 1 | 2 | 3, nullable — | Enum Value | Description | |---|---| | 1 | Legacy | | 2 | Tax exclusive | | 3 | Tax inclusive |
    - `calculation_method_description` 'Legacy' | 'Tax exclusive' | 'Tax inclusive', nullable
    - `closed_at` string, date-time, nullable
    - `created_at` string, date-time
    - `deleted_at` string, date-time, nullable
    - `discounted_amount` string, decimal, nullable
    - `id` string, int64
    - `invoice_items` object
      - `links` object
        - `self` string, uri
    - `invoice_to` string, nullable
    - `issue_date` string, date
    - `links` object
      - `self` string, uri
    - `net_amount` string, decimal, nullable
    - `notes` string, nullable
    - `number` integer
    - `online_payment_url` string, uri, nullable
    - `original_invoice` object
      - `links` object
        - `self` string, uri
    - `patient` object
      - `links` object
        - `self` string, uri
    - `patient_extra_information` string, nullable
    - `practitioner` object
      - `links` object
        - `self` string, uri
    - `reversed_invoices` object
      - `links` object
        - `self` string, uri
    - `signature` object
      - `links` object
        - `self` string, uri
    - `status` 10 | 20 | 30 | 40, nullable — | Enum Value | Description | |---|---| | 10 | Open | | 20 | Paid | | 30 | Closed | | 40 | Open credit |
    - `status_description` 'Open' | 'Paid' | 'Closed' | 'Open credit', nullable
    - `tax_amount` string, decimal, nullable
    - `total_amount` string, decimal, nullable
    - `updated_at` string, date-time
  - `total_entries` integer
  - `links` object
    - `self` string, uri
    - `previous` string, uri
    - `next` string, uri

---

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