---
search:
  tags:
    - Viewers
    - GET
seo:
  description: >-
    Every account that has signed in to the tip page (Twitch or Kick), most
    recently… Reference for the GET /viewers endpoint in the TipPage Developer
    API.
sidebar:
  label: List signed-in viewers
  badge: GET
title: List signed-in viewers
type: openapi-operation
---
Every account that has signed in to the tip page (Twitch or Kick), most recently signed-in first, each with the person's sub-reward credit balance (summed across their linked accounts, so a viewer who signed in here with both shows two rows with the same balance). Viewers who have never signed in don't appear - signing in is what creates a viewer. Requires `viewers:read`.

`GET /viewers`

**Responses**

- `200` — One page of viewers, newest sign-up first.
- `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\`).
- `429` — Rate limit exceeded - check the \`RateLimit-\*\` headers.

Response example, 200:

```json
{
  "viewers": [
    {
      "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"
        }
      ],
      "credits": {
        "available": 0,
        "total": 0,
        "used": 0
      }
    }
  ],
  "has_more": true,
  "next_cursor": "string"
}
```
