# Get Call Status

> GET /masking/calls/:call_sid — fetch the current state of a masked call. Poll until a terminal state.

Source: https://edesy.in/docs/number-masking/api-reference/get-call-status

```
GET /masking/calls/:call_sid
```

Returns the current state of a call. Poll this every 2–3 seconds until `status` reaches a terminal state (`completed`, `failed`, `no-answer`). See the [call lifecycle](https://edesy.in/docs/number-masking/getting-started/call-lifecycle).

## Path parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `call_sid` | string (UUID) | Yes | The `call_sid` returned by [Initiate a Call](https://edesy.in/docs/number-masking/api-reference/initiate-call). |

## Request

```bash
curl https://voice-api.edesy.in/v1/masking/calls/d28be7cd-9840-4b23-9627-199f1ef81fc6 \
  -H "Authorization: Bearer vp_YOUR_API_KEY"
```

```javascript
const response = await fetch(
  "https://voice-api.edesy.in/v1/masking/calls/d28be7cd-9840-4b23-9627-199f1ef81fc6",
  { headers: { "Authorization": "Bearer vp_YOUR_API_KEY" } },
);
console.log(await response.json());
```

```python
import requests

response = requests.get(
    "https://voice-api.edesy.in/v1/masking/calls/d28be7cd-9840-4b23-9627-199f1ef81fc6",
    headers={"Authorization": "Bearer vp_YOUR_API_KEY"},
)
print(response.json())
```

## Responses

**`200` — Current call state**

```json
{
  "data": {
    "id": "d28be7cd-9840-4b23-9627-199f1ef81fc6",
    "jambonz_call_sid": "31d9c8e2-1234-4567-89ab-cdef01234567",
    "caller_number": "917969002802",
    "target_number": "9876543210",
    "masked_number": "917969002802",
    "direction": "click_to_call",
    "status": "completed",
    "started_at": "2026-05-11T08:30:00Z",
    "answered_at": "2026-05-11T08:30:08Z",
    "ended_at": "2026-05-11T08:31:42Z",
    "duration_sec": 94,
    "bill_duration_sec": 120,
    "hangup_cause": "NORMAL_CLEARING",
    "price": 3.0,
    "recording_url": "recordings/2026/05/11/d28be7cd.wav"
  }
}
```

**`404` — No call exists with this call_sid**

```json
{
  "error": { "code": "not_found", "message": "Call not found" }
}
```