> ## Documentation Index > Fetch the complete documentation index at: https://docs.rcintell.com/llms.txt > Use this file to discover all available pages before exploring further. # Submit denial resolution query > Submit a denial resolution query to the AI agent. Analyzes CARC/RARC denial codes and recommends corrective actions: appeal strategies, documentation requirements, resubmission guidance, or payer contact. ## OpenAPI ````yaml /docs/openapi.client.json post /v1/agents/denial-resolution openapi: 3.1.0 info: description: >- Client API for RCIntel. Admin ingest, catalog sync, and internal audit routes are omitted. See Guides → Which API to use. summary: Multi-tenant knowledge API for healthcare revenue cycle management. title: Healthcare Knowledge Layer version: 0.1.0 servers: [] security: [] tags: - description: >- Geographic payer policy lookup (national NCD vs MAC LCD vs state). Query payer, code, state, plan_type. Each row includes geo_scope and document_version. name: policies - description: >- Payer network directory — search payers, check prior auth requirements, view filing rules, denial patterns, and appeal levels. name: payers - description: >- Resolve healthcare billing knowledge across the L1-L6 layer stack. Includes payment calculation, billing guidance, and per-layer queries. name: knowledge - description: >- CMS Fee Schedule lookups — OPPS (Addendum B / APC), DMEPOS (state-level pricing), and Clinical Lab Fee Schedule (CLFS). name: fee-schedules - description: >- NCCI (National Correct Coding Initiative) — dedicated MUE limits, PTP bundling edits, add-on code edits, and code pair validation. name: ncci - description: >- Service code intelligence — CPT/HCPCS lookup, RVU data, NCCI edits, payment calculation, implant/GUDID search, and service group classification. name: codes - description: >- Submit asynchronous AI agent jobs for code research, medical necessity, and denial resolution. Poll for results and retrieve reasoning traces. name: agents - description: >- Register and manage healthcare facilities by CCN (Medicare Provider Number). Each facility is the root entity for knowledge resolution. name: facilities - description: >- NPI Registry — live search against CMS NPPES API for provider and organization National Provider Identifiers. name: npi - description: >- OpenFDA drug product lookup by NDC. Includes product-level fields with normalized ingredient and package detail. name: drugs - description: Health checks, service metadata, and Prometheus metrics. name: system paths: /v1/agents/denial-resolution: post: tags: - agents summary: Submit denial resolution query description: >- Submit a denial resolution query to the AI agent. Analyzes CARC/RARC denial codes and recommends corrective actions: appeal strategies, documentation requirements, resubmission guidance, or payer contact. operationId: run_denial_resolution_v1_agents_denial_resolution_post requestBody: content: application/json: schema: $ref: '#/components/schemas/DenialResolutionRequest' required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/JobResponse' description: Job accepted — poll /agents/jobs/{job_id} for result '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - APIKeyHeader: [] components: schemas: DenialResolutionRequest: description: Submit a denial resolution query to the AI agent. examples: - carc: '97' claim_id: CLM-2026-001 group_code: CO query: How do I appeal a prior auth denial? rarc: N479 properties: callback_secret: anyOf: - maxLength: 128 minLength: 8 type: string - type: 'null' description: >- Shared secret for HMAC-SHA256 of the raw JSON body. We send X-RCI-Signature: sha256=. Do not send this on poll. title: Callback Secret callback_url: anyOf: - type: string - type: 'null' description: >- 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. examples: - https://yourapp.com/webhooks/rci-agent title: Callback Url carc: anyOf: - type: string - type: 'null' description: Claim Adjustment Reason Code examples: - '97' title: Carc ccn: anyOf: - type: string - type: 'null' description: Facility CCN to enrich the query with knowledge layer data examples: - '170001' title: Ccn claim_id: anyOf: - type: string - type: 'null' description: Original claim identifier title: Claim Id context: additionalProperties: true description: Additional context key-value pairs passed to the agent title: Context type: object denial_code: anyOf: - type: string - type: 'null' description: Denial reason code title: Denial Code group_code: anyOf: - type: string - type: 'null' description: Group code indicating financial responsibility (CO, PR, OA, PI) examples: - CO title: Group Code query: description: The question or task for the agent maxLength: 8000 title: Query type: string rarc: anyOf: - type: string - type: 'null' description: Remittance Advice Remark Code examples: - N479 title: Rarc required: - query title: DenialResolutionRequest type: object JobResponse: description: Returned when an agent job is accepted (202). properties: agent_type: description: 'Agent type: code_research, medical_necessity, denial_resolution' title: Agent Type type: string created_at: format: date-time title: Created At type: string job_id: description: Unique job identifier for polling format: uuid title: Job Id type: string status: description: 'Job status: pending, running, completed, failed' title: Status type: string required: - job_id - status - agent_type - created_at title: JobResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object ValidationError: properties: ctx: title: Context type: object input: title: Input loc: items: anyOf: - type: string - type: integer title: Location type: array msg: title: Message type: string type: title: Error Type type: string required: - loc - msg - type title: ValidationError type: object securitySchemes: APIKeyHeader: in: header name: X-API-Key type: apiKey ````