List surveys

Returns a page of surveys in the key's workspace, newest activity first.

HTTP request

GET https://www.asqiro.com/api/v1/surveys

Any API key in the survey's workspace.

Query parameters

Parameter	Type	Description
limit	integer	Number of items per page.Optional · Default: 25 · Maximum: 100
cursor	string	Opaque cursor from a previous response's nextCursor.Optional

Response body

The response is a page envelope: data holds the surveys, nextCursor points at the following page or is null on the last one.

Field	Type	Description
id	string	Unique survey id.
title	string	Survey title as shown to respondents.
description	string· nullable	Survey description, or null when none is set.
status	"draft" \| "published" \| "closed"	Current lifecycle status.
published	boolean	Whether the survey is currently accepting responses.
questionCount	integer	Number of questions in the survey.
responseCount	integer	Total responses received, including incomplete ones.
createdAt	string (ISO 8601)	When the survey was created.
updatedAt	string (ISO 8601)	When the survey was last changed.

Note Trashed surveys are never returned. An integration that syncs surveys will not resurrect something the user deleted.

Errors

unauthorized · 401 · The API key is missing, malformed, deleted, or its creator lost workspace access. Check the Authorization header, then the key itself.
plan_upgrade_required · 403 · The workspace owner's plan does not include API access. Upgrading the plan restores it; retrying will not.
rate_limited · 429 · Too many requests. The Retry-After response header carries the number of seconds to wait.

Example request

bash

curl "https://www.asqiro.com/api/v1/surveys?limit=25" \
  -H "Authorization: Bearer $ASQIRO_API_KEY"

Returns 200 on success.

Example response

json

{
  "data": [
    {
      "id": "s_7t2qk8wvbf31",
      "title": "Onboarding feedback",
      "description": null,
      "status": "published",
      "published": true,
      "questionCount": 8,
      "responseCount": 142,
      "createdAt": "2026-07-02T09:14:31.220Z",
      "updatedAt": "2026-08-11T16:02:07.884Z"
    }
  ],
  "nextCursor": "eyJ1cGRhdGVkQXQiOiIyMDI2LTA4LTExIn0"
}