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 EndUsers API from Heron — 20 operation(s) for endusers.

Heron End Users API is one of 48 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 27 operations across 20 paths, and defines 99 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.

27 operations 20 paths 99 schemas 3 DELETE15 GET1 PATCH7 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 27

Across 20 paths, the API surfaces 27 operations — 3 DELETE, 15 GET, 1 PATCH, 7 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

EndUsers 27
GET
/api/end_user_emails
Get EndUser emails
2 params → 200
GET
/api/end_users
List EndUsers
11 params → 200
POST
/api/end_users
Create EndUser
body → 201
PUT
/api/end_users
Update EndUser
body → 200
GET
/api/end_users/summary
List EndUsers with Summary Information
19 params → 200
GET
/api/end_users/{end_user_heron_id}/background_check
Get EndUser background check dashboard payload
3 params → 200404
GET
/api/end_users/{end_user_heron_id}/background_check/affiliations
List an end user's background check affiliations
1 param → 200404
POST
/api/end_users/{end_user_heron_id}/background_check/affiliations/reports
Request background check reports for affiliations
1 param body → 202404409
POST
/api/end_users/{end_user_heron_id}/background_check/affiliations/reports/confirm
Confirm a candidate for an affiliate report
1 param body → 202404409
DELETE
/api/end_users/{end_user_heron_id}/background_check/affiliations/reports/{ref}
Stop tracking an affiliate report
2 params → 204404409
DELETE
/api/end_users/{end_user_heron_id}/background_check/override
Clear all CLEAR candidate overrides for a background check
1 param → 204404
GET
/api/end_users/{end_user_heron_id}/background_check/override
Get the pinned CLEAR candidate overrides for a background check
1 param → 200404
POST
/api/end_users/{end_user_heron_id}/background_check/override
Pin CLEAR candidate overrides for a background check
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
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
3 params → 200404
GET
/api/end_users/{end_user_heron_id}/duplicate_end_users
Get duplicate end users for an end user
1 param → 200403404
DELETE
/api/end_users/{end_user_id_or_heron_id}deprecated
Delete EndUser by heronid or enduserid (sync)
1 param → 204
GET
/api/end_users/{end_user_id_or_heron_id}
Get EndUser by heronid or enduserid
1 param → 200
POST
/api/end_users/{end_user_id_or_heron_id}/delete
Delete EndUser by heronid or enduserid (async)
1 param → 202
GET
/api/end_users/{end_user_id_or_heron_id}/emails
Get EndUser emails
1 param → 200
GET
/api/end_users/{end_user_id_or_heron_id}/end_user_information
Get EndUser information
1 param → 200
PATCH
/api/end_users/{end_user_id_or_heron_id}/end_user_information
Patch EndUser information
1 param body → 200
POST
/api/end_users/{end_user_id_or_heron_id}/enrich
Enrich transactions of EndUser
2 params → 200
GET
/api/end_users/{end_user_id_or_heron_id}/location
Get EndUser physical location
1 param → 200
GET
/api/end_users/{end_user_id_or_heron_id}/processing_status
Get EndUser processing status
1 param → 200404
GET
/api/end_users/{heron_id}/crm_sync
Retrieve CRM sync events for an end user
1 param → 200
POST
/api/end_users/{heron_id}/crm_sync
Trigger a CRM Sync for an End User
1 param → 200

Schemas 99

The contract defines 99 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.

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

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

heron-endusers-api-openapi.yml Raw ↑

Other APIs Heron publishes across the network.

Heron Analytics API
Heron App Store 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 Email Templates API
Heron End Users API
Heron End User Accounts 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.