1. Public Endpoints
KyzoAI
  • KyzoAI
    • Public Endpoints
      • Place Call
        POST
      • Get Agents
        GET
      • Get Campaigns
        GET
      • Get placed call
        GET
    • Schemas
      • kyzo-place-call-api
      • ExternalCallResponse
      • ErrorResponse
  1. Public Endpoints

Get placed call

GET
/organizations/{organizationId}/calls/{callId}
Retrieve the current status and outcome of a call by its callId.
Use the callId returned by Place Call (POST /organizations/{organizationId}/agents/{agentId}/placeCall) to poll this endpoint until the call completes. Any call in the organization can be read — outbound campaign calls, test calls, externally placed (signal) calls, and inbound calls; the callType field in the response tells you which kind was resolved.
Authentication: pass your organization's API key in the x-api-key header. The call must belong to the organization in the path — IDs from other organizations return 404.
Rate limit: 60 requests per 60 seconds per API key on this route. Exceeding it returns 429. Polling every 2 seconds per in-flight call stays comfortably within the limit.
Notes:
All fields except callId and callType are optional and may be absent (or null) while the call is still in progress — e.g. summary, transcript, callSeconds, and callRecordingLink are populated only after the call ends.
Date fields (createdAt, updatedAt, callPlacedTime, callRescheduleTime) are ISO-8601 UTC strings.
campaignId is present only when callType is campaign.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Path Params

Responses

🟢200
application/json
Call found. Fields not yet known (call still in progress) are omitted or null.
Bodyapplication/json

🟠400
🟠401
🟠404
🟠429
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '/organizations//calls/' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Completed external call
{
    "callId": "66a0d4f19b2c7e0013cd56ef",
    "callType": "signal",
    "agentId": "6641b7d02f8a1c0011ef99aa",
    "calleeNumber": "+14155550123",
    "createdAt": "2026-07-27T10:15:02.481Z",
    "updatedAt": "2026-07-27T10:19:40.112Z",
    "phone": "+14155550123",
    "firstName": "Jane",
    "lastName": "Doe",
    "companyName": "Acme Corp",
    "email": "jane@acme.com",
    "lineStatus": "Answered",
    "callStatus": "ended",
    "callEndReason": "customer-ended-call",
    "callPlacedTime": "2026-07-27T10:15:05.000Z",
    "callSeconds": 213,
    "summary": "Customer was interested in the premium plan and asked for a follow-up email with pricing.",
    "transcript": "AI: Hello, this is ...\nUser: Hi ...",
    "interestLevel": "Interested",
    "callRecordingLink": "https://storage.googleapis.com/kyzo-recordings/xyz.wav"
}
Modified at 2026-07-28 07:23:26
Previous
Get Campaigns
Next
kyzo-place-call-api
Built with