Skip to content

Quiz answer conversion

GET
/v1/quizzes/{quiz_id}/analytics/answers
curl --request GET \
--url 'https://api.octaneai.com/v1/quizzes/example/analytics/answers?tz=UTC' \
--header 'Authorization: Bearer <token>'
quiz_id
required
Quiz Id
string
component_key
Any of:
string
<= 200 characters
from
Any of:
string format: date

First day, inclusive, in tz; 29 days before to when absent

to
Any of:
string format: date

Last day, inclusive, in tz; today when absent

tz
Tz
string
default: UTC <= 64 characters
channel
Any of:
string
device
Any of:
string
new_returning
Any of:
string
country
Any of:
string
if-none-match
Any of:
string
<= 1024 characters

Analytics for the range. ETag identifies the cached response.

Media typeapplication/json
AnalyticsAnswers
object
answered
required
Answered
integer
buckets
required
Buckets
Array<object>
AnswerBucketRow
object
answer_orders
required
Answer Orders
integer
answer_revenue
required
Any of:
Money
object
amount
required
Amount
string
currency
required
Currency
string
answered
required
Answered
integer
answered_share
required
Any of:
number
buyer_rate
required
Any of:
number
buyers
required
Buyers
integer
completed
required
Completed
integer
completion_rate
required
Any of:
number
high
required
High
number
label
required
Label
string
low
required
Low
number
opt_in_rate
required
Any of:
number
opted_in
required
Opted In
integer
currency
required
Any of:
string
filters
required
AnalyticsFilters
object
channel
required
Any of:
string
country
required
Any of:
string
device
required
Any of:
string
new_returning
required
Any of:
string
freshness
required
Freshness
object
as_of
required
Any of:
string format: date-time
closed_days_through
required
Closed Days Through
string format: date
next_refresh_at
required
Any of:
string format: date-time
pending
required
Pending
boolean
stale
required
Stale
boolean
today_live
required
Today Live
boolean
options
required
Options
Array<object>
AnswerOptionRow
object
answer_orders
required
Answer Orders
integer
answer_revenue
required
Any of:
Money
object
amount
required
Amount
string
currency
required
Currency
string
buyer_rate
required
Any of:
number
buyers
required
Buyers
integer
chose
required
Chose
integer
chose_share
required
Any of:
number
completed
required
Completed
integer
completion_rate
required
Any of:
number
image_url
required
Any of:
string
kind
required
Kind
string
Allowed values: choice image
label
required
Label
string
opt_in_rate
required
Any of:
number
opted_in
required
Opted In
integer
option_id
required
Option Id
string
removed
required
Removed
boolean
question
required
Any of:
AnswersQuestion
object
component_key
required
Component Key
string
kind
required
Kind
string
Allowed values: choice number
page_key
required
Page Key
string
page_title
required
Any of:
string
question
required
Question
string
questions
required
Questions
Array<object>
AnswersQuestion
object
component_key
required
Component Key
string
kind
required
Kind
string
Allowed values: choice number
page_key
required
Page Key
string
page_title
required
Any of:
string
question
required
Question
string
quiz_id
required
Quiz Id
string
/^quiz_[0-9a-f]{32}$/
range
required
AnalyticsRange
object
days
required
Days
integer
end
required
End
string format: date
start
required
Start
string format: date
timezone
required
Timezone
string
summary
required
Any of:
AnswerNumericSummary
object
count
required
Count
integer
max
required
Max
number
mean
required
Mean
number
median
required
Median
number
min
required
Min
number
Example
{
"answered": 5,
"buckets": [],
"currency": "USD",
"filters": {},
"freshness": {
"as_of": "2026-09-07T12:00:00Z",
"closed_days_through": "2026-09-06",
"next_refresh_at": "2026-09-07T13:00:00Z",
"pending": false,
"stale": false,
"today_live": true
},
"options": [
{
"answer_orders": 1,
"answer_revenue": {
"amount": "12.50",
"currency": "USD"
},
"buyer_rate": 50,
"buyers": 1,
"chose": 3,
"chose_share": 60,
"completed": 2,
"completion_rate": 66.67,
"image_url": "https://cdn.shopify.com/s/files/1/0001/skin-dry.jpg",
"kind": "image",
"label": "Dry",
"opt_in_rate": 50,
"opted_in": 1,
"option_id": "opt-1",
"removed": false
}
],
"question": {
"component_key": "choice-abc12",
"kind": "choice",
"page_key": "skin",
"page_title": "Skin",
"question": "Skin type?"
},
"questions": [
{
"component_key": "choice-abc12",
"kind": "choice",
"page_key": "skin",
"page_title": "Skin",
"question": "Skin type?"
}
],
"quiz_id": "quiz_7c9e6679742540de944be07fc1f90ae7",
"range": {
"days": 7,
"end": "2026-09-07",
"start": "2026-09-01",
"timezone": "UTC"
}
}
ETag
string
Example
"5a23d8"

If-None-Match matches the cached response; no body is sent.

ETag
string

The key is missing, malformed, revoked or expired.

Media typeapplication/problem+json
Problem

The body of every non-2xx response.

object
detail
required
Detail

What went wrong, for people

string
errors
Any of:
Array<object>
FieldError
object
field
required
Field

The input that failed, as a dotted path (body.label, query.from)

string
message
required
Message

Why it failed

string
export
Any of:
object
key
additional properties
any
request_id
required
Request Id

The same value as the Request-Id header; quote it to support

string
required
Any of:
Array<string>
retry_after
Any of:
integer
status
required
Status

The HTTP status of the response

integer
title
required
Title

The machine-readable error code

string
type
required
Type

A stable URI naming the error, on this API’s public host

string
Example
{
"detail": "The API key is missing, malformed, revoked or expired",
"request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": 401,
"title": "invalid_api_key",
"type": "https://api.octaneai.com/errors/invalid_api_key"
}
WWW-Authenticate
string
Example
Bearer

The store’s plan has no API access, or the key lacks the scope.

Media typeapplication/problem+json
Problem

The body of every non-2xx response.

object
detail
required
Detail

What went wrong, for people

string
errors
Any of:
Array<object>
FieldError
object
field
required
Field

The input that failed, as a dotted path (body.label, query.from)

string
message
required
Message

Why it failed

string
export
Any of:
object
key
additional properties
any
request_id
required
Request Id

The same value as the Request-Id header; quote it to support

string
required
Any of:
Array<string>
retry_after
Any of:
integer
status
required
Status

The HTTP status of the response

integer
title
required
Title

The machine-readable error code

string
type
required
Type

A stable URI naming the error, on this API’s public host

string
Examples
{
"detail": "The API key does not carry the scope this route needs",
"request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"required": [
"quizzes:read"
],
"status": 403,
"title": "insufficient_scope",
"type": "https://api.octaneai.com/errors/insufficient_scope"
}

Not found

Media typeapplication/problem+json
Problem

The body of every non-2xx response.

object
detail
required
Detail

What went wrong, for people

string
errors
Any of:
Array<object>
FieldError
object
field
required
Field

The input that failed, as a dotted path (body.label, query.from)

string
message
required
Message

Why it failed

string
export
Any of:
object
key
additional properties
any
request_id
required
Request Id

The same value as the Request-Id header; quote it to support

string
required
Any of:
Array<string>
retry_after
Any of:
integer
status
required
Status

The HTTP status of the response

integer
title
required
Title

The machine-readable error code

string
type
required
Type

A stable URI naming the error, on this API’s public host

string
Example
{
"detail": "Not found",
"request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": 404,
"title": "not_found",
"type": "https://api.octaneai.com/errors/not_found"
}

A request parameter is invalid.

Media typeapplication/problem+json
Problem

The body of every non-2xx response.

object
detail
required
Detail

What went wrong, for people

string
errors
Any of:
Array<object>
FieldError
object
field
required
Field

The input that failed, as a dotted path (body.label, query.from)

string
message
required
Message

Why it failed

string
export
Any of:
object
key
additional properties
any
request_id
required
Request Id

The same value as the Request-Id header; quote it to support

string
required
Any of:
Array<string>
retry_after
Any of:
integer
status
required
Status

The HTTP status of the response

integer
title
required
Title

The machine-readable error code

string
type
required
Type

A stable URI naming the error, on this API’s public host

string
Example
{
"detail": "A request parameter is invalid.",
"request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": 422,
"title": "validation_error",
"type": "https://api.octaneai.com/errors/validation_error"
}

The key’s or the store’s bucket is full; Retry-After says when to try again.

Media typeapplication/problem+json
Problem

The body of every non-2xx response.

object
detail
required
Detail

What went wrong, for people

string
errors
Any of:
Array<object>
FieldError
object
field
required
Field

The input that failed, as a dotted path (body.label, query.from)

string
message
required
Message

Why it failed

string
export
Any of:
object
key
additional properties
any
request_id
required
Request Id

The same value as the Request-Id header; quote it to support

string
required
Any of:
Array<string>
retry_after
Any of:
integer
status
required
Status

The HTTP status of the response

integer
title
required
Title

The machine-readable error code

string
type
required
Type

A stable URI naming the error, on this API’s public host

string
Example
{
"detail": "Too many requests",
"request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"retry_after": 1,
"status": 429,
"title": "rate_limited",
"type": "https://api.octaneai.com/errors/rate_limited"
}

Request limits could not be checked for the body, or the store’s details could not be read.

Media typeapplication/problem+json
Problem

The body of every non-2xx response.

object
detail
required
Detail

What went wrong, for people

string
errors
Any of:
Array<object>
FieldError
object
field
required
Field

The input that failed, as a dotted path (body.label, query.from)

string
message
required
Message

Why it failed

string
export
Any of:
object
key
additional properties
any
request_id
required
Request Id

The same value as the Request-Id header; quote it to support

string
required
Any of:
Array<string>
retry_after
Any of:
integer
status
required
Status

The HTTP status of the response

integer
title
required
Title

The machine-readable error code

string
type
required
Type

A stable URI naming the error, on this API’s public host

string
Examples
{
"detail": "A backing service is temporarily unavailable; retry shortly",
"request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"retry_after": 2,
"status": 503,
"title": "dependency_unavailable",
"type": "https://api.octaneai.com/errors/dependency_unavailable"
}

The request timed out.

Media typeapplication/problem+json
Problem

The body of every non-2xx response.

object
detail
required
Detail

What went wrong, for people

string
errors
Any of:
Array<object>
FieldError
object
field
required
Field

The input that failed, as a dotted path (body.label, query.from)

string
message
required
Message

Why it failed

string
export
Any of:
object
key
additional properties
any
request_id
required
Request Id

The same value as the Request-Id header; quote it to support

string
required
Any of:
Array<string>
retry_after
Any of:
integer
status
required
Status

The HTTP status of the response

integer
title
required
Title

The machine-readable error code

string
type
required
Type

A stable URI naming the error, on this API’s public host

string
Example
{
"detail": "The request timed out.",
"request_id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": 504,
"title": "timeout",
"type": "https://api.octaneai.com/errors/timeout"
}