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

# API Overview

> Base URL, authentication, tiers, and rate limits.

## 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:

```bash theme={"dark"}
curl -H "X-API-Key: as_live_your_key_here" \
  https://api.agentscore.com/v1/credentials
```

Get your API key from the [dashboard](https://www.agentscore.com/dashboard).

Requests without a valid API key receive:

```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"
  }
}
```

## Tiers

See [pricing](https://www.agentscore.com/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.

| | Free | Paid | Enterprise |
| - | - | - | - |
| **POST /v1/assess** | Yes | Yes | Yes |
| **POST /v1/sessions** | Yes | Yes | Yes |
| **GET /v1/sessions/:token** | Yes | Yes | Yes |
| **Compliance policy (assess)** | Yes | Yes | Yes |
| **Custom policies** | No | No | Yes |
| **Support** | Community | Email / Slack | Dedicated |

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](https://www.agentscore.com/pricing) for quotas.

## Endpoints

| Method | Path | Description | Min Tier |
| - | - | - | - |
| POST | `/v1/assess` | Identity assessment with policy evaluation | Free+ |
| POST | `/v1/sessions` | Create verification session | Free+ |
| GET | `/v1/sessions/:token` | Poll session status | Free+ |
| POST | `/v1/credentials` | Create operator credential | Free+ |
| GET | `/v1/credentials` | List operator credentials | Free+ |
| DELETE | `/v1/credentials/{id}` | Revoke operator credential | Free+ |
| POST | `/v1/credentials/wallets` | Report a wallet seen paying under a credential | Free+ |

## Response format

All responses are JSON. Successful responses return HTTP 200. Errors return the appropriate HTTP status code with an `error` object:

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


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