---
title: "List invoices"
method: GET
path: "/invoices"
tags: ["Invoices API"]
---

# List invoices

`GET /invoices`

## Request

- Base URL: `https://api.mollie.com/v2`
- URL: `https://api.mollie.com/v2/invoices`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://my.mollie.com/oauth2/authorize`
    - Token URL: `https://api.mollie.com/oauth2/tokens` scopes: `invoices.read`

Retrieve a list of all your invoices, optionally filtered by year or by invoice reference.

The results are paginated.

> 🔑 Access with
>
> [Advanced access token with **invoices.read**](/reference/authentication)
>
> [OAuth access with **invoices.read**](/reference/authentication)

## Query parameters

- `reference` string, nullable
- `year` string, nullable
- `from` string, nullable
- `limit` integer, nullable
- `sort` string

## Response `200`

A list of invoice objects. For a complete reference of the invoice object, refer to the [Get invoice endpoint](get-invoice) documentation.

- object
  - `count` integer, required: The number of items in this result set. If more items are available, a `_links.next` URL will be present in the result as well. The maximum number of items per result set is controlled by the `limit` property provided in the request. The default limit is 50 items.
  - `_embedded` object, required
    - `invoices` object[], required: An array of invoice objects. For a complete reference of the invoice object, refer to the [Get invoice endpoint](get-invoice) documentation.
      - `resource` string, required: Indicates that the response contains an invoice object. Will always contain the string `invoice` for this endpoint.
      - `id` string, required
      - `reference` string, required: The reference number of the invoice. An example value would be: `2024.10000`.
      - `vatNumber` string, nullable, required: The VAT number to which the invoice was issued to, if applicable.
      - `status` string, required: Status of the invoice. Possible values: `open` `paid` `overdue`
      - `netAmount` object, required: Total amount of the invoice, excluding VAT.
        - `currency` string, required: A three-character ISO 4217 currency code.
        - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `vatAmount` object, required: VAT amount of the invoice. Only applicable to merchants registered in the Netherlands. For EU merchants, VAT will be shifted to the recipient (as per article 44 and 196 in the EU VAT Directive 2006/112). For merchants outside the EU, no VAT will be charged.
        - `currency` string, required: A three-character ISO 4217 currency code.
        - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `grossAmount` object, required: Total amount of the invoice, including VAT.
        - `currency` string, required: A three-character ISO 4217 currency code.
        - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `lines` object[], required: The collection of products which make up the invoice.
        - `period` string, required: The administrative period in `YYYY-MM` on which the line should be booked.
        - `description` string, required: Description of the product.
        - `count` integer, required: Number of products invoiced. For example, the number of payments.
        - `vatPercentage` integer, required: VAT percentage rate that applies to this product.
        - `amount` object, required: Line item amount excluding VAT.
          - `currency` string, required: A three-character ISO 4217 currency code.
          - `value` string, required: A string containing an exact monetary amount in the given currency.
      - `issuedAt` string, required: The invoice date in `YYYY-MM-DD` format.
      - `paidAt` string, nullable: The date on which the invoice was paid, if applicable, in `YYYY-MM-DD` format.
      - `dueAt` string, nullable: The date on which the invoice is due, if applicable, in `YYYY-MM-DD` format.
      - `_links` object, required: An object with several relevant URLs. Every URL object will contain an `href` and a `type` field.
        - `self` object: URL to the current invoice resource.
          - `href` string, required: The actual URL string.
          - `type` string, required: The content type of the page or endpoint the URL points to.
        - `pdf` object: URL to a downloadable PDF of the invoice.
          - `href` string, required: The actual URL string.
          - `type` string, required: The content type of the page or endpoint the URL points to.
  - `_links` object, required: Links to help navigate through the lists of items. Every URL object will contain an `href` and a `type` field.
    - `self` object, required: The URL to the current set of items.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.
    - `previous` object, nullable, required: The previous set of items, if available.
      - `href` string: The actual URL string.
      - `type` string: The content type of the page or endpoint the URL points to.
    - `next` object, nullable, required: The next set of items, if available.
      - `href` string: The actual URL string.
      - `type` string: The content type of the page or endpoint the URL points to.
    - `documentation` object, required: In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.

## Other responses

- `400`: The request contains issues. For example, if the specified `from` value is not a valid ID.
- `404`: No entity with this ID exists.
- `429`: Rate Limit has been reached.

---

[API](https://skmtc.dev/mollie/apis/business-operations.md) - [All operations](https://skmtc.dev/mollie/apis/business-operations/llms.txt) - [OpenAPI document](https://skmtc.dev/mollie/apis/business-operations/revisions/d51d76f4e5d9?raw)