Skip to content
Project BlueDocs
Popular pages
Guides / Getting startedQuickstartGet an API key, send your first message, and confirm delivery.API reference / MessagesPOSTSend a messageSend iMessage or SMS, with media, voice memos, and message effects./send-api-messageGuides / IntegrationsWebhooksReceive message and call events at your own endpoint.Guides / Getting startedAuthenticationCreate an API key and authenticate requests with a bearer token.AI tools / AI toolsMCP server & skillConnect Claude, Codex, Cursor, and other AI tools to Project Blue.
↑ ↓ Navigate↵ Openesc Close
Dashboard
For AI agents
View as Markdown

FaceTime call status

Status is driven by call lifecycle events. Poll this endpoint to track ringing → answered → ended.

GET/get-facetime-call-status-apiBearer token

Query parameters

call_uuidstringRequired
The call_uuid returned by POST /start-facetime-call-api, or from an inbound FaceTime webhook.

Response

status"OK"Required
Present on every successful read.
call_uuidstringRequired
Identifies the call.
call_statusstringRequired
Live status. Inbound values: ringing, answered, ended, declined, no_answer, voicemail, busy, failed.
direction"inbound" | "outbound"Required
Whether the call was received on your line or placed from it.
addressstringRequired
The other party's number in E.164.
ringing_atstring (ISO 8601) | nullRequired
When the call started ringing, or null if it has not.
answered_atstring (ISO 8601) | nullRequired
When the call was answered, or null if it never was.
ended_atstring (ISO 8601) | nullRequired
When the call reached a terminal state, or null if it has not.

call_status values

initiatedringingansweredendeddeclinedno_answervoicemailbusyfailed
API reference