> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.agentrouter.to/llms.txt.
> For full documentation content, see https://docs.agentrouter.to/llms-full.txt.

# API reference

Use the API Reference tab for the full public AgentRouter API: catalog discovery, recommendation, execution, wallet, and usage.

## Core Endpoints

* `GET /domains`
* `GET /domains/{domainKey}`
* `GET /domains/{domainKey}/capabilities`
* `GET /domains/{domainKey}/capabilities/{capabilityId}`
* `GET /domains/{domainKey}/capabilities/{capabilityId}/contract`
* `GET /domains/{domainKey}/routes`
* `GET /domains/{domainKey}/capabilities/{capabilityId}/routes`
* `POST /domains/{domainKey}/capabilities/{capabilityId}/recommend`
* `POST /domains/{domainKey}/capabilities/{capabilityId}/execute`
* `GET /wallet`
* `GET /usage`

## How To Read The Reference

Use the reference in this order:

1. Start with catalog endpoints such as `/domains` and `/capabilities`.
2. Read `/contract` when you need the field-level request shape.
3. Use `/recommend` when AgentRouter should choose the route.
4. Use `/execute` when you want the paid operation to happen.
5. Inspect `/wallet` and `/usage` after execution.

## Authentication

All authenticated public calls use:

```http
Authorization: Bearer aak_...
```

Get your API key from:

```text
https://www.agentrouter.to/agentic-api/install
```

<Note>
  For capability-scoped requests, the request body varies by capability. Use the contract endpoint to inspect required fields and examples.
</Note>

For concrete provider comparisons and domain-specific walkthroughs, jump to the supporting domain pages on the main site:

* `https://www.agentrouter.to/supporting-domains/overview`
* `https://www.agentrouter.to/supporting-domains/email`
* `https://www.agentrouter.to/supporting-domains/enrichment`
* `https://www.agentrouter.to/supporting-domains/social`
* `https://www.agentrouter.to/supporting-domains/post`
* `https://www.agentrouter.to/supporting-domains/finance`