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

offset

integer
optional
The number of issuers to skip.

count

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

Mollie Connect/OAuth parameters

If you’re creating an app with Mollie Connect/OAuth, the testmode parameter is also available.

testmode

boolean
optional
Set this to true to only retrieve the issuers available in test mode.

Response

200 application/json; charset=utf-8

totalCount

integer
The total number of issuers available.

offset

integer
The number of skipped issuers as requested.

count

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

data

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

links

object

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

previous

string
The previous set of issuers, if available.

next

string
The next set of issuers, if available.

first

string
The first set of issuers, if available.

last

string
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; charset=utf-8

{
    "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/v2/ideal-issuer-icons/ABNANL2A.png",
                "bigger": "https://www.mollie.com/images/checkout/v2/ideal-issuer-icons/ABNANL2A%402x.png"
            }
        },
        {
            "resource": "issuer",
            "id": "ideal_ASNBNL21",
            "name": "ASN Bank",
            "method": "ideal",
            "image": {
                "normal": "https://www.mollie.com/images/checkout/v2/ideal-issuer-icons/ASNBNL21.png",
                "bigger": "https://www.mollie.com/images/checkout/v2/ideal-issuer-icons/ASNBNL21%402x.png"
            }
        },
        {
            "resource": "issuer",
            "id": "ideal_INGBNL2A",
            "name": "ING",
            "method": "ideal",
            "image": {
                "normal": "https://www.mollie.com/images/checkout/v2/ideal-issuer-icons/INGBNL2A.png",
                "bigger": "https://www.mollie.com/images/checkout/v2/ideal-issuer-icons/INGBNL2A%402x.png"
            }
        },
        { },
        { }
    ]
}