Verify

Verifies World ID 4.0 proofs and legacy 3.0 proofs. Use rp_id (rp_...) when possible; app_id (app_...) is still accepted for backward compatibility.

POST /api/v4/verify/{rp_id}

cURL

uniqueness_v3

curl --request POST \ --url https://developer.world.org/api/v4/verify/{rp_id} \ --header 'Content-Type: application/json' \ --data ' { "protocol_version": "3.0", "nonce": "0xabc123", "action": "my_action", "responses": [ { "identifier": "orb", "merkle_root": "0x2264a66d162d7893e12ea8e3c072c51e785bc085ad655f64c10c1a61e00f0bc2", "nullifier": "0x2bf8406809dcefb1486dadc96c0a897db9bab002053054cf64272db512c6fbd8", "proof": "0x1aa8b8f3b2d2de5ff452c0e1a83e29d6bf46fb83ef35dc5957121ff3d3698a1119090fb...", "signal_hash": "0x00c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4", "max_age": 304200 } ] } '

200

Example

{ "success": true, "results": [ { "identifier": "<string>", "success": true, "nullifier": "<string>", "code": "<string>", "detail": "<string>" } ], "action": "<string>", "nullifier": "<string>", "created_at": "2023-11-07T05:31:56Z", "environment": "production", "session_id": "<string>", "message": "<string>" }

Path Parameters

rp_id · string · required

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

Body

application/json

Legacy Proofs (v3)

Uniqueness Proofs

Session Proofs

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

Show child attributes

action_description · string

environment · enum<string> · default: production

Available options: production, staging

Response

200

application/json

At least one proof verified successfully

success · enum<boolean> · required

Available options: true

results · object[] · required

Show child attributes

action · string

nullifier · string

created_at · string<date-time>

environment · enum<string>

Available options: production, staging

session_id · string

message · string