Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.agentscore.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
Base URL

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

​
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.sh/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://agentscore.sh/sign-up"
  }
}

​
Tiers

See pricing for current quota and rate-limit numbers per tier. Endpoint availability:
FreeProEnterprise
GET /v1/reputationGrade + scoreFull responseFull response
POST /v1/assessNoYesYes
POST /v1/sessionsNoYesYes
GET /v1/sessions/:tokenNoYesYes
Compliance policy (assess)NoYesYes
Verification level (reputation)YesYesYes
Custom policiesNoNoYes
SupportCommunityEmailDedicated
Free tier returns a redacted response from /v1/reputation — numeric score and grade only. Dimensions, confidence, payment activity, reputation breakdown, and evidence are available on Pro and Enterprise tiers.

​
Endpoints

MethodPathDescriptionMin Tier
GET/v1/reputation/{address}Reputation lookup (redacted for free tier)Free
POST/v1/assessTrust assessment with policy evaluationPro
POST/v1/sessionsCreate verification sessionPro
GET/v1/sessions/:tokenPoll session statusPro
POST/v1/credentialsCreate operator credentialPro
GET/v1/credentialsList operator credentialsPro
DELETE/v1/credentials/{id}Revoke operator credentialPro
POST/v1/credentials/walletsReport a wallet seen paying under a credentialFree+

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