Answers to fileUpload questions carry a files array and an optional note
the participant left with their upload. Each file includes its metadata
(name, size, mime, uploadedAt, scanStatus) and a temporary url to
download it. The internal storage key is not exposed on responses.
Download URLs expire. Every URL is valid for at least one hour from the
moment the response is fetched, but not indefinitely. Do not cache or store
the URL.
The recommended pattern is a download button in your UI backed by the most
recently fetched URL. When a URL has expired, refetch either this list or the
specific screener response.
Each fetch issues fresh URLs for every file.A file only carries a url once its virus scan has passed. Until then
scanStatus is pending and the url property is absent. Refetch the
response later to get the URL. A file whose scanStatus is infected is
never downloadable.
Headers
x-api-key
string
required
x-api-secret
string
required
Path Parameters
projectId
string
required
Query Parameters
page
number
default:1
Specifies which page of results to return
Required range: x >= 1
pageSize
number
default:50
Number of records to return per page
includeCount
boolean
default:false
If true, includes the total count of records
hidden
boolean
default:false
status
enum<string>
Available options:
PENDING,
EXTERNAL_SCREENER_IN_PROGRESS,
INVITED,
SCHEDULED,
ATTENDED,
NOSHOW,
INVALIDRESPONSE,
REJECTEDQUALITY,
PAID,
CANCELLED
statuses
enum<string>[]
Available options:
PENDING,
EXTERNAL_SCREENER_IN_PROGRESS,
INVITED,
SCHEDULED,
ATTENDED,
NOSHOW,
INVALIDRESPONSE,
REJECTEDQUALITY,
PAID,
CANCELLED
qualified
boolean
favorite
boolean
visibilityStatus
enum<string>
default:VISIBLE
Available options:
DISMISSED,
VISIBLE,
ONHOLD
Response
200 - application/json
page
number
default:1
required
pageSize
number
default:50
required
totalResults
number
The total number of results possible, which is only provided in the response when includeCount is passed as true within a request.
results
object[]
Hide child attributes
results.qualified
boolean
required
results.percentage
number
required
results.status
enum<string>
required
Available options:
PENDING,
EXTERNAL_SCREENER_IN_PROGRESS,
INVITED,
SCHEDULED,
ATTENDED,
NOSHOW,
INVALIDRESPONSE,
REJECTEDQUALITY,
PAID,
CANCELLED
results.responses
object[]
required
Hide child attributes
results.responses.questionId
string
required
results.responses.questionText
string
required
results.responses.type
string
required
results.responses.questionType
enum<string>
required
Available options:
radio,
multiLineTextbox,
checkbox,
singleLineTextbox,
numericBox,
sliderScale,
fileUpload,
rank,
matrix
results.responses.answers
(object | string | number)[]
required
Always an array; the element type depends on questionType. radio: a single ScreenerQuestionAnswerValue object. checkbox: one ScreenerQuestionAnswerValue object per selected option. singleLineTextbox, multiLineTextbox, numericBox, sliderScale: a single string containing the participant's raw input (numeric and slider answers are strings, e.g. "36"; responses recorded before 2024 may contain bare numbers instead). rank, matrix and fileUpload questions carry their values in ranking/selections/files and have an empty answers array.
Hide child attributes
results.responses.answers.id
string
required
results.responses.answers.uid
string
required
results.responses.answers.text
string
required
results.responses.answers.answerValue
number
required
results.responses.answers.goToQuestionUid
string | null
results.responses.answers.isOther
boolean
results.responses.answers.other
string
results.responses.qualify
boolean
required
results.responses.order
number
results.responses.files
object[]
Only present on fileUpload answers: the files the participant uploaded.
Each file carries a temporary download url (see that property for the
expiry contract).
Hide child attributes
results.responses.files.name
string
required
The file name the participant uploaded the file under.
results.responses.files.size
number
required
File size in bytes.
results.responses.files.mime
string
required
MIME type of the file, e.g. application/pdf.
results.responses.files.uploadedAt
string<date-time>
required
results.responses.files.url
string
Temporary download URL for the file, only present while scanStatus is
clean. The link expires after a limited time (at least one hour from
when the response was fetched), so hand it to the user promptly — for
example behind a download button — rather than storing it. Once it has
expired, refetch this screener response: every fetch issues a fresh URL.
results.responses.files.scanStatus
enum<string>
Virus-scan verdict for this file. url is only issued once the verdict
is clean; pending means the scan has not finished yet, so refetch the
screener response later.
Available options:
pending,
clean,
infected,
unscanned
results.responses.note
string
Only present on fileUpload answers, and only when the participant added
an optional note alongside their files.
results.responses.selections
object[]
Hide child attributes
results.responses.selections.rowUid
string
required
results.responses.selections.rowText
string
required
results.responses.selections.answerUid
string
required
results.responses.selections.answerText
string
required
results.responses.ranking
object[]
Hide child attributes
results.responses.ranking.uid
string
required
results.responses.ranking.text
string
required
results.responses.skipped
boolean
Only present when the screener-responses-include-skipped-questions feature flag is enabled for the calling organization (default OFF). true when the participant did not answer this question — either because they chose to skip an optional question (skippedBy: user) or because skip-logic on a previous question routed them past it (skippedBy: skipLogic).
results.responses.skippedBy
enum<string>
Only present when the screener-responses-include-skipped-questions feature flag is enabled for the calling organization (default OFF). user means the participant saw the question and chose to skip it; skipLogic means the participant never saw it because skip-logic on a previous question routed past it. Absent on items where skipped is not true.
Available options:
user,
skipLogic
results.responses.shown
boolean
Only present when the screener-responses-include-skipped-questions feature flag is enabled for the calling organization (default OFF). true for answered questions and user-skipped questions (i.e. the participant saw the question); false for skip-logic-skipped questions (the participant never saw it).
results.totalTime
number
required
results.matching
object
required
Hide child attributes
results.matching.isGenderMatch
boolean
required
results.matching.isAgeMatch
boolean
required
results.matching.isEthnicityMatch
boolean
required
results.matching.isEducationMatch
boolean
required
results.matching.questionsQualified
boolean
required
results.matching.isLocationMatch
boolean
required
results.matching.isIndustryMatch
boolean
required
results.matching.isJobTitleMatch
boolean
required
results.matching.isHouseholdIncomeMatch
boolean
required
results.matching.isCompanySizeMatch
boolean
required
results.matching.isTopicsMatch
boolean
results.visibility
object
required
The visibility status of the screener response.
If a screener response is visible, it can be interacted with (invited etc).
If a screener response is not visible, it cannot be interacted with.
A screener may be hidden for various reasons, and a screener can change from visible
to not visible at any time if a participant or screener is found to be untrustworthy.
There is a webhook that will notify the client when a screener response changes visibility.
Hide child attributes
results.visibility.status
enum<string>
default:VISIBLE
required
Available options:
DISMISSED,
VISIBLE,
ONHOLD
results.id
string
required
results.projectId
string
required
results.userId
string
required
results.qualifiedPendingIdVerification
boolean
This property is set to true (with qualified set to false) if the participant has qualified based on their responses to the screener, but is in the process of verifying their identity.
Once the participant has completed ID verification, qualifiedPendingIdVerification will be set to false.
If the verification was successful, qualified will be set to true.
If the verification failed, qualified will remain set to false unless they were manually qualified through the qualification endpoint
(PATCH /projects/{projectId}/screener-responses/{screenerResponseId}/qualify).
results.favorite
boolean
results.hidden
boolean
results.isNew
boolean
results.inviteSentAt
string<date-time>
results.invited
boolean
results.scheduledAt
string<date-time>
results.statusUpdatedAt
string<date-time>
results.ndaUrl
string
results.ndaAgree
boolean
results.project
object
Hide child attributes
results.project.name
string
required
results.project.incentive
number
required
results.project.id
string
required
results.project.organizationId
string
required
results.project.teamId
string
required
results.profile
object
Hide child attributes
results.profile.id
string<ObjectId>
required
results.profile.userId
string<ObjectId>
required
results.profile.firstName
string
required
results.profile.lastName
string
required
results.profile.skills
object[]
required
Hide child attributes
results.profile.skills.id
string<ObjectId>
required
results.profile.skills.name
string
required
results.profile.skills.slug
string
required
results.profile.skills.validated
boolean
default:false
required
results.profile.skills.type
string
default:skill
required
results.profile.picture
string | null
results.externalProject
object
Hide child attributes
results.externalProject.researcherId
string
required
results.externalProject.bookingUrl
string
results.externalProject.meetingCancelLink
string<uri>
Link to cancel a meeting. If not set, bookingLink will be used.
results.externalProject.bookedDate
string<date-time>
results.externalProject.timezone
string
IANA timezone. Example: 'America/New_York'
results.invitation
object
Hide child attributes
results.invitation.id
string<ObjectId>
required
results.invitation.remoteCommunicationDetails
string<uri>
results.invitation.event
object
Hide child attributes
results.invitation.event.uid
string
required
results.invitation.message
string
This will override the special instructions from the project.
results.invitation.videoProvider
object
Hide child attributes
results.invitation.videoProvider.loginProviderId
string
required
results.invitation.videoProvider.providerKey
enum<string>
required
Available options:
zoom
results.invitation.videoProvider.userId
string
required
results.actor
enum<string>
Available options:
researcher,
respondent,
admin
results.reason
enum<string>
Available options:
time,
final
results.shortNoticeCancel
boolean
results.message
string
results.rejection
object
Hide child attributes
results.rejection.message
string
required
results.rejection.rejectedAt
string<date-time>
required
results.createdAt
string<date-time>
results.task
object
Hide child attributes
results.task.completedAt
string
Timestamp when the task was completed.
This field is automatically set when participants access the project's completionUrl.
results.quotaAssignment
object
Read-only. Which quota segments this response occupies and in which
consumption tier. Present when the project has a quota.
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Respondent API","colors":{"primary":"#0003C9","light":"#2E90FA"},"logo":{"light":"https://mintcdn.com/respondentio/1IlvD-ZbNqUuKfqV/images/main-logo.svg?fit=max\u0026auto=format\u0026n=1IlvD-ZbNqUuKfqV\u0026q=85\u0026s=e98b93965ff41fd386d3352299fc0ed0","dark":"https://mintcdn.com/respondentio/1IlvD-ZbNqUuKfqV/images/logo-white.svg?fit=max\u0026auto=format\u0026n=1IlvD-ZbNqUuKfqV\u0026q=85\u0026s=11faec295f93a4dffd5ba3db361c7df2","href":"/docs/Getting-started/quickstart"},"favicon":"https://mintcdn.com/respondentio/gxYdieii-EJUadzc/favicon.png?fit=max\u0026auto=format\u0026n=gxYdieii-EJUadzc\u0026q=85\u0026s=da53322578506c9e4a4ea14a698ab252","api":{"params":{"expanded":"all"},"examples":{"defaults":"required"}},"styling":{"eyebrows":"section","latex":false},"contextual":{"options":["assistant","view","download-spec","mcp","add-mcp"],"display":"header"},"metadata":{"timestamp":true},"markdown":{"schema":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"respondentio","hasAudioNarration":false,"actualSubdomain":"respondentio","customDomains":["developers.respondent.io"],"gitSource":{"type":"github","owner":"respondentinc","repo":"respondent","deployBranch":"main","contentDirectory":"apps/api-docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afe835362c0bddbc5ea3abc","clientVersion":"0.0.4227","searchFilterCounts":[{"language":"default","tag":"API Endpoints","count":81},{"language":"default","tag":"Guides","count":36},{"language":"default","tag":"Change Log","count":30},{"language":"default","tag":"Product Updates","count":30},{"language":"default","tag":"Screeners and Responses","count":10},{"language":"default","tag":"Projects","count":9},{"language":"default","tag":"Team Tools","count":8},{"language":"default","tag":"Webhooks","count":7},{"language":"default","tag":"Invite \u0026 Schedule Participants","count":7},{"language":"default","tag":"Getting started","count":6}],"searchSettings":{"showContentSnippets":true}},"assistantConfig":{"enableStarterQuestions":true,"enableContextualStarterQuestions":true,"deflection":{"enabled":true,"email":"partnersupport@respondent.io","showHelpButton":true}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"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":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"69ae2c3b0e586ea429d4fa3e","deploymentId":"6865f8a7787fbe9472a1f8da","questionText":"What are the steps to production?","status":"active","generatedBy":"manual","createdAt":"2026-03-09T02:11:07.244Z","updatedAt":"2026-03-09T02:11:07.244Z","__v":0},{"_id":"69ae2c350e586ea429d4fa21","deploymentId":"6865f8a7787fbe9472a1f8da","questionText":"How do I handle participants submitting low quality responses?","status":"active","generatedBy":"manual","createdAt":"2026-03-09T02:11:01.130Z","updatedAt":"2026-03-09T02:11:01.130Z","__v":0},{"_id":"69ae2c1c0e586ea429d4f9ef","deploymentId":"6865f8a7787fbe9472a1f8da","questionText":"How do I test the participant flow in staging?","status":"active","generatedBy":"manual","createdAt":"2026-03-09T02:10:36.092Z","updatedAt":"2026-03-09T02:10:36.092Z","__v":0}],"privacy":{"consentBanner":{"enabled":true}},"googleFontsInlined":false},"customCss":[{"filePath":"styles/custom.css","content":".prose h2{margin-top:2.5rem;margin-bottom:1rem}.prose h3{margin-top:2rem;margin-bottom:0.75rem}.prose p+p{margin-top:0.75rem}pre[class*=\"language-\"]{border:1px solid var(--border-color, rgba(0, 0, 0, 0.08));border-radius:0.625rem}:not(pre)>code{padding:0.15em 0.35em;font-size:0.875em;border-radius:0.25rem}[class*=\"Card\"]{transition:box-shadow 0.2s ease, transform 0.2s ease}[class*=\"Card\"]:hover{transform:translateY(-1px)}.prose table{font-size:0.9rem;width:100%}.prose table th{font-weight:600;text-align:left;white-space:nowrap}.prose table td{vertical-align:top}.prose table tbody tr:nth-child(even){background-color:rgba(0, 0, 0, 0.02)}:root[class~=\"dark\"] .prose table tbody tr:nth-child(even){background-color:rgba(255, 255, 255, 0.03)}[class*=\"Callout\"],[class*=\"callout\"]{border-left-width:3px}[class*=\"ParamField\"]+[class*=\"ParamField\"]{margin-top:0.5rem}[class*=\"method-badge\"],[class*=\"MethodBadge\"]{font-weight:700;letter-spacing:0.025em;text-transform:uppercase}@media (max-width: 768px){.prose h1{font-size:1.75rem}.prose h2{font-size:1.35rem;margin-top:2rem}pre[class*=\"language-\"]{font-size:0.8rem;overflow-x:auto;-webkit-overflow-scrolling:touch}.prose .table-wrapper,.prose table{display:block;overflow-x:auto;-webkit-overflow-scrolling:touch}[class*=\"CardGroup\"]{grid-template-columns:1fr!important}}#feedback-thumbs-up,#feedback-thumbs-down,#feedback-form,[class*=\"feedback-toolbar\"i],feedback-toolbar{display:none!important}.changelog-back,.changelog-back:link,.changelog-back:visited{display:inline-block;margin-bottom:1.5rem;font-size:0.875rem;font-weight:500;color:rgba(0, 0, 0, 0.6)!important;text-decoration:none!important;border-bottom:none!important;background-image:none!important}.changelog-back:hover{color:rgba(0, 0, 0, 0.85)!important;text-decoration:underline!important}:root[class~=\"dark\"] .changelog-back,:root[class~=\"dark\"] .changelog-back:link,:root[class~=\"dark\"] .changelog-back:visited{color:rgba(255, 255, 255, 0.6)!important}:root[class~=\"dark\"] .changelog-back:hover{color:#fff!important}.changelog-timeline{position:relative;margin:2rem 0}.changelog-entry{display:grid;grid-template-columns:180px 1fr;gap:2.5rem;padding:2rem 0;border-top:1px solid var(--border-color, rgba(0, 0, 0, 0.08))}.changelog-entry:first-of-type{border-top:none;padding-top:0.5rem}:root[class~=\"dark\"] .changelog-entry{border-top-color:rgba(255, 255, 255, 0.08)}.changelog-meta{display:flex;flex-direction:column;align-items:flex-start;gap:0.5rem;padding-top:0.15rem}.changelog-date{font-weight:600;font-size:0.875rem;color:rgba(0, 0, 0, 0.55);letter-spacing:0.05em;text-transform:uppercase}:root[class~=\"dark\"] .changelog-date{color:rgba(255, 255, 255, 0.55)}.changelog-content{font-size:0.95rem;line-height:1.65}.changelog-title,.changelog-title:link,.changelog-title:visited{display:block;font-size:1.15rem;font-weight:600;line-height:1.35;color:inherit!important;text-decoration:none!important;border-bottom:none!important;background-image:none!important;margin-bottom:1rem}:root[class~=\"dark\"] .changelog-title,:root[class~=\"dark\"] .changelog-title:link,:root[class~=\"dark\"] .changelog-title:visited{color:#fff!important}.changelog-title:hover{text-decoration:underline!important}.changelog-body{margin:0!important;color:rgba(0, 0, 0, 0.7)}:root[class~=\"dark\"] .changelog-body{color:rgba(255, 255, 255, 0.7)}@media (max-width: 640px){.changelog-entry{grid-template-columns:1fr;gap:0.75rem;padding:1.5rem 0}.changelog-meta{flex-direction:row;align-items:center}}.changelog-tag{display:inline-block;padding:0.15rem 0.6rem;font-size:0.75rem;font-weight:600;border-radius:9999px;letter-spacing:0.02em;line-height:1.4;border:1px solid transparent}.changelog-tag.new-feature{background:rgba(16, 185, 129, 0.12);color:#047857;border-color:rgba(16, 185, 129, 0.3)}.changelog-tag.improvement{background:rgba(59, 130, 246, 0.12);color:#1d4ed8;border-color:rgba(59, 130, 246, 0.3)}.changelog-tag.bug-fix{background:rgba(234, 179, 8, 0.15);color:#a16207;border-color:rgba(234, 179, 8, 0.35)}.changelog-tag.breaking-change{background:rgba(239, 68, 68, 0.12);color:#b91c1c;border-color:rgba(239, 68, 68, 0.3)}:root[class~=\"dark\"] .changelog-tag.new-feature{background:rgba(16, 185, 129, 0.18);color:#6ee7b7;border-color:rgba(16, 185, 129, 0.4)}:root[class~=\"dark\"] .changelog-tag.improvement{background:rgba(59, 130, 246, 0.2);color:#93c5fd;border-color:rgba(59, 130, 246, 0.4)}:root[class~=\"dark\"] .changelog-tag.bug-fix{background:rgba(234, 179, 8, 0.2);color:#fde047;border-color:rgba(234, 179, 8, 0.4)}:root[class~=\"dark\"] .changelog-tag.breaking-change{background:rgba(239, 68, 68, 0.2);color:#fca5a5;border-color:rgba(239, 68, 68, 0.4)}update a,update a:link,update a:visited,[class*=\"update\"i] a,[data-component-name*=\"update\"i] a,.prose update a,.prose [class*=\"update\"i] a{text-decoration:none!important;text-decoration-line:none!important;border-bottom:0!important;box-shadow:none!important;background-image:none!important}update a:hover,[class*=\"update\"i] a:hover,[data-component-name*=\"update\"i] a:hover,.prose update a:hover,.prose [class*=\"update\"i] a:hover{text-decoration:underline!important;text-decoration-line:underline!important}update a:hover strong,[class*=\"update\"i] a:hover strong{text-decoration:underline!important}@media print{nav,aside,[class*=\"sidebar\"],[class*=\"toc\"]{display:none!important}pre{break-inside:avoid}}"}]}
{"page":{"pagePath":"screener-responses/list-screener-responses","slug":"/screener-responses/list-screener-responses","pageMetadata":{"openapi":"get /v1/projects/{projectId}/screener-responses","description":"List all screener responses for a project with filtering and pagination. Use query parameters to filter by status, qualification state, or date range.","title":"List screener responses","href":"/screener-responses/list-screener-responses"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"List all screener responses for a project with filtering and pagination. Use query parameters to filter by status, qualification state, or date range.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Heading,Step,Steps,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(Heading,{level:`2`,id:`typical-workflow`,children:`Typical workflow`}),`\n`,_jsxs(Steps,{children:[_jsx(Step,{title:`List responses`,children:_jsx(_components.p,{children:`Retrieve screener responses and review participant answers.`})}),_jsx(Step,{title:`Qualify or disqualify`,children:_jsxs(_components.p,{children:[`Use `,_jsx(_components.a,{href:`/screener-responses/qualify-participant`,children:`Qualify Participant`}),` to approve or reject based on screener answers.`]})}),_jsx(Step,{title:`Invite qualified participants`,children:_jsxs(_components.p,{children:[`Send invitations via `,_jsx(_components.a,{href:`/screener-responses/invite-participant`,children:`Invite Participant`}),`.`]})}),_jsx(Step,{title:`Mark attendance and pay`,children:_jsxs(_components.p,{children:[`After the session, use `,_jsx(_components.a,{href:`/screener-responses/mark-as-attended`,children:`Mark as Attended`}),` to trigger payment.`]})})]}),`\n`,_jsx(Heading,{level:`2`,id:`file-upload-answers`,children:`File upload answers`}),`\n`,_jsxs(_components.p,{children:[`Answers to `,_jsx(_components.code,{children:`fileUpload`}),` questions carry a `,_jsx(_components.code,{children:`files`}),` array and an optional `,_jsx(_components.code,{children:`note`}),`\nthe participant left with their upload. Each file includes its metadata\n(`,_jsx(_components.code,{children:`name`}),`, `,_jsx(_components.code,{children:`size`}),`, `,_jsx(_components.code,{children:`mime`}),`, `,_jsx(_components.code,{children:`uploadedAt`}),`, `,_jsx(_components.code,{children:`scanStatus`}),`) and a temporary `,_jsx(_components.code,{children:`url`}),` to\ndownload it. The internal storage key is not exposed on responses.`]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Download URLs expire. Every URL is valid for at least one hour from the\nmoment the response is fetched, but not indefinitely. Do not cache or store\nthe URL.`})}),`\n`,_jsxs(_components.p,{children:[`The recommended pattern is a download button in your UI backed by the most\nrecently fetched URL. When a URL has expired, refetch either this list or the\n`,_jsx(_components.a,{href:`/screener-responses/view-a-specific-response`,children:`specific screener response`}),`.\nEach fetch issues fresh URLs for every file.`]}),`\n`,_jsxs(_components.p,{children:[`A file only carries a `,_jsx(_components.code,{children:`url`}),` once its virus scan has passed. Until then\n`,_jsx(_components.code,{children:`scanStatus`}),` is `,_jsx(_components.code,{children:`pending`}),` and the `,_jsx(_components.code,{children:`url`}),` property is absent. Refetch the\nresponse later to get the URL. A file whose `,_jsx(_components.code,{children:`scanStatus`}),` is `,_jsx(_components.code,{children:`infected`}),` is\nnever downloadable.`]})]})}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":{"openapi":"get /v1/projects/{projectId}/screener-responses","description":"List all screener responses for a project with filtering and pagination. Use query parameters to filter by status, qualification state, or date range.","title":"List screener responses","href":"/screener-responses/list-screener-responses"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Typical workflow","slug":"typical-workflow","depth":2,"children":[]},{"title":"File upload answers","slug":"file-upload-answers","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"ScreenerResponsesController_findAll","parameters":["76df2d09-35ee-4c63-82b3-b5eb6e9451a1","e06f1058-44f1-4905-bd85-c67f110cb493","d794e5a2-bf02-4631-bf0d-b328d6ff2c38","c5af94e9-55ae-4b0f-8992-8b70713ba69c","32815d57-d140-4ccb-b577-55095e7b09d7","d1b5a223-c50e-49f0-83d7-27ca27a50a31","04c53e59-e69d-4155-8317-3f71db028db3","43f94bf5-c053-4d08-a04e-2b9e0be964d1","fd47a1ec-a04b-4a2e-8165-8bcda5ad86de","d6245dcf-ee5f-4c9b-8b0f-299b4684fa9c","12fcd734-ff83-4b1b-9126-f8d7ae3f6594","24b8da9a-18c4-46c3-ab0f-bfed14f12a62"],"responses":{"200":"66c5b2d3-85ca-4564-b88d-f2353f23faaa"},"summary":"List screener responses","tags":["screener-responses"],"method":"get","type":"path","servers":["60754777-68b7-405c-89bd-78ca8b707e3b"],"security":[],"path":"/v1/projects/{projectId}/screener-responses","baseUrlOptions":["https://api-staging.respondent.io"],"title":"List screener responses","description":"List all screener responses for a project with filtering and pagination. Use query parameters to filter by status, qualification state, or date range.","codeSamples":[],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"76df2d09-35ee-4c63-82b3-b5eb6e9451a1":{"name":"x-api-key","in":"header","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"e06f1058-44f1-4905-bd85-c67f110cb493":{"name":"x-api-secret","in":"header","required":true,"schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"d794e5a2-bf02-4631-bf0d-b328d6ff2c38":{"name":"projectId","required":true,"in":"path","schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"c5af94e9-55ae-4b0f-8992-8b70713ba69c":{"name":"page","required":false,"in":"query","description":"Specifies which page of results to return","schema":{"minimum":1,"default":1,"type":"number","isRequired":false,"description":"Specifies which page of results to return","uniqueKey":"","typeLabel":"number"}},"32815d57-d140-4ccb-b577-55095e7b09d7":{"name":"pageSize","required":false,"in":"query","description":"Number of records to return per page","schema":{"type":"number","default":50,"isRequired":false,"description":"Number of records to return per page","uniqueKey":"","typeLabel":"number"}},"d1b5a223-c50e-49f0-83d7-27ca27a50a31":{"name":"includeCount","required":false,"in":"query","description":"If true, includes the total count of records","schema":{"type":"boolean","default":false,"isRequired":false,"description":"If true, includes the total count of records","uniqueKey":"","typeLabel":"boolean"}},"04c53e59-e69d-4155-8317-3f71db028db3":{"name":"hidden","required":false,"in":"query","schema":{"type":"boolean","default":false,"isRequired":false,"uniqueKey":"","typeLabel":"boolean"}},"43f94bf5-c053-4d08-a04e-2b9e0be964d1":{"name":"status","required":false,"in":"query","schema":{"type":"string","enum":["PENDING","EXTERNAL_SCREENER_IN_PROGRESS","INVITED","SCHEDULED","ATTENDED","NOSHOW","INVALIDRESPONSE","REJECTEDQUALITY","PAID","CANCELLED"],"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}},"fd47a1ec-a04b-4a2e-8165-8bcda5ad86de":{"name":"statuses","required":false,"in":"query","schema":{"type":"array","items":{"type":"string","enum":["PENDING","EXTERNAL_SCREENER_IN_PROGRESS","INVITED","SCHEDULED","ATTENDED","NOSHOW","INVALIDRESPONSE","REJECTEDQUALITY","PAID","CANCELLED"],"uniqueKey":"items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>[]"}},"d6245dcf-ee5f-4c9b-8b0f-299b4684fa9c":{"name":"qualified","required":false,"in":"query","schema":{"type":"boolean","isRequired":false,"uniqueKey":"","typeLabel":"boolean"}},"12fcd734-ff83-4b1b-9126-f8d7ae3f6594":{"name":"favorite","required":false,"in":"query","schema":{"type":"boolean","isRequired":false,"uniqueKey":"","typeLabel":"boolean"}},"24b8da9a-18c4-46c3-ab0f-bfed14f12a62":{"name":"visibilityStatus","required":false,"in":"query","schema":{"type":"string","enum":["DISMISSED","VISIBLE","ONHOLD"],"default":"VISIBLE","isRequired":false,"uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"66c5b2d3-85ca-4564-b88d-f2353f23faaa":{"description":"","content":{"application/json":{"schema":{"type":"object","properties":{"page":{"type":"number","default":1,"isRequired":true,"uniqueKey":"page","typeLabel":"number"},"pageSize":{"type":"number","default":50,"isRequired":true,"uniqueKey":"pageSize","typeLabel":"number"},"totalResults":{"type":"number","description":"The total number of results possible, which is only provided in the response when `includeCount` is passed as `true` within a request.","uniqueKey":"totalResults","typeLabel":"number"},"results":{"type":"array","items":{"type":"object","properties":{"qualified":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].qualified","typeLabel":"boolean"},"percentage":{"type":"number","isRequired":true,"uniqueKey":"results.items.[INDEX].percentage","typeLabel":"number"},"status":{"type":"string","enum":["PENDING","EXTERNAL_SCREENER_IN_PROGRESS","INVITED","SCHEDULED","ATTENDED","NOSHOW","INVALIDRESPONSE","REJECTEDQUALITY","PAID","CANCELLED"],"isRequired":true,"uniqueKey":"results.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"responses":{"type":"array","items":{"type":"object","properties":{"questionId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].questionId","typeLabel":"string"},"questionText":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].questionText","typeLabel":"string"},"type":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].type","typeLabel":"string"},"questionType":{"type":"string","enum":["radio","multiLineTextbox","checkbox","singleLineTextbox","numericBox","sliderScale","fileUpload","rank","matrix"],"isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].questionType","typeLabel":"enum\u003cstring>"},"answers":{"type":"array","items":{"oneOf":[{"type":"object","required":["id","uid","text","answerValue"],"properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0.id","typeLabel":"string"},"uid":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0.uid","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0.text","typeLabel":"string"},"answerValue":{"type":"number","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0.answerValue","typeLabel":"number"},"goToQuestionUid":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0.goToQuestionUid.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0.goToQuestionUid.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0.goToQuestionUid","typeLabel":"string | null"},"isOther":{"type":"boolean","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0.isOther","typeLabel":"boolean"},"other":{"type":"string","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0.other","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"string","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.1","typeLabel":"string"},{"type":"number","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX].oneOf.2","typeLabel":"number"}],"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers.items.[INDEX]","typeLabel":"object | string | number"},"description":"Always an array; the element type depends on `questionType`. `radio`: a single `ScreenerQuestionAnswerValue` object. `checkbox`: one `ScreenerQuestionAnswerValue` object per selected option. `singleLineTextbox`, `multiLineTextbox`, `numericBox`, `sliderScale`: a single string containing the participant's raw input (numeric and slider answers are strings, e.g. \"36\"; responses recorded before 2024 may contain bare numbers instead). `rank`, `matrix` and `fileUpload` questions carry their values in `ranking`/`selections`/`files` and have an empty `answers` array.","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].answers","typeLabel":"(object | string | number)[]"},"qualify":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].qualify","typeLabel":"boolean"},"order":{"type":"number","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].order","typeLabel":"number"},"files":{"description":"Only present on `fileUpload` answers: the files the participant uploaded.\nEach file carries a temporary download `url` (see that property for the\nexpiry contract).","type":"array","items":{"type":"object","properties":{"name":{"type":"string","description":"The file name the participant uploaded the file under.","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].files.items.[INDEX].name","typeLabel":"string"},"size":{"type":"number","description":"File size in bytes.","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].files.items.[INDEX].size","typeLabel":"number"},"mime":{"type":"string","description":"MIME type of the file, e.g. `application/pdf`.","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].files.items.[INDEX].mime","typeLabel":"string"},"uploadedAt":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].files.items.[INDEX].uploadedAt","typeLabel":"string\u003cdate-time>"},"url":{"type":"string","description":"Temporary download URL for the file, only present while `scanStatus` is\n`clean`. The link expires after a limited time (at least one hour from\nwhen the response was fetched), so hand it to the user promptly — for\nexample behind a download button — rather than storing it. Once it has\nexpired, refetch this screener response: every fetch issues a fresh URL.","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].files.items.[INDEX].url","typeLabel":"string"},"scanStatus":{"type":"string","enum":["pending","clean","infected","unscanned"],"description":"Virus-scan verdict for this file. `url` is only issued once the verdict\nis `clean`; `pending` means the scan has not finished yet, so refetch the\nscreener response later.","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].files.items.[INDEX].scanStatus","typeLabel":"enum\u003cstring>"}},"required":["name","size","mime","uploadedAt"],"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].files.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].files","typeLabel":"object[]"},"note":{"type":"string","description":"Only present on `fileUpload` answers, and only when the participant added\nan optional note alongside their files.","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].note","typeLabel":"string"},"selections":{"type":"array","items":{"type":"object","properties":{"rowUid":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].selections.items.[INDEX].rowUid","typeLabel":"string"},"rowText":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].selections.items.[INDEX].rowText","typeLabel":"string"},"answerUid":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].selections.items.[INDEX].answerUid","typeLabel":"string"},"answerText":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].selections.items.[INDEX].answerText","typeLabel":"string"}},"required":["rowUid","rowText","answerUid","answerText"],"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].selections.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].selections","typeLabel":"object[]"},"ranking":{"type":"array","items":{"type":"object","properties":{"uid":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].ranking.items.[INDEX].uid","typeLabel":"string"},"text":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].ranking.items.[INDEX].text","typeLabel":"string"}},"required":["uid","text"],"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].ranking.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results.items.[INDEX].responses.items.[INDEX].ranking","typeLabel":"object[]"},"skipped":{"type":"boolean","description":"Only present when the `screener-responses-include-skipped-questions` feature flag is enabled for the calling organization (default OFF). `true` when the participant did not answer this question — either because they chose to skip an optional question (`skippedBy: user`) or because skip-logic on a previous question routed them past it (`skippedBy: skipLogic`).","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].skipped","typeLabel":"boolean"},"skippedBy":{"enum":["user","skipLogic"],"type":"string","description":"Only present when the `screener-responses-include-skipped-questions` feature flag is enabled for the calling organization (default OFF). `user` means the participant saw the question and chose to skip it; `skipLogic` means the participant never saw it because skip-logic on a previous question routed past it. Absent on items where `skipped` is not `true`.","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].skippedBy","typeLabel":"enum\u003cstring>"},"shown":{"type":"boolean","description":"Only present when the `screener-responses-include-skipped-questions` feature flag is enabled for the calling organization (default OFF). `true` for answered questions and user-skipped questions (i.e. the participant saw the question); `false` for skip-logic-skipped questions (the participant never saw it).","uniqueKey":"results.items.[INDEX].responses.items.[INDEX].shown","typeLabel":"boolean"}},"required":["questionId","questionText","type","questionType","answers","qualify"],"uniqueKey":"results.items.[INDEX].responses.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.items.[INDEX].responses","typeLabel":"object[]"},"totalTime":{"type":"number","isRequired":true,"uniqueKey":"results.items.[INDEX].totalTime","typeLabel":"number"},"matching":{"type":"object","properties":{"isGenderMatch":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.isGenderMatch","typeLabel":"boolean"},"isAgeMatch":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.isAgeMatch","typeLabel":"boolean"},"isEthnicityMatch":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.isEthnicityMatch","typeLabel":"boolean"},"isEducationMatch":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.isEducationMatch","typeLabel":"boolean"},"questionsQualified":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.questionsQualified","typeLabel":"boolean"},"isLocationMatch":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.isLocationMatch","typeLabel":"boolean"},"isIndustryMatch":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.isIndustryMatch","typeLabel":"boolean"},"isJobTitleMatch":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.isJobTitleMatch","typeLabel":"boolean"},"isHouseholdIncomeMatch":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.isHouseholdIncomeMatch","typeLabel":"boolean"},"isCompanySizeMatch":{"type":"boolean","isRequired":true,"uniqueKey":"results.items.[INDEX].matching.isCompanySizeMatch","typeLabel":"boolean"},"isTopicsMatch":{"type":"boolean","uniqueKey":"results.items.[INDEX].matching.isTopicsMatch","typeLabel":"boolean"}},"required":["isGenderMatch","isAgeMatch","isEthnicityMatch","isEducationMatch","questionsQualified","isLocationMatch","isIndustryMatch","isJobTitleMatch","isHouseholdIncomeMatch","isCompanySizeMatch"],"isRequired":true,"uniqueKey":"results.items.[INDEX].matching","typeLabel":"object"},"visibility":{"type":"object","description":"The visibility status of the screener response.\nIf a screener response is visible, it can be interacted with (invited etc).\nIf a screener response is not visible, it cannot be interacted with.\nA screener may be hidden for various reasons, and a screener can change from visible\nto not visible at any time if a participant or screener is found to be untrustworthy.\nThere is a webhook that will notify the client when a screener response changes visibility.","required":["status"],"properties":{"status":{"type":"string","enum":["DISMISSED","VISIBLE","ONHOLD"],"default":"VISIBLE","isRequired":true,"uniqueKey":"results.items.[INDEX].visibility.status","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"results.items.[INDEX].visibility","typeLabel":"object"},"id":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].id","typeLabel":"string"},"projectId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].projectId","typeLabel":"string"},"userId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].userId","typeLabel":"string"},"qualifiedPendingIdVerification":{"type":"boolean","description":"- This property is set to `true` (with `qualified` set to `false`) if the participant has qualified based on their responses to the screener, but is in the process of verifying their identity.\n- Once the participant has completed ID verification, `qualifiedPendingIdVerification` will be set to false.\n - If the verification was successful, `qualified` will be set to `true`.\n - If the verification failed, `qualified` will remain set to `false` unless they were manually qualified through the qualification endpoint\n(`PATCH /projects/{projectId}/screener-responses/{screenerResponseId}/qualify`).","uniqueKey":"results.items.[INDEX].qualifiedPendingIdVerification","typeLabel":"boolean"},"favorite":{"type":"boolean","uniqueKey":"results.items.[INDEX].favorite","typeLabel":"boolean"},"hidden":{"type":"boolean","uniqueKey":"results.items.[INDEX].hidden","typeLabel":"boolean"},"isNew":{"type":"boolean","uniqueKey":"results.items.[INDEX].isNew","typeLabel":"boolean"},"inviteSentAt":{"format":"date-time","type":"string","uniqueKey":"results.items.[INDEX].inviteSentAt","typeLabel":"string\u003cdate-time>"},"invited":{"type":"boolean","uniqueKey":"results.items.[INDEX].invited","typeLabel":"boolean"},"scheduledAt":{"format":"date-time","type":"string","uniqueKey":"results.items.[INDEX].scheduledAt","typeLabel":"string\u003cdate-time>"},"statusUpdatedAt":{"format":"date-time","type":"string","uniqueKey":"results.items.[INDEX].statusUpdatedAt","typeLabel":"string\u003cdate-time>"},"ndaUrl":{"type":"string","uniqueKey":"results.items.[INDEX].ndaUrl","typeLabel":"string"},"ndaAgree":{"type":"boolean","uniqueKey":"results.items.[INDEX].ndaAgree","typeLabel":"boolean"},"project":{"type":"object","properties":{"name":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].project.name","typeLabel":"string"},"incentive":{"type":"number","isRequired":true,"uniqueKey":"results.items.[INDEX].project.incentive","typeLabel":"number"},"id":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].project.id","typeLabel":"string"},"organizationId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].project.organizationId","typeLabel":"string"},"teamId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].project.teamId","typeLabel":"string"}},"required":["name","incentive","id","organizationId","teamId"],"uniqueKey":"results.items.[INDEX].project","typeLabel":"object"},"profile":{"type":"object","properties":{"id":{"type":"string","format":"ObjectId","isRequired":true,"uniqueKey":"results.items.[INDEX].profile.id","typeLabel":"string\u003cObjectId>"},"userId":{"type":"string","format":"ObjectId","isRequired":true,"uniqueKey":"results.items.[INDEX].profile.userId","typeLabel":"string\u003cObjectId>"},"firstName":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].profile.firstName","typeLabel":"string"},"lastName":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].profile.lastName","typeLabel":"string"},"skills":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","format":"ObjectId","isRequired":true,"uniqueKey":"results.items.[INDEX].profile.skills.items.[INDEX].id","typeLabel":"string\u003cObjectId>"},"name":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].profile.skills.items.[INDEX].name","typeLabel":"string"},"slug":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].profile.skills.items.[INDEX].slug","typeLabel":"string"},"validated":{"type":"boolean","default":false,"isRequired":true,"uniqueKey":"results.items.[INDEX].profile.skills.items.[INDEX].validated","typeLabel":"boolean"},"type":{"type":"string","default":"skill","isRequired":true,"uniqueKey":"results.items.[INDEX].profile.skills.items.[INDEX].type","typeLabel":"string"}},"required":["id","name","slug","validated","type"],"uniqueKey":"results.items.[INDEX].profile.skills.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.items.[INDEX].profile.skills","typeLabel":"object[]"},"picture":{"oneOf":[{"type":"string","uniqueKey":"results.items.[INDEX].profile.picture.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"results.items.[INDEX].profile.picture.oneOf.1","typeLabel":"null"}],"uniqueKey":"results.items.[INDEX].profile.picture","typeLabel":"string | null"}},"required":["id","userId","firstName","lastName","skills"],"uniqueKey":"results.items.[INDEX].profile","typeLabel":"object"},"externalProject":{"type":"object","properties":{"researcherId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].externalProject.researcherId","typeLabel":"string"},"bookingUrl":{"type":"string","uniqueKey":"results.items.[INDEX].externalProject.bookingUrl","typeLabel":"string"},"meetingCancelLink":{"type":"string","description":"Link to cancel a meeting. If not set, bookingLink will be used.","format":"uri","uniqueKey":"results.items.[INDEX].externalProject.meetingCancelLink","typeLabel":"string\u003curi>"},"bookedDate":{"format":"date-time","type":"string","uniqueKey":"results.items.[INDEX].externalProject.bookedDate","typeLabel":"string\u003cdate-time>"},"timezone":{"type":"string","description":"IANA timezone. Example: 'America/New_York'","uniqueKey":"results.items.[INDEX].externalProject.timezone","typeLabel":"string"}},"required":["researcherId"],"uniqueKey":"results.items.[INDEX].externalProject","typeLabel":"object"},"invitation":{"type":"object","properties":{"id":{"type":"string","format":"ObjectId","isRequired":true,"uniqueKey":"results.items.[INDEX].invitation.id","typeLabel":"string\u003cObjectId>"},"remoteCommunicationDetails":{"type":"string","format":"uri","uniqueKey":"results.items.[INDEX].invitation.remoteCommunicationDetails","typeLabel":"string\u003curi>"},"event":{"type":"object","properties":{"uid":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].invitation.event.uid","typeLabel":"string"}},"required":["uid"],"uniqueKey":"results.items.[INDEX].invitation.event","typeLabel":"object"},"message":{"type":"string","description":"This will override the special instructions from the project.","default":null,"uniqueKey":"results.items.[INDEX].invitation.message","typeLabel":"string"},"videoProvider":{"type":"object","properties":{"loginProviderId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].invitation.videoProvider.loginProviderId","typeLabel":"string"},"providerKey":{"type":"string","enum":["zoom"],"isRequired":true,"uniqueKey":"results.items.[INDEX].invitation.videoProvider.providerKey","typeLabel":"enum\u003cstring>"},"userId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].invitation.videoProvider.userId","typeLabel":"string"}},"required":["loginProviderId","providerKey","userId"],"uniqueKey":"results.items.[INDEX].invitation.videoProvider","typeLabel":"object"}},"required":["id"],"uniqueKey":"results.items.[INDEX].invitation","typeLabel":"object"},"actor":{"type":"string","enum":["researcher","respondent","admin"],"uniqueKey":"results.items.[INDEX].actor","typeLabel":"enum\u003cstring>"},"reason":{"type":"string","enum":["time","final"],"uniqueKey":"results.items.[INDEX].reason","typeLabel":"enum\u003cstring>"},"shortNoticeCancel":{"type":"boolean","uniqueKey":"results.items.[INDEX].shortNoticeCancel","typeLabel":"boolean"},"message":{"type":"string","uniqueKey":"results.items.[INDEX].message","typeLabel":"string"},"rejection":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].rejection.message","typeLabel":"string"},"rejectedAt":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].rejection.rejectedAt","typeLabel":"string\u003cdate-time>"}},"required":["message","rejectedAt"],"uniqueKey":"results.items.[INDEX].rejection","typeLabel":"object"},"createdAt":{"format":"date-time","type":"string","uniqueKey":"results.items.[INDEX].createdAt","typeLabel":"string\u003cdate-time>"},"task":{"type":"object","properties":{"completedAt":{"type":"string","description":"Timestamp when the task was completed.\nThis field is automatically set when participants access the project's completionUrl.","uniqueKey":"results.items.[INDEX].task.completedAt","typeLabel":"string"}},"uniqueKey":"results.items.[INDEX].task","typeLabel":"object"},"quotaAssignment":{"type":"object","description":"Read-only. Which quota segments this response occupies and in which\nconsumption tier. Present when the project has a quota.","required":["segments","tier","revision","assignedAt","tierChangedAt"],"properties":{"segments":{"type":"array","items":{"type":"object","properties":{"groupId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].quotaAssignment.segments.items.[INDEX].groupId","typeLabel":"string"},"segmentId":{"type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].quotaAssignment.segments.items.[INDEX].segmentId","typeLabel":"string"}},"required":["groupId","segmentId"],"uniqueKey":"results.items.[INDEX].quotaAssignment.segments.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"results.items.[INDEX].quotaAssignment.segments","typeLabel":"object[]"},"tier":{"type":"string","enum":["PENDING","INVITED","ATTENDED","RELEASED"],"isRequired":true,"uniqueKey":"results.items.[INDEX].quotaAssignment.tier","typeLabel":"enum\u003cstring>"},"revision":{"type":"integer","isRequired":true,"uniqueKey":"results.items.[INDEX].quotaAssignment.revision","typeLabel":"integer"},"assignedAt":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].quotaAssignment.assignedAt","typeLabel":"string\u003cdate-time>"},"tierChangedAt":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"results.items.[INDEX].quotaAssignment.tierChangedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"results.items.[INDEX].quotaAssignment","typeLabel":"object"}},"required":["qualified","percentage","status","responses","totalTime","matching","visibility","id","projectId","userId"],"uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"uniqueKey":"results","typeLabel":"object[]"}},"required":["page","pageSize"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"page":1,"pageSize":50,"totalResults":123,"results":[{"qualified":true,"percentage":123,"status":"PENDING","responses":[{"questionId":"\u003cstring>","questionText":"\u003cstring>","type":"\u003cstring>","questionType":"radio","answers":[{"id":"\u003cstring>","uid":"\u003cstring>","text":"\u003cstring>","answerValue":123,"goToQuestionUid":"\u003cstring>","isOther":true,"other":"\u003cstring>"}],"qualify":true,"order":123,"files":[{"name":"\u003cstring>","size":123,"mime":"\u003cstring>","uploadedAt":"2023-11-07T05:31:56Z","url":"\u003cstring>","scanStatus":"pending"}],"note":"\u003cstring>","selections":[{"rowUid":"\u003cstring>","rowText":"\u003cstring>","answerUid":"\u003cstring>","answerText":"\u003cstring>"}],"ranking":[{"uid":"\u003cstring>","text":"\u003cstring>"}],"skipped":true,"skippedBy":"user","shown":true}],"totalTime":123,"matching":{"isGenderMatch":true,"isAgeMatch":true,"isEthnicityMatch":true,"isEducationMatch":true,"questionsQualified":true,"isLocationMatch":true,"isIndustryMatch":true,"isJobTitleMatch":true,"isHouseholdIncomeMatch":true,"isCompanySizeMatch":true,"isTopicsMatch":true},"visibility":{"status":"VISIBLE"},"id":"\u003cstring>","projectId":"\u003cstring>","userId":"\u003cstring>","qualifiedPendingIdVerification":true,"favorite":true,"hidden":true,"isNew":true,"inviteSentAt":"2023-11-07T05:31:56Z","invited":true,"scheduledAt":"2023-11-07T05:31:56Z","statusUpdatedAt":"2023-11-07T05:31:56Z","ndaUrl":"\u003cstring>","ndaAgree":true,"project":{"name":"\u003cstring>","incentive":123,"id":"\u003cstring>","organizationId":"\u003cstring>","teamId":"\u003cstring>"},"profile":{"id":"\u003cstring>","userId":"\u003cstring>","firstName":"\u003cstring>","lastName":"\u003cstring>","skills":[{"id":"\u003cstring>","name":"\u003cstring>","slug":"\u003cstring>","validated":false,"type":"skill"}],"picture":"\u003cstring>"},"externalProject":{"researcherId":"\u003cstring>","bookingUrl":"\u003cstring>","meetingCancelLink":"\u003cstring>","bookedDate":"2023-11-07T05:31:56Z","timezone":"\u003cstring>"},"invitation":{"id":"\u003cstring>","remoteCommunicationDetails":"\u003cstring>","event":{"uid":"\u003cstring>"},"message":null,"videoProvider":{"loginProviderId":"\u003cstring>","providerKey":"zoom","userId":"\u003cstring>"}},"actor":"researcher","reason":"time","shortNoticeCancel":true,"message":"\u003cstring>","rejection":{"message":"\u003cstring>","rejectedAt":"2023-11-07T05:31:56Z"},"createdAt":"2023-11-07T05:31:56Z","task":{"completedAt":"\u003cstring>"},"quotaAssignment":{"segments":[{"groupId":"\u003cstring>","segmentId":"\u003cstring>"}],"tier":"PENDING","revision":123,"assignedAt":"2023-11-07T05:31:56Z","tierChangedAt":"2023-11-07T05:31:56Z"}}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{},"servers":{"60754777-68b7-405c-89bd-78ca8b707e3b":{"url":"https://api-staging.respondent.io"}}},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"respondentio","siteName":"Respondent API","title":"List screener responses - Respondent API","relatedPagesConfig":{"enabled":false,"limit":5,"mode":"automatic"},"contextualStarterQuestions":[{"_id":"6a9a3c3f39df3fe1cd51bf67","deploymentId":"6865f8a7787fbe9472a1f8da","questionText":"How do I qualify participants?","status":"active","generatedBy":"contextual","path":"screener-responses/list-screener-responses","createdAt":"2026-09-04T03:34:23.147Z","updatedAt":"2026-09-04T03:34:23.147Z","__v":0},{"_id":"6a9a3c3f39df3fe1cd51bf66","deploymentId":"6865f8a7787fbe9472a1f8da","questionText":"When do file download URLs expire?","status":"active","generatedBy":"contextual","path":"screener-responses/list-screener-responses","createdAt":"2026-09-04T03:34:23.146Z","updatedAt":"2026-09-04T03:34:23.146Z","__v":0},{"_id":"6a9a3c3f39df3fe1cd51bf65","deploymentId":"6865f8a7787fbe9472a1f8da","questionText":"How do I filter screener responses?","status":"active","generatedBy":"contextual","path":"screener-responses/list-screener-responses","createdAt":"2026-09-04T03:34:23.146Z","updatedAt":"2026-09-04T03:34:23.146Z","__v":0}],"navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-04T03:34:09.736Z","gitLastModified":"2026-09-04T03:33:47.000Z","originalFileLocation":"screener-responses/list-screener-responses.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=\"List all screener responses for a project with filtering and pagination. Use query parameters to filter by status, qualification state, or date range.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Respondent API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/respondentio/jKZzsvA27N4OlfWK/_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/respondentio/jKZzsvA27N4OlfWK/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/respondentio/jKZzsvA27N4OlfWK/_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/respondentio/jKZzsvA27N4OlfWK/_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/respondentio/jKZzsvA27N4OlfWK/_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/respondentio/jKZzsvA27N4OlfWK/_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/respondentio/jKZzsvA27N4OlfWK/_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/respondentio/jKZzsvA27N4OlfWK/_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/respondentio/jKZzsvA27N4OlfWK/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List screener responses - Respondent API\">\u003cmeta data-mint-head property=\"og:description\" content=\"List all screener responses for a project with filtering and pagination. Use query parameters to filter by status, qualification state, or date range.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Respondent API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.respondent.io/screener-responses/list-screener-responses\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://respondentio.mintlify.site/_mintlify/api/og/v2?division=View+Responses+%26+Profiles\u0026amp;title=List+screener+responses\u0026amp;description=List+all+screener+responses+for+a+project+with+filtering+and+pagination.+Use+query+parameters+to+filter+by+status%2C+qualification+state%2C+or+date+range.\u0026amp;theme=07b94bf61b3b40a4f6255366\u0026amp;signature=551857540e5576af16eadee8896074ee64990b92fc86fcb40d9ad05a997a20bc\">\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 screener responses - Respondent API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List all screener responses for a project with filtering and pagination. Use query parameters to filter by status, qualification state, or date range.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://respondentio.mintlify.site/_mintlify/api/og/v2?division=View+Responses+%26+Profiles\u0026amp;title=List+screener+responses\u0026amp;description=List+all+screener+responses+for+a+project+with+filtering+and+pagination.+Use+query+parameters+to+filter+by+status%2C+qualification+state%2C+or+date+range.\u0026amp;theme=07b94bf61b3b40a4f6255366\u0026amp;signature=551857540e5576af16eadee8896074ee64990b92fc86fcb40d9ad05a997a20bc\">\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/respondentio/jKZzsvA27N4OlfWK/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Respondent API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0003C9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.respondent.io/screener-responses/list-screener-responses\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/screener-responses/list-screener-responses.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.respondent.io/#organization\",\"name\":\"Respondent API\",\"url\":\"https://developers.respondent.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/respondentio/1IlvD-ZbNqUuKfqV/images/main-logo.svg?fit=max\u0026auto=format\u0026n=1IlvD-ZbNqUuKfqV\u0026q=85\u0026s=e98b93965ff41fd386d3352299fc0ed0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.respondent.io#website\",\"name\":\"Respondent API\",\"url\":\"https://developers.respondent.io\",\"publisher\":{\"@id\":\"https://developers.respondent.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.respondent.io/screener-responses/list-screener-responses#webpage\",\"url\":\"https://developers.respondent.io/screener-responses/list-screener-responses\",\"name\":\"List screener responses\",\"description\":\"List all screener responses for a project with filtering and pagination. Use query parameters to filter by status, qualification state, or date range.\",\"dateModified\":\"2026-09-04T03:33:47.000Z\",\"isPartOf\":{\"@id\":\"https://developers.respondent.io#website\"},\"breadcrumb\":{\"@id\":\"https://developers.respondent.io/screener-responses/list-screener-responses#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.respondent.io/screener-responses/list-screener-responses#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Respondent API\",\"item\":\"https://developers.respondent.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List screener responses\",\"item\":\"https://developers.respondent.io/screener-responses/list-screener-responses\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.respondent.io/screener-responses/list-screener-responses#apireference\",\"headline\":\"List screener responses\",\"name\":\"List screener responses\",\"description\":\"List all screener responses for a project with filtering and pagination. Use query parameters to filter by status, qualification state, or date range.\",\"url\":\"https://developers.respondent.io/screener-responses/list-screener-responses\",\"mainEntityOfPage\":{\"@id\":\"https://developers.respondent.io/screener-responses/list-screener-responses#webpage\"},\"dateModified\":\"2026-09-04T03:33:47.000Z\",\"publisher\":{\"@id\":\"https://developers.respondent.io/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.respondent.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Respondent API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Respondent API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/screener-responses/list-screener-responses.md","siteName":"Respondent API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/docs/Getting-started/quickstart"}]},{"tab":"API Endpoints","groups":[{"group":"Getting started","icon":"rocket-launch","pages":[{"title":"Introduction","href":"/reference/introduction"},{"title":"Staging vs production","href":"/reference/staging-vs-production"}]},{"group":"Core Setup","icon":"project-diagram","pages":[{"openapi":"post /v1/projects","title":"Create a project","href":"/projects/create-a-project"},{"openapi":"post /v1/projects/{projectId}/screener-questions","title":"Create a screener question","href":"/screener-questions/create-a-screener-question"},{"openapi":"put /v1/projects/{projectId}/screener-questions/bulk","title":"Create multiple screener questions","href":"/screener-questions/create-multiple-screener-questions"},{"openapi":"patch /v1/projects/{projectId}/publish","title":"Publish a project","href":"/projects/publish-a-project"}]},{"group":"Extended Setup Actions","icon":"project-diagram","pages":[{"openapi":"get /v1/projects/{projectId}/feasibility/audience-size-estimate","title":"Retrieve audience size estimate","href":"/projects/retrieve-audience-size-estimate"},{"title":"Generate title \u0026 description","openapi":"post /v1/projects/suggestions","href":"/projects/generate-title-and-description"},{"openapi":"put /v1/projects/{projectId}/files/form-data","title":"Upload NDA file","href":"/projects/upload-nda-file"},{"openapi":"post /v1/projects/{projectId}/copy","title":"Copy a project","href":"/projects/copy-a-project"},{"openapi":"post /v1/profiles","title":"Create test participant (Staging only)","href":"/profiles/create-test-participant-staging-only"}]},{"group":"Audience Quotas","icon":"project-diagram","pages":[{"openapi":"put /v1/projects/{projectId}/quotas","title":"Create or replace a project's quota","href":"/quotas/create-quota"},{"openapi":"get /v1/projects/{projectId}/quotas","title":"Retrieve a project's quota","href":"/quotas/retrieve-quota"},{"openapi":"patch /v1/projects/{projectId}/quotas/targets","title":"Update quota targets","href":"/quotas/update-quota"},{"openapi":"put /v1/projects/{projectId}/quotas/external-fills","title":"Set external fills","href":"/quotas/set-external-fills"},{"openapi":"delete /v1/projects/{projectId}/quotas","title":"Delete a project's quota","href":"/quotas/delete-quota"}]},{"group":"Audience Quotas (V1)","icon":"project-diagram","pages":[{"title":"Create a quota (V1)","openapi":"post /v1/projects/{projectId}/quota","href":"/quotas/create-quota-v1"},{"title":"Retrieve a quota (V1)","openapi":"get /v1/projects/{projectId}/quota","href":"/quotas/retrieve-quota-v1"},{"title":"Update a quota (V1)","openapi":"patch /v1/projects/{projectId}/quota","href":"/quotas/update-quota-v1"},{"title":"Delete a quota (V1)","openapi":"delete /v1/projects/{projectId}/quota","href":"/quotas/delete-quota-v1"}]},{"group":"Project Management","icon":"project-diagram","pages":[{"openapi":"get /v1/projects","title":"Retrieve all projects","href":"/projects/retrieve-all-projects"},{"openapi":"get /v1/projects/{projectId}","title":"Retrieve a specific project","href":"/projects/retrieve-a-specific-project"},{"openapi":"patch /v1/projects/{projectId}","title":"Update a project","href":"/projects/update-a-project"},{"openapi":"patch /v1/projects/{projectId}/pause","title":"Pause a project","href":"/projects/pause-a-project"},{"openapi":"patch /v1/projects/{projectId}/close","title":"Close a project","href":"/projects/close-a-project"},{"openapi":"delete /v1/projects/{projectId}","title":"Delete a project","href":"/projects/delete-a-project"}]},{"group":"External Screener Management","icon":"project-diagram","pages":[{"openapi":"put /v1/projects/{projectId}/external-screener-questions/bulk","title":"Replace external screener questions","href":"/projects/replace-external-screener-questions"}]},{"group":"Screener Question Management","icon":"project-diagram","pages":[{"openapi":"get /v1/projects/{projectId}/screener-questions","title":"Retrieve screener questions","href":"/screener-questions/retrieve-screener-questions"},{"openapi":"get /v1/projects/{projectId}/screener-questions/{screenerQuestionId}","title":"Retrieve specific screener question","href":"/screener-questions/retrieve-specific-screener-question"},{"openapi":"patch /v1/projects/{projectId}/screener-questions/{screenerQuestionId}","title":"Update screener question","href":"/screener-questions/update-screener-question"},{"openapi":"delete /v1/projects/{projectId}/screener-questions/{screenerQuestionId}","title":"Delete screener question","href":"/screener-questions/delete-screener-question"},{"openapi":"patch /v1/projects/{projectId}/screener-questions/order","description":"Reorder screener questions to control the sequence in which they are presented to participants.","title":"Reorder screener questions","href":"/screener-questions/reorder-screener-questions"}]},{"group":"View Responses \u0026 Profiles","icon":"screen-users","pages":[{"openapi":"get /v1/projects/{projectId}/screener-responses","title":"List screener responses","href":"/screener-responses/list-screener-responses"},{"openapi":"get /v1/projects/{projectId}/screener-responses/{screenerResponseId}","description":"Retrieve a single screener response including the participant's answers, profile data, and current status.","title":"View a specific response","href":"/screener-responses/view-a-specific-response"},{"openapi":"get /v1/profiles/{profileId}","title":"Retrieve participant profile","href":"/profiles/retrieve-participant-profile"}]},{"group":"External Screener Answers","icon":"screen-users","pages":[{"openapi":"post /v1/projects/{projectId}/screener-responses/{screenerResponseId}/external-screener-answers","title":"Post External Screener Answers","href":"/screener-responses/post-external-screener-answers"}]},{"group":"Invite \u0026 Schedule Participants","icon":"screen-users","pages":[{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/qualify","title":"Qualify participant","href":"/screener-responses/qualify-participant"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/invite","title":"Invite participant","href":"/screener-responses/invite-participant"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/schedule","title":"Schedule participant","href":"/screener-responses/schedule-participant"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/cancel-invite","title":"Cancel invite","href":"/screener-responses/cancel-invite"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/cancel-booking","title":"Cancel booking","href":"/screener-responses/cancel-booking"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/cancel-booking-reinvite","title":"Cancel booking \u0026 re-invite","href":"/screener-responses/cancel-booking-\u0026-re-invite"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/participant-cancel-booking","title":"Cancel booking (participant request)","href":"/screener-responses/cancel-booking-participant-request"}]},{"group":"Update Participant Status","icon":"screen-users","pages":[{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/attended","title":"Mark as attended","href":"/screener-responses/mark-as-attended"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/reject","title":"Mark as rejected","href":"/screener-responses/mark-as-rejected"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/no-show","title":"Mark as no-show","href":"/screener-responses/mark-as-no-show"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/report","title":"Report participant","href":"/screener-responses/report-participant"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/favorite","title":"Mark as favorite","href":"/screener-responses/mark-as-favorite"},{"openapi":"patch /v1/projects/{projectId}/screener-responses/{screenerResponseId}/hide","title":"Hide participant","href":"/screener-responses/hide-participant"}]},{"group":"Payouts","icon":"screen-users","pages":[{"openapi":"post /v1/projects/{projectId}/screener-responses/{screenerResponseId}/payouts","title":"Trigger manual payout","href":"/screener-responses/trigger-manual-payout"},{"openapi":"get /v1/projects/{projectId}/screener-responses/payouts","title":"Retrieve payout counts","href":"/screener-responses/retrieve-payout-counts"}]},{"group":"Create Messages \u0026 Conversations","icon":"message-dots","pages":[{"openapi":"post /v1/messaging/conversations","title":"Create a conversation","href":"/messaging/create-a-conversation"},{"openapi":"post /v1/messaging/conversations/{conversationUid}/messages","title":"Create a message","href":"/messaging/create-a-message"},{"openapi":"post /v1/messaging/conversations/{conversationUid}/participants","title":"Add participant to conversation","href":"/messaging/add-participant-to-conversation"}]},{"group":"View Messages \u0026 Conversations","icon":"message-dots","pages":[{"openapi":"get /v1/messaging/messages","title":"Retrieve all messages","href":"/messaging/retrieve-all-messages"},{"openapi":"get /v1/messaging/messages/inbox","title":"Retrieve unread conversations","href":"/messaging/retrieve-unread-conversations"},{"openapi":"get /v1/messaging/messages/{messageUid}","title":"Retrieve specific message","href":"/messaging/retrieve-specific-message"},{"openapi":"get /v1/messaging/conversations","title":"Retrieve all conversations","href":"/messaging/retrieve-all-conversations"},{"openapi":"get /v1/messaging/conversations/{conversationUid}","title":"Retrieve specific conversation","href":"/messaging/retrieve-specific-conversation"}]},{"group":"Manage Conversations","icon":"message-dots","pages":[{"openapi":"patch /v1/messaging/conversations/{conversationUid}/read","title":"Mark conversation as read","href":"/messaging/mark-conversation-as-read"},{"openapi":"delete /v1/messaging/conversations/{conversationUid}/participants/{participantUserId}","title":"Remove participant from conversation","href":"/messaging/remove-participant-from-conversation"},{"openapi":"patch /v1/messaging/conversations/{conversationUid}","title":"Update a conversation","href":"/messaging/update-a-conversation"}]},{"group":"Lookup and Reference Data","icon":"table-list","pages":[{"openapi":"get /v1/industries","title":"Retrieve industry list","href":"/industries/retrieve-industry-list"},{"openapi":"get /v1/job-titles","title":"Retrieve job title list","href":"/job-titles/retrieve-job-title-list"},{"openapi":"get /v1/skills","title":"Retrieve skill list","href":"/skills/retrieve-skill-list"},{"openapi":"get /v1/topics","title":"Retrieve topics list","href":"/topics/retrieve-topics-list"},{"openapi":"get /v1/lookups","title":"Retrieve lookup values","href":"/lookups/retrieve-lookup-values"}]},{"group":"Webhooks","icon":"webhook","pages":[{"openapi":"post /v1/webhooks","title":"Create webhook","href":"/webhooks/create-webhook"},{"openapi":"get /v1/webhooks","title":"Retrieve webhook","href":"/webhooks/retrieve-webhook"},{"openapi":"get /v1/webhooks/{webhookId}","title":"Retrieve specific webhook","href":"/webhooks/retrieve-specific-webhook"},{"openapi":"get /v1/webhooks/{webhookId}/event-types","title":"Retrieve webhook event types","href":"/webhooks/retrieve-webhook-event-types"},{"openapi":"post /v1/webhooks/{webhookId}/simulate","title":"Simulate webhook event","href":"/webhooks/simulate-webhook-event"},{"openapi":"delete /v1/webhooks/{webhookId}","title":"Deactivate webhook","href":"/webhooks/deactivate-webhook"}]},{"group":"Team Tools","icon":"users","pages":[{"openapi":"get /v1/team-respondents","title":"Search past participants","href":"/team-respondents/search-past-participants"},{"openapi":"get /v1/team-respondents/profiles/{profileId}","title":"Retrieve past participant profile","href":"/team-respondents/retrieve-past-participant-profile"},{"openapi":"put /v1/team-respondents/batch-invite","title":"Invite multiple past participants","href":"/team-respondents/invite-multiple-past-participants"},{"openapi":"get /v1/projects/{projectId}/pending-invites","title":"List pending past-participant invites","href":"/team-respondents/list-queued-invitations"},{"openapi":"post /v1/projects/{projectId}/pending-invites","title":"Queue past-participant invites on a draft","href":"/team-respondents/queue-past-participants"},{"openapi":"delete /v1/projects/{projectId}/pending-invites/{profileId}","title":"Remove a past-participant invite from a draft","href":"/team-respondents/remove-queued-participant"},{"openapi":"post /v1/projects/{projectId}/pending-invites/send","title":"Send remaining past-participant invites","href":"/team-respondents/send-queued-invitations"},{"openapi":"get /v1/pricing/balances/summary","title":"View credit and incentive balance","href":"/pricing/view-credit-and-incentive-balance"}]}]},{"tab":"Change Log","pages":[{"title":"Change Log","href":"/docs/Changelog/overview"}]}]},"basePath":"","title":"List screener responses - Respondent API","deploymentId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","buildId":"dpl_vSEmv961Ncyvz1psVwgUnTXQMSYk","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-CrDfRf61.js","snippetPresets-Dv-cOUrx.js","utils-BUTreAgv.js","style-to-object-BY3JEAdk.js","utils-wsznt9RM.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-DEsMlaPy.js","conditional-requirements-CFM0id0Q.js","cloneDeep-DontW4xJ.js","_Uint8Array-pP7X6_RM.js","isObject-FP1Yky1u.js","Page-Cr9IwkK7.js","CodeSnippet-eoRjC4Le.js","DynamicMarkdown-NFqqduU7.js","SectionHeading-DQ-mJoAt.js","icon-DXTBUt6s.js","ApiExamples-CU_aGGP0.js","usePlaygroundInputsStore-7dNmUIbS.js","shallow-fTtruD8x.js","isEqual-BRfNFpSD.js","CodeSnippets-52884wUJ.js","getApiPlaygroundDisplay-CZyAPlR2.js","MethodPill-2v-b3js5.js","getPastedJson-v_8Y1_4v.js","DuplicateIcon-DXIkhZIo.js","createIcon-DRpYuPZs.js","axios-CsQoIw0U.js","Markdown-CwtoSfEf.js","AssistantPageLink-CTqa3eoi.js","dist-DIfYWxfm.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}