---
title: "Read opt-in callback routing without changing the default agent"
method: GET
path: "/v1/numbers/{e164}/callback-routing"
---

# Read opt-in callback routing without changing the default agent

`GET /v1/numbers/{e164}/callback-routing`

## Request

- Base URL: `https://volai.cz`
- URL: `https://volai.cz/v1/numbers/{e164}/callback-routing`
- Auth: HTTP bearer

Read the opt-in callback policy of an owned number. The default number routing stays unchanged.

## Path parameters

- `e164` string, required

## Response `200`

Callback routing

- object
  - `callbackRouting` object, required
    - `agentIds` string[], required: Owned active engine agents eligible for verified callbacks; an empty list disables callback routing.
    - `lookbackSecs` integer, required: Maximum age of a real outbound call in seconds, from 60 to 604800.
    - `firstMessage` string: Optional greeting spoken only for a verified campaign callback, up to 500 characters.
    - `missedFirstMessage` string: Optional greeting for a verified callback whose preceding outbound call had no conversation with the customer (not answered, voicemail, voice menu or nobody spoke), up to 500 characters. Without it firstMessage applies to every verified callback.

## Other responses

- `400`: Error codes: validation (request).
- `401`: Error codes: unauthorized (request).
- `403`: Error codes: account_suspended (account).
- `404`: Error codes: not_found (account).
- `429`: Error codes: rate_limited (busy).
- `500`: Error codes: internal_error (service).

---

[API](https://skmtc.dev/volai/apis/volai-rest-api.md) · [All operations](https://skmtc.dev/volai/apis/volai-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/volai/apis/volai-rest-api/revisions/12029b05e2fa?raw)