---
title: "Add details to broker submission"
method: POST
path: "/api/broker_submissions/{submission_heron_id}/update_information"
tags: ["BrokerSubmissions"]
---

# Add details to broker submission

`POST /api/broker_submissions/{submission_heron_id}/update_information`

## Request

- Base URL: `https://app.herondata.io`
- URL: `https://app.herondata.io/api/broker_submissions/{submission_heron_id}/update_information`
- Auth: API key in header `x-api-key`

Add company and owner details to existing broker submission.
**Authentication**: Requires a broker API key in the `x-api-key` header. Generate keys using the `/api/broker_submissions/api_keys/generate` endpoint.

## Path parameters

- `submission_heron_id` string, required

## Request body

- EndUserInformationPatchSchema
  - `amount_requested` number, nullable
  - `annual_revenue` number, nullable
  - `business_start_date` string, date, nullable
  - `company_billing_address` Address
    - `city` string, nullable
    - `line_1` string, nullable
    - `line_2` string, nullable
    - `state` string, nullable
    - `zip` string, nullable
  - `company_email` string, nullable
  - `company_legal_business_name` string, nullable
  - `company_phone_number` string, nullable
  - `company_physical_address` Address
    - `city` string, nullable
    - `line_1` string, nullable
    - `line_2` string, nullable
    - `state` string, nullable
    - `zip` string, nullable
  - `company_website` string, nullable
  - `dba` string, nullable: Doing business as
  - `federal_tax_id` string, nullable
  - `industry_type` string, nullable
  - `loan_purpose` string, nullable
  - `monthly_revenue` number, nullable
  - `naics` string, nullable
  - `owner_1` Owner
    - `credit_score` integer, nullable
    - `date_of_birth` string, date, nullable
    - `email_address` string, nullable
    - `first_name` string, nullable
    - `has_signed` boolean, nullable
    - `home_address` Address
      - `city` string, nullable
      - `line_1` string, nullable
      - `line_2` string, nullable
      - `state` string, nullable
      - `zip` string, nullable
    - `home_phone` string, nullable
    - `last_name` string, nullable
    - `middle_name` string, nullable
    - `mobile_phone` string, nullable
    - `ownership_percentage` number, nullable: Percentage of ownership
    - `prefix` string, nullable: Name prefix
    - `signed_date` string, date, nullable
    - `social_security_number` string, nullable
    - `suffix` string, nullable: Generational or professional suffix
  - `owner_2` Owner
    - `credit_score` integer, nullable
    - `date_of_birth` string, date, nullable
    - `email_address` string, nullable
    - `first_name` string, nullable
    - `has_signed` boolean, nullable
    - `home_address` Address
      - `city` string, nullable
      - `line_1` string, nullable
      - `line_2` string, nullable
      - `state` string, nullable
      - `zip` string, nullable
    - `home_phone` string, nullable
    - `last_name` string, nullable
    - `middle_name` string, nullable
    - `mobile_phone` string, nullable
    - `ownership_percentage` number, nullable: Percentage of ownership
    - `prefix` string, nullable: Name prefix
    - `signed_date` string, date, nullable
    - `social_security_number` string, nullable
    - `suffix` string, nullable: Generational or professional suffix
  - `predicted_industry_probability` number, nullable
  - `source_email_address` string, nullable
  - `source_name` string, nullable
  - `source_notes` string, nullable
  - `state_of_incorporation` string, nullable
  - `type_of_business_entity` string, nullable

## Response `200`

OK

- EndUserInformationSchema
  - `amount_requested` number, nullable
  - `annual_revenue` number, nullable
  - `business_start_date` string, date, nullable
  - `company_billing_address` Address
    - `city` string, nullable
    - `line_1` string, nullable
    - `line_2` string, nullable
    - `state` string, nullable
    - `zip` string, nullable
  - `company_email` string, nullable
  - `company_legal_business_name` string, nullable
  - `company_phone_number` string, nullable
  - `company_physical_address` Address
    - `city` string, nullable
    - `line_1` string, nullable
    - `line_2` string, nullable
    - `state` string, nullable
    - `zip` string, nullable
  - `company_website` string, nullable
  - `dba` string, nullable: Doing business as
  - `federal_tax_id` string, nullable
  - `industry_type` string, nullable
  - `loan_purpose` string, nullable
  - `monthly_revenue` number, nullable
  - `naics` string, nullable
  - `owner_1` Owner
    - `credit_score` integer, nullable
    - `date_of_birth` string, date, nullable
    - `email_address` string, nullable
    - `first_name` string, nullable
    - `has_signed` boolean, nullable
    - `home_address` Address
      - `city` string, nullable
      - `line_1` string, nullable
      - `line_2` string, nullable
      - `state` string, nullable
      - `zip` string, nullable
    - `home_phone` string, nullable
    - `last_name` string, nullable
    - `middle_name` string, nullable
    - `mobile_phone` string, nullable
    - `ownership_percentage` number, nullable: Percentage of ownership
    - `prefix` string, nullable: Name prefix
    - `signed_date` string, date, nullable
    - `social_security_number` string, nullable
    - `suffix` string, nullable: Generational or professional suffix
  - `owner_2` Owner
    - `credit_score` integer, nullable
    - `date_of_birth` string, date, nullable
    - `email_address` string, nullable
    - `first_name` string, nullable
    - `has_signed` boolean, nullable
    - `home_address` Address
      - `city` string, nullable
      - `line_1` string, nullable
      - `line_2` string, nullable
      - `state` string, nullable
      - `zip` string, nullable
    - `home_phone` string, nullable
    - `last_name` string, nullable
    - `middle_name` string, nullable
    - `mobile_phone` string, nullable
    - `ownership_percentage` number, nullable: Percentage of ownership
    - `prefix` string, nullable: Name prefix
    - `signed_date` string, date, nullable
    - `social_security_number` string, nullable
    - `suffix` string, nullable: Generational or professional suffix
  - `predicted_industry_probability` number, nullable
  - `source_email_address` string, nullable
  - `source_name` string, nullable
  - `source_notes` string, nullable
  - `source_type` 'api' | 'iso_application_form' | 'heron_industry_classifier' | 'rel6_industry_classifier' | 'email' | 'end_user_entities': Source of the end user information
  - `state_of_incorporation` string, nullable
  - `type_of_business_entity` string, nullable

## Changes

- **2026-11-03** `bd8008e49534`: 12 info
  - added the new optional request property `owner_1/middle_name`
  - added the new optional request property `owner_1/prefix`
  - added the new optional request property `owner_1/suffix`
  - added the new optional request property `owner_2/middle_name`
  - …8 more

[Operation history](https://skmtc.dev/herondata/apis/heron-data-api/changes/api/broker_submissions/:submission_heron_id/update_information/post.md)

---

[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)