# Get started

All requests to the ancon platform APIs are authorized with an access token sent in the `Access-Token` header. A missing or invalid token returns `401 Unauthorized`.

## What do you want to do?

- **You have, or represent, an existing customer** (an ancon platform account with a restaurant or chain) and want an API key for it: [existing customer](#existing-customer).
- **You want to integrate as a partner** and open the integration to many restaurants now and in the future: [partner integrations](https://ancon.dev/partner.md).

## Existing customer

1. In the backoffice ([cloud.ancon.io](https://cloud.ancon.io)), open the integration menu and create an access token. Decide whether it is an outlet-level or tenant-level token (see below).
2. Follow the [API reference](https://ancon.dev/api/core.md) to implement your integration.

## Token levels

| Level | Access |
| --- | --- |
| Tenant | Read and write on all endpoints. |
| Outlet | Read on tenant-level data; read and write on outlet-level data for the outlet the token was created for. |

## First requests

1. [Get tenant details](https://ancon.dev/api/core/tenants/get-tenant-details.md) needs no input and returns the tenant your token belongs to. The `tenantId` is required in many other URLs.
2. [Get outlet list](https://ancon.dev/api/core/tenants/get-outlet-list.md) returns every outlet under the tenant (an outlet-level token only sees its own outlet).

```bash
curl "https://core-api.ancon.io/api/v1/Tenants" \
  -H "Access-Token: $ANCON_TOKEN"
```

## Every response includes

- `X-Rate-Limit-*` headers, see [rate limits](https://ancon.dev/guides/rate-limits.md).
- A correlation id. Include it in any support question or bug report. You can also send your own as `x-correlation-id` (a UUID is best) to correlate logs on both sides.

## Choose a service

- [Core API](https://ancon.dev/api/core.md): tenants, outlets, products, menus, checks, orders, payments.
- [Voucher API](https://ancon.dev/api/voucher.md): bookkeeping, voucher bases and settlement reports.
- [User API](https://ancon.dev/api/user.md): customers, companies, guest groups, tenant users.

## Working with AI agents

Every reference page has a markdown twin (add `.md` to the URL), the raw OpenAPI specs are at `/specs/core.json`, `/specs/voucher.json` and `/specs/user.json`, and [llms.txt](https://ancon.dev/llms.txt) indexes everything. To let an AI assistant act on ancon platform data directly instead, see [MCP and OAuth](https://ancon.dev/mcp.md).

## Next

- [Filtering](https://ancon.dev/guides/filtering.md)
- [Webhooks](https://ancon.dev/guides/webhooks.md)
- Questions: integration-support@ancon.io
