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
FINAL_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
See AML reference​
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.
Step Type
Response Reference
IDENTITY
​IdentityVerificationResponse (see reference)​
RESIDENCY
​ResidencyVerificationResponse (see reference)​
PHONE
​PhoneVerificationResponse (see reference)​
LIVENESS
​LivenessVerificationResponse (see reference)​
​

Last modified 9mo ago

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

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

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

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

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

Onboarding

`AppInfo | Object`

SessionInfo | Object

`Steps | Array`

`StepsHistory | Array`

`Settings | Object`

`RestrictedDocuments | Object`

`RestrictedCountries | Object`

`VerificationSteps | Object`

SessionInfo | Object

`VerificationStepDetails | Object`

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

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

Step Type	Response Reference
IDENTITY	IdentityVerificationResponse (see reference)
RESIDENCY	ResidencyVerificationResponse (see reference)
PHONE	PhoneVerificationResponse (see reference)
LIVENESS	LivenessVerificationResponse (see reference)