Pagination

ProductBridge's public API uses cursor-based pagination for list endpoints that return potentially large result sets. The cursor is opaque — clients should pass it back unchanged without trying to parse or compute it.

Some list endpoints return small, bounded result sets (e.g. categories, tags, statuses, boards) and are not paginated — they return a raw JSON array. The per-endpoint reference page calls out which model an endpoint uses.

How it works

Send limit and (on follow-up requests) cursor as JSON body fields:

{
  "api_key": "pb_YOUR_PUBLIC_API_KEY",
  "limit": 25,
  "cursor": null
}

The response wraps the items in a fixed envelope:

{
  "items": [ /* per-resource shape */ ],
  "has_next_page": true,
  "cursor": "MjU"
}

Walking the full list

A typical "fetch everything" loop:

async function listAllFeedbackPosts(apiKey) {
  const all = [];
  let cursor = null;

  while (true) {
    const res = await fetch(
      "https://api.productbridge.io/api/external/v1/feedback-posts/list",
      {
        method: "POST",
        headers: { "Content-Type": "application/json" },
        body: JSON.stringify({ api_key: apiKey, limit: 100, cursor }),
      }
    );
    if (!res.ok) throw new Error(`HTTP ${res.status}`);
    const { items, has_next_page, cursor: nextCursor } = await res.json();

    all.push(...items);
    if (!has_next_page) break;
    cursor = nextCursor;
  }

  return all;
}

import httpx

def list_all_feedback_posts(api_key: str) -> list[dict]:
    all_items = []
    cursor = None
    with httpx.Client() as client:
        while True:
            resp = client.post(
                "https://api.productbridge.io/api/external/v1/feedback-posts/list",
                json={"api_key": api_key, "limit": 100, "cursor": cursor},
            )
            resp.raise_for_status()
            page = resp.json()
            all_items.extend(page["items"])
            if not page["has_next_page"]:
                break
            cursor = page["cursor"]
    return all_items

Endpoints that paginate

Endpoints that return unpaginated arrays

These endpoints have small, bounded result sets and skip the pagination envelope entirely. Each returns a JSON array: