List issuers

Issuers 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.

In the new v2 API, issuers can be retrieved by using the issuers include on the Methods API. Documentation for the Methods API v2 can be found here. For more information on the v2 API, refer to our v2 migration guide.

GEThttps://api.mollie.com/v1/issuers

Retrieve all available iDEAL issuers. This endpoint enables you to integrate iDEAL’s bank selection screen into your own payment flow.

The Issuers API only supports iDEAL.

The results are paginated. See pagination for more information.

Parameters

offsetintegeroptional
The number of issuers to skip.
countintegeroptional
The number of issuers to return (with a maximum of 250).

Access token parameters

If you are using organization access tokens or are creating an OAuth app, the testmode query string parameter is also available.

testmodebooleanoptional

Response

200 application/json

totalCountinteger
The total number of issuers available.
offsetinteger
The number of skipped issuers as requested.
countinteger
The number of issuers found in data, which is either the requested number (with a maximum of 250) or the default number.
dataarray
An array of issuer objects as described in Get issuer.
linksobject

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

Show child parameters

previousstring
The previous set of issuers, if available.
nextstring
The next set of issuers, if available.
firststring
The first set of issuers, if available.
laststring
The last set of issuers, if available.

Example

Request

1
2
curl -X GET https://api.mollie.com/v1/issuers \
    -H "Authorization: Bearer test_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM"

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
37
38
39
40
41
42
HTTP/1.1 200 OK
Content-Type: application/json

{
    "totalCount": 9,
    "offset": 0,
    "count": 9,
    "data": [
        {
            "resource": "issuer",
            "id": "ideal_ABNANL2A",
            "name": "ABN AMRO",
            "method": "ideal",
            "image": {
                "normal": "https://www.mollie.com/images/checkout/v3/ideal-issuer-icons/ABNANL2A.png",
                "bigger": "https://www.mollie.com/images/checkout/v3/ideal-issuer-icons/ABNANL2A%402x.png"
            }
        },
        {
            "resource": "issuer",
            "id": "ideal_ASNBNL21",
            "name": "ASN Bank",
            "method": "ideal",
            "image": {
                "normal": "https://www.mollie.com/images/checkout/v3/ideal-issuer-icons/ASNBNL21.png",
                "bigger": "https://www.mollie.com/images/checkout/v3/ideal-issuer-icons/ASNBNL21%402x.png"
            }
        },
        {
            "resource": "issuer",
            "id": "ideal_INGBNL2A",
            "name": "ING",
            "method": "ideal",
            "image": {
                "normal": "https://www.mollie.com/images/checkout/v3/ideal-issuer-icons/INGBNL2A.png",
                "bigger": "https://www.mollie.com/images/checkout/v3/ideal-issuer-icons/INGBNL2A%402x.png"
            }
        },
        { },
        { }
    ]
}