Skip to main content
POST
/
api
/
service
/
data
/
session
/
details
JavaScript
import Ivy from '@getivy/node-sdk';

const client = new Ivy({
  apiKey: 'My API Key',
});

const session = await client.data.session.retrieve({ id: 'id' });

console.log(session.id);
{
  "id": "<string>",
  "referenceId": "<string>",
  "displayId": "<string>",
  "merchantId": "<string>",
  "status": "open",
  "createdAt": 123,
  "updatedAt": 123,
  "expiresAt": 123,
  "locale": "de",
  "market": "AF",
  "metadata": {},
  "prefill": {
    "bankId": "<string>"
  },
  "disableBankSelection": true,
  "successCallbackUrl": "<string>",
  "errorCallbackUrl": "<string>"
}

Authorizations

X-Ivy-Api-Key
string
header
required

API key for authentication

Body

application/json
id
string
required

The id of the data session.

Response

200 - application/json

Returns the details of the data session

id
string
required

The id of the data session.

referenceId
string
required

An internal reference id for the data session.

displayId
string
required

Currently only visible in the merchant dashboard. This id used to be displayed to the user during the checkout.

merchantId
string
required

The id of the merchant.

status
enum<string>
required

The status of the data session.

Available options:
open,
closed,
expired
createdAt
number
required

The Epoch time in seconds at which the Session was created.

updatedAt
number
required

The Epoch time in seconds at which the Session was updated.

expiresAt
number
required

The Epoch time in seconds at which the Session will expire.

disableBankSelection
boolean
required

Whether customers can choose another bank than the pre-selected one.

successCallbackUrl
string<uri>
required

The URL where users will be redirected after a successful session.

errorCallbackUrl
string<uri>
required

The URL where users will be redirected after an unsuccessful session.

locale
enum<string>

The locale of the data session.

Available options:
de,
nl,
en,
fr,
es,
fi,
it,
pt,
sv,
pl,
sk,
lt
market
enum<string>

ISO 3166-1 alpha-2 country code of the market.

Available options:
AF,
AL,
DZ,
AS,
AD,
AO,
AI,
AQ,
AG,
AR,
AM,
AW,
AU,
AT,
AZ,
BS,
BH,
BD,
BB,
BY,
BE,
BZ,
BJ,
BM,
BT,
BO,
BA,
BW,
BV,
BR,
IO,
BN,
BG,
BF,
BI,
KH,
CM,
CA,
CV,
KY,
CF,
TD,
CL,
CN,
CX,
CC,
CO,
KM,
CG,
CD,
CK,
CR,
CI,
HR,
CU,
CY,
CZ,
DK,
DJ,
DM,
DO,
EC,
EG,
SV,
GQ,
ER,
EE,
ET,
FK,
FO,
FJ,
FI,
FR,
GF,
PF,
TF,
GA,
GM,
GE,
DE,
GH,
GI,
GR,
GL,
GD,
GP,
GU,
GT,
GN,
GW,
GY,
HT,
HM,
VA,
HN,
HK,
HU,
IS,
IN,
ID,
IR,
IQ,
IE,
IL,
IT,
JM,
JP,
JO,
KZ,
KE,
KI,
KP,
KR,
KW,
KG,
LA,
LV,
LB,
LS,
LR,
LY,
LI,
LT,
LU,
MO,
MG,
MW,
MY,
MV,
ML,
MT,
MH,
MQ,
MR,
MU,
YT,
MX,
FM,
MD,
MC,
MN,
MS,
MA,
MZ,
MM,
NA,
NR,
NP,
NL,
NC,
NZ,
NI,
NE,
NG,
NU,
NF,
MP,
MK,
NO,
OM,
PK,
PW,
PS,
PA,
PG,
PY,
PE,
PH,
PN,
PL,
PT,
PR,
QA,
RE,
RO,
RU,
RW,
SH,
KN,
LC,
PM,
VC,
WS,
SM,
ST,
SA,
SN,
SC,
SL,
SG,
SK,
SI,
SB,
SO,
ZA,
GS,
ES,
LK,
SD,
SR,
SJ,
SZ,
SE,
CH,
SY,
TW,
TJ,
TZ,
TH,
TL,
TG,
TK,
TO,
TT,
TN,
TR,
TM,
TC,
TV,
UG,
UA,
AE,
GB,
US,
UM,
UY,
UZ,
VU,
VE,
VN,
VG,
VI,
WF,
EH,
YE,
ZM,
ZW,
AX,
BQ,
CW,
GG,
IM,
JE,
ME,
BL,
MF,
RS,
SX,
SS,
XK
metadata
object

Any data stored with this data session.

prefill
object

Prefill options for the data session

I