Hanzo
OpenapiTel

Lists the calls this org has placed or received, newest first.

Lists the calls this org has placed or received, newest first.

GET /v1/tel/calls

Addresshttps://api.hanzo.ai/v1/tel/calls
MethodGET
Operationget_tel_calls
AuthAuthorization: Bearer $HANZO_API_KEY

Lists the calls this org has placed or received, newest first. Like the message list beside it, these are our own records rather than the carrier's.

Request

GET /v1/tel/calls takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200callListok

200 body — 7 fields.

FieldInTypeAlwaysDescription
databodyCall[]Data is this org's own calls, newest first — what this platform placed or received on its behalf, which is our record rather than the carrier's.
data[].agentbodystringAgent names the Hanzo assistant handling the call.
data[].frombodystringFrom is the calling number in E.164.
data[].idbodystringID is the carrier's handle for the call — what a hangup or a lookup names.
data[].orgbodystringOrg is the tenant the call was placed for or received by.
data[].statusbodystringStatus is where the call is: "queued", "ringing", "answered", "completed" or "failed".
data[].tobodystringTo is the called number in E.164.

Failure carries the platform error shape — see Errors.

Examples

hanzo tel calls list

Tel API · All Hanzo APIs · Interactive reference

How is this guide?

On this page