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

# Quickstart

> One curl call, your Group ID, and an API token — your first Operata API response in 90 seconds.

Send one curl request and see an Operata contact in the response. You need a Group ID, an API token, and curl.

## Before you start

* An [Operata account](https://app.operata.io). Your **Operata Group ID** is the UUID in the console URL.
* An **API token** generated under **Settings → Config → API**.

## Make the request

```bash theme={null}
curl -u "$OPERATA_GROUP_ID:$OPERATA_API_TOKEN" \
  "https://api.operata.io/v1/data/calls?fromTime=2026-05-17T00:00:00Z&toTime=2026-05-18T00:00:00Z&size=1"
```

## What you should see

```json theme={null}
{
  "data": [
    {
      "id": "ctr_0HXYZ123456789ABCDE",
      "started_at": "2026-05-17T15:02:11Z",
      "duration_ms": 184200,
      "agent": { "id": "agent_42", "name": "Riley Chen" },
      "queue": "billing-tier-1"
    }
  ],
  "next_cursor": null
}
```

## What the response means

* You authenticated with HTTP Basic — Group ID as username, token as password. See [Authentication](/docs/api-authentication).
* You requested one contact from a 24-hour window using the contact summary endpoint. See [Contact summary](/docs/api-contact-summary).
* The response uses Operata's standard paginated envelope: a `data` array and a `next_cursor` field that is `null` when there are no further pages. See [Pagination](/docs/api-pagination).
* A 429 response means you hit the per-token budget — back off using `Retry-After`. See [Rate limits](/docs/api-rate-limits).
* Every 4xx and 5xx response carries a stable `error.code` you match on. See [Errors](/docs/api-errors).

## Related

<CardGroup cols={3}>
  <Card title="Concepts" href="/docs/concepts-customer-journey-trace">
    The mental model behind contacts, signals, and observations.
  </Card>

  <Card title="API reference" href="/docs/api-getting-started">
    Every endpoint, every parameter.
  </Card>

  <Card title="Data redaction" href="/docs/api-data-redaction">
    Choose which fields to strip before they reach Operata.
  </Card>
</CardGroup>