How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Heron End Users API

The End Users API from Heron — 3 operation(s) for end users.

Heron End Users API is one of 47 APIs that Heron publishes on the APIs.io network, described by a machine-readable OpenAPI specification and an AsyncAPI event-driven specification.

Tagged areas include End Users. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, an API reference, a getting-started guide, authentication docs, and an AsyncAPI specification.

This API exposes 30 operations across 23 paths, and defines 106 schemas. It is described by OpenAPI 3.2.0, at version 2021-07-19.

Requests are made against a single base URL, https://app.herondata.io.

30 operations 23 paths 106 schemas 3 DELETE17 GET1 PATCH8 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2021-07-19
Base URL
https://app.herondata.io/api
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

Heron End Users API declares 1 security scheme for authenticating requests. An API key is passed in the header as x-api-key (ApiKeyAuth). By default, every request must be authenticated.

Paths & Operations 30

Across 23 paths, the API surfaces 30 operations — 3 DELETE, 17 GET, 1 PATCH, 8 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

End Users 30
GET
/api/end_users/{end_user_heron_id}/deal_link/
Get deal link entries for an end user
getApiEndUsersByEndUserHeronIdDealLink 1 param → 200404
GET
/api/end_users/{end_user_heron_id}/funder_policy_evaluations/
List funder policy evaluations for an end user
getApiEndUsersByEndUserHeronIdFunderPolicyEvaluations 1 param → 200404
POST
/api/end_users/{end_user_heron_id}/funder_submissions/{submission_heron_id}/submit_to_funder/
Submit an end user to a single funder
postApiEndUsersByEndUserHeronIdFunderSubmissionsBySubmissionHeronIdSubmitToFunder 2 params body → 202400404409
GET
/api/end_user_emails
Get EndUser emails
getApiEndUserEmails 2 params → 200
GET
/api/end_users
List EndUsers
getApiEndUsers 11 params → 200
POST
/api/end_users
Create EndUser
postApiEndUsers body → 201
PUT
/api/end_users
Update EndUser
putApiEndUsers body → 200
GET
/api/end_users/summary
List EndUsers with Summary Information
getApiEndUsersSummary 19 params → 200
GET
/api/end_users/{end_user_heron_id}/background_check
Get EndUser background check dashboard payload
getApiEndUsersByEndUserHeronIdBackgroundCheck 3 params → 200404
GET
/api/end_users/{end_user_heron_id}/background_check/affiliations
List an end user's background check affiliations
getApiEndUsersByEndUserHeronIdBackgroundCheckAffiliations 1 param → 200404
POST
/api/end_users/{end_user_heron_id}/background_check/affiliations/reports
Request background check reports for affiliations
postApiEndUsersByEndUserHeronIdBackgroundCheckAffiliationsReports 1 param body → 202404409
POST
/api/end_users/{end_user_heron_id}/background_check/affiliations/reports/confirm
Confirm a candidate for an affiliate report
postApiEndUsersByEndUserHeronIdBackgroundCheckAffiliationsReportsConfirm 1 param body → 202404409
DELETE
/api/end_users/{end_user_heron_id}/background_check/affiliations/reports/{ref}
Stop tracking an affiliate report
deleteApiEndUsersByEndUserHeronIdBackgroundCheckAffiliationsReportsByRef 2 params → 204404409
DELETE
/api/end_users/{end_user_heron_id}/background_check/override
Clear all CLEAR candidate overrides for a background check
deleteApiEndUsersByEndUserHeronIdBackgroundCheckOverride 1 param → 204404
GET
/api/end_users/{end_user_heron_id}/background_check/override
Get the pinned CLEAR candidate overrides for a background check
getApiEndUsersByEndUserHeronIdBackgroundCheckOverride 1 param → 200404
POST
/api/end_users/{end_user_heron_id}/background_check/override
Pin CLEAR candidate overrides for a background check
postApiEndUsersByEndUserHeronIdBackgroundCheckOverride 1 param body → 200404
GET
/api/end_users/{end_user_heron_id}/background_check/subjects/{subject_key}/raw_report
Download a background check raw report
getApiEndUsersByEndUserHeronIdBackgroundCheckSubjectsBySubjectKeyRawReport 2 params → 200404
GET
/api/end_users/{end_user_heron_id}/background_check/subjects/{subject_key}/records/{record_id}/mugshot
View a criminal-record mug shot
getApiEndUsersByEndUserHeronIdBackgroundCheckSubjectsBySubjectKeyRecordsByRecordIdMugshot 3 params → 200404
GET
/api/end_users/{end_user_heron_id}/duplicate_end_users
Get duplicate end users for an end user
getApiEndUsersByEndUserHeronIdDuplicateEndUsers 1 param → 200403404
DELETE
/api/end_users/{end_user_id_or_heron_id}deprecated
Delete EndUser by heronid or enduserid (sync)
deleteApiEndUsersByEndUserIdOrHeronId 1 param → 204
GET
/api/end_users/{end_user_id_or_heron_id}
Get EndUser by heronid or enduserid
getApiEndUsersByEndUserIdOrHeronId 1 param → 200
POST
/api/end_users/{end_user_id_or_heron_id}/delete
Delete EndUser by heronid or enduserid (async)
postApiEndUsersByEndUserIdOrHeronIdDelete 1 param → 202
GET
/api/end_users/{end_user_id_or_heron_id}/emails
Get EndUser emails
getApiEndUsersByEndUserIdOrHeronIdEmails 1 param → 200
GET
/api/end_users/{end_user_id_or_heron_id}/end_user_information
Get EndUser information
getApiEndUsersByEndUserIdOrHeronIdEndUserInformation 1 param → 200
PATCH
/api/end_users/{end_user_id_or_heron_id}/end_user_information
Patch EndUser information
patchApiEndUsersByEndUserIdOrHeronIdEndUserInformation 1 param body → 200
POST
/api/end_users/{end_user_id_or_heron_id}/enrich
Enrich transactions of EndUser
postApiEndUsersByEndUserIdOrHeronIdEnrich 2 params → 200
GET
/api/end_users/{end_user_id_or_heron_id}/location
Get EndUser physical location
getApiEndUsersByEndUserIdOrHeronIdLocation 1 param → 200
GET
/api/end_users/{end_user_id_or_heron_id}/processing_status
Get EndUser processing status
getApiEndUsersByEndUserIdOrHeronIdProcessingStatus 1 param → 200404
GET
/api/end_users/{heron_id}/crm_sync
Retrieve CRM sync events for an end user
getApiEndUsersByHeronIdCrmSync 1 param → 200
POST
/api/end_users/{heron_id}/crm_sync
Trigger a CRM Sync for an End User
postApiEndUsersByHeronIdCrmSync 1 param → 200

Schemas 106

The contract defines 106 schemas that model the data the API accepts and returns. The most detailed are CriminalSectionRecordSchema (50 properties), CriminalRecordSchema (40 properties), CriminalSectionEntrySchema (37 properties), CorporateRecordSchema (36 properties). Each schema is shown below with its type and property counts.

FunderSearchResultSchema
object
3 properties
FunderPolicyEvaluation
object
10 properties
SubmitFunderSubmissionResponseSchema
object
1 property
SubmitFunderSubmissionRequestSchema
object
1 property 1 required
DealLinkEntry
object
7 properties
DealLinkOccurrence
object
2 properties
LinkedFunderSubmission
object
3 properties
LitigationEntrySchema
object
6 properties
BackgroundCheckCheckCounts
object
3 properties 3 required
CandidateFieldTrace
object
4 properties 4 required
SearchAttemptCandidateRef
object
6 properties 1 required
EndUserInformationSchema
object
24 properties
BusinessContact
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
12 properties
EndUserSummary
object
19 properties 1 required
BackgroundCheckSection
object
A subject's findings for one record type. Record fields differ by section key.
16 properties 5 required
EndUserWebhookPayload
object
4 properties
DetailMeeting341
object
3 properties
BackgroundCheckSubject
object
14 properties 8 required
DetailDocketEntry
object
16 properties
Address
object
5 properties
BackgroundCheckResolution
object
9 properties 4 required
BackgroundCheckAffiliateReportRequestSchema
object
1 property 1 required
AddressLocation
object
2 properties
BackgroundCheckCheck
object
10 properties 6 required
LienJudgmentRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
30 properties
EndUserInformationPatchSchema
object
23 properties
EndUser
object
14 properties 1 required
SearchAttemptOutcomeReason
object
2 properties 2 required
BackgroundCheckAffiliationReportState
object
3 properties 3 required
CorporateFilingHistoryEntrySchema
object
2 properties
DetailFiling
object
22 properties
ProfilePhone
object
4 properties
UCCFilingEntrySchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
20 properties
CriminalRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
40 properties
BusinessProfileRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
35 properties
BackgroundCheckDecision
object
4 properties
BackgroundCheckOverall
object
3 properties 3 required
BackgroundCheckEvidence
object
4 properties 2 required
CandidateScoreContribution
object
11 properties 5 required
BackgroundCheckAffiliationsViewSchema
object
3 properties 3 required
BackgroundCheckAffiliateConfirmSchema
object
2 properties 2 required
EndUserPostParams
object
13 properties 1 required
BackgroundCheckAffiliationPersonRow
object
8 properties 3 required
DetailCharge
object
35 properties
ProfileSsnIssuance
object
4 properties
BackgroundCheckAffiliateSelection
object
5 properties 4 required
DetailBail
object
5 properties
SearchInputsUsed
object
13 properties 1 required
CriminalChargeEntrySchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
33 properties
CandidateTraceModifier
object
3 properties 2 required
BackgroundCheckOverride
object
3 properties 3 required
CrmSyncEvent
object
8 properties
DetailLienDebtor
object
4 properties
PolicyEvaluationResult
object
4 properties
BackgroundCheckRecordDetail
object
Supplementary source detail returned with includesectiondetail=true. The summarised record is the stable typed interface.
21 properties
BackgroundCheckApplication
object
The application identity used for the search. All fields are nullable; SSNs remain masked.
10 properties
LienJudgmentEntrySchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
25 properties
DataSource
object
2 properties 1 required
DetailCase
object
26 properties
UCCRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
26 properties
ProfileAddress
object
6 properties
EndUserWebhookData
object
3 properties
BackgroundCheckAffiliateRequestAcceptedSchema
object
1 property 1 required
AffiliateSubject
object
14 properties 8 required
CriminalSectionEntrySchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
37 properties
SearchAttemptOutcomeReasonDetail
object
2 properties 1 required
WorkAffiliation
object
5 properties
CriminalSectionRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
50 properties
CandidateAnchorTrace
object
4 properties 2 required
Owner
object
15 properties
CandidateCapTrace
object
3 properties 3 required
BackgroundCheckCandidateOverrideSchema
object
3 properties
SearchAttempt
object
10 properties 7 required
Metric
object
9 properties
BackgroundCheckCandidate
object
One deduplicated candidate across the subject's search attempts, including its match score.
14 properties 1 required
OfacRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
23 properties
BankruptcyRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
13 properties
BackgroundCheckAffiliationRow
object
13 properties 2 required
CandidateScore
object
8 properties 4 required
AssociateRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
17 properties
DuplicateEndUsersResponse
object
1 property 1 required
DetailAttorney
object
8 properties
LawsuitRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
23 properties
BackgroundCheckResponseSchema
object
Dates use YYYY-MM-DD. Amounts are decimal strings. Nullable source fields return null. SSNs remain masked; full SSNs never appear.
7 properties 3 required
DetailDefendant
object
5 properties
BackgroundCheckAffiliateSearchInputs
object
6 properties
BackgroundCheckAffiliateReport
object
5 properties 4 required
CrmSyncEventSchema
object
8 properties
EndUserEmailSchema
object
18 properties
TagSchema
object
4 properties 1 required
DetailParty
object
9 properties
ProfileEmail
object
2 properties
MarriageRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
11 properties
EndUserEndUserFile
object
4 properties
CorporateRecordSchema
object
A background-check finding. Risk and severity carry the same none, low, medium, or high tier.
36 properties
EndUserAddressLocationSchema
object
1 property
DetailLabelValue
object
2 properties 1 required
BackgroundCheckRawReportSchema
object
3 properties 3 required
BackgroundCheckNearTie
object
3 properties 2 required
CandidateTraceComponent
object
2 properties 1 required
EndUserProcessingStatusSchema
object
1 property 1 required
BackgroundCheckAffiliationsBlock
object
2 properties 2 required
DuplicateEndUser
object
3 properties 2 required
BusinessContactAddress
object
5 properties
BackgroundCheckPolicy
object
2 properties 2 required
DetailSource
object
4 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

heron-end-users-api-openapi.yml Raw ↑

Other APIs Heron publishes across the network.

Heron Analytics API
Heron Authentication API
Heron Broker Funder Policies API
Heron Broker Submissions API
Heron Categories API
Heron Clear API
Heron Credentials API
Heron CRM Integrations API
Heron End User Attributes API
Heron End User Calculations API
Heron End User Data Source Accounts API
Heron End User Data Sources API
Where this information came from

This is an independent, third-party profile of Heron End Users API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.