---
title: "Get Phone Call History"
method: GET
path: "/api/v1/calling/phone-history"
tags: ["CallingService"]
---

# Get Phone Call History

`GET /api/v1/calling/phone-history`

Returns all calls where a phone number appears as caller or callee, with cost and credit details and optional transcripts.

## Query parameters

- `phone` string, required
- `page` integer
- `page_size` integer
- `include_transcripts` boolean

## Response `200`

call history retrieved successfully

- PhoneHistoryResponse
  - `success` boolean
  - `message` string
  - `phone` string
  - `total_count` integer
  - `page` integer
  - `page_size` integer
  - `calls` PhoneHistoryCall[]
    - `id` string, uuid
    - `agent_id` string, uuid
    - `agent_name` string
    - `organization_id` string, uuid
    - `caller_number` string
    - `callee_number` string
    - `caller_name` string
    - `caller_email` string
    - `channel` string
    - `status` string
    - `summary` string
    - `recording_url` string
    - `duration_sec` integer
    - `cost_total` string
    - `twilio_cost` number
    - `model_cost` number
    - `credit_breakdown` PhoneHistoryCreditBreakdown
      - `model_credits` number
      - `provider_credits` number
      - `telephony_base_credits` number
    - `disconnect_reason` string
    - `call_latency_ms` integer
    - `error_message` string
    - `post_call_analysis_result` object
    - `metadata` object
    - `started_at` string, date-time
    - `ended_at` string, date-time
    - `created_at` string, date-time
    - `transcripts` PhoneHistoryTranscript[]
      - `id` string, uuid
      - `call_session_id` string, uuid
      - `message` PhoneHistoryTranscriptMessage
        - `role` string
        - `content` string
      - `timestamp_ms` integer
      - `created_at` string, date-time

## Other responses

- `400` — Missing phone param or invalid organization id
- `401` — Authentication required
- `500` — Query failure

---

[API](https://skmtc.net/ravan/apis/agni-api.md) · [All operations](https://skmtc.net/ravan/apis/agni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ravan/agni-api/revisions/48f45dc58534/schema)