---
title: "Grouped mixed doc classification summary"
method: GET
path: "/v2/index/mixed-doc/{mixed_doc_uuid}/summary"
tags: ["Classify"]
---

# Grouped mixed doc classification summary

`GET /v2/index/mixed-doc/{mixed_doc_uuid}/summary`

This API returns a classification summary for a mixed document, with forms organized into groups. Each group contains the associated pages and key details such as form type, status, and uniqueness values. Use this API to map pages to their respective forms, review form classifications, distinguish between known forms (such as 1040 and W2) and UNKNOWN forms, and extract key borrower data like SSN or name via `uniqueness_values`.
> 📘 About Uniqueness Values (UV)
 > The `uniqueness_values` array is populated only when the UV feature is enabled for your organization.
 > The fields returned within this array vary by form type but remain consistent across all organizations for a given form type. 
 > New UV fields may be added to existing form types over time. To enable this feature, contact your Ocrolus account team reach out to [support@ocrolus.com](mailto:support@ocrolus.com).

## Path parameters

- `mixed_doc_uuid` string, uuid, required

## Query parameters

- `split_unknowns` boolean
- `group_bank_statements` boolean

## Response `200`

Success

- object
  - `mixed_uploaded_doc_uuid` string, uuid — A unique identification code of the Mixed Document.
  - `form_groups` object[] — An array of form groups. Each group contains pages that belong together and their associated forms.
    - `pages` integer[] — An array of page indexes that belong to this group.
    - `forms` object[] — An array of forms associated with this group of pages.
      - `form_uuid` string, uuid, nullable — The unique identification code of a form. Returns an empty string or null for UNKNOWN forms.
      - `upload_origin` string — Origin of the uploaded form type.
      - `upload_details` object — Details of an uploaded form.
        - `mixed_doc_uuid` string, uuid — A unique identification code of the Mixed Document.
        - `mixed_doc_page_indexes` integer[] — An array of page indexes associated with this form within the Mixed Document.
        - `confidence` string, nullable — The confidence score associated with this Document. Returned as a string value or null.
      - `status` string — The processing status of the document.
      - `rejection_reason` string, nullable — An optional attribute that briefly explains why a Document was rejected.
      - `form_type` object — The type of form.
        - `name` string — The name of the form.
        - `account_type` string, nullable — Type of account.
        - `account_source` 'STANDARD_STATEMENT' | 'TRANSACTION_SUMMARY' | 'CREDIT_UNION' | 'VOA_PLAID' | 'VOA_BLEND' | 'VOA_FINICITY' | 'VOA_ACCOUNTCHEK' | 'VOA_OTHERS' | 'OTHERS' | 'null', nullable — The source of the bank account data. Only populated for BANK_ACCOUNT form types. Returns null for non-bank form types.
        - `display_name` string — Display name of the form.
      - `is_original` boolean, nullable — Identifies whether the uploaded form is the original version or a duplicate. When true, the form is an original. When false, the form is a duplicate of another form. Use `form_uuid_duplicate_of`` to identify the original form.
      - `form_uuid_duplicate_of` string, nullable — An optional field that contains the UUID of the original form when the current form is identified as a duplicate. Returns null if the form is an original. Use this field alongside `is_original` to identify and trace duplicate forms back to their source.
      - `uniqueness_values` object[] — Classification of the documents is based on the uniqueness values (UV). The fields under this array are displayed only when the UV feature is enabled for your organization. When not enabled, returns an empty array [].
        - `display_name` string — Display name of the attribute.
        - `raw_field_key` string — Unique identifier of the attribute in its raw and unprocessed form.
        - `value` string, nullable — Value of the attribute.
        - `confidence` number — The confidence score associated with this field.
      - `parent` boolean — Whether this is the primary or parent form in the group.

## Other responses

- `400` — Client Errors
- `403` — Forbidden
- `404` — NOT FOUND
- `500` — INTERNAL SERVER ERROR

---

[API](https://skmtc.net/ocrolus/apis/user-management.md) · [All operations](https://skmtc.net/ocrolus/apis/user-management/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ocrolus/user-management/revisions/3571ef602d13/schema)