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

# GET /invoices/

`GET /invoices/`

## Request

- Base URL: `https://ipaidthat.io/inv/api/v3`
- URL: `https://ipaidthat.io/inv/api/v3/invoices/`
- Auth: API key in header `Authorization`

List all your Invoices

## Query parameters

- `external_id` string
- `type` string
- `status` string
- `issue_date` string
- `invoice_number` string
- `number` string
- `generated_number` string
- `due_date` string
- `sent` string
- `customer_id` string
- `sender_id` string
- `customer` string
- `sender` string
- `updated` string
- `min_updated` string
- `max_updated` string

## Response `200`

OK

- Invoice[]
  - `id` integer
  - `external_id` string, nullable
  - `issue_date` string, date
  - `type` 'invoice' | 'credit' | 'quote' | 'order' | 'delivery' | 'proforma' | 'other'
  - `title` string: Pour remplacer "FACTURE" par autre chose si le type est réglé sur "autre".
  - `invoice_number` string: Final number will only be returned after validation. The mention Auto: show the number to be used.
  - `due_date` string, date, nullable
  - `shipping` string, decimal, nullable
  - `c_field_name_1` string
  - `c_field_value_1` string
  - `c_field_name_2` string
  - `c_field_value_2` string
  - `sender` integer, nullable
  - `customer` integer, nullable
  - `draft` boolean
  - `multi_page` boolean: Optimise la génération de documents de plusieurs pages.
  - `status` 'draft' | 'updating' | 'validated' | 'not paid' | 'partially paid' | 'past due' | 'paid' | 'canceled' | 'accepted' | 'rejected'
  - `paid` boolean
  - `total` number
  - `tax_amount` number
  - `subtotal` number
  - `updated` string, date-time
  - `created` string, date-time

## Changes

- **2023-12-19** `95686d5f0b8b`: 3 info
  - added the new optional `query` request parameter `max_updated`
  - added the new optional `query` request parameter `min_updated`
  - added the new optional `query` request parameter `updated`

[Operation history](https://skmtc.dev/hiit-consulting-fr/apis/inv-ipaidthat-invoicing-api/changes/invoices/get.md)

---

[API](https://skmtc.dev/hiit-consulting-fr/apis/inv-ipaidthat-invoicing-api.md) - [All operations](https://skmtc.dev/hiit-consulting-fr/apis/inv-ipaidthat-invoicing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hiit-consulting-fr/apis/inv-ipaidthat-invoicing-api/revisions/0a219b4474b8?raw)