---
title: "List ratings for a conversation"
method: GET
path: "/beta/conversations/{conversationId}/ratings"
tags: ["Conversations", "Ratings"]
---

# List ratings for a conversation

`GET /beta/conversations/{conversationId}/ratings`

Lists latest ratings statuses for a particular conversation by providing the conversation ID. For surveys with multiple questions, rating status will be reported for each individual question of the survey. For example, a response for a 3 question survey that was answered will be 3 elements with status "Rated". Additionally, a multiple question survey can be partially answered, therefore a response of such case will be a mix of "Offered" and "Rated" statuses. Note that the IDs of multiple questions response elements will be the same, because they are part of the same survey.

## Path parameters

- `conversationId` integer, required

## Response `200`

List of ratings for a conversation

- ListConversationRatingsOutput
  - `data` ConversationRating[]
    - `id` string, required
    - `ratingScore` integer
    - `ratingType` string, required — values: [Csat, Nps, ThumbsUpOrDown]
    - `ratingComment` string
    - `conversationChannel` string, required — values: [WhatsApp, Voicemail, WidgetChat, FacebookMessenger, Twitter, Email, ContactForm, Callback, PstnPhone, Sms, Messenger]
    - `agentId` string
    - `userId` string, required
    - `ratingStatus` string, required — values: [Unscheduled, Offered, Rated, Scheduled, Cancelled]
    - `language` string
    - `timestamps` MapString, required

## Other responses

- `400` — Invalid value for: path parameter conversationId, Invalid value extracted from request context
- `404` — An entity in this request could not be found
- `500` — Internal failure during request processing

---

[API](https://skmtc.net/dixa/apis/dixa-api.md) · [All operations](https://skmtc.net/dixa/apis/dixa-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dixa/dixa-api/versions/041e058483f0/schema)