ConfettiDocs

List survey responses

GET/v1/protected/surveys/{surveyId}/responses

Read a survey's responses for the team the secret key belongs to. Server-to-server only — authenticate with a secret key sent as Authorization: Bearer cfti_sk_.... Results are newest-first and paginated: pass the previous page's nextCursor as cursor to fetch the next page. limit defaults to 50 (max 100).

Authorization

BearerAuth
AuthorizationBearer <token>

Your team's secret key (cfti_sk_...), sent as a bearer token. Keep it server-side — never expose it in client code.

In: header

Path Parameters

surveyId*string

Query Parameters

respondent?string
cursor?string
limit?number

Response Body

application/json

curl -X GET "https://example.com/v1/protected/surveys/123/responses"
{  "data": [    {      "id": "string",      "respondent": "string",      "data": {        "property1": "string",        "property2": "string"      },      "clientMetadata": {        "property1": "string",        "property2": "string"      },      "createdAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string",  "limit": 0,  "links": {    "self": "string",    "next": "string"  }}