List posts

Retrieve a paginated list of feedback posts with optional filters.

Authorization

bearerAuth

AuthorizationBearer <token>

API key with sk_live_ or sk_test_ prefix. Create keys in your workspace settings.

In: header

Query Parameters

filters?string

Semicolon-separated key:value filter pairs. Supported keys: typeId (filter by post type ID), statusId (filter by status ID), search (text search query). Unknown keys are silently ignored.

sortBy?string

Sort order for results

Value in"votes" | "recent" | "oldest"

cursor?integer

Pagination cursor

limit?integer

Number of results per page

include?string

Semicolon-separated list of related resources to include. Supported: attachments, voters.

Response Body

`application/json`

curl -X GET "https://app.fdback.io/api/v1/posts"

{
  "data": {
    "posts": [
      {
        "id": "string",
        "title": "string",
        "description": {},
        "descriptionHtml": "string",
        "postTypeId": "string",
        "statusId": "string",
        "votesCount": 0,
        "commentsCount": 0,
        "createdAt": "2019-08-24T14:15:22Z",
        "updatedAt": "2019-08-24T14:15:22Z"
      }
    ],
    "cursor": 0,
    "hasMore": true
  }
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key.",
    "status": 401
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Please try again later.",
    "status": 429
  }
}

Query Parameters

Semicolon-separated key:value pairs via the filters query parameter.

Key	Description
`typeId`	Filter by post type ID
`statusId`	Filter by status ID
`search`	Full-text search across post titles

GET /posts?filters=typeId:abc;statusId:def;search:dark mode

Values can contain colons — only the first : is the separator.

Semicolon-separated values via the include query parameter.

Value	Description
`attachments`	Include file attachments on each post
`voters`	Include the list of users who voted

GET /posts?include=attachments;voters

Unknown values are silently ignored.

Standalone sortBy query parameter.

Value	Description
`votes`	Most voted first
`recent`	Newest first (default)
`oldest`	Oldest first

GET /posts?sortBy=votes

Parameter	Type	Description
`cursor`	integer	Page number for cursor-based pagination
`limit`	integer	Results per page (1–100, default 20)

GET /posts?cursor=2&limit=10

Full example:

GET /posts?filters=typeId:abc;search:bug&sortBy=votes&limit=10&include=attachments

Authorization

Query Parameters

Response Body

200application/json

401application/json

429application/json

Query Parameters

`application/json`

`application/json`

`application/json`