Skip to main content
POST
/
api
/
v2
/
verify
/
{app_id}
Verify (Legacy)
curl --request POST \
  --url https://developer.world.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"
}
'
{
  "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.

​
proof
string
required

The zero-knowledge proof, as provided by IDKit.

​
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.

​
verification_level
string
required

The verification level, as provided by IDKit.

​
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