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

# supportCsatResponses

> List the CSAT responses the help desk's CSAT tab lists: completed surveys with a rating, sent between `sentAfter` and `sentBefore` (both included), on `channels`, leaving out surveys on tickets tagged to be left out of analytics. Newest response first; `reverse` lists oldest first. Pages hold up to 100 responses. Selecting `ticket` adds the cost of reading that ticket selection for each response the page can hold, refunded for the tickets not read. The list is search-indexed, so a new response can take a few seconds to appear. A cursor only pages the list read with the same arguments.

**Required scopes:** [`support_analytics_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_analytics_read)

## Arguments

**after** `String`

Forward pagination cursor — returns responses after it.

**before** `String`

Backward pagination cursor — returns responses before it.

**channels** `[\[SupportCsatChannel!\]](/docs/api-reference/v3/reference/support/support-csat-channel)`

Only surveys sent on these channels. Omitted or empty: every channel.

**first** `Int`

Forward pagination: returns the first N responses (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N responses (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**reverse** `Boolean`

List oldest response first.

**sentAfter** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

Only surveys sent at or after this time.

**sentBefore** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

Only surveys sent at or before this time. Must not be earlier than `sentAfter`, or the request fails with BAD\_USER\_INPUT.

## Returns

**supportCsatResponses** `[SupportCsatResponseConnection!](/docs/api-reference/v3/pagination)` *required*

A paginated list of SupportCsatResponse items.

**fields**

**edges** `[\[SupportCsatResponseEdge!\]!](/docs/api-reference/v3/pagination)` *required*

The list of edges (each a node plus its pagination `cursor`).

**fields**

**cursor** `String!` *required*

Opaque cursor for this item; pass to `after`/`before` to page from here.

**node** `[SupportCsatResponse!](/docs/api-reference/v3/reference/support/support-csat-response)` *required*

The item at this edge.

**fields**

**channel** `[SupportCsatChannel!](/docs/api-reference/v3/reference/support/support-csat-channel)` *required*

The channel the survey was sent on.

**comment** `String`

What the customer wrote with their rating. Null when they wrote nothing.

**id** `ID!` *required*

The id of this response, the one the help desk uses.

**rating** `Float!` *required*

The customer's rating, from 1 to 5.

**respondedAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the customer answered.

**sentAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the survey was sent. Null when it wasn't recorded.

**ticket** `[SupportTicket](/docs/api-reference/v3/reference/support/support-ticket)`

The ticket the survey was about; its `customer` and `assignee` are the customer and team member the CSAT tab shows. Null when the ticket is hidden or deleted.

**nodes** `[\[SupportCsatResponse!\]!](/docs/api-reference/v3/reference/support/support-csat-response)` *required*

The nodes in this page, without the edge/cursor wrapper — a convenience over `edges`.

**fields**

**channel** `[SupportCsatChannel!](/docs/api-reference/v3/reference/support/support-csat-channel)` *required*

The channel the survey was sent on.

**comment** `String`

What the customer wrote with their rating. Null when they wrote nothing.

**id** `ID!` *required*

The id of this response, the one the help desk uses.

**rating** `Float!` *required*

The customer's rating, from 1 to 5.

**respondedAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the customer answered.

**sentAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the survey was sent. Null when it wasn't recorded.

**ticket** `[SupportTicket](/docs/api-reference/v3/reference/support/support-ticket)`

The ticket the survey was about; its `customer` and `assignee` are the customer and team member the CSAT tab shows. Null when the ticket is hidden or deleted.

**fields**

**aiDraftReplies** `[SupportAiDraftReplyConnection!](/docs/api-reference/v3/pagination)` *required*

The AI drafts waiting for review on the ticket, oldest first: the suggestions the help desk composer shows, at most one per message they answer. Decided drafts leave the list. Drafts of tickets merged into this one stay on those tickets, as their messages do.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor — returns AI drafts after it.

**before** `String`

Backward pagination cursor — returns AI drafts before it.

**first** `Int`

Forward pagination: returns the first N AI drafts (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N AI drafts (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**assignee** `[TeamMember](/docs/api-reference/v3/reference/common/team-member)`

The team member the ticket is assigned to. Null unless `assigneeType` is TEAM\_MEMBER, and null when they've left the team.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**assigneeType** `[SupportTicketAssigneeType](/docs/api-reference/v3/reference/support/support-ticket-assignee-type)`

What kind of assignee the ticket has. Null when unassigned.

**channels** `[\[MessageChannel!\]!](/docs/api-reference/v3/reference/support/message-channel)` *required*

Every channel the ticket's threads are on, each once, in no set order. Detached threads are left out, as in `threads`.

**closureReason** `[SupportTicketClosureReason](/docs/api-reference/v3/reference/support/support-ticket-closure-reason)`

Why the ticket was closed. Null unless `status` is CLOSED.

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the ticket was created.

**customer** `[Customer](/docs/api-reference/v3/reference/customers/customer)`

The customer the ticket is with: the primary contact on its most recently added thread that has one. Detached and deleted threads are left out, as in `threads`. Null when no thread has one.

**Requires:** [`customers_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-customers_read)

**customerSentiment** `[SupportTicketCustomerSentiment](/docs/api-reference/v3/reference/support/support-ticket-customer-sentiment)`

How the customer seems to feel, from the AI's read of the ticket. Null until it has one.

**draftPreview** `String`

The text of the team's most recently edited unsent reply, on any of the ticket's threads. Null when there's no draft.

**id** `ID!` *required*

The id of this ticket.

**lastCustomerMessageAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the customer last wrote. Null if they haven't written yet.

**lastMerchantMessageAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the team, the AI agent or an automation last wrote to the customer. Null if none has.

**lastMessage** `[Message](/docs/api-reference/v3/reference/support/message)`

The ticket's newest message with text, internal notes included. It skips the messages the ticket's `messages` list leaves out. Null when it has none.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**mergedInto** `[SupportTicket](/docs/api-reference/v3/reference/support/support-ticket)`

The ticket this one was merged into. Null unless it was merged, which also closes it as DUPLICATE.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**mergedTickets** `[SupportTicketConnection!](/docs/api-reference/v3/pagination)` *required*

The tickets merged directly into this one, oldest first.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor — returns tickets after it.

**before** `String`

Backward pagination cursor — returns tickets before it.

**first** `Int`

Forward pagination: returns the first N tickets (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N tickets (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**messages** `[MessageConnection!](/docs/api-reference/v3/pagination)` *required*

The ticket's messages, oldest first, internal notes included. Messages of tickets merged into it stay on those tickets. A thread can hold messages from other tickets, which this leaves out; `thread.messages` has them all.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor — returns messages after it.

**before** `String`

Backward pagination cursor — returns messages before it.

**first** `Int`

Forward pagination: returns the first N messages (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N messages (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**priority** `[SupportTicketPriority!](/docs/api-reference/v3/reference/support/support-ticket-priority)` *required*

How urgent the ticket is.

**readAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the team last read the ticket. Null if no one has opened it.

**senderBlocked** `Boolean`

Whether the ticket's sender is on the store's blocked-sender list (`SupportBlockedSendersSettings.blockedEmails`), as the help desk shows it, whether or not the rule that archives their email is on. The sender is the customer the help desk uses for the ticket: the primary contact on its most recently linked thread, detached and deleted threads included, so it can differ from `customer`, which leaves those out. Their email is matched ignoring case and surrounding spaces. False when no thread has a primary contact or the contact has no email. Null, with an error, when the customer can't be looked up. A request checks its tickets 100 at a time, for 10 points each time.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**snoozedUntil** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When the ticket reopens on its own. Null unless `status` is SNOOZED.

**status** `[SupportTicketStatus!](/docs/api-reference/v3/reference/support/support-ticket-status)` *required*

Where the ticket is in its lifecycle.

**statusUpdatedAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When `status` last changed.

**summary** `String`

The AI's summary of the ticket. Null until one has been written.

**tags** `[SupportTagConnection!](/docs/api-reference/v3/pagination)` *required*

The tags on the ticket, ordered by name.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor — returns tags after it.

**before** `String`

Backward pagination cursor — returns tags before it.

**first** `Int`

Forward pagination: returns the first N tags (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N tags (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**threads** `[MessageThreadConnection!](/docs/api-reference/v3/pagination)` *required*

The threads the ticket's conversation is on, oldest first.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor — returns threads after it.

**before** `String`

Backward pagination cursor — returns threads before it.

**first** `Int`

Forward pagination: returns the first N threads (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N threads (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**ticketNumber** `Int`

The ticket number the help desk shows, unique within the store. Null for some older tickets.

**timeline** `[SupportTicketEventConnection!](/docs/api-reference/v3/pagination)` *required*

What happened on the ticket, oldest first.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**fields**

**Arguments**

**after** `String`

Forward pagination cursor — returns events after it.

**before** `String`

Backward pagination cursor — returns events before it.

**first** `Int`

Forward pagination: returns the first N events (max 100, default 25). Use with `after`; mutually exclusive with `last`/`before`.

**last** `Int`

Backward pagination: returns the last N events (max 100, default 25). Use with `before`; mutually exclusive with `first`/`after`.

**topics** `[\[SupportTopic!\]!](/docs/api-reference/v3/reference/support/support-topic)` *required*

The store's topics the classifier matched to the ticket, ordered by name. The classifier matches at most 10. It lists the classifier's last result, which the help desk's topic rules also read, so it can lag the newest messages until the ticket is classified again. A topic deleted since is left out, and a ticket the classifier hasn't matched has none. Costs a flat 5 points per ticket plus the topic fields selected, however many topics it has.

**Requires:** [`support_tickets_read`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-support_tickets_read)

**unread** `Boolean!` *required*

Whether the customer wrote after the team last read the ticket. False when the customer hasn't written.

**updatedAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the ticket last changed.

**pageInfo** `[PageInfo!](/docs/api-reference/v3/pagination)` *required*

Pagination metadata for the current page.

**fields**

**endCursor** `String`

Cursor of the last edge in this page; pass to `after` to page forward.

**hasNextPage** `Boolean!` *required*

Whether more items exist after this page (drives forward pagination with `first`/`after`).

**hasPreviousPage** `Boolean!` *required*

Whether more items exist before this page (drives backward pagination with `last`/`before`).

**startCursor** `String`

Cursor of the first edge in this page; pass to `before` to page backward.

## Example

```graphql theme={null}
query {
  supportCsatResponses(after: "...", before: "...", channels: ATTENTIVE, first: 10, last: 10, reverse: true, sentAfter: "...", sentBefore: "...") {
    nodes {
      channel
      comment
      id
      rating
      respondedAt
      sentAt
    }
    pageInfo { hasNextPage endCursor }
  }
}
```


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