Skip to main content
POST
Pre-visit encounter readiness check

Authorizations

X-API-Key
string
header
required

Body

application/json

Pre-visit encounter readiness check — bundles PA, NCCI, payment, and billing.

cpt_codes
string[]
required

CPT/HCPCS codes planned for the encounter

Required array length: 1 - 25 elements
payer_slug
string
required

Payer slug or alias

ccn
string | null

Facility CCN (enables GPCI + billing guide)

date_of_service
string | null

Planned date of service (YYYY-MM-DD)

locality
string | null

GPCI locality code for payment estimates

place_of_service
string | null

Place of service code (e.g. 11=office)

plan_type
string | null

Plan type: commercial, medicaid, hmo, etc.

service_category
string | null

Service category for PA fallback

state
string | null

State abbreviation for state-specific rules

visit_count
integer | null

Current visit count for threshold checks

Response

Successful Response

Complete encounter readiness assessment.

codes
string[]
required
encounter_ready
boolean
required

True when no critical blockers found

payer_slug
string
required
ccn
string | null
date_of_service
string | null
ncci_clean
boolean
default:true
ncci_conflicts
NCCIBatchConflict · object[]
pa_required_count
integer
default:0
pa_results
EncounterPAResult · object[]
payer_name
string | null
payment_estimates
EncounterPaymentEstimate · object[]
total_estimated_payment
number
default:0
warnings
EncounterWarning · object[]