v1

latestOpenAPI 3.1.02026-07-242325051.4 MB

Idin

Idin:Browse

Retrieve all iDIN transaction. iDIN is a service of the dutch banks which you can use to identify your customers.

get/v2/idin

Query parameters

pageinteger

The collection page number

limitinteger

The number of items per page

eqstring

Filter iDINs by status. Use operators like eq: "SUCCESS", neq: "INIT".

neqstring

Filter iDINs by status. Use operators like neq: "SUCCESS", neq: "INIT".

Filter by status.

{
  "eq": "SUCCESS",
  "neq": "INIT"
}

eqstring

Filter on the exact service code.

neqstring

Filter on service codes that do not equal the given value.

Filter by service code (website location).

{
  "eq": "SL-1234-4321",
  "neq": "SL-1234-4321"
}

eqstring

Get results that equal the given value

Provides filtering based on merchant code.

{
  "eq": "M-1234-4321"
}

Response

countinteger

The amount of items the collection contains

pagesinteger

The amount of pages available

totalinteger nullable

The total items the collection contains

Example response

{
  "idin": [
    {
      "code": "DA-1234-4321-1234",
      "issuingBank": "ABNANL2A",
      "reference": "REF00256",
      "returnUrl": "http://return.com",
      "exchangeUrl": "https://idin.pay.nl/receive",
      "service": {
        "code": "SL-1234-4321",
        "name": "My location"
      },
      "merchant": {
        "code": "M-1234-4321",
        "name": "Company BV",
        "status": "ACTIVE"
      },
      "createdAt": "2024-06-04T08:15:00+01:00"
    }
  ],
  "count": 5,
  "pages": 2,
  "total": 10
}