GET
/
v1
/
channels
/
{id}
curl https://api.mavioapp.com/v1/channels/chn_a1b2c3d4e5 \
  -H "Authorization: Bearer mvo_live_abc123"
{
  "id": "chn_a1b2c3d4e5",
  "name": "Product Team",
  "description": "Weekly product syncs and design reviews",
  "visibility": "private",
  "owner_id": "usr_f6g7h8",
  "members": [
    {
      "id": "usr_f6g7h8",
      "name": "Sarah Chen",
      "email": "sarah@example.com",
      "role": "owner",
      "joined_at": "2026-02-15T10:00:00Z"
    },
    {
      "id": "usr_k1l2m3",
      "name": "James Rodriguez",
      "email": "james@example.com",
      "role": "admin",
      "joined_at": "2026-02-15T10:05:00Z"
    },
    {
      "id": "usr_n4o5p6",
      "name": "Priya Patel",
      "email": "priya@example.com",
      "role": "member",
      "joined_at": "2026-02-16T09:30:00Z"
    }
  ],
  "recent_meetings": [
    {
      "id": "mtg_8f3k2j1m4n5p",
      "title": "Weekly Product Sync",
      "status": "completed",
      "started_at": "2026-04-10T14:00:00Z",
      "participant_count": 6
    },
    {
      "id": "mtg_7e2d1c0b9a8g",
      "title": "Design Review — Onboarding Flow",
      "status": "completed",
      "started_at": "2026-04-08T11:00:00Z",
      "participant_count": 4
    }
  ],
  "meeting_count": 34,
  "created_at": "2026-02-15T10:00:00Z",
  "updated_at": "2026-04-12T14:30:00Z"
}
Returns the full channel object including the list of members with their roles and the most recent meetings in the channel.
id
string
required
The unique channel identifier (e.g., chn_a1b2c3d4e5).

Response

id
string
Unique channel identifier.
name
string
The channel name.
description
string | null
Optional description of the channel’s purpose.
visibility
string
Channel visibility: public or private.
owner_id
string
User ID of the channel owner.
members
array
List of channel members.
recent_meetings
array
The 5 most recent meetings in the channel.
meeting_count
integer
Total number of meetings in the channel.
created_at
string
ISO 8601 timestamp when the channel was created.
updated_at
string
ISO 8601 timestamp when the channel was last modified.
curl https://api.mavioapp.com/v1/channels/chn_a1b2c3d4e5 \
  -H "Authorization: Bearer mvo_live_abc123"
{
  "id": "chn_a1b2c3d4e5",
  "name": "Product Team",
  "description": "Weekly product syncs and design reviews",
  "visibility": "private",
  "owner_id": "usr_f6g7h8",
  "members": [
    {
      "id": "usr_f6g7h8",
      "name": "Sarah Chen",
      "email": "sarah@example.com",
      "role": "owner",
      "joined_at": "2026-02-15T10:00:00Z"
    },
    {
      "id": "usr_k1l2m3",
      "name": "James Rodriguez",
      "email": "james@example.com",
      "role": "admin",
      "joined_at": "2026-02-15T10:05:00Z"
    },
    {
      "id": "usr_n4o5p6",
      "name": "Priya Patel",
      "email": "priya@example.com",
      "role": "member",
      "joined_at": "2026-02-16T09:30:00Z"
    }
  ],
  "recent_meetings": [
    {
      "id": "mtg_8f3k2j1m4n5p",
      "title": "Weekly Product Sync",
      "status": "completed",
      "started_at": "2026-04-10T14:00:00Z",
      "participant_count": 6
    },
    {
      "id": "mtg_7e2d1c0b9a8g",
      "title": "Design Review — Onboarding Flow",
      "status": "completed",
      "started_at": "2026-04-08T11:00:00Z",
      "participant_count": 4
    }
  ],
  "meeting_count": 34,
  "created_at": "2026-02-15T10:00:00Z",
  "updated_at": "2026-04-12T14:30:00Z"
}