> ## 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.

# Get posted filing rules

> Posted timely-filing windows, labeled by product line and state.

Community Plan manuals are per USPS state. If you omit ``state``, the
catalog sets ``state_required=true`` and ``posted_states``. Commercial
participating rows use ``window_kind=deferred_to_agreement`` when the
Administrative Guide names the Participation Agreement — ``standard_days``
null is that posted rule, not a missing extract. YAML seed is not served.



## OpenAPI

````yaml /docs/openapi.client.json get /v1/payers/{slug}/filing-rules
openapi: 3.1.0
info:
  description: >-
    Client API for RCIntel. Authenticate with X-API-Key. 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: >-
      Cited payer policy lookup — GET /v1/policies and GET /v1/policies/changes.
      Medicare FFS returns NCDs/LCDs/MACs; commercial payers return that payer's
      documents only. Query payer, code, state, plan_type.
    name: policies
  - description: >-
      Payer-policy PDF parse and retrieve for Workspace / Payer Knowledge.
      Service-authenticated (X-Admin-Secret); chunks stored in Postgres.
    name: policy
  - description: >-
      Manufacturer 340B contract-pharmacy policy, fail-closed access, and the
      change feed. Different API from GET /v1/policies.
    name: 340B Policy
  - description: CRD-style prior authorization check, documentation, and vendors.
    name: prior-auth
  - description: Public payer directory (no API key on list/detail).
    name: payers-public
  - 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. Medicare
      edits under /ncci/*, the separate CMS Medicaid edit set under
      /ncci/medicaid/*.
    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
  - name: encounter
  - name: mcp
  - description: Health checks, service metadata, and Prometheus metrics.
    name: system
paths:
  /v1/payers/{slug}/filing-rules:
    get:
      tags:
        - payers
      summary: Get posted filing rules
      description: >-
        Posted timely-filing windows, labeled by product line and state.


        Community Plan manuals are per USPS state. If you omit ``state``, the

        catalog sets ``state_required=true`` and ``posted_states``. Commercial

        participating rows use ``window_kind=deferred_to_agreement`` when the

        Administrative Guide names the Participation Agreement —
        ``standard_days``

        null is that posted rule, not a missing extract. YAML seed is not
        served.
      operationId: get_filing_rules_v1_payers__slug__filing_rules_get
      parameters:
        - description: Normalized payer slug identifier.
          in: path
          name: slug
          required: true
          schema:
            title: Slug
            type: string
        - description: >-
            Product line: commercial, medicaid (Community Plan),
            medicare_advantage, exchange, medicare_ffs.
          in: query
          name: plan_type
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Product line: commercial, medicaid (Community Plan),
              medicare_advantage, exchange, medicare_ffs.
            title: Plan Type
        - description: >-
            USPS state for Community Plan. Omit to list every posted state; each
            rule still has geo_scope and state. Do not treat the list as one
            national Medicaid calendar.
          in: query
          name: state
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              USPS state for Community Plan. Omit to list every posted state;
              each rule still has geo_scope and state. Do not treat the list as
              one national Medicaid calendar.
            title: State
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostedFilingRulesResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - APIKeyHeader: []
components:
  schemas:
    PostedFilingRulesResponse:
      description: Posted filing catalog. Not a single national number.
      properties:
        notice_text:
          anyOf:
            - type: string
            - type: 'null'
          description: Catalog-level notice when state was omitted.
          title: Notice Text
        payer_slug:
          title: Payer Slug
          type: string
        plan_type_filter:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            plan_type query you passed (commercial, medicaid,
            medicare_advantage, exchange).
          title: Plan Type Filter
        posted_states:
          description: USPS states with a posted Community Plan row in rules.
          items:
            type: string
          title: Posted States
          type: array
        rules:
          items:
            $ref: '#/components/schemas/FilingRuleResponse'
          title: Rules
          type: array
        state_filter:
          anyOf:
            - type: string
            - type: 'null'
          description: USPS state you passed. Null means the catalog is unfiltered.
          title: State Filter
        state_required:
          description: >-
            True when Community Plan rows are in this catalog and you did not
            pass state. Do not use any one Medicaid row as the payer's national
            calendar.
          title: State Required
          type: boolean
      required:
        - payer_slug
        - state_required
      title: PostedFilingRulesResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    FilingRuleResponse:
      properties:
        audience:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Posted audience: participating, nonparticipating, delegated_*,
            empire_plan.
          title: Audience
        citation:
          anyOf:
            - type: string
            - type: 'null'
          title: Citation
        claim_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Claim Type
        clock_start:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Posted clock: agreement, date_of_service, original_eob_pra,
            calendar_year_end, remittance_notification, etc.
          title: Clock Start
        effective_date:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Effective Date
        expiration_date:
          anyOf:
            - format: date-time
              type: string
            - type: 'null'
          title: Expiration Date
        geo_scope:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            national = commercial/Exchange/MA/CMS guide. state = Community Plan
            manual.
          title: Geo Scope
        notice_text:
          anyOf:
            - type: string
            - type: 'null'
          description: Posted source language
          title: Notice Text
        plan_override_days:
          additionalProperties:
            type: integer
          title: Plan Override Days
          type: object
        product_line:
          anyOf:
            - type: string
            - type: 'null'
          title: Product Line
        scope_label:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Human label, e.g. 'Community Plan — AZ' or 'Commercial participating
            (national guide)'.
          title: Scope Label
        source_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Source Url
        standard_days:
          anyOf:
            - type: integer
            - type: 'null'
          description: >-
            Posted calendar-day window when the source publishes a number. Null
            with window_kind=deferred_to_agreement means the document refers you
            to the Participation Agreement — that is the posted rule, not a
            missing extract.
          title: Standard Days
        state:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            USPS state for a Community Plan manual row. Null when geo_scope is
            national — that is not a missing state, it is not a state manual.
          title: State
        state_override_days:
          additionalProperties:
            type: integer
          title: State Override Days
          type: object
        window_kind:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            posted_calendar_days | deferred_to_agreement |
            state_required_to_select | not_posted. Read this before
            standard_days.
          title: Window Kind
        window_label:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Human reading of window_kind. Agreement deferral is not missing
            data.
          title: Window Label
      title: FilingRuleResponse
      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

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.