Social API reference

Social API · Stories

get/v1/communities/{community_id}/posts/{post_id}/votes/{actor_id}Auth

Read an actor's vote on a poll.

Returns the actor's chosen `option_index` and when it was cast. 404 when the post is gone or the actor has not voted. Naturally idempotent — no Idempotency-Key.

Path parameters

community_id*string

Community UUID.

post_id*string

Post UUID containing the poll.

actor_id*string

Voter social actor UUID.

Response · 200 The actor's vote.

option_index*number

Zero-based index of the option the actor voted for.

Example: 1

created_at*string · date-time

When the vote was cast (or last changed).

Example: "2026-05-01T11:30:00.000Z"

Example

Request

GET https://social.productcraft.co/v1/communities/{community_id}/posts/{post_id}/votes/{actor_id}
Authorization: Bearer YOUR_TOKEN

Response

{
  "option_index": 1,
  "created_at": "2026-05-01T11:30:00.000Z"
}