curl "https://api.shortkit.dev/v1/surveys/d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a" \
-H "Authorization: Bearer sk_live_your_secret_key"
import requests
resp = requests.get(
"https://api.shortkit.dev/v1/surveys/d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
headers={"Authorization": "Bearer sk_live_your_secret_key"},
)
survey = resp.json()["data"]
const resp = await fetch(
"https://api.shortkit.dev/v1/surveys/d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
{
headers: { Authorization: "Bearer sk_live_your_secret_key" },
}
);
const { data: survey } = 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" },
{ "id": "c3d4e5f6-...", "text": "Friend", "position": 2, "responseCount": 15, "createdAt": "2026-02-10T09:00:00Z" }
],
"placementRules": [
{ "id": "e5f6a7b8-...", "ruleType": "min_videos_before", "ruleValue": { "n": 3 }, "createdAt": "2026-02-10T09:00:00Z" },
{ "id": "f6a7b8c9-...", "ruleType": "once_per_user", "ruleValue": {}, "createdAt": "2026-02-10T09:00:00Z" }
],
"totalResponses": 85,
"createdAt": "2026-02-10T09:00:00Z",
"updatedAt": "2026-02-12T14:30:00Z"
},
"meta": {
"request_id": "req_srv003"
}
}
Surveys
Get Survey
Retrieve a single survey by ID, including options, placement rules, and response counts.
GET
/
v1
/
surveys
/
{id}
curl "https://api.shortkit.dev/v1/surveys/d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a" \
-H "Authorization: Bearer sk_live_your_secret_key"
import requests
resp = requests.get(
"https://api.shortkit.dev/v1/surveys/d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
headers={"Authorization": "Bearer sk_live_your_secret_key"},
)
survey = resp.json()["data"]
const resp = await fetch(
"https://api.shortkit.dev/v1/surveys/d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
{
headers: { Authorization: "Bearer sk_live_your_secret_key" },
}
);
const { data: survey } = 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" },
{ "id": "c3d4e5f6-...", "text": "Friend", "position": 2, "responseCount": 15, "createdAt": "2026-02-10T09:00:00Z" }
],
"placementRules": [
{ "id": "e5f6a7b8-...", "ruleType": "min_videos_before", "ruleValue": { "n": 3 }, "createdAt": "2026-02-10T09:00:00Z" },
{ "id": "f6a7b8c9-...", "ruleType": "once_per_user", "ruleValue": {}, "createdAt": "2026-02-10T09:00:00Z" }
],
"totalResponses": 85,
"createdAt": "2026-02-10T09:00:00Z",
"updatedAt": "2026-02-12T14:30:00Z"
},
"meta": {
"request_id": "req_srv003"
}
}
Path parameters
string
required
Survey UUID.
curl "https://api.shortkit.dev/v1/surveys/d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a" \
-H "Authorization: Bearer sk_live_your_secret_key"
import requests
resp = requests.get(
"https://api.shortkit.dev/v1/surveys/d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
headers={"Authorization": "Bearer sk_live_your_secret_key"},
)
survey = resp.json()["data"]
const resp = await fetch(
"https://api.shortkit.dev/v1/surveys/d4e5f6a7-b8c9-4d0e-1f2a-3b4c5d6e7f8a",
{
headers: { Authorization: "Bearer sk_live_your_secret_key" },
}
);
const { data: survey } = 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" },
{ "id": "c3d4e5f6-...", "text": "Friend", "position": 2, "responseCount": 15, "createdAt": "2026-02-10T09:00:00Z" }
],
"placementRules": [
{ "id": "e5f6a7b8-...", "ruleType": "min_videos_before", "ruleValue": { "n": 3 }, "createdAt": "2026-02-10T09:00:00Z" },
{ "id": "f6a7b8c9-...", "ruleType": "once_per_user", "ruleValue": {}, "createdAt": "2026-02-10T09:00:00Z" }
],
"totalResponses": 85,
"createdAt": "2026-02-10T09:00:00Z",
"updatedAt": "2026-02-12T14:30:00Z"
},
"meta": {
"request_id": "req_srv003"
}
}
404 if the survey does not exist or does not belong to your organization.