Get survey details
Retrieve a specific survey by ID, including questions and delivery instances. Only accessible if the user is an admin of the survey.
Authorizations
API key for authentication. Generate keys in the Doozy dashboard.
Path Parameters
The unique identifier of the survey
1 - 128^[A-Za-z0-9_-]+$"survey_abc123"
Response
Survey details with questions and instances
Object type identifier
survey "survey"
Unique survey identifier
"survey_abc123"
Survey title
"Employee Satisfaction Survey"
Survey description
"Monthly check-in on team satisfaction"
Survey mode (poll or survey)
poll, survey "survey"
How responses are collected
anonymous, user "anonymous"
Who can view results
owner, everyone "owner"
Current survey status
draft, scheduled, archived "scheduled"
Monotonic version number, incremented on each publish. 0 before the first publish — a never-published eager draft, which clients open directly in the editor rather than the detail page.
x >= 03
Number of questions in the survey
5
Time limit in minutes for completing the survey (null for no limit)
x >= 130
Track reference if survey belongs to a track
Delivery instances of this survey
When the survey was created (ISO 8601 format)
"2026-01-15T10:30:00.000Z"
When the survey was last updated (ISO 8601 format)
"2026-01-20T14:00:00.000Z"
What the requesting user can do with this survey (edit, pause, resume, delete, activate, manage admins). Use these to drive UI affordances.
Who, beyond the survey's admins, can see an individual's responses in the People view. Null means owner only. Distinct from results_visibility.
Questions in the survey
Doozy user IDs of members who can edit this survey and view its results.
Active collaborative draft id. Clients connect their Yjs provider to /surveys/{id}/drafts/{current_draft_id} to participate in realtime editing. Null only for legacy surveys created before the collaborative editor rollout — those will lazy-mint a draft on first edit.
"draft_abc123"
ISO 8601 timestamp of the most recent publish, or null if never published.
"2026-06-10T09:48:36.000Z"
Profile of the person who last published, or null.
True when the current draft has edits that diverge from the published survey.
true
ISO 8601 timestamp of the last edit to the current draft, or null.
"2026-06-10T10:15:00.000Z"
Profile of the last person to edit the current draft, or null.