---
title: "List Satisfaction Ratings"
method: GET
path: "/api/v2/satisfaction_ratings"
tags: ["Satisfaction Ratings"]
---

# List Satisfaction Ratings

`GET /api/v2/satisfaction_ratings`

#### Allowed For
* Admins

#### Pagination

* Cursor pagination (recommended)
* Offset pagination

See [Pagination](/api-reference/introduction/pagination/).

#### Filters

| Parameter  | Value
| ---------- | -----
| score      | offered, unoffered, received, received\_with\_comment, received\_without\_comment,<br/>good, good\_with\_comment, good\_without\_comment,<br/>bad, bad\_with\_comment, bad\_without\_comment
| start_time | Time of the oldest satisfaction rating, as a [Unix epoch time](https://www.epochconverter.com/)
| end_time   | Time of the most recent satisfaction rating, as a [Unix epoch time](https://www.epochconverter.com/)

If you specify an unqualified score such as `good`, the results include all the records with and without comments.

Examples:

* `/api/v2/satisfaction_ratings.json?score=bad`
* `/api/v2/satisfaction_ratings.json?score=bad&start_time=1498151194`
* `/api/v2/satisfaction_ratings.json?start_time=1340384793&end_time=1371920793`

## Query parameters

- `page[before]` string
- `page[after]` string
- `page[size]` integer
- `score` 'offered' | 'unoffered' | 'received' | 'received_with_comment' | 'received_without_comment' | 'good' | 'good_with_comment' | 'good_without_comment' | 'bad' | 'bad_with_comment' | 'bad_without_comment'
- `start_time` integer
- `end_time` integer

## Response `200`

Success response

- SatisfactionRatingsResponse
  - `satisfaction_ratings` SatisfactionRatingObject[]
    - `assignee_id` integer, required — The id of agent assigned to at the time of rating
    - `comment` string — The comment received with this rating, if available
    - `created_at` string, date-time — The time the satisfaction rating got created
    - `group_id` integer, required — The id of group assigned to at the time of rating
    - `id` integer — Automatically assigned upon creation
    - `reason` string — The reason for a bad rating given by the requester in a follow-up question. Satisfaction reasons must be [enabled](https://support.zendesk.com/hc/en-us/articles/223152967)
    - `reason_code` integer — The default reasons the user can select from a list menu for giving a negative rating. See [Reason codes](/api-reference/ticketing/ticket-management/satisfaction_reasons/#reason-codes) in the Satisfaction Reasons API. Can only be set on ratings with a `score` of "bad". Responses don't include this property
    - `reason_id` integer — id for the reason the user gave a negative rating. Can only be set on ratings with a `score` of "bad". To get a descriptive value for the id, use the [Show Reason for Satisfaction Rating](/api-reference/ticketing/ticket-management/satisfaction_reasons/#show-reason-for-satisfaction-rating) endpoint
    - `requester_id` integer, required — The id of ticket requester submitting the rating
    - `score` string, required — The rating "offered", "unoffered", "good" or "bad"
    - `ticket_id` integer, required — The id of ticket being rated
    - `updated_at` string, date-time — The time the satisfaction rating got updated
    - `url` string — The API url of this rating

---

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