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

# List the ratings on an answer

> Read every rating given to one message in a conversation you can read, oldest first. The list is empty when the message has not been rated.

Returns every rating on one message, oldest first. `data` is empty when nobody has rated it. Only the person who started a conversation can [rate](/api-reference/conversations/rate-message) in it, so an answer usually has one rating or none.

Who can read is the same rule as reading the conversation: you can read the ratings in a conversation you started, and a caller whose role can moderate conversations (`owner` or `admin`) can read them in any conversation in the organization. A conversation that does not exist, belongs to another organization or is hidden from you returns `404`, and so does a message that is not in it or a malformed ID.

<ParamField path="conversation_id" type="string" required>
  The conversation ID.
</ParamField>

<ParamField path="message_id" type="string" required>
  The message's `id`, from [List messages](/api-reference/conversations/list-messages).
</ParamField>

## Response

<ResponseField name="data" type="object[]" required>
  The ratings, oldest first.

  <Expandable title="properties">
    <ResponseField name="id" type="string" required>
      The rating's ID.
    </ResponseField>

    <ResponseField name="message_id" type="string" required>
      The answer that was rated.
    </ResponseField>

    <ResponseField name="conversation_id" type="string" required>
      The conversation the answer belongs to.
    </ResponseField>

    <ResponseField name="rating" type="string" required>
      `up` or `down`.
    </ResponseField>

    <ResponseField name="note" type="string | null" required>
      The note sent with the rating, or `null`.
    </ResponseField>

    <ResponseField name="actor" type="object" required>
      Who gave the rating: `type` is `user` for a console session or `service` for an API key, and
      `id` identifies that user or key.
    </ResponseField>

    <ResponseField name="created_at" type="string" required>
      When the rating was first given, ISO 8601 in UTC.
    </ResponseField>

    <ResponseField name="updated_at" type="string" required>
      When the rating was last set, ISO 8601 in UTC.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={"theme":{"light":"github-light","dark":"github-dark"}}
  curl --request GET "$MITHUNAI_URL/mithunai/api/v1/conversations/c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60/messages/7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36/feedback" \
    --header "Authorization: Bearer $MITHUNAI_API_KEY"
  ```

  ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
  import os, requests

  conversation_id = "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60"
  message_id = "7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36"
  response = requests.get(
      f"{os.environ['MITHUNAI_URL']}/mithunai/api/v1/conversations/{conversation_id}/messages/{message_id}/feedback",
      headers={"Authorization": f"Bearer {os.environ['MITHUNAI_API_KEY']}"},
      timeout=60,
  )
  response.raise_for_status()
  print(response.json())
  ```

  ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
  const conversationId = 'c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60'
  const messageId = '7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36'
  const response = await fetch(
    `${process.env.MITHUNAI_URL}/mithunai/api/v1/conversations/${conversationId}/messages/${messageId}/feedback`,
    {
      headers: { Authorization: `Bearer ${process.env.MITHUNAI_API_KEY}` },
    },
  )
  console.log(await response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  {
    "data": [
      {
        "id": "b7c2e9a4-5d18-4f63-9a0e-2c4d6f8b1e37",
        "message_id": "7c3a9e52-1b6d-4f08-a4e7-2d9b5f1c8e36",
        "conversation_id": "c41f8a2e-6d93-4b0a-b7e5-3f1d2c8a9e60",
        "rating": "down",
        "note": "This describes the old dashboard.",
        "actor": { "type": "service", "id": "2f6b8d1c-4a35-4e79-b0c2-8d7e5f3a1b94" },
        "created_at": "2026-10-12T10:02:41.118204+00:00",
        "updated_at": "2026-10-12T10:02:41.118204+00:00"
      }
    ]
  }
  ```

  ```json 404 theme={"theme":{"light":"github-light","dark":"github-dark"}}
  { "code": "not_found", "message": "The requested resource was not found." }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.