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,
      "organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
      "file_name": "my-invoice.pdf",
      "status": "to_review",
      "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",
      "display_attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "declined_note": "",
      "e_invoice_type": "zugferd",
      "has_duplicates": false,
      "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",
      "iban": "FR1420041010050500013M02606",
      "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source": "email_forward",
      "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"
          ]
        }
      },
      "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
  }
}

GET

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,
      "organization_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
      "file_name": "my-invoice.pdf",
      "status": "to_review",
      "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",
      "display_attachment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "declined_note": "",
      "e_invoice_type": "zugferd",
      "has_duplicates": false,
      "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",
      "iban": "FR1420041010050500013M02606",
      "initiator_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "source": "email_forward",
      "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"
          ]
        }
      },
      "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[]

Show child attributes

supplier_invoices.id

string<uuid>

required

Example:

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

supplier_invoices.is_einvoice

boolean

required

indicates if the invoice is an e-invoice, currently ONLY for the German organizations

Example:

false

supplier_invoices.has_discrepancies

boolean

required

Example:

false

supplier_invoices.organization_id

string<uuid>

required

Example:

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

supplier_invoices.file_name

string

required

Example:

"my-invoice.pdf"

supplier_invoices.status

required

Initial status for invoices.

Allowed value: "to_review"

Example:

"to_review"

supplier_invoices.source_type

enum<string>

required

Available options:

email,

e_invoicing,

direct_upload

Example:

"email"

supplier_invoices.created_at

string

required

Example:

"2022-03-04T17:58:30+02:00"

supplier_invoices.updated_at

string

required

Example:

"2022-03-04T17:58:30+02:00"

supplier_invoices.attachment_id

string<uuid>

required

supplier_invoices.display_attachment_id

string<uuid>

required

supplier_invoices.declined_note

string

default:""

required

Note specified when invoice was archived

supplier_invoices.e_invoice_type

enum<string>

Available options:

zugferd,

xrechnung

Example:

"zugferd"

supplier_invoices.has_duplicates

boolean

Example:

false

supplier_invoices.invoice_number

string

Example:

"QONTO-JAN-2022"

supplier_invoices.supplier_name

string

Example:

"McDonald's"

supplier_invoices.vat_number

string | null

VAT number of the invoice issuer

Example:

"IT12345678901"

supplier_invoices.tin

string | null

Tax Identification Number (TIN) of the invoice issuer

Example:

"1234567890"

supplier_invoices.description

string

Example:

"This is an invoice for Ronald!"

supplier_invoices.total_amount

object

Show child attributes

supplier_invoices.total_amount.value

string

Example:

"22.10"

supplier_invoices.total_amount.currency

string

Example:

"EUR"

supplier_invoices.issue_date

string

Example:

"2022-03-01"

supplier_invoices.due_date

string

Example:

"2022-03-01"

supplier_invoices.payment_date

string

Example:

"2022-03-01"

supplier_invoices.scheduled_date

string

Example:

"2022-03-01"

supplier_invoices.iban

string

Example:

"FR1420041010050500013M02606"

supplier_invoices.initiator_id

string<uuid>

supplier_invoices.source

enum<string>

Available options:

email_forward,

e_invoicing,

supplier_invoices,

pay_by_invoice,

integration,

regate,

generic_upload,

pay_later

Example:

"email_forward"

supplier_invoices.is_attachment_invoice

boolean

supplier_invoices.attachment_category

enum<string>

The category of the attachment

Available options:

INVOICE,

EXPENSE_RECEIPT,

CARD_RECEIPT,

CREDIT_CARD_RECEIPT,

CREDIT_NOTE,

OTHER_FINANCIAL_DOCUMENT,

OTHER_NON_FINANCIAL_DOCUMENT,

UNKNOWN

Example:

"INVOICE"

supplier_invoices.is_attachment_non_financial

boolean

supplier_invoices.analyzed_at

string

Example:

"2022-03-04T17:58:30+02:00"

supplier_invoices.matched_transactions

string<uuid>[]

supplier_invoices.transfer_ids

string<uuid>[] | null

IDs of the transfer payments associated with this invoice, if any

supplier_invoices.request_transfer

object

Show child attributes

supplier_invoices.request_transfer.id

string<uuid>

Example:

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

supplier_invoices.request_transfer.initiator_id

string<uuid>

Example:

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

supplier_invoices.einvoicing_lifecycle_events

object[]

Show child attributes

supplier_invoices.einvoicing_lifecycle_events.status_code

enum<integer>

Status code of the operation. - 200: Déposée (Submitted) - 201: Emise par la plateforme (Issued by the platform) - 202: Reçue de la plateforme (Received from the platform) - 203: Mise à disposition (Made available) - 204: Prise en charge (Taken over) - 205: Approuvée (Approved) - 206: Approuvée partiellement (Partially approved) - 207: En litige (In dispute) - 208: Suspendue (Suspended) - 209: Complétée (Completed) - 210: Refusée (Refused) - 211: Paiement transmis (Payment sent) - 212: Encaissée (Collected) - 213: Rejetée (Rejected) - 214: Visée (Vised)

Available options:

200,

201,

202,

203,

204,

205,

206,

207,

208,

209,

210,

211,

212,

213,

214

Example:

200

supplier_invoices.einvoicing_lifecycle_events.reason

string

The reason label associated with a given event

Example:

"DOUBLE FACTURE"

supplier_invoices.einvoicing_lifecycle_events.reason_message

string

The reason message associated with a given event (comment provided by the user generating the event)

Example:

"I already received this invoice"

supplier_invoices.einvoicing_lifecycle_events.timestamp

string<date-time>

The timestamp of the event

Example:

"2024-12-04T11:05:16.4497Z"

supplier_invoices.meta

object

Show child attributes

supplier_invoices.meta.integration_type

string

Example:

"amazon"

supplier_invoices.meta.connector

string

Example:

"grover"

supplier_invoices.meta.accounting_recorded_at

string<date-time>

supplier_invoices.meta.accounting_recorded_source

string

Example:

"regate"

supplier_invoices.available_actions

object

Available actions for the invoice

Show child attributes

supplier_invoices.available_actions.delete

boolean

Indicates if the invoice can be deleted

supplier_invoices.available_actions.archive

boolean

Indicates if the invoice can be archived

supplier_invoices.available_actions.unarchive

boolean

Indicates if the invoice can be unarchived

supplier_invoices.available_actions.pay

boolean

Indicates if the invoice can be paid

supplier_invoices.available_actions.reasons

object

Detailed reasons for why certain actions are not available

Show child attributes

supplier_invoices.available_actions.reasons.pay

enum<string>[]

List of reasons why the invoice cannot be paid

Available options:

is_credit_note,

missing_iban,

missing_data,

invalid_status,

incorrect_approval_workflow

supplier_invoices.available_actions.reasons.delete

enum<string>[]

List of reasons why the invoice cannot be deleted

Available options:

invalid_status,

linked_self_invoice,

is_recorded

supplier_invoices.available_actions.reasons.archive

enum<string>[]

List of reasons why the invoice cannot be archived

Available options:

invalid_status

supplier_invoices.available_actions.reasons.unarchive

enum<string>[]

List of reasons why the invoice cannot be unarchived

Available options:

invalid_status

supplier_invoices.approval_workflow

object

Show child attributes

supplier_invoices.approval_workflow.approver_ids

string<uuid>[]

required

Membership IDs of the users who are next in line to approve the invoice

supplier_invoices.approval_workflow.supplier_invoice_request_id

string<uuid> | null

required

supplier_invoices.approval_workflow.verified_by

string<uuid> | null

required

ID of the membership that verified the supplier invoice and send it to approval workflow

supplier_invoices.approval_workflow.last_approved_by

string<uuid> | null

required

ID of the last membership that approved the supplier invoice request

supplier_invoices.payable_amount

object

Show child attributes

supplier_invoices.payable_amount.value

string

Example:

"22.10"

supplier_invoices.payable_amount.currency

string

Example:

"EUR"

supplier_invoices.total_amount_credit_notes

object

Show child attributes

supplier_invoices.total_amount_credit_notes.value

string

Example:

"22.10"

supplier_invoices.total_amount_credit_notes.currency

string

Example:

"EUR"

supplier_invoices.is_credit_note

boolean

Example:

false

supplier_invoices.has_suggested_credit_notes

boolean

Example:

false

Show child attributes

Example:

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

Example:

"QONTO-JAN-2022"

Show child attributes

Example:

"22.10"

Example:

"EUR"

Example:

"my-invoice.pdf"

supplier_invoices.suggested_transactions

object[] | null

suggested transactions for the invoice

Show child attributes

supplier_invoices.suggested_transactions.id

string<uuid>

id of the suggested transaction

Example:

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

supplier_invoices.suggested_transactions.score

string

match confidence score

Example:

"0.8"

Business API

Onboarding API

List supplier invoices

Authorizations

Headers

Query Parameters

Response