# Check availability before transferring a caller (/docs/api-reference/ping-post/check-availability-before-transferring-a-caller)



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Ask whether careCycle can take a live caller right now, before you transfer them. Returns whether the call can be taken right now (`agent_available`) and the tracking number to transfer the caller to (`number`).

Availability is a real check: live agent presence, business hours, AI coverage, and per-agent source blocks. When the ping includes `state` and the destination routes by agent licensure, availability also requires an agent licensed in that state (declined as `no_licensed_agents`).

Include any qualification data you have (name, date of birth, state, postal code, etc.) in the JSON body. It is stored with the ping and used to pre-fill the customer record when the call arrives. Unrecognized body fields are preserved as additional customer data.

Requires an API key with the `ping-post` permission scoped to the pinged source (`x-api-key` header).

<APIPage document="&#x22;../../apps/api/openapi/specs/openapi-public.yaml&#x22;" operations="[{&#x22;path&#x22;:&#x22;/v2/ping&#x22;,&#x22;method&#x22;:&#x22;post&#x22;}]" />