Skip to main content
POST
Create Benefits Check
This endpoint supports idempotency keys

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

idempotency-key
string

Unique key to prevent duplicate requests. We support keys up to 255 characters.

Required string length: 1 - 255

Body

application/json

Benefits Check Create Request Schema

patient_plan_id
string<uuid>
required

Patient Plan ID

specialties
enum<string>[]
required

List of specialties to create benefits check for

Available options:
PHYSICAL_THERAPY,
ABA_THERAPY,
SPEECH_THERAPY,
OCCUPATIONAL_THERAPY,
PSYCHOLOGICAL_TESTING,
HOME_HEALTH_CARE,
HOSPICE,
CARDIAC_REHABILITATION,
INTENSIVE_CARDIAC_REHABILITATION,
MENTAL_HEALTH,
PRINCIPAL_ILLNESS_NAVIGATION,
PRINCIPAL_CARE_MANAGEMENT,
ADVANCED_PRIMARY_CARE_MODELS,
PREVENTATIVE_HEALTH,
PARTIAL_HOSPITALIZATION_PROGRAM,
INTENSIVE_OUTPATIENT_PROGRAM,
INTERVENTIONAL_RADIOLOGY,
VASCULAR_SURGERY,
INTERVENTIONAL_CARDIOLOGY,
ORTHOPEDICS,
CHIROPRACTIC,
GYNECOLOGY,
LONG_TERM_CARE,
NUTRITIONAL_COUNSELING,
PHYSICAL_MEDICINE,
PULMONARY_REHABILITATION,
INJECTABLE_SPECIALTY_MEDICATIONS,
ALLERGY_TESTING,
SKILLED_NURSING,
RADIOLOGY,
OTOLARYNGOLOGY,
DURABLE_MEDICAL_EQUIPMENT,
DERMATOLOGY,
PROFESSIONAL_OFFICE_VISIT,
PSYCHIATRY,
PRIVATE_DUTY_NURSING
Example:
template_id
string<uuid> | null

Benefits Check Template ID

diagnosis_code_ids
string<uuid>[] | null

List of diagnosis code IDs to use for this benefits check. If provided, only these diagnosis codes will be attached. If not provided, all diagnosis codes from the patient record will be used.

network_status_override
enum<string> | null

Override the network status for this benefits check. If provided, the benefits check will use this network status instead of determining it automatically.

Available options:
IN_NETWORK,
OUT_OF_NETWORK
procedure_group_ids
string<uuid>[] | null

Procedure group IDs defining the CPT codes this benefits check is verified against. Each procedure group must be configured for one of the requested specialties, and the benefits check template used for this request must allow procedure group selection. Use GET /procedure-groups to look up IDs, optionally by exact CPT codes.

Response

Benefits Check Create Response Schema

benefits_check_ids
string<uuid>[]
required

List of created benefits check IDs