List Topics

List all topics for the organization with cursor-based pagination.

GET/topics

Requires an API key with the topics:read permission.

Query Parameters

limitnumber

Maximum number of results to return. Min 1, max 100. When omitted, every topic is returned — there is no default page size.

afterstring

Cursor for forward pagination.

beforestring

Cursor for backward pagination.

Response Fields

objectstring

Always "list".

has_moreboolean

Whether there are more results available.

dataarray

Array of topic objects. Each item contains id, name, description, default_subscription, visibility, and created_at.

curl -X GET 'https://api.postflare.dev/topics?limit=20' \
  -H 'Authorization: Bearer sk_xxxxxxxxx'

const response = await fetch('https://api.postflare.dev/topics?limit=20', {
  headers: {
    'Authorization': 'Bearer sk_xxxxxxxxx',
  },
});

const data = await response.json();

Response

{
  "object": "list",
  "has_more": false,
  "data": [
    {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Product Updates",
      "description": "Receive the latest product news",
      "default_subscription": "opt_in",
      "visibility": "public",
      "created_at": "2026-01-01T00:00:00.000Z"
    }
  ]
}