Skip to main content
GET
/
v3
/
questionnaires
/
{questionnaire_uuid}
cURL
curl -X GET 'https://verification.didit.me/v3/questionnaires/11111111-2222-3333-4444-555555555555/' \
  -H 'x-api-key: YOUR_API_KEY'
{
  "questionnaire_id": "11111111-2222-3333-4444-555555555555",
  "title": "Customer Onboarding",
  "description": "Additional information needed for verification",
  "languages": [
    "en"
  ],
  "default_language": "en",
  "is_active": true,
  "is_simple_questionnaire": true,
  "graph": {
    "start_node": "occupation",
    "nodes": {
      "occupation": {
        "element_type": "SHORT_TEXT",
        "is_required": true,
        "title": {
          "en": "What is your occupation?"
        },
        "next": "source_of_funds"
      },
      "source_of_funds": {
        "element_type": "MULTIPLE_CHOICE",
        "is_required": true,
        "title": {
          "en": "Source of funds"
        },
        "choices": [
          {
            "value": "employment",
            "label": {
              "en": "Employment"
            }
          },
          {
            "value": "business",
            "label": {
              "en": "Business"
            }
          }
        ],
        "next": null
      }
    }
  },
  "sections": [
    {
      "title": {},
      "description": {},
      "items": [
        {
          "uuid": "11111111-2222-3333-4444-666666666666",
          "value": "occupation",
          "element_type": "SHORT_TEXT",
          "is_required": true,
          "title": {
            "en": "What is your occupation?"
          }
        }
      ]
    }
  ],
  "questionnaire_group_id": "11111111-2222-3333-4444-555555555555",
  "version": 1,
  "status": "published",
  "published_at": "2026-04-23T10:00:00Z",
  "is_editable": false
}

Authorizations

x-api-key
string
header
required

Path Parameters

questionnaire_uuid
string<uuid>
required

Per-version UUID of the questionnaire (the uuid value returned by the list endpoint, also returned as questionnaire_id on detail endpoints).

Response

Full questionnaire detail including the canonical graph, the derived sections view, version metadata, and is_editable.

Full questionnaire detail returned from GET, POST (create) and PATCH (update) endpoints.

questionnaire_id
string<uuid>

Unique identifier of the questionnaire. Use this id when referencing the questionnaire from a workflow or in subsequent update/delete requests.

title
string
description
string | null
languages
string[]
default_language
string
is_active
boolean
is_simple_questionnaire
boolean
graph
object

Graph structure with start_node and nodes map.

sections
object[]

Questionnaire content grouped into sections (derived from the graph).

questionnaire_group_id
string<uuid>

Stable identifier that groups all versions of the same questionnaire.

version
integer
status
enum<string>
Available options:
draft,
published
published_at
string<date-time> | null
is_editable
boolean

True when the questionnaire can still be edited in place (draft versions).