# Get configuration

> Returns the whole configuration of a line's AI receptionist in one call: business details, voice and language, prompt, capabilities, business hours, transfer…

`GET /v2/api/numbers/{number}/agent`

<Note>
**Required scope:** `AGENTS_READ`
</Note>

## Behavior

Returns the whole configuration of one line's AI receptionist. The `{number}` path parameter is the Allo phone number in E.164 format.

Read this before any write. [Update configuration](/docs/agent/update-agent) replaces whole collections, so you need the current state to avoid dropping configuration you did not mean to touch.

## What comes back

- `agent` holds the receptionist's own settings, plus `status` and `is_default`, which are read-only here.
- `prompt` carries either `sections` or `custom_prompt`, never both. `custom_prompt` is what an older line has when its prompt was written as freeform text.
- `capabilities` always reports all three toggles, so `false` means off, not unavailable.
- `scheduling.calendars` lists only the calendars this receptionist books on. To see every calendar connected to the workspace, call [List calendars](/docs/agent/list-calendars).
- `knowledge.websites` and `knowledge.files` list your team's whole knowledge library, without the crawled or extracted text. `status` is `ACTIVE` when this line's receptionist answers from the entry and `DISABLED` when this line does not use it.
- `knowledge.text` is deprecated. It is still returned, see [Update configuration](/docs/agent/update-agent#knowledge-text).

## Errors

- `403 API_KEY_INSUFFICIENT_SCOPE`: the key does not hold `AGENTS_READ`.
- `404 PHONE_NUMBER_NOT_FOUND`: the number is not one you have access to.
