---
title: "Client Data Rating Distribution"
method: POST
path: "/api/analytics/contributor/rating-distribution"
tags: ["Contributor Data"]
---

# Client Data Rating Distribution

`POST /api/analytics/contributor/rating-distribution`

## Request

- Base URL: `https://api.creditbenchmark.com`
- URL: `https://api.creditbenchmark.com/api/analytics/contributor/rating-distribution`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/creditbenchmark/apis/credit-benchmark-api/docs/api/analytics/contributor/rating-distribution/post.ts> (a function with typed inputs; its response is checked against the schema)

Return client rating distribution data.

## Request body

- RequestEnvelopeClientDataDistributionRequest
  - `Parameters` ClientDataDistributionRequest, required
    - `portfolio` Portfolio, required
      - `name` string, required
      - `entities` FlexibleCBPortfolio, required
        - `CBId` string[]
    - `EffectiveDateId` integer
    - `effectivedateid_min` integer
    - `effectivedateid_min_lag_months` integer
    - `use_client_scale` boolean
    - `use_cb7_scale` boolean
    - `facet_column` string: Column to group by (e.g., Sector, Region, Industry)

## Response `200`

Client data rating distribution retrieved successfully

- RatingDistributionResponse: Response containing rating distribution with percentage of entities in each rating band
  - `EffectiveDateId` integer[], required: Effective date identifiers
  - `aaa` number[], required: Percentage of entities rated AAA
  - `aa+` number[], required: Percentage of entities rated AA+
  - `aa` number[], required: Percentage of entities rated AA
  - `aa-` number[], required: Percentage of entities rated AA-
  - `a+` number[], required: Percentage of entities rated A+
  - `a` number[], required: Percentage of entities rated A
  - `a-` number[], required: Percentage of entities rated A-
  - `bbb+` number[], required: Percentage of entities rated BBB+
  - `bbb` number[], required: Percentage of entities rated BBB
  - `bbb-` number[], required: Percentage of entities rated BBB-
  - `bb+` number[], required: Percentage of entities rated BB+
  - `bb` number[], required: Percentage of entities rated BB
  - `bb-` number[], required: Percentage of entities rated BB-
  - `b+` number[], required: Percentage of entities rated B+
  - `b` number[], required: Percentage of entities rated B
  - `b-` number[], required: Percentage of entities rated B-
  - `ccc+` number[], required: Percentage of entities rated CCC+
  - `ccc` number[], required: Percentage of entities rated CCC
  - `ccc-` number[], required: Percentage of entities rated CCC-
  - `cc` number[], required: Percentage of entities rated CC
  - `c` number[], required: Percentage of entities rated C

## Other responses

- `400`: Bad request - invalid parameters
- `401`: Unauthorized - invalid or missing JWT token
- `403`: Forbidden - insufficient permissions or access denied
- `422`: Validation error - request parameters are invalid
- `500`: Internal server error

---

[API](https://skmtc.dev/creditbenchmark/apis/credit-benchmark-api.md) - [All operations](https://skmtc.dev/creditbenchmark/apis/credit-benchmark-api/llms.txt) - [OpenAPI document](https://skmtc.dev/creditbenchmark/apis/credit-benchmark-api/revisions/b357bbdb41e6?raw)