> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mavioapp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List notes

> Retrieve a paginated list of notes attached to a specific meeting.

Returns all notes associated with a meeting, ordered by creation date descending. Notes can be created manually by users or generated automatically from AI summaries.

<ParamField path="id" type="string" required>
  The unique meeting identifier (e.g., `mtg_8f3k2j1m4n5p`).
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of notes to return per page. Must be between 1 and 100.
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of notes to skip for pagination.
</ParamField>

### Response

<ResponseField name="data" type="array">
  An array of note objects.

  <Expandable title="Note object">
    <ResponseField name="id" type="string">
      Unique note identifier (e.g., `nte_a1b2c3d4e5`).
    </ResponseField>

    <ResponseField name="meeting_id" type="string">
      The meeting this note is attached to.
    </ResponseField>

    <ResponseField name="title" type="string | null">
      Optional title for the note. `null` if untitled.
    </ResponseField>

    <ResponseField name="content" type="string">
      The note content in Markdown format.
    </ResponseField>

    <ResponseField name="author" type="object">
      The user who created the note.

      <Expandable title="Author object">
        <ResponseField name="id" type="string">
          User identifier.
        </ResponseField>

        <ResponseField name="name" type="string">
          Display name of the author.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the note was created.
    </ResponseField>

    <ResponseField name="updated_at" type="string">
      ISO 8601 timestamp when the note was last modified.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="pagination" type="object">
  Pagination metadata.

  <Expandable title="Pagination object">
    <ResponseField name="total" type="integer">
      Total number of notes for this meeting.
    </ResponseField>

    <ResponseField name="limit" type="integer">
      The limit used in this request.
    </ResponseField>

    <ResponseField name="offset" type="integer">
      The offset used in this request.
    </ResponseField>

    <ResponseField name="has_more" type="boolean">
      Whether there are more results beyond this page.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -G https://api.mavioapp.com/v1/meetings/mtg_8f3k2j1m4n5p/notes \
    -H "Authorization: Bearer mvo_live_abc123" \
    -d limit=10
  ```

  ```python Python theme={null}
  notes = client.notes.list(meeting_id="mtg_8f3k2j1m4n5p", limit=10)
  for note in notes.data:
      print(f"{note.title or 'Untitled'}: {note.content[:80]}...")
  ```

  ```javascript Node.js theme={null}
  const { data: notes } = await client.notes.list('mtg_8f3k2j1m4n5p', {
    limit: 10,
  });
  notes.forEach(note => {
    console.log(`${note.title ?? 'Untitled'}: ${note.content.slice(0, 80)}...`);
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "data": [
      {
        "id": "nte_a1b2c3d4e5",
        "meeting_id": "mtg_8f3k2j1m4n5p",
        "title": "Key Decisions",
        "content": "## Decisions Made\n\n- Launch date confirmed for April 20th\n- Stripe integration will be prioritized over PayPal\n- QA sprint starts Monday",
        "author": {
          "id": "usr_f6g7h8",
          "name": "Sarah Chen"
        },
        "created_at": "2026-04-10T15:02:00Z",
        "updated_at": "2026-04-10T15:02:00Z"
      },
      {
        "id": "nte_f6g7h8i9j0",
        "meeting_id": "mtg_8f3k2j1m4n5p",
        "title": null,
        "content": "Follow up with Priya on Stripe sandbox testing results by EOD tomorrow.",
        "author": {
          "id": "usr_k1l2m3",
          "name": "James Rodriguez"
        },
        "created_at": "2026-04-10T14:55:30Z",
        "updated_at": "2026-04-10T14:55:30Z"
      }
    ],
    "pagination": {
      "total": 2,
      "limit": 10,
      "offset": 0,
      "has_more": false
    }
  }
  ```
</ResponseExample>