Skip to main content
GET
/
v1
/
tags
curl https://api.getmatter.com/public/v1/tags \
  -H "Authorization: Bearer mat_your_token_here"

{
  "object": "list",
  "results": [
    {
      "object": "tag",
      "id": "tag_n5j2x",
      "name": "essays",
      "item_count": 42,
      "created_at": "2025-01-15T10:00:00Z"
    },
    {
      "object": "tag",
      "id": "tag_k3m9p",
      "name": "tech",
      "item_count": 87,
      "created_at": "2025-02-20T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

​
Query Parameters

​
limit
integer
default:25
Number of tags 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 tag 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/tags \
  -H "Authorization: Bearer mat_your_token_here"

{
  "object": "list",
  "results": [
    {
      "object": "tag",
      "id": "tag_n5j2x",
      "name": "essays",
      "item_count": 42,
      "created_at": "2025-01-15T10:00:00Z"
    },
    {
      "object": "tag",
      "id": "tag_k3m9p",
      "name": "tech",
      "item_count": 87,
      "created_at": "2025-02-20T14:30:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}