Verify App (v2)

Sandbox URL:

[https://verify.sandbox.purplx.me](https://verify.sandbox.purplx.me/)

Query params:

• userId - The ID of the AppUser.
• accessToken - The access token from PurplX API.
• returnUrl - The redirect URL where the AppUser will be navigated to after the ID scanning.

Steps on how to verify an AppUser:

1. Get an access token for the AppUser that needs to be verified. Send a similar request like the below. Please make sure to limit the scope to only one AppUser.

POST https://api.sandbox.purplx.me/tokens/
{
    "client_id": "<your client_id>",
    "client_secret": "<your client_secret>",
    "grant_type": "client_credentials",
    "scope": "app-user:<AppUser-id> app-user-verification:<AppUser-id>"  // Example: app-user:20 app-user-verification:20
}

1. Complete this URL and open it on a mobile phone’s browser:

[https://verify.sandbox.purplx.me/?userId=](https://verify.sandbox.purplx.me/?userCode=)<AppUser-id>&accessToken=<access_token>

1. After the Verify App opens on your mobile phone's browser, it should assist the user already on how to scan the ID document.
2. After a successful scanning of the ID document, the extracted data can be retrieved using this GET endpoint:

GET /app-users/{id}/verifications/
Authorization: Bearer <token>