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)​
​