---
title: "Get Inbound Route"
method: GET
path: "/inbound-routes/{route_id}"
tags: ["inbound-routes"]
---

# Get Inbound Route

`GET /inbound-routes/{route_id}`

## Request

- Base URL: `https://dev.whispa.net` (the document declares no server; this is the origin it was published from)
- URL: `https://dev.whispa.net/inbound-routes/{route_id}`
- Auth: one of:
  - OAuth 2
    - Password
    - Token URL: `auth/bearer/login`
  - API key in cookie `access_token`

## Path parameters

- `route_id` string, uuid, required

## Response `200`

Successful Response

- InboundRouteRead
  - `display_name` string, required
  - `scenario` string, required: ai_agent scenario with scenario_metadata.supports_inbound
  - `user_id` string, uuid, required: Owning service user for session ownership/attribution
  - `voice_id` string, nullable
  - `opening_line` string, nullable: Overrides the scenario's inbound_greeting; raw $placeholder template, rendered per call.
  - `human_destination` string, nullable: Transfer target for this route; empty = offer callback instead
  - `fallback_destination` string, nullable: Queue/voicemail destination (TCN: human hunt group SID) for auto-answered calls the autonomous agent cannot take, and for callers it cannot continue with (unknown caller, model failure, failed identity check)
  - `hours_start` string, nullable: 'HH:MM' local time
  - `hours_end` string, nullable: 'HH:MM' local time
  - `hours_days` integer[], nullable: date.weekday() ints (0=Mon); null = every day
  - `hours_timezone` string, nullable
  - `transfer_hours_start` string, nullable: 'HH:MM' local time; null with end = the team's business hours
  - `transfer_hours_end` string, nullable: 'HH:MM' local time; null with start = the team's business hours
  - `transfer_hours_days` integer[], nullable: Live-transfer date.weekday() ints (0=Mon); null = every day
  - `transfer_hours_timezone` string, nullable
  - `transfer_hours_exclude_public_holidays` boolean: Close live transfers on Australian national public holidays
  - `unknown_caller_policy` 'proceed' | 'fallback': How to treat a caller whose number matches no CRM account. Multiple matches never use this policy: they require a specialist because v1 deliberately has no account-selection or multi-account self-service.
  - `max_concurrent` integer, nullable
  - `id` string, uuid, required
  - `provider` string, required
  - `provider_ref` string, required
  - `enabled` boolean, required
  - `configuration_error` string, nullable
  - `required_provider_ref` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/whispa/apis/whispa-api.md) - [All operations](https://skmtc.dev/whispa/apis/whispa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/whispa/apis/whispa-api/revisions/12c2e4aca43c?raw)