---
title: "All EndUserFiles"
method: GET
path: "/api/end_user_files"
tags: ["EndUserFiles"]
---

# All EndUserFiles

`GET /api/end_user_files`

Get all files uploaded to Heron by your users, not including parsed results from files

## Response `200`

OK

- EndUserFileSchema[]
  - `bank_statement` PdfGet
    - `data_source` DataSourceNested
      - `heron_id` string — Heron ID of the data source
      - `is_enabled` boolean — Whether this data source is enabled
    - `heron_id` string — ID generated by Heron Data
    - `status` 'new' | 'parsing' | 'parsed' | 'processed' | 'human_reviewing' | 'approved' | 'rejected' | 'failed' | 'transactions_loaded' | 'transactions_unloaded' — Status of PDF
  - `created` string, date-time
  - `email` EndUserEmailSchema
    - `cc_addresses` string[]
    - `created` string, date-time
    - `date_sent` string, date-time
    - `date_sent_string` string
    - `from_address` string
    - `from_address_domain` string
    - `from_name` string
    - `heron_id` string
    - `html_body` string
    - `html_or_text_body` string
    - `is_reply` boolean
    - `processing_status` 'new' | 'processing' | 'processed' | 'failed'
    - `reply_to` string, nullable
    - `subject` string
    - `subject_cleaned` string
    - `text_body` string
    - `to_addresses` string[]
    - `viewer_url` string — a temporary, secure URL for viewing the email contents
  - `file_class` string
  - `file_source_metadata` object, nullable
  - `filename` string
  - `heron_id` string
  - `iso_application` GetIsoApplication
    - `heron_id` string, required — The ISO application's heron_id
    - `processing_status` 'new' | 'processing' | 'processed' | 'failed', required — The processing status of the file.
  - `num_pages` integer
  - `page_classes` object, nullable
  - `parent_heron_id` string, nullable
  - `parsed_results` ParsedEndUserFile[]
    - `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
  - `processing_error` string, nullable
  - `reference_id` string
  - `renamed_filename` string

---

[API](https://skmtc.net/herondata/apis/heron-data-api.md) · [All operations](https://skmtc.net/herondata/apis/heron-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/herondata/heron-data-api/versions/f2e441edece2/schema)