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

# API Overview

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

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

```bash theme={"dark"}
curl -H "X-API-Key: as_live_your_key_here" \
  https://api.agentscore.sh/v1/reputation/0x1234...
```

Get your API key from the [dashboard](https://agentscore.sh/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://agentscore.sh/sign-up"
  }
}
```

## Tiers

See [pricing](https://agentscore.sh/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          | Pro           | Enterprise    |
| ----------------------------------- | ------------- | ------------- | ------------- |
| **GET /v1/reputation**              | Grade + score | Full response | Full response |
| **POST /v1/assess**                 | No            | Yes           | Yes           |
| **POST /v1/sessions**               | No            | Yes           | Yes           |
| **GET /v1/sessions/:token**         | No            | Yes           | Yes           |
| **Compliance policy (assess)**      | No            | Yes           | Yes           |
| **Verification level (reputation)** | Yes           | Yes           | Yes           |
| **Custom policies**                 | No            | No            | Yes           |
| **Support**                         | Community     | Email         | Dedicated     |

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

| Method | Path                       | Description                                    | Min Tier |
| ------ | -------------------------- | ---------------------------------------------- | -------- |
| GET    | `/v1/reputation/{address}` | Reputation lookup (redacted for free tier)     | Free     |
| POST   | `/v1/assess`               | Trust assessment with policy evaluation        | Pro      |
| POST   | `/v1/sessions`             | Create verification session                    | Pro      |
| GET    | `/v1/sessions/:token`      | Poll session status                            | Pro      |
| POST   | `/v1/credentials`          | Create operator credential                     | Pro      |
| GET    | `/v1/credentials`          | List operator credentials                      | Pro      |
| DELETE | `/v1/credentials/{id}`     | Revoke operator credential                     | Pro      |
| 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.