API Reference
Explore and test the Human Passport APIs. Build Sybil-resistant applications.
Base URL
https://api.passport.xyzStamps API
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
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}