---
title: "Get parsed results from uploaded files"
method: GET
path: "/api/end_user_files/{heron_id}/parsed_results"
tags: ["EndUserFiles"]
---

# Get parsed results from uploaded files

`GET /api/end_user_files/{heron_id}/parsed_results`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/end_user_files/{heron_id}/parsed_results`
- Auth: API key in header `x-api-key`

## Path parameters

- `heron_id` string, required

## Query parameters

- `parser_id` string, nullable
- `version_number` integer, nullable

## Response `200`

OK

- ParsedEndUserFileSchema[]
  - `attribute_values` object[]
  - `bounding_boxes` ParsedEndUserFileBoundingBox[], nullable
    - `bounding_box` number[], required: Bounding box coordinates in the format 'y1,x1,y2,x2'
    - `json_pointer` string, required: JSON pointer to the field in the parsed result
    - `page_num` integer, required: Page number where the bounding box is located
    - `value` string, required: The actual value of the field within the bounding box
  - `created` string, date-time, required
  - `field_validations` FieldValidation[]
    - `failure_reason` string, nullable, required
    - `field_name` string, required
    - `result` 'pass' | 'fail' | 'not_applicable', required
    - `validation_type` string, required
  - `heron_id` string, required: Unique identifier of the end user file
  - `id` integer: [DEPRECATED] Unique identifier for the parsed file
  - `layout_bounding_boxes` ParsedEndUserFileBoundingBox[], nullable
    - `bounding_box` number[], required: Bounding box coordinates in the format 'y1,x1,y2,x2'
    - `json_pointer` string, required: JSON pointer to the field in the parsed result
    - `page_num` integer, required: Page number where the bounding box is located
    - `value` string, required: The actual value of the field within the bounding box
  - `parser_display_name` string
  - `parser_id` string, required
  - `parsing_status` 'succeeded' | 'failed' | 'processing', required
  - `patches` ParsedEndUserFilePatch[]
    - `correction_reason` string, nullable
    - `enabled` boolean, nullable
    - `op` string, required
    - `original_value` unknown
    - `path` string, required
    - `source` string, nullable
    - `value` unknown
  - `result` object, nullable: Final output result after applying patches
  - `result_schema` object: The output JSON schema the results conform to
  - `validation_summary` string: Summary of validation results

---

[API](https://skmtc.dev/herondata/apis/heron-data-api.md) - [All operations](https://skmtc.dev/herondata/apis/heron-data-api/llms.txt) - [OpenAPI document](https://skmtc.dev/herondata/apis/heron-data-api/revisions/1ec936e17fef?raw)
