Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES.
Use the returned question IDs, keywords, and cleaning settings when calling POST /v3/addRespondent.
TS is not suggested by this endpoint. Pass qualityChecks to limit which checks are suggested.
POST
/
v3
/
qualityCheckSuggestions
Quality Check Suggestions
curl --request POST \ --url https://api.redem.io/v3/qualityCheckSuggestions \ --header 'Content-Type: application/json' \ --header 'api-key: <api-key>' \ --data '{ "surveyPlatform": "SightX", "allInclusive": true, "surveyStructure": [ { "questionId": "Q1", "questionType": "OpenEnd", "question": "Why did you choose this product?" }, { "questionId": "Q2", "questionType": "Grid", "question": "Please rate the following brands.", "items": [ "Brand A", "Brand B", "Brand C", "Brand D", "Brand E" ], "answerOptions": [ "Very poor", "Poor", "Neutral", "Good", "Excellent" ], "isMultiSelect": false }, { "questionId": "Q3", "questionType": "Select", "question": "Which age group are you in?", "answerOptions": [ "18-24", "25-34", "35-44", "45-54", "55+" ], "isMultiSelect": false } ]}'
Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this endpoint to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing the manual effort of choosing which questions to score and how to configure them.What you get
Suggested OES questions with keywords and duplicate-check flags
Suggested GQS grids with pattern-check recommendations
Suggested CHS question IDs plus a surveyDescription
Suggested BAS tracking targets: open ends (keystrokes: true) and grids with 5 or more items (mouse: true)
Suggested DES demographic mappings (type + questionId) when suitable demographics are present
Recommended default cleaning settings for API v3
Notes
TS is not suggested here; configure it separately in your integration.
Optional qualityChecks limits which checks are suggested (OES, GQS, CHS, BAS, DES). Omit it to suggest all of them.
BAS is built from the other suggestions: every suggested open end, plus every suggested grid with 5 or more items. Grid-only surveys therefore get BAS suggestions when those grids qualify.
Cap suggestion volume with allInclusive (default true) to match all-inclusive plan limits.
Questionnaire structure used to suggest quality checks. Maximum 500 questions. Each item is a discriminated union on questionType (OpenEnd, Grid, or Select). Each questionId must be unique.
Maximum array length: 500
A question from your survey platform questionnaire. Discriminated by questionType (OpenEnd | Grid | Select) — each variant has its own required and optional fields. questionId values must be unique across surveyStructure.
When true (default), suggestion counts are capped to all-inclusive plan limits (OES 5, GQS 5, CHS 100 question slots). When false, higher API maxima are used (OES 30, GQS 20, CHS 300 slots).
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"ReDem Documentation","colors":{"primary":"#00a181","light":"#00a181","dark":"#00a181"},"logo":{"light":"https://mintcdn.com/redemgmbh/MbMZseQqK5DPUXC1/logo/ReDem-Logo-Light.png?fit=max\u0026auto=format\u0026n=MbMZseQqK5DPUXC1\u0026q=85\u0026s=6963f0c326adde403b805b6012c73c5d","dark":"https://mintcdn.com/redemgmbh/MbMZseQqK5DPUXC1/logo/ReDem-Logo-Dark.png?fit=max\u0026auto=format\u0026n=MbMZseQqK5DPUXC1\u0026q=85\u0026s=a5d5855c82b244a06b46fe52533ff988","href":"https://docs.redem.io/"},"favicon":"https://mintcdn.com/redemgmbh/JhRzQ1wyf4VQmVNq/ReDem-Fav-Icon.png?fit=max\u0026auto=format\u0026n=JhRzQ1wyf4VQmVNq\u0026q=85\u0026s=6df9604205f50179709e31a224cd6a3b","background":{"color":{"dark":"#061836"}},"navbar":{"links":[{"href":"mailto:support@redem.io","label":"Support"}],"primary":{"type":"button","label":"Login","href":"https://app.redem.io/"}},"seo":{"metatags":{"robots":"noindex"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"redemgmbh","hasAudioNarration":false,"actualSubdomain":"redemgmbh","customDomains":["docs.redem.io"],"gitSource":{"type":"github","owner":"redemoc","repo":"redem-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":false,"edits":false,"issues":false},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6aecb3b375e8c9363388252b","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Documentation","count":31},{"language":"default","tag":"Endpoints","count":21},{"language":"default","tag":"Knowledge Base","count":13},{"language":"default","tag":"User Guide","count":9},{"language":"default","tag":"Quality Checks","count":7},{"language":"default","tag":"How to integrate","count":4},{"language":"default","tag":"Others","count":4},{"language":"default","tag":"Getting Started","count":3},{"language":"default","tag":"API Specifications","count":3},{"language":"default","tag":"Core Features","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"llms-txt-v2","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":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"img.nav-logo{margin-top:10px;height:44px!important;width:auto!important}"}],"page":{"pagePath":"api-reference/endpoints/v3/qualityCheckSuggestions","slug":"/api-reference/endpoints/v3/qualityCheckSuggestions","pageMetadata":{"title":"Quality Check Suggestions","openapi":"POST /v3/qualityCheckSuggestions","description":"Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES.\n\nUse the returned question IDs, keywords, and cleaning settings when calling `POST /v3/addRespondent`.\n\nTS is not suggested by this endpoint. Pass `qualityChecks` to limit which checks are suggested.","href":"/api-reference/endpoints/v3/qualityCheckSuggestions"},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Use the returned question IDs, keywords, and cleaning settings when calling \", _jsx(_components.code, {\n children: \"POST /v3/addRespondent\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"TS is not suggested by this endpoint. Pass \", _jsx(_components.code, {\n children: \"qualityChecks\"\n }), \" to limit which checks are suggested.\"]\n })]\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};return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this endpoint to help their users set up API projects in ReDem with recommendations that align with `,_jsx(_components.a,{href:`/knowledge-base/best-practices/best-practice-setup`,children:`ReDem best practices`}),` — reducing the manual effort of choosing which questions to score and how to configure them.`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`What you get`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Suggested `,_jsx(_components.strong,{children:`OES`}),` questions with keywords and duplicate-check flags`]}),`\n`,_jsxs(_components.li,{children:[`Suggested `,_jsx(_components.strong,{children:`GQS`}),` grids with pattern-check recommendations`]}),`\n`,_jsxs(_components.li,{children:[`Suggested `,_jsx(_components.strong,{children:`CHS`}),` question IDs plus a `,_jsx(_components.code,{children:`surveyDescription`})]}),`\n`,_jsxs(_components.li,{children:[`Suggested `,_jsx(_components.strong,{children:`BAS`}),` tracking targets: open ends (`,_jsx(_components.code,{children:`keystrokes: true`}),`) and grids with `,_jsx(_components.strong,{children:`5 or more`}),` items (`,_jsx(_components.code,{children:`mouse: true`}),`)`]}),`\n`,_jsxs(_components.li,{children:[`Suggested `,_jsx(_components.strong,{children:`DES`}),` demographic mappings (`,_jsx(_components.code,{children:`type`}),` + `,_jsx(_components.code,{children:`questionId`}),`) when suitable demographics are present`]}),`\n`,_jsxs(_components.li,{children:[`Recommended default `,_jsx(_components.strong,{children:`cleaning settings`}),` for API v3`]}),`\n`]}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Notes`})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`TS`}),` is not suggested here; configure it separately in your integration.`]}),`\n`,_jsxs(_components.li,{children:[`Optional `,_jsx(_components.code,{children:`qualityChecks`}),` limits which checks are suggested (`,_jsx(_components.code,{children:`OES`}),`, `,_jsx(_components.code,{children:`GQS`}),`, `,_jsx(_components.code,{children:`CHS`}),`, `,_jsx(_components.code,{children:`BAS`}),`, `,_jsx(_components.code,{children:`DES`}),`). Omit it to suggest all of them.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`BAS`}),` is built from the other suggestions: every suggested open end, plus every suggested grid with 5 or more items. Grid-only surveys therefore get BAS suggestions when those grids qualify.`]}),`\n`,_jsxs(_components.li,{children:[`Cap suggestion volume with `,_jsx(_components.code,{children:`allInclusive`}),` (default `,_jsx(_components.code,{children:`true`}),`) to match all-inclusive plan limits.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Quality Check Suggestions","openapi":"POST /v3/qualityCheckSuggestions","description":"Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES.\n\nUse the returned question IDs, keywords, and cleaning settings when calling `POST /v3/addRespondent`.\n\nTS is not suggested by this endpoint. Pass `qualityChecks` to limit which checks are suggested.","href":"/api-reference/endpoints/v3/qualityCheckSuggestions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Respondent"],"summary":"Quality Check Suggestions","operationId":"qualityCheckSuggestionsV3","description":"Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES.\n\nUse the returned question IDs, keywords, and cleaning settings when calling `POST /v3/addRespondent`.\n\nTS is not suggested by this endpoint. Pass `qualityChecks` to limit which checks are suggested.","requestBody":"d11a4429-8711-4e13-bc67-a714db9d05a7","responses":{"200":"d4de98fa-b7a4-46ae-b0e0-92c9cc6150c2","422":"d44139c6-c87c-47f9-b16b-8badfbb0586c"},"method":"post","type":"path","servers":["da42eddd-ff63-473c-b12e-0d6f8ff0898e"],"security":["246c2102-4212-43ad-867f-0a7d1b1a3113"],"path":"/v3/qualityCheckSuggestions","baseUrlOptions":["https://api.redem.io"],"title":"Quality Check Suggestions","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"Request body for generating quality-check suggestions for an API project setup.\n\n **🔒 Authentication:** This endpoint is only accessible via a [`PRIVATE` API key](/api-reference/api-specifications/api-keys#permission-levels).","required":["surveyStructure"],"properties":{"surveyStructure":{"type":"array","maxItems":500,"description":"Questionnaire structure used to suggest quality checks. Maximum **500** questions. Each item is a discriminated union on `questionType` (`OpenEnd`, `Grid`, or `Select`). Each `questionId` must be unique.","items":{"oneOf":[{"type":"object","title":"OpenEnd","description":"A question from your survey platform questionnaire. Discriminated by `questionType` (`OpenEnd` | `Grid` | `Select`) — each variant has its own required and optional fields. `questionId` values must be unique across `surveyStructure`.","required":["questionId","questionType","question"],"properties":{"questionId":{"type":"string","minLength":1,"description":"Unique question identifier within `surveyStructure`.","example":"Q1","isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.0.questionId","typeLabel":"string"},"questionType":{"type":"string","enum":["OpenEnd"],"description":"Must be `OpenEnd`.","isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.0.questionType","typeLabel":"enum\u003cstring>"},"question":{"type":"string","minLength":1,"description":"Full question text.","example":"Why did you choose this product?","isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.0.question","typeLabel":"string"}},"uniqueKey":"surveyStructure.items.[INDEX].oneOf.0","typeLabel":"OpenEnd · object"},{"type":"object","title":"Grid","description":"A question from your survey platform questionnaire. Discriminated by `questionType` (`OpenEnd` | `Grid` | `Select`) — each variant has its own required and optional fields. `questionId` values must be unique across `surveyStructure`.","required":["questionId","questionType","question","items","answerOptions"],"properties":{"questionId":{"type":"string","minLength":1,"description":"Unique question identifier within `surveyStructure`.","example":"Q2","isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.1.questionId","typeLabel":"string"},"questionType":{"type":"string","enum":["Grid"],"description":"Must be `Grid`.","isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.1.questionType","typeLabel":"enum\u003cstring>"},"question":{"type":"string","minLength":1,"description":"Full question text.","example":"Please rate the following brands.","isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.1.question","typeLabel":"string"},"items":{"type":"array","minItems":1,"items":{"type":"string","uniqueKey":"surveyStructure.items.[INDEX].oneOf.1.\\items.items.[INDEX]","typeLabel":"string"},"description":"Row / item labels shown in the grid. At least one item required.","example":["Brand A","Brand B","Brand C","Brand D","Brand E"],"isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.1.\\items","typeLabel":"string[]"},"answerOptions":{"type":"array","minItems":1,"items":{"type":"string","uniqueKey":"surveyStructure.items.[INDEX].oneOf.1.answerOptions.items.[INDEX]","typeLabel":"string"},"description":"Column / scale labels. At least one option required.","example":["Very poor","Poor","Neutral","Good","Excellent"],"isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.1.answerOptions","typeLabel":"string[]"},"isMultiSelect":{"type":"boolean","default":false,"description":"Whether respondents can select multiple answers per row. Defaults to `false`.","example":false,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.1.isMultiSelect","typeLabel":"boolean"}},"uniqueKey":"surveyStructure.items.[INDEX].oneOf.1","typeLabel":"Grid · object"},{"type":"object","title":"Select","description":"A question from your survey platform questionnaire. Discriminated by `questionType` (`OpenEnd` | `Grid` | `Select`) — each variant has its own required and optional fields. `questionId` values must be unique across `surveyStructure`.","required":["questionId","questionType","question","answerOptions"],"properties":{"questionId":{"type":"string","minLength":1,"description":"Unique question identifier within `surveyStructure`.","example":"Q3","isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.2.questionId","typeLabel":"string"},"questionType":{"type":"string","enum":["Select"],"description":"Must be `Select`.","isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.2.questionType","typeLabel":"enum\u003cstring>"},"question":{"type":"string","minLength":1,"description":"Full question text.","example":"Which age group are you in?","isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.2.question","typeLabel":"string"},"answerOptions":{"type":"array","minItems":1,"items":{"type":"string","uniqueKey":"surveyStructure.items.[INDEX].oneOf.2.answerOptions.items.[INDEX]","typeLabel":"string"},"description":"Answer choices. At least one option required.","example":["18-24","25-34","35-44","45-54","55+"],"isRequired":true,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.2.answerOptions","typeLabel":"string[]"},"isMultiSelect":{"type":"boolean","default":false,"description":"Whether respondents can select multiple answers. Defaults to `false`.","example":false,"uniqueKey":"surveyStructure.items.[INDEX].oneOf.2.isMultiSelect","typeLabel":"boolean"}},"uniqueKey":"surveyStructure.items.[INDEX].oneOf.2","typeLabel":"Select · object"}],"uniqueKey":"surveyStructure.items.[INDEX]","typeLabel":"OpenEnd · object | Grid · object | Select · object"},"isRequired":true,"uniqueKey":"surveyStructure","typeLabel":"(OpenEnd · object | Grid · object | Select · object)[]"},"surveyPlatform":{"type":"string","description":"Optional survey platform identifier (for example `SightX`, `qualtrics`). Stored for logging and support only; it does not change suggestions.","example":"SightX","uniqueKey":"surveyPlatform","typeLabel":"string"},"allInclusive":{"type":"boolean","default":true,"description":"When `true` (default), suggestion counts are capped to all-inclusive plan limits (OES 5, GQS 5, CHS 100 question slots). When `false`, higher API maxima are used (OES 30, GQS 20, CHS 300 slots).","uniqueKey":"allInclusive","typeLabel":"boolean"},"qualityChecks":{"type":"array","minItems":1,"uniqueItems":true,"items":{"type":"string","enum":["OES","GQS","CHS","BAS","DES"],"uniqueKey":"qualityChecks.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"Optional subset of quality checks to suggest. When omitted, suggestions run for OES, GQS, CHS, BAS, and DES.","example":["OES","GQS","CHS","BAS","DES"],"uniqueKey":"qualityChecks","typeLabel":"enum\u003cstring>[]"}},"uniqueKey":"","typeLabel":"object"},"example":{"surveyPlatform":"SightX","allInclusive":true,"surveyStructure":[{"questionId":"Q1","questionType":"OpenEnd","question":"Why did you choose this product?"},{"questionId":"Q2","questionType":"Grid","question":"Please rate the following brands.","items":["Brand A","Brand B","Brand C","Brand D","Brand E"],"answerOptions":["Very poor","Poor","Neutral","Good","Excellent"],"isMultiSelect":false},{"questionId":"Q3","questionType":"Select","question":"Which age group are you in?","answerOptions":["18-24","25-34","35-44","45-54","55+"],"isMultiSelect":false}]},"examples":{"Example":{"title":"Example","value":{"surveyPlatform":"SightX","allInclusive":true,"surveyStructure":[{"questionId":"Q1","questionType":"OpenEnd","question":"Why did you choose this product?"},{"questionId":"Q2","questionType":"Grid","question":"Please rate the following brands.","items":["Brand A","Brand B","Brand C","Brand D","Brand E"],"answerOptions":["Very poor","Poor","Neutral","Good","Excellent"],"isMultiSelect":false},{"questionId":"Q3","questionType":"Select","question":"Which age group are you in?","answerOptions":["18-24","25-34","35-44","45-54","55+"],"isMultiSelect":false}]}}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"d4de98fa-b7a4-46ae-b0e0-92c9cc6150c2":{"description":"Suggestions generated successfully.","content":{"application/json":{"schema":{"type":"object","required":["success","message","results"],"properties":{"success":{"type":"boolean","example":true,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","example":"Quality check suggestions generated","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"results":{"type":"object","required":["OES","GQS","CHS","BAS","DES","cleaningSettings"],"properties":{"OES":{"type":"array","items":{"type":"object","required":["questionId","keywords","enableDuplicateCheck"],"properties":{"questionId":{"type":"string","example":"Q1","isRequired":true,"uniqueKey":"results.OES.items.[INDEX].questionId","typeLabel":"string"},"keywords":{"type":"array","items":{"type":"string","uniqueKey":"results.OES.items.[INDEX].keywords.items.[INDEX]","typeLabel":"string"},"description":"Suggested keywords for the OES datapoint.","example":["price","quality","brand"],"isRequired":true,"uniqueKey":"results.OES.items.[INDEX].keywords","typeLabel":"string[]"},"enableDuplicateCheck":{"type":"boolean","description":"Whether duplicate answer / respondent detection should be enabled for this OES datapoint.","isRequired":true,"uniqueKey":"results.OES.items.[INDEX].enableDuplicateCheck","typeLabel":"boolean"}},"uniqueKey":"results.OES.items.[INDEX]","typeLabel":"object"},"description":"Suggested open-ended checks.","isRequired":true,"uniqueKey":"results.OES","typeLabel":"object[]"},"GQS":{"type":"array","items":{"type":"object","required":["questionId","enablePatternCheck"],"properties":{"questionId":{"type":"string","example":"Q2","isRequired":true,"uniqueKey":"results.GQS.items.[INDEX].questionId","typeLabel":"string"},"enablePatternCheck":{"type":"boolean","description":"Whether to enable the GQS pattern check for this suggested grid.","isRequired":true,"uniqueKey":"results.GQS.items.[INDEX].enablePatternCheck","typeLabel":"boolean"}},"uniqueKey":"results.GQS.items.[INDEX]","typeLabel":"object"},"description":"Suggested grid checks.","isRequired":true,"uniqueKey":"results.GQS","typeLabel":"object[]"},"CHS":{"type":"object","required":["questionIds","surveyDescription"],"description":"Suggested Coherence Score configuration.","properties":{"questionIds":{"type":"array","items":{"type":"string","uniqueKey":"results.CHS.questionIds.items.[INDEX]","typeLabel":"string"},"description":"Suggested question IDs to include in the CHS interview.","example":["Q3","Q2"],"isRequired":true,"uniqueKey":"results.CHS.questionIds","typeLabel":"string[]"},"surveyDescription":{"type":"string","description":"Suggested survey description for CHS context.","example":"A survey about brand preference and product choice among shoppers.","isRequired":true,"uniqueKey":"results.CHS.surveyDescription","typeLabel":"string"}},"isRequired":true,"uniqueKey":"results.CHS","typeLabel":"object"},"BAS":{"type":"array","items":{"type":"object","required":["questionId","keystrokes","mouse"],"properties":{"questionId":{"type":"string","description":"Question to track. Open ends come from suggested OES questions. Grids come from suggested GQS questions with 5 or more items.","example":"Q1","isRequired":true,"uniqueKey":"results.BAS.items.[INDEX].questionId","typeLabel":"string"},"keystrokes":{"type":"boolean","description":"`true` for open ends. `false` for grids.","example":true,"isRequired":true,"uniqueKey":"results.BAS.items.[INDEX].keystrokes","typeLabel":"boolean"},"mouse":{"type":"boolean","description":"`true` for grids with 5 or more items. `false` for open ends.","example":false,"isRequired":true,"uniqueKey":"results.BAS.items.[INDEX].mouse","typeLabel":"boolean"}},"uniqueKey":"results.BAS.items.[INDEX]","typeLabel":"object"},"description":"Suggested behavior tracking targets. Open ends use `keystrokes: true`. Grids with 5 or more items use `mouse: true`.","isRequired":true,"uniqueKey":"results.BAS","typeLabel":"object[]"},"DES":{"type":"array","items":{"type":"object","required":["type","questionId"],"description":"Suggested Duplicate Entrance Score demographic mapping.","properties":{"type":{"type":"string","description":"Recommended DES demographic type.","enum":["age","ageRange","yearOfBirth","gender","country","city","zip","ethnicity","salaryRange","jobTitle"],"example":"ageRange","isRequired":true,"uniqueKey":"results.DES.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"questionId":{"type":"string","description":"Survey question ID to map to this demographic type.","example":"Q3","isRequired":true,"uniqueKey":"results.DES.items.[INDEX].questionId","typeLabel":"string"}},"uniqueKey":"results.DES.items.[INDEX]","typeLabel":"object"},"description":"Suggested DES demographic mappings (`type` + `questionId`). Empty when DES was not requested or no suitable demographics were found.","isRequired":true,"uniqueKey":"results.DES","typeLabel":"object[]"},"cleaningSettings":{"type":"object","description":"Recommended default cleaning settings for API v3 projects (includes DES). Same shape as [`cleaningSettings` on Add Respondent](/api-reference/endpoints/v3/addRespondent#body-cleaning-settings).","properties":{"redemScore":{"type":"number","description":"Minimum acceptable ReDem score (0-100)","example":60,"uniqueKey":"results.cleaningSettings.redemScore","typeLabel":"number"},"OES":{"type":"object","properties":{"activate":{"type":"boolean","description":"Indicates whether **OES** should be applied as a cleaning parameter.","example":true,"uniqueKey":"results.cleaningSettings.OES.activate","typeLabel":"boolean"},"score":{"type":"number","description":"Minimum score threshold for OES checks","example":40,"uniqueKey":"results.cleaningSettings.OES.score","typeLabel":"number"},"minDataPoints":{"type":"number","description":"Minimum number of data points required","example":2,"uniqueKey":"results.cleaningSettings.OES.minDataPoints","typeLabel":"number"},"categories":{"type":"object","properties":{"AI_SUSPECT":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.OES.categories.AI_SUSPECT.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.OES.categories.AI_SUSPECT.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.OES.categories.AI_SUSPECT","typeLabel":"object"},"BAD_LANGUAGE":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.OES.categories.BAD_LANGUAGE.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.OES.categories.BAD_LANGUAGE.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.OES.categories.BAD_LANGUAGE","typeLabel":"object"},"OFF_TOPIC":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.OES.categories.OFF_TOPIC.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.OES.categories.OFF_TOPIC.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.OES.categories.OFF_TOPIC","typeLabel":"object"},"NO_ANSWER":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.OES.categories.NO_ANSWER.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.OES.categories.NO_ANSWER.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.OES.categories.NO_ANSWER","typeLabel":"object"},"WRONG_LANGUAGE":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.OES.categories.WRONG_LANGUAGE.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.OES.categories.WRONG_LANGUAGE.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.OES.categories.WRONG_LANGUAGE","typeLabel":"object"},"GIBBERISH":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.OES.categories.GIBBERISH.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.OES.categories.GIBBERISH.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.OES.categories.GIBBERISH","typeLabel":"object"},"DUPLICATE_RESPONDENT":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.OES.categories.DUPLICATE_RESPONDENT.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.OES.categories.DUPLICATE_RESPONDENT.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.OES.categories.DUPLICATE_RESPONDENT","typeLabel":"object"},"DUPLICATE_ANSWER":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.OES.categories.DUPLICATE_ANSWER.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.OES.categories.DUPLICATE_ANSWER.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.OES.categories.DUPLICATE_ANSWER","typeLabel":"object"}},"uniqueKey":"results.cleaningSettings.OES.categories","typeLabel":"object"}},"uniqueKey":"results.cleaningSettings.OES","typeLabel":"object"},"CHS":{"type":"object","properties":{"activate":{"type":"boolean","description":"Indicates whether **CHS** should be applied as a cleaning parameter.","example":true,"uniqueKey":"results.cleaningSettings.CHS.activate","typeLabel":"boolean"},"score":{"type":"number","description":"Minimum score threshold for CHS checks","example":30,"uniqueKey":"results.cleaningSettings.CHS.score","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.CHS","typeLabel":"object"},"GQS":{"type":"object","properties":{"activate":{"type":"boolean","description":"Indicates whether **GQS** should be applied as a cleaning parameter.","example":true,"uniqueKey":"results.cleaningSettings.GQS.activate","typeLabel":"boolean"},"score":{"type":"number","description":"Minimum score threshold for GQS checks","example":20,"uniqueKey":"results.cleaningSettings.GQS.score","typeLabel":"number"},"minDataPoints":{"type":"number","description":"Minimum number of data points required","example":2,"uniqueKey":"results.cleaningSettings.GQS.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.GQS","typeLabel":"object"},"TS":{"type":"object","properties":{"activate":{"type":"boolean","description":"Indicates whether **TS** should be applied as a cleaning parameter.","example":true,"uniqueKey":"results.cleaningSettings.TS.activate","typeLabel":"boolean"},"score":{"type":"number","description":"Minimum score threshold for TS checks","example":20,"uniqueKey":"results.cleaningSettings.TS.score","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.TS","typeLabel":"object"},"BAS":{"type":"object","properties":{"activate":{"type":"boolean","description":"Indicates whether **BAS** should be applied as a cleaning parameter.","example":true,"uniqueKey":"results.cleaningSettings.BAS.activate","typeLabel":"boolean"},"score":{"type":"number","description":"Minimum score threshold for BAS checks","example":20,"uniqueKey":"results.cleaningSettings.BAS.score","typeLabel":"number"},"categories":{"type":"object","properties":{"UNNATURAL_TYPING":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.BAS.categories.UNNATURAL_TYPING.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.BAS.categories.UNNATURAL_TYPING.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.BAS.categories.UNNATURAL_TYPING","typeLabel":"object"},"COPY_AND_PASTE":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.BAS.categories.COPY_AND_PASTE.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.BAS.categories.COPY_AND_PASTE.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.BAS.categories.COPY_AND_PASTE","typeLabel":"object"},"UNNATURAL_MOVEMENT":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.BAS.categories.UNNATURAL_MOVEMENT.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.BAS.categories.UNNATURAL_MOVEMENT.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.BAS.categories.UNNATURAL_MOVEMENT","typeLabel":"object"}},"uniqueKey":"results.cleaningSettings.BAS.categories","typeLabel":"object"}},"uniqueKey":"results.cleaningSettings.BAS","typeLabel":"object"},"DES":{"type":"object","description":"Cleaning settings for Duplicate Entrance Score (DES).","properties":{"activate":{"type":"boolean","description":"Indicates whether **DES** should be applied as a cleaning parameter.","example":true,"uniqueKey":"results.cleaningSettings.DES.activate","typeLabel":"boolean"},"score":{"type":"number","description":"Minimum score threshold for DES. Respondents below this score are excluded when DES cleaning is active. Recommended default: `40`.","example":40,"uniqueKey":"results.cleaningSettings.DES.score","typeLabel":"number"},"categories":{"type":"object","description":"Optional category-based exclusion toggles. Off by default in recommended settings.","properties":{"DUPLICATE_IP":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.DES.categories.DUPLICATE_IP.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.DES.categories.DUPLICATE_IP.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.DES.categories.DUPLICATE_IP","typeLabel":"object"},"DUPLICATE_ENTRANT":{"type":"object","properties":{"activate":{"type":"boolean","uniqueKey":"results.cleaningSettings.DES.categories.DUPLICATE_ENTRANT.activate","typeLabel":"boolean"},"minDataPoints":{"type":"number","uniqueKey":"results.cleaningSettings.DES.categories.DUPLICATE_ENTRANT.minDataPoints","typeLabel":"number"}},"uniqueKey":"results.cleaningSettings.DES.categories.DUPLICATE_ENTRANT","typeLabel":"object"}},"uniqueKey":"results.cleaningSettings.DES.categories","typeLabel":"object"}},"uniqueKey":"results.cleaningSettings.DES","typeLabel":"object"}},"isRequired":true,"uniqueKey":"results.cleaningSettings","typeLabel":"object"}},"isRequired":true,"uniqueKey":"results","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"success":true,"message":"Quality check suggestions generated","results":{"OES":[{"questionId":"Q1","keywords":["price","quality","brand"],"enableDuplicateCheck":true}],"GQS":[{"questionId":"Q2","enablePatternCheck":true}],"CHS":{"questionIds":["Q3","Q2"],"surveyDescription":"A survey about brand preference and product choice among shoppers."},"BAS":[{"questionId":"Q1","keystrokes":true,"mouse":false},{"questionId":"Q2","keystrokes":false,"mouse":true}],"DES":[{"type":"ageRange","questionId":"Q3"}],"cleaningSettings":{"redemScore":60,"OES":{"activate":true,"score":40,"minDataPoints":2},"CHS":{"activate":true,"score":30},"GQS":{"activate":true,"score":20,"minDataPoints":2},"TS":{"activate":true,"score":30},"BAS":{"activate":true,"score":20,"minDataPoints":2},"DES":{"activate":true,"score":40}}}},"examples":{"Example":{"title":"Example","value":{"success":true,"message":"Quality check suggestions generated","results":{"OES":[{"questionId":"Q1","keywords":["price","quality","brand"],"enableDuplicateCheck":true}],"GQS":[{"questionId":"Q2","enablePatternCheck":true}],"CHS":{"questionIds":["Q3","Q2"],"surveyDescription":"A survey about brand preference and product choice among shoppers."},"BAS":[{"questionId":"Q1","keystrokes":true,"mouse":false},{"questionId":"Q2","keystrokes":false,"mouse":true}],"DES":[{"type":"ageRange","questionId":"Q3"}],"cleaningSettings":{"redemScore":60,"OES":{"activate":true,"score":40,"minDataPoints":2},"CHS":{"activate":true,"score":30},"GQS":{"activate":true,"score":20,"minDataPoints":2},"TS":{"activate":true,"score":30},"BAS":{"activate":true,"score":20,"minDataPoints":2},"DES":{"activate":true,"score":40}}}}}},"exampleType":"examples"}},"exampleType":"examples"},"d44139c6-c87c-47f9-b16b-8badfbb0586c":{"description":"When a request fails due to validation errors, the API returns a 422 Unprocessable Entity status code.","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"uniqueKey":"success","typeLabel":"boolean"},"message":{"type":"string","example":"Validation Failed","uniqueKey":"message","typeLabel":"string"},"errors":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"errors.additionalProperties","typeLabel":"string"},"uniqueKey":"errors","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"message":"Validation Failed","errors":{}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"246c2102-4212-43ad-867f-0a7d1b1a3113":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"api-key","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"da42eddd-ff63-473c-b12e-0d6f8ff0898e":{"url":"https://api.redem.io"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"api-key","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"redemgmbh","siteName":"ReDem Documentation","title":"Quality Check Suggestions - ReDem Documentation","navMaps":{"firstHrefInVersion":{"v3":{"href":"/api-reference/endpoints/v3/qualityCheckSuggestions","matchLevel":0},"v2":{"href":"/api-reference/endpoints/v2/addRespondent","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-10-20T08:24:38.914Z","originalFileLocation":"api-reference/endpoints/v3/qualityCheckSuggestions.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=\"Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES. Use the returned question IDs, keywords, and cleaning settings when calling POST /v3/addRespondent. TS is not suggested by this endpoint. Pass qualityChecks to limit which checks are suggested.\">\u003cmeta data-mint-head name=\"application-name\" content=\"ReDem Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003cmeta data-mint-head name=\"robots\" content=\"noindex\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/redemgmbh/TMtX1JNYtVvRL_24/_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/redemgmbh/TMtX1JNYtVvRL_24/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/redemgmbh/TMtX1JNYtVvRL_24/_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/redemgmbh/TMtX1JNYtVvRL_24/_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/redemgmbh/TMtX1JNYtVvRL_24/_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/redemgmbh/TMtX1JNYtVvRL_24/_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/redemgmbh/TMtX1JNYtVvRL_24/_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/redemgmbh/TMtX1JNYtVvRL_24/_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/redemgmbh/TMtX1JNYtVvRL_24/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Quality Check Suggestions - ReDem Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES. Use the returned question IDs, keywords, and cleaning settings when calling POST /v3/addRespondent. TS is not suggested by this endpoint. Pass qualityChecks to limit which checks are suggested.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"ReDem Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://redemgmbh.mintlify.site/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Quality+Check+Suggestions\u0026amp;description=Generate+smart+quality-check+suggestions+from+a+survey+questionnaire+structure.+Partners+can+use+this+to+help+their+users+set+up+API+projects+in+ReDem+with+reco\u0026amp;theme=b1a94dee9d8f1e2cfdf9595b\u0026amp;signature=518de6d8632484a39553735c2607b494e2e7755bb6ee7184b1913a8d3e08254e\">\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=\"Quality Check Suggestions - ReDem Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES. Use the returned question IDs, keywords, and cleaning settings when calling POST /v3/addRespondent. TS is not suggested by this endpoint. Pass qualityChecks to limit which checks are suggested.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://redemgmbh.mintlify.site/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Quality+Check+Suggestions\u0026amp;description=Generate+smart+quality-check+suggestions+from+a+survey+questionnaire+structure.+Partners+can+use+this+to+help+their+users+set+up+API+projects+in+ReDem+with+reco\u0026amp;theme=b1a94dee9d8f1e2cfdf9595b\u0026amp;signature=518de6d8632484a39553735c2607b494e2e7755bb6ee7184b1913a8d3e08254e\">\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/redemgmbh/TMtX1JNYtVvRL_24/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"ReDem Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#00a181\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/endpoints/v3/qualityCheckSuggestions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.redem.io/#organization\",\"name\":\"ReDem Documentation\",\"url\":\"https://docs.redem.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/redemgmbh/MbMZseQqK5DPUXC1/logo/ReDem-Logo-Light.png?fit=max\u0026auto=format\u0026n=MbMZseQqK5DPUXC1\u0026q=85\u0026s=6963f0c326adde403b805b6012c73c5d\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.redem.io#website\",\"name\":\"ReDem Documentation\",\"url\":\"https://docs.redem.io\",\"publisher\":{\"@id\":\"https://docs.redem.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions#webpage\",\"url\":\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions\",\"name\":\"Quality Check Suggestions\",\"description\":\"Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES. Use the returned question IDs, keywords, and cleaning settings when calling POST /v3/addRespondent. TS is not suggested by this endpoint. Pass qualityChecks to limit which checks are suggested.\",\"dateModified\":\"2026-10-20T08:24:38.914Z\",\"isPartOf\":{\"@id\":\"https://docs.redem.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.redem.io/api-reference/endpoints/v3/addRespondent\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Quality Check Suggestions\",\"item\":\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions#apireference\",\"headline\":\"Quality Check Suggestions\",\"name\":\"Quality Check Suggestions\",\"description\":\"Generate smart quality-check suggestions from a survey questionnaire structure. Partners can use this to help their users set up API projects in ReDem with recommendations that align with ReDem best practices — reducing manual configuration effort for OES, GQS, CHS, BAS, and DES. Use the returned question IDs, keywords, and cleaning settings when calling POST /v3/addRespondent. TS is not suggested by this endpoint. Pass qualityChecks to limit which checks are suggested.\",\"url\":\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.redem.io/api-reference/endpoints/v3/qualityCheckSuggestions#webpage\"},\"dateModified\":\"2026-10-20T08:24:38.914Z\",\"publisher\":{\"@id\":\"https://docs.redem.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.redem.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"ReDem Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"ReDem Documentation","nav":{"global":null,"versions":[{"version":"v3","tabs":[{"tab":"User Guide","pages":[{"title":"User Guide","href":"/welcome"}]},{"tab":"Knowledge Base","pages":[{"title":"Knowledge Base","href":"/knowledge-base/quality-checks/redem-score"}]},{"tab":"API Documentation","groups":[{"group":"How to integrate","pages":[{"title":"Introduction","icon":"book-open","iconType":"regular","href":"/api-reference/intro/introduction"},{"title":"Synchronous Response","icon":"arrow-up-arrow-down","iconType":"regular","href":"/api-reference/intro/synchronous-response"},{"title":"Asynchronous Response","icon":"arrows-rotate","iconType":"regular","href":"/api-reference/intro/asynchronous-response"},{"title":"API Version Migration Guide","icon":"arrow-right-arrow-left","iconType":"regular","href":"/api-reference/others/migration-guide"}]},{"group":"API Specifications","pages":[{"title":"API Keys","icon":"key","iconType":"regular","href":"/api-reference/api-specifications/api-keys"},{"title":"Response Structure","icon":"brackets-curly","iconType":"regular","href":"/api-reference/api-specifications/response-structure"},{"title":"Rate Limits","icon":"clock","iconType":"regular","href":"/api-reference/api-specifications/rate-limits"}]},{"group":"Endpoints","pages":[{"title":"Add Respondent","openapi":"POST /v3/addRespondent","href":"/api-reference/endpoints/v3/addRespondent"},{"title":"Get Respondent","openapi":"POST /v3/getRespondent","href":"/api-reference/endpoints/v3/getRespondent"},{"title":"Get All Respondents","openapi":"POST /v3/getAllRespondents","href":"/api-reference/endpoints/v3/getAllRespondents"},{"title":"Restart Survey","openapi":"POST /v3/restartSurvey","href":"/api-reference/endpoints/v3/restartSurvey"},{"title":"Stop Survey","openapi":"POST /v3/stopSurvey","href":"/api-reference/endpoints/v3/stopSurvey"},{"title":"Credit Calculation","openapi":"POST /v3/creditCalculation","href":"/api-reference/endpoints/v3/creditCalculation"},{"title":"Delete Respondents","openapi":"POST /v3/deleteRespondents","href":"/api-reference/endpoints/v3/deleteRespondents"},{"title":"Delete Surveys","openapi":"POST /v3/deleteSurveys","href":"/api-reference/endpoints/v3/deleteSurveys"},{"title":"Update Respondents Excluded Status","openapi":"POST /v3/updateRespondentsExcludedStatus","href":"/api-reference/endpoints/v3/updateRespondentsExcludedStatus"},{"title":"Recalculate Respondents","openapi":"POST /v3/recalculateRespondents","href":"/api-reference/endpoints/v3/recalculateRespondents"},{"title":"Change Cleaning Settings","openapi":"POST /v3/changeCleaningSettings","description":"Applies new cleaning settings to **all respondents** in a survey, or turns cleaning off for them. Scores are not recalculated and no credits are charged. Any saved AI explanation on an affected respondent is cleared.","href":"/api-reference/endpoints/v3/changeCleaningSettings"},{"title":"Quality Check Suggestions","openapi":"POST /v3/qualityCheckSuggestions","href":"/api-reference/endpoints/v3/qualityCheckSuggestions"}]},{"group":"Others","pages":[{"title":"API Change Log","description":"Stay updated on the latest changes and improvements in the API.","icon":"bullhorn","iconType":"regular","href":"/changelogs/api-change-log"},{"title":"Structuring Surveys Responses for ReDem Compatibility","icon":"lightbulb","iconType":"regular","href":"/api-reference/others/structuring-survey-responses"},{"title":"Behavior Tracking","icon":"eye","iconType":"regular","href":"/api-reference/others/behavior-tracking"}]}]},{"tab":"Status","href":"https://redem.instatus.com/"}]},{"version":"v2","pages":[{"title":"v2","href":"/api-reference/endpoints/v2/addRespondent"}]}]},"basePath":"","title":"Quality Check Suggestions - ReDem Documentation","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}