---
title: "Fetch Grouped Assessments"
method: GET
path: "/assessment/api/fetch_interviews/v2/"
---

# Fetch Grouped Assessments

`GET /assessment/api/fetch_interviews/v2/`

Fetch assessments from both Self-Assessment and Smartcheck modules.

## Query parameters

- `practitioner_uuid` string
- `patient_uuid` string
- `unique_identifier` string
- `transaction_id` string
- `username_alias` 'practitioner_uuid' | 'patient_uuid' | 'unique_identifier' | 'transaction_id'
- `wfids` string
- `status` 'NEW' | 'IN_REVIEW' | 'COMPLETED' | 'PARTIAL'

## Response `200`

A successful response containing the grouped assessments.

- object
  - `conversations` object[] — A list of assessment groups.
    - `practitioner_uuid` string — The practitioner UUID for this group.
    - `patient_uuid` string — The patient UUID for this group.
    - `unique_identifier` string — The OID stored against this assessment group. When `username_alias` is used, this will be the resolved OID — not the UHID that was passed in.
    - `transaction_id` string — The transaction ID for this group.
    - `conversations` object[] — A list of individual assessments within this group.
      - `conversationid` string — The unique ID for the assessment, prefixed with 'sa_' or 'sn_'.
      - `created_at` string, date-time — The creation timestamp of the assessment.
      - `wflow_wfid` integer, nullable — The workflow ID (wfid) associated with this assessment.

## Other responses

- `400` — Validation error, such as a missing required ID in the token or an invalid status.
- `500` — Internal 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/versions/9ea23456f722/schema)