---
title: "On Call Transfer Destination Request"
method: POST
path: "/vapi/on-call-transfer-destination"
tags: ["Vapi"]
---

# On Call Transfer Destination Request

`POST /vapi/on-call-transfer-destination`

Resolve the after-hours on-call transfer (dedicated transferCall tool).

Same transfer-destination-request contract as /transfer-destination, but
single-purpose: connect a new-case caller to the on-call person. The tool
takes no arguments — there is exactly one destination, the customer's
"On Call" TransferDestination row (for BJL a DID that rings the PBX ONCALL
queue, whose membership the NetSapiens reconciler keeps equal to the
scheduled on-call person).

The on-call window is re-checked here, not just at call start (the
prompt's onCallActive variable is frozen when the call begins, and a call
can span the window boundary). There is deliberately NO fallback chain: a
refused transfer returns {"error": ...}, which plays the tool's
request-failed message and lets the prompt recover into the in-house mini
intake.

## Request body

- VapiTransferDestinationRequest
  - `message` VapiTransferDestinationMessage, required
    - `type` string
    - `call` VapiCallObject
      - `id` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/b642b91e0a5c/schema)