List supplier invoices

curl --request GET \
  --url https://thirdparty.qonto.com/v2/supplier_invoices \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://thirdparty.qonto.com/v2/supplier_invoices"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://thirdparty.qonto.com/v2/supplier_invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://thirdparty.qonto.com/v2/supplier_invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://thirdparty.qonto.com/v2/supplier_invoices"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://thirdparty.qonto.com/v2/supplier_invoices")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://thirdparty.qonto.com/v2/supplier_invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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,
      "supplier_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
      "self_invoice_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
      "issuer_name": "McDonald's",
      "invoice_number": "QONTO-JAN-2022",
      "supplier_name": "McDonald's",
      "vat_number": "IT12345678901",
      "tin_number": "1234567890",
      "description": "This is an invoice for Ronald!",
      "total_amount": {
        "value": "22.10",
        "currency": "EUR"
      },
      "total_amount_excluding_taxes": {
        "value": "18.42",
        "currency": "EUR"
      },
      "total_tax_amount": {
        "value": "3.68",
        "currency": "EUR"
      },
      "taxes": [
        {
          "tax_amount": {
            "value": "3.68",
            "currency": "EUR"
          },
          "tax_rate": "0.20"
        }
      ],
      "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_ids": [
        "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
      ],
      "matched_transactions": [
        {
          "subject_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
          "subject_type": "transfer",
          "transaction_id": "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"
      },
      "supplier_snapshot": {
        "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
        "name": "McDonald's",
        "iban": "FR1420041010050500013M02606",
        "tin": "1234567890",
        "vat_number": "IT12345678901",
        "email": "billing@example.com",
        "currency": "EUR",
        "status": "active"
      },
      "available_actions": {
        "delete": true,
        "archive": true,
        "unarchive": true,
        "pay": true,
        "reasons": {
          "pay": [],
          "delete": [],
          "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>'

import requests

url = "https://thirdparty.qonto.com/v2/supplier_invoices"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://thirdparty.qonto.com/v2/supplier_invoices', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://thirdparty.qonto.com/v2/supplier_invoices",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://thirdparty.qonto.com/v2/supplier_invoices"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://thirdparty.qonto.com/v2/supplier_invoices")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://thirdparty.qonto.com/v2/supplier_invoices")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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,
      "supplier_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
      "self_invoice_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
      "issuer_name": "McDonald's",
      "invoice_number": "QONTO-JAN-2022",
      "supplier_name": "McDonald's",
      "vat_number": "IT12345678901",
      "tin_number": "1234567890",
      "description": "This is an invoice for Ronald!",
      "total_amount": {
        "value": "22.10",
        "currency": "EUR"
      },
      "total_amount_excluding_taxes": {
        "value": "18.42",
        "currency": "EUR"
      },
      "total_tax_amount": {
        "value": "3.68",
        "currency": "EUR"
      },
      "taxes": [
        {
          "tax_amount": {
            "value": "3.68",
            "currency": "EUR"
          },
          "tax_rate": "0.20"
        }
      ],
      "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_ids": [
        "4d5418bb-bd0d-4df4-865c-c07afab8bb48"
      ],
      "matched_transactions": [
        {
          "subject_id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
          "subject_type": "transfer",
          "transaction_id": "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"
      },
      "supplier_snapshot": {
        "id": "4d5418bb-bd0d-4df4-865c-c07afab8bb48",
        "name": "McDonald's",
        "iban": "FR1420041010050500013M02606",
        "tin": "1234567890",
        "vat_number": "IT12345678901",
        "email": "billing@example.com",
        "currency": "EUR",
        "status": "active"
      },
      "available_actions": {
        "delete": true,
        "archive": true,
        "unarchive": true,
        "pay": true,
        "reasons": {
          "pay": [],
          "delete": [],
          "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[marked_as_read]

boolean

Filter invoices by read status. true returns reviewed documents, false returns documents pending review. If provided multiple times, values are parsed as an array. Passing both true and false is not equivalent to no filter.

Example:

true

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[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"

filter[ids][]

string<uuid>

Supplier invoice ID array filters. If provided multiple times, they will be parsed as an array.

Example:

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

filter[supplier_id][]

string<uuid>

Supplier ID array filters. If provided multiple times, they will be parsed as an array.

Example:

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

filter[source][]

enum<string>

Source array filters. If provided multiple times, they will be parsed as an array.

Available options:

email_forward,

e_invoicing,

supplier_invoices,

pay_by_invoice,

integration,

regate,

generic_upload,

pay_later

Example:

"email_forward"

filter[attachment_category][]

enum<string>

Attachment category array filters. If provided multiple times, they will be parsed as an array.

Available options:

INVOICE,

EXPENSE_RECEIPT,

CARD_RECEIPT,

CREDIT_CARD_RECEIPT,

CREDIT_NOTE,

OTHER_FINANCIAL_DOCUMENT,

OTHER_NON_FINANCIAL_DOCUMENT

Example:

"INVOICE"

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

Business API

Onboarding API

List supplier invoices

Authorizations

Headers

Query Parameters

Response