---
title: "Get invoice"
method: GET
path: "/invoices/{invoiceId}"
tags: ["Invoices API"]
---

# Get invoice

`GET /invoices/{invoiceId}`

## Request

- Base URL: `https://api.mollie.com/v2`
- URL: `https://api.mollie.com/v2/invoices/{invoiceId}`
- 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 single invoice by its ID.

If you want to retrieve the details of an invoice by its invoice number, call the [List invoices](list-invoices) endpoint with the `reference` parameter.

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

## Response `200`

The invoice object.

- object
  - `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.
    - `documentation` object: URL to the API documentation.
      - `href` string, required: The actual URL string.
      - `type` string, required: The content type of the page or endpoint the URL points to.

## Other responses

- `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)