---
title: "List airtime shared with me"
method: GET
path: "/v1/shared-with-me"
tags: ["shared-with-me"]
---

# List airtime shared with me

`GET /v1/shared-with-me`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/shared-with-me`
- Auth: HTTP bearer

List airtime slices that other teams have reserved and made available for the caller's team to fill.

**Notes.**
- Only slices the caller can fill are listed. Besides `playlist.view`, the caller needs `playlist.edit` at the location the slice is reserved for.

## Response `200`

Success.

- object
  - `data` object[], required
    - `allocationId` string, required
    - `label` string, required
    - `reservedForNodeId` string, required: The location the slice is reserved for.
    - `reservedForName` string, required
    - `kind` 'percent' | 'every-nth' | 'daypart', required: Only `percent` and `every-nth` slices are listed.
    - `value` number, required: The share of airtime (a percentage, or every Nth item).
    - `requiresApproval` boolean, required
    - `sourcePlaylist` object, required
      - `id` string, required
      - `name` string, required
      - `nodeId` string, nullable, required
    - `fill` object, nullable, required: The playlist that fills the slice; null when none is bound.
      - `id` string, required
      - `name` string, required
      - `approvalState` 'draft' | 'pending' | 'approved' | 'rejected', required: Where the fill stands in review. With `requiresApproval`, only `approved` plays.

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)