---
title: "Get the scrubbed results and data validations of an uploaded ISO application by its heron_id (prefixed \"iso_\")"
method: GET
path: "/api/iso_applications/{heron_id}"
tags: ["ISOApplication"]
---

# Get the scrubbed results and data validations of an uploaded ISO application by its heron_id (prefixed "iso_")

`GET /api/iso_applications/{heron_id}`

Use this endpoint to retrieve the scrubbed results and data validations of an uploaded ISO application PDF once it has finished processing. If processing is still underway, the processing_status field will be "processing".

## Path parameters

- `heron_id` string, required

## Response `200`

Ok

- GetIsoApplicationSchema
  - `created` string, date-time
  - `end_user_heron_id` string — The heron_id of the end_user associated with the iso application, if available
  - `end_user_id` string — The end_user_id of the end_user associated with the iso application, if available
  - `field_validations` IsoApplicationFieldValidation[]
    - `failure_reason` string, nullable, required
    - `field_name` string, required
    - `result` 'passed' | 'failed' | 'not_applicable', required
    - `validation_type` string, required
  - `filename` string, required — The original filename of the ISO application form
  - `heron_id` string, required — The ISO application's heron_id
  - `processing_status` 'new' | 'processing' | 'processed' | 'failed', required — The processing status of the file.
  - `quality_status` 'fully_matched' | 'review_required' | 'null', nullable, required — The overall field validation results. 'fully_matched' indicated all field validations have passed. 'review_required' indicates one or more field validations failed.
  - `result` object — The extracted keys/values from the form, normalised to Heron's field schema. Keys will only be present in results if they are found in the original file. For a full list of fields, see the documentation.
  - `source_email` EndUserEmail
    - `cc_addresses` string[]
    - `date_sent` string, date-time
    - `date_sent_string` string
    - `from_address` string
    - `from_address_domain` string
    - `from_name` string
    - `html_body` string
    - `html_or_text_body` string
    - `reply_to` string, nullable
    - `subject` string
    - `text_body` string
    - `to_addresses` 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)