# Callers

| Method | Path | What it does |
| --- | --- | --- |
| GET | `/v1/callers/{number}` | Everything the account knows about one number |

| Parameter | Meaning |
| --- | --- |
| `days` | How far back, 1 to 365. 90 by default. |
| `limit` | Up to how many calls, and messages, 1 to 50. 10 by default. |
| `include` | Any of `contacts`, `calls`, `messages` (the default is all three) and `transcripts` |

The answer has `number`, `days`, `contacts` (up to 5), `calls` (each with `handled_by`, `summary` and its journey), `messages` (text cut at 400 characters), `last_call`, `last_incoming`, `last_outgoing` and `counts`. The calls come from the same data as `GET /v1/calls`. Transcripts, when asked for, are cut at 6,000 characters. The `agents` scope reaches this route.

[Callers in the API reference](https://vocatech.com/developers/reference/callers)