---
title: "List magicasts"
method: GET
path: "/magicast.list"
tags: ["Magicasts"]
---

# List magicasts

`GET /magicast.list`

Lists all magicasts in your Roam, sorted in reverse chronological order.

**Access:** Organization and Personal. In Personal mode, only magicasts owned by the authenticated user are returned.

**Required scope:** `magicast:read`

---

**OpenAPI Spec:** [openapi.json](https://developer.ro.am/openapi.json)

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

OK

- object
  - `magicasts` Magicast[]
    - `id` string, uuid, required — Unique identifier for the magicast
    - `name` string, required — Display name of the magicast
    - `createdAt` string, date-time, required — ISO-8601 timestamp when the magicast was created (UTC)
    - `ownerId` string, uuid — Address ID of the magicast owner
    - `coverImageUrl` string, uri — URL for the magicast cover image thumbnail
  - `nextCursor` string — Returned if there is a subsequent page of magicasts.

---

[API](https://skmtc.net/ro/apis/roam-hq-api.md) · [All operations](https://skmtc.net/ro/apis/roam-hq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ro/roam-hq-api/versions/5acda723f971/schema)