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

# List All

`GET /invoices.json`

Returns a list of invoices.

## Query parameters

- `api_key` string, required
- `Query Parameters` QueryParamns
  - `type[]` string[], required — Type(s) of document.
  - `status[]` string[], required — Status(es) of document.
  - `non_archived` boolean, required — Show non-archived documents.
  - `archived` boolean — Include archived docs
  - `text` string — Filter by client/doc text
  - `reference` string — Filter by reference
  - `date[from]` string — Start date (dd/mm/yyyy)
  - `date[to]` string — End date (dd/mm/yyyy)
  - `due_date[from]` string — Due date start
  - `due_date[to]` string — Due date end
  - `total_before_taxes[from]` number — Min value
  - `total_before_taxes[to]` number — Max value
  - `page` integer — Page number
  - `per_page` integer — Items per page

## Response `200`

SUCCESS 

Creates a new quote, proforma or fees_note.

#### Possible values for field atcud:

* ABCD1234-1 (or similar) - Unique document identifier to the Tax Authority, when the sequence is registered.
* N/D - The document's sequence is relevant for ATCUD but is not registered in the Tax Authority.
* N/A - The document's sequence is not relevant for ATCUD and is not registered in the Tax Authority.

- InvoiceListAllResponse
  - `invoices` object[]
    - `id` integer
    - `status` string
    - `archived` boolean
    - `type` string
    - `sequence_number` string
    - `inverted_sequence_number` string
    - `atcud` string
    - `date` string — dd/mm/yyyy
    - `due_date` string — dd/mm/yyyy
    - `reference` string
    - `observations` string
    - `retention` string
    - `permalink` string
    - `saft_hash` string
    - `sum` number
    - `discount` number
    - `before_taxes` number
    - `taxes` number
    - `total` number
    - `currency` string
    - `sequence_id` string
    - `tax_exemption` string
    - `client` object
      - `id` integer
      - `name` string
      - `country` string
    - `items` object[]
      - `name` string
      - `description` string
      - `unit_price` string
      - `unit` string
      - `quantity` string
      - `discount` number
      - `subtotal` number
      - `tax_amount` number
      - `discount_amount` number
      - `total` number
      - `tax` object
        - `id` integer
        - `name` string
        - `value` number
  - `pagination` Pagination
    - `total_entries` integer
    - `per_page` integer
    - `current_page` integer
    - `total_pages` integer

## Other responses

- `401` — ACCESS DENIED

---

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