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

# POST /api/aiphonecall/v1

`POST /api/aiphonecall/v1`

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

---

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