Skip to main content
POST

Path Parameters

rp_id
string
required

RP ID (rp_...) is recommended. App ID (app_...) is also accepted for backward compatibility.

Body

application/json

Choose one request type.

protocol_version
enum<string>
required
Available options:
3.0
nonce
string
required
action
string
required
responses
object[]
required
Minimum array length: 1
action_description
string
environment
enum<string>
default:production
Available options:
production,
staging
user_presence_completed
boolean

Whether World App completed the requested user-presence check. IDKit always sends it; treat a missing value as false.

Response

At least one proof verified successfully

success
enum<boolean>
required
Available options:
true
results
object[]
required
action
string
nullifier
string
created_at
string<date-time>
environment
enum<string>
Available options:
production,
staging
session_id
string

Opaque session ID in the format session_<128 hex characters>.

Example:

"session_5f3a9c2e...8d1b0a"

message
string