Passport verification V2
Introduction

API Endpoint's
Identity Object
POST https://preproduction.signzy.tech/api/v2/patrons/<patron-id>/identitiesPOST https://signzy.tech/api/v2/patrons/<patron-id>/identitiesHeaders
Key | Value |
|---|---|
Authorization | access token (returned as id field of login request) |
Content-type | application/json |
Request Data
{
"type": "passport",
"email": "[email protected]",
"callbackUrl": "https://your-domain.com/your-callback-system",
"images": [
]
}PARAMETERS | DESCRIPTION | TYPE | VALUE (COMPULSORY OR OPTIONAL) |
|---|---|---|---|
type | Supported type parameter for creation of Identity objects
| String | COMPULSORY |
E-mail can't be empty | String | COMPULSORY | |
callbackUrl | callbackUrl is where the data is posted on each activity performed on this Identity object. | String | COMPULSORY |
images | blank | List | COMPULSORY |
Response
{
"type": "passport",
"email": "[email protected]",
"callbackUrl": "https://your-domain.com/your-callback-system",
"images": [
],
"autoRecognition": [],
"verification": [],
"forgeryCheck": [],
"accessToken": "..access-token-for-the-snoop-request..",
"id": "..itemId-for-the-snoop-request....",
"patronId": "..your-id-into-signzy-system-(userId-returned-from-the-login-call).."
}
Snoops
POST https://preproduction.signzy.tech/api/v2/snoopsPOST https://signzy.tech/api/v2/snoopsHeaders
Key | Value |
|---|---|
Authorization | access token (returned as id field of login request) |
Content-type | application/json |
Request Data
{
"service": "Identity",
"itemId": "<..itemId-from-the-Identity-Object-request....>",
"task": "verification",
"accessToken": "<..access-token-from-the-Identity-Object-request..>",
"essentials": {
"fileNumber":"...fileNumber...",
"dob":"...dob...",
"name":"...name...",
"fuzzy" : "true/false"
}
}Parameter | Type | Required | Description |
|---|---|---|---|
task | string | Yes | The task to be performed by the API. For the driving license verification, the value should be "verification". |
essentials | object | Yes | The essential details of the driving license that you want to verify. This should include the fileNumber, date of birth. |
Response
{
"service": "Identity",
"itemId": "..item Id..",
"task": "verification",
"essentials": {},
"accessToken": "...accessToken...",
"id": "...id...",
"response": {
"files": [
"...image url..."
],
"id": 537,
"instance": {
"id": "...id...",
"callbackUrl": "...callback url..."
},
"result": {
"verified": true/false,
"message": "Verification completed successfully",
"upstreamName": "..upstreamName.."
}
}
}