Synaps
3.0.0
Search
⌃K

Onboarding

get
https://individual-api.synaps.io
/v3/onboarding/overview
Overview
API Response
Field
Type
Description
app
AppInfo | Object
App info
session
SessionInfo | Object
Session Info
steps
Steps | Array
Details of verification steps
sandbox
boolean
true if session is sandbox
false is session is production
settings
Settings | Object
Settings for verification flow by steps
submitted_documents
SubmittedDocs | Object
Array of document types previously submitted for identity & residency steps

AppInfo | Object

Field
Type
Description
name
string
Name of app
logo_url
string
Logo URL of app

SessionInfo | Object

Field
Type
Description
session_id
string
id of the session
alias
string
alias of the session
status
string
State of the session
VALIDATED
PENDING CANCELLED
sandbox
boolean

Steps | Array

Field
Type
Description
state
string
State of the step
VALIDATED
NOT_STARTED
PENDING
REJECTED
name
string
Name of the step
LIVENESS
IDENTITY
RESIDENCY
PHONE
history
StepsHistory | Array
History of steps state

StepsHistory | Array

Field
Type
Description
review_message
string
Explanation of rejection
review_date
string
Date of review

Settings | Object

Field
Type
Description
key
string
ID of step
restricted_documents
RestrictedDocuments | Object
List of restricted documents by countries
restricted_countries
RestrictedCountries | Object
List of restricted countries
"settings": {
"281342961711": {
"restricted_documents": {
"ABW": {},
"AFG": {},
"AGO": {},
"AIA": {}
},
"restricted_countries": {}
},
"281342966982": {
"restricted_documents": {
"ABW": {},
"AFG": {},
"AGO": {},
"AIA": {},
"ALA": {}
},
"restricted_countries": {}
},
"281342968582": {
"restricted_documents": {
"ABW": {},
"AFG": {},
"AGO": {},
"AIA": {},
"ALA": {},
"ALB": {},
"AND": {},
"FRA": {
"DRIVER_LICENSE": true,
"NATIONAL_ID": true,
"PASSPORT": true,
"RESIDENT_PERMIT": true
}
},
"restricted_countries": {
"FRA": true
}
}
},

RestrictedDocuments | Object

Field
Type
Description
key
string
ISO-3166 country code
value
boolean
true if restricted
false if allowed
"restricted_countries": {
"FRA": true
}

RestrictedCountries | Object

Field
Type
Description
key
string
ISO-3166 country code
value
boolean
document_type: boolean
document_type can be:
PASSPORT
NATIONAL_ID
DRIVER_LICENSE
RESIDENT_PERMIT
"FRA": {
"DRIVER_LICENSE": true,
"NATIONAL_ID": true,
"PASSPORT": true,
"RESIDENT_PERMIT": true
}
get
https://individual-api.synaps.io
/v3/onboarding/details
Details
API Response
Field
Type
Description
app_id
string
App ID
sandbox
boolean
true if session is sandbox
false if session is production
session_id
string
Synaps Session-Id
alias
string
alias (optional) given on session initialisation
steps
VerificationSteps | Object
map of verification steps with step_id as index
session
SessionInfo | Object
Session Info
aml
AmlCheck | Object

VerificationSteps | Object

Field
Type
Description
key
string
step_id
value
VerificationStepDetails | Object
Verification step details

SessionInfo | Object

Field
Type
Description
session_id
string
id of the session
alias
string
alias of the sesion
status
string
State of the session
VALIDATED
PENDING CANCELLED
sandbox
boolean

VerificationStepDetails | Object

For each step, you will have a type field and a verification field. Type is made of 4 type step. Each type has its own response structure available on their respective page.