Skip to main content
Posts

List voters on a post

Returns all voters (upvoters) for a specific post.

GET
/v2/posts/{id}/voters

Voters are users who have upvoted the post. Each voter is returned in the standard user format with:

  • Basic info: id, name, email, profilePicture
  • User type (admin, customer, guest, etc.)
  • Companies the user belongs to
  • Activity stats: commentsCreated, postsCreated, lastActivity
  • Preferences: subscribedToChangelog, locale, verified

Pagination

This endpoint uses cursor-based pagination:

  • limit - Number of voters 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/{id}/voters?limit=10
  2. If nextCursor is not null, use it for the next page
  3. Next request: GET /v2/posts/{id}/voters?limit=10&cursor={nextCursor}

Response Format

Returns a list object with:

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

Permissions

Requires member-level access or higher.

Authorizations

Authorizationstringheaderrequired

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

Path Parameters

idstringrequired

Post unique identifier

Example: 507f1f77bcf86cd799439011

Query Parameters

limitintegerquerydefault:10

A limit on the number of voters 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

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 users

nextCursorstring | nullrequired

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

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