Get respondent information

POST

/get-respondent-info

curl --request POST \
  --url https://respondent.rex.dynata.com/get-respondent-info \
  --header 'Content-Type: application/json' \
  --header 'dynata-access-key: ABCD1234' \
  --header 'dynata-expiration: 2026-04-15T12:00:00Z' \
  --header 'dynata-signature: c156e91013eb715edb2b07df5491497a807206b1796bb7d031505107a9dbdcdf' \
  --data '{ "respondent_id": "user1234" }'

• Production
• Sandbox

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_value	description
-5	This 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

Parameters

Header Parameters

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

Request Body

Media typeapplication/json

object

respondent_id

required

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

string

Responses

200

Respondent info retrieved

Media typeapplication/json

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>

Example

{
  "respondent_id": "user1234",
  "language": "en",
  "country": "US",
  "gender": "male",
  "birth_date": "1990-01-01",
  "postal_code": "E15RX",
  "date_created": "1990-01-01T00:00:00Z",
  "attributes": [
    {
      "123": [
        1
      ]
    },
    {
      "456": [
        -2
      ]
    },
    {
      "789": [
        3,
        4
      ]
    }
  ]
}

400

Bad request

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

401

Invalid credentials

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

403

Unauthorized

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}

500

Internal server error

Media typeapplication/json

object

message

required

string

Example^generated

{
  "message": "example"
}