WOworkiz
Calls

Retrieve a single Call

Changed on

Beta: Breaking changes may occur without notice.

Retrieves a single Call by its ID, including its AI insights, transcript, and caller locations.

get/v2/calls/{id}

Request

Path parameters

idstring required
Example:CAL-5e2a9c7b1d4f8e36

The call ID (prefix CAL-).

Headers

Authorizationstring required
Example:Bearer <token>

Bearer Token

Response

The requested Call.

idstring

The ID of the call (prefix CAL-).

direction'inbound' | 'outgoing'

The direction of the call.

fromstring

The phone number the call was made from.

tostring

The phone number the call was made to. For call masking calls, this is the number the call was connected to, not the masking number.

callMaskingNumberstring nullable

The call masking number the call was placed through. null when the call did not use call masking.

durationnumber

The duration of the call in seconds.

status'answered' | 'missed' | 'voicemail' | 'active' | 'geniusAnswering'

The status of the call: active while the call is in progress or on hold, geniusAnswering when Genius Answering handled it, voicemail when the caller left a voicemail, answered when a person answered and missed otherwise.

hasRecordingboolean

Whether a recording is available for the call.

flowNamestring nullable

The name of the call flow that handled the call. Calls placed through call masking show Call Masking.

adGroupIdstring nullable

The ID of the ad group of the called number (prefix AG-).

clientIdstring nullable

The ID of the client on the call (prefix CL-). null when the caller is unknown.

clientNamestring nullable

The name of the client on the call, as recorded on the call.

jobIdstring nullable

The ID of the job linked to the call (prefix JOB-).

leadIdstring nullable

The ID of the lead linked to the call (prefix LD-).

answeredByUserIdstring nullable

The ID of the user who answered the call (prefix USR-).

answeredByUserNamestring nullable

The name of the user who answered the call, as recorded on the call.

calledByUserIdstring nullable

The ID of the user who placed the call (prefix USR-).

calledByUserNamestring nullable

The name of the user who placed the call, as recorded on the call.

tagsstring[]

A list of tag IDs on the call (prefix TAG-).

updatedAtstring nullable

The date and time the call was last updated, in the account timezone.

createdAtstring

The date and time the call started, in the account timezone.

Example response

{
  "id": "CAL-5e2a9c7b1d4f8e36",
  "direction": "inbound",
  "from": "2125550199",
  "to": "2125550100",
  "callMaskingNumber": "2125550142",
  "duration": 125,
  "status": "answered",
  "hasRecording": true,
  "flowName": "Main Flow",
  "adGroupId": "AG-71b8d7310acbf8cc",
  "clientId": "CL-2d1f8b3a9c7e6f50",
  "clientName": "Jane Smith",
  "jobId": "JOB-6a0e4d2b7f9c1e38",
  "leadId": "LD-4c8b2e6f1a9d3e70",
  "answeredByUserId": "USR-38c1ee5c4efa38a4",
  "answeredByUserName": "Jane Smith",
  "calledByUserId": "USR-38c1ee5c4efa38a4",
  "calledByUserName": "John Doe",
  "tags": [
    "TAG-16a94b03317f6e64"
  ],
  "insights": {
    "sentiment": "positive",
    "intent": "booking",
    "dispatcherScore": 82,
    "objection": "price",
    "pricingDiscussed": true
  },
  "updatedAt": "2025-01-13 13:39:10",
  "createdAt": "2025-01-13 13:36:46"
}

Changes