> ## 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. # Calculate appeal deadlines > Calculate appeal deadlines for each appeal level given a denial date. Returns computed deadline dates, days remaining, and expiration status for every appeal level the payer supports (e.g., first-level, second-level, external review). Mirrors the filing-deadline calculator pattern. ## OpenAPI ````yaml /docs/openapi.client.json get /v1/payers/{slug}/appeal-deadline 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/payers/{slug}/appeal-deadline: get: tags: - payers summary: Calculate appeal deadlines description: >- Calculate appeal deadlines for each appeal level given a denial date. Returns computed deadline dates, days remaining, and expiration status for every appeal level the payer supports (e.g., first-level, second-level, external review). Mirrors the filing-deadline calculator pattern. operationId: get_appeal_deadline_v1_payers__slug__appeal_deadline_get parameters: - description: Normalized payer slug identifier. in: path name: slug required: true schema: title: Slug type: string - description: Denial date (YYYY-MM-DD) in: query name: denial_date required: true schema: description: Denial date (YYYY-MM-DD) title: Denial Date type: string - description: State code for state-specific override rules in: query name: state required: false schema: anyOf: - type: string - type: 'null' description: State code for state-specific override rules title: State responses: '200': content: application/json: schema: $ref: '#/components/schemas/AppealDeadlineResponse' description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - APIKeyHeader: [] components: schemas: AppealDeadlineResponse: description: Appeal deadline calculation for a payer given a denial date. properties: appeal_levels: items: $ref: '#/components/schemas/AppealLevelDeadline' title: Appeal Levels type: array denial_date: title: Denial Date type: string payer_name: title: Payer Name type: string payer_slug: title: Payer Slug type: string required: - payer_slug - payer_name - denial_date title: AppealDeadlineResponse type: object HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' title: Detail type: array title: HTTPValidationError type: object AppealLevelDeadline: description: Computed appeal deadline for a single appeal level. properties: appeal_level: title: Appeal Level type: integer days_remaining: description: Days until deadline (negative if expired) title: Days Remaining type: integer deadline_date: description: Appeal deadline date (YYYY-MM-DD) title: Deadline Date type: string deadline_days: title: Deadline Days type: integer external_review_deadline_days: anyOf: - type: integer - type: 'null' title: External Review Deadline Days is_expired: title: Is Expired type: boolean level_name: anyOf: - type: string - type: 'null' title: Level Name peer_to_peer_available: default: false title: Peer To Peer Available type: boolean required_documents: items: type: string title: Required Documents type: array submission_method: anyOf: - type: string - type: 'null' title: Submission Method success_rate: anyOf: - type: number - type: 'null' title: Success Rate required: - appeal_level - deadline_days - deadline_date - days_remaining - is_expired title: AppealLevelDeadline 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 ````