Skip to main content
GET
/
v1
/
items
/
{item_id}
/
annotations
curl "https://api.getmatter.com/public/v1/items/itm_r9f3a/annotations" \
  -H "Authorization: Bearer mat_your_token_here"
{
  "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
}

Path Parameters

item_id
string
required
The item ID. Example: itm_r9f3a.

Query Parameters

limit
integer
default:25
Number of annotations per page. Min 1, max 100.
cursor
string
Cursor for the next page of results.

Response

object
string
required
Always "list".
results
array
required
Array of annotation objects.
has_more
boolean
required
Whether there are more results.
next_cursor
string
Cursor for the next page.
curl "https://api.getmatter.com/public/v1/items/itm_r9f3a/annotations" \
  -H "Authorization: Bearer mat_your_token_here"
{
  "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
}