> ## Documentation Index
> Fetch the complete documentation index at: https://stage-docs.oktivo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Call Status

> Get the status and details of an API-triggered call.

## Path Parameters

**contactUID** `string` *required*

The unique identifier of the contact, returned from the [Trigger Call](https://stage-docs.oktivo.com/api-reference/calls/trigger-call.md) endpoint.

## Response

**success** `boolean`

Indicates if the request was successful.

**data** `object`

**data properties**

**contactUID** `string`

Unique identifier for this contact.

**campaignUID** `string`

The campaign this call belongs to.

**phone** `string`

The phone number dialed (E.164 format).

**name** `string`

The contact's display name.

**status** `string`

Contact-level status: `pending`, `in_progress`, `completed`, `failed`, or `stopped`.

**callStatus** `string`

Call-level outcome: `ringing`, `in_progress`, `completed`, `busy`, `no_answer`, `failed`, etc.

**callDuration** `number`

Actual call duration in seconds.

**billingDuration** `number`

Rounded-up duration used for billing (in seconds, rounded to nearest minute).

**attempts** `number`

Number of call attempts made (including the initial attempt).

**lastError** `string | null`

Description of the most recent error, or `null` if no errors.

**retryConfig** `object | null`

The retry configuration for this call, or `null` if no retries configured.

**dynamicVariables** `object | null`

The dynamic variables passed when the call was triggered.

**callDirection** `string`

Always `outbound` for API-triggered calls.

**createdAt** `string`

ISO 8601 timestamp of when the call was created.

**updatedAt** `string`

ISO 8601 timestamp of the last status update.

```json 200 Success theme={null}
{
  "success": true,
  "data": {
    "contactUID": "contact_7f8a9b0c1d2e",
    "campaignUID": "campaign_3e4f5g6h7i8j",
    "phone": "+14155551234",
    "name": "Jane Smith",
    "status": "completed",
    "callStatus": "completed",
    "callDuration": 145,
    "billingDuration": 180,
    "attempts": 1,
    "lastError": null,
    "retryConfig": {
      "retryCount": 2,
      "retryDelays": [5, 15]
    },
    "dynamicVariables": {
      "company": "Acme Corp",
      "deal_value": "$50,000"
    },
    "callDirection": "outbound",
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2025-01-15T10:02:25.000Z"
  }
}
```

```json 404 Not Found theme={null}
{
  "success": false,
  "message": "Contact not found"
}
```

> [!NOTE]
>
> This endpoint accepts both **API Token** (`okt_...`) and **JWT** authentication. You can only access calls belonging to your account.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.