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

# List invoices

`GET /api/invoices`

List invoices (faturas) with filters and pagination.

Translates VBA: PTQ_Financeiro_list

## Query parameters

- `year` integer, nullable — Filter by year
- `month` string, nullable — Filter by month(s) — CSV of 1-12 (#695 multi)
- `tipo_documento` string, nullable — Filter by document type(s) — CSV (#695 multi)
- `enviado_contabilidade` boolean, nullable — Filter by sent to accountant
- `search` string, nullable — Search in number, ATCUD, emitter/acquirer NIF or client name
- `client_nif` string, nullable — Filter by client NIF(s) (Faturas.A) — CSV (#695 multi)
- `adquirente_nif` string, nullable — Filter by acquirer/customer NIF(s) (Faturas.B) — CSV
- `emitido` string, nullable — Flow filter: 'vendas' (own PV NIF/NIPC) or 'compras'
- `justification_status` string, nullable — CSV of justified|partially_justified|unjustified|over_justified (#695 multi)
- `payment_status` string, nullable — CSV of paid|partially_paid|unpaid|over_paid (#695 multi)
- `archive_status` string, nullable — CSV of TOConline archive states: enviada|arquivada|erro_arquivo|sem_confirmacao|sem_feedback (#695 multi)
- `pv` string, nullable — Filter by PV the invoice belongs to (uploaded OR cost-center split) — CSV of PontosDeVenda.ID
- `has_cost_center` boolean, nullable — Filter by presence of a cost-center split (true=has one, false=has none)
- `start_date` string, nullable — Filter by dataentrada >= this date (YYYY-MM-DD)
- `end_date` string, nullable — Filter by dataentrada <= this date, inclusive (YYYY-MM-DD)
- `page` integer
- `page_size` integer

## Headers

- `x-api-token` string, nullable

## Response `200`

Successful Response

- object

## Other responses

- `422` — Validation Error

---

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