---
title: "Get Questionnaire Structure"
method: GET
path: "/questionnaires/structure"
tags: ["questionnaires"]
---

# Get Questionnaire Structure

`GET /questionnaires/structure`

## Request

- Base URL: `https://api.threadchain.pro` (the document declares no server; this is the origin it was published from)
- URL: `https://api.threadchain.pro/questionnaires/structure`
- Auth: OAuth 2
  - Password
  - Token URL: `auth/token`

Get questionnaire structure grouped by phases.

Returns a list of phases with metadata including:
- Phase name
- Phase order
- Question count
- Question IDs in that phase

If session_id is provided, also includes completion status:
- Answered questions count
- Whether phase is complete
- Whether phase is current

This endpoint is used by the frontend to display phase cards
in the wizard overview modal.

## Query parameters

- `product_type` 'jewelry' | 'clothes', required
- `session_id` string, uuid, nullable: Session ID to include completion status

## Response `200`

Successful Response

- QuestionnaireStructureResponse
  - `phases` PhaseStructure[], required
    - `name` string, required
    - `order` integer, required
    - `question_count` integer, required
    - `question_ids` string[], required
    - `answered_questions` integer
    - `is_complete` boolean
    - `is_current` boolean
    - `questions` QuestionStructure[]
      - `id` string, uuid, required
      - `text` string, required
      - `input_type` string, required
      - `order` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/threadchain/apis/threadchain-backend.md) - [All operations](https://skmtc.dev/threadchain/apis/threadchain-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/threadchain/apis/threadchain-backend/revisions/8ee288a7e6bd?raw)