API Reference
Explore and test the Human Passport APIs. Build Sybil-resistant applications.
Stamps API
Base URL
https://api.passport.xyzRequires API Key
GET
GET Stamps Score
/v2/stamps/{scorer_id}/score/{address}This is the primary endpoint that partners using the Stamps product will use.
This endpoint returns the latest score and Stamp data for a single address.
This endpoint returns the latest score and Stamp data for a single address.
Parameters
Try It
Request URL
https://api.passport.xyz/v2/stamps/{scorer_id}/score/{address}GET
GET Score History
/v2/stamps/{scorer_id}/score/{address}/historyThis endpoint will return the historical score and Stamp data for a single address at a specified time.
Note: To access this endpoint, you must submit your use case and be approved by the Passport team. To do so, please fill out the following form, making sure to provide a detailed description of your use case. The Passport team typically reviews and responds to form responses within 48 hours. Request access
Note: To access this endpoint, you must submit your use case and be approved by the Passport team. To do so, please fill out the following form, making sure to provide a detailed description of your use case. The Passport team typically reviews and responds to form responses within 48 hours. Request access
Parameters
Try It
Request URL
https://api.passport.xyz/v2/stamps/{scorer_id}/score/{address}/historyGET
GET Verified Stamps
/v2/stamps/{address}Use this endpoint to request all Stamps that have been verified by the specified Ethereum address.
If you would like to retrieve the metadata for all available Stamps, please use the GET All Stamps endpoint.
If you would like to retrieve the metadata for all available Stamps, please use the GET All Stamps endpoint.
Parameters
Try It
Request URL
https://api.passport.xyz/v2/stamps/{address}GET
GET All Stamps
/v2/stamps/metadataUse this endpoint to request all Stamps available on Passport.
If you would like to retrieve just the Stamps that are connected to a specified Ethereum address, please use the GET Verified Stamps endpoint.
If you would like to retrieve just the Stamps that are connected to a specified Ethereum address, please use the GET Verified Stamps endpoint.
Parameters
No parameters required
Try It
Request URL
https://api.passport.xyz/v2/stamps/metadataModels API
Base URL
https://api.passport.xyzRequires API Key
GET
GET Model Score
/v2/models/score/{address}Retrieve Sybil classification score for an Ethereum address. A score of -1 means that the given address doesn't have enough transaction history. A score of 0 means the user is likely a Sybil, and a score of 100 means the user is likely a human.
Parameters
Try It
Request URL
https://api.passport.xyz/v2/models/score/{address}Individual Verifications
Base URL
https://api.holonym.ioNo API Key Required
GET
GET Gov ID Verification
/sybil-resistance/gov-id/{network}Check if a user has completed government ID (KYC) verification with a unique proof for your action ID. Users can verify at id.human.tech/gov-id.
Parameters
Try It
Request URL
https://api.holonym.io/sybil-resistance/gov-id/{network}GET
GET Phone Verification
/sybil-resistance/phone/{network}Check if a user has completed phone verification with a unique proof for your action ID. Users can verify at id.human.tech/phone.
Parameters
Try It
Request URL
https://api.holonym.io/sybil-resistance/phone/{network}GET
GET Biometrics Verification
/sybil-resistance/biometrics/{network}Check if a user has completed biometric verification (face uniqueness and liveness check). Users can verify at id.human.tech/biometrics.
Parameters
Try It
Request URL
https://api.holonym.io/sybil-resistance/biometrics/{network}GET
GET Proof of Clean Hands
/api/scan/addresses/{address}/attestationsQuery Proof of Clean Hands attestations to verify a user is not on sanctions or PEP (Politically Exposed Persons) lists. Uses Sign Protocol on Optimism. Users can verify at id.human.tech/clean-hands.
Parameters
Try It
Request URL
https://mainnet-rpc.sign.global/api/scan/addresses/{address}/attestations