Skip to main content
GET
/
v2
/
supplier_invoices
List 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",
      "is_einvoice": false,
      "has_discrepancies": false,
      "e_invoice_type": "zugferd",
      "has_duplicates": false,
      "organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
      "file_name": "my-invoice.pdf",
      "invoice_number": "QONTO-JAN-2022",
      "supplier_name": "McDonald's",
      "vat_number": "IT12345678901",
      "tin": "1234567890",
      "description": "This is an invoice for Ronald!",
      "total_amount": {
        "value": "22.10",
        "currency": "EUR"
      },
      "issue_date": "2022-03-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",
      "source": "email_forward",
      "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",
      "display_attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "is_attachment_invoice": true,
      "attachment_category": "INVOICE",
      "is_attachment_non_financial": true,
      "analyzed_at": "2022-03-04T17:58:30+02:00",
      "matched_transactions": [
        "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
      ],
      "transfer_ids": [
        "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
      ],
      "request_transfer": {
        "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
        "initiator_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
      },
      "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",
        "accounting_recorded_at": "2023-11-07T05:31:56Z",
        "accounting_recorded_source": "regate"
      },
      "available_actions": {
        "delete": true,
        "archive": true,
        "unarchive": true,
        "pay": true,
        "reasons": {
          "pay": [
            "is_credit_note"
          ],
          "delete": [
            "invalid_status"
          ],
          "archive": [
            "invalid_status"
          ],
          "unarchive": [
            "invalid_status"
          ]
        }
      },
      "declined_note": "",
      "approval_workflow": {
        "approver_ids": [
          "3c90c3cc-0d44-4b50-8888-8dd25736052a"
        ],
        "supplier_invoice_request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "verified_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
        "last_approved_by": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "payable_amount": {
        "value": "22.10",
        "currency": "EUR"
      },
      "total_amount_credit_notes": {
        "value": "22.10",
        "currency": "EUR"
      },
      "is_credit_note": false,
      "has_suggested_credit_notes": false,
      "related_invoices": [
        {
          "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
          "invoice_number": "QONTO-JAN-2022",
          "total_amount": {
            "value": "22.10",
            "currency": "EUR"
          },
          "attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "file_name": "my-invoice.pdf"
        }
      ],
      "suggested_transactions": [
        {
          "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
          "score": "0.8"
        }
      ]
    }
  ],
  "meta": {
    "current_page": 2,
    "next_page": 3,
    "prev_page": 1,
    "total_pages": 11,
    "total_count": 210,
    "per_page": 20
  }
}

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]

statuses to filter on. if provided multiple times, they will be parsed as an array Initial status for invoices.

Allowed value: "to_review"
Example:

"to_review"

​
filter[due_date]
enum<string>

Due date filters for invoices. If provided multiple times, they will be parsed as an array

Available options:
past_and_today,
future,
missing_date
Example:

"due"

​
filter[attachment_id]
string

attachment ID filters for invoices. If provided multiple times, they will be parsed as an array

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

​
filter[attachment_id][]
string

attachment ID array filters for invoices.

Example:

"4d5418bb-bd0d-4df4-865c-c07afab8bb48"

​
filter[created_at_from]
string

RFC3339 format (e.g 2022-01-21T12:01:02Z)

Example:

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

​
filter[created_at_to]
string

RFC3339 format (e.g 2022-01-21T12:01:02Z)

Example:

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

​
filter[updated_at_from]
string

RFC3339 format (e.g 2022-01-21T12:01:02Z)

Example:

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

​
filter[updated_at_to]
string

RFC3339 format (e.g 2022-01-21T12:01:02Z)

Example:

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

​
filter[payment_date]
enum<string>

Filter payment dates by "friendly" values.

Available options:
today,
yesterday,
this_week,
past_week,
this_month,
past_month
Example:

"yesterday"

​
filter[issue_date]
enum<string>

Filter issue dates by "friendly" values.

Available options:
today,
yesterday,
this_week,
past_week,
this_month,
past_month
Example:

"yesterday"

​
filter[missing_data]
boolean

Filter supplier invoices with missing data

Example:

false

​
filter[matched_transactions]
boolean

Filter invoices with matched transactions

Example:

false

​
filter[document_type]
enum<string>

Filter invoices by document type. If provided multiple times, they will be parsed as an array

Available options:
duplicates,
non_financial_documents
Example:

"duplicates"

​
filter[document_type][]
enum<string>

Document type array filters for invoices.

Available options:
duplicates,
non_financial_documents
Example:

"duplicates"

​
filter[approver_id][]
string<uuid>

Approval workflow approver ID array filters for invoices.

​
filter[issue_date_from]
string

Filter invoices by issue date from

Example:

"2022-01-21"

​
filter[exclude_credit_notes]
boolean

Exclude credit notes from the result

Example:

false

​
filter[payable_amount]
string

Filter invoices by payable amount with operators lte/gte and currency with format payable_amount[lte]=lte:100.00:EUR

Example:

"filter[payable_amount]=lte:100.00:EUR"

​
query
string

Full-text search query. To be associated with the query_fields param.

Example:

"Qonto"

​
query_fields
string

Fields to search in. To be associated with the query param.

Example:

"supplier_name,amount,file_name,invoice_number"

​
page
integer
Example:

1

​
per_page
integer
Example:

25

​
sort_by
string
Example:

"name:desc"

Response

returns an array of supplier invoices

​
supplier_invoices
object[]
​
meta
object

Metadata for paginated responses