# Get a call (/api-reference/calls/getCall)

## GET /api/v1/calls/{call_id}

Operation ID: `getCall`
Get a call
Status, transcript, summary, outcome, cost and the details the agent collected.

### Parameters

| Name | In | Required | Description |
|---|---|---|---|
| `call_id` | path | yes |  |

### Responses

#### 200 OK

Example (example):

```json
{
  "call": {
    "agentId": "4f6d2c1a-9b7e-4c3d-8a21-5e0f7b9c1d23",
    "agentName": "Priya",
    "billableMinutes": 2,
    "billedInr": 9,
    "callType": "manual",
    "campaignId": "e3f4a5b6-c7d8-4e9f-a0b1-c2d3e4f5a6b7",
    "campaignName": "Priya instant calls",
    "channel": "instant",
    "createdAt": "2026-11-14T10:02:09Z",
    "duration": 94,
    "endTime": "2026-11-14T10:03:45Z",
    "endedReason": "customer-ended-call",
    "extractedFields": {
      "delivery_slot": "morning"
    },
    "fromNumber": "+918045671234",
    "hasRecording": true,
    "id": "8c1e5b7a-2d4f-4e9a-b6c3-1f0a9d8e7b65",
    "isEscalated": false,
    "leadId": "b2a7c9d1-6e3f-4a8b-9c0d-1e2f3a4b5c6d",
    "leadName": "Asha Verma",
    "merchantOutcome": "interested",
    "metadata": {
      "crmId": "0065g00000XyZ"
    },
    "outcome": "successful",
    "outcomeCategory": "interested",
    "phoneNumber": "+919812345678",
    "phoneNumberId": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d",
    "sentiment": "positive",
    "startTime": "2026-11-14T10:02:11Z",
    "status": "completed",
    "summary": "Customer confirmed Friday delivery and asked for a morning slot.",
    "transcript": "Assistant: Hi Asha, this is Priya from Acme about order A-1042.\nUser: Yes, go ahead.",
    "updatedAt": "2026-11-14T10:03:52Z",
    "whatsappSent": [
      {
        "createdAt": "2026-11-14T10:03:10Z",
        "error": "",
        "id": "0d9c8b7a-6f5e-4d3c-2b1a-0f9e8d7c6b5a",
        "kind": "template",
        "status": "delivered",
        "statusAt": "2026-11-14T10:03:14Z",
        "template": "order_confirmation"
      }
    ]
  },
  "success": true
}
```

#### 401 Unauthorized: `api_key_expired`, `invalid_api_key`, `unauthenticated`.

Example (The API key has expired.):

```json
{
  "detail": "The API key has expired.",
  "error": {
    "code": "api_key_expired",
    "docUrl": "https://docs.callmitra.ai/errors/api_key_expired",
    "message": "The API key has expired.",
    "param": null,
    "requestId": "req_5f1c2e9b7a3d4c0e8b6a1f2d3c4b5a69",
    "type": "authentication_error"
  }
}
```

Example (The API key is invalid or has been revoked.):

```json
{
  "detail": "The API key is invalid or has been revoked.",
  "error": {
    "code": "invalid_api_key",
    "docUrl": "https://docs.callmitra.ai/errors/invalid_api_key",
    "message": "The API key is invalid or has been revoked.",
    "param": null,
    "requestId": "req_5f1c2e9b7a3d4c0e8b6a1f2d3c4b5a69",
    "type": "authentication_error"
  }
}
```

Example (Authentication required.):

```json
{
  "detail": "Authentication required.",
  "error": {
    "code": "unauthenticated",
    "docUrl": "https://docs.callmitra.ai/errors/unauthenticated",
    "message": "Authentication required.",
    "param": null,
    "requestId": "req_5f1c2e9b7a3d4c0e8b6a1f2d3c4b5a69",
    "type": "authentication_error"
  }
}
```

#### 403 Forbidden: `api_key_scope_denied`, `permission_denied`.

Example (The API key does not have the scope required for this request.):

```json
{
  "detail": "The API key does not have the scope required for this request.",
  "error": {
    "code": "api_key_scope_denied",
    "docUrl": "https://docs.callmitra.ai/errors/api_key_scope_denied",
    "message": "The API key does not have the scope required for this request.",
    "param": null,
    "requestId": "req_5f1c2e9b7a3d4c0e8b6a1f2d3c4b5a69",
    "type": "permission_error"
  }
}
```

Example (You do not have permission to perform this action.):

```json
{
  "detail": "You do not have permission to perform this action.",
  "error": {
    "code": "permission_denied",
    "docUrl": "https://docs.callmitra.ai/errors/permission_denied",
    "message": "You do not have permission to perform this action.",
    "param": null,
    "requestId": "req_5f1c2e9b7a3d4c0e8b6a1f2d3c4b5a69",
    "type": "permission_error"
  }
}
```

#### 404 Not found: `call_not_found`.

Example (Call not found.):

```json
{
  "detail": "Call not found.",
  "error": {
    "code": "call_not_found",
    "docUrl": "https://docs.callmitra.ai/errors/call_not_found",
    "message": "Call not found.",
    "param": null,
    "requestId": "req_5f1c2e9b7a3d4c0e8b6a1f2d3c4b5a69",
    "type": "not_found_error"
  }
}
```

#### 422 Invalid parameters: `parameter_invalid`.

Example (One or more parameters are invalid.):

```json
{
  "detail": [
    {
      "loc": [
        "body",
        "phone"
      ],
      "msg": "Field required",
      "type": "missing"
    }
  ],
  "error": {
    "code": "parameter_invalid",
    "docUrl": "https://docs.callmitra.ai/errors/parameter_invalid",
    "message": "One or more parameters are invalid.",
    "param": "phone",
    "requestId": "req_5f1c2e9b7a3d4c0e8b6a1f2d3c4b5a69",
    "type": "invalid_request_error"
  }
}
```

#### 429 Too many requests: `rate_limit_exceeded`.

Example (Too many requests. Slow down and retry later.):

```json
{
  "detail": "Too many requests. Slow down and retry later.",
  "error": {
    "code": "rate_limit_exceeded",
    "docUrl": "https://docs.callmitra.ai/errors/rate_limit_exceeded",
    "message": "Too many requests. Slow down and retry later.",
    "param": null,
    "requestId": "req_5f1c2e9b7a3d4c0e8b6a1f2d3c4b5a69",
    "type": "rate_limit_error"
  }
}
```

#### 500 Server error: `internal_error`.

Example (Something went wrong on our side.):

```json
{
  "detail": "Something went wrong on our side.",
  "error": {
    "code": "internal_error",
    "docUrl": "https://docs.callmitra.ai/errors/internal_error",
    "message": "Something went wrong on our side.",
    "param": null,
    "requestId": "req_5f1c2e9b7a3d4c0e8b6a1f2d3c4b5a69",
    "type": "api_error"
  }
}
```

### Error codes

- [`api_key_expired`](/errors/api_key_expired)
- [`invalid_api_key`](/errors/invalid_api_key)
- [`unauthenticated`](/errors/unauthenticated)
- [`api_key_scope_denied`](/errors/api_key_scope_denied)
- [`permission_denied`](/errors/permission_denied)
- [`call_not_found`](/errors/call_not_found)
- [`parameter_invalid`](/errors/parameter_invalid)
- [`rate_limit_exceeded`](/errors/rate_limit_exceeded)
- [`internal_error`](/errors/internal_error)
