> ## 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. # List code groups (service_group, BETOS, or RBCS taxonomy) > List code groups for a given taxonomy. The platform supports three orthogonal groupings: - ``service_group`` (default, legacy) — coarse CPT-range groupings such as "E/M", "Surgical", "Radiology". One row per ``ServiceGroup``. - ``betos`` — CMS BETOS-1 taxonomy (~190 leaves). Use this for utilization analytics and benchmarking against published CMS reports. - ``rbcs`` — CMS Restructured BETOS Classification System (2021+). Richer 4-level hierarchy that supersedes BETOS-1 in newer CMS publications. For ``betos`` / ``rbcs`` the ``code_count`` field tells you how many HCPCS/CPT codes in this platform's catalog are currently assigned to each leaf group. ## OpenAPI ````yaml /docs/openapi.client.json get /v1/codes/groups 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/codes/groups: get: tags: - codes summary: List code groups (service_group, BETOS, or RBCS taxonomy) description: >- List code groups for a given taxonomy. The platform supports three orthogonal groupings: - ``service_group`` (default, legacy) — coarse CPT-range groupings such as "E/M", "Surgical", "Radiology". One row per ``ServiceGroup``. - ``betos`` — CMS BETOS-1 taxonomy (~190 leaves). Use this for utilization analytics and benchmarking against published CMS reports. - ``rbcs`` — CMS Restructured BETOS Classification System (2021+). Richer 4-level hierarchy that supersedes BETOS-1 in newer CMS publications. For ``betos`` / ``rbcs`` the ``code_count`` field tells you how many HCPCS/CPT codes in this platform's catalog are currently assigned to each leaf group. operationId: list_service_groups_v1_codes_groups_get parameters: - description: >- Which taxonomy to list: service_group (CPT range groupings), betos (BETOS-1), or rbcs (Restructured BETOS). in: query name: taxonomy required: false schema: default: service_group description: >- Which taxonomy to list: service_group (CPT range groupings), betos (BETOS-1), or rbcs (Restructured BETOS). pattern: ^(service_group|betos|rbcs)$ title: Taxonomy type: string - description: >- For betos/rbcs, return leaf nodes only (groups that codes are assigned to). Ignored for service_group. in: query name: leaves_only required: false schema: default: true description: >- For betos/rbcs, return leaf nodes only (groups that codes are assigned to). Ignored for service_group. title: Leaves Only type: boolean - description: Taxonomy year. Defaults to the most recent year on file. in: query name: year required: false schema: anyOf: - type: integer - type: 'null' description: Taxonomy year. Defaults to the most recent year on file. title: Year - description: >- Filter by taxonomy category (e.g. 'imaging', 'procedures'). Only used for betos/rbcs. in: query name: category required: false schema: anyOf: - type: string - type: 'null' description: >- Filter by taxonomy category (e.g. 'imaging', 'procedures'). Only used for betos/rbcs. title: Category responses: '200': content: application/json: schema: anyOf: - items: $ref: '#/components/schemas/ServiceGroupResponse' type: array - items: $ref: '#/components/schemas/TaxonomyGroupResponse' type: array title: Response List Service Groups V1 Codes Groups Get description: Successful Response '422': content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' description: Validation Error security: - APIKeyHeader: [] components: schemas: ServiceGroupResponse: properties: billing_specialty: anyOf: - type: string - type: 'null' title: Billing Specialty cpt_range: anyOf: - type: string - type: 'null' title: Cpt Range description: anyOf: - type: string - type: 'null' title: Description documentation_requirements: anyOf: - type: string - type: 'null' title: Documentation Requirements key_modifiers: items: type: string title: Key Modifiers type: array name: title: Name type: string requires_modifier: default: false title: Requires Modifier type: boolean slug: title: Slug type: string required: - slug - name title: ServiceGroupResponse type: object TaxonomyGroupResponse: description: |- Single node in a BETOS / RBCS taxonomy. Returned by ``GET /v1/codes/groups?taxonomy=betos|rbcs``. ``code_count`` is the number of HCPCS/CPT codes currently assigned to this leaf. properties: category: anyOf: - type: string - type: 'null' title: Category code: description: >- Group code (e.g. 'M1A' for BETOS, 'EVAL.OFFICE.NEW' for RBCS, slug for service_group) title: Code type: string code_count: default: 0 description: Number of service codes assigned to this group title: Code Count type: integer description: anyOf: - type: string - type: 'null' title: Description is_leaf: default: true title: Is Leaf type: boolean level: anyOf: - type: integer - type: 'null' title: Level name: title: Name type: string parent_code: anyOf: - type: string - type: 'null' title: Parent Code taxonomy: enum: - service_group - betos - rbcs title: Taxonomy type: string required: - taxonomy - code - name title: TaxonomyGroupResponse 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 ````