Skip to main content
GET
Retrieve a survey

Authorizations

next-auth.session-token
string
cookie
required

NextAuth session JWT cookie. Development: often next-auth.session-token. Production (HTTPS): often __Secure-next-auth.session-token. Send the cookie your browser receives after sign-in.

Path Parameters

surveyId
string<cuid2>
required

Survey identifier.

Query Parameters

lang
string[]

Comma-separated language selector filter for translatable fields, for example ?lang=de-DE,pt-PT. The response shape stays stable: translatable fields are always maps, never strings, and response keys match the emitted languages[].code values for this survey. For compatibility with existing Formbricks surveys, GET accepts language tags such as de, de-DE, zh-Hans, and zh-Hans-CN, accepts _ or - separators, is case-insensitive, and accepts configured workspace aliases such as english. Bare language selectors are resolved against the survey's configured languages and return 400 if ambiguous, for example if both en-US and en-GB are configured. Disabled-but-configured languages are readable in the management API so unfinished translations can be completed.

Examples:

Response

Survey retrieved successfully

data
object
required