List Studies

curl 'https://listenlabs.ai/api/public/list_surveys' \
-H 'x-api-key: <api_key>'

[
  {
    "id": "12345678-0000-0000-0000-000000000000",
    "link_id": "study-1",
    "title": "Example study",
    "created_at": "2023-09-02T07:07:17.960725+00:00",
    "desc": "Example study (12 Responses)"
  },
  {
    "id": "23456789-0000-0000-0000-000000000000",
    "link_id": "study-2",
    "title": "Example study 2",
    "created_at": "2023-09-01T07:07:17.960725+00:00",
    "desc": "Example study 2 (9 Responses)"
  }
]

GET

api

public

list_surveys

curl 'https://listenlabs.ai/api/public/list_surveys' \
-H 'x-api-key: <api_key>'

[
  {
    "id": "12345678-0000-0000-0000-000000000000",
    "link_id": "study-1",
    "title": "Example study",
    "created_at": "2023-09-02T07:07:17.960725+00:00",
    "desc": "Example study (12 Responses)"
  },
  {
    "id": "23456789-0000-0000-0000-000000000000",
    "link_id": "study-2",
    "title": "Example study 2",
    "created_at": "2023-09-01T07:07:17.960725+00:00",
    "desc": "Example study 2 (9 Responses)"
  }
]

Deprecated starting August 1, 2026. Use GET /api/public/v1/studies instead.

Response

Returns a list of studies. Each study is an object with the following fields:

uuid

Permanent unique identifier for the study — it never changes. Accepted by the versioned launch, questions, and response endpoints.

string

The link ID of the study — the path parameter for the response and questions endpoints. This is editable in the study settings so it might change.

string

The title of the study.

string

UTC timestamp of when the study was created.

string

A description of the study. E.g. “My study (10 Responses)”

curl 'https://listenlabs.ai/api/public/list_surveys' \
-H 'x-api-key: <api_key>'

[
  {
    "id": "12345678-0000-0000-0000-000000000000",
    "link_id": "study-1",
    "title": "Example study",
    "created_at": "2023-09-02T07:07:17.960725+00:00",
    "desc": "Example study (12 Responses)"
  },
  {
    "id": "23456789-0000-0000-0000-000000000000",
    "link_id": "study-2",
    "title": "Example study 2",
    "created_at": "2023-09-01T07:07:17.960725+00:00",
    "desc": "Example study 2 (9 Responses)"
  }
]

Get Started

Study Design

Recruitment & Fielding

Study Insights and Analysis

Integrations

Accounts & Permissions

API Documentation

Response

​Response

Response