Skip to main content

​
Getting an API key

  1. Sign up at agentscore.com
  2. Go to the dashboard
  3. Copy your API key (starts with as_live_)

​
Using your API key

Include the key in the X-API-Key header on every request: 
curl -H "X-API-Key: as_live_your_key_here" \
  https://api.agentscore.com/v1/reputation/0x1234567890abcdef1234567890abcdef12345678

const response = await fetch("https://api.agentscore.com/v1/reputation/0x1234567890abcdef1234567890abcdef12345678", {
  headers: { "X-API-Key": process.env.AGENTSCORE_API_KEY },
});

import requests

response = requests.get(
    "https://api.agentscore.com/v1/reputation/0x1234567890abcdef1234567890abcdef12345678",
    headers={"X-API-Key": "as_live_your_key_here"},
)

​
Error responses

​
Missing or invalid key (401)

{
  "error": {
    "code": "signup_required",
    "message": "Sign up for a free account to use the AgentScore API.",
    "signup_url": "https://www.agentscore.com/sign-up"
  }
}

​
Endpoint not enabled for your account (402)

{
  "error": {
    "code": "payment_required",
    "message": "This endpoint is not enabled for your account. See https://www.agentscore.com/pricing"
  }
}

​
Rate limits and quotas

See pricing for current per-second rate limits and request quotas per tier. When you exceed the per-second rate limit, you’ll receive a 429 with code: "rate_limited". When you exceed your account quota, you’ll receive a 429 with code: "quota_exceeded". Rate limit headers are included in every response:
HeaderDescription
X-RateLimit-LimitRequests per second allowed (e.g., 5/s or unlimited)
X-RateLimit-RemainingRequests remaining in current window
X-RateLimit-ResetSeconds until the rate limit window resets
X-Quota-LimitTotal request quota for your tier
X-Quota-UsedRequests used in current quota period
X-Quota-ResetDate when quota resets, e.g. 2026-05-01. Omitted for enterprise.
Enterprise tier returns only X-RateLimit-Limit: unlimited with no remaining, reset, or quota headers.

​
Key management

  • Keys can be regenerated from the dashboard
  • Each account gets one active key
  • Enterprise accounts can request multiple keys