Get a response

GET
/surveys/{survey_id}/responses/{response_id}

Returns a single response directly as an object (without a data wrapper). attributes[] works as in the list; filters are not used here.

Authorization

bearerAuth
headerAuthorizationBearer <token>

API token of the account (ph_ followed by 48 characters), created in the account settings under API access.

Path Parameters

survey_id*string

UUID of the survey (id from List surveys).

Formatuuid
response_id*string

ID of the response (id from List responses).

Match^[0-9]+$

Query Parameters

attributes[]?array<>

Names of respondent attributes to return with each response, e.g. email. At most 50. Fixed attributes: email, customer_id, customer_type, total_revenue, total_purchases, total_aov, country, language; otherwise a key of the custom data passed to identify().

Itemsitems <= 50

Response Body

The response.

application/json
  1. response
id?string

ID of the response (numeric, as a string).

collected_at?string

Time of the first answer.

Formatdate-time
completed?boolean

The survey was completed.

completed_at?|

Time of completion.

Formatdate-time
time_taken?|

Duration in seconds.

url?|

Page on which the response was given.

device_type?string|null
browser?string|null
country?string|null
utm?
answers?array<>

Answers in the order of the questions shown. Skipped questions are left out.

respondent?
curl -X GET 'https://app.poll-hero.com/api/v1/surveys/42293d51-fdd7-49cb-a693-cc6f9f0a070b/responses/918273'
{  "id": "918273",  "collected_at": "2026-09-14T10:22:41.000000Z",  "completed": true,  "completed_at": "2026-09-14T10:23:19.000000Z",  "time_taken": 38,  "url": "https://shop.example.com/checkout/thank-you",  "device_type": "desktop",  "browser": "Chrome",  "country": "Germany",  "utm": {    "source": "newsletter",    "medium": "email",    "campaign": "autumn",    "term": null,    "content": null  },  "answers": [    {      "question_id": "de184da0-572b-4a7d-94d2-ada144566528",      "question_type": "single",      "answer": {        "content": "Search engine"      }    },    {      "question_id": "5b0c7c0e-2f0e-4f0a-9d53-0c4f3a1f7a11",      "question_type": "nps",      "answer": {        "content": 9,        "tag": "promoter"      }    }  ],  "respondent": {    "id": "b1f4c2d0-7a35-4c1e-8f7b-2f6f0e1f9a44",    "attributes": [      {        "name": "email",        "value": "customer@example.com"      }    ]  }}