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

# Get Recent Calls

`GET /dashboard/recent-calls`

Get recent calls for the customer.

By default, test calls are excluded. Set include_test_calls=true to include them.

## Query parameters

- `include_test_calls` boolean

## Response `200`

Successful Response

- RecentCallsResponse — Recent 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

## 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)