List invoices

Invoices API v1

Warning

The v1 API has been deprecated. The v1 API will be supported for the foreseeable future, at least until July 2023. However, new features will only be added to the v2 API.

The documentation for retrieving invoices in the new v2 API can be found here. For more information on the v2 API, refer to our v2 migration guide.

GEThttps://api.mollie.com/v1/invoices
Authentication:App access tokens

Retrieve all invoices on the account. Optionally filter on year or invoice number.

The results are paginated. See pagination for more information.

Parameters

reference

string
optional
Use this parameter to filter for an invoice with a specific invoice number / reference. An example reference would be 2018.10000.

year

integer
optional
Use this parameter to filter for invoices from a specific year (e.g. 2018).

offset

integer
optional
The number of invoices to skip.

count

integer
optional
The number of invoices to return (with a maximum of 250).

Includes

This endpoint allows you to include additional information by appending the following values via the include querystring parameter.

  • lines Include invoice details such as which products were invoiced.
  • settlements Include settlements for which the invoices were created, if applicable.

Response

200 application/json

totalCount

integer
The total number of invoices available.

offset

integer
The number of skipped invoices as requested.

count

integer
The number of invoices found in data, which is either the requested number (with a maximum of 250) or the default number.

data

array
An array of invoice objects as described in Get invoice.

links

object

Links to help navigate through the lists of invoices, based on the given offset.

previous

string
The previous set of invoices, if available.

next

string
The next set of invoices, if available.

first

string
The first set of invoices, if available.

last

string
The last set of invoices, if available.

Example

Request

1
2
curl -X GET "https://api.mollie.com/v1/invoices?include=lines" \
    -H "Authorization: Bearer access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ"

Response

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
HTTP/1.1 200 OK
Content-Type: application/json

{
    "totalCount":1,
    "offset":0,
    "count":1,
    "data":[
        {
            "resource":"invoice",
            "id":"inv_xBEbP9rvAq",
            "reference":"2017.10000",
            "vatNumber":"NL001234567B01",
            "status":"open",
            "issueDate":"2017-08-31",
            "dueDate":"2017-09-14",
            "amount": {
                "net":"45.00",
                "vat":"9.45",
                "gross":"54.45"
            },
            "lines":[
                {
                    "period":"2017-09",
                    "description":"Transaction costs iDEAL",
                    "count":100,
                    "vatPercentage":21,
                    "amount":"29.00"
                }
            ],
            "links": {
                "pdf":"https://www.mollie.com/merchant/download/invoice/sbd9gu/52981a39788e5e0acaf71bbf570e941f"
            }
        }
    ]
}