# Get magicast

`GET /magicast.info`

## Description

Retrieve a magicast by ID.

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

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

---

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

## Authentication

```
Authorization: Bearer YOUR_API_KEY
```

## Parameters

| Name | In | Type | Required | Description |
|------|-----|------|----------|-------------|
| `id` | query | string | Yes | The magicast ID. |

## Responses

### 200 - OK

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier for the magicast |
| `name` | string | Yes | Display name of the magicast |
| `createdAt` | string | Yes | ISO-8601 timestamp when the magicast was created (UTC) |
| `ownerId` | string | No | Address ID of the magicast owner |
| `coverImageUrl` | string | No | URL for the magicast cover image thumbnail |


#### Example Response

```json
{
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "Q1 Product Launch Recap",
  "createdAt": "2026-03-20T14:30:00Z",
  "ownerId": "0cc74785-e31e-4403-aa5e-0cc7c1897e66",
  "coverImageUrl": "https://ro.am/assets/a1b2c3d4/thumbnail"
}
```

### 400 - Missing or invalid `id` parameter

### 404 - Magicast not found

---

*Machine-readable API documentation.*
*Full documentation: https://developer.ro.am/docs/roam-api/get-magicast*