Skip to main content
POST
Submit denial resolution query

Authorizations

X-API-Key
string
header
required

Body

application/json

Submit a denial resolution query to the AI agent.

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"

carc
string | null

Claim Adjustment Reason Code

Example:

"97"

ccn
string | null

Facility CCN to enrich the query with knowledge layer data

Example:

"170001"

claim_id
string | null

Original claim identifier

context
Context · object

Additional context key-value pairs passed to the agent

denial_code
string | null

Denial reason code

group_code
string | null

Group code indicating financial responsibility (CO, PR, OA, PI)

Example:

"CO"

rarc
string | null

Remittance Advice Remark Code

Example:

"N479"

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