Skip to content

Get respondent information

POST
/get-respondent-info

The /get-respondent-info endpoint will return information about a respondent, including birth_date, gender, postal_code, and attributes. Learn more here.

Negative Answer Values

For negative answers, please refer to the table below for further details.

answer_valuedescription
-5This attribute is derived from postal_code, but the respondent postal_code is invalid or unsupported.
*All other negative answer values will only match filter cells if kind is ANSWERED or negate is true. The answer value will not match any quota cells.

Respondents

dynata-expiration
required
string format: date-time

RFC3339 timestamp indicating request expiration

dynata-access-key
required
string

Dynata provided access key

Example
ABCD1234
dynata-signature
required
string

Signature created using the dynata methodology

Example
c156e91013eb715edb2b07df5491497a807206b1796bb7d031505107a9dbdcdf
object
respondent_id
required

Partner’s respondent identifier. Accepts 100 characters, 3-byte chars.

string

Respondent info retrieved

object
respondent_id

Partner’s respondent identifier. Accepts 100 characters, 3-byte chars.

string
language
string
/^[a-z]{2}$/
country
string
/^[A-Z]{2}$/
is_active
boolean
is_suspended
boolean
gender
string
Allowed values: male female
birth_date
string format: YYYY-MM-DD
postal_code
string
date_created
string format: date-time
attributes
object
key
additional properties
Array<integer>

Bad request

object
message
required
string

Invalid credentials

object
message
required
string

Unauthorized

object
message
required
string

Internal server error

object
message
required
string