Machine-to-machine authentication
Backend integrations can use a machine credential instead of storing a person’s email and password. Rep Data provisions a client ID, a client secret, and the token URL. The backend exchanges them for an access token with the OAuth 2.0 client credentials grant. Each request acts as the person named in theX-RepData-Acting-User header, or as the integration user configured for the credential when that header is absent. See Authentication Workflow.Survey list fields, fielding stats, and COMPLETE API flag
Documentation aligned with the liveGET /surveys response.Surveys
- Documented
completes_check_enabledonsurvey_attributes(COMPLETE API server-side complete validation; optional on create, defaults to the account setting) - Documented nested
field_detailsfields returned onGET /surveys:inflight,abandons,defender_terminates, reconciliation counts/costs (accepted_completes,accepted_unregistered_completes,rejected_completes,accepted_cost,accepted_unregistered_cost,rejected_cost,final_cost,final_completes) - Documented the list envelope:
total_surveys,page,page_size,surveys - Added
ScheduledandAuto-Pausedto documented survey statuses
Respondent Status Codes
Added a Respondent Status Codes reference covering:- Client redirect
inbound_codevalues (1000,2000,3000,4000, and quality1) - How
GET /responsesmaps codes to named statuses - Full
iscsub-codes, including Research Desk terms, over-quotas, and Defender outcomes
WorkOS AuthKit, English qualifications text, and Desk RX test links
Documentation aligned with recent Demand API deployments.Authentication
- Authorized requests accept WorkOS AuthKit access tokens in the
Authorizationheader, in addition to Cognito JWTs fromPOST /tokens POST /tokensremains Cognito email/password token issuance only
Qualifications (GET /qualifications)
- Added
english_only— when present, returns English question/option text - Added
globals— when present, includesglobal_idandglobal_name - Corrected name filter parameter to
names(comma-delimited) - Documented
pagedefault as1;country_codeandlanguage_coderequired
Surveys
- Documented system-assigned
desk_test_link(Test Link) anddesk_rx_test_link(Live/RX Test Link) on survey responses
Research Desk Demand API v1.1
Initial public release of the Research Desk Demand API. Provides programmatic access to the full survey lifecycle — from project creation and audience targeting through fieldwork management and respondent reconciliation.Endpoint Groups
AuthenticationPOST /tokens— Generate a JWT token using email and password credentials
GET /users— Retrieve users associated with your accountGET /accounts— Retrieve account details and configuration
GET /definitions— Fetch platform-wide reference values (countries, languages, survey statuses, etc.)GET /qualifications— Retrieve the full library of audience targeting attributes and their valid option values
GET /projects— List and filter projectsPOST /projects— Create a new projectPATCH /projects/{id}— Update project details or status
GET /surveys— List and filter surveys within a projectPOST /surveys— Create a new survey with targeting, quotas, and redirect linksPATCH /surveys/{id}— Update survey configuration, status, or compensation
GET /responses— Retrieve respondent records with status and metadataPATCH /responses/{id}— Reconcile individual response records (quality-based exclusions)
