Initiate chat verification

POST

/api/chat/verify/initiate

Starts a Vipps/BankID identity verification for a chat session using the visitor's phone number. The visitor confirms in their Vipps app, then the client polls the verify/status endpoint. Public endpoint; no authentication required.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Verification initiated, already verified, or pending.

Bodyapplication/json

🟠400

🟠404

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/chat/verify/initiate' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "session_id": "1ffd059c-17ea-40a8-8aef-70fd0307db82",
    "phone_number": "string"
}'

Response Example

{
    "success": true,
    "already_verified": true,
    "user_name": "string",
    "status": "pending",
    "message": "string",
    "poll_interval": 0
}

Modified at 2026-07-08 19:01:40

Get chat verification status

Check if verification is required