Initiate BankID/eID caller verification

POST

/api/identity/idura/initiate

Starts a backchannel (CIBA) eID authentication during a call, sending a verification request to the caller's BankID/MitID app. If no method is supplied the tenant's default method is used. This endpoint identifies the tenant via the request body and does not use API-key auth.

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 request sent

Bodyapplication/json

🟠400BadRequest

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/identity/idura/initiate' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "tenant_id": "11111111-1111-1111-1111-111111111111",
    "agent_id": "22222222-2222-2222-2222-222222222222",
    "room_name": "room-abc",
    "phone_number": "+4791234567",
    "method": "bankid_no"
}'

Response Example

200 - Success

{
    "success": true,
    "auth_req_id": "areq-123",
    "expires_in": 120,
    "poll_interval": 5,
    "method_used": "bankid_no",
    "message": "BankID-forespørsel sendt til +4791234567. Brukeren må bekrefte i sin BankID-app."
}

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

Test a service connection

Check BankID/eID verification status