> ## Documentation Index
> Fetch the complete documentation index at: https://docs.creditbenchmark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Rating Scales

> Returns CB rating scale metadata, including CB21 and CB7 ordering and band mappings.



## OpenAPI

````yaml /openapi/consensus-data.yaml get /analytics/v2/metadata/rating-scales
openapi: 3.1.0
info:
  title: Credit Benchmark API
  description: |
    Authentication, entity resolution, data, analytics, and metadata endpoints.
  version: 1.0.0
  contact:
    name: Credit Benchmark API Support
    email: api-support@creditbenchmark.com
    url: https://creditbenchmark.com/support
  license:
    name: Proprietary
    url: https://creditbenchmark.com/terms
servers:
  - url: https://gateway.creditbenchmark.com
    description: Production gateway
security:
  - BearerAuth: []
tags:
  - name: authentication
    description: Token generation endpoints.
    x-group: Authentication
  - name: entity-resolution
    description: Entity name resolution endpoints.
    x-group: Entity Resolution
  - name: data
    description: Raw data extraction endpoints.
    x-group: Data
  - name: analytics
    description: Analytics endpoints.
    x-group: Analytics
  - name: metadata
    description: Metadata discovery endpoints.
    x-group: Metadata
paths:
  /analytics/v2/metadata/rating-scales:
    get:
      tags:
        - metadata
      summary: Rating Scales
      description: >-
        Returns CB rating scale metadata, including CB21 and CB7 ordering and
        band mappings.
      operationId: metadata_rating_scales_v2_metadata_rating_scales_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RatingScalesMetadataResponse'
              example:
                default_scale: CB21
                supported_scales:
                  - CB21
                  - CB7
                  - CLIENT
                scales:
                  CB21:
                    ratings:
                      - CB_CCR_21_Notch: 1
                        CB_CCR: aaa
                        CB_PD_Lower_Bound: 0
                        CB_PD_Mid_Point: 0.000079057
                        CB_PD_Upper_Bound: 0.000125
                        CB_IG_HY: IG
                      - CB_CCR_21_Notch: 2
                        CB_CCR: aa+
                        CB_PD_Lower_Bound: 0.000125001
                        CB_PD_Mid_Point: 0.000167705
                        CB_PD_Upper_Bound: 0.000225
                        CB_IG_HY: IG
                  CB7:
                    ratings:
                      - CB_Rating_Group_Notch: 1
                        CB_Rating_Group: aaa
                      - CB_Rating_Group_Notch: 2
                        CB_Rating_Group: aa
                  CLIENT:
                    description: >-
                      Client-specific scales are selected per entitled client
                      request.
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/InternalServerError'
components:
  schemas:
    RatingScalesMetadataResponse:
      type: object
      description: CB rating scale metadata.
      required:
        - default_scale
        - supported_scales
        - scales
      properties:
        default_scale:
          type: string
          example: CB21
        supported_scales:
          type: array
          items:
            type: string
          example:
            - CB21
            - CB7
            - CLIENT
        scales:
          type: object
          additionalProperties:
            type: object
            additionalProperties: true
          description: >-
            Scale definitions keyed by scale name. `CB21` and `CB7` include
            ordered rating rows; `CLIENT` describes client-specific scale
            behavior.
    UnauthorizedError:
      type: object
      required:
        - detail
      properties:
        detail:
          type: string
    SimpleError:
      type: object
      required:
        - error
      properties:
        error:
          type: string
    RateLimitError:
      type: object
      required:
        - error
        - detail
      properties:
        error:
          type: string
        detail:
          type: string
  responses:
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/UnauthorizedError'
          example:
            detail: Unauthorized request
    Forbidden:
      description: Forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SimpleError'
          example:
            error: Client-backed analytics inputs require contributor entitlement.
    TooManyRequests:
      description: Too many requests
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/RateLimitError'
          example:
            error: Rate limit exceeded
            detail: 60 per 1 minute
    InternalServerError:
      description: Server error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/SimpleError'
          example:
            error: >-
              An error occurred while processing your request. Please try again
              later.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT bearer token.

````