---
title: "GET /api/aiphonecall/v1/results"
method: GET
path: "/api/aiphonecall/v1/results"
---

# GET /api/aiphonecall/v1/results

`GET /api/aiphonecall/v1/results`

Retrieve the outcomes of AI phone calls placed through the Cair platform. Returns only completed or failed calls — calls still in progress are excluded. Results are scoped to your organization based on your authentication token.

## Query parameters

- `dateFrom` string, date
- `dateTo` string, date
- `type` 'vob' | 'custom_vob_aba' | 'podiatry_vob' | 'vob_rpm' | 'denial' | 'claim_status_inquiry' | 'claim_status_wc' | 'claim_status_auto_pip' | 'custom_claim_status' | 'prior_auth' | 'prior_auth_cpt' | 'prior_auth_status_nds' | 'prior_auth_status_cpt' | 'credentialing' | 'credentialing_im' | 'appeal' — vob = Verification of Benefits, custom_vob_aba = Custom VOB for ABA, podiatry_vob = Podiatry VOB, vob_rpm = VOB for Remote Patient Monitoring, denial = Denied Claim Follow-up, claim_status_inquiry = General Claim Status, claim_status_wc = Workers' Comp Claim Status, claim_status_auto_pip = Auto/PIP Claim Status, custom_claim_status = Custom Claim Status, prior_auth = Prior Auth (Drug-based), prior_auth_cpt = Prior Auth (CPT-based), prior_auth_status_nds = Prior Auth Status (NDS), prior_auth_status_cpt = Prior Auth Status (CPT), credentialing = Credentialing Inquiry, credentialing_im = Credentialing - IM, appeal = Appeal Call
- `status` 'completed' | 'failed'
- `source` 'platform' | 'api' — platform = from the Cair UI, api = via the API
- `batchId` string
- `callId` string
- `phoneNumber` string
- `claimControlNumber` string
- `page` integer
- `pageSize` integer
- `sortOrder` 'desc' | 'asc' — desc = newest first, asc = oldest first

## Response `200`

Call results retrieved successfully

- CallResultsResponse — Paginated response containing call result records
  - `records` CallResultRecord[], required — Array of call result objects
    - `callId` string, required — Unique identifier for the call
    - `type` string, required — The call type (e.g. vob, denial, claim_status_inquiry)
    - `status` 'completed' | 'failed', required — The call outcome
    - `phoneNumber` string, required — The phone number that was called
    - `dateCreated` string, date-time, required — ISO 8601 timestamp of when the call was initiated
    - `dateCompleted` string, date-time, required — ISO 8601 timestamp of when the call finished (succeeded or failed)
    - `results` object — Call results as a JSON object containing question-answer pairs from the AI conversation. Only present when status is completed.
    - `formattedResults` string — A human-readable formatted version of the call results. Only present when status is completed.
    - `error` string — A description of why the call failed. Only present when status is failed.
    - `errorDetails` CallResultErrorDetails — Additional structured details about a failed call. Only present when status is failed.
      - `originalError` string — The original error message
      - `internalTag` string — Internal tag for the failed call
      - `internalId` string — Internal identifier for the failed call
      - `timestamp` string, date-time — Timestamp of the failure
  - `pagination` CallResultPagination, required — Pagination metadata for call results
    - `totalRecords` integer, required — Total number of records matching your filters
    - `totalPages` integer, required — Total number of pages available
    - `currentPage` integer, required — The current page number
    - `pageSize` integer, required — The number of records per page

## Other responses

- `400` — Invalid query parameters (e.g. malformed date, unsupported call type, page size exceeding 200)
- `401` — Bearer token is missing, invalid, or expired
- `500` — Unexpected server-side error

---

[API](https://skmtc.net/cairhealth/apis/cair-health-apis.md) · [All operations](https://skmtc.net/cairhealth/apis/cair-health-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cairhealth/cair-health-apis/revisions/dfc60069747b/schema)