---
title: "Create supplier invoices with attachments"
method: POST
path: "/v2/supplier_invoices/bulk"
tags: ["Supplier Invoices"]
---

# Create supplier invoices with attachments

`POST /v2/supplier_invoices/bulk`

## Request

- Base URL: `https://thirdparty.qonto.com`
- URL: `https://thirdparty.qonto.com/v2/supplier_invoices/bulk`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://oauth.qonto.com/oauth2/auth`
    - Token URL: `https://oauth.qonto.com/oauth2/token` scopes: `supplier_invoice.write`
  - API key in header `Authorization`

OAuth scope: `supplier_invoice.write`

---

**Price plans**: this endpoint is available for all Qonto price plans.

Bulk create supplier invoices with attachments
---
This endpoint will always return a 200 regardless if there are any errors. Clients must ensure to check the `errors` property in order to confirm if all operations were successful.

A 400 will be returned if whole request fails.

Total size of the request cannot exceed 15MB.

## Headers

- `X-Qonto-Staging-Token` string

## Request body `multipart/form-data`

- object
  - `supplier_invoices` object[], required
    - `file` string, binary, required
    - `idempotency_key` string, required
  - `meta` string, json

## Response `200`

returns supplier invoices result (there could be failures)

- object
  - `supplier_invoices` SupplierInvoice[], required
    - `id` string, uuid, required
    - `organization_id` string, uuid, required
    - `file_name` string, required
    - `invoice_number` string
    - `supplier_name` string
    - `description` string
    - `total_amount` object
      - `value` string
      - `currency` string
    - `issue_date` string
    - `due_date` string
    - `payment_date` string
    - `scheduled_date` string
    - `status` 'to_review' | 'to_pay' | 'pending' | 'scheduled' | 'paid', required
    - `iban` string
    - `initiator_id` string, uuid
    - `source_type` 'email' | 'manual_upload', required
    - `created_at` string, required
    - `updated_at` string, required
    - `attachment_id` string, uuid, required
    - `analyzed_at` string
    - `request_transfer` object
      - `id` string, uuid
      - `initiator_id` string, uuid
    - `meta` object
      - `integration_type` string
      - `connector` string
  - `errors` object[], required
    - `code` string
    - `detail` string

## Other responses

- `400`: returns errors
- `403`: returns a forbidden error

---

[API](https://skmtc.dev/hiit-consulting-fr/apis/qonto.md) - [All operations](https://skmtc.dev/hiit-consulting-fr/apis/qonto/llms.txt) - [OpenAPI document](https://skmtc.dev/hiit-consulting-fr/apis/qonto/revisions/25208d6f9deb?raw)