---
title: "Get Calls"
method: GET
path: "/dashboard/calls"
tags: ["Dashboard"]
---

# Get Calls

`GET /dashboard/calls`

Get paginated, sorted, and filtered calls for the customer. By default, test calls are excluded.

## Query parameters

- `page` integer — Page number
- `page_size` integer — Number of items per page
- `sort_column` string — Column to sort by
- `sort_direction` string — Sort direction
- `search` string, nullable — Search by phone number or caller name
- `direction` string, nullable — Filter by call direction
- `caller_client_status` string, nullable — Filter by caller client status
- `has_error` boolean, nullable — Filter by error status
- `outcome` string, nullable — Filter by call outcome
- `vxt_transfer` string, nullable — Filter by VXT transfer outcome: answered, voicemail, no_answer, not_transferred
- `dialtone_screening` string, nullable — Filter by dialtone screening outcome: accepted, declined, no_answer, none
- `sa_case_number` string, nullable — Filter to calls whose matched SmartAdvocate case number contains this text
- `start_datetime` string, date-time, nullable — Filter calls with start_time >= this UTC datetime (inclusive)
- `end_datetime` string, date-time, nullable — Filter calls with start_time < this UTC datetime (exclusive)
- `intake` boolean, nullable — Filter by intake recording: true = only imported intake recordings (Intakes page), false = exclude them (Calls page), null = no filter
- `transfer_destination` string, uuid, nullable — Filter to calls transferred to this TransferDestination (metrics drill-through; includes claimed bounce-back originals)
- `include_test_calls` boolean — Include test calls in results

## Response `200`

Successful Response

- PaginatedCallsResponse — Paginated calls response schema
  - `calls` RecentCall[], required
    - `call_id` string, uuid, required
    - `phone_number` string, nullable, required
    - `caller_name` string, nullable, required
    - `caller_identity` string, nullable
    - `caller_display_name` string, nullable
    - `duration_seconds` integer, nullable, required
    - `direction` string, required
    - `channel` string
    - `status` string, required
    - `caller_client_status` string, nullable, required
    - `is_test` boolean, required
    - `transferred` boolean
    - `transfer_outcome` string, nullable
    - `staff_leg_pending` boolean
    - `vxt_transferred` boolean, nullable
    - `vxt_voicemail` boolean, nullable
    - `vxt_transfer_no_answer` boolean, nullable
    - `start_time` string, date-time, nullable, required
    - `has_error` boolean, required
    - `error_description` string, nullable, required
    - `hung_up_before_connect` boolean, nullable
    - `errors` CallError[], nullable
      - `severity` string, required — Error severity: 'warning' or 'error'
      - `text` string, required — Error message text
    - `case_id` string, uuid, nullable, required
    - `case_title` string, nullable, required
    - `external_source` string, nullable
    - `quality_score` string, nullable
    - `quality_reason` string, nullable
    - `goal_accomplished` boolean, nullable
    - `goal_reason` string, nullable
    - `caller_hung_up` boolean, nullable
    - `cnam_caller_name` string, nullable
    - `cnam_caller_type` string, nullable
    - `screening_status` string, nullable
    - `screening_phone_number` string, nullable
    - `screening_caller_name` string, nullable
    - `screening_call_reason` string, nullable
    - `screening_decline_reason` string, nullable
    - `case_note_posted` boolean, nullable
    - `case_match_case_name` string, nullable
    - `has_substantive_conversation` boolean, nullable
    - `case_matching_pipeline_status` string, nullable
    - `case_match_status` string, nullable
    - `sa_case_number` string, nullable
    - `sa_case_url` string, nullable
    - `lead_exists` boolean, nullable
    - `outcome` string, nullable
    - `intake_client_name` string, nullable
    - `docusign_envelope_status` string, nullable
    - `docusign_sender_view_url` string, nullable
    - `intake_docusign_status` string, nullable
    - `intake_docusign_error` string, nullable
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required
  - `total_pages` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)