---
title: "Get K1 extraction response in normalized envelope shape"
method: POST
path: "/internal/api/document/{document_id}/k1/response"
tags: ["DOCUMENT"]
---

# Get K1 extraction response in normalized envelope shape

`POST /internal/api/document/{document_id}/k1/response`

## Request

- Base URL: `https://api.signalshq.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.signalshq.io/internal/api/document/{document_id}/k1/response`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Returns K1 extraction result structured as the K1xStandard normalized envelope. Top-level keys per subtype (standard_1065, schedule_k3, etc.), each containing sections with flattened attributes.

## Path parameters

- `document_id` string, uuid, required: Document ID

## Request body

- DocumentExtractionRequest: Request schema for document extraction response
  - `client_id` string, uuid, required: Client ID for the document

## Response `200`

Successful Response

- K1NormalizedResponse: Complete K1 extraction response in the normalized envelope shape.
  - `document_id` string, required: Document ID that was extracted
  - `extraction_source` string: Extraction engine used
  - `extraction_job_id` string, nullable: Extraction job identifier
  - `standard_1065` K1Form: Normalized representation of a single K1 form type (1065, 1041, 1120S, or K-3).
    - `form_type` string, required: Document identifier for the form type
    - `tax_year` integer, nullable: Tax year for this K1
    - `tax_year_beginning` string, nullable: Fiscal year start date
    - `tax_year_ending` string, nullable: Fiscal year end date
    - `is_final_k1` boolean, nullable: Whether this is a final K1
    - `is_amended_k1` boolean, nullable: Whether this is an amended K1
    - `is_ocr` boolean, nullable: Whether this was OCR-processed
    - `summary` K1FormSummary, required: Summary metadata extracted from the K1 form header.
      - `issuer` K1FormSummaryParty: Issuer or recipient party information from a K1 form.
        - `tax_id` string, nullable: Tax identification number
        - `name` string, nullable: Party name
        - `address` string, nullable: Party address
      - `recipient` K1FormSummaryParty: Issuer or recipient party information from a K1 form.
        - `tax_id` string, nullable: Tax identification number
        - `name` string, nullable: Party name
        - `address` string, nullable: Party address
      - `profit_loss_capital` object, nullable: Profit, loss, and capital percentages
      - `modifications` unknown
    - `sections` K1Section[], required: Sections containing extracted attributes
      - `key` string, required: Section identifier key
      - `display_name` string, required: Human-readable section title
      - `display_order` integer, required: Sort order for UI rendering
      - `attributes` K1NormalizedAttribute[], required: Attributes within this section
        - `id` string, required: Unique identifier for this extracted attribute
        - `key` string, required: Attribute key used for programmatic lookups
        - `vendor_attribute_name` string, required: Original vendor-assigned attribute name
        - `display_name` string, required: Human-readable label for the attribute
        - `datatype` string, required: Data type of the attribute value
        - `display_order` integer, required: Sort order for UI rendering
        - `value` unknown
        - `is_user_updateable` boolean: Whether the user can edit this value
        - `confidence_score` number, nullable: Model confidence score
        - `status` string: Review status of the attribute
        - `is_user_updated` boolean: Whether the user has modified this value
        - `bounding_regions` unknown[]: Bounding regions for the attribute on the source document
          - unknown
    - `activities` K1Activity[], nullable: Activities reported on the form
      - `activity_name` string, nullable: Name of the activity
      - `activity_number` string, nullable: Activity sequence number
      - `attributes` K1NormalizedAttribute[]: Attributes for this activity
        - `id` string, required: Unique identifier for this extracted attribute
        - `key` string, required: Attribute key used for programmatic lookups
        - `vendor_attribute_name` string, required: Original vendor-assigned attribute name
        - `display_name` string, required: Human-readable label for the attribute
        - `datatype` string, required: Data type of the attribute value
        - `display_order` integer, required: Sort order for UI rendering
        - `value` unknown
        - `is_user_updateable` boolean: Whether the user can edit this value
        - `confidence_score` number, nullable: Model confidence score
        - `status` string: Review status of the attribute
        - `is_user_updated` boolean: Whether the user has modified this value
        - `bounding_regions` unknown[]: Bounding regions for the attribute on the source document
          - unknown
  - `standard_1041` K1Form: Normalized representation of a single K1 form type (1065, 1041, 1120S, or K-3).
    - `form_type` string, required: Document identifier for the form type
    - `tax_year` integer, nullable: Tax year for this K1
    - `tax_year_beginning` string, nullable: Fiscal year start date
    - `tax_year_ending` string, nullable: Fiscal year end date
    - `is_final_k1` boolean, nullable: Whether this is a final K1
    - `is_amended_k1` boolean, nullable: Whether this is an amended K1
    - `is_ocr` boolean, nullable: Whether this was OCR-processed
    - `summary` K1FormSummary, required: Summary metadata extracted from the K1 form header.
      - `issuer` K1FormSummaryParty: Issuer or recipient party information from a K1 form.
        - `tax_id` string, nullable: Tax identification number
        - `name` string, nullable: Party name
        - `address` string, nullable: Party address
      - `recipient` K1FormSummaryParty: Issuer or recipient party information from a K1 form.
        - `tax_id` string, nullable: Tax identification number
        - `name` string, nullable: Party name
        - `address` string, nullable: Party address
      - `profit_loss_capital` object, nullable: Profit, loss, and capital percentages
      - `modifications` unknown
    - `sections` K1Section[], required: Sections containing extracted attributes
      - `key` string, required: Section identifier key
      - `display_name` string, required: Human-readable section title
      - `display_order` integer, required: Sort order for UI rendering
      - `attributes` K1NormalizedAttribute[], required: Attributes within this section
        - `id` string, required: Unique identifier for this extracted attribute
        - `key` string, required: Attribute key used for programmatic lookups
        - `vendor_attribute_name` string, required: Original vendor-assigned attribute name
        - `display_name` string, required: Human-readable label for the attribute
        - `datatype` string, required: Data type of the attribute value
        - `display_order` integer, required: Sort order for UI rendering
        - `value` unknown
        - `is_user_updateable` boolean: Whether the user can edit this value
        - `confidence_score` number, nullable: Model confidence score
        - `status` string: Review status of the attribute
        - `is_user_updated` boolean: Whether the user has modified this value
        - `bounding_regions` unknown[]: Bounding regions for the attribute on the source document
          - unknown
    - `activities` K1Activity[], nullable: Activities reported on the form
      - `activity_name` string, nullable: Name of the activity
      - `activity_number` string, nullable: Activity sequence number
      - `attributes` K1NormalizedAttribute[]: Attributes for this activity
        - `id` string, required: Unique identifier for this extracted attribute
        - `key` string, required: Attribute key used for programmatic lookups
        - `vendor_attribute_name` string, required: Original vendor-assigned attribute name
        - `display_name` string, required: Human-readable label for the attribute
        - `datatype` string, required: Data type of the attribute value
        - `display_order` integer, required: Sort order for UI rendering
        - `value` unknown
        - `is_user_updateable` boolean: Whether the user can edit this value
        - `confidence_score` number, nullable: Model confidence score
        - `status` string: Review status of the attribute
        - `is_user_updated` boolean: Whether the user has modified this value
        - `bounding_regions` unknown[]: Bounding regions for the attribute on the source document
          - unknown
  - `standard_1120s` K1Form: Normalized representation of a single K1 form type (1065, 1041, 1120S, or K-3).
    - `form_type` string, required: Document identifier for the form type
    - `tax_year` integer, nullable: Tax year for this K1
    - `tax_year_beginning` string, nullable: Fiscal year start date
    - `tax_year_ending` string, nullable: Fiscal year end date
    - `is_final_k1` boolean, nullable: Whether this is a final K1
    - `is_amended_k1` boolean, nullable: Whether this is an amended K1
    - `is_ocr` boolean, nullable: Whether this was OCR-processed
    - `summary` K1FormSummary, required: Summary metadata extracted from the K1 form header.
      - `issuer` K1FormSummaryParty: Issuer or recipient party information from a K1 form.
        - `tax_id` string, nullable: Tax identification number
        - `name` string, nullable: Party name
        - `address` string, nullable: Party address
      - `recipient` K1FormSummaryParty: Issuer or recipient party information from a K1 form.
        - `tax_id` string, nullable: Tax identification number
        - `name` string, nullable: Party name
        - `address` string, nullable: Party address
      - `profit_loss_capital` object, nullable: Profit, loss, and capital percentages
      - `modifications` unknown
    - `sections` K1Section[], required: Sections containing extracted attributes
      - `key` string, required: Section identifier key
      - `display_name` string, required: Human-readable section title
      - `display_order` integer, required: Sort order for UI rendering
      - `attributes` K1NormalizedAttribute[], required: Attributes within this section
        - `id` string, required: Unique identifier for this extracted attribute
        - `key` string, required: Attribute key used for programmatic lookups
        - `vendor_attribute_name` string, required: Original vendor-assigned attribute name
        - `display_name` string, required: Human-readable label for the attribute
        - `datatype` string, required: Data type of the attribute value
        - `display_order` integer, required: Sort order for UI rendering
        - `value` unknown
        - `is_user_updateable` boolean: Whether the user can edit this value
        - `confidence_score` number, nullable: Model confidence score
        - `status` string: Review status of the attribute
        - `is_user_updated` boolean: Whether the user has modified this value
        - `bounding_regions` unknown[]: Bounding regions for the attribute on the source document
          - unknown
    - `activities` K1Activity[], nullable: Activities reported on the form
      - `activity_name` string, nullable: Name of the activity
      - `activity_number` string, nullable: Activity sequence number
      - `attributes` K1NormalizedAttribute[]: Attributes for this activity
        - `id` string, required: Unique identifier for this extracted attribute
        - `key` string, required: Attribute key used for programmatic lookups
        - `vendor_attribute_name` string, required: Original vendor-assigned attribute name
        - `display_name` string, required: Human-readable label for the attribute
        - `datatype` string, required: Data type of the attribute value
        - `display_order` integer, required: Sort order for UI rendering
        - `value` unknown
        - `is_user_updateable` boolean: Whether the user can edit this value
        - `confidence_score` number, nullable: Model confidence score
        - `status` string: Review status of the attribute
        - `is_user_updated` boolean: Whether the user has modified this value
        - `bounding_regions` unknown[]: Bounding regions for the attribute on the source document
          - unknown
  - `schedule_k3` K1Form: Normalized representation of a single K1 form type (1065, 1041, 1120S, or K-3).
    - `form_type` string, required: Document identifier for the form type
    - `tax_year` integer, nullable: Tax year for this K1
    - `tax_year_beginning` string, nullable: Fiscal year start date
    - `tax_year_ending` string, nullable: Fiscal year end date
    - `is_final_k1` boolean, nullable: Whether this is a final K1
    - `is_amended_k1` boolean, nullable: Whether this is an amended K1
    - `is_ocr` boolean, nullable: Whether this was OCR-processed
    - `summary` K1FormSummary, required: Summary metadata extracted from the K1 form header.
      - `issuer` K1FormSummaryParty: Issuer or recipient party information from a K1 form.
        - `tax_id` string, nullable: Tax identification number
        - `name` string, nullable: Party name
        - `address` string, nullable: Party address
      - `recipient` K1FormSummaryParty: Issuer or recipient party information from a K1 form.
        - `tax_id` string, nullable: Tax identification number
        - `name` string, nullable: Party name
        - `address` string, nullable: Party address
      - `profit_loss_capital` object, nullable: Profit, loss, and capital percentages
      - `modifications` unknown
    - `sections` K1Section[], required: Sections containing extracted attributes
      - `key` string, required: Section identifier key
      - `display_name` string, required: Human-readable section title
      - `display_order` integer, required: Sort order for UI rendering
      - `attributes` K1NormalizedAttribute[], required: Attributes within this section
        - `id` string, required: Unique identifier for this extracted attribute
        - `key` string, required: Attribute key used for programmatic lookups
        - `vendor_attribute_name` string, required: Original vendor-assigned attribute name
        - `display_name` string, required: Human-readable label for the attribute
        - `datatype` string, required: Data type of the attribute value
        - `display_order` integer, required: Sort order for UI rendering
        - `value` unknown
        - `is_user_updateable` boolean: Whether the user can edit this value
        - `confidence_score` number, nullable: Model confidence score
        - `status` string: Review status of the attribute
        - `is_user_updated` boolean: Whether the user has modified this value
        - `bounding_regions` unknown[]: Bounding regions for the attribute on the source document
          - unknown
    - `activities` K1Activity[], nullable: Activities reported on the form
      - `activity_name` string, nullable: Name of the activity
      - `activity_number` string, nullable: Activity sequence number
      - `attributes` K1NormalizedAttribute[]: Attributes for this activity
        - `id` string, required: Unique identifier for this extracted attribute
        - `key` string, required: Attribute key used for programmatic lookups
        - `vendor_attribute_name` string, required: Original vendor-assigned attribute name
        - `display_name` string, required: Human-readable label for the attribute
        - `datatype` string, required: Data type of the attribute value
        - `display_order` integer, required: Sort order for UI rendering
        - `value` unknown
        - `is_user_updateable` boolean: Whether the user can edit this value
        - `confidence_score` number, nullable: Model confidence score
        - `status` string: Review status of the attribute
        - `is_user_updated` boolean: Whether the user has modified this value
        - `bounding_regions` unknown[]: Bounding regions for the attribute on the source document
          - unknown
  - `state_k1_information` object, nullable: State-level K1 information
  - `supplemental_information` object, nullable: Supplemental information statements
  - `foreign_disclosures` unknown[], nullable: Foreign transaction disclosures
    - unknown
  - `section_199as` unknown[], nullable: Section 199A qualified business income
    - unknown
  - `ubti` unknown[], nullable: Unrelated business taxable income
    - unknown
  - `form_1099s` unknown[], nullable: Associated Form 1099 information
    - unknown
  - `form_w2s` unknown[], nullable: Associated Form W-2 information
    - unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/signalshq/apis/signals-api.md) - [All operations](https://skmtc.dev/signalshq/apis/signals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalshq/apis/signals-api/revisions/2c22af3b5576?raw)