GET /v1/survey_cycles — List the Cycles of a Recurring Survey
List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0.
Planned for Export API v1.4.0 — not yet available on api.honestly.com. Documented here so you can plan your integration. Watch Versioning for the release.
A recurring survey runs in cycles — each cycle opens, collects responses, and closes. This endpoint lists those cycles with their exact boundaries, so you can align an export to the periods your survey actually ran in rather than to arbitrary calendar dates.This is what makes a like-for-like period comparison possible: pass one cycle’s boundaries to /v1/scores, then the previous cycle’s.
Endpoint
GET https://api.honestly.com/v1/survey_cycles
Query Parameters
integer
Return only cycles of this survey. Survey IDs come from /v1/surveys. Omit to list cycles of every survey in the account.
integer
Maximum number of cycles to return per page. Accepts values from 0 to 1000. Defaults to 100.
integer
Number of cycles to skip before returning results. Defaults to 0.
Total number of cycles matching the filter, for pagination.
array
Show cycle
string
Cycle UUID. Pass it as survey_cycle_ids to /v1/text_responses to export one cycle’s free-text answers. It also identifies the cycle in the participation breakdown returned by /v1/scores.
integer
ID of the survey this cycle belongs to, matching /v1/surveys.
string
RFC 3339 datetime in UTC when the cycle opened.
string | null
RFC 3339 datetime in UTC when the cycle closed. null means the cycle is still open.
string
The survey’s configured timezone, for rendering local dates. Timestamps themselves are always UTC.
Cycles are returned newest first.
Comparing a score to the previous period
Read the cycles, then call /v1/scores once per cycle using its boundaries:
There is no built-in comparison endpoint, because “previous period” means different things in different reports — the previous cycle, the same quarter a year earlier, a fixed baseline. Two calls cost one extra round trip and let you compare anything to anything.Each call is anonymity-checked independently, so a comparison can legitimately return a number for one period and a suppressed value for the other.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Honestly","colors":{"primary":"#2b7a73","light":"#5cb0a7","dark":"#1f5f59"},"logo":{"light":"https://mintcdn.com/honestly/BkkEjewk45IYUeOR/images/logo/honestly.svg?fit=max\u0026auto=format\u0026n=BkkEjewk45IYUeOR\u0026q=85\u0026s=fb54c4a490fa7945fcc35f39206832ce","dark":"https://mintcdn.com/honestly/BkkEjewk45IYUeOR/images/logo/honestly-white.svg?fit=max\u0026auto=format\u0026n=BkkEjewk45IYUeOR\u0026q=85\u0026s=6656c4b3a53579344ed0ef1d1ace7bca"},"favicon":"https://mintcdn.com/honestly/B-Ykoogmlc4ptiuo/favicon.svg?fit=max\u0026auto=format\u0026n=B-Ykoogmlc4ptiuo\u0026q=85\u0026s=fc4c58d62e70454736c56887117d27cd","footer":{"socials":{"website":"https://www.honestly.com"}},"fonts":{"heading":{"family":"Bricolage Grotesque"},"body":{"family":"Hanken Grotesk"}},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","navbar":{"links":[{"href":"https://share.hsforms.com/1OdBSP16kRFmVS8Q-XaKEeA2b9g8","label":"Contact support"}],"primary":{"type":"button","label":"Go to Honestly","href":"https://webapp.honestly.de/"}},"href":""},{"language":"de","navbar":{"links":[{"href":"https://share.hsforms.com/1j0iwk_7BQt-obdHPoiqzcQ2b9g8","label":"Support kontaktieren"}],"primary":{"type":"button","label":"Zu Honestly","href":"https://webapp.honestly.de/"}},"href":"de"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"honestly","hasAudioNarration":false,"actualSubdomain":"honestly","customDomains":["help.honestly.com"],"gitSource":{"type":"github","owner":"honestly-com","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6b00421a2232714be2014fdb","clientVersion":"0.0.4248","searchFilterCounts":[{"language":"de","tag":"Using Honestly","count":162},{"language":"en","tag":"Using Honestly","count":161},{"language":"de","tag":"Feedback erfassen","count":55},{"language":"en","tag":"Collecting feedback","count":55},{"language":"de","tag":"Umfragen","count":46},{"language":"en","tag":"Surveys","count":46},{"language":"de","tag":"Auswerten \u0026 handeln","count":36},{"language":"de","tag":"Verwaltung","count":36},{"language":"en","tag":"Analyze \u0026 act","count":36},{"language":"en","tag":"Administration","count":36},{"language":"de","tag":"Dashboard","count":31},{"language":"en","tag":"Dashboard","count":31},{"language":"de","tag":"Mitarbeitende","count":20},{"language":"en","tag":"Employees","count":20},{"language":"de","tag":"Grundlagen","count":18},{"language":"de","tag":"Hilfe \u0026 Updates","count":17},{"language":"en","tag":"Getting started","count":17},{"language":"en","tag":"Help \u0026 updates","count":17},{"language":"de","tag":"FAQ","count":16},{"language":"default","tag":"Developers","count":16},{"language":"default","tag":"Developer docs","count":16},{"language":"en","tag":"FAQ","count":16},{"language":"default","tag":"API Reference","count":11},{"language":"default","tag":"Core Concepts","count":3},{"language":"default","tag":"Get Started","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":".update-meta{margin-top:-0.5rem;font-size:0.8125rem;color:inherit;opacity:0.6}.month-count{margin-top:-2.1rem;text-align:right;font-size:0.8125rem;color:inherit;opacity:0.6}html[data-current-path$=\"/whats-new/highlights\"] li.toc-item[data-depth]:not([data-depth=\"0\"]){display:none}html[data-current-path$=\"/whats-new/highlights\"] .card h4{position:relative;margin-top:0;margin-bottom:0}html[data-current-path$=\"/whats-new/highlights\"] .card h4>div{position:static;order:1;display:flex;align-items:center;align-self:center}html[data-current-path$=\"/whats-new/highlights\"] .card h4 a{margin-left:0.4rem}html[data-current-path$=\"/whats-new/highlights\"] .anchor-copied{margin-left:0.4rem;align-self:center;font-size:0.75rem;font-weight:400;color:inherit;opacity:0.6;white-space:nowrap}"}]}
{"page":{"pagePath":"developers/api-reference/survey-cycles","slug":"/developers/api-reference/survey-cycles","pageMetadata":{"title":"GET /v1/survey_cycles — List the Cycles of a Recurring Survey","sidebarTitle":"Survey Cycles","description":"List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0.","href":"/developers/api-reference/survey-cycles"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,Note,ParamField,ResponseField,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Warning,{children:_jsxs(_components.p,{children:[`Planned for Export API v1.4.0 — not yet available on `,_jsx(_components.code,{children:`api.honestly.com`}),`. Documented here so you can plan your integration. Watch `,_jsx(_components.a,{href:`/developers/concepts/versioning`,children:`Versioning`}),` for the release.`]})}),`\n`,_jsxs(_components.p,{children:[`A recurring survey runs in `,_jsx(_components.strong,{children:`cycles`}),` — each cycle opens, collects responses, and closes. This endpoint lists those cycles with their exact boundaries, so you can align an export to the periods your survey actually ran in rather than to arbitrary calendar dates.`]}),`\n`,_jsxs(_components.p,{children:[`This is what makes a like-for-like period comparison possible: pass one cycle’s boundaries to `,_jsx(_components.a,{href:`/developers/api-reference/scores`,children:_jsx(_components.code,{children:`/v1/scores`})}),`, then the previous cycle’s.`]}),`\n`,_jsx(Heading,{level:`2`,id:`endpoint`,children:`Endpoint`}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`GET https://api.honestly.com/v1/survey_cycles`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`survey_id`,type:`integer`,id:`param-survey-id`,children:_jsxs(_components.p,{children:[`Return only cycles of this survey. Survey IDs come from `,_jsx(_components.a,{href:`/developers/api-reference/surveys`,children:_jsx(_components.code,{children:`/v1/surveys`})}),`. Omit to list cycles of every survey in the account.`]})}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,id:`param-limit`,children:_jsxs(_components.p,{children:[`Maximum number of cycles to return per page. Accepts values from `,_jsx(_components.code,{children:`0`}),` to `,_jsx(_components.code,{children:`1000`}),`. Defaults to `,_jsx(_components.code,{children:`100`}),`.`]})}),`\n`,_jsx(ParamField,{query:`offset`,type:`integer`,id:`param-offset`,children:_jsxs(_components.p,{children:[`Number of cycles to skip before returning results. Defaults to `,_jsx(_components.code,{children:`0`}),`.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`example-request`,children:`Example Request`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -G`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.honestly.com/v1/survey_cycles\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Api-Key: YOUR_SECRET_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"survey_id=17\"`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`example-response`,children:`Example Response`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`19`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`19`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total_count\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"cycles\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"9f1c8a52-2b7d-4f3e-9d21-0c5a7e4b1f88\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"survey_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`17`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"opened_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-04-01T06:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"closed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timezone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Europe/Berlin\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"7b3a1e04-6c92-4a1b-8f75-3d2e9a6c04b1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"survey_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`17`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"opened_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-01-01T06:00:00Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"closed_at\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-01-14T21:59:59Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"timezone\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Europe/Berlin\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsx(ResponseField,{name:`total_count`,type:`integer`,id:`param-total-count`,children:_jsx(_components.p,{children:`Total number of cycles matching the filter, for pagination.`})}),`\n`,_jsx(ResponseField,{name:`cycles`,type:`array`,id:`param-cycles`,children:_jsxs(Expandable,{title:`cycle`,children:[_jsx(ResponseField,{name:`id`,type:`string`,id:`param-id`,children:_jsxs(_components.p,{children:[`Cycle UUID. Pass it as `,_jsx(_components.code,{children:`survey_cycle_ids`}),` to `,_jsx(_components.a,{href:`/developers/api-reference/text-responses`,children:_jsx(_components.code,{children:`/v1/text_responses`})}),` to export one cycle’s free-text answers. It also identifies the cycle in the `,_jsx(_components.a,{href:`/developers/api-reference/scores#participation-rate`,children:`participation breakdown`}),` returned by `,_jsx(_components.code,{children:`/v1/scores`}),`.`]})}),_jsx(ResponseField,{name:`survey_id`,type:`integer`,id:`param-survey-id-1`,children:_jsxs(_components.p,{children:[`ID of the survey this cycle belongs to, matching `,_jsx(_components.a,{href:`/developers/api-reference/surveys`,children:_jsx(_components.code,{children:`/v1/surveys`})}),`.`]})}),_jsx(ResponseField,{name:`opened_at`,type:`string`,id:`param-opened-at`,children:_jsx(_components.p,{children:`RFC 3339 datetime in UTC when the cycle opened.`})}),_jsx(ResponseField,{name:`closed_at`,type:`string | null`,id:`param-closed-at`,children:_jsxs(_components.p,{children:[`RFC 3339 datetime in UTC when the cycle closed. `,_jsx(_components.code,{children:`null`}),` means the cycle is still open.`]})}),_jsx(ResponseField,{name:`timezone`,type:`string`,id:`param-timezone`,children:_jsx(_components.p,{children:`The survey’s configured timezone, for rendering local dates. Timestamps themselves are always UTC.`})})]})}),`\n`,_jsx(_components.p,{children:`Cycles are returned newest first.`}),`\n`,_jsx(Heading,{level:`2`,id:`comparing-a-score-to-the-previous-period`,children:`Comparing a score to the previous period`}),`\n`,_jsxs(_components.p,{children:[`Read the cycles, then call `,_jsx(_components.a,{href:`/developers/api-reference/scores`,children:_jsx(_components.code,{children:`/v1/scores`})}),` once per cycle using its boundaries:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`15`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# current cycle`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -G`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.honestly.com/v1/scores\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Api-Key: YOUR_SECRET_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"question_ids=121\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"survey_ids=17\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"period_from=2026-04-01T06:00:00Z\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"period_to=2026-04-14T21:59:59Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# previous cycle`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -G`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.honestly.com/v1/scores\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"X-Api-Key: YOUR_SECRET_API_KEY\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"question_ids=121\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"survey_ids=17\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"period_from=2026-01-01T06:00:00Z\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --data-urlencode`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"period_to=2026-01-14T21:59:59Z\"`})]}),`\n`]})})}),`\n`,_jsxs(Note,{children:[_jsx(_components.p,{children:`There is no built-in comparison endpoint, because “previous period” means different things in different reports — the previous cycle, the same quarter a year earlier, a fixed baseline. Two calls cost one extra round trip and let you compare anything to anything.`}),_jsx(_components.p,{children:`Each call is anonymity-checked independently, so a comparison can legitimately return a number for one period and a suppressed value for the other.`})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"GET /v1/survey_cycles — List the Cycles of a Recurring Survey","sidebarTitle":"Survey Cycles","description":"List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0.","href":"/developers/api-reference/survey-cycles"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Endpoint","slug":"endpoint","depth":2,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Example Request","slug":"example-request","depth":2,"children":[]},{"title":"Example Response","slug":"example-response","depth":2,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":2,"children":[]},{"title":"Comparing a score to the previous period","slug":"comparing-a-score-to-the-previous-period","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/honestly/2e40997da2022c0c/frank.js","/_mintlify/custom/honestly/828ee994b07ee804/language-redirect.js","/_mintlify/custom/honestly/a2c539a43086b1e9/highlight-anchor-copy.js"],"subdomain":"honestly","siteName":"Honestly","title":"GET /v1/survey_cycles — List the Cycles of a Recurring Survey - Honestly","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/developers/api-reference/survey-cycles","matchLevel":0},"de":{"href":"/developers/api-reference/survey-cycles","matchLevel":0}}},"lastModified":"2026-08-11T14:51:12.060Z","originalFileLocation":"developers/api-reference/survey-cycles.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Honestly\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"GET /v1/survey_cycles — List the Cycles of a Recurring Survey - Honestly\">\u003cmeta data-mint-head property=\"og:description\" content=\"List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Honestly\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://help.honestly.com/developers/api-reference/survey-cycles\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://honestly.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=GET+%2Fv1%2Fsurvey_cycles+%E2%80%94+List+the+Cycles+of+a+Recurring+Survey\u0026amp;description=List+the+open+and+closed+cycles+of+a+recurring+survey%2C+with+their+exact+start+and+end+dates%2C+to+compare+engagement+scores+across+periods.+Planned+for+Export+API\u0026amp;theme=2181f5f021c2b5c78cf6ece0\u0026amp;signature=318d3436d36c11aebf738c04b736b0389f7e224dcb89d35171521bf9f2b995d8\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"GET /v1/survey_cycles — List the Cycles of a Recurring Survey - Honestly\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://honestly.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=GET+%2Fv1%2Fsurvey_cycles+%E2%80%94+List+the+Cycles+of+a+Recurring+Survey\u0026amp;description=List+the+open+and+closed+cycles+of+a+recurring+survey%2C+with+their+exact+start+and+end+dates%2C+to+compare+engagement+scores+across+periods.+Planned+for+Export+API\u0026amp;theme=2181f5f021c2b5c78cf6ece0\u0026amp;signature=318d3436d36c11aebf738c04b736b0389f7e224dcb89d35171521bf9f2b995d8\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/honestly/PsVfD-T-mbmayU-9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Honestly\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2b7a73\">\u003clink data-mint-head rel=\"canonical\" href=\"https://help.honestly.com/developers/api-reference/survey-cycles\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/developers/api-reference/survey-cycles.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://help.honestly.com/#organization\",\"name\":\"Honestly\",\"url\":\"https://help.honestly.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/honestly/BkkEjewk45IYUeOR/images/logo/honestly.svg?fit=max\u0026auto=format\u0026n=BkkEjewk45IYUeOR\u0026q=85\u0026s=fb54c4a490fa7945fcc35f39206832ce\"}},{\"@type\":\"WebSite\",\"@id\":\"https://help.honestly.com#website\",\"name\":\"Honestly\",\"url\":\"https://help.honestly.com\",\"publisher\":{\"@id\":\"https://help.honestly.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://help.honestly.com/developers/api-reference/survey-cycles#webpage\",\"url\":\"https://help.honestly.com/developers/api-reference/survey-cycles\",\"name\":\"GET /v1/survey_cycles — List the Cycles of a Recurring Survey\",\"description\":\"List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0.\",\"dateModified\":\"2026-08-11T14:51:12.060Z\",\"isPartOf\":{\"@id\":\"https://help.honestly.com#website\"},\"breadcrumb\":{\"@id\":\"https://help.honestly.com/developers/api-reference/survey-cycles#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://help.honestly.com/developers/api-reference/survey-cycles#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Developer docs\",\"item\":\"https://help.honestly.com/developers/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://help.honestly.com/developers/api-reference/overview\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"GET /v1/survey_cycles — List the Cycles of a Recurring Survey\",\"item\":\"https://help.honestly.com/developers/api-reference/survey-cycles\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://help.honestly.com/developers/api-reference/survey-cycles#article\",\"headline\":\"GET /v1/survey_cycles — List the Cycles of a Recurring Survey\",\"name\":\"GET /v1/survey_cycles — List the Cycles of a Recurring Survey\",\"description\":\"List the open and closed cycles of a recurring survey, with their exact start and end dates, to compare engagement scores across periods. Planned for Export API v1.4.0.\",\"url\":\"https://help.honestly.com/developers/api-reference/survey-cycles\",\"mainEntityOfPage\":{\"@id\":\"https://help.honestly.com/developers/api-reference/survey-cycles#webpage\"},\"dateModified\":\"2026-08-11T14:51:12.060Z\",\"publisher\":{\"@id\":\"https://help.honestly.com/#organization\"},\"isPartOf\":{\"@id\":\"https://help.honestly.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Honestly\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Honestly\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/developers/api-reference/survey-cycles.md","siteName":"Honestly","nav":{"global":null,"languages":[{"language":"en","navbar":{"links":[{"href":"https://share.hsforms.com/1OdBSP16kRFmVS8Q-XaKEeA2b9g8","label":"Contact support"}],"primary":{"type":"button","label":"Go to Honestly","href":"https://webapp.honestly.de/"}},"tabs":[{"tab":"Using Honestly","pages":[{"title":"Using Honestly","href":""}]},{"tab":"Developers","groups":[{"group":"Developer docs","pages":[{"group":"Get Started","icon":"circle-play","expanded":true,"pages":[{"title":"Honestly Export API: What You Can Export","sidebarTitle":"Introduction","href":"/developers/introduction"},{"title":"Honestly Export API: Authentication and API Keys","sidebarTitle":"Authentication","href":"/developers/authentication"},{"title":"Honestly Export API: Make Your First API Call","sidebarTitle":"Quickstart","href":"/developers/quickstart"}]},{"group":"Core Concepts","icon":"book-open","expanded":true,"pages":[{"title":"How to Paginate Results in the Honestly Export API","sidebarTitle":"Pagination","href":"/developers/concepts/pagination"},{"title":"How to Handle API Errors in the Honestly Export API","sidebarTitle":"Error Handling","href":"/developers/concepts/error-handling"},{"title":"API Versioning and Backward Compatibility Guarantees","sidebarTitle":"Versioning","href":"/developers/concepts/versioning"}]},{"group":"API Reference","icon":"code","expanded":true,"pages":[{"title":"Honestly Export API v1.3.0 — Full Reference Guide","sidebarTitle":"Overview","href":"/developers/api-reference/overview"},{"title":"GET /v1/surveys — List and Filter Surveys by Status","sidebarTitle":"Surveys","href":"/developers/api-reference/surveys"},{"title":"GET /v1/questions — List and Filter Survey Questions","sidebarTitle":"Questions","href":"/developers/api-reference/questions"},{"title":"GET /v1/employees — Export and List Employee Records","sidebarTitle":"Employees","href":"/developers/api-reference/employees"},{"title":"GET /v1/survey_assignments — List Survey Assignments","sidebarTitle":"Survey Assignments","href":"/developers/api-reference/survey-assignments"},{"title":"GET /v1/scores — Retrieve Aggregated Engagement Scores","sidebarTitle":"Scores","href":"/developers/api-reference/scores"},{"title":"GET /v1/initiatives — List Initiatives (Action Items)","sidebarTitle":"Initiatives","href":"/developers/api-reference/initiatives"},{"title":"GET /v1/attributes — List Employee Attributes and Their Options","sidebarTitle":"Attributes","description":"List the employee attributes released for API use and their options, to filter and group engagement scores by cohort. Planned for Export API v1.4.0.","href":"/developers/api-reference/attributes"},{"title":"GET /v1/survey_cycles — List the Cycles of a Recurring Survey","sidebarTitle":"Survey Cycles","href":"/developers/api-reference/survey-cycles"},{"title":"GET /v1/text_responses — Export Free-Text Survey Answers","sidebarTitle":"Text Responses","description":"Export the free-text answers to open questions with their topics and per-topic sentiment, filtered by survey or survey cycle. Anonymity-protected, with optional PII masking. Planned for Export API v1.4.0.","href":"/developers/api-reference/text-responses"},{"title":"POST /v1/employees/imports — Import Employees","sidebarTitle":"Employee Import","href":"/developers/api-reference/employee-import"}]}]}]}]},{"language":"de","navbar":{"links":[{"href":"https://share.hsforms.com/1j0iwk_7BQt-obdHPoiqzcQ2b9g8","label":"Support kontaktieren"}],"primary":{"type":"button","label":"Zu Honestly","href":"https://webapp.honestly.de/"}},"tabs":[{"tab":"Using Honestly","pages":[{"title":"Using Honestly","href":"/de"}]},{"tab":"Developers","groups":[{"group":"Developer docs","pages":[{"group":"Get Started","icon":"circle-play","expanded":true,"pages":[{"title":"Honestly Export API: Was du exportieren kannst","sidebarTitle":"Einführung","href":"/de/developers/introduction"},{"title":"Honestly Export API: Authentication and API Keys","sidebarTitle":"Authentication","href":"/developers/authentication"},{"title":"Honestly Export API: Make Your First API Call","sidebarTitle":"Quickstart","href":"/developers/quickstart"}]},{"group":"Core Concepts","icon":"book-open","expanded":true,"pages":[{"title":"How to Paginate Results in the Honestly Export API","sidebarTitle":"Pagination","href":"/developers/concepts/pagination"},{"title":"How to Handle API Errors in the Honestly Export API","sidebarTitle":"Error Handling","href":"/developers/concepts/error-handling"},{"title":"API Versioning and Backward Compatibility Guarantees","sidebarTitle":"Versioning","href":"/developers/concepts/versioning"}]},{"group":"API Reference","icon":"code","expanded":true,"pages":[{"title":"Honestly Export API v1.3.0 — Full Reference Guide","sidebarTitle":"Overview","href":"/developers/api-reference/overview"},{"title":"GET /v1/surveys — List and Filter Surveys by Status","sidebarTitle":"Surveys","href":"/developers/api-reference/surveys"},{"title":"GET /v1/questions — List and Filter Survey Questions","sidebarTitle":"Questions","href":"/developers/api-reference/questions"},{"title":"GET /v1/employees — Export and List Employee Records","sidebarTitle":"Employees","href":"/developers/api-reference/employees"},{"title":"GET /v1/survey_assignments — List Survey Assignments","sidebarTitle":"Survey Assignments","href":"/developers/api-reference/survey-assignments"},{"title":"GET /v1/scores — Retrieve Aggregated Engagement Scores","sidebarTitle":"Scores","href":"/developers/api-reference/scores"},{"title":"GET /v1/initiatives — List Initiatives (Action Items)","sidebarTitle":"Initiatives","href":"/developers/api-reference/initiatives"},{"title":"GET /v1/attributes — List Employee Attributes and Their Options","sidebarTitle":"Attributes","description":"List the employee attributes released for API use and their options, to filter and group engagement scores by cohort. Planned for Export API v1.4.0.","href":"/developers/api-reference/attributes"},{"title":"GET /v1/survey_cycles — List the Cycles of a Recurring Survey","sidebarTitle":"Survey Cycles","href":"/developers/api-reference/survey-cycles"},{"title":"GET /v1/text_responses — Export Free-Text Survey Answers","sidebarTitle":"Text Responses","description":"Export the free-text answers to open questions with their topics and per-topic sentiment, filtered by survey or survey cycle. Anonymity-protected, with optional PII masking. Planned for Export API v1.4.0.","href":"/developers/api-reference/text-responses"},{"title":"POST /v1/employees/imports — Import Employees","sidebarTitle":"Employee Import","href":"/developers/api-reference/employee-import"}]}]}]}]}]},"basePath":"","title":"GET /v1/survey_cycles — List the Cycles of a Recurring Survey - Honestly","deploymentId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","buildId":"dpl_2pTxFtyBudBMYZiCw1MyvoA1wxpd","dynamics":[],"chunks":[]}