Skip to main content
POST
/
api
/
broker_submissions
/
{submission_heron_id}
/
files
curl --request POST \
  --url https://app.herondata.io/api/broker_submissions/{submission_heron_id}/files \
  --header 'Content-Type: multipart/form-data' \
  --header 'x-api-key: <api-key>' \
  --form 'files[0]=january.pdf' \
  --form 'files[1]=february.pdf' \
  --form 'files[2]=march.pdf' \
  --form files.items='@example-file'
[
  {
    "file": "statement_q4.pdf",
    "status": "uploaded"
  }
]

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
submission_heron_id
string
required

The unique identifier for the broker submission to upload files to

Example:

"sub_1a2b3c4d5e6f"

Body

multipart/form-data
​
files
file[]
required

Array of PDF files to upload (minimum 1, maximum 5)

Required array length: 1 - 5 elements

Response

All files uploaded successfully

​
file
string

Name of the uploaded file

Example:

"statement_q4.pdf"

​
status
enum<string>

Status of the file upload

Available options:
uploaded
Example:

"uploaded"