---
title: "Read the playlist a slice belongs to"
method: GET
path: "/v1/shared-with-me/{allocationId}/source"
tags: ["shared-with-me"]
---

# Read the playlist a slice belongs to

`GET /v1/shared-with-me/{allocationId}/source`

## Request

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

Get the owner playlist around an airtime slice shared with your team: its name, whether it shuffles, its items in play order (name, kind, thumbnail, duration), and the share itself (kind, value, whether approval is required, and your fill playlist). Read only. Besides `playlist.view`, you need `playlist.edit` at the location the slice is reserved for. Other locations’ shares and the owner’s settings are not returned.

**Notes.**
- Besides `playlist.view`, the caller needs `playlist.edit` at the location the slice is reserved for.
- Read only. Other locations' shares and the owner's settings are not returned.

## Path parameters

- `allocationId` string, required

## Response `200`

Success.

- object
  - `data` object, required
    - `playlist` object, required
      - `id` string, required
      - `name` string, required
      - `shuffle` boolean, required
    - `items` object[], required: The owner's items in order: what plays around your share.
      - `name` string, required
      - `kind` string, required
      - `thumbnailUrl` string, nullable, required
      - `durationSec` number, required
    - `share` object, required
      - `kind` 'percent' | 'every-nth' | 'daypart', required
      - `value` number, required
      - `requiresApproval` boolean, required
      - `reservedForName` string, required
      - `fillPlaylistId` string, nullable, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: You cannot fill this slice.
- `404`: No such fillable slice in this workspace.
- `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)