> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentscore.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Authentication

> How to get and use API keys.

## Getting an API key

1. Sign up at [agentscore.com](https://www.agentscore.com/sign-up)
2. Go to the [dashboard](https://www.agentscore.com/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:

<CodeGroup>
  ```bash cURL theme={"dark"}
  curl -H "X-API-Key: as_live_your_key_here" \
    https://api.agentscore.com/v1/reputation/0x1234567890abcdef1234567890abcdef12345678
  ```

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

  ```python Python theme={"dark"}
  import requests

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

## Error responses

### Missing or invalid key (401)

```json theme={"dark"}
{
  "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)

```json theme={"dark"}
{
  "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](https://www.agentscore.com/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:

| Header                  | Description                                                        |
| ----------------------- | ------------------------------------------------------------------ |
| `X-RateLimit-Limit`     | Requests per second allowed (e.g., `5/s` or `unlimited`)           |
| `X-RateLimit-Remaining` | Requests remaining in current window                               |
| `X-RateLimit-Reset`     | Seconds until the rate limit window resets                         |
| `X-Quota-Limit`         | Total request quota for your tier                                  |
| `X-Quota-Used`          | Requests used in current quota period                              |
| `X-Quota-Reset`         | Date 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