Skip to main content
GET
Get a survey's results per question

Authorizations

Authorization
string
header
required

An API key (utk_live_...) or an app's OAuth access token (uto_...).

Path Parameters

surveyId
string<uuid>
required

A survey id.

Query Parameters

from
string<date-time>

From this time (RFC 3339; UTC when no offset).

to
string<date-time>

Up to this time (RFC 3339; UTC when no offset). A date alone (2026-10-14) includes that whole UTC day.

channel
enum<string>

website, link or email.

Available options:
website,
link,
email
country
string

A country code (ISO 3166, US).

Maximum string length: 16
device
enum<string>

desktop, tablet or mobile.

Available options:
desktop,
tablet,
mobile
language
string

A language tag the responses were answered in.

Maximum string length: 35
page
string

A page responses came from (a path or a URL), as the Pages list keys it.

Maximum string length: 2048
answer
string[]

questionId:value, the value as the question's bucket key reads (an option's words, a number, yes or no). Repeat it, at most 50; they combine. A filter on a question no longer in the survey is listed in ignoredFilters.

Maximum array length: 50
Maximum string length: 600
variant
string

A variant id (v_...) or default.

Maximum string length: 64
timedOut
enum<string>

yes: responses where a timer ran out; no: timed responses where none did.

Available options:
yes,
no
speeders
boolean

true: responses faster than a third of the survey's median time.

durationMin
integer

The shortest total response time, in seconds (0 to 86,400).

Required range: 0 <= x <= 86400
durationMax
integer

The longest total response time, in seconds (0 to 86,400).

Required range: 0 <= x <= 86400
tz
string

An IANA time zone the daily and weekly steps are cut in (UTC by default).

Maximum string length: 64
Example:

"Europe/Istanbul"

Response

The results.

A survey's results as aggregates. Written answers, contact details and files are responses, read with responses:read.

surveyId
string<uuid>
required
window
object
required
summary
object
required
demographics
object
required
questions
object[]
required

In survey order.

removedQuestions
object[]
required

Questions no longer in the survey that have answers in the window. Their values are left out, since a removed text question's values are written answers.

ignoredFilters
object[]
required

Answer filters that named a question no longer in the survey; every other filter applied.

partial
boolean
required

True when part of the read failed (the series, the window before or the device split): what came back is right, and the missing parts are empty.

Last modified on November 8, 2026