POST
/
api
/
v2
/
verify
/
{app_id}
Verify Proof
curl --request POST \
  --url https://developer.worldcoin.org/api/v2/verify/{app_id} \
  --header 'Content-Type: application/json' \
  --data '{
  "nullifier_hash": "0x2bf8406809dcefb1486dadc96c0a897db9bab002053054cf64272db512c6fbd8",
  "merkle_root": "0x2264a66d162d7893e12ea8e3c072c51e785bc085ad655f64c10c1a61e00f0bc2",
  "proof": "0x1aa8b8f3b2d2de5ff452c0e1a83e29d6bf46fb83ef35dc5957121ff3d3698a1119090fb...",
  "verification_level": "orb",
  "action": "my_action",
  "signal_hash": "0x00c5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a4",
  "max_age": 3600
}'
{
  "success": true,
  "action": "my_action",
  "nullifier_hash": "0x2bf8406809dcefb1486dadc96c0a897db9bab002053054cf64272db512c6fbd8",
  "created_at": "2023-02-18T11:20:39.530041+00:00"
}

Path Parameters

​
app_id
string
required

Your app ID from the Developer Portal

Body

application/json
​
nullifier_hash
string
required

The unique user identifier (called the nullifier hash in the ZKP), as provided by IDKit. See IDKit response for details.

​
proof
string
required

The zero-knowledge proof, as provided by IDKit. See IDKit response for details.

​
merkle_root
string
required

Part of the ZKP, the hash of the Merkle root that proves membership to the set of credentials. As provided by IDKit. See IDKit response for details.

​
verification_level
string
required

The verification level, as provided by IDKit. See IDKit response for details.

​
action
string
required

Same action identifier as passed to IDKit.

​
signal_hash
string

The hash of the signal that was used to generate the proof. Defaults to the hash of an empty string.

​
max_age
integer
default:7200

The maximum age of the root in seconds. This parameter controls how old the Merkle root used in the proof can be. Minimum value is 3600 (1 hour) and maximum value is 604800 (7 days). Defaults to 7200 (2 hours).

Required range: 3600 <= x <= 604800

Response

Verified

The response is of type any.