Skip to main content
GET
/
responses
Responses
curl --request GET \
  --url https://demand.researchdesk.com/responses \
  --header 'Authorization: <api-key>'
{
  "total_responses": 1,
  "page": 1,
  "page_size": 50,
  "survey_id": "dfc48145-09a2-436f-aed2-0a7e46767e95",
  "responses": [
    {
      "rdud": "b153e8c9-2442-4233-a9b8-3f0c473a1d4a",
      "status": "Complete",
      "reconciliation_status": "Unprocessed",
      "buyer_cpi": 1.55,
      "qualification_attributes": [
        {
          "precodes": [
            1,
            2
          ],
          "qualification_id": 2
        },
        {
          "precodes": [
            1,
            2,
            3
          ],
          "qualification_id": 16
        },
        {
          "precodes": [
            21,
            22,
            23,
            24,
            25,
            26,
            27,
            28,
            29,
            30
          ],
          "qualification_id": 1
        }
      ],
      "quota_attributes": [
        "df691be3-9e11-4cf6-b47e-22bb527db614",
        "7c0be8aa-0a49-4161-a42d-b7e57c575e5f",
        "373a6c70-7171-498e-93d0-81aafab93f7a"
      ]
    }
  ]
}
Rate limit: 6000 requests/minute Note: The GET method returns a list of objects, PATCH accepts and returns a single object
Query String Parameters (GET)
NameDescriptionRequiredExample
survey_idThe ID of a surveyYes?id=1
rdudsComma delimited value of the Response IDs being retrievedNo?rduds=1,2,3
statusesComma delimited value of the URL-encoded statuses associated with the Responses being retrieved.No?statuses=complete,security termination
pageInteger value of the page being retrievedNo; if omitted, the value defaults to 1?page=2
page_sizeInteger value dictating the number of objects returned per page.No; if omitted, the value defaults to 50?page_size=100
Response Object Definition
ParameterRequired on PATCHDescription
rdudYesThe ID of the associated Response object.
statusSystem AssignedThe status associated with the Response object.
reconciliation_statusYes
Note: Can only be Accepted or Rejected		The reconciliation status of a Response object.
buyer_cpiSystem AssignedThe price this respondent cost if it was complete.
qualification_attributesSystem AssignedWhat qualification(s) the respondent had.
quota_attributesSystem AssignedWhich quota(s) the respondent fell under.

Authorizations

​
Authorization
string
header
required

Authentication token to be sent directly in the Authorization header (no '' prefix).

Headers

​
Authorization
string

Response

200 - application/json

Responses

​
total_responses
integer
​
page
integer
​
page_size
integer
​
survey_id
string
​
responses
object[]