GET
/
v2
/
supplier_invoices
curl --request GET \
  --url https://thirdparty.qonto.com/v2/supplier_invoices \
  --header 'Authorization: Bearer <token>'
{
  "supplier_invoices": [
    {
      "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
      "organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
      "file_name": "my-invoice.pdf",
      "invoice_number": "QONTO-JAN-2022",
      "supplier_name": "McDonald's",
      "description": "This is an invoice for Ronald!",
      "total_amount": {
        "value": "22.10",
        "currency": "EUR"
      },
      "issue_date": "2022-02-01",
      "due_date": "2022-03-01",
      "payment_date": "2022-03-01",
      "scheduled_date": "2022-03-01",
      "status": "to_review",
      "iban": "FR1420041010050500013M02606",
      "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source_type": "email",
      "created_at": "2022-03-04T17:58:30+02:00",
      "updated_at": "2022-03-04T17:58:30+02:00",
      "attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "analyzed_at": "2022-03-04T17:58:30+02:00",
      "request_transfer": {
        "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
        "initiator_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
      },
      "is_einvoice": false,
      "einvoicing_lifecycle_events": [
        {
          "status_code": 200,
          "reason": "DOUBLE FACTURE",
          "reason_message": "I already received this invoice",
          "timestamp": "2024-12-04T11:05:16.4497Z"
        }
      ],
      "meta": {
        "integration_type": "amazon",
        "connector": "grover"
      }
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": "<any>",
    "prev_page": "<any>",
    "total_pages": 2,
    "total_count": 150,
    "per_page": 100
  }
}

Authorizations

Authorization
string
header
required

Bearer authorization header: Bearer <token>, where <token> is the access token received from the authorization server at the end of the OAuth 2.0 flow.

Headers

X-Qonto-Staging-Token
string

Required only for Sandbox API requests; to get one, please sign up to the Developer Portal.

Query Parameters

filter[status]
string[]

Invoices can be filtered by their status.

page
integer

Returned page (cf. Pagination).

Example:

1

per_page
integer
default:1

Number of invoices per page (cf. Pagination).

Required range: x <= 100
sort_by
string

Invoices can be sorted by a specific property and order. <br>👉 Property: created_at, file_name, supplier_name, payment_date, due_date, scheduled_date or total_amount <br>👉 Order: asc (Ascending) / desc (Descending) <br>By default: <br>- the invoices to review are sorted by created_at:desc; <br>- the invoices to pay are sorted by payment_date:asc; <br>- the invoices processed are sorted by payment_date:desc.

Example:

"created_at:asc"

filter[created_at_from]
string

Invoices can be filtered by their created_at property. Can be use in combination with the created_at_to query parameter to get invoices created within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2025-07-23T13:35:36Z"

filter[created_at_to]
string

Invoices can be filtered by their created_at property. Can be use in combination with the created_at_from query parameter to get invoices created within a specific timeframe. Please use a valid date time format (ISO 8601 for instance).

Example:

"2026-07-23T13:35:36Z"

Response

200
application/json
Returns the list of suppliers invoices.

The response is of type object.