---
title: "List Client Invoices"
method: POST
path: "/clients/{client_id}/invoices.json"
tags: ["Clients"]
---

# List Client Invoices

`POST /clients/{client_id}/invoices.json`

This method allows you to obtain the invoices for a specific client. You can filter the results by document status, type and if it’s archived or not.

## Path parameters

- `client_id` integer, required

## Query parameters

- `api_key` string, required
- `page` integer
- `per_page` integer

## Request body

- ClientsInvoiceFilterRequest
  - `filter` object — Filters to apply on the list
    - `status` string[]
    - `by_type` string[]
    - `archived` string[]

## Response `200`

SUCCESS. Returns the client's invoices.

- ClientsInvoicesResponse
  - `invoices` object[]
    - `id` integer
    - `status` string
    - `cancel_reason` string — Only present once the document has been canceled — carries the message supplied to change-state.
    - `archived` boolean
    - `type` string
    - `sequence_number` string
    - `inverted_sequence_number` string
    - `date` string
    - `due_date` string
    - `reference` string, nullable
    - `observations` string, nullable
    - `retention` string, nullable
    - `atcud` string
    - `permalink` string
    - `saft_hash` string — Only present once the document has been finalized.
    - `sum` number
    - `discount` number, nullable
    - `before_taxes` number
    - `taxes` number
    - `total` number
    - `currency` string
    - `client` object
      - `id` integer
      - `name` string
      - `email` string, nullable
      - `address` string, nullable
      - `postal_code` string, nullable
      - `city` string, nullable
      - `fiscal_id` string, nullable
      - `country` string
    - `items` object[]
      - `name` string
      - `description` string, nullable
      - `unit_price` string
      - `unit` string, nullable
      - `quantity` string
      - `tax` object
        - `id` integer
        - `name` string
        - `value` number
      - `discount` number
      - `subtotal` number
      - `tax_amount` number
      - `discount_amount` number
      - `total` number
    - `sequence_id` integer, nullable — Absent while the document is still a draft.
    - `tax_exemption` string — Absent unless a tax exemption applies.
  - `pagination` object
    - `total_entries` integer
    - `current_page` integer
    - `total_pages` integer
    - `per_page` integer

## Other responses

- `401` — ACCESS DENIED
- `404` — NOT FOUND

## Changes

- **2026-08-25** `5b82d4eb0d9f` — 9 breaking, 1 warning, 7 info
  - the response property `invoices/items/discount` became nullable for the status `200`
  - the response property `invoices/items/items/items/description` became nullable for the status `200`
  - the response property `invoices/items/items/items/unit` became nullable for the status `200`
  - the response property `invoices/items/observations` became nullable for the status `200`
  - …13 more

[Change history](https://skmtc.dev/invoicexpress/apis/invoicexpress-api/changes/clients/:client_id/invoices.json/post.md)

---

[API](https://skmtc.dev/invoicexpress/apis/invoicexpress-api.md) · [All operations](https://skmtc.dev/invoicexpress/apis/invoicexpress-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/invoicexpress/invoicexpress-api/revisions/59bc808e8784/schema)