Complete Identity Verification with SDK

Endpoint:

GET /v1/user/{user_api_key_id}/identity-verification-session/36

Response:

{
    "Response": [
        {
            "IdentityVerificationSessionIncode": {
                "id": 36,
                "created": "2025-10-31 16:38:53.872547",
                "updated": "2025-10-31 16:38:53.872547",
                "purpose": "VERIFICATION",
                "applicant_identifier_external": null,
                "session_identifier_external": "incode_token",
                "country": "NL",
                "status": "CREATED",
                "token": "token_value_123",
                "url_api": "https://demo-api.incodesmile.com/0/",
                "should_record_session": true,
                "result": null
            }
        }
    ]
}

Step 3: Pass the information to the SDK

Here, the token should be passed to the SDK in order for the session to start. User will then interact with it and they will apply facial verification and ID check. After it is done, your app will obtain a confirmation from the SDK, then you need to inform bunq using the following endpoint.

Endpoint:

PUT /v1/user/{user_api_key_id}/identity-verification-session/36

Request Body:

{
    "status": "SUBMITTED"
}

Response:

{
    "Response": [
        {
            "Id": {
                "id": 36
            }
        }
    ]
}

Step 4: Keep polling until the result is completed

Endpoint:

GET /v1/user/{user_api_key_id}/identity-verification-session/36

Response:

{
    "Response": [
        {
            "IdentityVerificationSessionIncode": {
                "id": 36,
                "created": "2025-10-31 16:38:53.872547",
                "updated": "2025-10-31 16:38:53.872547",
                "purpose": "VERIFICATION",
                "applicant_identifier_external": null,
                "session_identifier_external": "incode_token",
                "country": "NL",
                "status": "PROCESSED",
                "token": "token_value_123",
                "url_api": "https://demo-api.incodesmile.com/0/",
                "should_record_session": true,
                "result": "APPROVED"
            }
        }
    ]
}

Now, user identity verification is completed and user is Approved, you can continue with finalizing the rest of the fulfillments.