Skip to main content

​
Base URL

All API requests use the following base URL: 
https://api.agentscore.com

​
Authentication

Every request must include an API key in the X-API-Key header: 
curl -H "X-API-Key: as_live_your_key_here" \
  https://api.agentscore.com/v1/reputation/0x1234...
Get your API key from the dashboard. Requests without a valid API key receive: 
{
  "error": {
    "code": "signup_required",
    "message": "Sign up for a free account to use the AgentScore API.",
    "signup_url": "https://www.agentscore.com/sign-up"
  }
}

​
Tiers

See pricing for current tier names, quotas, and rate-limit numbers. Endpoint availability shown below by paid vs. free; tier names in this table reflect the live pricing page.
FreePaidEnterprise
POST /v1/assessYesYesYes
POST /v1/sessionsYesYesYes
GET /v1/sessions/:tokenYesYesYes
Compliance policy (assess)YesYesYes
Custom policiesNoNoYes
GET /v1/reputationGrade + scoreFull responseFull response
SupportCommunityEmail / SlackDedicated
The /v1/assess and /v1/sessions identity endpoints are open to all tiers including Free, gated by monthly quota rather than by tier; see pricing for quotas. /v1/reputation is a supplementary on-chain signal: the free tier returns a redacted response (numeric score and grade only); dimensions, confidence, payment activity, and evidence are available on paid plans.

​
Endpoints

MethodPathDescriptionMin Tier
POST/v1/assessIdentity assessment with policy evaluationFree+
POST/v1/sessionsCreate verification sessionFree+
GET/v1/sessions/:tokenPoll session statusFree+
POST/v1/credentialsCreate operator credentialFree+
GET/v1/credentialsList operator credentialsFree+
DELETE/v1/credentials/{id}Revoke operator credentialFree+
POST/v1/credentials/walletsReport a wallet seen paying under a credentialFree+
GET/v1/reputation/{address}Supplementary on-chain reputation signal (redacted for free tier)Free

​
Response format

All responses are JSON. Successful responses return HTTP 200. Errors return the appropriate HTTP status code with an error object: 
{
  "error": {
    "code": "error_code",
    "message": "Human-readable description."
  }
}

​
Versioning

The API is versioned via the URL path (/v1/). Breaking changes will be introduced under a new version prefix.