Returns the catalog of questions that can be referenced from a given position in the study — with ready-to-insert {{Q:...}} templates for each. Use this endpoint to build an ”@-mention” picker or discover the exact token for one option response.Always copy the returned template into the destination question’s content. A full-answer token such as {{Q:<question_id>}} inserts the complete response. To insert one item from a structured answer, choose an entry whose kind is property.
string
required
The study ID.
string
Only return questions that appear before this question — use when editing an existing question.
integer
Only return the questions at zero-based interview positions lower than this value — use when composing a new question. Positions count questions in the order participants see them, with question groups expanded, so they match the numbers in the study editor. Ignored if before_question_id is set.
Supported question types
The following source question types can be mentioned:
textInput, shortText, number, and multipleChoice — full answer only.
matrixRatingScale — full answer or ratingForItem[index], which returns the rating for one item.
matrixSelection — full answer or selectionForItem[index], which returns the answer chosen for one row. In a translated interview, selectionForItem returns the answer label in the study’s default language.
ranking — full answer, rankOfOption[index], or optionAtRank[index].
allocation — full answer or allocationForItem[index].
cardSort — full answer, categoryForCard[index], or cardsInCategory[index].
Property indices are zero-based. For example, ratingForItem[0] selects the first entry in the matrix question’s props.options.
Property selectors are type-specific. There is no generic .option[index] selector, and multiple-choice questions expose only their full answer.
Response
ReferenceableQuestion[]
Each entry has question_id, display_order (zero-based interview position, groups expanded), type, content, a human-readable label such as Q2, and available_references.
string
fullAnswer for the complete response or property for one structured sub-answer.
string
The exact {{Q:...}} token to insert into the destination question’s content.
string | null
Type-specific selector such as ratingForItem, rankOfOption, or allocationForItem. Null for a full answer.
integer | null
Zero-based option, category, or rank-position index. Null for a full answer.
string | null
Human-readable option, category, or rank position selected by the property reference.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Versive","description":"Documentation for Versive — the AI-powered user research and testing platform","colors":{"primary":"#00786F","light":"#2BB3A8","dark":"#00786F"},"logo":{"light":"https://mintcdn.com/versive/Og7M_uVBtd7MTGJK/logo/light.svg?fit=max\u0026auto=format\u0026n=Og7M_uVBtd7MTGJK\u0026q=85\u0026s=3de4d6717f3a65645f417a61cc68828d","dark":"https://mintcdn.com/versive/Og7M_uVBtd7MTGJK/logo/dark.svg?fit=max\u0026auto=format\u0026n=Og7M_uVBtd7MTGJK\u0026q=85\u0026s=dd51cb606f5301040c8219b572a717fc","href":"https://getversive.com"},"favicon":"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026auto=format\u0026n=-C2_T5LPeZ5Csg69\u0026q=85\u0026s=ec8e3723f4e24346fcea7c20b5e480ce","api":{"mdx":{"auth":{"method":"bearer"},"server":"https://api.getversive.com/api/v1"}},"navbar":{"links":[{"href":"mailto:[email protected]","label":"Support"}],"primary":{"type":"button","label":"Open Versive","href":"https://getversive.com/login"}},"footer":{"socials":{"website":"https://getversive.com","linkedin":"https://www.linkedin.com/company/versivehq"}},"icons":{"library":"tabler"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"versive","hasAudioNarration":false,"actualSubdomain":"versive","customDomains":["docs.getversive.com"],"gitSource":{"type":"github","owner":"trymirio","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6afb8e0bc23367ba6fcedbdd","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API reference","count":47},{"language":"default","tag":"Documentation","count":27},{"language":"default","tag":"Studies","count":27},{"language":"default","tag":"AI tests","count":7},{"language":"default","tag":"Interviews","count":5},{"language":"default","tag":"Getting started","count":5},{"language":"default","tag":"Quotas","count":5},{"language":"default","tag":"Question logic","count":4},{"language":"default","tag":"Questions","count":4},{"language":"default","tag":"Randomizers","count":4}]},"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/studies/available-references","slug":"/api-reference/studies/available-references","pageMetadata":{"title":"List available references","api":"GET /studies/{study_id}/available-references","description":"Which earlier questions can be referenced from a given position","href":"/api-reference/studies/available-references"},"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: \"Which earlier questions can be referenced from a given position\"\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`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Callout,Heading,ParamField,ResponseField}=_components;if(!Callout)_missingMdxReference(`Callout`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns the catalog of questions that can be `,_jsx(_components.a,{href:`/api-reference/questions/batch-questions#question-references-mentions`,children:`referenced`}),` from a given position in the study — with ready-to-insert `,_jsx(_components.code,{children:`{{Q:...}}`}),` templates for each. Use this endpoint to build an ”@-mention” picker or discover the exact token for one option response.`]}),`\n`,_jsxs(_components.p,{children:[`Always copy the returned `,_jsx(_components.code,{children:`template`}),` into the destination question’s `,_jsx(_components.code,{children:`content`}),`. A full-answer token such as `,_jsx(_components.code,{children:`{{Q:\u003cquestion_id>}}`}),` inserts the complete response. To insert one item from a structured answer, choose an entry whose `,_jsx(_components.code,{children:`kind`}),` is `,_jsx(_components.code,{children:`property`}),`.`]}),`\n`,_jsx(ParamField,{path:`study_id`,type:`string`,required:true,id:`param-study-id`,children:_jsx(_components.p,{children:`The study ID.`})}),`\n`,_jsx(ParamField,{query:`before_question_id`,type:`string`,id:`param-before-question-id`,children:_jsxs(_components.p,{children:[`Only return questions that appear `,_jsx(_components.strong,{children:`before`}),` this question — use when editing an existing question.`]})}),`\n`,_jsx(ParamField,{query:`before_display_order`,type:`integer`,id:`param-before-display-order`,children:_jsxs(_components.p,{children:[`Only return the questions at zero-based interview positions lower than this value — use when composing a new question. Positions count questions in the order participants see them, with question groups expanded, so they match the numbers in the study editor. Ignored if `,_jsx(_components.code,{children:`before_question_id`}),` is set.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`supported-question-types`,children:`Supported question types`}),`\n`,_jsx(_components.p,{children:`The following source question types can be mentioned:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`textInput`}),`, `,_jsx(_components.code,{children:`shortText`}),`, `,_jsx(_components.code,{children:`number`}),`, and `,_jsx(_components.code,{children:`multipleChoice`}),` — full answer only.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`matrixRatingScale`}),` — full answer or `,_jsx(_components.code,{children:`ratingForItem[index]`}),`, which returns the rating for one item.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`matrixSelection`}),` — full answer or `,_jsx(_components.code,{children:`selectionForItem[index]`}),`, which returns the answer chosen for one row. In a translated interview, `,_jsx(_components.code,{children:`selectionForItem`}),` returns the answer label in the study’s default language.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ranking`}),` — full answer, `,_jsx(_components.code,{children:`rankOfOption[index]`}),`, or `,_jsx(_components.code,{children:`optionAtRank[index]`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`allocation`}),` — full answer or `,_jsx(_components.code,{children:`allocationForItem[index]`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`cardSort`}),` — full answer, `,_jsx(_components.code,{children:`categoryForCard[index]`}),`, or `,_jsx(_components.code,{children:`cardsInCategory[index]`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Property indices are `,_jsx(_components.strong,{children:`zero-based`}),`. For example, `,_jsx(_components.code,{children:`ratingForItem[0]`}),` selects the first entry in the matrix question’s `,_jsx(_components.code,{children:`props.options`}),`.`]}),`\n`,_jsx(Callout,{icon:`info-circle`,color:`#71717a`,children:_jsxs(_components.p,{children:[`Property selectors are type-specific. There is no generic `,_jsx(_components.code,{children:`.option[index]`}),` selector, and multiple-choice questions expose only their full answer.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`references`,type:`ReferenceableQuestion[]`,id:`param-references`,children:_jsxs(_components.p,{children:[`Each entry has `,_jsx(_components.code,{children:`question_id`}),`, `,_jsx(_components.code,{children:`display_order`}),` (zero-based interview position, groups expanded), `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`content`}),`, a human-readable `,_jsx(_components.code,{children:`label`}),` such as `,_jsx(_components.code,{children:`Q2`}),`, and `,_jsx(_components.code,{children:`available_references`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`available_references[].kind`,type:`string`,id:`param-available-references-kind`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`fullAnswer`}),` for the complete response or `,_jsx(_components.code,{children:`property`}),` for one structured sub-answer.`]})}),`\n`,_jsx(ResponseField,{name:`available_references[].template`,type:`string`,id:`param-available-references-template`,children:_jsxs(_components.p,{children:[`The exact `,_jsx(_components.code,{children:`{{Q:...}}`}),` token to insert into the destination question’s `,_jsx(_components.code,{children:`content`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`available_references[].property_name`,type:`string | null`,id:`param-available-references-property-name`,children:_jsxs(_components.p,{children:[`Type-specific selector such as `,_jsx(_components.code,{children:`ratingForItem`}),`, `,_jsx(_components.code,{children:`rankOfOption`}),`, or `,_jsx(_components.code,{children:`allocationForItem`}),`. Null for a full answer.`]})}),`\n`,_jsx(ResponseField,{name:`available_references[].property_index`,type:`integer | null`,id:`param-available-references-property-index`,children:_jsx(_components.p,{children:`Zero-based option, category, or rank-position index. Null for a full answer.`})}),`\n`,_jsx(ResponseField,{name:`available_references[].option`,type:`string | null`,id:`param-available-references-option`,children:_jsx(_components.p,{children:`Human-readable option, category, or rank position selected by the property reference.`})})]})}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":"List available references","api":"GET /studies/{study_id}/available-references","description":"Which earlier questions can be referenced from a given position","href":"/api-reference/studies/available-references"}}},"mdxSourceWithNoJs":{"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`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Callout,CodeBlock,Heading,ParamField,RequestExample,ResponseExample,ResponseField}=_components;if(!Callout)_missingMdxReference(`Callout`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Returns the catalog of questions that can be `,_jsx(_components.a,{href:`/api-reference/questions/batch-questions#question-references-mentions`,children:`referenced`}),` from a given position in the study — with ready-to-insert `,_jsx(_components.code,{children:`{{Q:...}}`}),` templates for each. Use this endpoint to build an ”@-mention” picker or discover the exact token for one option response.`]}),`\n`,_jsxs(_components.p,{children:[`Always copy the returned `,_jsx(_components.code,{children:`template`}),` into the destination question’s `,_jsx(_components.code,{children:`content`}),`. A full-answer token such as `,_jsx(_components.code,{children:`{{Q:\u003cquestion_id>}}`}),` inserts the complete response. To insert one item from a structured answer, choose an entry whose `,_jsx(_components.code,{children:`kind`}),` is `,_jsx(_components.code,{children:`property`}),`.`]}),`\n`,_jsx(ParamField,{path:`study_id`,type:`string`,required:true,id:`param-study-id`,children:_jsx(_components.p,{children:`The study ID.`})}),`\n`,_jsx(ParamField,{query:`before_question_id`,type:`string`,id:`param-before-question-id`,children:_jsxs(_components.p,{children:[`Only return questions that appear `,_jsx(_components.strong,{children:`before`}),` this question — use when editing an existing question.`]})}),`\n`,_jsx(ParamField,{query:`before_display_order`,type:`integer`,id:`param-before-display-order`,children:_jsxs(_components.p,{children:[`Only return the questions at zero-based interview positions lower than this value — use when composing a new question. Positions count questions in the order participants see them, with question groups expanded, so they match the numbers in the study editor. Ignored if `,_jsx(_components.code,{children:`before_question_id`}),` is set.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`supported-question-types`,children:`Supported question types`}),`\n`,_jsx(_components.p,{children:`The following source question types can be mentioned:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`textInput`}),`, `,_jsx(_components.code,{children:`shortText`}),`, `,_jsx(_components.code,{children:`number`}),`, and `,_jsx(_components.code,{children:`multipleChoice`}),` — full answer only.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`matrixRatingScale`}),` — full answer or `,_jsx(_components.code,{children:`ratingForItem[index]`}),`, which returns the rating for one item.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`matrixSelection`}),` — full answer or `,_jsx(_components.code,{children:`selectionForItem[index]`}),`, which returns the answer chosen for one row. In a translated interview, `,_jsx(_components.code,{children:`selectionForItem`}),` returns the answer label in the study’s default language.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ranking`}),` — full answer, `,_jsx(_components.code,{children:`rankOfOption[index]`}),`, or `,_jsx(_components.code,{children:`optionAtRank[index]`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`allocation`}),` — full answer or `,_jsx(_components.code,{children:`allocationForItem[index]`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`cardSort`}),` — full answer, `,_jsx(_components.code,{children:`categoryForCard[index]`}),`, or `,_jsx(_components.code,{children:`cardsInCategory[index]`}),`.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Property indices are `,_jsx(_components.strong,{children:`zero-based`}),`. For example, `,_jsx(_components.code,{children:`ratingForItem[0]`}),` selects the first entry in the matrix question’s `,_jsx(_components.code,{children:`props.options`}),`.`]}),`\n`,_jsx(Callout,{icon:`info-circle`,color:`#71717a`,children:_jsxs(_components.p,{children:[`Property selectors are type-specific. There is no generic `,_jsx(_components.code,{children:`.option[index]`}),` selector, and multiple-choice questions expose only their full answer.`]})}),`\n`,_jsx(Heading,{level:`3`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`references`,type:`ReferenceableQuestion[]`,id:`param-references`,children:_jsxs(_components.p,{children:[`Each entry has `,_jsx(_components.code,{children:`question_id`}),`, `,_jsx(_components.code,{children:`display_order`}),` (zero-based interview position, groups expanded), `,_jsx(_components.code,{children:`type`}),`, `,_jsx(_components.code,{children:`content`}),`, a human-readable `,_jsx(_components.code,{children:`label`}),` such as `,_jsx(_components.code,{children:`Q2`}),`, and `,_jsx(_components.code,{children:`available_references`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`available_references[].kind`,type:`string`,id:`param-available-references-kind`,children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`fullAnswer`}),` for the complete response or `,_jsx(_components.code,{children:`property`}),` for one structured sub-answer.`]})}),`\n`,_jsx(ResponseField,{name:`available_references[].template`,type:`string`,id:`param-available-references-template`,children:_jsxs(_components.p,{children:[`The exact `,_jsx(_components.code,{children:`{{Q:...}}`}),` token to insert into the destination question’s `,_jsx(_components.code,{children:`content`}),`.`]})}),`\n`,_jsx(ResponseField,{name:`available_references[].property_name`,type:`string | null`,id:`param-available-references-property-name`,children:_jsxs(_components.p,{children:[`Type-specific selector such as `,_jsx(_components.code,{children:`ratingForItem`}),`, `,_jsx(_components.code,{children:`rankOfOption`}),`, or `,_jsx(_components.code,{children:`allocationForItem`}),`. Null for a full answer.`]})}),`\n`,_jsx(ResponseField,{name:`available_references[].property_index`,type:`integer | null`,id:`param-available-references-property-index`,children:_jsx(_components.p,{children:`Zero-based option, category, or rank-position index. Null for a full answer.`})}),`\n`,_jsx(ResponseField,{name:`available_references[].option`,type:`string | null`,id:`param-available-references-option`,children:_jsx(_components.p,{children:`Human-readable option, category, or rank position selected by the property reference.`})}),`\n`,_jsx(RequestExample,{children:_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,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:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#8250DF`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"https://api.getversive.com/api/v1/studies/9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b/available-references?before_display_order=5\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` -H `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Authorization: Bearer $VERSIVE_API_KEY\"`})]}),`\n`]})})})}),`\n`,_jsx(ResponseExample,{children:_jsx(CodeBlock,{filename:`200`,numberOfLines:`29`,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:`29`,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:` \"references\"`}),_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:` \"question_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"matrix-q-123\"`}),_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:` \"display_order\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1`}),_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:` \"type\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"matrixRatingScale\"`}),_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:` \"content\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Rate each part of the experience\"`}),_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:` \"label\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Q2\"`}),_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:` \"available_references\"`}),_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:` \"kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"fullAnswer\"`}),_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:` \"label\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Q2\"`}),_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:` \"template\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{{Q:matrix-q-123}}\"`}),_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:` \"property_name\"`}),_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:` \"property_index\"`}),_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:` \"option\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:`null`})]}),`\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:` \"kind\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"property\"`}),_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:` \"label\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Q2.ratingForItem[1]\"`}),_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:` \"template\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"{{Q:matrix-q-123.ratingForItem[0]}}\"`}),_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:` \"property_name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"ratingForItem\"`}),_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:` \"property_index\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_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:` \"option\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Speed\"`})]}),`\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`,_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`]})})})})]})}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":"List available references","api":"GET /studies/{study_id}/available-references","description":"Which earlier questions can be referenced from a given position","href":"/api-reference/studies/available-references"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Supported question types","slug":"supported-question-types","depth":2,"children":[{"title":"Response","slug":"response","depth":3,"children":[]}]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#8250DF;--shiki-dark:#DCDCAA\">curl\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\"> \"https://api.getversive.com/api/v1/studies/9b2f7c1e-4a4b-4f6e-9a1d-1c2d3e4f5a6b/available-references?before_display_order=5\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> -H \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Authorization: Bearer $VERSIVE_API_KEY\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default dark-plus\" style=\"background-color:#ffffff;--shiki-dark-bg:#0B0C0E;color:#1f2328;--shiki-dark:#D4D4D4\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"29\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"references\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"question_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"matrix-q-123\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"display_order\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">1\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"type\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"matrixRatingScale\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"content\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Rate each part of the experience\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"label\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Q2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"available_references\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"kind\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"fullAnswer\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"label\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Q2\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"template\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"{{Q:matrix-q-123}}\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"property_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"property_index\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"option\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#569CD6\">null\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"kind\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"property\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"label\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Q2.ratingForItem[1]\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"template\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"{{Q:matrix-q-123.ratingForItem[0]}}\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"property_name\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"ratingForItem\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"property_index\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#B5CEA8\">0\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#9CDCFE\"> \"option\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#CE9178\">\"Speed\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#D4D4D4\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"List available references","path":"/studies/{study_id}/available-references","servers":[{"url":"https://api.getversive.com/api/v1"}],"method":"get","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{"before_question_id":{"schema":[{"type":"string","description":"Only return questions that appear before this question — use when editing an existing question."}]},"before_display_order":{"schema":[{"type":"integer","description":"Only return the questions at zero-based interview positions lower than this value — use when composing a new question. Positions count questions in the order participants see them, with question groups expanded, so they match the numbers in the study editor. Ignored if `before_question_id` is set."}]}},"header":{},"cookie":{},"path":{"study_id":{"schema":[{"type":"string","description":"The study ID.","required":true}]}}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"references":[{"type":"array","items":[{"type":"object","properties":{}}],"description":"Each entry has `question_id` , `display_order` (zero-based interview position, groups expanded), `type` , `content` , a human-readable `label` such as `Q2` , and `available_references` ."}],"available_references[].kind":[{"type":"string","description":"`fullAnswer` for the complete response or `property` for one structured sub-answer."}],"available_references[].template":[{"type":"string","description":"The exact `{{Q:...}}` token to insert into the destination question’s `content` ."}],"available_references[].property_name":[{"type":"object","properties":{},"description":"Type-specific selector such as `ratingForItem` , `rankOfOption` , or `allocationForItem` . Null for a full answer."}],"available_references[].property_index":[{"type":"object","properties":{},"description":"Zero-based option, category, or rank-position index. Null for a full answer."}],"available_references[].option":[{"type":"object","properties":{},"description":"Human-readable option, category, or rank position selected by the property reference."}]}}],"examples":{"example":{"value":{"references":[{}],"available_references[].kind":"\u003cstring>","available_references[].template":"\u003cstring>","available_references[].property_name":{},"available_references[].property_index":{},"available_references[].option":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"versive","siteName":"Versive","title":"List available references - Versive","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-27T21:15:18.800Z","originalFileLocation":"api-reference/studies/available-references.mdx"},"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=\"Which earlier questions can be referenced from a given position\">\u003cmeta data-mint-head name=\"application-name\" content=\"Versive\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/x-icon\" sizes=\"180x180\" href=\"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=-C2_T5LPeZ5Csg69\u0026amp;q=85\u0026amp;s=ec8e3723f4e24346fcea7c20b5e480ce\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"32x32\" href=\"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=-C2_T5LPeZ5Csg69\u0026amp;q=85\u0026amp;s=ec8e3723f4e24346fcea7c20b5e480ce\">\u003clink data-mint-head rel=\"icon\" type=\"image/x-icon\" sizes=\"16x16\" href=\"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=-C2_T5LPeZ5Csg69\u0026amp;q=85\u0026amp;s=ec8e3723f4e24346fcea7c20b5e480ce\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintcdn.com/versive/-C2_T5LPeZ5Csg69/favicon.ico?fit=max\u0026amp;auto=format\u0026amp;n=-C2_T5LPeZ5Csg69\u0026amp;q=85\u0026amp;s=ec8e3723f4e24346fcea7c20b5e480ce\">\u003cmeta data-mint-head property=\"og:title\" content=\"List available references - Versive\">\u003cmeta data-mint-head property=\"og:description\" content=\"Which earlier questions can be referenced from a given position\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Versive\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.getversive.com/api-reference/studies/available-references\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://versive.mintlify.site/_mintlify/api/og/v2?division=Studies\u0026amp;title=List+available+references\u0026amp;description=Which+earlier+questions+can+be+referenced+from+a+given+position\u0026amp;theme=320d8c7891ebe44ce8a03901\u0026amp;signature=396eae69c2d91a00be3dead604b990eb1c509a9788da6622a56d6e21071f2e42\">\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=\"List available references - Versive\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Which earlier questions can be referenced from a given position\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://versive.mintlify.site/_mintlify/api/og/v2?division=Studies\u0026amp;title=List+available+references\u0026amp;description=Which+earlier+questions+can+be+referenced+from+a+given+position\u0026amp;theme=320d8c7891ebe44ce8a03901\u0026amp;signature=396eae69c2d91a00be3dead604b990eb1c509a9788da6622a56d6e21071f2e42\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/versive/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Versive\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00786F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.getversive.com/api-reference/studies/available-references\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/studies/available-references.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.getversive.com/#organization\",\"name\":\"Versive\",\"url\":\"https://docs.getversive.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/versive/Og7M_uVBtd7MTGJK/logo/light.svg?fit=max\u0026auto=format\u0026n=Og7M_uVBtd7MTGJK\u0026q=85\u0026s=3de4d6717f3a65645f417a61cc68828d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.getversive.com#website\",\"name\":\"Versive\",\"url\":\"https://docs.getversive.com\",\"publisher\":{\"@id\":\"https://docs.getversive.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.getversive.com/api-reference/studies/available-references#webpage\",\"url\":\"https://docs.getversive.com/api-reference/studies/available-references\",\"name\":\"List available references\",\"description\":\"Which earlier questions can be referenced from a given position\",\"dateModified\":\"2026-10-27T21:15:18.800Z\",\"isPartOf\":{\"@id\":\"https://docs.getversive.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.getversive.com/api-reference/studies/available-references#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.getversive.com/api-reference/studies/available-references#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Studies\",\"item\":\"https://docs.getversive.com/api-reference/studies/create-study\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List available references\",\"item\":\"https://docs.getversive.com/api-reference/studies/available-references\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.getversive.com/api-reference/studies/available-references#apireference\",\"headline\":\"List available references\",\"name\":\"List available references\",\"description\":\"Which earlier questions can be referenced from a given position\",\"url\":\"https://docs.getversive.com/api-reference/studies/available-references\",\"mainEntityOfPage\":{\"@id\":\"https://docs.getversive.com/api-reference/studies/available-references#webpage\"},\"dateModified\":\"2026-10-27T21:15:18.800Z\",\"publisher\":{\"@id\":\"https://docs.getversive.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.getversive.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Versive\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Versive\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/studies/available-references.md","siteName":"Versive","nav":{"global":null,"tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API reference","groups":[{"group":"Getting started","pages":[{"title":"API introduction","sidebarTitle":"Introduction","href":"/api-reference/introduction"},{"title":"Versioning and compatibility","sidebarTitle":"Versioning","href":"/api-reference/versioning"},{"title":"Webhooks","sidebarTitle":"Webhooks","href":"/api-reference/webhooks"}]},{"group":"Studies","pages":[{"title":"Create study","api":"POST /studies","href":"/api-reference/studies/create-study"},{"title":"List studies","api":"GET /studies","href":"/api-reference/studies/list-studies"},{"title":"Get study","api":"GET /studies/{id}","href":"/api-reference/studies/get-study"},{"title":"Update study","api":"PUT /studies/{id}","href":"/api-reference/studies/update-study"},{"title":"Get study metrics","api":"GET /studies/{id}/metrics","href":"/api-reference/studies/get-study-metrics"},{"title":"Review study","api":"GET /studies/{id}/review","href":"/api-reference/studies/review-study"},{"title":"Estimate study length","api":"POST /studies/length-estimate","href":"/api-reference/studies/estimate-study-length"},{"title":"Translate study","api":"POST /studies/{id}/translate","href":"/api-reference/studies/translate-study"},{"title":"List study translations","api":"GET /studies/{id}/translations","href":"/api-reference/studies/list-study-translations"},{"title":"Edit study with AI agent","api":"POST /studies/{study_id}/agent","href":"/api-reference/studies/agent-edit"},{"title":"Apply agent mutations","api":"POST /studies/{study_id}/agent/apply","href":"/api-reference/studies/agent-apply"},{"title":"AI edit questions (stateless)","api":"POST /studies/{study_id}/ai-edit","description":"Transform a question list with AI, without saving","href":"/api-reference/studies/ai-edit"},{"title":"List available references","api":"GET /studies/{study_id}/available-references","href":"/api-reference/studies/available-references"}]},{"group":"Quotas","pages":[{"title":"Get study quotas","api":"GET /studies/{id}/quotas","description":"The study-level quota configuration","href":"/api-reference/quotas/get-study-quotas"},{"title":"Update study quotas","api":"PUT /studies/{id}/quotas","href":"/api-reference/quotas/update-study-quotas"},{"title":"Get quota progress","api":"GET /studies/{id}/quotas/progress","href":"/api-reference/quotas/get-quota-progress"},{"title":"List question quotas","api":"GET /studies/{id}/question-quotas","href":"/api-reference/quotas/list-question-quotas"},{"title":"Update question quotas","api":"PUT /studies/{id}/questions/{question_id}/quotas","href":"/api-reference/quotas/update-question-quotas"}]},{"group":"Randomizers","pages":[{"title":"List randomizers","api":"GET /randomizers","href":"/api-reference/randomizers/list-randomizers"},{"title":"Create randomizer","api":"POST /randomizers","href":"/api-reference/randomizers/create-randomizer"},{"title":"Update randomizer","api":"PUT /randomizers/{id}","href":"/api-reference/randomizers/update-randomizer"},{"title":"Remove randomizer","api":"POST /randomizers/{id}/remove","href":"/api-reference/randomizers/remove-randomizer"}]},{"group":"Questions","pages":[{"title":"List questions","api":"GET /questions","href":"/api-reference/questions/list-questions"},{"title":"Batch create/update questions","api":"POST /questions/batch","href":"/api-reference/questions/batch-questions"},{"title":"Update question","api":"PUT /questions/{question_id}","href":"/api-reference/questions/update-question"},{"title":"Delete question","api":"DELETE /questions/{question_id}","href":"/api-reference/questions/delete-question"}]},{"group":"Asset uploads","pages":[{"title":"Create asset upload","api":"POST /asset-uploads","href":"/api-reference/asset-uploads/create-asset-upload"},{"title":"Complete asset upload","api":"POST /asset-uploads/{upload_id}/complete","href":"/api-reference/asset-uploads/complete-asset-upload"}]},{"group":"Question logic","pages":[{"title":"List question logic","api":"GET /question-logic","href":"/api-reference/question-logic/list-question-logic"},{"title":"Create question logic","api":"POST /question-logic","href":"/api-reference/question-logic/create-question-logic"},{"title":"Update question logic","api":"PUT /question-logic/{logic_id}","href":"/api-reference/question-logic/update-question-logic"},{"title":"Delete question logic","api":"DELETE /question-logic/{logic_id}","href":"/api-reference/question-logic/delete-question-logic"}]},{"group":"Interviews","pages":[{"title":"Create interview","api":"POST /interviews","href":"/api-reference/interviews/create-interview"},{"title":"Get interview","api":"GET /interviews/{id}","href":"/api-reference/interviews/get-interview"},{"title":"Get interview by link token","api":"GET /interviews","href":"/api-reference/interviews/get-interview-by-vid"},{"title":"Get interview media","api":"GET /interviews/{id}/media","href":"/api-reference/interviews/get-interview-media"},{"title":"Update interview","api":"PUT /interviews/{id}","href":"/api-reference/interviews/update-interview"}]},{"group":"Insights","pages":[{"title":"Get interview insights","api":"GET /insights","href":"/api-reference/insights/get-insights"}]},{"group":"Translated questions","pages":[{"title":"List translated questions","api":"GET /translated-questions","href":"/api-reference/translated-questions/list-translated-questions"},{"title":"Get translated question","api":"GET /translated-questions/{translated_question_id}","href":"/api-reference/translated-questions/get-translated-question"},{"title":"Update translated question","api":"PUT /translated-questions/{translated_question_id}","href":"/api-reference/translated-questions/update-translated-question"}]},{"group":"Folders","pages":[{"title":"Create folder","api":"POST /folders","href":"/api-reference/folders/create-folder"},{"title":"List folders","api":"GET /folders","href":"/api-reference/folders/list-folders"},{"title":"Update folder","api":"PATCH /folders/{id}","href":"/api-reference/folders/update-folder"}]}]},{"tab":"MCP","pages":[{"title":"MCP","href":"/mcp/overview"}]},{"tab":"SDK","pages":[{"title":"SDK","href":"/sdk/overview"}]}]},"basePath":"","title":"List available references - Versive","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","Page-C7x-eUfk.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js"]}