---
title: "Get a list of supplier invoices for an organization"
method: GET
path: "/v2/supplier_invoices"
tags: ["Supplier Invoices"]
---

# Get a list of supplier invoices for an organization

`GET /v2/supplier_invoices`

OAuth scope: `supplier_invoice.read`

---

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

List all supplier invoices for an organization

---

## Attributes details

### Initiator
`initiator_id` is the member who uploaded the invoice.

#### Statuses
`status` contains four possible values:

- **to_review**: When first uploaded, the invoice lands in this state for review.
- **to_pay**: Deprecated: This status will no longer be assigned to **new** supplier-invoices. Any invoices already in the `to_pay` status can be marked as paid or be scheduled for transfer.
- **pending**: The invoice is waiting for approval or declining by one of the authorized members (only accessible by organizations in a Business or Enterprise plan).
- **scheduled**: The invoice is scheduled to be paid. This status is managed by Qonto as it tracks the updates of the transfer.
- **paid**: The invoice is paid.

### Filters
#### `status`
Supplier invoices can be filter by available status.

### `created_at_from` and `created_at_to`
Supplier invoices can be filtered by created date time interval using `created_at_from` and `created_at_to` where:
- created_at_from represents the min date.
- created_at_to represents the max date.

Note that if the created_at_from and created_at_to are not specified in the query parameters, the response will contain all the invoices of that particular organization.

### Sorting
Supplier invoices can be sorted by a specific field and order. The `sort_by` query parameter accepts a string defining these two items with the field:order format.

#### Field
`created_at`, `file_name`, `supplier_name`, `payment_date`, `due_date`, `scheduled_date` and `total_amount` values are available.
By default the field used to sort invoices is `created_at:desc` for the `To Review` section and `payment_date:asc` for the `To Pay` and `Processed` `payment_date:desc`

#### Order
Two values are available : asc (Ascending) / desc (Descending)
By default the order used to sort supplier invoices is `desc`

### Pagination
Default number of items per page is 1, max items per page is 100. Pagination data is returned in the response : [See Schema here](https://api-doc.qonto.com/docs/business-api/c2NoOjI3NTA2MjA3-pagination).

## Query parameters

- `filter[status]` 'to_review' | 'to_pay' | 'pending' | 'scheduled' | 'paid'
- `page` integer
- `per_page` integer
- `sort_by` string
- `filter[created_at_from]` string
- `filter[created_at_to]` string

## Headers

- `X-Qonto-Staging-Token` string

## Response `200`

returns an array of supplier invoices

- 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
  - `meta` Pagination
    - `current_page` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `total_pages` integer
    - `total_count` integer
    - `per_page` integer

## Other responses

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

---

[API](https://skmtc.net/hiit-consulting-fr/apis/qonto.md) · [All operations](https://skmtc.net/hiit-consulting-fr/apis/qonto/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hiit-consulting-fr/qonto/revisions/25208d6f9deb/schema)