Skip to main content
POST
cURL
Authentication: API key OAuth 2.0
Scope: client_invoice.write
Related guide: E-invoicing via API
Unlike creating a client invoice, this endpoint does not regenerate the document: the original file you upload is preserved as-is. This makes it the right choice when your ERP or billing system already produces compliant Factur-X invoices that must be transmitted unchanged.
The whole request body is limited to 15 MB, with a maximum of 5 files of 5 MB each per request.
To preserve the embedded XML for e-invoicing in France, upload PDF files that follow the Factur-X standard.
Bulk import is all-or-nothing: if any file in the request is rejected (unsupported format, larger than 5 MB, or more than 5 files), the whole request fails and no invoices are created. Fix the offending file and retry the batch.
This endpoint is not idempotent: re-importing a file that has already been imported creates a new client invoice with a different invoice_id. The invoice number is not checked for duplicates on import.If you lose the response of an import call, check whether the invoice was created before retrying: list client invoices with exclude_imported=false (imported invoices are excluded by default) and filter[created_at_from] set to the time of your call, then match on the invoice number.
Bulk import is not available to Italian organizations; their requests return 403 Forbidden.

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.

Body

multipart/form-data

You have to specify multipart form data in order to attach the files to the request. Repeat the client_invoices field once per file. When using curl it will look like this:

client_invoices
file[]
required

The invoice files to import (repeat the client_invoices field once per file). Supported formats:

  • PDF (.pdf), including Factur-X
  • JPEG (.jpeg, .jpg)
  • PNG (.png)

Each file must not exceed 5 MB, and the whole request must not exceed 15 MB.

Maximum array length: 5

Response

Returns the list of successfully imported client invoices.

client_invoices
object[]
required