---
search:
  tags:
    - Viewers
    - GET
seo:
  description: >-
    The viewer's played sub-reward messages, most recent first - the same…
    Reference for the GET /viewers/{user}/rewards endpoint in the TipPage
    Developer API.
sidebar:
  label: A viewer's sub-reward history
  badge: GET
title: A viewer's sub-reward history
type: openapi-operation
---
The viewer's played sub-reward messages, most recent first - the same shape as `/tts/history`, filtered to this viewer's sub rewards. Replays by the streamer are excluded; a sub reward still waiting to play shows up in `/tts/queue` like any other tip. Requires `viewers:read`.

`GET /viewers/{user}/rewards`

**Responses**

- `200` — One page of played sub rewards.
- `400` — Unknown \`before\` cursor (\`bad\_cursor\`).
- `401` — Missing or invalid credential (\`missing\_api\_key\` / \`invalid\_api\_key\`, or \`invalid\_token\` for an expired/revoked OAuth access token).
- `403` — The key lacks the required scope (\`missing\_scope\`).
- `404` — No viewer with that name or id has ever signed in to this tip page (\`viewer\_not\_signed\_in\`). Signing in on the tip page (Twitch or Kick) is what creates a viewer - until then they can't be looked up or granted credits.
- `409` — More than one signed-in viewer matches (\`ambiguous\_viewer\`) - two people share that name, or a bare id exists on both platforms. Retry with \`\<platform\>:\<id\>\`.
- `429` — Rate limit exceeded - check the \`RateLimit-\*\` headers.

Response example, 200:

```json
{
  "viewer": {
    "platform": "twitch",
    "platform_user_id": "123456789",
    "login": "gigachad42",
    "display_name": "GigaChad42",
    "profile_image_url": "http://example.com",
    "subscriber_tier": 0,
    "first_signed_in_at": "2019-08-24T14:15:22Z",
    "last_active_at": "2019-08-24T14:15:22Z",
    "linked_accounts": [
      {
        "platform": "twitch",
        "platform_user_id": "string",
        "login": "string",
        "display_name": "string"
      }
    ]
  },
  "rewards": [
    {
      "order_id": "string",
      "name": "string",
      "amount": 0,
      "message": "string",
      "tts_url": "http://example.com",
      "is_replay": true,
      "is_sub_reward": true,
      "source": "string",
      "external_source": "string",
      "external_ref": "string",
      "is_paid": true,
      "platform": "twitch",
      "platform_user_id": "string",
      "name_was_filtered": true,
      "message_was_filtered": true,
      "queued_at": "2019-08-24T14:15:22Z",
      "played_at": "2019-08-24T14:15:22Z"
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```
