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

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
read-only

Token string used for authentication.

​
expiration
string<date-time>
required
read-only

Date and time when this token will become expired.

​
isValid
boolean
required
read-only

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