ConfettiDocs

List surveys

GET/v1/protected/surveys

List the surveys owned by the team the secret key belongs to. Includes active and inactive surveys and excludes deleted ones. Server-to-server only — authenticate with a secret key sent as Authorization: Bearer cfti_sk_.... Results are ordered by creation time (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

Query Parameters

cursor?string
limit?number

Response Body

application/json

curl -X GET "https://example.com/v1/protected/surveys"
{  "data": [    {      "id": "string",      "title": "string",      "description": "string",      "status": "active",      "createdAt": "2019-08-24T14:15:22Z",      "updatedAt": "2019-08-24T14:15:22Z"    }  ],  "nextCursor": "string",  "limit": 0,  "links": {    "self": "string",    "next": "string"  }}

Was this page helpful?