Polls

List polls in a room (with counts-only tallies)

GET
/api/v1/polls

Authorization

tenant-api-key
x-api-key<token>

Tenant API key (backend only — never expose to a browser)

In: header

Query Parameters

roomId*string

Room ID

status?string

Value in

  • "DRAFT"
  • "ACTIVE"
  • "CLOSED"

Response Body

application/json

curl -X GET "https://example.com/api/v1/polls?roomId=string"
[  {    "id": "string",    "roomId": "string",    "question": "string",    "status": "DRAFT",    "isAnonymous": true,    "allowMultiple": true,    "totalVotes": 0,    "options": [      {        "id": "string",        "text": "string",        "order": 0,        "count": 0      }    ],    "createdAt": "2019-08-24T14:15:22Z",    "closedAt": {}  }]