---
title: "List active and scheduled temporary screen takeovers"
method: GET
path: "/v1/takeovers"
tags: ["Devices and streams"]
---

# List active and scheduled temporary screen takeovers

`GET /v1/takeovers`

## Request

- Base URL: `https://infoslides.app`
- URL: `https://infoslides.app/v1/takeovers`
- Auth: none declared

Lists the workspace's temporary screen takeovers, latest start first, each with `id`, `deviceId` and `deviceName`, `slideshowId` and `slideshowTitle`, `startsAt`, `endsAt` (null when open-ended), `cancelledAt` and `isActive` (running right now). `?deviceId=` narrows it to one screen; `?activeOnly=true` returns only those running right now (not ended, cancelled or still to start). Use it to answer "is anything overriding the lobby screen?" or to find the id to end one early.

## Query parameters

- `deviceId` string, uuid
- `activeOnly` boolean

## Response `200`

OK

---

[API](https://skmtc.dev/infoslides/apis/infoslides-agent-api.md) · [All operations](https://skmtc.dev/infoslides/apis/infoslides-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/infoslides/apis/infoslides-agent-api/revisions/d15bb7f8ee9d?raw)