Skip to main content
POST
Submit medical necessity check

Authorizations

X-API-Key
string
header
required

Body

application/json

Submit a medical necessity check to the AI agent.

cpt_code
string
required

CPT code to evaluate

Example:

"27447"

query
string
required

The question or task for the agent

Maximum string length: 8000
callback_secret
string | null

Shared secret for HMAC-SHA256 of the raw JSON body. We send X-RCI-Signature: sha256=. Do not send this on poll.

Required string length: 8 - 128
callback_url
string | null

HTTPS URL to POST when the job completes or fails. There is no POST /v1/webhooks registry — this is the only push. Pair with callback_secret so we send X-RCI-Signature.

Example:

"https://yourapp.com/webhooks/rci-agent"

ccn
string | null

Facility CCN to enrich the query with knowledge layer data

Example:

"170001"

clinical_notes
string | null

Relevant clinical notes excerpt

context
Context · object

Additional context key-value pairs passed to the agent

dx_codes
string[]

ICD-10 diagnosis codes supporting necessity

Example:

Response

Job accepted — poll /agents/jobs/{job_id} for result

Returned when an agent job is accepted (202).

agent_type
string
required

Agent type: code_research, medical_necessity, denial_resolution

created_at
string<date-time>
required
job_id
string<uuid>
required

Unique job identifier for polling

status
string
required

Job status: pending, running, completed, failed