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

# List invoices

`GET /v2/invoices`

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

The results are paginated.

## Query parameters

- `reference` string, nullable
- `year` string, nullable
- `from` string, nullable
- `limit` integer, nullable
- `sort` 'asc' | 'desc'

## Headers

- `idempotency-key` 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.

## 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.net/mollie/apis/mollie-api.md) · [All operations](https://skmtc.net/mollie/apis/mollie-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mollie/mollie-api/revisions/3fb1b5127a6b/schema)