Panelist API Overview

The Panelist API enables client-side interactions for voting and survey responses. Use it to build custom voting interfaces.

Base URL

https://api.votito.com/public

Authentication

Panelist API uses compound tokens obtained from the Tenant API. Include the token in the Authorization header:

Authorization: {publicKey}

The publicKey is returned by the Tenant API’s panelist access endpoint.

Endpoints

Method	Endpoint	Description
GET	/survey	Load survey questions
POST	/survey	Submit votes/survey responses
POST	/survey/dismiss	Record survey dismissal

Workflow

1. Get Voting Token

First, your backend calls the Tenant API to get a token:

// Server-side
const { panelist } = await fetch(`https://api.votito.com/tenant/surveys/${surveyId}/panelists/${customerId}`, { headers: { 'X-API-Key': apiKey } }).then((r) =>
	r.json()
);

// Pass panelist.publicKey to your frontend

2. Load Survey

Use the token to load survey questions:

// Client-side
const survey = await fetch('https://api.votito.com/public/survey', {
	headers: { 'Authorization': publicKey }
}).then((r) => r.json());

3. Submit Response

Submit the panelist’s votes:

const result = await fetch('https://api.votito.com/public/survey', {
	method: 'POST',
	headers: {
		'Authorization': publicKey,
		'Content-Type': 'application/json'
	},
	body: JSON.stringify({
		responses: {
			'question-1': { optionId: '3' },
			'question-2': { optionId: '1' }
		},
		isFinal: true
	})
}).then((r) => r.json());

Error Handling

Status	Error	Description
401	Unauthorized	Missing or invalid token
403	Forbidden	Token expired or survey closed
400	invalid_response	Response data is invalid

Reference

Get Survey - Load survey questions for display to a panelist
Submit Response - Submit panelist votes for survey questions
Dismiss Survey - Record that a panelist dismissed a survey without responding