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

# Get Test Call Status

> Poll the status and trace of a SIP test call.

### Headers

<ParamField header="authorization" type="string" required>
  Your API key for authentication.
</ParamField>

### Query Parameters

<ParamField query="call_id" type="string" required>
  The call ID returned from `POST /v1/sip/test-call`.
</ParamField>

### Response

<ResponseField name="status" type="string">
  Call status: `"queued"`, `"initiated"`, `"ringing"`, `"in-progress"`, `"completed"`, `"failed"`, `"busy"`, `"no-answer"`.
</ResponseField>

<ResponseField name="result" type="string">
  Final result enum: `"connected"`, `"failed"`, `"busy"`, `"no_answer"`, `"pending"`.
</ResponseField>

<ResponseField name="duration_seconds" type="number">
  Call duration in seconds.
</ResponseField>

<ResponseField name="timeline" type="array">
  Array of timeline events with `event` (string), `at` (timestamp), and `detail` (string) fields.
</ResponseField>

```json Example Request theme={null}
curl -X GET 'https://api.bland.ai/v1/sip/test-call/status?call_id=tc_abc123' \
  -H "Authorization: Bearer <token>"
```

<ResponseExample>
  ```json Response theme={null}
  {
    "data": {
      "status": "completed",
      "result": "connected",
      "duration_seconds": 8,
      "timeline": [
        { "event": "initiated", "at": "2026-03-09T12:00:00Z", "detail": "Call initiated" },
        { "event": "ringing", "at": "2026-03-09T12:00:01Z", "detail": "Endpoint ringing" },
        { "event": "answered", "at": "2026-03-09T12:00:03Z", "detail": "Call answered" },
        { "event": "completed", "at": "2026-03-09T12:00:08Z", "detail": "Call ended" }
      ]
    },
    "errors": null
  }
  ```
</ResponseExample>

***

Docs for agents: [llms.txt](/llms.txt)