---
title: "Get service review rating by channel ID"
method: GET
path: "/channels/{channelId}/service-reviews/aggregate-rating"
tags: ["Endpoints"]
---

# Get service review rating by channel ID

`GET /channels/{channelId}/service-reviews/aggregate-rating`

This endpoint retrieves aggregate ratings for service reviews by channel ID.

The response will contain aggregates for five periods of time: the last seven, 30, 90 days, the last year, and overall.
If the overall period of collecting reviews is shorter than one or several of the fix periods, the aggregates will still be calculated and returned.

For example, if a channel only collects service reviews for 14 days, the result will still contain the aggregates for 30, 90 and 365 days, but they will be the same, except for the `start` property.

>  **NB:** Please use the **"365 days"** rating response object if you intend to display your ratings publicly.
>  Also, only verified reviews are considered, meaning  unverified reviews such as imported ones are excluded.

## Path parameters

- `channelId` string, required

## Response `200`

The retrieved aggregate ratings.**NB:** Please use the "360days" rating when displaying your score publicly.

- AggregateRatingResponse — The average rating based on multiple service review ratings, each within the specified duration.
  - `7days` AggregateRating, required — The average rating based on multiple reviews over a set period. **NB:** Please refrain from displaying the "overall" score publicly. It may not accurately reflect the channel's current rating since it includes reviews from its inception.
    - `count` integer, required — The total number of service reviews in this aggregation.
    - `rating` number, double, required — The average rating of the service reviews in the aggregation period, i.e. the sum of all their ratings divided by `count` and rounded to two digits after the decimal point.
    - `distribution` AggregateRatingDistribution, required — The rating distribution per star.
      - `oneStar` integer, required — The number of service reviews with a one star rating in the specified duration.
      - `twoStars` integer, required — The number of service reviews with a two star rating in the specified duration.
      - `threeStars` integer, required — The number of service reviews with a three star rating in the specified duration.
      - `fourStars` integer, required — The number of service reviews with a four star rating in the specified duration.
      - `fiveStars` integer, required — The number of service reviews with a five star rating in the specified duration.
    - `period` AggregateRatingPeriod, required — The aggregation period for this aggregate rating object.
      - `start` string, date-time, required — The start date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `end` string, date-time, required — The end date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `firstConsideredReviewSubmission` string, date-time, required — The date and time when the first review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `lastConsideredReviewSubmission` string, date-time, required — The date and time when the last review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `calculatedAt` string, date-time — The date and time when the aggregate rating was calculated, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `ratingTrend` 'NEGATIVE' | 'NEUTRAL' | 'POSITIVE' — The rating trend for the aggregation period, compared to the overall average rating. When calculating the trend, there is a five percent tolerance per grade, i.e. `5 * 0.05` tolerance. Note that the `overall` period does not contain a `ratingTrend` as a comparison with itself would be meaningless.
  - `30days` AggregateRating, required — The average rating based on multiple reviews over a set period. **NB:** Please refrain from displaying the "overall" score publicly. It may not accurately reflect the channel's current rating since it includes reviews from its inception.
    - `count` integer, required — The total number of service reviews in this aggregation.
    - `rating` number, double, required — The average rating of the service reviews in the aggregation period, i.e. the sum of all their ratings divided by `count` and rounded to two digits after the decimal point.
    - `distribution` AggregateRatingDistribution, required — The rating distribution per star.
      - `oneStar` integer, required — The number of service reviews with a one star rating in the specified duration.
      - `twoStars` integer, required — The number of service reviews with a two star rating in the specified duration.
      - `threeStars` integer, required — The number of service reviews with a three star rating in the specified duration.
      - `fourStars` integer, required — The number of service reviews with a four star rating in the specified duration.
      - `fiveStars` integer, required — The number of service reviews with a five star rating in the specified duration.
    - `period` AggregateRatingPeriod, required — The aggregation period for this aggregate rating object.
      - `start` string, date-time, required — The start date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `end` string, date-time, required — The end date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `firstConsideredReviewSubmission` string, date-time, required — The date and time when the first review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `lastConsideredReviewSubmission` string, date-time, required — The date and time when the last review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `calculatedAt` string, date-time — The date and time when the aggregate rating was calculated, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `ratingTrend` 'NEGATIVE' | 'NEUTRAL' | 'POSITIVE' — The rating trend for the aggregation period, compared to the overall average rating. When calculating the trend, there is a five percent tolerance per grade, i.e. `5 * 0.05` tolerance. Note that the `overall` period does not contain a `ratingTrend` as a comparison with itself would be meaningless.
  - `90days` AggregateRating, required — The average rating based on multiple reviews over a set period. **NB:** Please refrain from displaying the "overall" score publicly. It may not accurately reflect the channel's current rating since it includes reviews from its inception.
    - `count` integer, required — The total number of service reviews in this aggregation.
    - `rating` number, double, required — The average rating of the service reviews in the aggregation period, i.e. the sum of all their ratings divided by `count` and rounded to two digits after the decimal point.
    - `distribution` AggregateRatingDistribution, required — The rating distribution per star.
      - `oneStar` integer, required — The number of service reviews with a one star rating in the specified duration.
      - `twoStars` integer, required — The number of service reviews with a two star rating in the specified duration.
      - `threeStars` integer, required — The number of service reviews with a three star rating in the specified duration.
      - `fourStars` integer, required — The number of service reviews with a four star rating in the specified duration.
      - `fiveStars` integer, required — The number of service reviews with a five star rating in the specified duration.
    - `period` AggregateRatingPeriod, required — The aggregation period for this aggregate rating object.
      - `start` string, date-time, required — The start date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `end` string, date-time, required — The end date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `firstConsideredReviewSubmission` string, date-time, required — The date and time when the first review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `lastConsideredReviewSubmission` string, date-time, required — The date and time when the last review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `calculatedAt` string, date-time — The date and time when the aggregate rating was calculated, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `ratingTrend` 'NEGATIVE' | 'NEUTRAL' | 'POSITIVE' — The rating trend for the aggregation period, compared to the overall average rating. When calculating the trend, there is a five percent tolerance per grade, i.e. `5 * 0.05` tolerance. Note that the `overall` period does not contain a `ratingTrend` as a comparison with itself would be meaningless.
  - `365days` AggregateRating, required — The average rating based on multiple reviews over a set period. **NB:** Please refrain from displaying the "overall" score publicly. It may not accurately reflect the channel's current rating since it includes reviews from its inception.
    - `count` integer, required — The total number of service reviews in this aggregation.
    - `rating` number, double, required — The average rating of the service reviews in the aggregation period, i.e. the sum of all their ratings divided by `count` and rounded to two digits after the decimal point.
    - `distribution` AggregateRatingDistribution, required — The rating distribution per star.
      - `oneStar` integer, required — The number of service reviews with a one star rating in the specified duration.
      - `twoStars` integer, required — The number of service reviews with a two star rating in the specified duration.
      - `threeStars` integer, required — The number of service reviews with a three star rating in the specified duration.
      - `fourStars` integer, required — The number of service reviews with a four star rating in the specified duration.
      - `fiveStars` integer, required — The number of service reviews with a five star rating in the specified duration.
    - `period` AggregateRatingPeriod, required — The aggregation period for this aggregate rating object.
      - `start` string, date-time, required — The start date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `end` string, date-time, required — The end date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `firstConsideredReviewSubmission` string, date-time, required — The date and time when the first review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `lastConsideredReviewSubmission` string, date-time, required — The date and time when the last review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `calculatedAt` string, date-time — The date and time when the aggregate rating was calculated, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `ratingTrend` 'NEGATIVE' | 'NEUTRAL' | 'POSITIVE' — The rating trend for the aggregation period, compared to the overall average rating. When calculating the trend, there is a five percent tolerance per grade, i.e. `5 * 0.05` tolerance. Note that the `overall` period does not contain a `ratingTrend` as a comparison with itself would be meaningless.
  - `overall` AggregateRating, required — The average rating based on multiple reviews over a set period. **NB:** Please refrain from displaying the "overall" score publicly. It may not accurately reflect the channel's current rating since it includes reviews from its inception.
    - `count` integer, required — The total number of service reviews in this aggregation.
    - `rating` number, double, required — The average rating of the service reviews in the aggregation period, i.e. the sum of all their ratings divided by `count` and rounded to two digits after the decimal point.
    - `distribution` AggregateRatingDistribution, required — The rating distribution per star.
      - `oneStar` integer, required — The number of service reviews with a one star rating in the specified duration.
      - `twoStars` integer, required — The number of service reviews with a two star rating in the specified duration.
      - `threeStars` integer, required — The number of service reviews with a three star rating in the specified duration.
      - `fourStars` integer, required — The number of service reviews with a four star rating in the specified duration.
      - `fiveStars` integer, required — The number of service reviews with a five star rating in the specified duration.
    - `period` AggregateRatingPeriod, required — The aggregation period for this aggregate rating object.
      - `start` string, date-time, required — The start date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `end` string, date-time, required — The end date and time of the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `firstConsideredReviewSubmission` string, date-time, required — The date and time when the first review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `lastConsideredReviewSubmission` string, date-time, required — The date and time when the last review was collected during the aggregation period, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `calculatedAt` string, date-time — The date and time when the aggregate rating was calculated, in the ISO 8601 and RFC3339 compliant format `yyyy-MM-dd'T'HH:mm:ss.SSSZ`.
      - `ratingTrend` 'NEGATIVE' | 'NEUTRAL' | 'POSITIVE' — The rating trend for the aggregation period, compared to the overall average rating. When calculating the trend, there is a five percent tolerance per grade, i.e. `5 * 0.05` tolerance. Note that the `overall` period does not contain a `ratingTrend` as a comparison with itself would be meaningless.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found

---

[API](https://skmtc.net/etrusted/apis/accounts-api.md) · [All operations](https://skmtc.net/etrusted/apis/accounts-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/etrusted/accounts-api/revisions/649ef7dac98c/schema)