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

# GET /api/aiphonecall/v1/results

`GET /api/aiphonecall/v1/results`

## Request

- Base URL: `https://forecaster.cairhealth.com`
- URL: `https://forecaster.cairhealth.com/api/aiphonecall/v1/results`
- Auth: HTTP bearer

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' | '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, vob_aba = VOB - ABA (CPT 97151-97158), 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

## Changes

- **2026-11-03** `b32380ccde9a`: 3 info
  - added the new enum value `vob_aba` to the `query` request parameter `type`
  - added the optional property `error` to the response with the `401` status
  - added the optional property `error` to the response with the `500` status

[Operation history](https://skmtc.dev/cairhealth/apis/cair-health-apis/changes/api/aiphonecall/v1/results/get.md)

---

[API](https://skmtc.dev/cairhealth/apis/cair-health-apis.md) - [All operations](https://skmtc.dev/cairhealth/apis/cair-health-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/cairhealth/apis/cair-health-apis/revisions/b32380ccde9a?raw)