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
}