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

# List Annotations

> Returns all annotations for a specific item.

## Path Parameters

<ParamField path="item_id" type="string" required>
  The item ID. Example: `itm_r9f3a`.
</ParamField>

## Query Parameters

<ParamField query="limit" type="integer" default={25}>
  Number of annotations per page. Min 1, max 100.
</ParamField>

<ParamField query="cursor" type="string">
  Cursor for the next page of results.
</ParamField>

## Response

<ResponseField name="object" type="string" required>
  Always `"list"`.
</ResponseField>

<ResponseField name="results" type="array" required>
  Array of annotation objects.

  <Expandable title="annotation properties">
    <ResponseField name="object" type="string">Always `"annotation"`.</ResponseField>
    <ResponseField name="id" type="string">Annotation ID.</ResponseField>
    <ResponseField name="item_id" type="string">The parent item ID.</ResponseField>
    <ResponseField name="text" type="string">The highlighted text.</ResponseField>
    <ResponseField name="note" type="string">User-added note, if any.</ResponseField>
    <ResponseField name="created_at" type="string">ISO 8601 timestamp.</ResponseField>
    <ResponseField name="updated_at" type="string">ISO 8601 timestamp.</ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="has_more" type="boolean" required>
  Whether there are more results.
</ResponseField>

<ResponseField name="next_cursor" type="string">
  Cursor for the next page.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.getmatter.com/public/v1/items/itm_r9f3a/annotations" \
    -H "Authorization: Bearer mat_your_token_here"
  ```

  ```python Python theme={null}
  response = requests.get(
      "https://api.getmatter.com/public/v1/items/itm_r9f3a/annotations",
      headers={"Authorization": f"Bearer {token}"}
  )
  annotations = response.json()
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "object": "list",
    "results": [
      {
        "object": "annotation",
        "id": "ann_m2k8v",
        "item_id": "itm_r9f3a",
        "text": "The way to figure out what to work on is by working.",
        "note": "Core thesis of the essay",
        "created_at": "2026-03-30T18:32:00Z",
        "updated_at": "2026-03-30T18:32:00Z"
      }
    ],
    "has_more": false,
    "next_cursor": null
  }
  ```
</ResponseExample>