---
search:
  tags:
    - Chat timers
    - GET
seo:
  description: >-
    All timers, enabled or not. Requires timers:manage. Reference for the GET
    /timers endpoint in the TipPage Developer API.
sidebar:
  label: List timers
  badge: GET
title: List timers
type: openapi-operation
---
All timers, enabled or not. Requires `timers:manage`.

`GET /timers`

**Responses**

- `200` — All timers for this streamer.
- `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
{
  "timers": [
    {
      "id": "tmr_1a2b3c4d5e6f7a8b",
      "name": "string",
      "message": "string",
      "interval_minutes": 1,
      "interval_max_minutes": 1,
      "min_chat_lines": 0,
      "live_only": true,
      "platforms": [
        "twitch"
      ],
      "enabled": true,
      "created_at": "2019-08-24T14:15:22Z",
      "updated_at": "2019-08-24T14:15:22Z"
    }
  ]
}
```
