Skip to main content
Posts

List all posts

Returns all posts (feedback submissions) for the authenticated organization.

GET
/v2/posts

Posts are user-submitted feedback items. Each post belongs to a board and can have:

  • Status (in progress, complete, etc.)
  • Tags for categorization
  • Upvotes from users
  • Comments (if enabled)
  • Custom field values

Pagination

This endpoint uses cursor-based pagination:

  • limit - Number of posts to return (1-100, default 10)
  • cursor - Opaque cursor from a previous response's nextCursor field

Example: To paginate through results:

  1. First request: GET /v2/posts?limit=10
  2. If nextCursor is not null, use it for the next page
  3. Next request: GET /v2/posts?limit=10&cursor={nextCursor}

Response Format

Returns a list object with:

  • object - Always "list"
  • data - Array of post objects
  • nextCursor - Cursor for the next page (null if no more results)

Filtering

Filter posts using query parameters:

  • boardId - Filter by board (category) ID
  • statusId - Filter by status ID
  • tags - Filter by tag names (can be comma-separated or repeated)
  • q - Search query for title/content
  • inReview - Include posts pending moderation
  • kind - issue (default: work items) or record; insights are never served by this resource — use /v2/insights

Sorting

Use sortBy to sort results:

  • createdAt - Sort by creation date (default)
  • upvotes - Sort by vote count
  • trending - Sort by trending score
  • recent - Sort by most recently updated

Authorizations

Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

Query Parameters

limitintegerquerydefault:10

A limit on the number of posts to be returned, between 1 and 100.

Required range: 1 <= x <= 100
Example: 10
cursorstringquery

An opaque cursor for pagination. Use the nextCursor value from a previous response to fetch the next page of results.

Maximum string length: 512
Example: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
boardIdstring | string[]query

Filter by board (category) ID(s)

Example: 507f1f77bcf86cd799439011
statusIdstring | string[]query

Filter by status ID(s)

Example: 507f1f77bcf86cd799439012
tagsstring | string[]query

Filter by tag names

qstringquery

Search query to filter posts by title/content

Maximum string length: 255
Example: dark mode
inReviewboolean | nullquery

Include posts that are in review

Example: true
sortByenum<string>querydefault:createdAt

Sort order for posts

Available options: createdAt, upvotes, trending, recent
Example: upvotes
sortOrderenum<string>querydefault:desc

Sort direction

Available options: asc, desc
Example: desc
kindenum<string>query

Filter by submission kind. Omitted or 'issue' returns work items only. Pass 'record' for customer submissions whose claims were extracted into insights. Insights are never served by this resource — use /v2/insights.

Available options: issue, record
Example: issue

Headers

Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

dataobject[]required

Array of posts

nextCursorstring | nullrequired

Cursor for fetching the next page (cursor-based pagination)

Maximum string length: 512
Example: eyJpZCI6IjUwN2YxZjc3YmNmODZjZDc5OTQzOTAxMSJ9
objectenum<string>required

Object type identifier

Available options: list
Example: list
paginationobject

Pagination metadata for page-based requests

Still need help? Ask the team