List surveys
GET
Returns the surveys the token may read, newest first. from and to refer to the creation date.
bearerAuthheader
AuthorizationBearer <token>API token of the account (ph_ followed by 48 characters), created in the account settings under API access.
project_id?stringOnly surveys of this project (project.id of a survey). An unknown project returns an empty list.
Length
length <= 64page[size]?integerRecords per page, 1 to 100. Default: 50.
Range
1 <= value <= 100Default
50page[cursor]?stringCursor of the next page. Take it from links.next and pass it on unchanged.
Length
length <= 500from?stringOnly records whose creation date is at or after this point in time. ISO 8601; a plain date (2026-01-31) covers the whole day in UTC.
to?stringOnly records whose creation date is at or before this point in time. Must not be before from.
A page of surveys.
application/json- response
data*array<>links*meta*curl -X GET 'https://app.poll-hero.com/api/v1/surveys'{ "data": [ { "id": "42293d51-fdd7-49cb-a693-cc6f9f0a070b", "type": "onsite", "name": "Checkout satisfaction", "created_at": "2026-08-12T09:14:03.000000Z", "active": true, "paused": false, "draft": false, "responses": 1284, "launch": { "start_at": "2026-08-14T00:00:00.000000Z", "end_at": null }, "project": { "id": "KIn-gk5o6co5HOsPHDq8B", "name": "Online shop" } } ], "links": { "first": "https://app.poll-hero.com/api/v1/surveys", "prev": null, "next": "https://app.poll-hero.com/api/v1/surveys?page%5Bcursor%5D=eyJ0IjoiMjAyNi0w..." }, "meta": { "page_size": 50 }}