---
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
    - `archived` boolean
    - `type` string
    - `sequence_number` string
    - `inverted_sequence_number` string
    - `date` string
    - `due_date` string
    - `reference` string
    - `observations` string
    - `retention` string
    - `permalink` string
    - `saft_hash` string
    - `sum` number
    - `discount` number
    - `before_taxes` number
    - `taxes` number
    - `total` number
    - `currency` string
    - `client` object
      - `id` integer
      - `name` string
      - `country` string
    - `items` object[]
      - `name` string
      - `description` string
      - `unit_price` string
      - `unit` string
      - `quantity` string
      - `tax` object
        - `id` integer
        - `name` string
        - `value` number
      - `discount` number
      - `subtotal` number
      - `tax_amount` number
      - `discount_amount` number
      - `total` number
    - `sequence_id` string
    - `tax_exemption` string
  - `pagination` object
    - `total_entries` integer
    - `current_page` integer
    - `total_pages` integer
    - `per_page` integer

## Other responses

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

---

[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)