List voters for a post

Paginated list of users who currently have an active vote on a feedback or roadmap post.

Returns a paginated list of users who currently have an active vote on a single post. Returned in chronological vote-creation order (oldest votes first).

Endpoint

POST https://api.productbridge.io/api/external/v1/votes/voters

Arguments

body

api_keystring

Required

Your organization's public API key. See Authentication.

body

post_idstring

Required

UUID of the post. Must belong to your organization.

body

post_typestring

Required

Polymorphic discriminator. One of "feedback" or "roadmap".

body

limitinteger

Number of items per page. Min 1, max 100. Defaults to 25.

body

cursorstring

Opaque pagination cursor returned by the previous page. Omit for the first page.

Returns

The standard cursor-paginated envelope. Each items[i] is a minimal voter object:

user_idstring

Required

UUID of the voting user.

namestring

Display name. May be null for users without a populated name.

emailstring

Email address. May be null.

{
  "items": [ /* voter objects */ ],
  "has_next_page": false,
  "cursor": null
}

Example request

curl -X POST https://api.productbridge.io/api/external/v1/votes/voters \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key":   "pb_YOUR_PUBLIC_API_KEY",
    "post_id":   "aa3c3ef8-b8cd-cd15-01ba-postpost0001",
    "post_type": "feedback",
    "limit":     50
  }'

const res = await fetch(
  "https://api.productbridge.io/api/external/v1/votes/voters",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      api_key: process.env.PRODUCTBRIDGE_API_KEY,
      post_id: "aa3c3ef8-b8cd-cd15-01ba-postpost0001",
      post_type: "feedback",
      limit: 50,
    }),
  }
);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const { items, has_next_page, cursor } = await res.json();

import os, httpx

resp = httpx.post(
    "https://api.productbridge.io/api/external/v1/votes/voters",
    json={
        "api_key": os.environ["PRODUCTBRIDGE_API_KEY"],
        "post_id": "aa3c3ef8-b8cd-cd15-01ba-postpost0001",
        "post_type": "feedback",
        "limit": 50,
    },
)
resp.raise_for_status()
payload = resp.json()

Example response

{
  "items": [
    {
      "user_id": "bb3c3ef8-b8cd-cd15-01ba-useruser0001",
      "name":    "Sally Doe",
      "email":   "sally@acme.example.com"
    },
    {
      "user_id": "bb3c3ef8-b8cd-cd15-01ba-useruser0002",
      "name":    null,
      "email":   "anon@protonmail.example"
    }
  ],
  "has_next_page": false,
  "cursor": null
}

If the post belongs to a different organization, the response is 200 OK with an empty items array — never another org's voters.

Errors

Status	Body	Cause
`401`	`{"detail":{"error":"invalid api_key"}}`	Missing / unknown / inactive `api_key`.
`422`	Validation error envelope	`post_type` not in `{"feedback","roadmap"}`, `limit` out of range, missing fields.

See Errors and Pagination.

Was this page helpful?

Last updated 1 week ago

Built with Documentation.AI