---
title: "Start questionnaire parsing"
method: POST
path: "/v1/questionnaire/upload-and-parse"
tags: ["Questionnaire"]
---

# Start questionnaire parsing

`POST /v1/questionnaire/upload-and-parse`

Upload a questionnaire payload and start asynchronous parsing, returning a run ID for real-time progress tracking.

## Request body

- UploadAndParseDto

## Response `200`

Upload file and trigger async parsing. Returns runId for realtime tracking.

- object
  - `runId` string
  - `publicAccessToken` string

## Changes

- **2026-04-01** `ab25f417b60b` — 2 warning, 2 info
  - removed the optional property `questionnaireId` from the response with the `200` status
  - removed the optional property `totalQuestions` from the response with the `200` status
  - added the optional property `publicAccessToken` to the response with the `200` status
  - added the optional property `runId` to the response with the `200` status
- **2026-03-05** `946edaa856a9` — 1 info
  - the endpoint scheme security `apikey` was added to the API

[Change history](https://skmtc.dev/om-network/apis/betayum-api/changes/v1/questionnaire/upload-and-parse/post.md)

---

[API](https://skmtc.dev/om-network/apis/betayum-api.md) · [All operations](https://skmtc.dev/om-network/apis/betayum-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/om-network/betayum-api/revisions/95679a9aa625/schema)