---
title: "Step 1. Initialization"
method: POST
path: "/assessment/api/v1/init/"
tags: ["Assessments"]
---

# Step 1. Initialization

`POST /assessment/api/v1/init/`

This API is used to initialize the assessment. It returns an assessment_id that uniquely identifies the assessment session. <Warning>This API must be called to initiate a user assessment</Warning>

## Headers

- `client-id` string, required
- `locale` 'en' | 'hi' | 'kn'

## Request body

- object — The request body should contain the user information. Users can either provide the date of birth or age using `dob` and `age` fields respectively, along with gender inside `user_info`.
  - `user_info` union, required
    - object — The user information should contain atleast the age of the user.
      - `gender` 'M' | 'F' | 'O', required
      - `age` integer, required
      - `dob` string, date — DOB should be in the form of "YYYY-MM-DD"
    - object — The user information should contain atleast the dob of the user.
      - `gender` 'M' | 'F' | 'O', required
      - `dob` string, date, required — DOB should be in the form of "YYYY-MM-DD"
      - `age` integer
  - `workflow_id` integer, required — A unique id to identify the assessment to be taken. [Detailed list of Assessment Workflows](../../assessment-workflows)
  - `practitioner_uuid` string — A unique practitioner uuid to identify the practitioner to associate an assessment with, if applicable.
  - `patient_uuid` string — A unique patient uuid to identify the patient, if applicable.
  - `unique_identifier` string, required — Unique patient OID to identify the patient for which they are taking the assessment.
  - `transaction_id` string — The transaction ID for a specific assessment session, that you wish to give.

## Response `200`

OK

- ASInit200 — The response object contains the assessment_id that uniquely identifies the assessment session.
  - `assessment_id` string, required — A unique identifier for the assessment session.

## Other responses

- `400` — Bad Request
- `500` — Server Error

---

[API](https://skmtc.net/eka/apis/eka-developer-apis.md) · [All operations](https://skmtc.net/eka/apis/eka-developer-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/eka/eka-developer-apis/revisions/9ea23456f722/schema)