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

# API overview

> Base URL, versioning, and conventions.

## Base URL

```
https://api.imarobot.ai
```

All endpoints are versioned under `/v1/`. The `/health` endpoint is unversioned.

## Authentication

All endpoints except `/health` and `GET /v1/verify/:token` require a Bearer token:

```bash theme={null}
Authorization: Bearer sk_live_YOUR_KEY
```

See [Authentication](/api-reference/authentication) for key types and scopes.

## Rate limits

Every response includes rate limit headers:

```
X-RateLimit-Limit: 5000
X-RateLimit-Remaining: 4847
X-RateLimit-Reset: 1711234567
```

| Plan            | Verify endpoint | All other endpoints |
| --------------- | --------------- | ------------------- |
| Unauthenticated | 100 req/min     | 20 req/min          |
| Free            | 500 req/min     | 60 req/min          |
| Developer       | 5,000 req/min   | 500 req/min         |
| Growth          | 50,000 req/min  | 2,000 req/min       |
| Enterprise      | Custom          | Custom              |

Exceeded limits return `429` with the standard error schema.

## Error format

All errors follow a consistent schema:

```json theme={null}
{
  "error": {
    "code": "AGENT_NOT_FOUND",
    "message": "No agent found with the specified ID.",
    "request_id": "req_abc123",
    "docs_url": "https://docs.imarobot.ai/errors/AGENT_NOT_FOUND"
  }
}
```

See [Errors](/api-reference/errors) for the full list of error codes.

## Health check

```bash theme={null}
GET /health
```

```json theme={null}
{
  "status": "ok",
  "version": "1.0.0",
  "timestamp": "2026-03-26T18:00:00.000Z"
}
```

No authentication required. Use this for uptime monitoring and receiver connectivity checks.