Verification

Public developer endpoints for verifying user wallets against the Humanity Protocol's Proof-of-Humanity registry.

Verify Wallet Address

get

https://api.humanity.orghttps://testnet-api.humanity.org

/v1/human/verify

Returns whether the supplied wallet address is associated with a palm-verified Humanity Protocol user. This is the primary endpoint for dApps and services to integrate Proof-of-Humanity checks.

Authorizations

ApiKeyAuth

X-HP-API-KeystringRequired

Your developer API key for accessing public endpoints.

Query parameters

wallet_addressstringRequired

EIP-55 compliant wallet address to verify.

Example: 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B

Responses

200

Wallet verification status retrieved successfully.

application/json

401

Unauthorized. The request lacks valid authentication credentials.

application/json

403

Forbidden. The server understood the request but refuses to authorize it.

application/json

404

Not Found. The requested resource could not be found.

application/json

get

/v1/human/verify

HTTPcURLJavaScriptPython

GET /v1/human/verify?wallet_address=0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B HTTP/1.1
Host: api.humanity.org
X-HP-API-Key: YOUR_API_KEY
Accept: */*

{
  "wallet_address": "text",
  "is_human": true,
  "user_id": "123e4567-e89b-12d3-a456-426614174000"
}