> ## 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. # Add a payer to a facility's roster > Record which payers a facility contracts with (and the network status). The roster is the foundation for facility-specific prior-auth resolution: by-CCN PA checks consult this roster and any facility overrides. Idempotent on (facility, payer) — posting the same payer again updates the entry. ## OpenAPI ````yaml /docs/openapi.client.json post /v1/facilities/{ccn}/payers 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/facilities/{ccn}/payers: post: tags: - facilities summary: Add a payer to a facility's roster description: >- Record which payers a facility contracts with (and the network status). The roster is the foundation for facility-specific prior-auth resolution: by-CCN PA checks consult this roster and any facility overrides. Idempotent on (facility, payer) — posting the same payer again updates the entry. operationId: add_facility_payer_v1_facilities__ccn__payers_post parameters: - description: >- 6-digit CMS Certification Number (facility CCN / Medicare provider number). in: path name: ccn required: true schema: title: Ccn type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/FacilityPayerCreate' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/FacilityPayerResponse' description: The created/updated roster entry '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - APIKeyHeader: [] components: schemas: FacilityPayerCreate: description: Add a payer to a facility's contract roster. properties: effective_date: anyOf: - format: date-time type: string - type: 'null' description: Contract effective date title: Effective Date expiration_date: anyOf: - format: date-time type: string - type: 'null' description: Contract expiration date title: Expiration Date network_status: default: in_network description: 'Contract network status: in_network, out_of_network, or unknown.' examples: - in_network title: Network Status type: string notes: anyOf: - maxLength: 2000 type: string - type: 'null' description: Free-form notes title: Notes payer_slug: description: Payer slug or alias examples: - fidelis-care title: Payer Slug type: string plan_types: anyOf: - items: type: string type: array - type: 'null' description: >- Plan/product lines this facility participates in (e.g. ['medicaid']). title: Plan Types required: - payer_slug title: FacilityPayerCreate type: object FacilityPayerResponse: description: A payer on a facility's roster. properties: 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 id: format: uuid title: Id type: string is_active: default: true title: Is Active type: boolean network_status: title: Network Status type: string notes: anyOf: - type: string - type: 'null' title: Notes payer_name: title: Payer Name type: string payer_slug: title: Payer Slug type: string plan_types: items: type: string title: Plan Types type: array required: - id - payer_slug - payer_name - network_status title: FacilityPayerResponse 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 ````