---
title: "POST /api/aiphonecall/v1"
method: POST
path: "/api/aiphonecall/v1"
---

# POST /api/aiphonecall/v1

`POST /api/aiphonecall/v1`

## Request

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

Triggers an automated phone call for verification of benefits (VOB) or denial follow-ups

## Headers

- `x-organization-id` string, required

## Request body

- object
  - `callType` 'vob' | 'denial', required: Type of call to make
  - `orgId` string, required: Organization ID
  - `callParameters` union, required
    - VOBCallParameters
      - `billingProviderNpi` string, required: Billing provider NPI (10 digits)
      - `billingProviderTaxId` string, required: Billing provider tax ID
      - `isPrimaryPolicy` 'yes' | 'no', required: Whether this is the primary policy
      - `memberId` string, required: Member ID
      - `patientDateOfBirth` string, date, required: Patient date of birth (YYYY-MM-DD)
      - `patientFirstName` string, required: Patient first name
      - `patientLastName` string, required: Patient last name
      - `patientRelationshipToMember` 'child' | 'spouse' | 'self', required: Patient's relationship to the member
      - `payerName` string, required: Name of the payer
      - `phoneNumber` string, required: Phone number to call
      - `renderingProviderName` string, required: Name of the rendering provider
      - `cptCode1` string, required: CPT code to verify
      - `dateOfService` string, date: Optional date of service for the VOB (YYYY-MM-DD) when the script accepts this input
      - `webhookUrl` string, uri: Optional webhook URL for call status updates
    - DenialCallParameters
      - `beginningDateOfService` string, date, required: Beginning date of service (YYYY-MM-DD)
      - `billingProviderAddress` string, required: Billing provider address
      - `billingProviderName` string, required: Billing provider name
      - `billingProviderTaxId` string, required: Billing provider tax ID
      - `claimChargeAmount` string, required: Claim charge amount
      - `claimSubmittedDate` string, date, required: Claim submitted date (YYYY-MM-DD)
      - `memberId` string, required: Member ID
      - `patientDateOfBirth` string, date, required: Patient date of birth (YYYY-MM-DD)
      - `patientFirstName` string, required: Patient first name
      - `patientLastName` string, required: Patient last name
      - `payerName` string, required: Name of the payer
      - `phoneNumber` string, required: Phone number to call
      - `renderingProviderName` string, required: Name of the rendering provider
      - `renderingProviderNpi` string, required: Rendering provider NPI (10 digits)
      - `webhookUrl` string, uri: Optional webhook URL for call status updates

## Response `200`

Call triggered successfully

- object
  - `success` boolean
  - `callId` string: Unique identifier for the call

## Other responses

- `400`: Invalid request body
- `401`: Unauthorized access or invalid organization ID

## Changes

- **2026-11-03** `b32380ccde9a`: 2 info
  - added the optional property `error` to the response with the `400` status
  - added the optional property `error` to the response with the `401` status

[Operation history](https://skmtc.dev/cairhealth/apis/cair-health-apis/changes/api/aiphonecall/v1/post.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)