Get a call (rich detail)

get a single call with full detail. Extends the list shape with the heavy fields: transcript, AI summary, and recording URL or number used.

GET https://api.centerfy.ai/webhooks/inbound/calls/:id

Headers

HeaderRequiredValueDescription
x-api-keyYesyour sub-account API key (cfy_…)authenticates the request; or pass Authorization: Bearer <key>.

Path parameters

NameTypeRequiredDescription
idstring (uuid)Yesthe call id. A non-uuid returns 400; a call that does not exist returns 404.

Example

curl -X GET "https://api.centerfy.ai/webhooks/inbound/calls/{id}" \
  -H "x-api-key: $CENTERFY_API_KEY"
import { CenterfyClient } from "@centerfy/sdk";

const centerfy = new CenterfyClient({ apiKey: process.env.CENTERFY_API_KEY! });

const result = await centerfy.calls.get("<callId>");
console.log(result);
centerfy calls get <callId>

MCP tool: centerfy_calls_get (see MCP server)

Response

{
  "status": "success",
  "call": {
    "id": "d4e5f6a7-2222-4abc-9def-000000000020",
    "call_sid": "CA0123456789abcdef0123456789abcdef",
    "direction": "inbound",
    "status": "completed",
    "from": "+14155550123",
    "to": "+18005551234",
    "duration_seconds": 142,
    "has_recording": true,
    "agent_id": "b2c3d4e5-3333-4abc-9def-000000000030",
    "agent_name": "Front Desk AI",
    "contact_id": "7f1c9e2a-3b4d-4e5f-8a90-1b2c3d4e5f60",
    "contact_name": "Jane Doe",
    "ended_reason": "completed",
    "started_at": "2026-06-12T15:00:00.000Z",
    "ended_at": "2026-06-12T15:02:22.000Z",
    "transcript": "Agent: Thanks for calling, how can I help?\nCaller: I'd like to book an appointment...",
    "ai_summary": "Caller requested to book an appointment for next Tuesday; agent confirmed availability.",
    "number_used": "+18005551234",
    "created_at": "2026-06-12T15:00:00.000Z",
    "updated_at": "2026-06-12T15:02:30.000Z"
  }
}

Errors

  • 401 — if unauthenticated; 400 for an invalid call id; 404 if the call does not exist.

Notes

Read-only. Returns the full list-shape fields plus transcript, ai_summary, number_used, created_at, and updated_at.

© 2026 Centerfy AI. All rights reserved.