> ## 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/credentials
  ```

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

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

  response = requests.get(
      "https://api.agentscore.com/v1/credentials",
      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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.