curl "https://api.shortkit.dev/v1/surveys?status=active" \
-H "Authorization: Bearer sk_live_your_secret_key"
import requests
resp = requests.get(
"https://api.shortkit.dev/v1/surveys",
headers={"Authorization": "Bearer sk_live_your_secret_key"},
params={"status": "active"},
)
surveys = resp.json()["data"]
const resp = await fetch(
"https://api.shortkit.dev/v1/surveys?status=active",
{
headers: { Authorization: "Bearer sk_live_your_secret_key" },
}
);
const { data: surveys } = await resp.json();
{
"data": [
{
"id": "d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
"title": "Content Discovery",
"question": "How did you discover this content?",
"status": "active",
"priority": 10,
"autoAdvanceDelay": 3.0,
"options": [
{ "id": "a1b2c3d4-...", "text": "Social media", "position": 0, "responseCount": 42, "createdAt": "2026-02-10T09:00:00Z" },
{ "id": "b2c3d4e5-...", "text": "Search", "position": 1, "responseCount": 28, "createdAt": "2026-02-10T09:00:00Z" }
],
"placementRules": [
{ "id": "e5f6a7b8-...", "ruleType": "min_videos_before", "ruleValue": { "n": 3 }, "createdAt": "2026-02-10T09:00:00Z" }
],
"totalResponses": 70,
"createdAt": "2026-02-10T09:00:00Z",
"updatedAt": "2026-02-12T14:30:00Z"
}
],
"meta": {
"request_id": "req_srv002"
}
}
Surveys
List Surveys
Returns all surveys in your organization, ordered by priority.
GET
/
v1
/
surveys
curl "https://api.shortkit.dev/v1/surveys?status=active" \
-H "Authorization: Bearer sk_live_your_secret_key"
import requests
resp = requests.get(
"https://api.shortkit.dev/v1/surveys",
headers={"Authorization": "Bearer sk_live_your_secret_key"},
params={"status": "active"},
)
surveys = resp.json()["data"]
const resp = await fetch(
"https://api.shortkit.dev/v1/surveys?status=active",
{
headers: { Authorization: "Bearer sk_live_your_secret_key" },
}
);
const { data: surveys } = await resp.json();
{
"data": [
{
"id": "d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
"title": "Content Discovery",
"question": "How did you discover this content?",
"status": "active",
"priority": 10,
"autoAdvanceDelay": 3.0,
"options": [
{ "id": "a1b2c3d4-...", "text": "Social media", "position": 0, "responseCount": 42, "createdAt": "2026-02-10T09:00:00Z" },
{ "id": "b2c3d4e5-...", "text": "Search", "position": 1, "responseCount": 28, "createdAt": "2026-02-10T09:00:00Z" }
],
"placementRules": [
{ "id": "e5f6a7b8-...", "ruleType": "min_videos_before", "ruleValue": { "n": 3 }, "createdAt": "2026-02-10T09:00:00Z" }
],
"totalResponses": 70,
"createdAt": "2026-02-10T09:00:00Z",
"updatedAt": "2026-02-12T14:30:00Z"
}
],
"meta": {
"request_id": "req_srv002"
}
}
Query parameters
string
Filter by status:
draft, active, paused, or archived.curl "https://api.shortkit.dev/v1/surveys?status=active" \
-H "Authorization: Bearer sk_live_your_secret_key"
import requests
resp = requests.get(
"https://api.shortkit.dev/v1/surveys",
headers={"Authorization": "Bearer sk_live_your_secret_key"},
params={"status": "active"},
)
surveys = resp.json()["data"]
const resp = await fetch(
"https://api.shortkit.dev/v1/surveys?status=active",
{
headers: { Authorization: "Bearer sk_live_your_secret_key" },
}
);
const { data: surveys } = await resp.json();
{
"data": [
{
"id": "d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
"title": "Content Discovery",
"question": "How did you discover this content?",
"status": "active",
"priority": 10,
"autoAdvanceDelay": 3.0,
"options": [
{ "id": "a1b2c3d4-...", "text": "Social media", "position": 0, "responseCount": 42, "createdAt": "2026-02-10T09:00:00Z" },
{ "id": "b2c3d4e5-...", "text": "Search", "position": 1, "responseCount": 28, "createdAt": "2026-02-10T09:00:00Z" }
],
"placementRules": [
{ "id": "e5f6a7b8-...", "ruleType": "min_videos_before", "ruleValue": { "n": 3 }, "createdAt": "2026-02-10T09:00:00Z" }
],
"totalResponses": 70,
"createdAt": "2026-02-10T09:00:00Z",
"updatedAt": "2026-02-12T14:30:00Z"
}
],
"meta": {
"request_id": "req_srv002"
}
}
priority descending. Each survey includes response counts per option and totalResponses.