---
search:
  tags:
    - Overlays
    - GET
seo:
  description: >-
    Whether any of the account's overlays holds a live realtime connection
    right… Reference for the GET /overlays/connected endpoint in the TipPage
    Developer API.
sidebar:
  label: Is an overlay connected?
  badge: GET
title: Is an overlay connected?
type: openapi-operation
---
Whether any of the account's overlays holds a live realtime connection right now - without one, nothing you queue plays. Needs `tts:read` or `media:read` (not `overlays:manage`): it is the fact both queues share.

`GET /overlays/connected`

**Responses**

- `200` — The connected overlays.
- `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
{
  "connected": true,
  "media_screen": true,
  "overlays": [
    {
      "id": "string",
      "name": "string",
      "media_screen": true
    }
  ]
}
```
