Skip to main content
POST
/
bank
/
tokens
Generate bank verification token
curl --request POST \
  --url https://api.example.com/bank/tokens/ \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "lifetime": 3600,
  "country": "AT",
  "bank": "<string>",
  "access": {
    "accounts": false,
    "balances": false,
    "transactions": false
  }
}
'
{
  "tokenString": "<string>",
  "expiration": "2023-11-07T05:31:56Z",
  "isValid": true,
  "country": "AT",
  "bank": "<string>",
  "access": {
    "accounts": false,
    "balances": false,
    "transactions": false
  }
}

Authorizations

​
Authorization
string
header
required

The request must contain basic auth headers where username is API key and password is API secret.
In order for you to start using our API you will need an API key and API secret.
Both can be retrieved by contacting iDenfy's support or iDenfy's sales team.

Body

application/json
​
lifetime
integer
default:3600

The duration in seconds of bank verification token validity.

Required range: 0 <= x <= 2592000
​
country
enum<string>
Available options:
AT,
BE,
BG,
HR,
CY,
DK,
EE,
FI,
FR,
DE,
GR,
HU,
IS,
IE,
IT,
LV,
LT,
LU,
MT,
NL,
NO,
PL,
PT,
RO,
SK,
SI,
ES,
SE
​
bank
string | null
Maximum string length: 32
​
access
object

Response

201 - application/json
​
tokenString
string
required

Token string used for authentication.

​
expiration
string<date-time>
required

Date and time when this token will become expired.

​
isValid
boolean
required

Indicates whether this token is valid.

​
country
enum<string>
Available options:
AT,
BE,
BG,
HR,
CY,
DK,
EE,
FI,
FR,
DE,
GR,
HU,
IS,
IE,
IT,
LV,
LT,
LU,
MT,
NL,
NO,
PL,
PT,
RO,
SK,
SI,
ES,
SE
​
bank
string | null
Maximum string length: 32
​
access
object