List Topics

GEThttps://api.inboxjot.com/v1/topics

Lists the topics of the workspace, oldest first. Needs a Full key. A key limited to one domain answers 403.

Lists are paged with cursors. Read next_cursor and send it as after for the next page. A page has 50 items unless you set per_page, up to 100.

GET/v1/topics

1
2

curl -X GET https://api.inboxjot.com/v1/topics \
  -H "Authorization: Bearer $INBOXJOT_API_KEY"

{
  "data": [
    {
      "id": "top_06d2mfk8r6pn2tc8yw3hd",
      "name": "Product updates",
      "description": "New features, once a month.",
      "default_subscribed": true,
      "visibility": "public",
      "double_opt_in": false,
      "form_enabled": false,
      "sender_name": null,
      "sender_email": null,
      "redirect_url": null,
      "is_default": false,
      "counts": {
        "subscribed": 3120,
        "pending": 14,
        "unsubscribed": 96
      },
      "created_at": "2026-09-02T10:12:00.000Z",
      "updated_at": "2026-09-02T10:12:00.000Z"
    }
  ],
  "prev_cursor": null,
  "next_cursor": null
}

Returns a page of topics.

Query Parameters

per_pageinteger

How many items to return, from 1 to 100. Defaults to 50.

afterstring

A next_cursor from the last page. Returns the items after it.

beforestring

A prev_cursor from the last page. Returns the items before it. When you send both, before wins.

Response

dataobject[]

The topics on this page.

prev_cursorstring | null

Send it as before to get the page before. null on the first page.

next_cursorstring | null

Send it as after to get the next page. null on the last page.

Responses

{ "data": [ { "id": "top_06d2mfk8r6pn2tc8yw3hd", "name": "Product updates", "description": "New features, once a month.", "default_subscribed": true, "visibility": "public", "double_opt_in": false, "form_enabled": false, "sender_name": null, "sender_email": null, "redirect_url": null, "is_default": false, "counts": { "subscribed": 3120, "pending": 14, "unsubscribed": 96 }, "created_at": "2026-09-02T10:12:00.000Z", "updated_at": "2026-09-02T10:12:00.000Z" } ], "prev_cursor": null, "next_cursor": null }