{"components":{"schemas":{"AccountBalance":{"properties":{"closing_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"The closing balance for the day","example":25000.45},"currency":{"description":"Currency of the balance","example":"USD","type":"string"},"date":{"description":"Date of the balance","example":"2022-01-01","format":"date","type":"string"}},"required":["closing_amount"],"type":"object"},"AccountBalance1":{"properties":{"account_id":{"example":"checking_account_202348","maxLength":400,"type":"string"},"batch_closing_balance":{"description":"The closing balance for this account after the transactions in this batch","example":25000.45,"type":"number"}},"required":["account_id","batch_closing_balance"],"type":"object"},"AccountDataSourceReconciliationRange":{"properties":{"end_date":{"format":"date","type":"string"},"reconciliation_report_by_date":{"additionalProperties":{"items":{"$ref":"#/components/schemas/DataSourceAccountDateReconciliationMetrics"},"type":"array"},"nullable":true,"type":"object"},"reconciliation_status":{"enum":["no_data","single_source","reconciled","unreconciled"],"type":"string"},"start_date":{"format":"date","type":"string"}},"required":["end_date","reconciliation_report_by_date","reconciliation_status","start_date"],"type":"object"},"AccountDataSourcesReconciliation":{"properties":{"account_number":{"type":"string"},"has_unreconciled_enabled_overlap":{"type":"boolean"},"ranges":{"items":{"$ref":"#/components/schemas/AccountDataSourceReconciliationRange"},"type":"array"}},"required":["account_number","has_unreconciled_enabled_overlap","ranges"],"type":"object"},"AccountTransactionDataCoverage":{"properties":{"account_number":{"type":"string"},"data_source_type":{"type":"string"},"ranges":{"items":{"$ref":"#/components/schemas/AccountTransactionDataCoverageRange"},"type":"array"}},"required":["account_number","data_source_type","ranges"],"type":"object"},"AccountTransactionDataCoverageRange":{"properties":{"data_source_account":{"allOf":[{"$ref":"#/components/schemas/DataSourceAccount"}],"nullable":true},"end_date":{"format":"date","type":"string"},"has_coverage":{"type":"boolean"},"is_enabled":{"nullable":true,"type":"boolean"},"start_date":{"format":"date","type":"string"}},"required":["end_date","has_coverage","start_date"],"type":"object"},"ActivePolicySectionSchema":{"properties":{"display_order":{"description":"Where the section sits among the others, lowest first","nullable":true,"readOnly":true,"type":"integer"},"heron_id":{"description":"Heron ID of the section","readOnly":true,"type":"string"},"name":{"description":"Section name, as shown on a deal's policy results","readOnly":true,"type":"string"}},"type":"object"},"AddFunderIntegrationRequestSchema":{"properties":{"funder_heron_id":{"type":"string"}},"required":["funder_heron_id"],"type":"object"},"AddFunderToPoliciesSchema":{"additionalProperties":false,"properties":{"funder_heron_id":{"description":"Heron ID of the funder to add","type":"string"}},"required":["funder_heron_id"],"type":"object"},"Address":{"properties":{"city":{"nullable":true,"type":"string"},"line_1":{"nullable":true,"type":"string"},"line_2":{"nullable":true,"type":"string"},"state":{"nullable":true,"type":"string"},"zip":{"nullable":true,"type":"string"}},"type":"object"},"AddressFields":{"properties":{"city":{"description":"City or town.","nullable":true,"type":"string"},"country":{"description":"Country.","nullable":true,"type":"string"},"is_po_box":{"description":"Whether the address is a PO box.","type":"boolean"},"line_1":{"description":"Street and building number.","nullable":true,"type":"string"},"line_2":{"description":"Apartment, unit or suite.","nullable":true,"type":"string"},"postcode":{"description":"ZIP or postal code.","nullable":true,"type":"string"},"raw":{"description":"The full address in one line.","type":"string"},"region":{"description":"State, province or county.","nullable":true,"type":"string"}},"type":"object"},"AddressLocation":{"properties":{"lat":{"type":"number"},"lng":{"type":"number"}},"type":"object"},"AddressWrite":{"additionalProperties":false,"properties":{"city":{"description":"City or town.","nullable":true,"type":"string"},"country":{"description":"Country.","nullable":true,"type":"string"},"heron_id":{"description":"The `heron_id` of the address or phone from `GET`. Leave it out to add a new one.","nullable":true,"type":"string"},"line_1":{"description":"Street and building number.","nullable":true,"type":"string"},"line_2":{"description":"Apartment, unit or suite.","nullable":true,"type":"string"},"postal_code":{"description":"ZIP or postal code.","nullable":true,"type":"string"},"state_province":{"description":"State, province or county.","nullable":true,"type":"string"}},"type":"object"},"AffiliateSubject":{"properties":{"age":{"description":"Age reported for the person; null when unavailable.","nullable":true,"type":"integer"},"application":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckApplication"}],"description":"Identity searched, taken from the application data."},"candidates":{"description":"Every deduplicated candidate returned across the subject's searches, with its match score.","items":{"$ref":"#/components/schemas/BackgroundCheckCandidate"},"type":"array"},"case_ref":{"description":"Reserved case reference; null in normal use.","nullable":true,"type":"string"},"current_firmographics":{"allOf":[{"$ref":"#/components/schemas/CurrentFirmographics"}],"description":"One current status, employee count and revenue picked from the business facts, each with its source and date. Null for person subjects and for background checks run before it was added.","nullable":true},"date_of_birth_masked":{"description":"Date of birth masked by the source; null when unavailable. The masked value is returned unchanged.","nullable":true,"type":"string"},"decision":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckDecision"}],"description":"Audit of how the winning candidate was selected; null when no scoring decision was needed.","nullable":true},"duns_numbers":{"description":"D&B DUNS numbers of the resolved business. Empty for person subjects.","items":{"type":"string"},"type":"array"},"fictitious_name_records":{"description":"DBA and fictitious-name filings for the business, including active and expired filings. Empty for person subjects or when none are reported.","items":{"$ref":"#/components/schemas/FictitiousNameRecordSchema"},"type":"array"},"firmographics":{"allOf":[{"$ref":"#/components/schemas/BusinessFirmographics"}],"description":"Business facts grouped by source; null for person subjects.","nullable":true},"gender":{"description":"Gender reported for the person; null when unavailable.","nullable":true,"type":"string"},"key":{"description":"Identifier for an affiliate report, such as affiliate_business_bcs_x7Kp2 - not one of the three fixed subject keys.","type":"string"},"kind":{"description":"Subject type: person or business.","enum":["person","business"],"type":"string"},"name":{"description":"Label for the subject: the matched record's filed name for a business, the searched name for a person. Null when neither is known.","nullable":true,"type":"string"},"ofac_support_status":{"description":"Support state for an OFAC finding; null when no OFAC finding is present.","enum":["supported","clear_only",null],"nullable":true,"type":"string"},"related_party_officers":{"description":"Business-filing officers who match a related party on the deal.","items":{"type":"string"},"type":"array"},"resolution":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckResolution"}],"description":"How and whether the subject was matched."},"role":{"description":"Subject's role on the deal; null when unavailable.","nullable":true,"type":"string"},"searches":{"description":"Search waterfall in attempted order, including each step's inputs and outcome.","items":{"$ref":"#/components/schemas/SearchAttempt"},"type":"array"},"sections":{"description":"Report findings grouped by record type.","items":{"$ref":"#/components/schemas/BackgroundCheckSection"},"type":"array"},"ssn_in_itin_range":{"description":"Whether any reported SSN starts with 9. Null when the report has no SSN.","nullable":true,"type":"boolean"},"ssn_itin_source":{"description":"Where the ITIN-range SSN appears: subject or other_ssn. Null when none appears.","enum":["subject","other_ssn",null],"nullable":true,"type":"string"},"ssn_itin_support_status":{"description":"Support state for an ITIN finding; null when no ITIN finding is present.","enum":["supported","conflicting","clear_only",null],"nullable":true,"type":"string"},"unreported_officers":{"description":"Officers on active business filings who are not listed as owners on the application. Empty for person subjects.","items":{"type":"string"},"type":"array"}},"required":["application","candidates","firmographics","key","kind","resolution","searches","sections","unreported_officers"],"type":"object"},"AlterationCoverage":{"properties":{"failed_checks":{"description":"Names of the checks that did not complete, when a reason is `check_failed`","items":{"type":"string"},"type":"array"},"reasons":{"description":"Why the file is partially checked or not checked, most important first","items":{"enum":["scanned_no_text_layer","scanned_ocr_text_layer","check_failed","pages_unchecked","producer_not_checked","file_type_not_supported","check_did_not_finish","not_a_bank_statement"]},"type":"array"},"status":{"description":"Customer-facing status of how far the alteration check covered the file. This is not the verdict's `coverage` (full, partial or none): `partially_checked` applies only to a green result, and an amber or red result is always `checked`.","enum":["checked","partially_checked","not_checked"]}},"required":["failed_checks","reasons","status"],"type":"object"},"AlterationFeedbackRequestSchema":{"properties":{"comment":{"description":"The analyst's note on the result","maxLength":2000,"nullable":true,"type":"string"},"finding_ids":{"description":"IDs of the result's findings the analyst marked wrong","items":{"maxLength":512,"minLength":1,"type":"string"},"maxItems":200,"type":"array"},"rating":{"description":"Whether the analyst thinks the alteration result is right or wrong","enum":["right","wrong"]},"session_uuid":{"description":"PostHog session UUID","maxLength":36,"minLength":1,"nullable":true,"type":"string"}},"required":["rating"],"type":"object"},"AlterationFeedbackResponseSchema":{"properties":{"interaction_log_heron_id":{"description":"Heron ID of the stored feedback","type":"string"}},"required":["interaction_log_heron_id"],"type":"object"},"AlterationFlagSchema":{"properties":{"alteration_coverage":{"$ref":"#/components/schemas/AlterationCoverage"},"bank_name":{"nullable":true,"type":"string"},"end_user_file_heron_id":{"type":"string"},"end_user_heron_id":{"type":"string"},"end_user_name":{"nullable":true,"type":"string"},"filename":{"nullable":true,"type":"string"},"flagged_at":{"format":"date-time","type":"string"},"label":{"type":"string"},"risk":{"enum":["red","amber"],"type":"string"},"statement_periods":{"items":{"$ref":"#/components/schemas/AlterationFlagStatementPeriod"},"type":"array"},"uploaded_at":{"format":"date-time","type":"string"},"why":{"type":"string"}},"required":["alteration_coverage","bank_name","end_user_file_heron_id","end_user_heron_id","end_user_name","filename","flagged_at","label","risk","statement_periods","uploaded_at","why"],"type":"object"},"AlterationFlagStatementPeriod":{"properties":{"end":{"nullable":true,"type":"string"},"start":{"nullable":true,"type":"string"}},"required":["end","start"],"type":"object"},"Analysis":{"properties":{"active":{"nullable":true,"type":"string"},"dpv_cmra":{"nullable":true,"type":"string"},"dpv_footnotes":{"nullable":true,"type":"string"},"dpv_match_code":{"nullable":true,"type":"string"},"dpv_no_stat":{"nullable":true,"type":"string"},"dpv_vacant":{"nullable":true,"type":"string"},"footnotes":{"nullable":true,"type":"string"}},"type":"object"},"Annotation":{"properties":{"annotator":{"allOf":[{"$ref":"#/components/schemas/AnnotatorPublic"}],"readOnly":true},"category":{"allOf":[{"$ref":"#/components/schemas/Category1"}],"readOnly":true},"confidence":{"nullable":true,"readOnly":true,"type":"number"},"model_version":{"nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"AnnotationSettings":{"properties":{"annotators":{"items":{"$ref":"#/components/schemas/AnnotatorSettings"},"maxItems":10,"type":"array"},"heron_ai_chunk_size":{"type":"integer"},"llm_counterparty_extraction_and_clustering_enabled":{"type":"boolean"},"llm_counterparty_extraction_chunk_size":{"type":"integer"},"reconcile":{"type":"boolean"},"reconcile_version":{"type":"string"},"slug":{"enum":["us_sme_lend_2","ca_sme_lend_2","gb_sme_lend_2","gb_sme_lender","us_sme_lender","us_consumer","smartbiz_loans","24","30","171","capchase"]},"split_intra_co_transfers_to_inflows_outflows":{"type":"boolean"},"split_p2p_to_inflows_outflows":{"type":"boolean"}},"type":"object"},"AnnotatorPublic":{"properties":{"context":{"enum":["sync","async_","manual","undetermined"],"type":"string"},"priority_type":{"enum":["gold_standard","feedback","manual_review","reconcile","heuristics","predicted","other","positions_detection"],"type":"string"}},"required":["context","priority_type"],"type":"object"},"AnnotatorSettings":{"properties":{"async_":{"type":"boolean"},"confidence_threshold":{"maximum":1.0,"minimum":0.0,"type":"number"},"label":{"pattern":"^(heuristics|rich_heuristics|distilbert|distilbert_intra_co_override_async_|random_forest|heron_ai_.+)$","type":"string"},"sync":{"type":"boolean"}},"type":"object"},"AnomalyParams":{"properties":{"category_label_or_heron_id":{"description":"Label or Heron ID of category to find anomalies for","example":"Revenue","type":"string"}},"required":["category_label_or_heron_id"],"type":"object"},"AnomalySchema":{"properties":{"amount":{"description":"Converted amount of transaction in currency","example":42.42,"type":"number"},"anomaly_score":{"description":"Anomaly score 0-1, where 1 is very anomalous, and 0 is not anomalous","example":0.5,"type":"number"},"currency":{"description":"Currency code for amount that transaction was converted to","example":"USD","type":"string"},"heron_id":{"description":"Heron ID of the Transaction","example":"txn_9oPspuxisSVyboAqnR2L4Q","type":"string"},"reference_id":{"description":"Customer-provided reference ID for the Transaction","example":"1342db06-feb7-4c33-a157-4351d74a98e9","nullable":true,"type":"string"}},"type":"object"},"AnyMarshmallowSchema":{"additionalProperties":true,"properties":{},"type":"object"},"ApiKeyCreatedSchema":{"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"is_active":{"readOnly":true,"type":"boolean"},"name":{"readOnly":true,"type":"string"},"token":{"description":"Full token - shown only once","readOnly":true,"type":"string"},"token_prefix":{"readOnly":true,"type":"string"}},"required":["is_active","name","token","token_prefix"],"type":"object"},"ApiKeyStatusSchema":{"properties":{"heron_id":{"readOnly":true,"type":"string"},"is_active":{"readOnly":true,"type":"boolean"}},"required":["is_active"],"type":"object"},"ApiKeyWithLastUsedSchema":{"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"is_active":{"readOnly":true,"type":"boolean"},"last_used":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"name":{"readOnly":true,"type":"string"},"token_prefix":{"readOnly":true,"type":"string"}},"required":["is_active","last_used","name","token_prefix"],"type":"object"},"AppStoreSchema":{"properties":{"applications":{"items":{"$ref":"#/components/schemas/Application"},"type":"array"}},"type":"object"},"Application":{"properties":{"cta":{"$ref":"#/components/schemas/CTAResponse"},"description":{"description":"A brief description of the application.","example":"This is an example application.","type":"string"},"file_classes":{"example":[{"description":"description1","name":"file_class1"},{"description":"description2","name":"file_class2"}],"items":{"$ref":"#/components/schemas/FileClass"},"type":"array"},"heron_id":{"example":"asa_66j3BaZeWzY7mCp6Bn5sA8","type":"string"},"image":{"description":"URL to the application's logo","example":"https://example.com/image.png","format":"url","type":"string"},"integrations":{"example":["integration1","integration2"],"items":{"type":"string"},"type":"array"},"is_enabled":{"example":true,"type":"boolean"},"name":{"description":"The name of the application.","example":"Example App","type":"string"},"priority":{"example":1,"type":"integer"},"tags":{"example":["tag1","tag2"],"items":{"type":"string"},"type":"array"},"type":{"description":"The type of the application.","enum":["enricher","integration","ingestion","parser","check","analytics","workflow"],"example":"enricher","type":"string"},"use_cases":{"example":["use_case1","use_case2"],"items":{"type":"string"},"type":"array"}},"required":["description","heron_id","is_enabled","name","priority","type"],"type":"object"},"AssociateRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"age":{"description":"Reported age of the associate.","nullable":true,"type":"integer"},"association_description":{"description":"Source description of the association, such as Shared Address.","nullable":true,"type":"string"},"city_state":{"description":"Reported city and state.","nullable":true,"type":"string"},"date_of_birth":{"description":"Date of birth; null when unavailable.","format":"date","nullable":true,"type":"string"},"death_date":{"description":"Reported date of death; null when unavailable.","format":"date","nullable":true,"type":"string"},"entity_id":{"description":"Source entity identifier; null when unavailable.","nullable":true,"type":"string"},"first_reported_date":{"description":"First reported date; null when unavailable.","format":"date","nullable":true,"type":"string"},"is_deceased":{"description":"True when the associate is reported deceased.","type":"boolean"},"is_high_risk":{"description":"True when the associate is marked high risk.","type":"boolean"},"last_reported_date":{"description":"Last reported date; null when unavailable.","format":"date","nullable":true,"type":"string"},"name":{"description":"Name of the associate.","nullable":true,"type":"string"},"relationship":{"description":"Source-provided relationship to the subject.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"shares_address":{"description":"True when the associate shares an address with the subject.","type":"boolean"},"shares_phone":{"description":"True when the associate shares a phone number with the subject.","type":"boolean"},"strength_of_association":{"description":"Source strength score for the association; null when unavailable.","nullable":true,"type":"integer"}},"type":"object"},"AsyncScorecardQueryParams":{"properties":{"date":{"description":"Cut-off date to consider transactions to for calculating scorecard (inclusive)","example":"2023-01-19","format":"date","type":"string"}},"required":["date"],"type":"object"},"AttributeEvidence":{"properties":{"record_indices":{"items":{"type":"integer"},"nullable":true,"type":"array"},"section":{"nullable":true,"type":"string"},"source_id":{"nullable":true,"type":"string"},"source_ids":{"items":{"type":"string"},"nullable":true,"type":"array"},"source_type":{"type":"string"}},"type":"object"},"AttributePeriod":{"properties":{"end":{"description":"Last day read, inclusive","format":"date","readOnly":true,"type":"string"},"start":{"description":"First day read, inclusive","format":"date","readOnly":true,"type":"string"}},"type":"object"},"AvailableAfter":{"properties":{"label":{"description":"Customer-facing name of the step","type":"string"},"producers":{"description":"The data this step writes that the variable needs","items":{"$ref":"#/components/schemas/Producer"},"type":"array"}},"required":["label","producers"],"type":"object"},"AvailableEnvironments":{"properties":{"default_environment":{"description":"Default environment for the user (username)","example":"heron_data","type":"string"},"organizations":{"description":"List of organizations available to the user","example":[{"environments":[{"alias":"Development","environment":"dev","username":"dev"},{"alias":"Staging","environment":"staging","username":"staging"}],"name":"My Organization","slug":"my-organization"}],"items":{"allOf":[{"$ref":"#/components/schemas/AvailableEnvironmentsOrganization"}],"description":"List of organizations available to the user"},"type":"array"}},"type":"object"},"AvailableEnvironmentsEnvironment":{"properties":{"alias":{"description":"Alias for the environment","example":"Development","nullable":true,"type":"string"},"environment":{"description":"Environment name","example":"dev","type":"string"},"username":{"description":"Name of the environment","example":"dev","type":"string"}},"type":"object"},"AvailableEnvironmentsOrganization":{"properties":{"environments":{"description":"List of environments available to the user","example":["dev","staging","prod"],"items":{"allOf":[{"$ref":"#/components/schemas/AvailableEnvironmentsEnvironment"}],"description":"List of environments available to the user"},"type":"array"},"name":{"description":"Name of the organization","example":"My Organization","type":"string"},"slug":{"description":"Slug of the organization","example":"my-organization","type":"string"}},"type":"object"},"BackgroundCheckAffiliateConfirmSchema":{"properties":{"entity_id":{"description":"The chosen candidate's entity identifier from the report's search trail.","type":"string"},"ref":{"description":"The affiliate report request reference, as returned when it was requested.","type":"string"}},"required":["entity_id","ref"],"type":"object"},"BackgroundCheckAffiliateReport":{"properties":{"kind":{"description":"Whether the report is for an affiliated business or person.","enum":["person","business"],"type":"string"},"name":{"description":"Name of the affiliate the report was requested for.","type":"string"},"ref":{"description":"Stable reference for this affiliate report request; echo it when confirming a candidate or removing the request.","type":"string"},"status":{"description":"Report lifecycle: pending until the next screening run pulls it, succeeded when the report is ready, not_found when no confident match was found (a candidate can be confirmed), or failed.","enum":["pending","succeeded","not_found","failed"],"type":"string"},"subject":{"allOf":[{"$ref":"#/components/schemas/AffiliateSubject"}],"description":"The affiliate's search trail and report findings, shaped like a subject; null when it failed.","nullable":true}},"required":["kind","name","ref","status"],"type":"object"},"BackgroundCheckAffiliateReportRequestSchema":{"properties":{"affiliates":{"description":"The affiliations to request CLEAR reports for, at most 25 per request.","items":{"$ref":"#/components/schemas/BackgroundCheckAffiliateSelection"},"maxItems":25,"minItems":1,"type":"array"}},"required":["affiliates"],"type":"object"},"BackgroundCheckAffiliateRequestAcceptedSchema":{"properties":{"requests":{"description":"One entry per selection: the report request accepted for processing, or the in-flight request it was deduplicated against.","items":{"$ref":"#/components/schemas/BackgroundCheckAffiliationReportState"},"type":"array"}},"required":["requests"],"type":"object"},"BackgroundCheckAffiliateSearchInputs":{"properties":{"city":{"description":"City of the address to search on.","nullable":true,"type":"string"},"date_of_birth":{"description":"The person's date of birth; ignored for a business.","format":"date","nullable":true,"type":"string"},"phone":{"description":"Phone number on file; ignored for a person.","nullable":true,"type":"string"},"state":{"description":"State of the address to search on.","nullable":true,"type":"string"},"street":{"description":"Street of the address to search on.","nullable":true,"type":"string"},"zip_code":{"description":"ZIP code of the address to search on.","nullable":true,"type":"string"}},"type":"object"},"BackgroundCheckAffiliateSelection":{"properties":{"index":{"description":"Position of the affiliation in that owner's list, as returned by the affiliations endpoint.","minimum":0,"type":"integer"},"kind":{"description":"Whether the selection is an affiliated business or person.","enum":["person","business"],"type":"string"},"name":{"description":"Name shown for the affiliation; the request is rejected if the list has changed.","type":"string"},"search_inputs":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckAffiliateSearchInputs"}],"description":"Details to search a corporate officer on, whose filing carries only a name. Optional, and ignored for selections whose source already holds search details.","nullable":true},"source":{"description":"The list the selection's index refers to, as returned on the row. Optional for compatibility: when omitted, a business subject_key means the officer-company list and an owner subject_key means work affiliations. Required to request a corporate filing.","enum":["work_affiliation","corporate_officer","corporate_filing",null],"nullable":true,"type":"string"},"subject_key":{"description":"The report whose list the selection refers to: an owner's affiliations, or the people and companies named as officers on the business's own filings.","enum":["owner_1","owner_2","business"],"type":"string"}},"required":["index","kind","name","subject_key"],"type":"object"},"BackgroundCheckAffiliationPersonRow":{"properties":{"city_state":{"description":"Reported city and state.","nullable":true,"type":"string"},"date_of_birth":{"description":"Date of birth; null when unavailable.","format":"date","nullable":true,"type":"string"},"has_entity_id":{"description":"Whether CLEAR identified this associate. When true a report pulls directly; when false a search runs first and may require confirming a candidate.","type":"boolean"},"index":{"description":"Position in that report's list.","type":"integer"},"name":{"description":"Name of the associate.","nullable":true,"type":"string"},"relationship":{"description":"Source-provided relationship to the owner.","nullable":true,"type":"string"},"report":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckAffiliationReportState"}],"description":"State of the most recent report requested for this associate; null when never requested.","nullable":true},"subject_key":{"description":"The report that names this person: owner_1 or owner_2 for an owner's associate, or business for an unreported corporate officer.","enum":["owner_1","owner_2","business"],"type":"string"}},"required":["has_entity_id","index","subject_key"],"type":"object"},"BackgroundCheckAffiliationReportState":{"properties":{"kind":{"description":"Whether the report is for an affiliated business or person.","enum":["person","business"],"type":"string"},"ref":{"description":"Stable reference for this affiliate report request; echo it when confirming a candidate or removing the request.","type":"string"},"status":{"description":"Report lifecycle: pending until the next screening run pulls it, succeeded when the report is ready, not_found when no confident match was found (a candidate can be confirmed), or failed.","enum":["pending","succeeded","not_found","failed"],"type":"string"}},"required":["kind","ref","status"],"type":"object"},"BackgroundCheckAffiliationRow":{"properties":{"address":{"description":"Address of the business; null when unavailable.","nullable":true,"type":"string"},"address_state":{"description":"State of the business address; null when unavailable.","nullable":true,"type":"string"},"business_name":{"description":"Business the owner is affiliated with.","nullable":true,"type":"string"},"index":{"description":"Position in that report's list; echo it when requesting a report.","type":"integer"},"legal_business_name":{"description":"Legal name of the business as filed; null when unavailable.","nullable":true,"type":"string"},"merged_from":{"description":"Every filing behind this affiliation, each as the source reported it, including the one whose values the affiliation shows, so more than one entry means values were combined. Empty for an affiliation with no filing behind it, such as a corporate officer named on the business's own report.","items":{"$ref":"#/components/schemas/MergedFiling"},"type":"array"},"organization_type":{"description":"Source-provided organisation type, such as CORPORATION; null when unavailable.","nullable":true,"type":"string"},"report":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckAffiliationReportState"}],"description":"State of the most recent report requested for this affiliation; null when never requested.","nullable":true},"role":{"description":"Role at the business, such as CEO, DIRECTOR, or Registered Agent.","nullable":true,"type":"string"},"roles":{"description":"All roles the owner holds at the business, such as Officer or Registered Agent.","items":{"type":"string"},"type":"array"},"since_date":{"description":"Date the affiliation began; null when unavailable.","format":"date","nullable":true,"type":"string"},"source":{"description":"Which list produced this row: an owner's work affiliation, a company named as an officer on the business report's filings, or a business filed under an owner (corporate filings). Echo it with the index when requesting a report.","enum":["work_affiliation","corporate_officer","corporate_filing"],"type":"string"},"status":{"description":"Source-provided status of the affiliation.","nullable":true,"type":"string"},"subject_key":{"description":"The report that names this business: owner_1 or owner_2 for an owner's affiliation, or business for a company named as an officer on the business's own filings.","enum":["owner_1","owner_2","business"],"type":"string"},"year_established":{"description":"Year the business was established as recorded on the source; null when unavailable.","nullable":true,"type":"string"}},"required":["index","source","subject_key"],"type":"object"},"BackgroundCheckAffiliationsBlock":{"properties":{"business":{"description":"Reports requested for affiliated businesses, in request order.","items":{"$ref":"#/components/schemas/BackgroundCheckAffiliateReport"},"type":"array"},"person":{"description":"Reports requested for affiliated people, in request order.","items":{"$ref":"#/components/schemas/BackgroundCheckAffiliateReport"},"type":"array"}},"required":["business","person"],"type":"object"},"BackgroundCheckAffiliationsViewSchema":{"properties":{"businesses":{"description":"Businesses the owners are affiliated with, from their background check reports.","items":{"$ref":"#/components/schemas/BackgroundCheckAffiliationRow"},"type":"array"},"persons":{"description":"People associated with the owners, from their background check reports.","items":{"$ref":"#/components/schemas/BackgroundCheckAffiliationPersonRow"},"type":"array"},"status":{"description":"Run lifecycle of the underlying background check. Lists reflect the most recent succeeded run; while a newer run is processing or failed they keep the last completed data and pending report requests show as pending.","enum":["never_run","processing","succeeded","failed","missing_input_data"],"type":"string"}},"required":["businesses","persons","status"],"type":"object"},"BackgroundCheckApplication":{"description":"The application identity used for the search. All fields are nullable; SSNs remain masked.","properties":{"address":{"description":"Application address used to search this subject; null when unavailable.","nullable":true,"type":"string"},"business_name":{"description":"Application business name; null for person subjects.","nullable":true,"type":"string"},"date_of_birth":{"description":"Date of birth; null when unavailable.","format":"date","nullable":true,"type":"string"},"ein":{"description":"Employer Identification Number used for the search; null when unavailable.","nullable":true,"type":"string"},"email":{"description":"Email address; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Application person name; null for business subjects.","nullable":true,"type":"string"},"owner":{"description":"Named owner used when searching a business subject; null for person subjects.","nullable":true,"type":"string"},"phone":{"description":"Phone number; null when unavailable.","nullable":true,"type":"string"},"ssn":{"description":"Masked SSN. Only the first five digits are ever held or returned; the full SSN never appears.","nullable":true,"type":"string"},"state":{"description":"Application state; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"BackgroundCheckCandidate":{"description":"One deduplicated candidate across the subject's search attempts, including its match score.","properties":{"address":{"description":"Candidate address returned by the search.","nullable":true,"type":"string"},"aka_names":{"description":"Also-known-as names on the candidate.","items":{"type":"string"},"type":"array"},"basis":{"description":"Search basis that returned the candidate, such as the matching name variant.","nullable":true,"type":"string"},"duns_numbers":{"description":"D&B DUNS numbers from the business candidate; empty for person candidates.","items":{"type":"string"},"type":"array"},"entity_id":{"description":"Source entity identifier; null when unavailable.","nullable":true,"type":"string"},"group_id":{"description":"Source record-group identifier; null when unavailable.","nullable":true,"type":"string"},"id":{"description":"Stable candidate reference: source entity ID, or group ID as fallback.","type":"string"},"is_limited":{"description":"Whether the candidate is a limited-data record; null when unknown.","nullable":true,"type":"boolean"},"matched_address":{"description":"Non-primary address that matched the search; null when the primary address matched.","nullable":true,"type":"string"},"matched_aka_name":{"description":"Also-known-as name that matched the search; null when the primary name matched.","nullable":true,"type":"string"},"name":{"description":"Candidate name returned by the search.","nullable":true,"type":"string"},"rank":{"description":"Candidate's position in the search results.","nullable":true,"type":"integer"},"relevance":{"description":"Source relevance score for the search hit.","nullable":true,"type":"integer"},"score":{"allOf":[{"$ref":"#/components/schemas/CandidateScore"}],"description":"Match score audit; null when the candidate was not scored.","nullable":true}},"required":["id"],"type":"object"},"BackgroundCheckCandidateOverrideSchema":{"properties":{"business":{"description":"Selected candidate ID for the business; null when not overridden.","nullable":true,"type":"string"},"owner_1":{"description":"Selected candidate ID for owner_1; null when not overridden.","nullable":true,"type":"string"},"owner_2":{"description":"Selected candidate ID for owner_2; null when not overridden.","nullable":true,"type":"string"}},"type":"object"},"BackgroundCheckCheck":{"properties":{"area":{"description":"Display group for the policy check.","type":"string"},"area_sub":{"description":"Display subgroup for the policy check; null when the check has none.","nullable":true,"type":"string"},"auto_reason":{"description":"Explanation for the automated policy outcome; null when unavailable.","nullable":true,"type":"string"},"auto_status":{"description":"Automated outcome: pass, review_required, failed, or missing_data.","enum":["pass","failed","review_required","missing_data"]},"check_text":{"description":"Human-readable description of what the policy check evaluates.","type":"string"},"evidence_subjects":{"description":"Per-subject pointers to the findings that produced the policy outcome.","items":{"$ref":"#/components/schemas/BackgroundCheckEvidence"},"type":"array"},"id":{"description":"Stable check ID in <subject_tier>:<signal> form.","type":"string"},"override":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckOverride"}],"description":"Manual reviewer override; null when the automated outcome stands.","nullable":true},"rule":{"description":"Configured threshold or rule expression; null when the check has none.","nullable":true,"type":"string"},"signal":{"description":"Underlying attribute evaluated by the policy check.","type":"string"}},"required":["area","auto_status","check_text","evidence_subjects","id","signal"],"type":"object"},"BackgroundCheckCheckCounts":{"properties":{"fail":{"description":"Number of failed policy checks.","type":"integer"},"pass":{"description":"Number of passed policy checks.","type":"integer"},"review":{"description":"Number of policy checks requiring review.","type":"integer"}},"required":["fail","pass","review"],"type":"object"},"BackgroundCheckDecision":{"properties":{"anchored_by":{"description":"Anchor identifier that resolved the match outright: ein or corp_number_echo; null when unanchored.","nullable":true,"type":"string"},"near_tie":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckNearTie"}],"description":"Top-two score comparison; null when the candidates were not close.","nullable":true},"pooled_count":{"description":"Number of candidates pooled and scored.","nullable":true,"type":"integer"},"tie_break":{"description":"How the winner separated from the runner-up; null when there was no winner/runner-up.","enum":["score","key_order","flag_probe",null],"nullable":true,"type":"string"}},"type":"object"},"BackgroundCheckEvidence":{"properties":{"excluded_record_indices":{"description":"Indices excluded from the value because their amount is missing.","items":{"type":"integer"},"type":"array"},"filtered":{"description":"True when record_indices is a matched subset. An empty filtered list means no records matched.","type":"boolean"},"record_indices":{"description":"Indices into the cited section's records array.","items":{"type":"integer"},"type":"array"},"section":{"description":"Section key containing the cited evidence; null when no section applies.","nullable":true,"type":"string"},"subject_key":{"description":"Evidence subject: owner_1, owner_2, business, any_owner, or submission.","enum":["owner_1","owner_2","business","any_owner","submission",null],"nullable":true,"type":"string"}},"required":["excluded_record_indices","filtered","record_indices"],"type":"object"},"BackgroundCheckMatchedEntity":{"properties":{"corporation_number":{"description":"Matched business corporation number returned by the source; falls back to the corporation number sent in the search when the source record has none. Null when unavailable.","nullable":true,"type":"string"},"entity_id":{"description":"Source identifier for the matched entity; null when unavailable.","nullable":true,"type":"string"},"filing_state":{"description":"Matched business filing state returned by the source; falls back to the filing state sent in the search when the source record has none. Null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Matched entity name returned by the search.","nullable":true,"type":"string"}},"type":"object"},"BackgroundCheckNearTie":{"properties":{"flag_counts":{"additionalProperties":{"type":"integer"},"description":"Adverse-flag counts per probed candidate, keyed by candidate id; null when not probed.","nullable":true,"type":"object"},"gap":{"description":"Difference between the top two candidate scores.","type":"number"},"probed":{"description":"True when both near-tied candidate reports were retrieved and compared.","type":"boolean"}},"required":["gap","probed"],"type":"object"},"BackgroundCheckOverall":{"properties":{"check_counts":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckCheckCounts"}],"description":"Policy check totals."},"result":{"description":"Headline result: passed, review_required, failed, or missing_data.","enum":["passed","failed","review_required","missing_data","execution_error","skipped"]},"severity":{"description":"Highest severity found: none, low, medium, or high.","enum":["none","low","medium","high"],"type":"string"}},"required":["check_counts","result","severity"],"type":"object"},"BackgroundCheckOverride":{"properties":{"at":{"description":"When the reviewer applied the override.","format":"date-time","type":"string"},"by":{"description":"Reviewer who applied the override.","type":"string"},"status":{"description":"Reviewer-selected outcome replacing the automated result.","enum":["pass","failed","review_required","missing_data"]}},"required":["at","by","status"],"type":"object"},"BackgroundCheckPolicy":{"properties":{"checks":{"description":"One entry per configured policy check.","items":{"$ref":"#/components/schemas/BackgroundCheckCheck"},"type":"array"},"result":{"description":"Worst configured policy outcome: passed, review_required, failed, or missing_data.","enum":["passed","failed","review_required","missing_data","execution_error","skipped"]}},"required":["checks","result"],"type":"object"},"BackgroundCheckRawReportSchema":{"properties":{"file_b64":{"description":"Base64-encoded document bytes","type":"string"},"filename":{"description":"Suggested download filename","type":"string"},"mime_type":{"description":"MIME type of the document","type":"string"}},"required":["file_b64","filename","mime_type"],"type":"object"},"BackgroundCheckRecordDetail":{"description":"Supplementary source detail returned with include_section_detail=true. The summarised record is the stable typed interface.","properties":{"additional_fields":{"description":"Every source value not mapped to a named field, as label and value pairs.","items":{"$ref":"#/components/schemas/DetailLabelValue"},"type":"array"},"arrests":{"description":"Arrest entries as source-provided key and value pairs.","items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},"attorneys":{"description":"Counsel the source does not tie to a specific party.","items":{"$ref":"#/components/schemas/DetailAttorney"},"type":"array"},"bail":{"description":"Bail entries on the case.","items":{"$ref":"#/components/schemas/DetailBail"},"type":"array"},"case":{"allOf":[{"$ref":"#/components/schemas/DetailCase"}],"description":"Case metadata; null when not a case record.","nullable":true},"charges":{"description":"Charges on the case.","items":{"$ref":"#/components/schemas/DetailCharge"},"type":"array"},"collateral":{"description":"Collateral descriptions on the filing.","items":{"type":"string"},"type":"array"},"creditors":{"description":"Creditors named on the filing.","items":{"type":"string"},"type":"array"},"debtors":{"description":"Debtors named on the filing.","items":{"$ref":"#/components/schemas/DetailLienDebtor"},"type":"array"},"defendant":{"allOf":[{"$ref":"#/components/schemas/DetailDefendant"}],"description":"Defendant details; null when not applicable.","nullable":true},"docket_entries":{"description":"Docket entries on the case.","items":{"$ref":"#/components/schemas/DetailDocketEntry"},"type":"array"},"entries":{"description":"For merged cases: one entry per raw source record, carrying this same shape.","items":{"$ref":"#/components/schemas/BackgroundCheckRecordDetail"},"type":"array"},"filing":{"allOf":[{"$ref":"#/components/schemas/DetailFiling"}],"description":"Filing metadata; null when not a filing record.","nullable":true},"filing_relationship":{"description":"Source-provided filing relationship; null when unavailable.","nullable":true,"type":"string"},"meeting_341":{"allOf":[{"$ref":"#/components/schemas/DetailMeeting341"}],"description":"341 creditors' meeting; null when not applicable.","nullable":true},"parties":{"description":"Parties named on the case.","items":{"$ref":"#/components/schemas/DetailParty"},"type":"array"},"record_shape":{"description":"Names the source shape this detail carries.","nullable":true,"type":"string"},"related":{"description":"Related records as label and value pairs.","items":{"$ref":"#/components/schemas/DetailLabelValue"},"type":"array"},"secured_parties":{"description":"Secured parties named on the filing.","items":{"$ref":"#/components/schemas/DetailLienDebtor"},"type":"array"},"source":{"allOf":[{"$ref":"#/components/schemas/DetailSource"}],"description":"Provenance of the source record; null when unavailable.","nullable":true},"source_entry_id":{"description":"Source-provided source entry reference; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"BackgroundCheckRecordDetailSchema":{"description":"Supplementary source detail returned with include_section_detail=true. The summarised record is the stable typed interface.","properties":{"additional_fields":{"description":"Every source value not mapped to a named field, as label and value pairs.","items":{"$ref":"#/components/schemas/DetailLabelValueSchema"},"type":"array"},"arrests":{"description":"Arrest entries as source-provided key and value pairs.","items":{"additionalProperties":{"type":"string"},"type":"object"},"type":"array"},"attorneys":{"description":"Counsel the source does not tie to a specific party.","items":{"$ref":"#/components/schemas/DetailAttorneySchema"},"type":"array"},"bail":{"description":"Bail entries on the case.","items":{"$ref":"#/components/schemas/DetailBailSchema"},"type":"array"},"case":{"allOf":[{"$ref":"#/components/schemas/DetailCaseSchema"}],"description":"Case metadata; null when not a case record.","nullable":true},"charges":{"description":"Charges on the case.","items":{"$ref":"#/components/schemas/DetailChargeSchema"},"type":"array"},"collateral":{"description":"Collateral descriptions on the filing.","items":{"type":"string"},"type":"array"},"creditors":{"description":"Creditors named on the filing.","items":{"type":"string"},"type":"array"},"debtors":{"description":"Debtors named on the filing.","items":{"$ref":"#/components/schemas/DetailLienDebtorSchema"},"type":"array"},"defendant":{"allOf":[{"$ref":"#/components/schemas/DetailDefendantSchema"}],"description":"Defendant details; null when not applicable.","nullable":true},"docket_entries":{"description":"Docket entries on the case.","items":{"$ref":"#/components/schemas/DetailDocketEntrySchema"},"type":"array"},"entries":{"description":"For merged cases: one entry per raw source record, carrying this same shape.","items":{"$ref":"#/components/schemas/BackgroundCheckRecordDetailSchema"},"type":"array"},"filing":{"allOf":[{"$ref":"#/components/schemas/DetailFilingSchema"}],"description":"Filing metadata; null when not a filing record.","nullable":true},"filing_relationship":{"description":"Source-provided filing relationship; null when unavailable.","nullable":true,"type":"string"},"meeting_341":{"allOf":[{"$ref":"#/components/schemas/DetailMeeting341Schema"}],"description":"341 creditors' meeting; null when not applicable.","nullable":true},"parties":{"description":"Parties named on the case.","items":{"$ref":"#/components/schemas/DetailPartySchema"},"type":"array"},"record_shape":{"description":"Names the source shape this detail carries.","nullable":true,"type":"string"},"related":{"description":"Related records as label and value pairs.","items":{"$ref":"#/components/schemas/DetailLabelValueSchema"},"type":"array"},"secured_parties":{"description":"Secured parties named on the filing.","items":{"$ref":"#/components/schemas/DetailLienDebtorSchema"},"type":"array"},"source":{"allOf":[{"$ref":"#/components/schemas/DetailSourceSchema"}],"description":"Provenance of the source record; null when unavailable.","nullable":true},"source_entry_id":{"description":"Source-provided source entry reference; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"BackgroundCheckResolution":{"properties":{"aka_names":{"description":"Also-known-as names on the resolved entity.","items":{"type":"string"},"type":"array"},"entity_not_found":{"description":"True when no matching entity was found.","type":"boolean"},"error_code":{"description":"The data provider's error code for a search or report error: its status code, or http_<status> or timeout when it sent none. Null unless CLEAR failed.","nullable":true,"type":"string"},"error_type":{"description":"Why the search or report pull errored: upstream_failure (the data provider failed or refused the request; a later run can succeed) or input_error (the provider rejected the identifiers sent). Null unless CLEAR failed. A search that ran and found nobody has status not_found instead.","enum":["upstream_failure","input_error",null],"nullable":true,"type":"string"},"is_limited":{"default":false,"description":"True when the matched record is a limited CLEAR record. Its report leaves out some sections, so some fields are not available.","type":"boolean"},"label":{"description":"Display label for a matched entity whose report is unavailable; null for other outcomes.","nullable":true,"type":"string"},"match_threshold":{"description":"The deciding evidence-score floor; null on older records.","nullable":true,"type":"number"},"matched_entity":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckMatchedEntity"}],"description":"Search facts for the match whose report is unavailable; null for other outcomes.","nullable":true},"method":{"description":"Resolving search step: ssn_only, name_state_dob, name_address, name_state, corp_id, ein, manual_recovery (a reviewer manually selected the match), or linked_entity_id (no search ran - the report naming this affiliation already identified them).","nullable":true,"type":"string"},"reason":{"description":"Reason the matched report is unavailable; null when the report did not fail.","nullable":true,"type":"string"},"report_error_message":{"description":"Source error message for a failed report retrieval; null when unavailable.","nullable":true,"type":"string"},"report_retry_attempted":{"description":"True when a failed report retrieval was retried.","type":"boolean"},"report_unavailable":{"description":"True when a match resolved but the report pull failed (distinct from a search-time error).","type":"boolean"},"score_version":{"description":"Version of the match-scoring model; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Resolution status: found, not_found, or error.","enum":["found","not_found","error"],"type":"string"},"winner_ref":{"description":"Ref into the subject's candidates[] for the resolved match; null when unresolved.","nullable":true,"type":"string"}},"required":["entity_not_found","error_code","label","matched_entity","reason","report_error_message","report_retry_attempted","report_unavailable","status"],"type":"object"},"BackgroundCheckResponseSchema":{"description":"Dates use YYYY-MM-DD. Amounts are decimal strings. Nullable source fields return null. SSNs remain masked; full SSNs never appear.","properties":{"affiliations":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckAffiliationsBlock"}],"description":"Reports requested for the subjects' affiliated businesses and people; null when none requested.","nullable":true},"end_user_id":{"description":"Heron ID of the end user","type":"string"},"overall":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckOverall"}],"description":"Headline outcome across all background checks; null until an outcome is available.","nullable":true},"policy":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckPolicy"}],"description":"Outcome of each configured background-check policy check; null until available.","nullable":true},"processing_stage":{"description":"While processing: searching, pulling_reports, or analysing. Null otherwise.","enum":["searching","pulling_reports","analysing",null],"nullable":true,"type":"string"},"status":{"description":"Run lifecycle: never_run, processing, succeeded, failed, or missing_input_data.","enum":["never_run","processing","succeeded","failed","missing_input_data"],"type":"string"},"subjects":{"description":"One entry per searched subject: owner_1, owner_2 when present, and business.","items":{"$ref":"#/components/schemas/BackgroundCheckSubject"},"type":"array"},"trial":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckTrial"}],"description":"Trial run allowance, or null when background check runs are unlimited.","nullable":true}},"required":["end_user_id","status","subjects"],"type":"object"},"BackgroundCheckSection":{"description":"A subject's findings for one record type. Record fields differ by section key.","properties":{"addresses":{"description":"Known addresses. Populated only on the `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/ProfileAddress"},"type":"array"},"akas":{"description":"Also-known-as names. Populated only on the `profile` section; empty elsewhere.","items":{"type":"string"},"type":"array"},"business_contacts":{"description":"Business contacts shown on the `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/BusinessContact"},"type":"array"},"business_flags":{"description":"Business risk signals and their supporting report records.","items":{"$ref":"#/components/schemas/BusinessFlagRecord"},"type":"array"},"business_profile_details":{"description":"Customer-safe business identity and profile details shown on the `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/BusinessProfileRecordSchema"},"type":"array"},"businesses_at_business_address_records":{"description":"Other businesses sharing the applicant business's address or phone. Populated only on a business `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/BusinessAtBusinessAddressRecord"},"type":"array"},"corporate_records":{"description":"Business corporate filings shown on the `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/CorporateRecordSchema"},"type":"array"},"count":{"description":"Number of records in the section.","type":"integer"},"death_records":{"description":"Death records. Populated only on a person's `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/DeathRecord"},"type":"array"},"dun_bradstreet_records":{"description":"Dun & Bradstreet records from a person's own report: one entry per business D&B links to the person. Populated only on a person's `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/BusinessFirmographics"},"type":"array"},"emails":{"description":"Known email addresses. Populated only on the `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/ProfileEmail"},"type":"array"},"entry_count":{"description":"Number of underlying source entries before roll-up; null for sections without combined records.","nullable":true,"type":"integer"},"flag":{"description":"Policy flag for this section: ok or fail; null when no policy check cites it.","enum":["ok","fail",null],"nullable":true,"type":"string"},"identity_fraud_flags":{"description":"Identity-fraud signals. Populated only on a person's `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/IdentityFraudFlag"},"type":"array"},"key":{"description":"Section identifier: profile, criminal, bankruptcy, liens, lawsuits, marriage, affiliations, ofac, corporate, ucc, property, or industry.","enum":["profile","criminal","bankruptcy","liens","ucc","property","lawsuits","marriage","affiliations","corporate","ofac","industry"],"type":"string"},"label":{"description":"Display label for the section.","type":"string"},"marital_status":{"description":"The subject's marital status from CLEAR, strongest evidence first: the latest marriage or divorce filing (`married`, `divorced`, or `divorce_pending` when the divorce is filed with no decree on record); otherwise `single` when every vehicle record the subject owns says single and there are no `spouse_names`; otherwise `possibly_married` when vehicle records say married or disagree, or `spouse_names` exist; otherwise `unknown`. Null on checks run before this field existed and on every section except a person's `marriage` section.","enum":["married","divorced","divorce_pending","single","possibly_married","unknown",null],"nullable":true,"type":"string"},"not_available":{"description":"True when the matched record is a limited CLEAR record whose report leaves out a source this section reads, and the section is empty: unknown, not no records.","type":"boolean"},"other_ssn_records":{"description":"Other SSNs linked to the person. Populated only on a person's `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/OtherSsnRecord"},"type":"array"},"people_at_business_address_records":{"description":"People linked to the applicant business's address or phone on the business report. Populated only on the business `profile` section; names and shared values never include SSNs or birth dates.","items":{"$ref":"#/components/schemas/PeopleAtBusinessAddressRecord"},"type":"array"},"phones":{"description":"Populated only on the `profile` section; empty elsewhere.","items":{"$ref":"#/components/schemas/ProfilePhone"},"type":"array"},"potential_spouse_matches":{"description":"Associates and relatives whose first name matches one of `spouse_names`, listed for every match. A spouse name with no entry here matched no one. Populated only on a person's `marriage` section; empty elsewhere.","items":{"$ref":"#/components/schemas/PotentialSpouseMatch"},"type":"array"},"records":{"description":"Section rows. Fields differ by section key; the profile section contains professional licences.","items":{"anyOf":[{"$ref":"#/components/schemas/ProfessionalLicenseRecordSchema"},{"$ref":"#/components/schemas/CriminalSectionRecordSchema"},{"$ref":"#/components/schemas/BankruptcyRecordSchema"},{"$ref":"#/components/schemas/LienJudgmentRecordSchema"},{"$ref":"#/components/schemas/LawsuitRecordSchema"},{"$ref":"#/components/schemas/MarriageRecordSchema"},{"$ref":"#/components/schemas/AssociateRecordSchema"},{"$ref":"#/components/schemas/OfacRecordSchema"},{"$ref":"#/components/schemas/CorporateRecordSchema"},{"$ref":"#/components/schemas/UCCRecordSchema"},{"$ref":"#/components/schemas/PropertyRecordSchema"},{"$ref":"#/components/schemas/BusinessProfileRecordSchema"}]},"type":"array"},"relatives":{"description":"Relatives reported for the subject. Populated only on the `affiliations` section; empty elsewhere.","items":{"$ref":"#/components/schemas/RelativeRecord"},"type":"array"},"severity":{"description":"Highest record severity in the section: none, low, medium, or high.","enum":["none","low","medium","high"],"type":"string"},"spouse_names":{"description":"Spouse names reported on the subject's profile in CLEAR's header data, usually first names only. They are undated and can include former spouses, so they do not establish current marital status. These are not marriage or divorce filings and can be present when `records` is empty. Populated only on a person's `marriage` section; empty elsewhere.","items":{"type":"string"},"type":"array"},"spouse_names_source":{"description":"CLEAR's underlying header data source for `spouse_names`, such as Experian. Null when there are no spouse names or the source is not reported.","nullable":true,"type":"string"},"ssn_issuance":{"allOf":[{"$ref":"#/components/schemas/ProfileSsnIssuance"}],"description":"SSN issuance details. Populated only on the `profile` section; null elsewhere.","nullable":true},"work_affiliations":{"description":"Populated only on the `affiliations` section; empty elsewhere.","items":{"$ref":"#/components/schemas/WorkAffiliation"},"type":"array"}},"required":["count","key","label","records","severity"],"type":"object"},"BackgroundCheckSubject":{"properties":{"age":{"description":"Age reported for the person; null when unavailable.","nullable":true,"type":"integer"},"application":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckApplication"}],"description":"Identity searched, taken from the application data."},"candidates":{"description":"Every deduplicated candidate returned across the subject's searches, with its match score.","items":{"$ref":"#/components/schemas/BackgroundCheckCandidate"},"type":"array"},"case_ref":{"description":"Reserved case reference; null in normal use.","nullable":true,"type":"string"},"current_firmographics":{"allOf":[{"$ref":"#/components/schemas/CurrentFirmographics"}],"description":"One current status, employee count and revenue picked from the business facts, each with its source and date. Null for person subjects and for background checks run before it was added.","nullable":true},"date_of_birth_masked":{"description":"Date of birth masked by the source; null when unavailable. The masked value is returned unchanged.","nullable":true,"type":"string"},"decision":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckDecision"}],"description":"Audit of how the winning candidate was selected; null when no scoring decision was needed.","nullable":true},"duns_numbers":{"description":"D&B DUNS numbers of the resolved business. Empty for person subjects.","items":{"type":"string"},"type":"array"},"fictitious_name_records":{"description":"DBA and fictitious-name filings for the business, including active and expired filings. Empty for person subjects or when none are reported.","items":{"$ref":"#/components/schemas/FictitiousNameRecordSchema"},"type":"array"},"firmographics":{"allOf":[{"$ref":"#/components/schemas/BusinessFirmographics"}],"description":"Business facts grouped by source; null for person subjects.","nullable":true},"gender":{"description":"Gender reported for the person; null when unavailable.","nullable":true,"type":"string"},"key":{"description":"Subject identifier: owner_1, owner_2, or business.","enum":["owner_1","owner_2","business"],"type":"string"},"kind":{"description":"Subject type: person or business.","enum":["person","business"],"type":"string"},"name":{"description":"Label for the subject: the matched record's filed name for a business, the searched name for a person. Null when neither is known.","nullable":true,"type":"string"},"ofac_support_status":{"description":"Support state for an OFAC finding; null when no OFAC finding is present.","enum":["supported","clear_only",null],"nullable":true,"type":"string"},"related_party_officers":{"description":"Business-filing officers who match a related party on the deal.","items":{"type":"string"},"type":"array"},"resolution":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckResolution"}],"description":"How and whether the subject was matched."},"role":{"description":"Subject's role on the deal; null when unavailable.","nullable":true,"type":"string"},"searches":{"description":"Search waterfall in attempted order, including each step's inputs and outcome.","items":{"$ref":"#/components/schemas/SearchAttempt"},"type":"array"},"sections":{"description":"Report findings grouped by record type.","items":{"$ref":"#/components/schemas/BackgroundCheckSection"},"type":"array"},"ssn_in_itin_range":{"description":"Whether any reported SSN starts with 9. Null when the report has no SSN.","nullable":true,"type":"boolean"},"ssn_itin_source":{"description":"Where the ITIN-range SSN appears: subject or other_ssn. Null when none appears.","enum":["subject","other_ssn",null],"nullable":true,"type":"string"},"ssn_itin_support_status":{"description":"Support state for an ITIN finding; null when no ITIN finding is present.","enum":["supported","conflicting","clear_only",null],"nullable":true,"type":"string"},"unreported_officers":{"description":"Officers on active business filings who are not listed as owners on the application. Empty for person subjects.","items":{"type":"string"},"type":"array"}},"required":["application","candidates","firmographics","key","kind","resolution","searches","sections","unreported_officers"],"type":"object"},"BackgroundCheckTrial":{"properties":{"limit":{"description":"Maximum background check runs in the trial.","type":"integer"},"remaining":{"description":"Background check runs left in the trial.","type":"integer"},"used":{"description":"Background check runs consumed by the trial.","type":"integer"}},"required":["limit","remaining","used"],"type":"object"},"BacktestBaselineSection":{"properties":{"evaluated_at":{"nullable":true,"readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"name":{"readOnly":true,"type":"string"},"policy_version":{"nullable":true,"readOnly":true,"type":"integer"}},"type":"object"},"BacktestCheckChange":{"properties":{"check_identity":{"description":"What the check reads, which is how it is named","readOnly":true,"type":"string"},"check_name":{"nullable":true,"readOnly":true,"type":"string"},"deal_count":{"description":"Deals whose outcome changed with this check moving","readOnly":true,"type":"integer"},"section_name":{"readOnly":true,"type":"string"}},"required":["check_identity","check_name","section_name"],"type":"object"},"BacktestCheckDefinition":{"properties":{"auto_decline":{"readOnly":true,"type":"boolean"},"ignore_metric_availability":{"readOnly":true,"type":"boolean"},"is_mandatory":{"readOnly":true,"type":"boolean"},"on_failure":{"readOnly":true,"type":"string"},"type":{"nullable":true,"readOnly":true,"type":"string"},"value":{"nullable":true,"readOnly":true}},"type":"object"},"BacktestCheckFilter":{"properties":{"check_identity":{"minLength":1,"type":"string"},"result":{"enum":["passed","failed","review_required","missing_data","execution_error","skipped"]},"section_heron_id":{"type":"string"}},"required":["result","section_heron_id"],"type":"object"},"BacktestCheckSide":{"properties":{"availability":{"nullable":true,"readOnly":true,"type":"string"},"definition":{"allOf":[{"$ref":"#/components/schemas/BacktestCheckDefinition"}],"readOnly":true},"effective_result":{"readOnly":true,"type":"string"},"result":{"readOnly":true,"type":"string"},"source":{"enum":["reused","recomputed","live"],"readOnly":true},"threshold_value":{"description":"The compared variable's value. Absent for a check against a fixed number","readOnly":true,"type":"string"},"value":{"nullable":true,"readOnly":true,"type":"string"},"value_type":{"nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"BacktestCreateSchema":{"properties":{"baseline":{"default":"active","description":"Compare with the active policy or each deal's stored evaluations","enum":["active","as_evaluated"]},"check_filter":{"allOf":[{"$ref":"#/components/schemas/BacktestCheckFilter"}],"nullable":true},"description":{"description":"Free text describing what this run is testing","maxLength":2000,"nullable":true,"type":"string"},"end_user_heron_ids":{"description":"Specific deals to run, in request order; cannot be combined with selection filters","items":{"type":"string"},"maxItems":4000,"minItems":1,"nullable":true,"type":"array"},"limit":{"description":"Deals to include, at most 4000 (default 200)","maximum":4000,"minimum":1,"nullable":true,"type":"integer"},"source_filter":{"allOf":[{"$ref":"#/components/schemas/BacktestSourceFilter"}],"description":"Only deals from one ISO: a deal matches when any of the given values matches","nullable":true},"window_days":{"description":"How far back to look for deals; the account's configured window when omitted","minimum":1,"nullable":true,"type":"integer"},"window_end":{"description":"Exclusive deal creation bound; requires window_start and is clamped to now when in the future","format":"date-time","nullable":true,"type":"string"},"window_start":{"description":"Inclusive deal creation bound; requires window_end and cannot be combined with window_days","format":"date-time","nullable":true,"type":"string"},"with_policy_result":{"description":"Only deals whose last policy result was one of ['failed', 'missing_data', 'passed', 'review_required']; omit for all","items":{"enum":["passed","failed","review_required","missing_data","execution_error","skipped"]},"minItems":1,"nullable":true,"type":"array"}},"type":"object"},"BacktestCrmQueuePair":{"properties":{"baseline":{"allOf":[{"$ref":"#/components/schemas/CrmQueueStatus"}],"nullable":true,"readOnly":true},"candidate":{"allOf":[{"$ref":"#/components/schemas/CrmQueueStatus"}],"nullable":true,"readOnly":true},"deal_count":{"readOnly":true,"type":"integer"}},"type":"object"},"BacktestDealCountSchema":{"properties":{"matching_deal_count":{"readOnly":true,"type":"integer"},"selected_deal_count":{"readOnly":true,"type":"integer"}},"required":["matching_deal_count","selected_deal_count"],"type":"object"},"BacktestDealSchema":{"properties":{"baseline":{"items":{"$ref":"#/components/schemas/BacktestBaselineSection"},"nullable":true,"readOnly":true,"type":"array"},"baseline_crm_queue":{"allOf":[{"$ref":"#/components/schemas/CrmQueue"}],"description":"The CRM queue the original run set, separate from the policy result; null when none","nullable":true,"readOnly":true},"baseline_result":{"description":"The baseline version's verdict, null when it could not be evaluated","enum":["passed","failed","review_required","missing_data","execution_error","skipped","mandatory_check_missing_data",null],"nullable":true,"readOnly":true},"candidate_crm_queue":{"allOf":[{"$ref":"#/components/schemas/CrmQueue"}],"description":"The CRM queue the candidate's route sets; null when none. Its status_id is null when an expression sets it on a sync step the original run didn't reach","nullable":true,"readOnly":true},"candidate_result":{"description":"The candidate version's verdict, null when it could not be evaluated. On a cannot_compare deal it covers only the sections the candidate reached before the backtest stopped","enum":["passed","failed","review_required","missing_data","execution_error","skipped","mandatory_check_missing_data",null],"nullable":true,"readOnly":true},"check_flips":{"items":{"$ref":"#/components/schemas/CheckFlip"},"readOnly":true,"type":"array"},"crm_queue_result":{"description":"Whether the CRM queue changes; cannot_compare when the replay stopped or an expression sets the status, null when the deal wasn't replayed or its workflow has no CRM sync step","enum":["same_queue","queue_changed","cannot_compare",null],"nullable":true,"readOnly":true},"end_user_created":{"description":"When the deal arrived; the live evaluation clock for a deal the policy never ran on","format":"date-time","readOnly":true,"type":"string"},"end_user_heron_id":{"readOnly":true,"type":"string"},"end_user_name":{"nullable":true,"readOnly":true,"type":"string"},"evaluated_as_of":{"description":"The clock both sides were read under","format":"date-time","readOnly":true,"type":"string"},"evaluation_result":{"enum":["same_outcome","outcome_changed","cannot_compare","diverged"],"readOnly":true},"id":{"description":"Cursor for fetching rows recorded after this one","readOnly":true,"type":"integer"},"lendsaas_deal_ids":{"description":"LendSaaS deal IDs linked to the deal. Empty unless include_lendsaas_deal_ids is requested.","items":{"type":"string"},"readOnly":true,"type":"array"},"note":{"description":"Why the deal was classified this way, in English","readOnly":true,"type":"string"},"route":{"allOf":[{"$ref":"#/components/schemas/BacktestRoute"}],"description":"The candidate's route through the deal's workflow, null when it wasn't replayed","nullable":true,"readOnly":true},"sections":{"items":{"$ref":"#/components/schemas/BacktestSection"},"readOnly":true,"type":"array"},"source":{"allOf":[{"$ref":"#/components/schemas/BacktestDealSource"}],"description":"Where the deal came from, null when it has neither a source name nor a sender","nullable":true,"readOnly":true}},"required":["evaluated_as_of","evaluation_result","id","lendsaas_deal_ids","note"],"type":"object"},"BacktestDealSource":{"properties":{"name":{"description":"The ISO for an API deal; the sender's display name for an email deal","nullable":true,"readOnly":true,"type":"string"},"sender_address":{"description":"Who emailed the deal in","nullable":true,"readOnly":true,"type":"string"},"sender_domain":{"description":"The sender's domain, lowercased","nullable":true,"readOnly":true,"type":"string"},"source_type":{"description":"How the deal arrived, e.g. api or email","nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"BacktestListingSchema":{"properties":{"baseline_mode":{"enum":["active","as_evaluated"],"readOnly":true},"baseline_version":{"description":"Version number the run compared against","readOnly":true,"type":"integer"},"candidate_version":{"description":"Version number the run tested","readOnly":true,"type":"integer"},"created":{"format":"date-time","readOnly":true,"type":"string"},"deal_count":{"description":"Deals the run claimed at setup. A member limited to tagged deals gets the count of those deals","nullable":true,"readOnly":true,"type":"integer"},"deal_set_params":{"allOf":[{"$ref":"#/components/schemas/DealSetParams"}],"readOnly":true},"description":{"nullable":true,"readOnly":true,"type":"string"},"error":{"description":"Why the run failed, null unless it did","nullable":true,"readOnly":true,"type":"string"},"finished_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"result_counts":{"additionalProperties":{"type":"integer"},"description":"Deals per evaluation_result, every bucket present even at zero","readOnly":true,"type":"object"},"skipped_end_user_heron_ids":{"items":{"$ref":"#/components/schemas/SkippedDeal"},"readOnly":true,"type":"array"},"stale":{"description":"The version has been edited since this run was asked for","readOnly":true,"type":"boolean"},"started_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"status":{"enum":["pending","running","complete","failed"],"readOnly":true},"triggered_by":{"readOnly":true,"type":"string"}},"required":["baseline_mode","baseline_version","skipped_end_user_heron_ids","stale","status","triggered_by"],"type":"object"},"BacktestRoute":{"properties":{"diverged":{"description":"Whether a policy step takes a different branch under the candidate","readOnly":true,"type":"boolean"},"stopped_at":{"allOf":[{"$ref":"#/components/schemas/BacktestRouteStop"}],"description":"The step the replay couldn't follow past; set exactly when the deal is diverged","nullable":true,"readOnly":true}},"type":"object"},"BacktestRouteStop":{"properties":{"reason":{"description":"One of: never_ran, branch_unknown, inputs_changed, js_inputs_unavailable, js_error, unknown_node, node_failed_in_original_run, unwired_handle","readOnly":true,"type":"string"},"step_label":{"description":"The step's name on the policies page workflow, null for steps customers don't see","nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"BacktestSchema":{"properties":{"baseline_mode":{"enum":["active","as_evaluated"],"readOnly":true},"baseline_version":{"description":"Version number the run compared against","readOnly":true,"type":"integer"},"candidate_version":{"description":"Version number the run tested","readOnly":true,"type":"integer"},"created":{"format":"date-time","readOnly":true,"type":"string"},"deal_count":{"description":"Deals the run claimed at setup. A member limited to tagged deals gets the count of those deals","nullable":true,"readOnly":true,"type":"integer"},"deal_set_params":{"allOf":[{"$ref":"#/components/schemas/DealSetParams"}],"readOnly":true},"description":{"nullable":true,"readOnly":true,"type":"string"},"error":{"description":"Why the run failed, null unless it did","nullable":true,"readOnly":true,"type":"string"},"finished_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"skipped_end_user_heron_ids":{"items":{"$ref":"#/components/schemas/SkippedDeal"},"readOnly":true,"type":"array"},"stale":{"description":"The version has been edited since this run was asked for","readOnly":true,"type":"boolean"},"started_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"status":{"enum":["pending","running","complete","failed"],"readOnly":true},"summary":{"allOf":[{"$ref":"#/components/schemas/BacktestSummary"}],"readOnly":true},"triggered_by":{"readOnly":true,"type":"string"}},"required":["baseline_mode","skipped_end_user_heron_ids","stale","status","summary","triggered_by"],"type":"object"},"BacktestSection":{"properties":{"baseline_result":{"nullable":true,"readOnly":true,"type":"string"},"candidate_result":{"nullable":true,"readOnly":true,"type":"string"},"checks":{"items":{"$ref":"#/components/schemas/BacktestSectionCheck"},"readOnly":true,"type":"array"},"heron_id":{"readOnly":true,"type":"string"},"name":{"readOnly":true,"type":"string"}},"type":"object"},"BacktestSectionCheck":{"properties":{"baseline":{"allOf":[{"$ref":"#/components/schemas/BacktestCheckSide"}],"nullable":true,"readOnly":true},"candidate":{"allOf":[{"$ref":"#/components/schemas/BacktestCheckSide"}],"nullable":true,"readOnly":true},"change":{"description":"How the check's definition changed between the versions. Null on a deal that stopped partway (diverged or cannot_compare) when only one side reached the check's section.","enum":["unchanged","threshold_changed","added","dropped","flags_changed",null],"nullable":true,"readOnly":true},"check_identity":{"readOnly":true,"type":"string"},"check_name":{"nullable":true,"readOnly":true,"type":"string"},"flipped":{"readOnly":true,"type":"boolean"}},"type":"object"},"BacktestSelectionSchema":{"properties":{"check_filter":{"allOf":[{"$ref":"#/components/schemas/BacktestCheckFilter"}],"nullable":true},"end_user_heron_ids":{"description":"Specific deals to run, in request order; cannot be combined with selection filters","items":{"type":"string"},"maxItems":4000,"minItems":1,"nullable":true,"type":"array"},"limit":{"description":"Deals to include, at most 4000 (default 200)","maximum":4000,"minimum":1,"nullable":true,"type":"integer"},"source_filter":{"allOf":[{"$ref":"#/components/schemas/BacktestSourceFilter"}],"description":"Only deals from one ISO: a deal matches when any of the given values matches","nullable":true},"window_days":{"description":"How far back to look for deals; the account's configured window when omitted","minimum":1,"nullable":true,"type":"integer"},"window_end":{"description":"Exclusive deal creation bound; requires window_start and is clamped to now when in the future","format":"date-time","nullable":true,"type":"string"},"window_start":{"description":"Inclusive deal creation bound; requires window_end and cannot be combined with window_days","format":"date-time","nullable":true,"type":"string"},"with_policy_result":{"description":"Only deals whose last policy result was one of ['failed', 'missing_data', 'passed', 'review_required']; omit for all","items":{"enum":["passed","failed","review_required","missing_data","execution_error","skipped"]},"minItems":1,"nullable":true,"type":"array"}},"type":"object"},"BacktestSourceFilter":{"properties":{"names":{"description":"Source names sent through the API, matched case-insensitively","items":{"type":"string"},"type":"array"},"sender_addresses":{"description":"Addresses that sent the deal's first email, matched case-insensitively","items":{"format":"email","type":"string"},"type":"array"},"sender_domains":{"description":"Domains that sent the deal's first email, like broker.com","items":{"pattern":"^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$","type":"string"},"type":"array"}},"type":"object"},"BacktestSummary":{"properties":{"changed_checks":{"description":"Checks behind the deals whose outcome changed, most-affected first; empty until the run finishes","items":{"$ref":"#/components/schemas/BacktestCheckChange"},"readOnly":true,"type":"array"},"crm_queue_pairs":{"description":"Deals per (baseline, candidate) CRM queue pair, most first","items":{"$ref":"#/components/schemas/BacktestCrmQueuePair"},"readOnly":true,"type":"array"},"crm_queue_result_counts":{"additionalProperties":{"type":"integer"},"description":"Deals per crm_queue_result, every bucket present even at zero","readOnly":true,"type":"object"},"recorded_deal_count":{"description":"Deals recorded so far; against deal_count this is the progress","readOnly":true,"type":"integer"},"result_counts":{"additionalProperties":{"type":"integer"},"description":"Deals per evaluation_result, every bucket present even at zero","readOnly":true,"type":"object"}},"required":["recorded_deal_count"],"type":"object"},"BalanceSheetCategories":{"properties":{"current_assets":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"},"current_liabilities":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"},"equity":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"},"fixed_assets":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"},"non_current_liabilities":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"},"other_assets":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"}},"type":"object"},"BalanceSheetReport":{"properties":{"extracted_totals":{"allOf":[{"$ref":"#/components/schemas/BalanceSheetTotalsGroup"}],"nullable":true},"line_items":{"items":{"$ref":"#/components/schemas/BalanceSheetReportLineItem"},"nullable":true,"type":"array"},"summed_totals":{"allOf":[{"$ref":"#/components/schemas/BalanceSheetTotalsGroup"}],"nullable":true},"time_period":{"allOf":[{"$ref":"#/components/schemas/BalanceSheetTimePeriod"}],"nullable":true}},"type":"object"},"BalanceSheetReportLineItem":{"properties":{"amount":{"nullable":true,"type":"number"},"category":{"enum":["current_assets","fixed_assets","other_assets","current_liabilities","non_current_liabilities","equity",null],"nullable":true,"type":"string"},"id":{"nullable":true,"type":"string"},"label":{"nullable":true,"type":"string"},"row_id":{"nullable":true,"type":"string"},"row_index":{"nullable":true,"type":"integer"},"sub_category":{"nullable":true,"type":"string"}},"type":"object"},"BalanceSheetSchema":{"properties":{"currency":{"nullable":true,"type":"string"},"is_reconciled":{"nullable":true,"type":"boolean"},"reports":{"items":{"$ref":"#/components/schemas/BalanceSheetReport"},"nullable":true,"type":"array"}},"type":"object"},"BalanceSheetTimePeriod":{"properties":{"column_index":{"nullable":true,"type":"integer"},"date":{"format":"date","nullable":true,"type":"string"},"label":{"nullable":true,"type":"string"},"time_interval":{"enum":["year","quarter","month","interim_one_off",null],"nullable":true,"type":"string"}},"type":"object"},"BalanceSheetTotalsGroup":{"properties":{"current_ratio":{"nullable":true,"type":"number"},"debt_to_equity_ratio":{"nullable":true,"type":"number"},"is_reconciled":{"nullable":true,"type":"boolean"},"total_assets":{"nullable":true,"type":"number"},"total_current_assets":{"nullable":true,"type":"number"},"total_current_liabilities":{"nullable":true,"type":"number"},"total_equity":{"nullable":true,"type":"number"},"total_fixed_assets":{"nullable":true,"type":"number"},"total_liabilities":{"nullable":true,"type":"number"},"total_liabilities_and_equity":{"nullable":true,"type":"number"},"total_non_current_liabilities":{"nullable":true,"type":"number"},"total_other_assets":{"nullable":true,"type":"number"},"unreconciled_amount":{"nullable":true,"type":"number"}},"type":"object"},"BankStatementSummaryRow":{"properties":{"actual_holdback_percentage":{"description":"Actual MCA payments to revenue as % (raw repayment amounts)","nullable":true,"type":"number"},"additional_no_od":{"description":"Overdraft-item count a bank reports as a statement value for items absent from the transaction list. These items are already included in no_od and no_od_nsf. Null when the statement does not report a count.","nullable":true,"type":"integer"},"average_balance":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Average balance","nullable":true},"average_balance_to_revenue_ratio":{"description":"Average balance divided by total revenue","nullable":true,"type":"number"},"business_day_average_balance":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Average balance over weekdays excluding public holidays","nullable":true},"days_covered":{"description":"Number of distinct statement days covered in this calendar month","nullable":true,"type":"integer"},"days_in_month":{"description":"Total number of days in this calendar month","nullable":true,"type":"integer"},"dd_reversals":{"description":"Number of DD Reversals","type":"integer"},"ending_balance":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Ending balance","nullable":true},"expected_mca_debits":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Expected MCA debits amount"},"holdback_percentage":{"description":"Expected MCA payments to revenue as % (with frequency multiplier)","nullable":true,"type":"number"},"is_mtd":{"description":"True when month-to-date (MTD) file data feeds this row. A file counts as MTD when its file class is month_to_date, or when it has no file class and the parser read the statement as a month-to-date export (such as an online banking web report). For users without the month_to_date class, a bank_statement the parser read as month-to-date also counts. Monthly rows set it only on the month the MTD file ends in, not on every month it covers. by_data_source_account_heron_id and by_data_source_account_by_monthly_intervals set it on every row of an account whose MTD file ends in or after the month of the latest transaction across all accounts in the summary. It does not mean the month is recent, or that it is incomplete (on by_month rows, use is_partial). When true, holdback_percentage and actual_holdback_percentage are null. Always false for rolling 30-day groupings and for total and average","type":"boolean"},"is_partial":{"description":"True when days_in_month minus days_covered is more than the account's partial-month leniency (0 days unless Heron sets one), whether or not MTD files feed the month. Null outside by-month rows or when coverage is unknown","nullable":true,"type":"boolean"},"is_unreconcilable":{"description":"True when every file feeding this row has no balance data to reconcile against (statement_reconciliation_status not_possible), whatever the file class. False when any file feeding the row has another status or is a bank connection. When true, ending_balance, average_balance, business_day_average_balance, negative_balance_days and low_balance_days are null. Always false for total and average. When unreconciled files are loaded (load_unreconciled_transactions), summary leaves them out, so read this flag in all_transactions_summary","type":"boolean"},"is_unreconciled":{"description":"True when any file feeding this row failed reconciliation (statement_reconciliation_status failed), whatever the file class, so a month mixing a reconciled statement with a failed MTD is true. Balances still show. Always false for total and average. When unreconciled files are loaded (load_unreconciled_transactions), summary leaves them out, so read this flag in all_transactions_summary","type":"boolean"},"low_balance_days":{"description":"Number of days where end of day balance falls below low balance threshold","nullable":true,"type":"integer"},"mca_credits":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"MCA credits amount"},"mca_debits":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"MCA debits amount"},"negative_balance_days":{"description":"Number of days with negative balance","nullable":true,"type":"integer"},"no_deposits":{"description":"Number of deposit transactions","type":"integer"},"no_mca_credits":{"description":"Number of MCA credit transactions","type":"integer"},"no_mca_debits":{"description":"Number of MCA debit transactions","type":"integer"},"no_nsf":{"description":"Number of NSF transactions (unambiguous NSF-only category labels).","type":"integer"},"no_od":{"description":"Number of overdraft fees: transactions with unambiguous OD-only category labels, plus additional_no_od.","type":"integer"},"no_od_nsf":{"description":"Total overdraft/NSF fees: overdraft fees + NSF fees + ambiguous fees.","type":"integer"},"no_overdraft_transactions":{"description":"Number of transactions where the resulting balance falls below 0","type":"integer"},"no_revenue":{"description":"Number of revenue transactions","type":"integer"},"no_withdrawals":{"description":"Number of withdrawals transactions","type":"integer"},"non_revenue":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Non-revenue amount"},"period_end_date":{"description":"End of the MTD statement period behind this row: the latest end date of the MTD files that set is_mtd (e.g. an MTD statement covering Apr 1\u201315 gives Apr 15). Null when is_mtd is false. In by_data_source_account_by_monthly_intervals it is the last day of the row's interval instead, on every row","format":"date","nullable":true,"type":"string"},"period_start_date":{"description":"Start of the MTD statement period behind this row: the earliest start date of the MTD files that set is_mtd. It can fall in an earlier month than the row. Null when is_mtd is false. In by_data_source_account_by_monthly_intervals it is the first day of the row's interval instead, on every row","format":"date","nullable":true,"type":"string"},"starting_balance":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Starting balance for the period","nullable":true},"total_deposits":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Total deposit amount"},"total_revenue":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Total revenue amount"},"total_withdrawals":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Total withdrawal amount"}},"type":"object"},"BankStatementSummarySettings":{"properties":{"monthly_summary_averages_and_totals_exclude_partial_months":{"type":"boolean"},"monthly_summary_averages_and_totals_partial_month_leniency_days":{"minimum":0,"type":"integer"}},"type":"object"},"BankruptcyRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"chapter":{"description":"Bankruptcy chapter number; null when unavailable.","nullable":true,"type":"integer"},"chapter_kind":{"description":"Bankruptcy chapter classification: chapter_7, chapter_11, chapter_12, chapter_13, other, or unknown.","enum":["chapter_7","chapter_11","chapter_12","chapter_13","other","unknown"]},"debtor_is_different_company":{"description":"True when the filing names a business debtor and none matches this business by EIN or name. False when any debtor is unknown or is a person with no EIN. The filing is still shown and counted.","type":"boolean"},"debtor_name":{"description":"Debtor named on the filing.","nullable":true,"type":"string"},"detail":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckRecordDetail"}],"description":"Only populated when include_section_detail=true is passed on the request","nullable":true},"discharge_date":{"description":"Case discharge date, or final decree date when no discharge date is recorded; null otherwise.","format":"date","nullable":true,"type":"string"},"discharge_date_source":{"description":"Source of discharge_date: discharge or final_decree; null when the case is not discharged.","enum":["discharge","final_decree",null],"nullable":true},"dismissal_date":{"description":"Case dismissal date; null when the case is not dismissed or the date is unavailable.","format":"date","nullable":true,"type":"string"},"document_id":{"description":"Source document reference; null when unavailable.","nullable":true,"type":"string"},"filed_date":{"description":"Case filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"is_open":{"description":"True when status_kind is neither discharged nor dismissed.","type":"boolean"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"status":{"description":"Bankruptcy status value matching status_kind.","nullable":true,"type":"string"},"status_kind":{"description":"Bankruptcy status classification: filed, discharged, dismissed, or unknown. Discharged and dismissed are closed; filed and unknown are open.","enum":["filed","discharged","dismissed","unknown"]},"total_assets":{"description":"Total scheduled assets as a decimal string; null when the filing does not record them.","format":"decimal","nullable":true,"type":"string"},"total_liabilities":{"description":"Total scheduled liabilities as a decimal string; null when the filing does not record them.","format":"decimal","nullable":true,"type":"string"}},"type":"object"},"BooleanCheck":{"properties":{"auto_decline":{"default":false,"type":"boolean"},"decline_code":{"description":"The CRM's identifier for this decline reason, e.g. a LendSaas reason id. Left unset, the CRM sync falls back to this check's decline_description.","nullable":true,"type":"string"},"decline_description":{"nullable":true,"type":"string"},"email_template_name":{"nullable":true,"type":"string"},"ignore_metric_availability":{"default":false,"type":"boolean"},"is_mandatory":{"default":false,"type":"boolean"},"on_failure":{"default":"fail","enum":["fail","review_required"]},"on_missing":{"default":"missing_data","description":"What the check reports when it would report missing data: `missing_data` (the default), `fail` or `pass`. A check saved with an older flag (`pass_if_value_missing` on a date-delta check) reads as the setting it stands for. With `ignore_metric_availability` or `pass_if_value_missing` set, only that setting is accepted","enum":["missing_data","fail","pass"]},"pass_description":{"nullable":true,"type":"string"},"transaction_scope":{"allOf":[{"$ref":"#/components/schemas/TransactionScope"}],"nullable":true},"value":{"type":"boolean"}},"type":"object"},"BrokerDealDecisionCounts":{"properties":{"approved":{"readOnly":true,"type":"integer"},"declined":{"readOnly":true,"type":"integer"},"pending":{"readOnly":true,"type":"integer"}},"type":"object"},"BrokerDealOutcomeRequest":{"properties":{"funded_offer_heron_id":{"nullable":true,"type":"string"},"funded_offer_terms":{"allOf":[{"$ref":"#/components/schemas/BrokerFundedOfferTerms"}],"nullable":true},"outcome":{"enum":["funded","closed"]},"reason":{"nullable":true,"type":"string"}},"required":["outcome"],"type":"object"},"BrokerDealOutcomeResponse":{"properties":{"deal_stage":{"enum":["ready","missing_docs","shopped","offers_in","funded","closed"]},"funded_offer_heron_id":{"nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"BrokerEndUserSummary":{"properties":{"broker_link_status":{"description":"Review and deal-link state for this broker end user.","enum":["unlinked","linked","dismissed","reclassified",null],"nullable":true,"readOnly":true},"classification":{"description":"How broker intake classified this end user's email thread.","enum":["submission","decision","other"],"readOnly":true},"confidence":{"description":"Aggregated confidence for the end user across all transactions; between 0 and 1","example":0.42,"nullable":true,"readOnly":true,"type":"number"},"created":{"description":"When the end user was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"criteria":{"description":"List of scorecard metrics","items":{"$ref":"#/components/schemas/Metric"},"nullable":true,"readOnly":true,"type":"array"},"crm_sync_result":{"allOf":[{"$ref":"#/components/schemas/CrmSyncEvent"}],"nullable":true},"data_sources":{"description":"List of data source summaries for the end user","items":{"$ref":"#/components/schemas/DataSource"},"readOnly":true,"type":"array"},"deal_stage":{"description":"Where this deal sits in the broker pipeline.","enum":["ready","missing_docs","shopped","offers_in","funded","closed"],"readOnly":true},"decision_counts":{"allOf":[{"$ref":"#/components/schemas/BrokerDealDecisionCounts"}],"nullable":true,"readOnly":true},"duplicate_count":{"description":"Number of duplicate submission records hidden behind this deal.","readOnly":true,"type":"integer"},"end_user_id":{"description":"id defined by user; links to the end_user_id for transactions","example":"7cb48787-6d91-5b9f-bc60-f30298ea5736","maxLength":140,"minLength":1,"type":"string"},"files":{"items":{"$ref":"#/components/schemas/EndUserEndUserFile"},"type":"array"},"funded_offer_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"heron_id":{"description":"Unique id for end user generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","readOnly":true,"type":"string"},"in_human_review":{"description":"Whether an active document is pending human review","readOnly":true,"type":"boolean"},"is_portfolio":{"description":"Whether the end user is part of a lending portfolio","example":true,"type":"boolean"},"last_processed_at":{"description":"When the end user was last successfully processed in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"readOnly":true,"type":"string"},"last_updated":{"description":"When the end user was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"latest_activity_at":{"description":"Latest creation, funder submission, or current decision timestamp.","format":"date-time","nullable":true,"readOnly":true,"type":"string"},"linked_deal_end_user_heron_id":{"description":"Heron ID of the deal linked to this broker end user.","nullable":true,"readOnly":true,"type":"string"},"linked_deal_name":{"description":"Display name of the deal linked to this broker end user.","nullable":true,"readOnly":true,"type":"string"},"name":{"description":"Name of end user; may help to improve categorisation accuracy","example":"Company Name Inc.","maxLength":128,"nullable":true,"type":"string"},"outcome":{"enum":["funded","closed",null],"nullable":true,"readOnly":true},"outcome_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"policy_evaluation_results":{"description":"One entry per use_case, carrying the latest evaluation's policy identity and result","items":{"$ref":"#/components/schemas/PolicyEvaluationResult"},"type":"array"},"policy_evaluations":{"items":{"enum":["passed","failed","review_required","missing_data","execution_error","skipped"]},"type":"array"},"profit_and_loss_layout":{"nullable":true},"reason":{"nullable":true,"readOnly":true,"type":"string"},"status":{"description":"Status of end user; 'ready' triggers async processing, 'review_requested' triggers manual review request","enum":["new","ready","processed","reviewed","review_requested","failed"],"example":"ready","type":"string"},"submitting_brokers":{"description":"Brokers who submitted this deal \u2014 the discriminator between same-named merchants.","items":{"$ref":"#/components/schemas/SubmittingBroker"},"readOnly":true,"type":"array"},"tags":{"description":"Tags currently applied to this end user, read-only. Absent unless the endpoint returns them.","items":{"$ref":"#/components/schemas/TagSchema"},"readOnly":true,"type":"array"}},"required":["end_user_id"],"type":"object"},"BrokerEndUserSummaryParams":{"properties":{"broker_classification":{"description":"Filter by broker intake classification.","enum":["submission","decision","other",null],"nullable":true},"broker_link_status":{"description":"Filter by broker decision review state.","enum":["unlinked","linked","dismissed","reclassified",null],"nullable":true},"criteria":{"additionalProperties":{},"description":"Information about the end user that can be used as rules for underwriting","example":{"history_days":{"value":40}},"nullable":true,"readOnly":true,"type":"object"},"deal_stage":{"description":"Filter by broker deal stage.","enum":["ready","missing_docs","shopped","offers_in","funded","closed",null],"nullable":true},"end_user_id":{"description":"Filter by ID associated with end_user_id field in transactions","example":"your_end_user_id","nullable":true,"type":"string"},"funder_heron_id":{"description":"Filter by the funder on the end user's submission lane.","nullable":true,"type":"string"},"heron_id":{"description":"Unique ID generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"},"holds_decision":{"description":"Filter to end users holding a live funder verdict on their own submission lane.","nullable":true,"type":"boolean"},"in_human_review":{"description":"Filter by whether an active document is pending human review","nullable":true,"type":"boolean"},"include_decision_counts":{"default":false,"description":"Include funder lane decision counts for submission rows.","example":true,"type":"boolean"},"include_tags":{"default":false,"description":"Whether to include the tags applied to each end user","example":true,"type":"boolean"},"include_updates_in_interval":{"default":false,"description":"When true, interval_start and interval_end match end users created or last updated within the window. Bounds are inclusive only when this flag is true.","type":"boolean"},"interval_end":{"format":"date-time","nullable":true,"type":"string"},"interval_start":{"format":"date-time","nullable":true,"type":"string"},"is_portfolio":{"description":"Whether the end user is part of a lending portfolio","example":true,"nullable":true,"type":"boolean"},"limit":{"description":"Pagination limit per page (optional). If provided, 'page' must also be provided.","maximum":10000,"minimum":1,"nullable":true,"type":"integer"},"name":{"description":"Filter by name associated with end user","example":"your_end_user_name","nullable":true,"type":"string"},"order_by":{"default":"last_updated_desc","description":"Order to return broker end users by","enum":["last_updated_desc","last_updated_asc","created_desc","created_asc","latest_activity_desc"],"type":"string"},"page":{"description":"Pagination page number (optional). If provided, 'limit' must also be provided.","minimum":1,"nullable":true,"type":"integer"},"status":{"description":"Filter by status of end user","enum":["new","ready","processed","reviewed","review_requested","failed",null],"example":"reviewed","nullable":true,"type":"string"},"tags":{"description":"Filter by tag Heron IDs. End users holding any active requested tag are returned. Unknown and soft-deleted tag IDs do not match any end users.","items":{"type":"string"},"nullable":true,"type":"array"},"with_crm_sync_result":{"enum":["success","failure","no_sync_attempted",null],"nullable":true},"with_policy_result":{"description":"Only end users whose policy result was this.","enum":["passed","failed","review_required","missing_data","execution_error",null],"nullable":true}},"type":"object"},"BrokerFundedOfferTerms":{"properties":{"buy_rate":{"anyOf":[{"nullable":true,"type":"number"},{"format":"decimal","nullable":true,"type":"string"}]},"commission_percent":{"anyOf":[{"nullable":true,"type":"number"},{"format":"decimal","nullable":true,"type":"string"}]},"factor_rate":{"anyOf":[{"nullable":true,"type":"number"},{"format":"decimal","nullable":true,"type":"string"}]},"funded_amount":{"anyOf":[{"type":"number"},{"format":"decimal","type":"string"}]},"payment_amount":{"anyOf":[{"nullable":true,"type":"number"},{"format":"decimal","nullable":true,"type":"string"}]},"payment_frequency":{"enum":["daily","weekly","biweekly","monthly",null],"nullable":true,"type":"string"},"term_length":{"anyOf":[{"nullable":true,"type":"number"},{"format":"decimal","nullable":true,"type":"string"}]},"term_unit":{"enum":["days","weeks","months",null],"nullable":true,"type":"string"}},"required":["funded_amount"],"type":"object"},"BrokerFunderLink":{"additionalProperties":false,"properties":{"broker_user_id":{"readOnly":true,"type":"integer"},"classification_instructions_override":{"nullable":true,"readOnly":true,"type":"string"},"created":{"format":"date-time","readOnly":true,"type":"string"},"external_reference_id":{"nullable":true,"readOnly":true,"type":"integer"},"extraction_instructions_override":{"nullable":true,"readOnly":true,"type":"string"},"funder_heron_id":{"readOnly":true,"type":"string"},"last_updated":{"format":"date-time","readOnly":true,"type":"string"},"offer_calculation_constants_override":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"},"offer_email_instructions_override":{"nullable":true,"readOnly":true,"type":"string"},"offer_portal_instructions_override":{"nullable":true,"readOnly":true,"type":"string"},"offer_source_override":{"enum":["email","api","web_portal","all_offers","crm_lendsaas",null],"nullable":true,"readOnly":true},"staging_submission_integration_id":{"nullable":true,"readOnly":true,"type":"integer"},"submission_cc_email_addresses":{"items":{"type":"string"},"nullable":true,"readOnly":true,"type":"array"},"submission_channel_override":{"enum":["email","api","web_portal","all_offers","crm_lendsaas",null],"nullable":true,"readOnly":true},"submission_email_address":{"nullable":true,"readOnly":true,"type":"string"},"submission_email_subject_prefix":{"nullable":true,"readOnly":true,"type":"string"},"submission_integration_id":{"nullable":true,"readOnly":true,"type":"integer"}},"type":"object"},"BrokerFunderLinkDeleteSchema":{"additionalProperties":false,"properties":{"funder_heron_ids":{"items":{"type":"string"},"minItems":1,"type":"array"}},"required":["funder_heron_ids"],"type":"object"},"BrokerFunderPolicy":{"additionalProperties":false,"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"funder":{"allOf":[{"$ref":"#/components/schemas/BrokerFunderPolicyFunder"}],"readOnly":true},"last_updated":{"format":"date-time","readOnly":true,"type":"string"},"matching_priority":{"nullable":true,"readOnly":true,"type":"integer"},"policy":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"}},"required":["funder","matching_priority"],"type":"object"},"BrokerFunderPolicyFunder":{"additionalProperties":false,"properties":{"heron_id":{"readOnly":true,"type":"string"},"logo_url":{"nullable":true,"readOnly":true,"type":"string"},"name":{"readOnly":true,"type":"string"}},"required":["name"],"type":"object"},"BrokerFunderPolicyUpdateItem":{"additionalProperties":false,"properties":{"funder_heron_id":{"type":"string"},"matching_priority":{"nullable":true,"type":"integer"},"policy":{"additionalProperties":{},"nullable":true,"type":"object"}},"required":["funder_heron_id"],"type":"object"},"BrokerFunderPolicyUploadJobSchema":{"additionalProperties":false,"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"error_count":{"readOnly":true,"type":"integer"},"error_details":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"},"error_message":{"nullable":true,"readOnly":true,"type":"string"},"filename":{"nullable":true,"readOnly":true,"type":"string"},"finished_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"last_updated":{"format":"date-time","readOnly":true,"type":"string"},"processed_count":{"readOnly":true,"type":"integer"},"results_summary":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"},"started_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"status":{"enum":["queued","processing","completed","failed"],"readOnly":true},"success_count":{"readOnly":true,"type":"integer"},"total_count":{"nullable":true,"readOnly":true,"type":"integer"}},"required":["error_count","error_message","filename","finished_at","processed_count","started_at","status","success_count","total_count"],"type":"object"},"BrokerFunderPolicyUploadSchema":{"additionalProperties":false,"properties":{"file_base64":{"description":"Base64 encoded file bytes","type":"string"},"filename":{"description":"Name of file","type":"string"}},"required":["file_base64","filename"],"type":"object"},"BrokerLifecycleFunderSubmission":{"additionalProperties":false,"properties":{"attempts":{"items":{"$ref":"#/components/schemas/FunderSubmissionAttempt"},"readOnly":true,"type":"array"},"configured_channel":{"enum":["email","api","web_portal","all_offers","crm_lendsaas",null],"nullable":true,"readOnly":true},"created":{"format":"date-time","readOnly":true,"type":"string"},"current_decision":{"allOf":[{"$ref":"#/components/schemas/FunderSubmissionDecision"}],"nullable":true,"readOnly":true},"decisions":{"items":{"$ref":"#/components/schemas/FunderSubmissionDecision"},"readOnly":true,"type":"array"},"funder":{"allOf":[{"$ref":"#/components/schemas/Funder1"}],"readOnly":true},"heron_id":{"readOnly":true,"type":"string"},"send_eligibility":{"allOf":[{"$ref":"#/components/schemas/SendEligibility"}],"readOnly":true},"should_send":{"nullable":true,"readOnly":true,"type":"boolean"},"status":{"enum":["pending","in_progress","submitted_to_funder","invalid_data_for_funder","submission_failed","approved","declined",null],"nullable":true,"readOnly":true},"submission_configured":{"nullable":true,"readOnly":true,"type":"boolean"},"submission_reference_id":{"nullable":true,"readOnly":true,"type":"string"},"submission_status_message":{"nullable":true,"readOnly":true,"type":"string"},"submitted_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"}},"required":["funder","should_send","status","submitted_at"],"type":"object"},"BrokerLifecyclePage":{"additionalProperties":false,"properties":{"broker_link_status":{"enum":["unlinked","linked","dismissed","reclassified",null],"nullable":true,"readOnly":true},"classification":{"enum":["submission","decision","other",null],"nullable":true,"readOnly":true},"has_more":{"readOnly":true,"type":"boolean"},"items":{"items":{"$ref":"#/components/schemas/BrokerLifecycleFunderSubmission"},"readOnly":true,"type":"array"},"limit":{"readOnly":true,"type":"integer"},"linked_deal_end_user_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"linked_deal_name":{"nullable":true,"readOnly":true,"type":"string"},"linked_records":{"items":{"$ref":"#/components/schemas/BrokerLinkedRecord"},"readOnly":true,"type":"array"},"page":{"readOnly":true,"type":"integer"},"submitting_brokers":{"items":{"$ref":"#/components/schemas/SubmittingBroker"},"nullable":true,"readOnly":true,"type":"array"}},"required":["broker_link_status","classification","has_more","items","limit","linked_records","page","submitting_brokers"],"type":"object"},"BrokerLink":{"properties":{"classification":{"enum":["submission","decision","other"],"readOnly":true},"linked_deal_end_user_heron_id":{"description":"Heron ID of the deal linked to this broker end user.","nullable":true,"readOnly":true,"type":"string"},"linked_deal_name":{"description":"Display name of the deal linked to this broker end user.","nullable":true,"readOnly":true,"type":"string"},"status":{"enum":["unlinked","linked","dismissed","reclassified"],"readOnly":true}},"required":["classification","status"],"type":"object"},"BrokerLinkedRecord":{"additionalProperties":false,"properties":{"classification":{"enum":["submission","decision","other"],"readOnly":true},"created":{"format":"date-time","readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"link_type":{"enum":["absorbed_submission_duplicate","linked_decision"],"readOnly":true},"name":{"nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"BrokerSubmissionFileFailed":{"properties":{"filename":{"description":"Name of the file","example":"invalid.pdf","type":"string"},"reason":{"description":"Reason for failure","example":"File type application/msword not allowed. Allowed: application/pdf","type":"string"},"status":{"description":"Status of the file upload","enum":["failed"],"example":"failed","type":"string"}},"type":"object"},"BrokerSubmissionFileResult":{"properties":{"filename":{"description":"Name of the file","example":"statement.pdf","type":"string"},"reason":{"description":"Error reason (only present when status is \"failed\")","example":"Duplicate file","type":"string"},"status":{"description":"Status of the file upload","enum":["succeeded","failed"],"example":"succeeded","type":"string"}},"type":"object"},"BrokerSubmissionFileUploaded":{"properties":{"filename":{"description":"Name of the uploaded file","example":"statement_q4.pdf","type":"string"},"status":{"description":"Status of the file upload","enum":["succeeded"],"example":"succeeded","type":"string"}},"type":"object"},"BrokerSubmissionFilesUploadSchema":{"properties":{"files":{"items":{},"maxItems":12,"minItems":1,"type":"array"}},"required":["files"],"type":"object"},"BrokerVelocitySignal":{"properties":{"high_threshold":{"type":"integer"},"low_threshold":{"type":"integer"},"medium_threshold":{"type":"integer"}},"type":"object"},"BulkExecuteQueriesRequestSchema":{"properties":{"end_user_heron_id":{"nullable":false,"type":"string"},"query_names":{"items":{"nullable":false,"type":"string"},"minItems":1,"nullable":false,"type":"array"}},"required":["end_user_heron_id","query_names"],"type":"object"},"BulkFunderExclusionRuleCreateSchema":{"additionalProperties":false,"properties":{"funder_heron_ids":{"items":{"type":"string"},"maxItems":200,"minItems":1,"type":"array"},"sender_domains":{"items":{"pattern":"^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$","type":"string"},"type":"array"},"sender_emails":{"items":{"format":"email","type":"string"},"type":"array"},"sender_names":{"items":{"type":"string"},"type":"array"}},"required":["funder_heron_ids"],"type":"object"},"BulkFunderExclusionRuleResultSchema":{"properties":{"action":{"enum":["created","updated","unchanged","deleted"],"readOnly":true},"funder_heron_id":{"readOnly":true,"type":"string"}},"required":["funder_heron_id"],"type":"object"},"BulkFunderExclusionRuleTargetSchema":{"additionalProperties":false,"properties":{"funder_heron_ids":{"items":{"type":"string"},"maxItems":200,"minItems":1,"type":"array"}},"required":["funder_heron_ids"],"type":"object"},"BulkFunderExclusionRuleUpdateSchema":{"additionalProperties":false,"properties":{"add":{"$ref":"#/components/schemas/FunderExclusionSenderIdentitySchema"},"funder_heron_ids":{"items":{"type":"string"},"maxItems":200,"minItems":1,"type":"array"},"remove":{"$ref":"#/components/schemas/FunderExclusionSenderIdentitySchema"}},"required":["funder_heron_ids"],"type":"object"},"BulkSaveEntityAttributeValueItem":{"properties":{"attribute_name":{"description":"Name of the attribute to set the value for","type":"string"},"entity_name":{"description":"Name of the entity to target","type":"string"},"value":{"description":"The value to set for the attribute","nullable":true}},"required":["attribute_name","entity_name","value"],"type":"object"},"BulkSaveEntityAttributeValueResultSchema":{"properties":{"attribute_name":{"description":"Name of the attribute","type":"string"},"entity_name":{"description":"Name of the entity","type":"string"},"error":{"description":"Error message if the save failed","nullable":true,"type":"string"},"success":{"description":"Whether the value was saved successfully","type":"boolean"}},"required":["attribute_name","entity_name","success"],"type":"object"},"BulkSaveEntityAttributeValuesSchema":{"properties":{"values":{"description":"List of entity attribute values to save","items":{"$ref":"#/components/schemas/BulkSaveEntityAttributeValueItem"},"type":"array"}},"required":["values"],"type":"object"},"BulkSubmitFunderSubmissionResultSchema":{"additionalProperties":false,"properties":{"error":{"readOnly":true,"type":"string"},"outcome":{"enum":["submitted","failed","skipped"],"readOnly":true},"submission_heron_id":{"readOnly":true,"type":"string"}},"type":"object"},"BulkSubmitFunderSubmissionsRequestSchema":{"additionalProperties":false,"properties":{"selected_file_heron_ids":{"items":{"type":"string"},"nullable":true,"type":"array"},"submission_heron_ids":{"items":{"type":"string"},"maxItems":200,"minItems":1,"type":"array"},"use_sandbox":{"type":"boolean"}},"required":["submission_heron_ids","use_sandbox"],"type":"object"},"BulkUpdateBrokerFunderPoliciesSchema":{"additionalProperties":false,"properties":{"policies":{"items":{"$ref":"#/components/schemas/BrokerFunderPolicyUpdateItem"},"type":"array"}},"required":["policies"],"type":"object"},"BusinessAtBusinessAddressRecord":{"properties":{"company_name":{"description":"Name of another business sharing the applicant business's address or phone.","type":"string"},"match_type":{"description":"Whether the other business shares the applicant business's address or phone.","enum":["same_address","same_phone"],"type":"string"},"shared_value":{"description":"Shared address or phone number; null when the source does not provide the value.","nullable":true,"type":"string"},"source":{"description":"Report section that supplied the business and shared value.","type":"string"}},"type":"object"},"BusinessContact":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"department":{"description":"Department of the business contact.","nullable":true,"type":"string"},"emails":{"description":"Business email addresses associated with the contact.","items":{"type":"string"},"type":"array"},"job_level":{"description":"Job level of the business contact.","nullable":true,"type":"string"},"linkedin_url":{"description":"LinkedIn profile URL for the contact.","nullable":true,"type":"string"},"name":{"description":"Name of the business contact.","nullable":true,"type":"string"},"organization":{"description":"Organisation associated with the contact.","nullable":true,"type":"string"},"organization_addresses":{"description":"Organisation addresses associated with the contact.","items":{"$ref":"#/components/schemas/BusinessContactAddress"},"type":"array"},"phones":{"description":"Business phone numbers associated with the contact.","items":{"$ref":"#/components/schemas/ProfilePhone"},"type":"array"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source":{"description":"Source that supplied the contact.","nullable":true,"type":"string"},"title":{"description":"Title of the business contact.","nullable":true,"type":"string"}},"type":"object"},"BusinessContactAddress":{"properties":{"city":{"description":"City of the contact's organisation address.","nullable":true,"type":"string"},"country":{"description":"Country of the contact's organisation address.","nullable":true,"type":"string"},"state":{"description":"State or province of the contact's organisation address.","nullable":true,"type":"string"},"street":{"description":"Street address of the contact's organisation.","nullable":true,"type":"string"},"zip_code":{"description":"Postal code of the contact's organisation address.","nullable":true,"type":"string"}},"type":"object"},"BusinessFirmographics":{"properties":{"accounting_firm":{"description":"Name of the business's accounting firm as recorded by the source. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"address":{"description":"Business addresses by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"alternate_names":{"description":"Other names the business is recorded under, such as a trading name or a former name, by source. Empty when no source reported any.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"annual_report_date":{"description":"Dates the business last filed an annual report with the registry, in ISO 8601 format. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedDateValue"},"type":"array"},"associated_entities":{"description":"Names of other entities the registry links to this filing, one entry each. Empty when no source reported any.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"authorised_capital":{"description":"Capital the registry authorises the business to raise, in whole units of currency. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"},"bank":{"description":"Name of the business's bank as recorded by the source. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"business_description":{"description":"How the source describes what the business does, in its own words. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"care_of":{"description":"Care-of line on the registry filing address. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"classification":{"description":"How the company registry classifies the entity. Source-verbatim, with no fixed vocabulary; empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"corp_lifetime":{"description":"How long the registry records the entity as existing for, such as perpetual. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"duns":{"description":"D&B DUNS numbers by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"duration_date":{"description":"Date the registry records the entity as ceasing, where its life is fixed rather than perpetual. Source-verbatim; empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"effective_date":{"description":"Dates the registry filing took effect, by source. Often the same as the filing date; empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedDateValue"},"type":"array"},"email":{"description":"Email addresses recorded for the business, by source. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"employees":{"description":"Employee counts by source. A source may supply earlier counts alongside its current one; the as_of date distinguishes them.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"},"employees_here":{"description":"Employees at this location only, by source, where the source reports it separately from the organisation-wide count. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"},"employment_growth":{"description":"Headcount growth as the source expressed it, usually a percentage. Source-verbatim; empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"establishment_type":{"description":"How the source classifies the site, such as a single location, a headquarters, or a branch. Source-verbatim, with no fixed vocabulary; empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"fein":{"description":"Federal Employer Identification Numbers recorded for the business, by source. A business may have more than one on file. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"filing_county":{"description":"County the original registry filing was made in. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"filing_date":{"description":"Dates the business's formation document was filed with the company registry, by source. A record may carry a filing date without an incorporation date, or the reverse; empty when neither is reported.","items":{"$ref":"#/components/schemas/SourcedDateValue"},"type":"array"},"filing_history":{"description":"Amendments and other events the registry recorded against the filing, one entry each, in source order. An entry's as_of is the date of that amendment where the source gives one. Empty when no source reported any.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"filing_office":{"description":"Names of the registry offices holding the filing, by source. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"filing_office_address":{"description":"Addresses of the registry offices holding the filing, by source. This is the office's own address, not the business's. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"filing_state":{"description":"States the registry filing was made in, by source. This is where the document was filed, which is not always the state of incorporation. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"filing_type":{"description":"Kind of document filed with the registry. Source-verbatim; empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"fiscal_year_end":{"description":"When the business's financial year ends, as the source expressed it. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"franchise_status":{"description":"Status of the business's franchise tax with the registry. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"headquarters":{"description":"Name of the business's headquarters where the source records it as a branch. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"incorporation_date":{"description":"Dates the business was incorporated, by source. Empty when no source reported one, which happens where a registry record carries only the date its formation document was filed.","items":{"$ref":"#/components/schemas/SourcedDateValue"},"type":"array"},"industry_group":{"description":"Industry groups by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"invested_amount":{"description":"Amount recorded as invested in the business, in whole units of currency. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"},"last_annual_financial_date":{"description":"Date of the most recent annual financial figures the source holds, in ISO 8601 format. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedDateValue"},"type":"array"},"legal_immediate_parent":{"description":"Legal immediate parent names by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"legal_immediate_parent_indicator":{"description":"Legal immediate parent indicators by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"legal_name":{"description":"Legal business names by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"legal_status":{"description":"Business legal statuses by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"legal_ultimate_parent":{"description":"Legal ultimate parent names by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"legal_ultimate_parent_indicator":{"description":"Legal ultimate parent indicators by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"line_of_business":{"description":"Lines of business by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"llc_type":{"description":"Sub-type the registry records for a limited liability company. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"mailing_address":{"description":"Mailing addresses where these differ from the trading address, by source. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"msa":{"description":"Metropolitan statistical areas by source.","items":{"$ref":"#/components/schemas/SourcedMSAValue"},"type":"array"},"naics":{"description":"Ranked NAICS codes by source.","items":{"$ref":"#/components/schemas/SourcedIndustryCodeValue"},"type":"array"},"net_worth":{"description":"Net worth in whole units of currency, by source. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"},"number_of_accounts":{"description":"Count of accounts the source holds for the business. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"},"occupancy_type":{"description":"Whether the source records the premises as owned, rented or otherwise held. Source-verbatim; empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"operating_status":{"description":"Business operating statuses by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"outstanding_shares":{"description":"Shares currently in issue, as the source expressed it. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"ownership":{"description":"Business ownership details by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"people":{"description":"Business contacts and officers by source.","items":{"$ref":"#/components/schemas/SourcedPersonValue"},"type":"array"},"phone":{"description":"Business phone numbers by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"profit":{"description":"Profit in whole units of currency, by source. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"},"registered_agent":{"description":"Registered agents by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"registered_agent_address":{"description":"Addresses recorded for the registered agent, by source. This is the agent's address, not the business's. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"registry_number":{"description":"Identifiers the company registry assigned to the business, by source. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"revenue":{"description":"Annual revenue amounts by source. A source may supply earlier figures alongside its current one; the as_of date distinguishes them.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"},"sales_growth":{"description":"Sales growth as the source expressed it, usually a percentage. Source-verbatim; empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"sales_territory":{"description":"Geographic area the source records the business as selling into. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"shareholders":{"description":"Shareholder count as the source expressed it. Source-verbatim; empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"sic":{"description":"Ranked SIC codes by source.","items":{"$ref":"#/components/schemas/SourcedIndustryCodeValue"},"type":"array"},"square_footage":{"description":"Floor area of the building in square feet, by source. Empty when no source reported it.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"},"state_of_incorporation":{"description":"Incorporation states by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"status_date":{"description":"Dates the registry last changed the business's status, by source. Empty when no source reported one.","items":{"$ref":"#/components/schemas/SourcedDateValue"},"type":"array"},"ticker_symbol":{"description":"Stock ticker symbols recorded for the business, by source. Empty for a business that is not publicly traded.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"web_address":{"description":"Business websites by source.","items":{"$ref":"#/components/schemas/SourcedStringValue"},"type":"array"},"year_started":{"description":"Business start years by source.","items":{"$ref":"#/components/schemas/SourcedIntegerValue"},"type":"array"}},"required":["accounting_firm","address","alternate_names","annual_report_date","associated_entities","authorised_capital","bank","business_description","care_of","classification","corp_lifetime","duns","duration_date","effective_date","email","employees","employees_here","employment_growth","establishment_type","fein","filing_county","filing_date","filing_history","filing_office","filing_office_address","filing_state","filing_type","fiscal_year_end","franchise_status","headquarters","incorporation_date","industry_group","invested_amount","last_annual_financial_date","legal_immediate_parent","legal_immediate_parent_indicator","legal_name","legal_status","legal_ultimate_parent","legal_ultimate_parent_indicator","line_of_business","llc_type","mailing_address","msa","naics","net_worth","number_of_accounts","occupancy_type","operating_status","outstanding_shares","ownership","people","phone","profit","registered_agent","registered_agent_address","registry_number","revenue","sales_growth","sales_territory","shareholders","sic","square_footage","state_of_incorporation","status_date","ticker_symbol","web_address","year_started"],"type":"object"},"BusinessFlagRecord":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"address":{"description":"Address CLEAR attaches as proof of the flag; null when unavailable.","nullable":true,"type":"string"},"dba_name":{"description":"Trade name on the supporting record; null when unavailable.","nullable":true,"type":"string"},"detail":{"description":"Source-provided proof summary; null when unavailable.","nullable":true,"type":"string"},"flag":{"description":"Business risk signal category.","enum":["msb","marijuana","pending_class_action","out_of_business","non_profit","religious_organization","public_listing","business_used_as_residential_address","listing_linked_to_business_phone"],"type":"string"},"license_number":{"description":"Marijuana business licence number; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Business name on the supporting record; null when unavailable.","nullable":true,"type":"string"},"phone_number":{"description":"Phone number on a listing CLEAR links to the flag; null when unavailable.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"services":{"description":"Services on a money-service record.","items":{"type":"string"},"type":"array"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source":{"description":"Report source that raised or supports the signal.","enum":["clear_risk_flag","business_profile","dnb","sos","sic_naics","msb_section","marijuana_section","worldbase"],"type":"string"},"source_record_index":{"description":"Zero-based record index within the source section; null for merged values.","nullable":true,"type":"integer"},"source_section":{"description":"CLEAR report section containing the proof.","type":"string"},"stock_exchange":{"description":"Stock exchange; null when unavailable.","nullable":true,"type":"string"},"support_status":{"description":"Whether the report supports, conflicts with, or only flags the signal.","enum":["supported","conflicting","clear_only"],"type":"string"},"ticker_symbol":{"description":"Stock ticker symbol; null when unavailable.","nullable":true,"type":"string"}},"required":["flag","source","source_section","support_status"],"type":"object"},"BusinessProfileRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"alternate_business_names":{"description":"Other business names on the record.","items":{"type":"string"},"type":"array"},"business_description":{"description":"Description of the business's activity.","nullable":true,"type":"string"},"business_name":{"description":"Business name on the record.","nullable":true,"type":"string"},"business_type":{"description":"Source-provided business type.","nullable":true,"type":"string"},"company_contact":{"description":"Company contact named by the source.","nullable":true,"type":"string"},"contact_title":{"description":"Title of the company contact.","nullable":true,"type":"string"},"corporate_status":{"description":"Source-provided corporate status.","nullable":true,"type":"string"},"current_outstanding_shares":{"description":"Current outstanding share count.","nullable":true,"type":"string"},"fiscal_year_end":{"description":"Fiscal year end from the source.","nullable":true,"type":"string"},"incorporation_date":{"description":"Date the business was incorporated.","format":"date","nullable":true,"type":"string"},"last_annual_financial_date":{"description":"Date of the latest annual financial information.","format":"date","nullable":true,"type":"string"},"legal_business_name":{"description":"Legal business name on the record.","nullable":true,"type":"string"},"location_type":{"description":"Source-provided business location type.","nullable":true,"type":"string"},"non_profit":{"description":"Whether the business is a nonprofit.","nullable":true,"type":"boolean"},"number_of_employees":{"description":"Source-provided employee count.","nullable":true,"type":"string"},"operating_status":{"description":"Source-provided operating status.","nullable":true,"type":"string"},"parent_company":{"description":"Immediate or ultimate parent company.","nullable":true,"type":"string"},"primary_naics_code":{"description":"Primary NAICS industry code.","nullable":true,"type":"string"},"primary_naics_desc":{"description":"Description of the primary NAICS industry code.","nullable":true,"type":"string"},"primary_sic_code":{"description":"Primary SIC industry code.","nullable":true,"type":"string"},"primary_sic_desc":{"description":"Description of the primary SIC industry code.","nullable":true,"type":"string"},"public_company":{"description":"Whether the business is publicly traded.","nullable":true,"type":"boolean"},"registered_agent":{"description":"Registered agent named by the source.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"secondary_naics_codes":{"description":"Secondary NAICS industry codes.","items":{"type":"string"},"type":"array"},"secondary_sic_codes":{"description":"Secondary SIC industry codes.","items":{"type":"string"},"type":"array"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"shareholders":{"description":"Shareholder information from the source.","nullable":true,"type":"string"},"source":{"description":"Source that supplied the record.","nullable":true,"type":"string"},"state_of_incorporation":{"description":"State where the business was incorporated.","nullable":true,"type":"string"},"stock_exchange":{"description":"Stock exchange for a public company.","nullable":true,"type":"string"},"stock_ticker":{"description":"Stock ticker for a public company.","nullable":true,"type":"string"},"website":{"description":"Business website.","nullable":true,"type":"string"},"year_established":{"description":"Year the business was established.","nullable":true,"type":"string"},"year_started":{"description":"Year the business started operating.","nullable":true,"type":"string"}},"type":"object"},"BusinessSocialMedia":{"description":"Social media profiles of the business.","properties":{"facebook":{"allOf":[{"$ref":"#/components/schemas/ResolvedSocialProfile"}],"description":"The company's Facebook page.","nullable":true},"instagram":{"allOf":[{"$ref":"#/components/schemas/ResolvedSocialProfile"}],"description":"The company's Instagram profile.","nullable":true},"linkedin":{"allOf":[{"$ref":"#/components/schemas/ResolvedSocialProfile"}],"description":"The company's LinkedIn page.","nullable":true}},"type":"object"},"BusinessVerification":{"properties":{"billing_address":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"Where the business is billed."},"business_address":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"Where the business operates from."},"business_email":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The business's email address."},"business_phone":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The business's phone number."},"dba":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"DBA or trade name."},"display_name":{"description":"The name a reader shows the subject under.","nullable":true,"type":"string"},"ein":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"US EIN."},"entity_type":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"Legal form, such as LLC."},"facebook":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The business's Facebook page."},"industry":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The company's main industry, such as `NAICS 722511 - Full-Service Restaurants`. Not verified: each source's value is listed as `not_compared`, and the application's as `stated`."},"instagram":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The business's Instagram profile."},"key":{"description":"The details response key for this subject's row, so a reader can open it.","type":"string"},"legal_name":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"Legal business name."},"linkedin":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The business's LinkedIn page."},"standing":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"How the winning filing reads on filings and fees."},"started_on":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"Business start date."},"state_of_incorporation":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"State the company was formed in."},"status":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"Business status: active or inactive."},"status_raw":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The winning filing's status in the registry's own words."},"subject_type":{"enum":["owner","business"]},"website":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The business's website."}},"type":"object"},"CTAResponse":{"properties":{"text":{"example":"CTA Text","type":"string"},"url":{"example":"https://example.com/cta","type":"string"}},"type":"object"},"CandidateAnchorTrace":{"properties":{"anchor":{"description":"Identifier that resolved the match outright: ein or corp_number_echo.","enum":["ein","corp_number_echo"],"type":"string"},"guard_field":{"description":"Candidate field used to guard the anchor match; null when no guard was needed.","enum":["business_name","address","owner",null],"nullable":true,"type":"string"},"guard_strength":{"description":"Guard field's comparison strength; null when no guard was evaluated.","nullable":true,"type":"number"},"permitted":{"description":"False records an anchor-grade identifier the guard denied.","type":"boolean"}},"required":["anchor","permitted"],"type":"object"},"CandidateCapTrace":{"properties":{"cap":{"description":"The cap the total was clamped to, as a fraction.","type":"number"},"conflict":{"description":"Conflicting field that caused the score cap.","enum":["zero_floor"],"type":"string"},"uncapped_total":{"description":"The uncapped total, as a fraction.","type":"number"}},"required":["cap","conflict","uncapped_total"],"type":"object"},"CandidateFieldTrace":{"properties":{"base":{"description":"Comparator strength before named modifiers are applied.","type":"number"},"components":{"description":"Per-part evidence used to derive the strength.","items":{"$ref":"#/components/schemas/CandidateTraceComponent"},"type":"array"},"mode":{"description":"How the strength was derived: exact, similarity, stepped, or composite.","enum":["exact","similarity","stepped","composite"],"type":"string"},"modifiers":{"description":"Named adjustments applied to the base strength.","items":{"$ref":"#/components/schemas/CandidateTraceModifier"},"type":"array"}},"required":["base","components","mode","modifiers"],"type":"object"},"CandidateScore":{"properties":{"anchor_trace":{"allOf":[{"$ref":"#/components/schemas/CandidateAnchorTrace"}],"description":"Winner-only; null otherwise.","nullable":true},"anchored_by":{"description":"The anchor identifier that resolved the match (e.g. ein); winner-only.","nullable":true,"type":"string"},"cap_trace":{"allOf":[{"$ref":"#/components/schemas/CandidateCapTrace"}],"description":"Audit of the score cap; null when no cap was applied.","nullable":true},"capped_by":{"description":"Names the clamp when the total isn't the contribution sum (e.g. zero_floor); null otherwise.","nullable":true,"type":"string"},"contributions":{"description":"Per-field ledger of contributions to the candidate's match score.","items":{"$ref":"#/components/schemas/CandidateScoreContribution"},"type":"array"},"tier":{"description":"Score tier: high, medium, or low.","enum":["high","medium","low"],"type":"string"},"total":{"description":"The match score as a fraction in [0, 1].","type":"number"},"version":{"description":"Match-scoring model version.","type":"string"}},"required":["contributions","tier","total","version"],"type":"object"},"CandidateScoreContribution":{"properties":{"allocation":{"description":"Fraction of the 100-point maximum.","type":"number"},"application_value":{"description":"The compared application value when it differs from the hoisted application block; null otherwise.","nullable":true,"type":"string"},"candidate_value":{"description":"Candidate value compared for this contribution; null when absent.","nullable":true,"type":"string"},"cause":{"description":"Why an absent verdict has no evidence; null on scoreable rows.","enum":["missing_application_value","missing_candidate_value",null],"nullable":true,"type":"string"},"field":{"description":"Application field evaluated by this contribution.","type":"string"},"identifier_source":{"description":"For an identifier-echo corroboration (corp_number_echo), which system supplied the re-searched number; null on other rows.","enum":["sos_registry","clear_filing",null],"nullable":true,"type":"string"},"kind":{"description":"Contribution type: field (a direct comparison), corroboration, penalty, or quality.","enum":["field","corroboration","quality","penalty"],"type":"string"},"points":{"description":"This row's contribution to the total, as a fraction.","type":"number"},"strength":{"description":"Comparator strength in [-1, 1]; null when the field wasn't comparable (fall back to the verdict).","nullable":true,"type":"number"},"trace":{"allOf":[{"$ref":"#/components/schemas/CandidateFieldTrace"}],"description":"How the strength was derived; null when trivially derived.","nullable":true},"verdict":{"description":"Comparison verdict: agree, fuzzy, diverge, or absent.","enum":["agree","fuzzy","diverge","absent"],"type":"string"}},"required":["allocation","field","kind","points","verdict"],"type":"object"},"CandidateTraceComponent":{"properties":{"part":{"description":"Compared part of a compound field, such as street, city, zip, or name similarity.","enum":["name_similarity","full_name_similarity","house","street","city","state","zip","zip5","zip4"],"type":"string"},"value":{"description":"Bool for exact part matches, a 0-1 float for fuzzy ones; null when uncompared.","nullable":true}},"required":["part"],"type":"object"},"CandidateTraceModifier":{"properties":{"detail":{"description":"Free-text specifics; display verbatim.","nullable":true,"type":"string"},"effect":{"description":"The strength delta this adjustment contributed.","type":"number"},"kind":{"description":"Adjustment applied: aka_lift, dba_basis, or premises_composite.","enum":["aka_lift","corroboration_admitted","dba_basis","full_name_in_first_name","merged_filing_basis","middle_initial_cap","partial_agreement_floor","premises_composite"],"type":"string"}},"required":["effect","kind"],"type":"object"},"CategorisationBeta":{"properties":{"merchants_beta":{"type":"boolean"},"positions_beta":{"type":"boolean"},"rich_heuristics_beta":{"type":"boolean"}},"type":"object"},"Category":{"properties":{"analytics_group":{"description":"The analytics group of the category","enum":["revenue","cost_of_goods_sold","operational_expenses","tax_expenses","intra_company","debt","equity","other_income","special_items","other",null],"example":"revenue","nullable":true,"readOnly":true,"type":"string"},"created":{"description":"Timestamp for when the category was created","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"description":{"description":"Description of the category","example":"Rent for offices, workspaces or storage facilities","type":"string"},"heron_id":{"description":"Unique ID of the category generated by Heron Data","example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","readOnly":true,"type":"string"},"label":{"description":"The label of the category","example":"Rent","type":"string"}},"required":["label"],"type":"object"},"Category1":{"properties":{"heron_id":{"description":"Unique ID of the category generated by Heron Data","example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","readOnly":true,"type":"string"},"label":{"description":"The label of the category","example":"Rent","type":"string"}},"required":["label"],"type":"object"},"CategoryFeedback":{"properties":{"heron_id":{"description":"heron_id of the correct category","example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","type":"string"},"label":{"description":"label of the correct category","example":"Insurance","type":"string"}},"type":"object"},"Check":{"properties":{"attribute_description":{"description":"What the attribute measures. Present only for accounts on policy versions","nullable":true,"type":"string"},"attribute_display_name":{"description":"The attribute's human-readable name. Present only for accounts on policy versions","nullable":true,"type":"string"},"attribute_entry_format":{"additionalProperties":{},"description":"How each entry of a list value on `attribute_label` is written, as in the catalogue's `check_options[].entry_format`. Absent for free text or a check without an attribute","nullable":true,"properties":{"example":{"type":"string"},"hint":{"type":"string"},"mask":{"type":"string"},"noun":{"type":"string"}},"required":["noun","mask","example","hint"],"type":"object"},"attribute_label":{"nullable":true,"type":"string"},"attribute_unit":{"description":"The unit of `attribute_label`, for formatting the attribute's value and the check's threshold. Null for a check without an attribute or an attribute with no declared unit","enum":["currency","percentage","count","ratio","days","years","text",null],"nullable":true},"attribute_validators":{"description":"The validity operators `attribute_label` offers, as in the catalogue's `check_options[].validators`, so a saved `is_valid` / `is_invalid` check can be worded. Empty for a check without an attribute or an attribute with no validity rule","items":{"additionalProperties":{},"type":"object"},"nullable":true,"type":"array"},"attribute_value_set":{"description":"The vocabulary `attribute_label` draws from, so the editor can offer a dropdown. Keys into the /policy_value_sets response. Null for free text","enum":["us_state","naics_industry","naics_code","restricted_industries","merchant","crm_decline_reason","iso_source_name","business_entity_type","fraud_network_finding","broker_velocity","broker_velocity_signal","fraud_network_scan_status","fraud_network_classification","industry_category","datamerch_note_category","complete_months",null],"nullable":true},"boolean_check":{"allOf":[{"$ref":"#/components/schemas/BooleanCheck"}],"nullable":true},"composite_check":{"allOf":[{"$ref":"#/components/schemas/CompositeCheck"}],"nullable":true},"date_check":{"allOf":[{"$ref":"#/components/schemas/DateCheck"}],"nullable":true},"date_delta_to_now_check":{"allOf":[{"$ref":"#/components/schemas/DateDeltaToNowCheck"}],"nullable":true},"enhanced_sql_check":{"allOf":[{"$ref":"#/components/schemas/EnhancedSQLCheck"}],"nullable":true},"group":{"nullable":true,"type":"string"},"heron_id":{"description":"Stable across edits; omit for a new check and one is minted. Policy versions only","nullable":true,"type":"string"},"identity":{"description":"Stable kind:key identity used to match stored check evaluations","nullable":true,"readOnly":true,"type":"string"},"name":{"nullable":true,"type":"string"},"numeric_check":{"allOf":[{"$ref":"#/components/schemas/NumericCheck"}],"nullable":true},"parameters":{"additionalProperties":{"oneOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"$ref":"#/components/schemas/TableColumn"}]},"description":"Settings by name: a string, a list of strings, or {\"lookup\": {\"table_heron_id\", \"column_id\"}} to read the setting from a lookup table column, per deal","nullable":true,"type":"object"},"sql_check":{"allOf":[{"$ref":"#/components/schemas/SQLCheck"}],"nullable":true},"string_check":{"allOf":[{"$ref":"#/components/schemas/StringCheck"}],"nullable":true}},"type":"object"},"CheckAnalyticsResponse":{"properties":{"check_name":{"type":"string"},"total_failed":{"type":"integer"},"total_missing_data":{"type":"integer"},"total_passed":{"type":"integer"}},"type":"object"},"CheckEvaluation":{"properties":{"attribute_value":{"allOf":[{"$ref":"#/components/schemas/CompanyAttributeValue"}],"nullable":true},"check":{"allOf":[{"$ref":"#/components/schemas/Check"}],"nullable":true},"computed_threshold":{"description":"factor \u00d7 threshold_value, the number the check compared against, as a decimal string. Absent when the check has no factor or the compared value is missing","readOnly":true},"effective_result":{"description":"The check's result after failure routing: `review_required` for a tripped check whose on_failure is review_required (and not auto_decline), else the same as `result`","enum":["pass","failed","review_required","missing_data"],"readOnly":true},"evaluations":{"items":{"$ref":"#/components/schemas/CheckEvaluation"},"nullable":true,"type":"array"},"parameter_lookups_used":{"description":"For each variable setting the check read from a lookup table, the row it used. Absent for checks with no setting read from a table","items":{"$ref":"#/components/schemas/ParameterLookupUse"},"readOnly":true,"type":"array"},"reason":{"description":"Only populated for customers on policy versions, and only for company-attribute checks","nullable":true,"readOnly":true,"type":"string"},"result":{"enum":["pass","failed","review_required","missing_data"]},"threshold_value":{"allOf":[{"$ref":"#/components/schemas/CompanyAttributeValue"}],"description":"The value of the variable a number check compares against. Absent for a check with a fixed number","nullable":true,"readOnly":true}},"type":"object"},"CheckFlip":{"properties":{"baseline_result":{"description":"Baseline result: passed, failed, review_required, or missing_data","readOnly":true,"type":"string"},"baseline_threshold_value":{"description":"The compared variable's value. Absent for a check against a fixed number","nullable":true,"readOnly":true,"type":"string"},"baseline_value":{"nullable":true,"readOnly":true,"type":"string"},"candidate_result":{"description":"Candidate result: passed, failed, review_required, or missing_data","readOnly":true,"type":"string"},"candidate_threshold_value":{"description":"The compared variable's value. Absent for a check against a fixed number","nullable":true,"readOnly":true,"type":"string"},"candidate_value":{"nullable":true,"readOnly":true,"type":"string"},"check_identity":{"description":"Prefixed identity: attribute:, sql:, sql_legacy:, or composite:","readOnly":true,"type":"string"},"check_name":{"nullable":true,"readOnly":true,"type":"string"},"section_name":{"readOnly":true,"type":"string"}},"type":"object"},"CheckValueUpdate":{"properties":{"check_heron_id":{"description":"The check to update","type":"string"},"value":{"description":"The new value: a list of strings for list operators (e.g. is_in), otherwise a string, number or boolean matching the check. List entries can't contain a comma or semicolon. A check that compares two variables takes {\"factor\": <number more than 0, at most 100, up to 4 decimal places>}, e.g. \"0.8\" for 80% of the compared variable. Only the value changes; the check's operator and attribute stay the same"}},"required":["check_heron_id","value"],"type":"object"},"CheckValuesUpdateSchema":{"properties":{"change_description":{"maxLength":255,"nullable":true,"type":"string"},"updates":{"items":{"$ref":"#/components/schemas/CheckValueUpdate"},"minItems":1,"type":"array"}},"required":["updates"],"type":"object"},"ChosenCreditScore":{"properties":{"bureau":{"description":"The bureau that produced the score; `unknown` when the source did not identify one.","enum":["equifax","experian","transunion","unknown"]},"score":{"description":"The numeric score the source reported.","type":"integer"},"score_model":{"description":"The scoring model family; `unknown` when the source did not name one.","enum":["fico","vantagescore","unknown"]},"score_model_raw":{"description":"The scoring model as the source named it; null when the source did not identify one.","nullable":true,"type":"string"},"score_version_raw":{"description":"The scoring model version as the source stated it, such as `8`; null when it gave none.","nullable":true,"type":"string"},"scored_on":{"description":"The date the score was calculated, in ISO 8601 format; null when the source did not report one.","format":"date","nullable":true,"type":"string"}},"type":"object"},"CloneEndUserEntityAttributeSchema":{"properties":{"attribute_name":{"type":"string"}},"required":["attribute_name"],"type":"object"},"CollectingAccount":{"properties":{"account_owner_name":{"description":"Name the bank statement lists as the owner of the account the money was collected from","example":"ACME TRADING LLC","nullable":true,"type":"string"},"display_account_id":{"description":"Human-readable label for the bank account the money was collected from: the last four digits of the account number without heron_account_suffix (falling back to the account title). Not unique and not a key.","example":"7505","nullable":true,"type":"string"},"heron_account_suffix":{"description":"Added by Heron to tell apart accounts that print the same account number, such as a checking account and its reserve line. Not printed by the bank. A 3-digit suffix is the order the accounts appear in one file, so the same account can get a different one in another file. Null when the printed number needed no suffix.","example":"001","nullable":true,"type":"string"}},"type":"object"},"ColumnTypeFeed":{"properties":{"attribute_label":{"description":"The variable whose setting reads the column","type":"string"},"parameter":{"description":"The setting the column's cells supply, e.g. month_count","type":"string"},"requires":{"additionalProperties":{"type":"string"},"description":"Other settings the rule must have for this setting to read a column; empty when none","type":"object"}},"required":["attribute_label","parameter","requires"],"type":"object"},"ColumnTypeValueSetSchema":{"properties":{"feeds":{"description":"The variable settings a column of this type can supply","items":{"$ref":"#/components/schemas/ColumnTypeFeed"},"type":"array"},"name":{"description":"The type's display name, e.g. Month window","type":"string"},"type":{"description":"A lookup column type whose cells come from a value set","enum":["years","money","number","list","month_window"]},"value_set":{"description":"The value set its cells are chosen from; its options come from the value sets endpoint","enum":["us_state","naics_industry","naics_code","restricted_industries","merchant","crm_decline_reason","iso_source_name","business_entity_type","fraud_network_finding","broker_velocity","broker_velocity_signal","fraud_network_scan_status","fraud_network_classification","industry_category","datamerch_note_category","complete_months"]}},"required":["feeds","name","type","value_set"],"type":"object"},"CompanyAttributeCatalogueSchema":{"properties":{"availability":{"description":"Which libraries list this attribute: every customer's, or specific customers' only (per-account attributes such as entity fields). Not included in customer responses.","enum":["all_customers","specific_customers","internal"],"readOnly":true,"type":"string"},"check_options":{"description":"Allowed check forms and any conditional inputs for this value type. `validators` lists the validity operators this variable offers on top of its type's own, e.g. {\"type\": \"is_valid\", \"label\": \"must be a valid EIN\", \"trigger_label\": \"is invalid\"}: `type` is the operator to store, `label` reads as the pass condition and `trigger_label` as the condition that fails the check. Empty when the variable has none. `entry_format`, on the string_check option, is how each entry of a list value is written: `mask` has `#` per digit, any text whose digits fill it is the same entry, saves store it in the mask's form, and any other entry is refused with `hint`. Null when entries are free text. A `string_check` entry also carries the variable's operator menu. `operators` lists the stored operators to offer for a new check, in menu order. `legacy_operators` lists the rest: a saved check may still hold one, so show it, but do not offer it again. `offers_presence` is false when the variable always has a value, so the empty-value checks (`equal` or `not_equal` with an empty `value`) should not be offered. `pick_only` is true when a check may only hold values from the variable's value set. `value_set_operators` gives the same four fields for each value set a setting can switch the variable to (see `parameter_value_sets`), and is null when no setting does","items":{"properties":{"check_type":{"enum":["string_check","numeric_check","date_check","boolean_check","date_delta_to_now_check"],"type":"string"},"entry_format":{"nullable":true,"properties":{"example":{"type":"string"},"hint":{"type":"string"},"mask":{"type":"string"},"noun":{"type":"string"}},"required":["noun","mask","example","hint"],"type":"object"},"extra_inputs":{"additionalProperties":true,"type":"object"},"legacy_operators":{"items":{"enum":["equal","not_equal","contains","does_not_contain","starts_with","does_not_start_with","starts_with_any_of","does_not_start_with_any_of","is_in","is_not_in","has_any_of","has_none_of","has_only","has_fewer_than_n_matches","has_more_than_n_matches"],"type":"string"},"type":"array"},"offers_presence":{"type":"boolean"},"operators":{"items":{"enum":["equal","not_equal","contains","does_not_contain","starts_with","does_not_start_with","starts_with_any_of","does_not_start_with_any_of","is_in","is_not_in","has_any_of","has_none_of","has_only","has_fewer_than_n_matches","has_more_than_n_matches"],"type":"string"},"type":"array"},"pick_only":{"type":"boolean"},"validators":{"items":{"properties":{"label":{"type":"string"},"trigger_label":{"type":"string"},"type":{"enum":["is_invalid","is_valid"],"type":"string"}},"required":["type","label","trigger_label"],"type":"object"},"type":"array"},"value_set_operators":{"items":{"properties":{"legacy_operators":{"items":{"enum":["equal","not_equal","contains","does_not_contain","starts_with","does_not_start_with","starts_with_any_of","does_not_start_with_any_of","is_in","is_not_in","has_any_of","has_none_of","has_only","has_fewer_than_n_matches","has_more_than_n_matches"],"type":"string"},"type":"array"},"offers_presence":{"type":"boolean"},"operators":{"items":{"enum":["equal","not_equal","contains","does_not_contain","starts_with","does_not_start_with","starts_with_any_of","does_not_start_with_any_of","is_in","is_not_in","has_any_of","has_none_of","has_only","has_fewer_than_n_matches","has_more_than_n_matches"],"type":"string"},"type":"array"},"pick_only":{"type":"boolean"},"value_set":{"enum":["us_state","naics_industry","naics_code","restricted_industries","merchant","crm_decline_reason","iso_source_name","business_entity_type","fraud_network_finding","broker_velocity","broker_velocity_signal","fraud_network_scan_status","fraud_network_classification","industry_category","datamerch_note_category","complete_months"],"type":"string"}},"type":"object"},"nullable":true,"type":"array"}},"required":["check_type","extra_inputs","validators"],"type":"object"},"readOnly":true,"type":"array"},"description":{"description":"What the value means, written for the customer reading their own rules - the status words a position count admits, what a window is anchored to, when the value is missing rather than zero. Null for a label with no curated description yet. Present only for accounts on policy versions","nullable":true,"readOnly":true,"type":"string"},"display_name":{"description":"The attribute's human-readable name, with its tier as a qualifier, e.g. \"NSF days last 30 days\", \"Open judgment total amount (12 months, background check, owner 1)\". Parameters are not part of the name - render them from `parameters` where the context wants them. Derived, so it may be reworded. Present only for accounts on policy versions","readOnly":true,"type":"string"},"enricher":{"description":"The Heron enricher the value comes from. Null when it comes from none.","enum":["background_check","court_records","web_presence","industry_prediction","fraud_network","broker_velocity","secretary_of_state","tin_match"],"nullable":true,"readOnly":true,"type":"string"},"label":{"description":"The attribute's stable identifier, which a check refers to and a CRM field maps onto. Namespaced with \":\" where a source groups its attributes, e.g. \"nsf_days_last_30_days\", \"BackgroundCheck:owner_1:has_felony\"","type":"string"},"library_group":{"description":"The group the variable library lists this attribute under.","enum":["bank_statements","identity","heron_enrichers","integrations"],"readOnly":true,"type":"string"},"minimum":{"description":"The lowest threshold a numeric check on this attribute may compare with; a save refuses a lower one. 0 for a percentage, ratio, count or number of days. Null when the value can be negative, such as money","nullable":true,"readOnly":true,"type":"integer"},"parameter_definitions":{"description":"Presentation metadata for every parameter axis, including its name, description, default value, an option-to-label map and `option_descriptions`, an option-to-sentence map saying what choosing each option does, and `tier`: `regular` for a setting rule authors often tune, `advanced` for one they rarely change, which the editor can tuck away. `kind` is `choice` for a setting that takes one of its options, or `number` for one that takes any whole number from `minimum` up, with its options as suggested values. `multiple: true` marks a setting that takes one option or a list of several. `shown_when`, e.g. {\"filter_by\": [\"merchant_group\"]}, marks a setting that applies only while each named setting holds one of the listed options; the editor hides it otherwise. Null for an unparametrised label","readOnly":true},"parameter_value_sets":{"description":"Settings that change the vocabulary the value is drawn from, e.g. [{\"parameters\": {\"address\": \"physical\", \"part\": \"state\"}, \"value_set\": \"us_state\"}]. A check whose settings match an entry uses that entry's `value_set`; any other check uses the attribute's own `value_set`. Null when no setting changes it","readOnly":true},"parameter_value_types":{"description":"Settings that change the value's type and unit, e.g. [{\"parameters\": {\"aggregation\": \"total\"}, \"type\": \"decimal\", \"unit\": \"currency\", \"minimum\": null}]. Each entry names only the settings that decide the type. A check whose settings include an entry's `parameters` uses that entry's `type`, `unit` and `minimum`; any other check uses the attribute's own. Null when no setting changes it","items":{"properties":{"minimum":{"nullable":true,"type":"integer"},"parameters":{"additionalProperties":{"type":"string"},"type":"object"},"type":{"enum":["float","int","decimal","string","date","datetime","bool"],"type":"string"},"unit":{"enum":["currency","percentage","count","ratio","days","years","text"],"nullable":true,"type":"string"}},"required":["parameters","type","unit","minimum"],"type":"object"},"nullable":true,"readOnly":true,"type":"array"},"parameters":{"additionalProperties":{"oneOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"description":"Which variant of a parametrised label this is, e.g. {\"product_type\": \"mca\", \"status\": \"active_only\"}. A setting marked `multiple` in its parameter definition may hold a list of options. Null for a label that takes no parameters, and null on a catalogue listing, where parameter definitions give the choices instead","nullable":true,"type":"object"},"parser":{"description":"The id of the document parser whose field this is. Null for any other attribute.","nullable":true,"readOnly":true,"type":"string"},"period_examples":{"description":"Preview only, never part of a description: the dates a check would read if evaluated today, one entry per combination of its date settings","readOnly":true},"source":{"description":"Where the attribute's value comes from.","enum":["business_details","entity_graph","template_entity","custom_entity","documents","emails","bank_statements","transactions","positions","background_check","court_records","datamerch","web_presence","fraud_network","broker_velocity","industry_prediction","lendsaas","other"],"readOnly":true,"type":"string"},"sources":{"description":"For an attribute that compares several sources, those sources. Empty for any other attribute.","items":{"enum":["background_check","bank_statements","broker_velocity","court_records","fraud_network","industry_prediction","secretary_of_state","tin_match","web_presence"],"type":"string"},"readOnly":true,"type":"array"},"topic_path":{"description":"The picker hierarchy from broad topic to narrow topic.","items":{"type":"string"},"readOnly":true,"type":"array"},"type":{"description":"The value's type, which decides what a check on it can compare: \"int\", \"float\", \"decimal\", \"string\", \"date\", \"datetime\", \"bool\"","enum":["float","int","decimal","string","date","datetime","bool"]},"unit":{"description":"How to format the value, which `type` alone cannot say: \"currency\" (in the deal's currency), \"percentage\" (already in percent points), \"count\", \"ratio\" (a 0-1 quotient), \"days\", \"text\". Null for an attribute with no declared unit - print the raw value","enum":["currency","percentage","count","ratio","days","years","text",null],"nullable":true},"value_set":{"description":"The finite vocabulary the value is drawn from, so the editor can offer a dropdown instead of free text. Keys into the /policy_value_sets response. Null for free text","enum":["us_state","naics_industry","naics_code","restricted_industries","merchant","crm_decline_reason","iso_source_name","business_entity_type","fraud_network_finding","broker_velocity","broker_velocity_signal","fraud_network_scan_status","fraud_network_classification","industry_category","datamerch_note_category","complete_months",null],"nullable":true}},"required":["check_options","enricher","library_group","parser","source","sources"],"type":"object"},"CompanyAttributeSchema":{"properties":{"description":{"description":"What the value means, written for the customer reading their own rules - the status words a position count admits, what a window is anchored to, when the value is missing rather than zero. Null for a label with no curated description yet. Present only for accounts on policy versions","nullable":true,"readOnly":true,"type":"string"},"display_name":{"description":"The attribute's human-readable name, with its tier as a qualifier, e.g. \"NSF days last 30 days\", \"Open judgment total amount (12 months, background check, owner 1)\". Parameters are not part of the name - render them from `parameters` where the context wants them. Derived, so it may be reworded. Present only for accounts on policy versions","readOnly":true,"type":"string"},"label":{"description":"The attribute's stable identifier, which a check refers to and a CRM field maps onto. Namespaced with \":\" where a source groups its attributes, e.g. \"nsf_days_last_30_days\", \"BackgroundCheck:owner_1:has_felony\"","type":"string"},"parameter_options":{"description":"Every value each of the label's parameters accepts, e.g. {\"product_type\": [\"mca\", \"line_of_credit\", \"all\"], \"status\": [\"active_only\", \"open\", \"all\"]}. Null for an unparametrised label. Missing keys use their declared defaults","readOnly":true},"parameters":{"additionalProperties":{"oneOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"description":"Which variant of a parametrised label this is, e.g. {\"product_type\": \"mca\", \"status\": \"active_only\"}. A setting marked `multiple` in its parameter definition may hold a list of options. Null for a label that takes no parameters, and null on a catalogue listing, where parameter definitions give the choices instead","nullable":true,"type":"object"},"type":{"description":"The value's type, which decides what a check on it can compare: \"int\", \"float\", \"decimal\", \"string\", \"date\", \"datetime\", \"bool\"","enum":["float","int","decimal","string","date","datetime","bool"]},"unit":{"description":"How to format the value, which `type` alone cannot say: \"currency\" (in the deal's currency), \"percentage\" (already in percent points), \"count\", \"ratio\" (a 0-1 quotient), \"days\", \"text\". Null for an attribute with no declared unit - print the raw value","enum":["currency","percentage","count","ratio","days","years","text",null],"nullable":true},"value_set":{"description":"The finite vocabulary the value is drawn from, so the editor can offer a dropdown instead of free text. Keys into the /policy_value_sets response. Null for free text","enum":["us_state","naics_industry","naics_code","restricted_industries","merchant","crm_decline_reason","iso_source_name","business_entity_type","fraud_network_finding","broker_velocity","broker_velocity_signal","fraud_network_scan_status","fraud_network_classification","industry_category","datamerch_note_category","complete_months",null],"nullable":true}},"type":"object"},"CompanyAttributeValue":{"properties":{"evidence":{"allOf":[{"$ref":"#/components/schemas/AttributeEvidence"}],"description":"Where the value came from, so a reviewer can see what produced it - the source records for a background-check finding, the positions behind a holdback. Null for attributes that cite nothing","nullable":true},"missing_reason":{"allOf":[{"$ref":"#/components/schemas/MissingReason"}],"description":"Why the value is missing. Absent when the value is present or the reason is unknown","readOnly":true},"period":{"allOf":[{"$ref":"#/components/schemas/AttributePeriod"}],"description":"The dates the value read. Absent for attributes with no date window","readOnly":true},"value":{"description":"The value, stringified whatever the attribute's type: \"3\", \"12500.00\", \"True\", \"1999-01-01\". Null when the deal has no data for this attribute","nullable":true,"type":"string"}},"type":"object"},"CompanyAttributeValueSchema":{"properties":{"attribute":{"$ref":"#/components/schemas/CompanyAttributeSchema"},"availability":{"enum":["available","partially_available","not_available"]},"value":{}},"type":"object"},"CompanyId":{"properties":{"country":{"description":"Issuing country, as a two-letter code.","nullable":true,"type":"string"},"type":{"description":"Type of business identifier. The prefix is the issuing country: `us_ein` (US Employer Identification Number), `us_taxpayer_number` (US state taxpayer number), `uk_company_number` (UK Companies House number), `duns` (D-U-N-S number, worldwide) or `vat` (VAT number).","enum":["us_ein","us_taxpayer_number","duns","uk_company_number","vat"]},"value":{"description":"The identifier.","type":"string"},"verified":{"description":"What an authority said when asked about this identifier under this business's name: `matched` or `not_matched`. Null when no check was run for it, and always null on the identifier inside a `tax_id_verifications` row, which is the check itself.","enum":["matched","not_matched",null],"nullable":true}},"type":"object"},"CompanyIdWrite":{"additionalProperties":false,"properties":{"country":{"description":"Issuing country, as a two-letter code.","nullable":true,"type":"string"},"type":{"description":"Type of business identifier. The prefix is the issuing country: `us_ein` (US Employer Identification Number), `us_taxpayer_number` (US state taxpayer number), `uk_company_number` (UK Companies House number), `duns` (D-U-N-S number, worldwide) or `vat` (VAT number).","enum":["us_ein","us_taxpayer_number","duns","uk_company_number","vat"]},"value":{"description":"The identifier.","type":"string"}},"type":"object"},"CompanyName":{"properties":{"effective_from":{"description":"Date the name started, when a source states one.","format":"date","nullable":true,"type":"string"},"effective_to":{"description":"Date the name ended, when a source states one.","format":"date","nullable":true,"type":"string"},"raw":{"description":"The name exactly as the source wrote it, including its legal form.","type":"string"},"type":{"description":"What type of name it is: `legal` is the name a source answers with, `former` a name a registry held before the current one, `dba` a name the company trades under, and `trade` a name a report lists as an alternate.","enum":["legal","dba","former","trade"]}},"type":"object"},"CompanyOverviewLayoutSchema":{"properties":{"group_name":{"type":"string"},"id":{"description":"A unique id used to reference the group","type":"string"},"widgets":{"items":{"$ref":"#/components/schemas/Widget"},"type":"array"}},"required":["group_name","id","widgets"],"type":"object"},"ComparedVariable":{"properties":{"attribute_label":{"type":"string"},"parameters":{"additionalProperties":{"oneOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"},{"$ref":"#/components/schemas/TableColumn"}]},"description":"Settings by name: a string, a list of strings, or {\"lookup\": {\"table_heron_id\", \"column_id\"}} to read the setting from a lookup table column, per deal","nullable":true,"type":"object"}},"required":["attribute_label"],"type":"object"},"Components":{"properties":{"city_name":{"nullable":true,"type":"string"},"default_city_name":{"nullable":true,"type":"string"},"delivery_point":{"nullable":true,"type":"string"},"delivery_point_check_digit":{"nullable":true,"type":"string"},"plus4_code":{"nullable":true,"type":"string"},"primary_number":{"nullable":true,"type":"string"},"state_abbreviation":{"nullable":true,"type":"string"},"street_name":{"nullable":true,"type":"string"},"street_suffix":{"nullable":true,"type":"string"},"zipcode":{"nullable":true,"type":"string"}},"type":"object"},"CompositeCheck":{"properties":{"auto_decline":{"default":false,"type":"boolean"},"checks":{"items":{"$ref":"#/components/schemas/Check"},"type":"array"},"decline_code":{"description":"The CRM's identifier for this decline reason, e.g. a LendSaas reason id. Left unset, the CRM sync falls back to this check's decline_description.","nullable":true,"type":"string"},"decline_description":{"nullable":true,"type":"string"},"email_template_name":{"nullable":true,"type":"string"},"ignore_metric_availability":{"default":false,"type":"boolean"},"is_mandatory":{"default":false,"type":"boolean"},"max_failing":{"nullable":true,"type":"integer"},"on_failure":{"default":"fail","enum":["fail","review_required"]},"on_missing":{"default":"missing_data","description":"What the check reports when it would report missing data: `missing_data` (the default), `fail` or `pass`. A check saved with an older flag (`pass_if_value_missing` on a date-delta check) reads as the setting it stands for. With `ignore_metric_availability` or `pass_if_value_missing` set, only that setting is accepted","enum":["missing_data","fail","pass"]},"pass_description":{"nullable":true,"type":"string"},"transaction_scope":{"allOf":[{"$ref":"#/components/schemas/TransactionScope"}],"nullable":true},"type":{"enum":["AND","OR","AT_MOST_FAILING"]}},"type":"object"},"ConditionEvaluation":{"properties":{"attribute_value":{"allOf":[{"$ref":"#/components/schemas/CompanyAttributeValue"}],"nullable":true,"readOnly":true},"check":{"allOf":[{"$ref":"#/components/schemas/Check"}],"readOnly":true},"matched":{"description":"Whether the condition passed and chose its branch. One that did not is not a failed check","readOnly":true}},"type":"object"},"CorporateFilingHistoryEntrySchema":{"properties":{"history_code":{"description":"Code assigned to the filing event by the source.","nullable":true,"type":"string"},"history_desc":{"description":"Source-provided description of the filing event.","nullable":true,"type":"string"}},"type":"object"},"CorporateRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"annual_report_file_date":{"description":"Date the filing office received the annual report; null when unavailable.","format":"date","nullable":true,"type":"string"},"associated_business_count":{"description":"Number of associated businesses in the source business group.","type":"integer"},"business_duns":{"description":"DUNS number assigned to the filed business; null when unavailable.","nullable":true,"type":"string"},"business_group":{"description":"Source grouping identifier for associated businesses.","nullable":true,"type":"string"},"business_name":{"description":"The registered business name.","nullable":true,"type":"string"},"business_type":{"description":"Source-provided business type on the filing; the first value when the source reports several.","nullable":true,"type":"string"},"corp_lifetime":{"description":"The term the registration was filed for, e.g. PERPETUAL; null when unavailable.","nullable":true,"type":"string"},"corp_status":{"description":"Filing status classification: active, inactive, dissolved, failed, or unknown. Failed covers forfeited, revoked, suspended, and administratively dissolved filings.","enum":["active","dissolved","inactive","failed","unknown"]},"corporation_number":{"description":"Corporation number the filing office assigned to the entity; null when the source does not report one.","nullable":true,"type":"string"},"corporation_type":{"description":"Source-provided corporation classification, separate from the filing's business type; null when unavailable.","nullable":true,"type":"string"},"duration":{"description":"Source-provided duration date or term; null when unavailable.","nullable":true,"type":"string"},"federal_emp_id":{"description":"Federal employer identification number listed on the filing.","nullable":true,"type":"string"},"filing_date":{"description":"Filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"filing_history":{"description":"Ordered filing events recorded for this corporate record.","items":{"$ref":"#/components/schemas/CorporateFilingHistoryEntrySchema"},"type":"array"},"filing_office_duns":{"description":"Source-provided filing DUNS number; null when unavailable.","nullable":true,"type":"string"},"filing_office_name":{"description":"Office where the filing was recorded.","nullable":true,"type":"string"},"filing_state":{"description":"State where the filing was recorded.","nullable":true,"type":"string"},"filing_state_name":{"description":"Full name of the filing state.","nullable":true,"type":"string"},"former_names":{"description":"Former business names listed on the filing.","items":{"type":"string"},"type":"array"},"franchise_status":{"description":"Franchise-tax standing the filing office reports, e.g. CURRENT; null when unavailable.","nullable":true,"type":"string"},"has_officers":{"description":"True when the filing lists officers.","type":"boolean"},"incorporation_date":{"description":"Date the entity was incorporated.","format":"date","nullable":true,"type":"string"},"is_failed":{"description":"True when the corporate filing status is failed.","type":"boolean"},"llc_type":{"description":"How the registry classifies the LLC, e.g. MEMBER MANAGED; null when unavailable.","nullable":true,"type":"string"},"notes":{"description":"Source-provided note about the filing; null when unavailable.","nullable":true,"type":"string"},"officer_count":{"description":"Number of officers listed on the filing.","type":"integer"},"officer_names":{"description":"Names of officers listed on the filing.","items":{"type":"string"},"type":"array"},"owner_is_officer":{"description":"True when the application's named owner appears among the filing's officers.","type":"boolean"},"ownership_changed":{"description":"True when officers changed across the entity's filings.","type":"boolean"},"registered_agent":{"description":"Registered agent listed on the filing.","nullable":true,"type":"string"},"registered_agent_address":{"description":"Address of the registered agent listed on the filing.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source":{"description":"Source that supplied the record.","nullable":true,"type":"string"},"state_filing_number":{"description":"Filing number recorded on the filing; null when the source does not report one.","nullable":true,"type":"string"},"state_of_incorporation":{"description":"State where the entity was incorporated.","nullable":true,"type":"string"},"status":{"description":"Source-provided corporate filing status.","nullable":true,"type":"string"},"status_date":{"description":"Date the source recorded the corporate status; null when unavailable.","format":"date","nullable":true,"type":"string"},"status_effective_date":{"description":"Date the filing became effective; null when unavailable.","format":"date","nullable":true,"type":"string"}},"type":"object"},"CoverageResponseSchema":{"properties":{"fields":{"additionalProperties":{"items":{"enum":["tin","sos","court","background_check","web_presence","web_search","bank_statement","void_check","pnl_statement","tax_return","driving_licence","xactus","industry_prediction","generic_industry_prediction","industry_prediction_v2","datamerch","business_profile_search","api","manual","broker_submission","crm","application","email"]},"type":"array"},"description":"Per field, the sources outside the deal whose reports state it, best authority first, keyed as the verification response keys the field (an owner's as `owner.ssn`). Empty where no source states the field, so nothing can compare it against the claim.","type":"object"}},"type":"object"},"CreateBrokerFunderApiKeySchema":{"properties":{"email":{"description":"Broker email address","format":"email","type":"string"}},"required":["email"],"type":"object"},"CreateBrokerSubmissionSchema":{"properties":{"name":{"description":"The name of the submission being made, this is purely for user reference.","minLength":10,"type":"string"}},"required":["name"],"type":"object"},"CreateEndUserEntityAttributeSchema":{"properties":{"attribute_description":{"type":"string"},"attribute_name":{"type":"string"},"attribute_type":{"enum":["float","int","decimal","string","date","datetime","bool"]},"display_order":{"type":"integer"},"is_dedupe_key":{"default":false,"type":"boolean"},"reconciliation_config":{"additionalProperties":{},"type":"object"},"reconciliation_strategy":{"enum":["sort_order","llm","comparison","concatenate_lists"]}},"required":["attribute_name"],"type":"object"},"CreateEndUserEntityAttributeSourceSchema":{"properties":{"sort_order":{"type":"integer"},"source_config":{"additionalProperties":{},"type":"object"},"source_type":{"enum":["parsed_end_user_file","api","rel_6","end_user_enricher","company_attribute","static_value","end_user_query","broker_submission_api","crm"]}},"type":"object"},"CreateEndUserEntitySchema":{"properties":{"display_order":{"type":"integer"},"entity_description":{"type":"string"},"entity_name":{"type":"string"},"entity_post_processor_configs":{"default":[],"items":{"additionalProperties":{},"type":"object"},"type":"array"},"is_list":{"type":"boolean"},"saved_query_heron_id":{"nullable":true,"type":"string"}},"required":["entity_name"],"type":"object"},"CreateFileRenameRuleSchema":{"properties":{"end_user_file_class":{"type":"string"},"file_name_template":{"type":"string"},"is_enabled":{"type":"boolean"},"variables":{"items":{"$ref":"#/components/schemas/VariableDefinition"},"type":"array"}},"required":["end_user_file_class","file_name_template","is_enabled"],"type":"object"},"CreateInteractionLogSchema":{"properties":{"attributes":{"additionalProperties":{},"description":"Arbitrary JSON attributes","nullable":true,"type":"object"},"end_user_heron_id":{"description":"Heron ID of the end user","nullable":true,"type":"string"},"name":{"description":"Interaction name/type","maxLength":256,"minLength":1,"type":"string"},"session_uuid":{"description":"PostHog session UUID","maxLength":36,"minLength":1,"type":"string"}},"required":["name","session_uuid"],"type":"object"},"CreateKeySchema":{"properties":{"name":{"description":"A descriptive name for the key","maxLength":128,"minLength":1,"type":"string"}},"required":["name"],"type":"object"},"CreateMcpEndpointSchema":{"additionalProperties":false,"properties":{"label":{"description":"Human-readable label for this endpoint","maxLength":128,"minLength":1,"type":"string"},"require_request_secret":{"default":false,"description":"Issue a secret that every MCP request to this endpoint must carry in its X-Auth-Token header. It is returned once, in this response.","type":"boolean"}},"required":["label"],"type":"object"},"CreditScoreCheck":{"properties":{"chosen_by":{"description":"The source `value` was taken from: the first this field prefers that stated anything. Not the source the others are read against, which `source_to_verify` names. Null when nothing stated the field.","enum":["tin","sos","court","background_check","web_presence","web_search","bank_statement","void_check","pnl_statement","tax_return","driving_licence","xactus","industry_prediction","generic_industry_prediction","industry_prediction_v2","datamerch","business_profile_search","api","manual","broker_submission","crm","application","email",null],"nullable":true},"chosen_score":{"allOf":[{"$ref":"#/components/schemas/ChosenCreditScore"}],"description":"The score `value` was taken from, with its bureau, model and date. Two sources agree when they state the same number. Null when no source stated a score.","nullable":true},"label":{"description":"The field as a reader reads it, such as `Legal business name`.","type":"string"},"source_to_verify":{"description":"The source that is being verified.","enum":["tin","sos","court","background_check","web_presence","web_search","bank_statement","void_check","pnl_statement","tax_return","driving_licence","xactus","industry_prediction","generic_industry_prediction","industry_prediction_v2","datamerch","business_profile_search","api","manual","broker_submission","crm","application","email",null],"nullable":true},"sources":{"description":"One line per source, in the order this field prefers them.","items":{"$ref":"#/components/schemas/SourceVerification"},"type":"array"},"state":{"description":"`verified` when a source independent of the deal confirms what it claimed, `conflict` when any source contradicts it, the deal's own other channels included. `not_verified` means nothing independent confirmed it: nothing else spoke to the claim, or only another channel of the deal restated it, or the deal claimed nothing to check. `blank` means nobody stated a value at all.","enum":["verified","conflict","not_verified","blank"]},"value":{"description":"The best answer the sources hold: the value of the first one this field prefers that stated anything. Not what the deal claimed, which `state` reports on instead, so a field can show a registry's value and read `conflict`. Null when no source stated the field.","nullable":true,"type":"string"}},"type":"object"},"CreditScoreWrite":{"additionalProperties":false,"properties":{"bureau":{"description":"Credit bureau.","enum":["equifax","experian","transunion","unknown",null],"nullable":true},"heron_id":{"description":"The `heron_id` of the score from `GET`. Leave it out to add a new one.","nullable":true,"type":"string"},"score":{"description":"The score.","type":"integer"},"score_model":{"description":"Scoring model, for example `fico`.","enum":["fico","vantagescore","unknown",null],"nullable":true},"score_version_raw":{"description":"Scoring model version, for example `8`.","nullable":true,"type":"string"},"scored_on":{"description":"Date of the score.","format":"date","nullable":true,"type":"string"}},"required":["score"],"type":"object"},"CriminalChargeEntrySchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"actual_release_date":{"description":"Actual release date from custody; null when unavailable.","format":"date","nullable":true,"type":"string"},"arrest_date":{"description":"Date of the arrest; null when unavailable.","format":"date","nullable":true,"type":"string"},"arresting_agency":{"description":"Arresting agency named on the source record; null when unavailable.","nullable":true,"type":"string"},"case_number":{"description":"Court case reference; null when unavailable.","nullable":true,"type":"string"},"case_status":{"description":"The court's live case status, such as DISCHARGE or PENDING. Can resolve a case even when no disposition is recorded; null when unavailable.","nullable":true,"type":"string"},"case_status_date":{"description":"Date of the case status; null when unavailable.","format":"date","nullable":true,"type":"string"},"categories":{"description":"Offence classifications: fraud, violent, dui, drug, burglary, domestic_violence, child_related, sex_offense, murder_homicide, fiduciary, animal_cruelty, theft, tax, bribery_corruption, extortion, racketeering, terrorism, human_trafficking, explosives, hijacking, arson, robbery, aggravated_assault, kidnapping, murder, voluntary_manslaughter, involuntary_manslaughter, rape, child_abuse, incest, mayhem, animal_fighting, drug_trafficking, firearms_trafficking, inchoate, or other.","items":{"enum":["violent","murder_homicide","domestic_violence","burglary","fraud","sex_offense","child_related","fiduciary","animal_cruelty","drug","dui","theft","tax","bribery_corruption","extortion","racketeering","terrorism","human_trafficking","explosives","hijacking","arson","other","robbery","aggravated_assault","kidnapping","murder","voluntary_manslaughter","involuntary_manslaughter","rape","child_abuse","incest","mayhem","animal_fighting","drug_trafficking","firearms_trafficking","inchoate"]},"type":"array"},"category":{"description":"Source-provided offence category string.","nullable":true,"type":"string"},"court_county":{"description":"County of the court; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Court name; null when unavailable.","nullable":true,"type":"string"},"crime_date":{"description":"Date the offence occurred, distinct from the case filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"disposition":{"description":"Case or charge outcome; null when unavailable.","nullable":true,"type":"string"},"disposition_date":{"description":"Date of the disposition; null when unavailable.","format":"date","nullable":true,"type":"string"},"filed_date":{"description":"Case filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"fine_amount":{"description":"Fine imposed as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"grade":{"description":"Offence grade: felony, misdemeanor, petty_misdemeanor, infraction, or unknown.","enum":["felony","misdemeanor","petty_misdemeanor","infraction","unknown"]},"is_dismissed":{"description":"True when the case was dismissed or not prosecuted.","type":"boolean"},"is_felony":{"description":"True when any charge on the case is a felony.","type":"boolean"},"max_sentence_years":{"description":"Source-recorded maximum sentence in years, not time served; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"number_of_counts":{"description":"Number of counts; null when unavailable.","nullable":true,"type":"integer"},"offense":{"description":"Offence as recorded on the source document.","nullable":true,"type":"string"},"offense_location":{"description":"Where the offence took place; null when unavailable.","nullable":true,"type":"string"},"parole_status":{"description":"Parole status; null when unavailable.","nullable":true,"type":"string"},"plea":{"description":"The plea entered - the changed plea when one exists, else the original; null when unavailable.","nullable":true,"type":"string"},"plea_date":{"description":"Date of the plea; null when unavailable.","format":"date","nullable":true,"type":"string"},"probation_end_date":{"description":"Probation end date - the actual end when recorded, else the scheduled end; null when unavailable.","format":"date","nullable":true,"type":"string"},"probation_violation":{"description":"Probation violation as recorded on the source; null when unavailable.","nullable":true,"type":"string"},"projected_release_date":{"description":"Projected release date from custody, falling back to the tentative then maximum release date; null when unavailable.","format":"date","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"sentence":{"description":"Sentence text; null when unavailable.","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"severity_text":{"description":"Source-provided severity string.","nullable":true,"type":"string"},"sex_offender_registry_id":{"description":"Public sex offender registry identifier; null when unavailable.","nullable":true,"type":"string"},"source_entry_id":{"description":"Stable reference for the underlying source row; null when unavailable.","nullable":true,"type":"string"},"statute_code":{"description":"Statute code; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"CriminalRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"actual_release_date":{"description":"Actual release date from custody; null when unavailable.","format":"date","nullable":true,"type":"string"},"arrest_date":{"description":"Date of the arrest; null when unavailable.","format":"date","nullable":true,"type":"string"},"arresting_agency":{"description":"Arresting agency named on the source record; null when unavailable.","nullable":true,"type":"string"},"case_number":{"description":"Court case reference; null when unavailable.","nullable":true,"type":"string"},"case_status":{"description":"The court's live case status, such as DISCHARGE or PENDING. Can resolve a case even when no disposition is recorded; null when unavailable.","nullable":true,"type":"string"},"case_status_date":{"description":"Date of the case status; null when unavailable.","format":"date","nullable":true,"type":"string"},"categories":{"description":"Offence classifications: fraud, violent, dui, drug, burglary, domestic_violence, child_related, sex_offense, murder_homicide, fiduciary, animal_cruelty, theft, tax, bribery_corruption, extortion, racketeering, terrorism, human_trafficking, explosives, hijacking, arson, robbery, aggravated_assault, kidnapping, murder, voluntary_manslaughter, involuntary_manslaughter, rape, child_abuse, incest, mayhem, animal_fighting, drug_trafficking, firearms_trafficking, inchoate, or other.","items":{"enum":["violent","murder_homicide","domestic_violence","burglary","fraud","sex_offense","child_related","fiduciary","animal_cruelty","drug","dui","theft","tax","bribery_corruption","extortion","racketeering","terrorism","human_trafficking","explosives","hijacking","arson","other","robbery","aggravated_assault","kidnapping","murder","voluntary_manslaughter","involuntary_manslaughter","rape","child_abuse","incest","mayhem","animal_fighting","drug_trafficking","firearms_trafficking","inchoate"]},"type":"array"},"category":{"description":"Source-provided offence category string.","nullable":true,"type":"string"},"court_county":{"description":"County of the court; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Court name; null when unavailable.","nullable":true,"type":"string"},"crime_date":{"description":"Date the offence occurred, distinct from the case filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"detail":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckRecordDetail"}],"description":"Only populated when include_section_detail=true is passed on the request","nullable":true},"disposition":{"description":"Case or charge outcome; null when unavailable.","nullable":true,"type":"string"},"disposition_date":{"description":"Date of the disposition; null when unavailable.","format":"date","nullable":true,"type":"string"},"entry_count":{"description":"Number of underlying source entries combined into this record.","type":"integer"},"filed_date":{"description":"Case filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"fine_amount":{"description":"Fine imposed as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"grade":{"description":"Offence grade: felony, misdemeanor, petty_misdemeanor, infraction, or unknown.","enum":["felony","misdemeanor","petty_misdemeanor","infraction","unknown"]},"is_dismissed":{"description":"True when the case was dismissed or not prosecuted.","type":"boolean"},"is_felony":{"description":"True when any charge on the case is a felony.","type":"boolean"},"is_unclassified":{"description":"True when the offence could not be classified.","type":"boolean"},"max_sentence_years":{"description":"Source-recorded maximum sentence in years, not time served; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"number_of_counts":{"description":"Number of counts; null when unavailable.","nullable":true,"type":"integer"},"offense":{"description":"Offence as recorded on the source document.","nullable":true,"type":"string"},"offense_location":{"description":"Where the offence took place; null when unavailable.","nullable":true,"type":"string"},"parole_status":{"description":"Parole status; null when unavailable.","nullable":true,"type":"string"},"plea":{"description":"The plea entered - the changed plea when one exists, else the original; null when unavailable.","nullable":true,"type":"string"},"plea_date":{"description":"Date of the plea; null when unavailable.","format":"date","nullable":true,"type":"string"},"probation_end_date":{"description":"Probation end date - the actual end when recorded, else the scheduled end; null when unavailable.","format":"date","nullable":true,"type":"string"},"probation_violation":{"description":"Probation violation as recorded on the source; null when unavailable.","nullable":true,"type":"string"},"projected_release_date":{"description":"Projected release date from custody, falling back to the tentative then maximum release date; null when unavailable.","format":"date","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"sentence":{"description":"Sentence text; null when unavailable.","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"severity_text":{"description":"Source-provided severity string.","nullable":true,"type":"string"},"sex_offender_registry_id":{"description":"Public sex offender registry identifier; null when unavailable.","nullable":true,"type":"string"},"shared_case_key":{"description":"Stable key for a record that appears on both owner and business reports; null when not shared.","nullable":true,"type":"string"},"shared_relationship":{"description":"Where the shared record also appears: also_on_business or also_on_owner; null when not shared.","enum":["also_on_owner","also_on_business",null],"nullable":true,"type":"string"},"source_entries":{"description":"Underlying source rows combined into this record.","items":{"$ref":"#/components/schemas/CriminalChargeEntrySchema"},"type":"array"},"source_entry_id":{"description":"Stable reference for the underlying source row; null when unavailable.","nullable":true,"type":"string"},"source_entry_ids":{"description":"References for the underlying source rows combined into this record.","items":{"type":"string"},"type":"array"},"statute_code":{"description":"Statute code; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"CriminalSectionEntrySchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"actual_release_date":{"description":"Actual release date from custody; null when unavailable.","format":"date","nullable":true,"type":"string"},"arrest_date":{"description":"Date of the arrest; null when unavailable.","format":"date","nullable":true,"type":"string"},"arresting_agency":{"description":"Arresting agency named on the source record; null when unavailable.","nullable":true,"type":"string"},"bail_amount":{"description":"Bail amount on this entry as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"booking_number":{"description":"Booking reference on this entry; null when unavailable.","nullable":true,"type":"string"},"case_number":{"description":"Court case reference; null when unavailable.","nullable":true,"type":"string"},"case_status":{"description":"The court's live case status, such as DISCHARGE or PENDING. Can resolve a case even when no disposition is recorded; null when unavailable.","nullable":true,"type":"string"},"case_status_date":{"description":"Date of the case status; null when unavailable.","format":"date","nullable":true,"type":"string"},"categories":{"description":"Offence classifications: fraud, violent, dui, drug, burglary, domestic_violence, child_related, sex_offense, murder_homicide, fiduciary, animal_cruelty, theft, tax, bribery_corruption, extortion, racketeering, terrorism, human_trafficking, explosives, hijacking, arson, robbery, aggravated_assault, kidnapping, murder, voluntary_manslaughter, involuntary_manslaughter, rape, child_abuse, incest, mayhem, animal_fighting, drug_trafficking, firearms_trafficking, inchoate, or other.","items":{"enum":["violent","murder_homicide","domestic_violence","burglary","fraud","sex_offense","child_related","fiduciary","animal_cruelty","drug","dui","theft","tax","bribery_corruption","extortion","racketeering","terrorism","human_trafficking","explosives","hijacking","arson","other","robbery","aggravated_assault","kidnapping","murder","voluntary_manslaughter","involuntary_manslaughter","rape","child_abuse","incest","mayhem","animal_fighting","drug_trafficking","firearms_trafficking","inchoate"]},"type":"array"},"category":{"description":"Source-provided offence category string.","nullable":true,"type":"string"},"court_county":{"description":"County of the court; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Court name; null when unavailable.","nullable":true,"type":"string"},"crime_date":{"description":"Date the offence occurred, distinct from the case filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"disposition":{"description":"Case or charge outcome; null when unavailable.","nullable":true,"type":"string"},"disposition_date":{"description":"Date of the disposition; null when unavailable.","format":"date","nullable":true,"type":"string"},"filed_date":{"description":"Case filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"fine_amount":{"description":"Fine imposed as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"grade":{"description":"Offence grade: felony, misdemeanor, petty_misdemeanor, infraction, or unknown.","enum":["felony","misdemeanor","petty_misdemeanor","infraction","unknown"]},"is_dismissed":{"description":"True when the case was dismissed or not prosecuted.","type":"boolean"},"is_felony":{"description":"True when any charge on the case is a felony.","type":"boolean"},"max_sentence_years":{"description":"Source-recorded maximum sentence in years, not time served; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"mugshot_record_id":{"description":"Stable identifier used to request this entry's mug shot; null when it has none.","nullable":true,"type":"string"},"number_of_counts":{"description":"Number of counts; null when unavailable.","nullable":true,"type":"integer"},"offense":{"description":"Offence as recorded on the source document.","nullable":true,"type":"string"},"offense_location":{"description":"Where the offence took place; null when unavailable.","nullable":true,"type":"string"},"parole_status":{"description":"Parole status; null when unavailable.","nullable":true,"type":"string"},"plea":{"description":"The plea entered - the changed plea when one exists, else the original; null when unavailable.","nullable":true,"type":"string"},"plea_date":{"description":"Date of the plea; null when unavailable.","format":"date","nullable":true,"type":"string"},"probation_end_date":{"description":"Probation end date - the actual end when recorded, else the scheduled end; null when unavailable.","format":"date","nullable":true,"type":"string"},"probation_violation":{"description":"Probation violation as recorded on the source; null when unavailable.","nullable":true,"type":"string"},"projected_release_date":{"description":"Projected release date from custody, falling back to the tentative then maximum release date; null when unavailable.","format":"date","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"sentence":{"description":"Sentence text; null when unavailable.","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"severity_text":{"description":"Source-provided severity string.","nullable":true,"type":"string"},"sex_offender_registry_id":{"description":"Public sex offender registry identifier; null when unavailable.","nullable":true,"type":"string"},"source_entry_id":{"description":"Stable reference for the underlying source row; null when unavailable.","nullable":true,"type":"string"},"state":{"description":"State this entry was reported in; null when unavailable.","nullable":true,"type":"string"},"statute_code":{"description":"Statute code; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"CriminalSectionRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"actual_release_date":{"description":"Actual release date from custody; null when unavailable.","format":"date","nullable":true,"type":"string"},"arrest_date":{"description":"Date of the arrest; null when unavailable.","format":"date","nullable":true,"type":"string"},"arrest_time":{"description":"Time of the arrest; null when unavailable.","nullable":true,"type":"string"},"arresting_agency":{"description":"Arresting agency named on the source record; null when unavailable.","nullable":true,"type":"string"},"bail_amount":{"description":"Bail amount on the record as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"booking_date":{"description":"Date of the booking; null when unavailable.","format":"date","nullable":true,"type":"string"},"booking_location":{"description":"Booking location; null when unavailable.","nullable":true,"type":"string"},"booking_number":{"description":"Booking reference; null when unavailable.","nullable":true,"type":"string"},"booking_time":{"description":"Time of the booking; null when unavailable.","nullable":true,"type":"string"},"case_number":{"description":"Court case reference; null when unavailable.","nullable":true,"type":"string"},"case_status":{"description":"The court's live case status, such as DISCHARGE or PENDING. Can resolve a case even when no disposition is recorded; null when unavailable.","nullable":true,"type":"string"},"case_status_date":{"description":"Date of the case status; null when unavailable.","format":"date","nullable":true,"type":"string"},"categories":{"description":"Offence classifications: fraud, violent, dui, drug, burglary, domestic_violence, child_related, sex_offense, murder_homicide, fiduciary, animal_cruelty, theft, tax, bribery_corruption, extortion, racketeering, terrorism, human_trafficking, explosives, hijacking, arson, robbery, aggravated_assault, kidnapping, murder, voluntary_manslaughter, involuntary_manslaughter, rape, child_abuse, incest, mayhem, animal_fighting, drug_trafficking, firearms_trafficking, inchoate, or other.","items":{"enum":["violent","murder_homicide","domestic_violence","burglary","fraud","sex_offense","child_related","fiduciary","animal_cruelty","drug","dui","theft","tax","bribery_corruption","extortion","racketeering","terrorism","human_trafficking","explosives","hijacking","arson","other","robbery","aggravated_assault","kidnapping","murder","voluntary_manslaughter","involuntary_manslaughter","rape","child_abuse","incest","mayhem","animal_fighting","drug_trafficking","firearms_trafficking","inchoate"]},"type":"array"},"category":{"description":"Source-provided offence category string.","nullable":true,"type":"string"},"court_county":{"description":"County of the court; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Court name; null when unavailable.","nullable":true,"type":"string"},"crime_date":{"description":"Date the offence occurred, distinct from the case filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"detail":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckRecordDetail"}],"description":"Only populated when include_section_detail=true is passed on the request","nullable":true},"disposition":{"description":"Case or charge outcome; null when unavailable.","nullable":true,"type":"string"},"disposition_date":{"description":"Date of the disposition; null when unavailable.","format":"date","nullable":true,"type":"string"},"entry_count":{"description":"Number of underlying source entries combined into this record.","type":"integer"},"filed_date":{"description":"Case filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"fine_amount":{"description":"Fine imposed as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"grade":{"description":"Offence grade: felony, misdemeanor, petty_misdemeanor, infraction, or unknown.","enum":["felony","misdemeanor","petty_misdemeanor","infraction","unknown"]},"is_dismissed":{"description":"True when the case was dismissed or not prosecuted.","type":"boolean"},"is_felony":{"description":"True when any charge on the case is a felony.","type":"boolean"},"is_unclassified":{"description":"True when the offence could not be classified.","type":"boolean"},"max_sentence_years":{"description":"Source-recorded maximum sentence in years, not time served; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"mugshot_record_id":{"description":"Stable identifier used to request this record's mug shot; null when no mug shot is available.","nullable":true,"type":"string"},"number_of_counts":{"description":"Number of counts; null when unavailable.","nullable":true,"type":"integer"},"offense":{"description":"Offence as recorded on the source document.","nullable":true,"type":"string"},"offense_county":{"description":"County where the offence occurred; null when unavailable.","nullable":true,"type":"string"},"offense_location":{"description":"Where the offence took place; null when unavailable.","nullable":true,"type":"string"},"parole_status":{"description":"Parole status; null when unavailable.","nullable":true,"type":"string"},"plea":{"description":"The plea entered - the changed plea when one exists, else the original; null when unavailable.","nullable":true,"type":"string"},"plea_date":{"description":"Date of the plea; null when unavailable.","format":"date","nullable":true,"type":"string"},"probation_end_date":{"description":"Probation end date - the actual end when recorded, else the scheduled end; null when unavailable.","format":"date","nullable":true,"type":"string"},"probation_violation":{"description":"Probation violation as recorded on the source; null when unavailable.","nullable":true,"type":"string"},"projected_release_date":{"description":"Projected release date from custody, falling back to the tentative then maximum release date; null when unavailable.","format":"date","nullable":true,"type":"string"},"record_type":{"description":"Record class: Criminal case or Arrest record.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"sentence":{"description":"Sentence text; null when unavailable.","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"severity_text":{"description":"Source-provided severity string.","nullable":true,"type":"string"},"sex_offender_registry_id":{"description":"Public sex offender registry identifier; null when unavailable.","nullable":true,"type":"string"},"shared_case_key":{"description":"Stable key for a record that appears on both owner and business reports; null when not shared.","nullable":true,"type":"string"},"shared_relationship":{"description":"Where the shared record also appears: also_on_business or also_on_owner; null when not shared.","enum":["also_on_owner","also_on_business",null],"nullable":true,"type":"string"},"source_entries":{"description":"Underlying source rows combined into this record: one per charge for a court case, one per reported arrest entry for an arrest.","items":{"$ref":"#/components/schemas/CriminalSectionEntrySchema"},"type":"array"},"source_entry_id":{"description":"Stable reference for the underlying source row; null when unavailable.","nullable":true,"type":"string"},"source_entry_ids":{"description":"References for the underlying source rows combined into this record.","items":{"type":"string"},"type":"array"},"state":{"description":"State the arrest record was reported in; null when unavailable.","nullable":true,"type":"string"},"statute_code":{"description":"Statute code; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"CrmConfig":{"properties":{"child_file_filtering_enabled":{"default":true,"description":"Whether to filter out child files (files that have a parent file)","type":"boolean"},"data_source_accounts_config":{"allOf":[{"$ref":"#/components/schemas/CrmObjectConfig"}],"description":"The data source accounts configuration for the CRM integration","nullable":true},"default_id":{"allOf":[{"$ref":"#/components/schemas/CrmObjectId"}],"description":"The default object id for the CRM integration","nullable":true},"download_legacy_attachments":{"default":false,"description":"Whether to download legacy Salesforce Attachment records","type":"boolean"},"object_configs":{"default":[],"description":"The object configurations for the CRM integration","items":{"$ref":"#/components/schemas/CrmObjectConfig"},"type":"array"},"policy_evaluation_config":{"allOf":[{"$ref":"#/components/schemas/CrmPolicyEvaluationConfig"}],"description":"The policy evaluation configuration for the CRM integration","nullable":true},"small_file_filtering_enabled":{"default":false,"description":"Whether to filter out files smaller than 400 bytes","type":"boolean"},"sync_file_classes":{"additionalProperties":{"type":"boolean"},"default":{},"description":"Whether to sync files of a given class, including emails","type":"object"},"value_mappings":{"default":[],"description":"A list of value mappings for the CRM integration","items":{"$ref":"#/components/schemas/CrmValueMapping"},"type":"array"}},"type":"object"},"CrmExternalLookupConfig":{"properties":{"external_lookup_fields_and":{"description":"External lookup fields are what is used to try match potential new objects to existing objects in the CRM (i.e., for deduplication). Used in the and condition.","items":{"type":"string"},"type":"array"},"external_lookup_fields_or":{"description":"External lookup fields are what is used to try match potential new objects to existing objects in the CRM (i.e., for deduplication). Used in the or condition.","items":{"type":"string"},"type":"array"},"sort_field_name":{"default":"CreatedDate","description":"The field name to sort by when doing the external lookup","example":"CreatedDate","type":"string"},"sort_order":{"description":"The sort order when doing the external lookup","enum":["ASC","DESC"],"type":"string"}},"type":"object"},"CrmFieldMapping":{"properties":{"external_lookup_field_name":{"description":"Override field name to use for external lookup instead of the field_name","nullable":true,"type":"string"},"external_object_name_for_id":{"description":"The external object whose id we want to use populate the field value","example":"Account","nullable":true,"type":"string"},"field_name":{"description":"The name of the field in the CRM","example":"Name","type":"string"},"heron_company_attribute_label":{"description":"The label of the company attribute in Heron","example":"owner_1_first_name","nullable":true,"type":"string"},"max_length":{"description":"The max length of the crm field this should be mapped to. Used for string fields. If set, the string will be truncated.","example":255,"nullable":true,"type":"integer"},"overwrite_on_update":{"default":true,"description":"Whether the field should be overwritten on update. True by default. When False, the field will only be set on creation","example":true,"type":"boolean"},"regex_remove":{"description":"Any pattern that should be removed from the company attribute value","example":"pattern","nullable":true,"type":"string"},"required":{"default":false,"description":"Whether the field is required","example":true,"type":"boolean"},"static_value":{"description":"A static value for the field","example":"static value","nullable":true,"type":"string"},"static_value_key":{"description":"The value key of the static data","enum":["date_today",null],"nullable":true,"type":"string"},"value_mapping_name":{"description":"Name of the value mapping to use for the field","example":"state","nullable":true,"type":"string"},"value_type":{"description":"The crm type of the field","example":"Text","nullable":true,"type":"string"}},"required":["field_name"],"type":"object"},"CrmIntegrationPatchSchema":{"additionalProperties":false,"properties":{"auth":{"additionalProperties":{},"description":"Authentication details for the CRM integration","type":"object","writeOnly":true},"config":{"allOf":[{"$ref":"#/components/schemas/CrmConfig"}],"description":"The configuration for the CRM integration"},"failure_notification_channel":{"description":"The channel to send failure notifications to","nullable":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"instance_url":{"description":"Base URL of the CRM integration","example":"https://sandbox.salesforce.com","format":"url","type":"string"},"is_enabled":{"default":true,"description":"Whether the integration is enabled","example":true,"type":"boolean"},"is_live":{"default":true,"description":"Whether the integration is live","example":true,"type":"boolean"},"provider":{"description":"The CRM provider","type":"string"},"secret":{"description":"A secret key for the CRM integration","type":"string","writeOnly":true}},"type":"object"},"CrmIntegrationSchema":{"additionalProperties":false,"properties":{"auth":{"additionalProperties":{},"description":"Authentication details for the CRM integration","type":"object","writeOnly":true},"config":{"allOf":[{"$ref":"#/components/schemas/CrmConfig"}],"description":"The configuration for the CRM integration"},"failure_notification_channel":{"description":"The channel to send failure notifications to","nullable":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"instance_url":{"description":"Base URL of the CRM integration","example":"https://sandbox.salesforce.com","format":"url","type":"string"},"is_enabled":{"default":true,"description":"Whether the integration is enabled","example":true,"type":"boolean"},"is_live":{"default":true,"description":"Whether the integration is live","example":true,"type":"boolean"},"provider":{"description":"The CRM provider","type":"string"},"secret":{"description":"A secret key for the CRM integration","type":"string","writeOnly":true}},"required":["auth","config","instance_url","provider","secret"],"type":"object"},"CrmObjectConfig":{"properties":{"description":{"description":"Human-readable description of the object","example":"A company or person","nullable":true,"type":"string"},"external_lookup_config":{"allOf":[{"$ref":"#/components/schemas/CrmExternalLookupConfig"}],"description":"Configuration for external lookup","nullable":true},"external_name":{"description":"The exact name of the object in the CRM","example":"Account","type":"string"},"field_mappings":{"description":"Mapping for Heron fields to object fields in CRM","items":{"$ref":"#/components/schemas/CrmFieldMapping"},"type":"array"},"is_optional":{"default":false,"description":"Whether the object is optional. Optional means that if object fails it will not stop execution of CRM sync","type":"boolean"},"key":{"description":"key should be unique among objects within an integration","example":"Account","type":"string"},"required_ids":{"description":"List of object ids that new object needs","items":{"$ref":"#/components/schemas/CrmObjectId"},"type":"array"},"static_data":{"description":"Stores static data used by the integration, for example status fields","items":{"$ref":"#/components/schemas/CrmStaticData"},"type":"array"}},"required":["external_name","key"],"type":"object"},"CrmObjectId":{"properties":{"alias":{"description":"An alias for the object in the CRM","example":"Company","nullable":true,"type":"string"},"external_name":{"description":"The exact name of the object in the CRM","example":"Account","type":"string"}},"required":["external_name"],"type":"object"},"CrmPolicyEvaluationConfig":{"properties":{"external_object_name":{"description":"The object to write policy evaluation results to","example":"Opportunity","type":"string"},"failure_reason_external_name":{"description":"The field to write policy evaluation failure reason to","example":"Failure_Reason__c","type":"string"},"result_external_name":{"description":"The field to write policy evaluation results","example":"Submission_Result_from_Heron__c","type":"string"}},"required":["external_object_name"],"type":"object"},"CrmQueue":{"properties":{"crm_integration_heron_id":{"readOnly":true,"type":"string"},"node_id":{"description":"The CRM sync step that sets the queue","readOnly":true,"type":"string"},"status_id":{"description":"The status the sync step sends, which the CRM may not apply (e.g. under a priority order)","nullable":true,"readOnly":true,"type":"string"},"status_name":{"nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"CrmQueueStatus":{"properties":{"crm_integration_heron_id":{"readOnly":true,"type":"string"},"status_id":{"description":"The status the sync step sends, which the CRM may not apply (e.g. under a priority order)","nullable":true,"readOnly":true,"type":"string"},"status_name":{"nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"CrmStaticData":{"properties":{"key":{"description":"The key of the static data","example":"status","type":"string"},"value":{"description":"The value of the static data","example":"active"}},"required":["key","value"],"type":"object"},"CrmSyncEvent":{"properties":{"crm_record_url":{"nullable":true,"type":"string"},"error_message":{"nullable":true,"type":"string"},"heron_id":{"type":"string"},"name":{"type":"string"},"occurred_at":{"format":"date-time","type":"string"},"provider":{"nullable":true,"type":"string"},"result":{"enum":["success","failure","no_sync_attempted"]},"success_message":{"nullable":true,"type":"string"}},"type":"object"},"CrmSyncEventSchema":{"properties":{"crm_record_url":{"nullable":true,"type":"string"},"error_message":{"nullable":true,"type":"string"},"heron_id":{"type":"string"},"name":{"type":"string"},"occurred_at":{"format":"date-time","type":"string"},"provider":{"nullable":true,"type":"string"},"result":{"enum":["success","failure","no_sync_attempted"]},"success_message":{"nullable":true,"type":"string"}},"type":"object"},"CrmValueMapping":{"properties":{"default_value":{"description":"The default value to use when no match is found","example":"Default","nullable":true,"type":"string"},"description":{"description":"A human-readable description of the value mapping","example":"The status of the company","nullable":true,"type":"string"},"mapping":{"additionalProperties":{},"description":"The mapping of values","example":{"CA":"California","NY":"New York"},"type":"object"},"name":{"description":"The name of the value mapping","example":"Status","type":"string"},"use_partial_match":{"default":false,"description":"Whether to use partial match when mapping values","type":"boolean"}},"required":["mapping","name"],"type":"object"},"CurrentFirmographics":{"properties":{"employees":{"allOf":[{"$ref":"#/components/schemas/SourcedIntegerValue"}],"description":"The newest employee count across sources. Null when no source reported one.","nullable":true},"revenue":{"allOf":[{"$ref":"#/components/schemas/SourcedIntegerValue"}],"description":"The newest annual revenue figure across sources. Null when no source reported one.","nullable":true},"status":{"allOf":[{"$ref":"#/components/schemas/SourcedCurrentStatusValue"}],"description":"The business's current status, read from the state filing that best matches it (one under the business's name first, then one in the business's state, then one whose filing number another source states for the business, with the most recently active filing breaking any remaining tie), counting only filings whose status reads as active or inactive and taking trade-name filings last. A filing that shares no name, state or filing number with the business counts only after every other source, even a matching filing whose status cannot be read. Another source's status is used only when no filing qualifies. The out-of-business flag never overrides it. as_of is the filing's latest activity (status change, annual report or filing); filing_id names the filing. Null when no source states a status.","nullable":true}},"required":["employees","revenue","status"],"type":"object"},"CustomerFunderExclusionRuleInputSchema":{"additionalProperties":false,"properties":{"not_senders":{"items":{"type":"string"},"type":"array"},"sender_domains":{"items":{"pattern":"^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$","type":"string"},"type":"array"},"sender_emails":{"items":{"format":"email","type":"string"},"type":"array"},"sender_names":{"items":{"type":"string"},"type":"array"}},"type":"object"},"CustomerFunderExclusionRuleSchema":{"properties":{"funder":{"allOf":[{"$ref":"#/components/schemas/FunderSearchResultSchema"}],"readOnly":true},"funder_heron_id":{"readOnly":true,"type":"string"},"not_senders":{"items":{"type":"string"},"readOnly":true,"type":"array"},"reason":{"readOnly":true,"type":"string"},"sender_domains":{"items":{"type":"string"},"readOnly":true,"type":"array"},"sender_emails":{"items":{"type":"string"},"readOnly":true,"type":"array"},"sender_names":{"items":{"type":"string"},"readOnly":true,"type":"array"}},"required":["funder","reason"],"type":"object"},"DataSource":{"properties":{"status":{"description":"Status of the data source entity, where applicable (e.g. pdfs, integration links)","enum":["new","parsing","parsed","processed","human_reviewing","approved","rejected","failed","transactions_loaded","transactions_unloaded","pending","active","syncing","erroring","sync_disabled","deleted_in_plaid","unknown"],"example":"new","type":"string"},"type":{"description":"Data source type","enum":["api","csv","pdf","integration_link","legacy","legacy_pdf","legacy_integration_link"],"example":"pdf","type":"string"}},"required":["type"],"type":"object"},"DataSourceAccount":{"properties":{"account_id":{"description":"PDF statement account identifier. Null for non-PDF sources.","example":"202348","nullable":true,"type":"string"},"account_type":{"description":"Heron's full account type, the same for every source: business_checking, business_savings, personal, escrow or credit_loan. Open-banking accounts get it only for checking and savings whose owner is known. Null when Heron can't tell.","enum":["business_checking","business_savings","personal","escrow","credit_loan",null],"example":"business_checking","nullable":true,"readOnly":true},"anomaly_reasons":{"description":"Reasons associated with anomaly_score for pdf bank statement account sources","example":["Statement metadata changed","Manual review flagged suspicious edits"],"items":{"type":"string"},"nullable":true,"type":"array"},"anomaly_score":{"description":"For pdf bank statement account sources, where the value is between 0 and 1000, with 1000 being the most anomalous","example":200,"type":"integer"},"balances":{"description":"List of balances associated with the account","example":[{"closing_amount":25000.45,"currency":"USD","date":"2022-01-01"}],"items":{"$ref":"#/components/schemas/AccountBalance"},"type":"array"},"currency":{"description":"Currency of the account","example":"USD","type":"string"},"dba":{"description":"Doing Business As name printed on the bank statement","example":"Chickys","nullable":true,"type":"string"},"disabled_reason":{"description":"Why this account is disabled. An account we never processed was created disabled with no transactions: excluded_account_type (legacy or unknown account-type exclusion), excluded_personal_account, excluded_business_savings_account, excluded_escrow_account, excluded_credit_loan_account, loan_account, reviewer_excluded, not_an_account (an empty section of the document that is not an account, such as a summary box), excluded_bank (a bank or service provider the workflow skips), account_id_mismatch (the account number does not match the account_id sent on upload), failed_checks (the statement was parsed but failed our checks, so the file was rejected), or unverifiable_statement (missing pages or no balances). An account turned off after it loaded has one of: duplicate_statement (another file holds the same statement), duplicate_coverage (another statement already covers these dates), disabled_by_user, or no_longer_returned_by_provider (the bank connection, e.g. Plaid, stopped returning it). Null for an enabled account, for a bank-connection account the workflow's account filters turned off, and for one disabled before these reasons existed.","enum":["excluded_account_type","excluded_personal_account","excluded_business_savings_account","excluded_escrow_account","excluded_credit_loan_account","loan_account","reviewer_excluded","not_an_account","excluded_bank","account_id_mismatch","failed_checks","unverifiable_statement","duplicate_statement","duplicate_coverage","disabled_by_user","no_longer_returned_by_provider",null],"example":"excluded_account_type","nullable":true},"disabled_reason_description":{"description":"Customer-facing explanation of why the account is disabled.","example":"Heron didn't load transactions because this workflow excludes business savings accounts.","nullable":true,"readOnly":true,"type":"string"},"display_account_id":{"description":"Human-readable account label for display: the last four digits of the account number without heron_account_suffix (falling back to the account title). Not unique and not a key; join heron_id to data_source_account_heron_id on transactions.","example":"7505","nullable":true,"type":"string"},"end_date":{"description":"End date of the account","example":"2022-01-31","format":"date","type":"string"},"heron_account_suffix":{"description":"Added by Heron to tell apart accounts that print the same account number, such as a checking account and its reserve line. Not printed by the bank. A 3-digit suffix is the order the accounts appear in one file, so the same account can get a different one in another file. Null when the printed number needed no suffix.","example":"001","nullable":true,"type":"string"},"heron_id":{"description":"Unique ID for data source generated by Heron","example":"dso_StvEAbtRd2LLU6n8LjQDwS","type":"string"},"institution_name":{"description":"Name of the institution","example":"Chase","type":"string"},"is_enabled":{"description":"Whether or not the account is enabled. If disabled, hides related transactions from analytics","example":true,"type":"boolean"},"max_date":{"description":"Latest date of transactions associated with the data source account","example":"2022-01-31","format":"date","type":"string"},"min_date":{"description":"Earliest date of transactions associated with the data source account","example":"2022-01-01","format":"date","type":"string"},"name":{"description":"Name of the account","example":"Checking Account","nullable":true,"type":"string"},"num_transactions":{"description":"Number of transactions associated with the data source account","example":120,"type":"integer"},"number":{"description":"Number of the account","example":"123456789","nullable":true,"type":"string"},"owner_name":{"description":"Name of the account owner","example":"John Doe","type":"string"},"printed_account_number":{"description":"The account number without heron_account_suffix: the number and any sub-account the bank printed. Same as number when there is no suffix.","example":"1-458-1824-4066","nullable":true,"type":"string"},"reference_id":{"description":"This is the account ID provided as part of the transaction","example":"account-202348","type":"string"},"start_date":{"description":"Start date of the account","example":"2022-01-01","format":"date","type":"string"},"transactions_match_balances":{"description":"For pdf bank statements, represents whether all transactions extracted match the balances extracted","example":true,"type":"boolean"},"type":{"description":"Raw account type. Bank statements: business, personal or unknown. Open banking: the provider's own value, e.g. CHECKING, SAVINGS or Plaid's depository. Not the same across sources; use account_type to tell business checking from other accounts.","example":"business","nullable":true,"type":"string"}},"required":["is_enabled"],"type":"object"},"DataSourceAccountDateReconciliationMetrics":{"properties":{"data_source_account_heron_id":{"readOnly":true},"date":{"format":"date","type":"string"},"metrics":{"items":{"$ref":"#/components/schemas/DataSourceAccountReconciliationMetric"},"type":"array"}},"required":["data_source_account_heron_id","date","metrics"],"type":"object"},"DataSourceAccountNested":{"properties":{"heron_id":{"description":"Heron ID of the data source account","type":"string"},"is_enabled":{"description":"Whether this data source account is enabled","type":"boolean"}},"type":"object"},"DataSourceAccountReconciliationMetric":{"properties":{"category_label":{"nullable":true,"type":"string"},"metric":{"enum":["num_txns","num_inflow_txns","num_outflow_txns","num_txns_with_balance","num_txns_with_negative_balance","num_overdraft_fee_units","num_nsf_fee_units","num_ambiguous_od_nsf_fee_units","num_items_returned_unpaid","amount__sum","amount_inflow__sum","amount_outflow__sum","amount_inflow__max","amount_outflow__max","amount_inflow__min","amount_outflow__min","amount_inflow_squared__sum","amount_outflow_squared__sum","confidence_x_amount_inflow__sum","confidence_x_amount_outflow__sum"]},"value":{"$ref":"#/components/schemas/Money"}},"required":["category_label","metric","value"],"type":"object"},"DataSourceAccountSummary":{"properties":{"account":{"$ref":"#/components/schemas/EndUserDataSourceAccount"},"all_transactions_summary":{"allOf":[{"$ref":"#/components/schemas/DataSourceAccountSummaryRow"}],"description":"The same metrics over every loaded transaction, where `summary` covers files that reconciled, or that predate reconciliation checks, whatever their file class. When the end user does not load unreconciled transactions the two views are identical, and this mirrors `summary`. additional_no_od is a statement value and is never set here.","nullable":true},"statement_reconciliation_status":{"description":"Whether this account's statement reconciled: reconciled = a check passed, not_possible = the document had nothing to check against, failed = a check ran and did not match, or a human reviewer ruled the document unreconciled. Only reconciled statements count towards `summary` (a null `summary` can have other causes too, such as a disabled account). The value is per document: a multi-statement pdf takes its worst statement's value, so all its accounts read the same. Null for bank connections \u2014 there is no statement to check \u2014 and for pdfs parsed before we recorded reconciliation, which still count.","enum":["failed","not_possible","reconciled",null],"nullable":true,"type":"string"},"summary":{"allOf":[{"$ref":"#/components/schemas/DataSourceAccountSummaryRow"}],"nullable":true}},"type":"object"},"DataSourceAccountSummaryPublicSchema":{"properties":{"data_source_account_summaries":{"items":{"$ref":"#/components/schemas/DataSourceAccountSummary"},"type":"array"},"end_user":{"$ref":"#/components/schemas/EndUser1"}},"type":"object"},"DataSourceAccountSummaryRow":{"properties":{"actual_holdback_percentage":{"description":"Actual MCA payments to revenue as % (raw repayment amounts)","nullable":true,"type":"number"},"additional_no_od":{"description":"Overdraft-item count a bank reports as a statement value for items absent from the transaction list. These items are already included in no_od and no_od_nsf. Null when the statement does not report a count.","nullable":true,"type":"integer"},"average_balance":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Average balance","nullable":true},"average_balance_to_revenue_ratio":{"description":"Average balance divided by total revenue","nullable":true,"type":"number"},"business_day_average_balance":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Average balance over weekdays excluding public holidays","nullable":true},"dd_reversals":{"description":"Number of DD Reversals","type":"integer"},"ending_balance":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Ending balance","nullable":true},"expected_mca_debits":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Expected MCA debits amount"},"holdback_percentage":{"description":"Expected MCA payments to revenue as % (with frequency multiplier)","nullable":true,"type":"number"},"is_mtd":{"description":"True when month-to-date (MTD) file data feeds this row. A file counts as MTD when its file class is month_to_date, or when it has no file class and the parser read the statement as a month-to-date export (such as an online banking web report). For users without the month_to_date class, a bank_statement the parser read as month-to-date also counts. Monthly rows set it only on the month the MTD file ends in, not on every month it covers. by_data_source_account_heron_id and by_data_source_account_by_monthly_intervals set it on every row of an account whose MTD file ends in or after the month of the latest transaction across all accounts in the summary. It does not mean the month is recent, or that it is incomplete (on by_month rows, use is_partial). When true, holdback_percentage and actual_holdback_percentage are null. Always false for rolling 30-day groupings and for total and average","type":"boolean"},"is_unreconcilable":{"description":"True when every file feeding this row has no balance data to reconcile against (statement_reconciliation_status not_possible), whatever the file class. False when any file feeding the row has another status or is a bank connection. When true, ending_balance, average_balance, business_day_average_balance, negative_balance_days and low_balance_days are null. Always false for total and average. When unreconciled files are loaded (load_unreconciled_transactions), summary leaves them out, so read this flag in all_transactions_summary","type":"boolean"},"is_unreconciled":{"description":"True when any file feeding this row failed reconciliation (statement_reconciliation_status failed), whatever the file class, so a month mixing a reconciled statement with a failed MTD is true. Balances still show. Always false for total and average. When unreconciled files are loaded (load_unreconciled_transactions), summary leaves them out, so read this flag in all_transactions_summary","type":"boolean"},"low_balance_days":{"description":"Number of days where end of day balance falls below low balance threshold","nullable":true,"type":"integer"},"mca_credits":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"MCA credits amount"},"mca_debits":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"MCA debits amount"},"negative_balance_days":{"description":"Number of days with negative balance","nullable":true,"type":"integer"},"no_deposits":{"description":"Number of deposit transactions","type":"integer"},"no_mca_credits":{"description":"Number of MCA credit transactions","type":"integer"},"no_mca_debits":{"description":"Number of MCA debit transactions","type":"integer"},"no_nsf":{"description":"Number of NSF transactions (unambiguous NSF-only category labels).","type":"integer"},"no_od":{"description":"Number of overdraft fees: transactions with unambiguous OD-only category labels, plus additional_no_od.","type":"integer"},"no_od_nsf":{"description":"Total overdraft/NSF fees: overdraft fees + NSF fees + ambiguous fees.","type":"integer"},"no_overdraft_transactions":{"description":"Number of transactions where the resulting balance falls below 0","type":"integer"},"no_revenue":{"description":"Number of revenue transactions","type":"integer"},"no_withdrawals":{"description":"Number of withdrawals transactions","type":"integer"},"non_revenue":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Non-revenue amount"},"period_end_date":{"description":"End of the MTD statement period behind this row: the latest end date of the MTD files that set is_mtd (e.g. an MTD statement covering Apr 1\u201315 gives Apr 15). Null when is_mtd is false. In by_data_source_account_by_monthly_intervals it is the last day of the row's interval instead, on every row","format":"date","nullable":true,"type":"string"},"period_start_date":{"description":"Start of the MTD statement period behind this row: the earliest start date of the MTD files that set is_mtd. It can fall in an earlier month than the row. Null when is_mtd is false. In by_data_source_account_by_monthly_intervals it is the first day of the row's interval instead, on every row","format":"date","nullable":true,"type":"string"},"starting_balance":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Starting balance for the period","nullable":true},"total_deposits":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Total deposit amount"},"total_revenue":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Total revenue amount"},"total_withdrawals":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Total withdrawal amount"}},"type":"object"},"DataSourceAccountUpdateNumberSchema":{"properties":{"source_dsa_heron_id":{"description":"The Heron ID of the data source account containing the number we want to update to","example":"dsa_8Wezdyj8LMyX4pv7bLzJ2f","type":"string"}},"required":["source_dsa_heron_id"],"type":"object"},"DataSourceMetadata":{"properties":{"currency":{"description":"Currency associated with the data source entity, where applicable (e.g. pdfs)","example":"USD","type":"string"},"filename":{"description":"Name of the file uploaded, where applicable (e.g. pdfs)","example":"202348_JAN_2022.pdf","nullable":true,"type":"string"},"integration_heron_id":{"description":"Unique Heron ID associated with an integration","example":"itg_kiQpir7WkK8AbyhqUNMT5T","type":"string"},"integration_item_id":{"description":"Unique item id associated with integration link data sources","example":"Ed6bjNrDLJfGvZWwnkQlfxwoNz54B5C97ejBr","type":"string"},"last_successful_sync":{"description":"Last successful sync date associated with integration link data sources","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"type":"string"},"notes":{"description":"Customer-facing data source status message. Null for a newly uploaded PDF.","example":"Statement processed successfully. All balances verified.","nullable":true,"type":"string"},"parsing_version":{"description":"Parsing version associated with the data source entity, where applicable (e.g. pdfs)","example":"1.0.0","type":"string"},"sub_type":{"description":"Sub type of the data source entity, where applicable (e.g. integration links)","example":"transaction","type":"string"}},"type":"object"},"DataSourceNested":{"properties":{"heron_id":{"description":"Heron ID of the data source","type":"string"},"is_enabled":{"description":"Whether this data source is enabled","type":"boolean"}},"type":"object"},"DateCheck":{"properties":{"auto_decline":{"default":false,"type":"boolean"},"decline_code":{"description":"The CRM's identifier for this decline reason, e.g. a LendSaas reason id. Left unset, the CRM sync falls back to this check's decline_description.","nullable":true,"type":"string"},"decline_description":{"nullable":true,"type":"string"},"email_template_name":{"nullable":true,"type":"string"},"ignore_metric_availability":{"default":false,"type":"boolean"},"is_mandatory":{"default":false,"type":"boolean"},"on_failure":{"default":"fail","enum":["fail","review_required"]},"on_missing":{"default":"missing_data","description":"What the check reports when it would report missing data: `missing_data` (the default), `fail` or `pass`. A check saved with an older flag (`pass_if_value_missing` on a date-delta check) reads as the setting it stands for. With `ignore_metric_availability` or `pass_if_value_missing` set, only that setting is accepted","enum":["missing_data","fail","pass"]},"pass_description":{"nullable":true,"type":"string"},"transaction_scope":{"allOf":[{"$ref":"#/components/schemas/TransactionScope"}],"nullable":true},"type":{"enum":["equal","not_equal","before","before_or_on","after","after_or_on"]},"value":{"format":"date","nullable":true,"type":"string"}},"type":"object"},"DateDeltaToNowCheck":{"properties":{"auto_decline":{"default":false,"type":"boolean"},"decline_code":{"description":"The CRM's identifier for this decline reason, e.g. a LendSaas reason id. Left unset, the CRM sync falls back to this check's decline_description.","nullable":true,"type":"string"},"decline_description":{"nullable":true,"type":"string"},"email_template_name":{"nullable":true,"type":"string"},"ignore_metric_availability":{"default":false,"type":"boolean"},"is_mandatory":{"default":false,"type":"boolean"},"on_failure":{"default":"fail","enum":["fail","review_required"]},"on_missing":{"default":"missing_data","description":"What the check reports when it would report missing data: `missing_data` (the default), `fail` or `pass`. A check saved with an older flag (`pass_if_value_missing` on a date-delta check) reads as the setting it stands for. With `ignore_metric_availability` or `pass_if_value_missing` set, only that setting is accepted","enum":["missing_data","fail","pass"]},"pass_description":{"nullable":true,"type":"string"},"pass_if_value_missing":{"default":false,"type":"boolean"},"transaction_scope":{"allOf":[{"$ref":"#/components/schemas/TransactionScope"}],"nullable":true},"type":{"enum":["greater_than","greater_than_or_equal","less_than","less_than_or_equal"]},"value":{"additionalProperties":{},"nullable":true,"type":"object"}},"type":"object"},"DateRangeSchema":{"properties":{"end_date":{"format":"date-time","type":"string"},"start_date":{"format":"date-time","type":"string"}},"required":["end_date","start_date"],"type":"object"},"DealConfidence":{"properties":{"average_mca_payment_tolerance":{"maximum":1.0,"minimum":0.0,"type":"number"},"enabled":{"type":"boolean"},"mca_positions_tolerance":{"minimum":0,"type":"integer"},"nsf_od_count_tolerance":{"minimum":0,"type":"integer"},"revenue_tolerance":{"maximum":1.0,"minimum":0.0,"type":"number"},"statement_tolerance":{"minimum":0,"type":"integer"}},"type":"object"},"DealLinkCandidate":{"properties":{"heron_id":{"readOnly":true,"type":"string"},"latest_activity_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"name":{"nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"DealLinkEntry":{"additionalProperties":false,"properties":{"decline_reason":{"nullable":true,"readOnly":true,"type":"string"},"funder_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"funder_name":{"nullable":true,"readOnly":true,"type":"string"},"name":{"nullable":true,"readOnly":true,"type":"string"},"occurrences":{"items":{"$ref":"#/components/schemas/DealLinkOccurrence"},"readOnly":true,"type":"array"},"opportunity_id":{"readOnly":true,"type":"string"},"role":{"enum":["submission","approval","decline","other","unknown"],"readOnly":true}},"type":"object"},"DealLinkOccurrence":{"additionalProperties":false,"properties":{"created":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"end_user_heron_id":{"readOnly":true,"type":"string"}},"type":"object"},"DealRead":{"additionalProperties":false,"properties":{"signals":{"items":{"$ref":"#/components/schemas/RecommendationSignal"},"readOnly":true,"type":"array"},"strength":{"readOnly":true,"type":"string"}},"type":"object"},"DealSetCheckFilter":{"properties":{"check_identity":{"readOnly":true,"type":"string"},"result":{"readOnly":true,"type":"string"},"section_heron_id":{"readOnly":true,"type":"string"}},"type":"object"},"DealSetParams":{"properties":{"check_filter":{"allOf":[{"$ref":"#/components/schemas/DealSetCheckFilter"}],"nullable":true,"readOnly":true},"end_user_heron_ids":{"items":{"type":"string"},"readOnly":true,"type":"array"},"limit":{"readOnly":true,"type":"integer"},"source_filter":{"allOf":[{"$ref":"#/components/schemas/DealSetSourceFilter"}],"nullable":true,"readOnly":true},"window_end":{"description":"ISO 8601, exclusive","readOnly":true,"type":"string"},"window_start":{"description":"ISO 8601, inclusive","readOnly":true,"type":"string"},"with_policy_result":{"items":{"type":"string"},"nullable":true,"readOnly":true,"type":"array"}},"type":"object"},"DealSetSourceFilter":{"properties":{"names":{"items":{"type":"string"},"readOnly":true,"type":"array"},"sender_addresses":{"items":{"type":"string"},"readOnly":true,"type":"array"},"sender_domains":{"items":{"type":"string"},"readOnly":true,"type":"array"}},"type":"object"},"DeathRecord":{"properties":{"age_at_death":{"description":"Age at death; null when unavailable.","nullable":true,"type":"integer"},"birth_place":{"description":"Birth place of the deceased; null when unavailable.","nullable":true,"type":"string"},"date_of_birth":{"description":"Birth date of the deceased as the source reports it, often partly masked (MM/XX/YYYY); null when unavailable.","nullable":true,"type":"string"},"date_of_death":{"description":"Date of death; null when unavailable.","format":"date","nullable":true,"type":"string"},"date_of_death_note":{"description":"Source text given in place of a date of death, for example 'SSA Death Record reported within the last 3 years'; null when a date is given or nothing is reported.","nullable":true,"type":"string"},"death_certificate_number":{"description":"Death certificate reference; null when unavailable.","nullable":true,"type":"string"},"death_place":{"description":"Place of death; null when unavailable.","nullable":true,"type":"string"},"deceased_name":{"description":"Name on the death record, not the applicant's name; null when unavailable.","nullable":true,"type":"string"},"father_birth_place":{"description":"Father's birth place; null when unavailable.","nullable":true,"type":"string"},"father_name":{"description":"Father named on the record; null when unavailable.","nullable":true,"type":"string"},"last_address":{"description":"Last address listed for the deceased; null when unavailable.","nullable":true,"type":"string"},"matches_subject":{"description":"Whether the deceased_name on the record matches the applicant. Null means the record supplied no name to compare.","nullable":true,"type":"boolean"},"mother_birth_place":{"description":"Mother's birth place; null when unavailable.","nullable":true,"type":"string"},"mother_name":{"description":"Mother named on the record; null when unavailable.","nullable":true,"type":"string"},"record_type":{"description":"Death record class: death_record, deceased_record, obituary_record, or death_summary.","enum":["death_record","deceased_record","obituary_record","death_summary"],"type":"string"},"source":{"description":"Source that supplied the record; null when unavailable.","nullable":true,"type":"string"},"spouse_name":{"description":"Spouse named on the record; null when unavailable.","nullable":true,"type":"string"},"ssn":{"description":"Social Security number of the deceased, masked to the first five digits (123-45-XXXX); null when unavailable.","nullable":true,"type":"string"}},"required":["record_type"],"type":"object"},"DecisionEngineSettings":{"properties":{"beta":{"type":"boolean"},"enabled":{"type":"boolean"}},"type":"object"},"DecisionLogicPostParams":{"properties":{"currency":{"description":"ISO 4217 currency code","example":"USD","type":"string"}},"type":"object"},"DeclineAnalyticsResponseSchema":{"properties":{"check_analytics":{"items":{"$ref":"#/components/schemas/CheckAnalyticsResponse"},"type":"array"},"total_declined":{"type":"integer"},"total_end_users":{"type":"integer"}},"type":"object"},"DeduplicatedAccountSchema":{"properties":{"best_number":{"description":"The longest sanitised account number seen for this group.","example":"8463","nullable":true,"type":"string"},"data_source_account_heron_ids":{"description":"Heron IDs of every DataSourceAccount clustered into this group.","items":{"type":"string"},"type":"array"},"display_account_number":{"example":"8463","nullable":true,"type":"string"},"group_key":{"description":"Interim row key for this deduplicated group. Unstable: it is recomputed on every call from the accounts that currently cluster together. FE row key only - never store it or compare it across requests.","example":"dsa_2N2fEbfWyGxCVzkASN2yiy|dsa_2N2fEcRp2mGwbCd4xTHi33","type":"string"},"heron_account_suffix":{"description":"Added by Heron to tell apart accounts that print the same account number, such as a checking account and its reserve line. Not printed by the bank. A 3-digit suffix is the order the accounts appear in one file, so the same account can get a different one in another file. Null when the printed number needed no suffix.","example":"001","nullable":true,"type":"string"},"heron_id":{"description":"Always null in this interim version - no Account entity exists yet.","nullable":true,"type":"string"},"latest_balance":{"allOf":[{"$ref":"#/components/schemas/AccountBalance"}],"nullable":true},"name":{"example":"Checking","nullable":true,"type":"string"},"source_reference_ids":{"description":"The member DataSourceAccounts' `reference_id` values, which is what analytics endpoints take as `account_ids`. These are not the `account_id` carried on their transactions, which for a PDF-parsed statement is the bare account number.","example":["account_8463_stmt_0","account_8463_stmt_1"],"items":{"type":"string"},"type":"array"}},"type":"object"},"DefaultPolicyBranch":{"properties":{"checks":{"items":{"$ref":"#/components/schemas/Check"},"type":"array"},"condition":{"description":"Not allowed: the default runs when no branch matches. Accepted only to report that at its path","nullable":true,"writeOnly":true},"decline_code":{"description":"Optional code sent with a failed or review_required result","nullable":true,"type":"string"},"decline_description":{"description":"Required when result is failed or review_required","nullable":true,"type":"string"},"heron_id":{"nullable":true,"type":"string"},"name":{"default":"Default","type":"string"},"result":{"description":"What happens to deals no branch matches when the default has no checks; required then","enum":["passed","failed","review_required",null],"nullable":true}},"type":"object"},"DefinitionIssue":{"properties":{"code":{"description":"A stable code for the problem","type":"string"},"message":{"description":"What is wrong, written for the person editing the policy","type":"string"},"path":{"description":"The field the problem belongs to","items":{},"type":"array"}},"required":["code","message","path"],"type":"object"},"DeleteTransactionParams":{"properties":{"account_id":{"description":"account_id of transactions to be deleted","nullable":true,"type":"string"},"end_user_id":{"description":"end_user_id of transactions to be deleted","nullable":true,"type":"string"},"heron_id":{"description":"(legacy) Heron ID of transaction to be deleted","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"type":"string"},"heron_ids":{"default":[],"description":"Heron IDs of transactions to be deleted","items":{"type":"string"},"type":"array"},"only_duplicates":{"description":"if true, deletes only transactions that are marked as duplicates","nullable":true,"type":"boolean"},"reference_ids":{"default":[],"description":"Reference IDs of transactions to be deleted","items":{"type":"string"},"type":"array"},"request_id":{"description":"Request ID of transactions to be deleted","nullable":true,"type":"string"}},"type":"object"},"DerivedFeaturesSchema":{"properties":{"currency":{"description":"Currency of every amount in `features`","type":"string"},"end_user_heron_id":{"description":"Heron ID of the end user","type":"string"},"features":{"additionalProperties":{"nullable":true},"description":"Each derived feature's name and value. A value is null when the data it needs is missing.","type":"object"},"reference_date":{"description":"The later of the last transaction and the last statement end date. Windowed features end on this date. Null without transactions.","format":"date","nullable":true,"type":"string"}},"required":["currency","end_user_heron_id","features","reference_date"],"type":"object"},"DetailAttorney":{"properties":{"address":{"description":"Source-provided address; null when unavailable.","nullable":true,"type":"string"},"bar_number":{"description":"Source-provided bar number; null when unavailable.","nullable":true,"type":"string"},"email":{"description":"Source-provided email address; null when unavailable.","nullable":true,"type":"string"},"firm":{"description":"Source-provided firm; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Source-provided attorney name; null when unavailable.","nullable":true,"type":"string"},"phone":{"description":"Source-provided phone number; null when unavailable.","nullable":true,"type":"string"},"role":{"description":"Source-provided role; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Source-provided status; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailAttorneySchema":{"properties":{"address":{"description":"Source-provided address; null when unavailable.","nullable":true,"type":"string"},"bar_number":{"description":"Source-provided bar number; null when unavailable.","nullable":true,"type":"string"},"email":{"description":"Source-provided email address; null when unavailable.","nullable":true,"type":"string"},"firm":{"description":"Source-provided firm; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Source-provided attorney name; null when unavailable.","nullable":true,"type":"string"},"phone":{"description":"Source-provided phone number; null when unavailable.","nullable":true,"type":"string"},"role":{"description":"Source-provided role; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Source-provided status; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailBail":{"properties":{"bond_number":{"description":"Source-provided bond number; null when unavailable.","nullable":true,"type":"string"},"bondsman":{"description":"Source-provided bondsman; null when unavailable.","nullable":true,"type":"string"},"date":{"description":"Source-provided bail date; null when unavailable.","nullable":true,"type":"string"},"posted":{"description":"Source-provided posted amount; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Source-provided bail status; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailBailSchema":{"properties":{"bond_number":{"description":"Source-provided bond number; null when unavailable.","nullable":true,"type":"string"},"bondsman":{"description":"Source-provided bondsman; null when unavailable.","nullable":true,"type":"string"},"date":{"description":"Source-provided bail date; null when unavailable.","nullable":true,"type":"string"},"posted":{"description":"Source-provided posted amount; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Source-provided bail status; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailCase":{"properties":{"case_details":{"description":"Source-provided case details; null when unavailable.","nullable":true,"type":"string"},"case_number":{"description":"Source-provided case number; null when unavailable.","nullable":true,"type":"string"},"case_title":{"description":"Source-provided case title; null when unavailable.","nullable":true,"type":"string"},"category":{"description":"Source-provided case category; null when unavailable.","nullable":true,"type":"string"},"chapter":{"description":"Source-provided bankruptcy chapter; null when unavailable.","nullable":true,"type":"string"},"company_interest":{"description":"Source-provided company interest; null when unavailable.","nullable":true,"type":"string"},"county":{"description":"Source-provided county; null when unavailable.","nullable":true,"type":"string"},"court":{"description":"Source-provided court; null when unavailable.","nullable":true,"type":"string"},"discharge_date":{"description":"Source-provided discharge date; null when unavailable.","nullable":true,"type":"string"},"disposition":{"description":"Source-provided disposition; null when unavailable.","nullable":true,"type":"string"},"disposition_date":{"description":"Source-provided disposition date; null when unavailable.","nullable":true,"type":"string"},"division":{"description":"Source-provided court division; null when unavailable.","nullable":true,"type":"string"},"docket_number":{"description":"Source-provided docket number; null when unavailable.","nullable":true,"type":"string"},"document_id":{"description":"Source-provided document reference; null when unavailable.","nullable":true,"type":"string"},"filed_date":{"description":"Source-provided filed date; null when unavailable.","nullable":true,"type":"string"},"filing_office":{"description":"Source-provided filing office; null when unavailable.","nullable":true,"type":"string"},"filing_state":{"description":"Source-provided filing state; null when unavailable.","nullable":true,"type":"string"},"final_decree_date":{"description":"Source-provided final decree date; null when unavailable.","nullable":true,"type":"string"},"judge":{"description":"Source-provided judge; null when unavailable.","nullable":true,"type":"string"},"jury_demand":{"description":"Source-provided jury demand; null when unavailable.","nullable":true,"type":"string"},"jury_demand_amount":{"description":"Source-provided jury demand amount; null when unavailable.","nullable":true,"type":"string"},"nature_of_suit":{"description":"Source-provided nature of suit; null when unavailable.","nullable":true,"type":"string"},"nature_of_suit_code":{"description":"Source-provided nature of suit code; null when unavailable.","nullable":true,"type":"string"},"state":{"description":"Source-provided state; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Source-provided case status; null when unavailable.","nullable":true,"type":"string"},"sub_category":{"description":"Source-provided case subcategory; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailCaseSchema":{"properties":{"case_details":{"description":"Source-provided case details; null when unavailable.","nullable":true,"type":"string"},"case_number":{"description":"Source-provided case number; null when unavailable.","nullable":true,"type":"string"},"case_title":{"description":"Source-provided case title; null when unavailable.","nullable":true,"type":"string"},"category":{"description":"Source-provided case category; null when unavailable.","nullable":true,"type":"string"},"chapter":{"description":"Source-provided bankruptcy chapter; null when unavailable.","nullable":true,"type":"string"},"company_interest":{"description":"Source-provided company interest; null when unavailable.","nullable":true,"type":"string"},"county":{"description":"Source-provided county; null when unavailable.","nullable":true,"type":"string"},"court":{"description":"Source-provided court; null when unavailable.","nullable":true,"type":"string"},"discharge_date":{"description":"Source-provided discharge date; null when unavailable.","nullable":true,"type":"string"},"disposition":{"description":"Source-provided disposition; null when unavailable.","nullable":true,"type":"string"},"disposition_date":{"description":"Source-provided disposition date; null when unavailable.","nullable":true,"type":"string"},"division":{"description":"Source-provided court division; null when unavailable.","nullable":true,"type":"string"},"docket_number":{"description":"Source-provided docket number; null when unavailable.","nullable":true,"type":"string"},"document_id":{"description":"Source-provided document reference; null when unavailable.","nullable":true,"type":"string"},"filed_date":{"description":"Source-provided filed date; null when unavailable.","nullable":true,"type":"string"},"filing_office":{"description":"Source-provided filing office; null when unavailable.","nullable":true,"type":"string"},"filing_state":{"description":"Source-provided filing state; null when unavailable.","nullable":true,"type":"string"},"final_decree_date":{"description":"Source-provided final decree date; null when unavailable.","nullable":true,"type":"string"},"judge":{"description":"Source-provided judge; null when unavailable.","nullable":true,"type":"string"},"jury_demand":{"description":"Source-provided jury demand; null when unavailable.","nullable":true,"type":"string"},"jury_demand_amount":{"description":"Source-provided jury demand amount; null when unavailable.","nullable":true,"type":"string"},"nature_of_suit":{"description":"Source-provided nature of suit; null when unavailable.","nullable":true,"type":"string"},"nature_of_suit_code":{"description":"Source-provided nature of suit code; null when unavailable.","nullable":true,"type":"string"},"state":{"description":"Source-provided state; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Source-provided case status; null when unavailable.","nullable":true,"type":"string"},"sub_category":{"description":"Source-provided case subcategory; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailCharge":{"properties":{"additional_fields":{"description":"Unmapped source values as label and value pairs.","items":{"$ref":"#/components/schemas/DetailLabelValue"},"type":"array"},"amended_offense":{"description":"Source-provided amended offence; null when unavailable.","nullable":true,"type":"string"},"amended_statute":{"description":"Source-provided amended statute; null when unavailable.","nullable":true,"type":"string"},"case_comments":{"description":"Source-provided case comments; null when unavailable.","nullable":true,"type":"string"},"case_information":{"description":"Source-provided case information; null when unavailable.","nullable":true,"type":"string"},"case_number":{"description":"Source-provided case number; null when unavailable.","nullable":true,"type":"string"},"case_status":{"description":"Source-provided case status; null when unavailable.","nullable":true,"type":"string"},"category":{"description":"Source-provided charge category; null when unavailable.","nullable":true,"type":"string"},"citation_number":{"description":"Source-provided citation number; null when unavailable.","nullable":true,"type":"string"},"class_of_offense":{"description":"Source-provided class of offence; null when unavailable.","nullable":true,"type":"string"},"counts":{"description":"Source-provided counts; null when unavailable.","nullable":true,"type":"string"},"court_charge":{"description":"Source-provided court charge; null when unavailable.","nullable":true,"type":"string"},"court_county":{"description":"Source-provided court county; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Source-provided court name; null when unavailable.","nullable":true,"type":"string"},"crime_date":{"description":"Source-provided crime date; null when unavailable.","nullable":true,"type":"string"},"disposition":{"description":"Source-provided disposition; null when unavailable.","nullable":true,"type":"string"},"disposition_date":{"description":"Source-provided disposition date; null when unavailable.","nullable":true,"type":"string"},"duplicate_report":{"description":"True when the charge duplicates another reported entry.","type":"boolean"},"facts":{"description":"Arrest entries only: this entry's own key facts as label and value pairs, ahead of the unmapped source values.","items":{"$ref":"#/components/schemas/DetailLabelValue"},"type":"array"},"fee_amount":{"description":"Source-provided fee amount; null when unavailable.","nullable":true,"type":"string"},"filed_date":{"description":"Source-provided filed date; null when unavailable.","nullable":true,"type":"string"},"fined_amount":{"description":"Source-provided fined amount; null when unavailable.","nullable":true,"type":"string"},"max_sentence_months":{"description":"Source-provided maximum sentence months; null when unavailable.","nullable":true,"type":"string"},"max_sentence_years":{"description":"Source-provided maximum sentence in years, not time served; null when unavailable.","nullable":true,"type":"string"},"offense":{"description":"Source-provided offence; null when unavailable.","nullable":true,"type":"string"},"offense_code":{"description":"Source-provided offence code; null when unavailable.","nullable":true,"type":"string"},"offense_date":{"description":"Source-provided offence date; null when unavailable.","nullable":true,"type":"string"},"offense_notes":{"description":"Source-provided offence notes; null when unavailable.","nullable":true,"type":"string"},"plea":{"description":"Source-provided plea; null when unavailable.","nullable":true,"type":"string"},"probation_months":{"description":"Source-provided probation months; null when unavailable.","nullable":true,"type":"string"},"sentence":{"description":"Source-provided sentence; null when unavailable.","nullable":true,"type":"string"},"sequence":{"description":"Source-provided charge sequence; null when unavailable.","nullable":true,"type":"string"},"severity":{"description":"Source-provided charge severity; null when unavailable.","nullable":true,"type":"string"},"source_entry_id":{"description":"Source-provided source entry reference; null when unavailable.","nullable":true,"type":"string"},"statute":{"description":"Source-provided statute; null when unavailable.","nullable":true,"type":"string"},"warrant_date":{"description":"Source-provided warrant date; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailChargeSchema":{"properties":{"additional_fields":{"description":"Unmapped source values as label and value pairs.","items":{"$ref":"#/components/schemas/DetailLabelValueSchema"},"type":"array"},"amended_offense":{"description":"Source-provided amended offence; null when unavailable.","nullable":true,"type":"string"},"amended_statute":{"description":"Source-provided amended statute; null when unavailable.","nullable":true,"type":"string"},"case_comments":{"description":"Source-provided case comments; null when unavailable.","nullable":true,"type":"string"},"case_information":{"description":"Source-provided case information; null when unavailable.","nullable":true,"type":"string"},"case_number":{"description":"Source-provided case number; null when unavailable.","nullable":true,"type":"string"},"case_status":{"description":"Source-provided case status; null when unavailable.","nullable":true,"type":"string"},"category":{"description":"Source-provided charge category; null when unavailable.","nullable":true,"type":"string"},"citation_number":{"description":"Source-provided citation number; null when unavailable.","nullable":true,"type":"string"},"class_of_offense":{"description":"Source-provided class of offence; null when unavailable.","nullable":true,"type":"string"},"counts":{"description":"Source-provided counts; null when unavailable.","nullable":true,"type":"string"},"court_charge":{"description":"Source-provided court charge; null when unavailable.","nullable":true,"type":"string"},"court_county":{"description":"Source-provided court county; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Source-provided court name; null when unavailable.","nullable":true,"type":"string"},"crime_date":{"description":"Source-provided crime date; null when unavailable.","nullable":true,"type":"string"},"disposition":{"description":"Source-provided disposition; null when unavailable.","nullable":true,"type":"string"},"disposition_date":{"description":"Source-provided disposition date; null when unavailable.","nullable":true,"type":"string"},"duplicate_report":{"description":"True when the charge duplicates another reported entry.","type":"boolean"},"facts":{"description":"Arrest entries only: this entry's own key facts as label and value pairs, ahead of the unmapped source values.","items":{"$ref":"#/components/schemas/DetailLabelValueSchema"},"type":"array"},"fee_amount":{"description":"Source-provided fee amount; null when unavailable.","nullable":true,"type":"string"},"filed_date":{"description":"Source-provided filed date; null when unavailable.","nullable":true,"type":"string"},"fined_amount":{"description":"Source-provided fined amount; null when unavailable.","nullable":true,"type":"string"},"max_sentence_months":{"description":"Source-provided maximum sentence months; null when unavailable.","nullable":true,"type":"string"},"max_sentence_years":{"description":"Source-provided maximum sentence in years, not time served; null when unavailable.","nullable":true,"type":"string"},"offense":{"description":"Source-provided offence; null when unavailable.","nullable":true,"type":"string"},"offense_code":{"description":"Source-provided offence code; null when unavailable.","nullable":true,"type":"string"},"offense_date":{"description":"Source-provided offence date; null when unavailable.","nullable":true,"type":"string"},"offense_notes":{"description":"Source-provided offence notes; null when unavailable.","nullable":true,"type":"string"},"plea":{"description":"Source-provided plea; null when unavailable.","nullable":true,"type":"string"},"probation_months":{"description":"Source-provided probation months; null when unavailable.","nullable":true,"type":"string"},"sentence":{"description":"Source-provided sentence; null when unavailable.","nullable":true,"type":"string"},"sequence":{"description":"Source-provided charge sequence; null when unavailable.","nullable":true,"type":"string"},"severity":{"description":"Source-provided charge severity; null when unavailable.","nullable":true,"type":"string"},"source_entry_id":{"description":"Source-provided source entry reference; null when unavailable.","nullable":true,"type":"string"},"statute":{"description":"Source-provided statute; null when unavailable.","nullable":true,"type":"string"},"warrant_date":{"description":"Source-provided warrant date; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailDefendant":{"properties":{"additional_fields":{"description":"Unmapped source values as label and value pairs.","items":{"$ref":"#/components/schemas/DetailLabelValue"},"type":"array"},"address":{"description":"Source-provided address; null when unavailable.","nullable":true,"type":"string"},"addresses":{"description":"Addresses on the record; arrests can carry several.","items":{"type":"string"},"type":"array"},"akas":{"description":"Also-known-as names on the record.","items":{"type":"string"},"type":"array"},"dob":{"description":"Source-provided date of birth; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Source-provided defendant name; null when unavailable.","nullable":true,"type":"string"},"sex":{"description":"Source-provided sex; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailDefendantSchema":{"properties":{"additional_fields":{"description":"Unmapped source values as label and value pairs.","items":{"$ref":"#/components/schemas/DetailLabelValueSchema"},"type":"array"},"address":{"description":"Source-provided address; null when unavailable.","nullable":true,"type":"string"},"addresses":{"description":"Addresses on the record; arrests can carry several.","items":{"type":"string"},"type":"array"},"akas":{"description":"Also-known-as names on the record.","items":{"type":"string"},"type":"array"},"dob":{"description":"Source-provided date of birth; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Source-provided defendant name; null when unavailable.","nullable":true,"type":"string"},"sex":{"description":"Source-provided sex; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailDocketEntry":{"properties":{"attorney":{"description":"Source-provided attorney; null when unavailable.","nullable":true,"type":"string"},"date":{"description":"Source-provided entry date; null when unavailable.","nullable":true,"type":"string"},"description":{"description":"Source-provided entry description; null when unavailable.","nullable":true,"type":"string"},"disposition":{"description":"Source-provided disposition; null when unavailable.","nullable":true,"type":"string"},"docketed_date":{"description":"Source-provided docketed date; null when unavailable.","nullable":true,"type":"string"},"document":{"description":"Source-provided document; null when unavailable.","nullable":true,"type":"string"},"entry_number":{"description":"Source-provided entry number; null when unavailable.","nullable":true,"type":"string"},"fee":{"description":"Source-provided fee; null when unavailable.","nullable":true,"type":"string"},"file_type":{"description":"Source-provided file type; null when unavailable.","nullable":true,"type":"string"},"judge":{"description":"Source-provided judge; null when unavailable.","nullable":true,"type":"string"},"location":{"description":"Source-provided location; null when unavailable.","nullable":true,"type":"string"},"misc":{"description":"Source-provided miscellaneous notes; null when unavailable.","nullable":true,"type":"string"},"party":{"description":"Source-provided party; null when unavailable.","nullable":true,"type":"string"},"party_type":{"description":"Source-provided party type; null when unavailable.","nullable":true,"type":"string"},"room":{"description":"Source-provided room; null when unavailable.","nullable":true,"type":"string"},"time":{"description":"Source-provided time; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailDocketEntrySchema":{"properties":{"attorney":{"description":"Source-provided attorney; null when unavailable.","nullable":true,"type":"string"},"date":{"description":"Source-provided entry date; null when unavailable.","nullable":true,"type":"string"},"description":{"description":"Source-provided entry description; null when unavailable.","nullable":true,"type":"string"},"disposition":{"description":"Source-provided disposition; null when unavailable.","nullable":true,"type":"string"},"docketed_date":{"description":"Source-provided docketed date; null when unavailable.","nullable":true,"type":"string"},"document":{"description":"Source-provided document; null when unavailable.","nullable":true,"type":"string"},"entry_number":{"description":"Source-provided entry number; null when unavailable.","nullable":true,"type":"string"},"fee":{"description":"Source-provided fee; null when unavailable.","nullable":true,"type":"string"},"file_type":{"description":"Source-provided file type; null when unavailable.","nullable":true,"type":"string"},"judge":{"description":"Source-provided judge; null when unavailable.","nullable":true,"type":"string"},"location":{"description":"Source-provided location; null when unavailable.","nullable":true,"type":"string"},"misc":{"description":"Source-provided miscellaneous notes; null when unavailable.","nullable":true,"type":"string"},"party":{"description":"Source-provided party; null when unavailable.","nullable":true,"type":"string"},"party_type":{"description":"Source-provided party type; null when unavailable.","nullable":true,"type":"string"},"room":{"description":"Source-provided room; null when unavailable.","nullable":true,"type":"string"},"time":{"description":"Source-provided time; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailFiling":{"properties":{"certificate_number":{"description":"Source-provided certificate number; null when unavailable.","nullable":true,"type":"string"},"court":{"description":"Source-provided court; null when unavailable.","nullable":true,"type":"string"},"court_county":{"description":"Source-provided court county; null when unavailable.","nullable":true,"type":"string"},"expire_date":{"description":"Source-provided expiry date; null when unavailable.","nullable":true,"type":"string"},"file_date":{"description":"Source-provided file date; null when unavailable.","nullable":true,"type":"string"},"file_number_full":{"description":"Source-provided full file number; null when unavailable.","nullable":true,"type":"string"},"file_pages":{"description":"Source-provided file page count; null when unavailable.","nullable":true,"type":"string"},"filing_date":{"description":"Source-provided filing date; null when unavailable.","nullable":true,"type":"string"},"filing_number":{"description":"Source-provided filing number; null when unavailable.","nullable":true,"type":"string"},"filing_office":{"description":"Source-provided filing office; null when unavailable.","nullable":true,"type":"string"},"filing_office_address":{"description":"Source-provided filing office address; null when unavailable.","nullable":true,"type":"string"},"filing_state":{"description":"Source-provided filing state; null when unavailable.","nullable":true,"type":"string"},"filing_type":{"description":"Source-provided filing type; null when unavailable.","nullable":true,"type":"string"},"hidden_filing_number":{"description":"Source-provided hidden filing number; null when unavailable.","nullable":true,"type":"string"},"original_filing_number":{"description":"Source-provided original filing number; null when unavailable.","nullable":true,"type":"string"},"perfected_date":{"description":"Source-provided perfected date; null when unavailable.","nullable":true,"type":"string"},"reference_file_number":{"description":"Source-provided reference file number; null when unavailable.","nullable":true,"type":"string"},"related_file_date":{"description":"Source-provided related file date; null when unavailable.","nullable":true,"type":"string"},"release_date":{"description":"Source-provided release date; null when unavailable.","nullable":true,"type":"string"},"type_of_action":{"description":"Source-provided type of action; null when unavailable.","nullable":true,"type":"string"},"type_of_filing":{"description":"Source-provided type of filing; null when unavailable.","nullable":true,"type":"string"},"type_of_tax":{"description":"Source-provided type of tax; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailFilingSchema":{"properties":{"certificate_number":{"description":"Source-provided certificate number; null when unavailable.","nullable":true,"type":"string"},"court":{"description":"Source-provided court; null when unavailable.","nullable":true,"type":"string"},"court_county":{"description":"Source-provided court county; null when unavailable.","nullable":true,"type":"string"},"expire_date":{"description":"Source-provided expiry date; null when unavailable.","nullable":true,"type":"string"},"file_date":{"description":"Source-provided file date; null when unavailable.","nullable":true,"type":"string"},"file_number_full":{"description":"Source-provided full file number; null when unavailable.","nullable":true,"type":"string"},"file_pages":{"description":"Source-provided file page count; null when unavailable.","nullable":true,"type":"string"},"filing_date":{"description":"Source-provided filing date; null when unavailable.","nullable":true,"type":"string"},"filing_number":{"description":"Source-provided filing number; null when unavailable.","nullable":true,"type":"string"},"filing_office":{"description":"Source-provided filing office; null when unavailable.","nullable":true,"type":"string"},"filing_office_address":{"description":"Source-provided filing office address; null when unavailable.","nullable":true,"type":"string"},"filing_state":{"description":"Source-provided filing state; null when unavailable.","nullable":true,"type":"string"},"filing_type":{"description":"Source-provided filing type; null when unavailable.","nullable":true,"type":"string"},"hidden_filing_number":{"description":"Source-provided hidden filing number; null when unavailable.","nullable":true,"type":"string"},"original_filing_number":{"description":"Source-provided original filing number; null when unavailable.","nullable":true,"type":"string"},"perfected_date":{"description":"Source-provided perfected date; null when unavailable.","nullable":true,"type":"string"},"reference_file_number":{"description":"Source-provided reference file number; null when unavailable.","nullable":true,"type":"string"},"related_file_date":{"description":"Source-provided related file date; null when unavailable.","nullable":true,"type":"string"},"release_date":{"description":"Source-provided release date; null when unavailable.","nullable":true,"type":"string"},"type_of_action":{"description":"Source-provided type of action; null when unavailable.","nullable":true,"type":"string"},"type_of_filing":{"description":"Source-provided type of filing; null when unavailable.","nullable":true,"type":"string"},"type_of_tax":{"description":"Source-provided type of tax; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailLabelValue":{"properties":{"label":{"description":"Display label for the source value.","type":"string"},"value":{"description":"Value paired with the label; null when unavailable.","nullable":true,"type":"string"}},"required":["label"],"type":"object"},"DetailLabelValueSchema":{"properties":{"label":{"description":"Display label for the source value.","type":"string"},"value":{"description":"Value paired with the label; null when unavailable.","nullable":true,"type":"string"}},"required":["label"],"type":"object"},"DetailLienDebtor":{"properties":{"address":{"description":"Source-provided address; null when unavailable.","nullable":true,"type":"string"},"duns_number":{"description":"Source-provided DUNS number; null when unavailable.","nullable":true,"type":"string"},"fein":{"description":"Source-provided federal EIN; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Source-provided name; null when unavailable.","nullable":true,"type":"string"},"owed_amount":{"description":"Source-provided owed amount; null when unavailable.","nullable":true,"type":"string"},"role":{"description":"Source-provided role; null when unavailable.","nullable":true,"type":"string"},"suffix":{"description":"Source-provided name suffix; null when unavailable.","nullable":true,"type":"string"},"type_of_party":{"description":"Source-provided stated party type; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailLienDebtorSchema":{"properties":{"address":{"description":"Source-provided address; null when unavailable.","nullable":true,"type":"string"},"duns_number":{"description":"Source-provided DUNS number; null when unavailable.","nullable":true,"type":"string"},"fein":{"description":"Source-provided federal EIN; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Source-provided name; null when unavailable.","nullable":true,"type":"string"},"owed_amount":{"description":"Source-provided owed amount; null when unavailable.","nullable":true,"type":"string"},"role":{"description":"Source-provided role; null when unavailable.","nullable":true,"type":"string"},"suffix":{"description":"Source-provided name suffix; null when unavailable.","nullable":true,"type":"string"},"type_of_party":{"description":"Source-provided stated party type; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailMeeting341":{"properties":{"date":{"description":"Source-provided meeting date; null when unavailable.","nullable":true,"type":"string"},"location":{"description":"Source-provided meeting location; null when unavailable.","nullable":true,"type":"string"},"time":{"description":"Source-provided meeting time; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailMeeting341Schema":{"properties":{"date":{"description":"Source-provided meeting date; null when unavailable.","nullable":true,"type":"string"},"location":{"description":"Source-provided meeting location; null when unavailable.","nullable":true,"type":"string"},"time":{"description":"Source-provided meeting time; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailParty":{"properties":{"address":{"description":"Source-provided address; null when unavailable.","nullable":true,"type":"string"},"akas":{"description":"Also-known-as names on the party.","items":{"type":"string"},"type":"array"},"attorneys":{"description":"Attorneys the source ties to this party.","items":{"$ref":"#/components/schemas/DetailAttorney"},"type":"array"},"name":{"description":"Source-provided party name; null when unavailable.","nullable":true,"type":"string"},"phone":{"description":"Source-provided phone number; null when unavailable.","nullable":true,"type":"string"},"reported_date":{"description":"Source-provided reported date; null when unavailable.","nullable":true,"type":"string"},"role":{"description":"Source-provided role; null when unavailable.","nullable":true,"type":"string"},"sex":{"description":"Source-provided sex; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Source-provided status; null when unavailable.","nullable":true,"type":"string"},"type_of_party":{"description":"Source-provided stated party type; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailPartySchema":{"properties":{"address":{"description":"Source-provided address; null when unavailable.","nullable":true,"type":"string"},"akas":{"description":"Also-known-as names on the party.","items":{"type":"string"},"type":"array"},"attorneys":{"description":"Attorneys the source ties to this party.","items":{"$ref":"#/components/schemas/DetailAttorneySchema"},"type":"array"},"name":{"description":"Source-provided party name; null when unavailable.","nullable":true,"type":"string"},"phone":{"description":"Source-provided phone number; null when unavailable.","nullable":true,"type":"string"},"reported_date":{"description":"Source-provided reported date; null when unavailable.","nullable":true,"type":"string"},"role":{"description":"Source-provided role; null when unavailable.","nullable":true,"type":"string"},"sex":{"description":"Source-provided sex; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Source-provided status; null when unavailable.","nullable":true,"type":"string"},"type_of_party":{"description":"Source-provided stated party type; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailSource":{"properties":{"publication_date":{"description":"Source-provided publication date; null when unavailable.","nullable":true,"type":"string"},"source_document_guid":{"description":"Source-provided source document reference; null when unavailable.","nullable":true,"type":"string"},"source_name":{"description":"Source-provided source name; null when unavailable.","nullable":true,"type":"string"},"source_state":{"description":"Source-provided source state; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailSourceSchema":{"properties":{"publication_date":{"description":"Source-provided publication date; null when unavailable.","nullable":true,"type":"string"},"source_document_guid":{"description":"Source-provided source document reference; null when unavailable.","nullable":true,"type":"string"},"source_name":{"description":"Source-provided source name; null when unavailable.","nullable":true,"type":"string"},"source_state":{"description":"Source-provided source state; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"DetailsBusinessWrite":{"additionalProperties":false,"description":"Business details to update.","properties":{"billing_address":{"allOf":[{"$ref":"#/components/schemas/AddressWrite"}],"description":"Billing address of the business.","nullable":true},"dba":{"description":"Trading name (DBA) of the business.","nullable":true,"type":"string"},"emails":{"description":"Email addresses of the business. Replaces the emails you sent before.","items":{"$ref":"#/components/schemas/EmailWrite"},"nullable":true,"type":"array"},"entity_type":{"description":"Legal structure of the business, for example `llc` or `corp`.","enum":["llc","inc","corp","lp","llp","partnership","sole_proprietor","ltd","plc","co","pc","pllc","unknown",null],"nullable":true},"heron_id":{"description":"The business's `heron_id` from `GET /end_users/{id}/details`. Required if the deal already has a business.","nullable":true,"type":"string"},"identifiers":{"description":"Business identifiers, such as the EIN. Replaces the identifiers you sent before.","items":{"$ref":"#/components/schemas/CompanyIdWrite"},"nullable":true,"type":"array"},"legal_name":{"description":"Legal name of the business.","nullable":true,"type":"string"},"phone_number":{"allOf":[{"$ref":"#/components/schemas/PhoneWrite"}],"description":"Phone number of the business.","nullable":true},"physical_address":{"allOf":[{"$ref":"#/components/schemas/AddressWrite"}],"description":"Physical address of the business.","nullable":true},"started_on":{"allOf":[{"$ref":"#/components/schemas/PartialDateWrite"}],"description":"Date the business started. The month and day are optional.","nullable":true},"state_of_incorporation":{"description":"State where the business is incorporated, as a name or a two-letter code.","nullable":true,"type":"string"},"website":{"description":"Website of the business.","nullable":true,"type":"string"}},"type":"object"},"DetailsOwnerWrite":{"additionalProperties":false,"description":"Owner details to update.","properties":{"aliases":{"description":"Other names of the owner.","items":{"$ref":"#/components/schemas/PersonAliasWrite"},"nullable":true,"type":"array"},"credit_scores":{"description":"Credit scores of the owner. Use `heron_id` to update a score. Leave it out to add a new one.","items":{"$ref":"#/components/schemas/CreditScoreWrite"},"nullable":true,"type":"array"},"date_of_birth":{"allOf":[{"$ref":"#/components/schemas/PartialDateWrite"}],"description":"Date of birth.","nullable":true},"emails":{"description":"Email addresses of the owner. Replaces the emails you sent before.","items":{"$ref":"#/components/schemas/EmailWrite"},"nullable":true,"type":"array"},"heron_id":{"description":"The owner's `heron_id` from `GET /end_users/{id}/details`. Leave it out to add a new owner.","nullable":true,"type":"string"},"home_address":{"allOf":[{"$ref":"#/components/schemas/AddressWrite"}],"description":"Home address of the owner.","nullable":true},"home_phone_number":{"allOf":[{"$ref":"#/components/schemas/PhoneWrite"}],"description":"Home phone number of the owner.","nullable":true},"mobile_phone_number":{"allOf":[{"$ref":"#/components/schemas/PhoneWrite"}],"description":"Mobile phone number of the owner.","nullable":true},"name":{"allOf":[{"$ref":"#/components/schemas/PersonNameWrite"}],"description":"Name of the owner.","nullable":true},"national_ids":{"description":"National identifiers, such as the SSN. Replaces the identifiers you sent before.","items":{"$ref":"#/components/schemas/NationalIdWrite"},"nullable":true,"type":"array"},"ownership_percentage":{"description":"Percentage of the business the owner owns, from 0 to 100.","maximum":100.0,"minimum":0.0,"nullable":true,"type":"number"}},"type":"object"},"DetailsWriteSchema":{"additionalProperties":false,"description":"Updates the business and owner details. Fields you do not send stay as they are. To remove a value you set, send `null`. The response is the same as `GET /end_users/{id}/details`.","properties":{"business":{"allOf":[{"$ref":"#/components/schemas/DetailsBusinessWrite"}],"description":"Business details to update.","nullable":true},"owners":{"description":"Owners to update or add. Use `heron_id` to update an existing owner. Leave it out to add a new one.","items":{"$ref":"#/components/schemas/DetailsOwnerWrite"},"type":"array"}},"type":"object"},"DriversLicenceFrontResultSchema":{"properties":{"address_city":{"nullable":true,"type":"string"},"address_line_1":{"nullable":true,"type":"string"},"address_state":{"nullable":true,"type":"string"},"address_zip":{"nullable":true,"type":"string"},"date_of_birth":{"format":"date","nullable":true,"type":"string"},"document_number":{"nullable":true,"type":"string"},"expiration_date":{"format":"date","nullable":true,"type":"string"},"first_name":{"nullable":true,"type":"string"},"issuing_date":{"format":"date","nullable":true,"type":"string"},"issuing_state":{"nullable":true,"type":"string"},"issuing_state_code":{"nullable":true,"type":"string"},"last_name":{"nullable":true,"type":"string"},"middle_name":{"nullable":true,"type":"string"}},"type":"object"},"DrivingLicence":{"properties":{"agreement_score":{"description":"How far the front and barcode readings agree, from 0 to 1; null when only one side was read.","nullable":true,"type":"number"},"evidence_level":{"description":"How far the document itself can be trusted, from how its sides were read and the barcode signature: signed_and_corroborated, signed, corroborated, barcode_only, scan_only, unresolved or suspect.","enum":["signed_and_corroborated","signed","corroborated","barcode_only","scan_only","unresolved","suspect"]},"expired":{"description":"Whether the expiry date has passed.","type":"boolean"},"expires_on":{"description":"The licence expiry date in ISO 8601 format; null when the parse gave none.","format":"date","nullable":true,"type":"string"},"flags":{"description":"Codes for how the front and barcode readings differed, e.g. names_swapped; an ambiguous licence also carries unresolved_tie.","items":{"type":"string"},"type":"array"},"issued_on":{"description":"The licence issue date in ISO 8601 format; null when the parse gave none.","format":"date","nullable":true,"type":"string"},"number":{"description":"The licence number as the document states it.","type":"string"},"pairing_status":{"description":"How the licence's front and barcode readings matched: paired, partial_match, front_only, back_only or ambiguous. An ambiguous reading stays a licence of its own.","enum":["paired","partial_match","ambiguous","front_only","back_only"]},"signature_outcome":{"description":"Whether the barcode's issuer signature checked out: valid, invalid, unsigned, not_supported or malformed; null when no barcode was read.","nullable":true,"type":"string"},"state":{"description":"The issuing state's two-letter code; null when the parse gave none or it named no single state.","nullable":true,"type":"string"}},"type":"object"},"DuplicateEndUser":{"properties":{"created":{"description":"When the duplicate end user was created","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"end_user_heron_id":{"description":"Heron ID of the duplicate end user","example":"eus_abc123","type":"string"},"name":{"description":"Name of the duplicate end user","example":"Acme Corp","nullable":true,"type":"string"}},"required":["created","end_user_heron_id"],"type":"object"},"DuplicateEndUsersResponse":{"properties":{"duplicates":{"description":"List of duplicate end users with their heron IDs, names, and created dates","items":{"$ref":"#/components/schemas/DuplicateEndUser"},"type":"array"}},"required":["duplicates"],"type":"object"},"EmailTemplatePatchSchema":{"additionalProperties":true,"properties":{"cc_address":{"description":"The email address to CC","nullable":true,"type":"string"},"heron_id":{"description":"Unique identifier for the email template","readOnly":true,"type":"string"},"html_body":{"description":"The body of the email to send.","type":"string"},"name":{"description":"Unique name of the email template. Used to match which email template to send. Only alphanumeric characters, underscores, and dashes are allowed.","maxLength":50,"minLength":3,"pattern":"^[a-zA-Z0-9_-]+$","type":"string"},"reply_to_address":{"description":"The email address to reply to","nullable":true,"type":"string"},"to_address":{"description":"The email address to send the email to","nullable":true,"type":"string"}},"type":"object"},"EmailTemplateSchema":{"additionalProperties":true,"properties":{"cc_address":{"description":"The email address to CC","nullable":true,"type":"string"},"heron_id":{"description":"Unique identifier for the email template","readOnly":true,"type":"string"},"html_body":{"description":"The body of the email to send.","type":"string"},"name":{"description":"Unique name of the email template. Used to match which email template to send. Only alphanumeric characters, underscores, and dashes are allowed.","maxLength":50,"minLength":3,"pattern":"^[a-zA-Z0-9_-]+$","type":"string"},"reply_to_address":{"description":"The email address to reply to","nullable":true,"type":"string"},"to_address":{"description":"The email address to send the email to","nullable":true,"type":"string"}},"required":["html_body","name"],"type":"object"},"EmailWrite":{"additionalProperties":false,"properties":{"email_address":{"description":"The email address.","type":"string"}},"type":"object"},"EmbedBackgroundCheckSchema":{"properties":{"background_check":{"$ref":"#/components/schemas/BackgroundCheckResponseSchema"},"deal_name":{"type":"string"},"open_in_heron_url":{"type":"string"},"state":{"enum":["not_enabled","not_run","trial_exhausted","missing_inputs","running","failed","not_found","complete"]},"trial":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckTrial"}],"description":"Trial run allowance, or null when background check runs are unlimited.","nullable":true}},"required":["deal_name","open_in_heron_url","state"],"type":"object"},"EndUser":{"properties":{"confidence":{"description":"Aggregated confidence for the end user across all transactions; between 0 and 1","example":0.42,"nullable":true,"readOnly":true,"type":"number"},"created":{"description":"When the end user was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"criteria":{"description":"List of scorecard metrics","items":{"$ref":"#/components/schemas/Metric"},"nullable":true,"readOnly":true,"type":"array"},"data_sources":{"description":"List of data source summaries for the end user","items":{"$ref":"#/components/schemas/DataSource"},"readOnly":true,"type":"array"},"end_user_id":{"description":"id defined by user; links to the end_user_id for transactions","example":"7cb48787-6d91-5b9f-bc60-f30298ea5736","maxLength":140,"minLength":1,"type":"string"},"heron_id":{"description":"Unique id for end user generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","readOnly":true,"type":"string"},"is_portfolio":{"description":"Whether the end user is part of a lending portfolio","example":true,"type":"boolean"},"last_processed_at":{"description":"When the end user was last successfully processed in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"readOnly":true,"type":"string"},"last_updated":{"description":"When the end user was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"meta":{"additionalProperties":{"type":"string"},"description":"Arbitrary key-value metadata. Max 20 keys, key \u226464 chars, value \u2264256 chars, total \u22644KB. Example: {\"attribution_key\": \"lender_42\"}","nullable":true,"type":"object"},"name":{"description":"Name of end user; may help to improve categorisation accuracy","example":"Company Name Inc.","maxLength":128,"nullable":true,"type":"string"},"profit_and_loss_layout":{"nullable":true},"status":{"description":"Status of end user; 'ready' triggers async processing, 'review_requested' triggers manual review request","enum":["new","ready","processed","reviewed","review_requested","failed"],"example":"ready","type":"string"},"tags":{"description":"Tags currently applied to this end user, read-only. Absent unless the endpoint returns them.","items":{"$ref":"#/components/schemas/TagSchema"},"readOnly":true,"type":"array"}},"required":["end_user_id"],"type":"object"},"EndUser1":{"properties":{"end_user_id":{"description":"id defined by user; links to the end_user_id for transactions","example":"7cb48787-6d91-5b9f-bc60-f30298ea5736","maxLength":140,"minLength":1,"type":"string"},"heron_id":{"description":"Unique id for end user generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","readOnly":true,"type":"string"},"name":{"description":"Name of end user; may help to improve categorisation accuracy","example":"Company Name Inc.","maxLength":128,"nullable":true,"type":"string"}},"required":["end_user_id"],"type":"object"},"EndUser2":{"properties":{"heron_id":{"description":"Unique id for end user generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","readOnly":true,"type":"string"}},"type":"object"},"EndUserAccountBalance":{"properties":{"account_id":{"description":"Account associated with balance","type":"string"},"account_info":{"allOf":[{"$ref":"#/components/schemas/EndUserAccountInfo"}],"nullable":true},"balance":{"description":"Balance amount","type":"number"},"balance_converted":{"description":"Converted balance amount in target currency","type":"number"},"currency":{"description":"ISO 4217 currency code for balance","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"currency_converted":{"description":"Conversion currency code. ISO 4217 currency code for balance","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"display_account_id":{"description":"Human-readable account label for display: the last four digits of the account number without heron_account_suffix (falling back to the account name). Not unique and not a key; use account_id to join.","example":"7505","nullable":true,"type":"string"},"heron_account_suffix":{"description":"Added by Heron to tell apart accounts that print the same account number, such as a checking account and its reserve line. Not printed by the bank. A 3-digit suffix is the order the accounts appear in one file, so the same account can get a different one in another file. Null when the printed number needed no suffix.","example":"001","nullable":true,"type":"string"},"is_computed":{"description":"Whether the balance has been imputed using forward fill","type":"boolean"},"is_latest":{"description":"Whether the date is the latest non-imputed balance for the account","type":"boolean"},"timestamp":{"description":"Timestamp of the latest transaction","format":"date-time","nullable":true,"type":"string"}},"type":"object"},"EndUserAccountBalanceForecast":{"properties":{"account_id":{"type":"string"},"balances":{"items":{"$ref":"#/components/schemas/EndUserBalanceForecast"},"type":"array"},"currency":{"type":"string"}},"type":"object"},"EndUserAccountInfo":{"properties":{"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"heron_id":{"description":"Heron ID of the data source account","example":"dsa_8Wezdyj8LMyX4pv7bLzJ2f","type":"string"},"institution_name":{"description":"Name of the institution","example":"Chase","nullable":true,"type":"string"},"name":{"description":"Name of the account","example":"Checking Account","type":"string"},"number":{"description":"Number of the account","example":"123456789","nullable":true,"type":"string"},"owner_name":{"description":"Name of the account owner","example":"John Doe","nullable":true,"type":"string"},"type":{"description":"Type of the account","example":"Checking","nullable":true,"type":"string"}},"type":"object"},"EndUserAddressLocationSchema":{"properties":{"company_physical_address":{"allOf":[{"$ref":"#/components/schemas/AddressLocation"}],"nullable":true}},"type":"object"},"EndUserBalanceForecast":{"properties":{"date":{"description":"Forecast date at specified date granularity","example":"2026-02-26","type":"string"},"predicted":{"description":"Predicted converted balance","example":42.42,"type":"number"},"predicted_lower":{"description":"Predict amount lower bound","example":4.24,"type":"number"},"predicted_upper":{"description":"Predicted amount upper bound","example":420.42,"type":"number"}},"type":"object"},"EndUserBalanceInputParams":{"properties":{"account_ids":{"default":[],"description":"Filter by specific account reference IDs","example":["1234","5678"],"items":{"type":"string"},"type":"array"},"date_max":{"description":"Filter for transactions with date earlier than the input value (inclusive). It has precedence over timestamp_max","example":"2026-02-26","format":"date","nullable":true,"type":"string"},"date_min":{"description":"Filter for transactions with timestamp after the input value (inclusive). It has precedence over timestamp_min","example":"2026-02-26","format":"date","nullable":true,"type":"string"},"end_user_heron_id":{"description":"Heron-generated id for end user; either end_user_id or end_user_heron_id is required","example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"},"end_user_id":{"description":"end_user_id for statistics; either end_user_id or end_user_heron_id is required","example":"your_end_user_id","nullable":true,"type":"string"},"include_forecast":{"default":false,"description":"If true, forecasts the balances of each account","type":"boolean"},"timestamp_max":{"description":"Deprecated (use date_max instead). Filter for transactions with timestamp earlier than the input value","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"type":"string"},"timestamp_min":{"description":"Deprecated (use date_min instead). Filter for transactions with timestamp after the input value","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"type":"string"},"to_currency":{"description":"ISO 4217 currency code to convert to","enum":["GBP","USD","EUR","CAD","AUD",null],"example":"USD","nullable":true,"type":"string"}},"type":"object"},"EndUserBalanceOutputSchema":{"properties":{"daily_balances":{"items":{"$ref":"#/components/schemas/EndUserDailyBalance"},"type":"array"},"forecasted":{"items":{"$ref":"#/components/schemas/EndUserAccountBalanceForecast"},"type":"array"},"summary":{"allOf":[{"$ref":"#/components/schemas/EndUserDailyBalance"}],"nullable":true},"warnings":{"description":"Empty-balance reason codes. Populated responses return an empty list.","items":{"enum":["no_transactions_present","transactions_present_but_not_enriched","transactions_enriched_but_no_balance_data"],"type":"string"},"type":"array"}},"type":"object"},"EndUserBankStatementSummary":{"properties":{"all_transactions_summary":{"allOf":[{"$ref":"#/components/schemas/EndUserBankStatementSummaryContent"}],"description":"The same summary over every loaded transaction, where the fields above narrow to files that reconciled, or that predate reconciliation checks, whatever their file class. Bank connections and other non-file sources are in both, so a deal with no files reports the same figures twice. Grouped the same way as the request asked for. When the end user does not load unreconciled transactions the two views are identical, and this mirrors the summary.","nullable":true},"average":{"$ref":"#/components/schemas/BankStatementSummaryRow"},"by_data_source_account_heron_id":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"description":"Summary of bank statement by data source account. Keys are heron ids of the data source account","nullable":true,"type":"object"},"by_month":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"description":"Summary of bank statement by month (only populated when grouping is calendar_month))","nullable":true,"type":"object"},"by_month_by_account":{"additionalProperties":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"type":"object"},"description":"Summary of bank statement by month and account id. Keys are the start date of the month and account ids, which may span multiple data source accounts","nullable":true,"type":"object"},"by_month_by_data_source_account_heron_id":{"additionalProperties":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"type":"object"},"description":"Summary of bank statement by month and data source account. Keys are the start date of the month and heron ids of the data source account","nullable":true,"type":"object"},"grouping":{"description":"Describes how the report was grouped. It supports either by calendar month or rolling 30-day period","readOnly":true,"type":"string"},"rolling_30_days_from_last_txn":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"description":"Summary of bank statement by rolling 30 days (only populated when grouping is rolling_30_days). Keys are the start date of the 30-day period using latest transaction date date as the end date","nullable":true,"type":"object"},"rolling_30_days_from_today":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"description":"Summary of bank statement by rolling 30 days (only populated when grouping is rolling_30_days_from_today). Keys are the start date of the 30-day period using today as the end date","nullable":true,"type":"object"},"total":{"$ref":"#/components/schemas/BankStatementSummaryRow"}},"required":["grouping"],"type":"object"},"EndUserBankStatementSummaryContent":{"properties":{"average":{"$ref":"#/components/schemas/BankStatementSummaryRow"},"by_data_source_account_heron_id":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"description":"Summary of bank statement by data source account. Keys are heron ids of the data source account","nullable":true,"type":"object"},"by_month":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"description":"Summary of bank statement by month (only populated when grouping is calendar_month))","nullable":true,"type":"object"},"by_month_by_account":{"additionalProperties":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"type":"object"},"description":"Summary of bank statement by month and account id. Keys are the start date of the month and account ids, which may span multiple data source accounts","nullable":true,"type":"object"},"by_month_by_data_source_account_heron_id":{"additionalProperties":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"type":"object"},"description":"Summary of bank statement by month and data source account. Keys are the start date of the month and heron ids of the data source account","nullable":true,"type":"object"},"grouping":{"description":"Describes how the report was grouped. It supports either by calendar month or rolling 30-day period","readOnly":true,"type":"string"},"rolling_30_days_from_last_txn":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"description":"Summary of bank statement by rolling 30 days (only populated when grouping is rolling_30_days). Keys are the start date of the 30-day period using latest transaction date date as the end date","nullable":true,"type":"object"},"rolling_30_days_from_today":{"additionalProperties":{"allOf":[{"$ref":"#/components/schemas/BankStatementSummaryRow"}],"nullable":true},"description":"Summary of bank statement by rolling 30 days (only populated when grouping is rolling_30_days_from_today). Keys are the start date of the 30-day period using today as the end date","nullable":true,"type":"object"},"total":{"$ref":"#/components/schemas/BankStatementSummaryRow"}},"required":["grouping"],"type":"object"},"EndUserBankStatementSummaryParams":{"properties":{"account_ids":{"description":"Account ids to include in the summary, if not provided, all accounts are included","items":{"example":"1234","type":"string"},"nullable":true,"type":"array"},"grouping":{"default":"by_month","description":"Determines how to group transactions. It supports calendar month (by_month) or rolling 30-day period (from last txns with rolling_30_days_from_last_txn or from today with rolling_30_days_from_today)","enum":["by_month","by_data_source_account_heron_id","rolling_30_days_from_last_txn","rolling_30_days_from_today","by_month_by_data_source_account_heron_id","by_month_by_account","by_data_source_account_by_monthly_intervals"],"type":"string"},"num_full_calendar_months":{"description":"Number of full calendar months to show in the summary","minimum":1,"nullable":true,"type":"integer"}},"type":"object"},"EndUserBulkCategoryFeedback":{"properties":{"category":{"$ref":"#/components/schemas/CategoryFeedback"},"source":{"description":"your identifier for where the feedback comes from e.g. bob_the_underwriter","maxLength":120,"nullable":true,"type":"string"},"transaction_heron_ids":{"default":[],"description":"List of transaction heron IDs","items":{"example":"txn_9oPspuxisSVyboAqnR2L4Q","type":"string"},"type":"array"},"transaction_reference_ids":{"default":[],"description":"List of transaction reference IDs","items":{"example":"your_reference_id","type":"string"},"type":"array"}},"required":["category"],"type":"object"},"EndUserBulkCategoryFeedbackParams":{"properties":{"high_priority":{"default":false,"description":"Whether to process the feedback with high priority","type":"boolean"}},"type":"object"},"EndUserBulkMerchantFeedback":{"properties":{"merchant":{"$ref":"#/components/schemas/MerchantFeedback1"},"transaction_heron_ids":{"description":"List of transaction heron IDs","items":{"example":"txn_9oPspuxisSVyboAqnR2L4Q","type":"string"},"type":"array"}},"required":["merchant","transaction_heron_ids"],"type":"object"},"EndUserDailyBalance":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/EndUserAccountBalance"},"type":"array"},"accounts_not_converted":{"items":{"$ref":"#/components/schemas/EndUserAccountBalance"},"type":"array"},"balance":{"description":"Balance amount","type":"number"},"currency":{"description":"ISO 4217 currency code for balance","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"date":{"description":"Date of balance","format":"date","type":"string"}},"type":"object"},"EndUserDataSource":{"properties":{"created":{"description":"When the data source was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"data_source_accounts":{"description":"List of data source accounts associated with the data source","example":[{"account_id":"202348","anomaly_reasons":["Statement metadata changed","Manual review flagged suspicious edits"],"anomaly_score":200,"enabled":true,"max_date":"2022-01-31","min_date":"2022-01-01","num_transactions":120,"transactions_match_balances":true}],"items":{"$ref":"#/components/schemas/DataSourceAccount"},"type":"array"},"heron_id":{"description":"Unique ID for data source generated by Heron","example":"dso_StvEAbtRd2LLU6n8LjQDwS","readOnly":true,"type":"string"},"is_enabled":{"default":true,"description":"Whether or not the data source is enabled. If disabled, hides related transactions from analytics","example":true,"type":"boolean"},"last_updated":{"description":"When the data source was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/DataSourceMetadata"}],"description":"Metadata associated with the data source","example":{"filename":"202348_JAN_2022.pdf","status":"processed"}},"reference_id":{"description":"Unique ID to identify the data source","example":"pdf_ipa38qiztYHMFuSDDqN6m5","type":"string"},"status":{"description":"Status of the data source entity, where applicable (e.g. pdfs, integration links)","enum":["new","parsing","parsed","processed","human_reviewing","approved","rejected","failed","transactions_loaded","transactions_unloaded","pending","active","syncing","erroring","sync_disabled","deleted_in_plaid","unknown"],"example":"new","type":"string"},"type":{"description":"Data source type","enum":["api","csv","pdf","integration_link","legacy","legacy_pdf","legacy_integration_link"],"example":"pdf","type":"string"}},"required":["created","data_source_accounts","heron_id","last_updated","reference_id","type"],"type":"object"},"EndUserDataSourceAccount":{"properties":{"account_id":{"description":"PDF statement account identifier. Null for non-PDF sources.","example":"202348","nullable":true,"type":"string"},"account_type":{"description":"Heron's full account type, the same for every source: business_checking, business_savings, personal, escrow or credit_loan. Open-banking accounts get it only for checking and savings whose owner is known. Null when Heron can't tell.","enum":["business_checking","business_savings","personal","escrow","credit_loan",null],"example":"business_checking","nullable":true,"readOnly":true},"anomaly_reasons":{"description":"Reasons associated with anomaly_score for pdf bank statement account sources","example":["Statement metadata changed","Manual review flagged suspicious edits"],"items":{"type":"string"},"nullable":true,"type":"array"},"anomaly_score":{"description":"For pdf bank statement account sources, where the value is between 0 and 1000, with 1000 being the most anomalous","example":200,"type":"integer"},"balances":{"description":"List of balances associated with the account","example":[{"closing_amount":25000.45,"currency":"USD","date":"2022-01-01"}],"items":{"$ref":"#/components/schemas/AccountBalance"},"type":"array"},"currency":{"description":"Currency of the account","example":"USD","type":"string"},"dba":{"description":"Doing Business As name printed on the bank statement","example":"Chickys","nullable":true,"type":"string"},"disabled_reason":{"description":"Why this account is disabled. An account we never processed was created disabled with no transactions: excluded_account_type (legacy or unknown account-type exclusion), excluded_personal_account, excluded_business_savings_account, excluded_escrow_account, excluded_credit_loan_account, loan_account, reviewer_excluded, not_an_account (an empty section of the document that is not an account, such as a summary box), excluded_bank (a bank or service provider the workflow skips), account_id_mismatch (the account number does not match the account_id sent on upload), failed_checks (the statement was parsed but failed our checks, so the file was rejected), or unverifiable_statement (missing pages or no balances). An account turned off after it loaded has one of: duplicate_statement (another file holds the same statement), duplicate_coverage (another statement already covers these dates), disabled_by_user, or no_longer_returned_by_provider (the bank connection, e.g. Plaid, stopped returning it). Null for an enabled account, for a bank-connection account the workflow's account filters turned off, and for one disabled before these reasons existed.","enum":["excluded_account_type","excluded_personal_account","excluded_business_savings_account","excluded_escrow_account","excluded_credit_loan_account","loan_account","reviewer_excluded","not_an_account","excluded_bank","account_id_mismatch","failed_checks","unverifiable_statement","duplicate_statement","duplicate_coverage","disabled_by_user","no_longer_returned_by_provider",null],"example":"excluded_account_type","nullable":true},"disabled_reason_description":{"description":"Customer-facing explanation of why the account is disabled.","example":"Heron didn't load transactions because this workflow excludes business savings accounts.","nullable":true,"readOnly":true,"type":"string"},"display_account_id":{"description":"Human-readable account label for display: the last four digits of the account number without heron_account_suffix (falling back to the account title). Not unique and not a key; join heron_id to data_source_account_heron_id on transactions.","example":"7505","nullable":true,"type":"string"},"end_date":{"description":"End date of the account","example":"2022-01-31","format":"date","type":"string"},"heron_account_suffix":{"description":"Added by Heron to tell apart accounts that print the same account number, such as a checking account and its reserve line. Not printed by the bank. A 3-digit suffix is the order the accounts appear in one file, so the same account can get a different one in another file. Null when the printed number needed no suffix.","example":"001","nullable":true,"type":"string"},"heron_id":{"description":"Unique ID for data source generated by Heron","example":"dso_StvEAbtRd2LLU6n8LjQDwS","type":"string"},"institution_name":{"description":"Name of the institution","example":"Chase","type":"string"},"is_enabled":{"description":"Whether or not the account is enabled. If disabled, hides related transactions from analytics","example":true,"type":"boolean"},"max_date":{"description":"Latest date of transactions associated with the data source account","example":"2022-01-31","format":"date","type":"string"},"min_date":{"description":"Earliest date of transactions associated with the data source account","example":"2022-01-01","format":"date","type":"string"},"name":{"description":"Name of the account","example":"Checking Account","nullable":true,"type":"string"},"num_transactions":{"description":"Number of transactions associated with the data source account","example":120,"type":"integer"},"number":{"description":"Number of the account","example":"123456789","nullable":true,"type":"string"},"owner_name":{"description":"Name of the account owner","example":"John Doe","type":"string"},"printed_account_number":{"description":"The account number without heron_account_suffix: the number and any sub-account the bank printed. Same as number when there is no suffix.","example":"1-458-1824-4066","nullable":true,"type":"string"},"reference_id":{"description":"This is the account ID provided as part of the transaction","example":"account-202348","type":"string"},"start_date":{"description":"Start date of the account","example":"2022-01-01","format":"date","type":"string"},"transactions_match_balances":{"description":"For pdf bank statements, represents whether all transactions extracted match the balances extracted","example":true,"type":"boolean"},"type":{"description":"Raw account type. Bank statements: business, personal or unknown. Open banking: the provider's own value, e.g. CHECKING, SAVINGS or Plaid's depository. Not the same across sources; use account_type to tell business checking from other accounts.","example":"business","nullable":true,"type":"string"}},"required":["is_enabled"],"type":"object"},"EndUserDataSourceAccountDisableDuplicatesSchema":{"properties":{"end_date":{"format":"date","nullable":true,"type":"string"},"start_date":{"format":"date","nullable":true,"type":"string"}},"type":"object"},"EndUserDataSourceAccountSummarySchema":{"properties":{"grouping":{"default":"by_data_source_account_heron_id","enum":["by_data_source_account_heron_id","by_data_source_account_by_monthly_intervals"],"type":"string"}},"type":"object"},"EndUserDataSourceAccountUpdateSchema":{"properties":{"is_enabled":{"description":"Whether or not the account is enabled. If disabled, hides related transactions from analytics","example":true,"type":"boolean"}},"type":"object"},"EndUserDataSourceMetadata":{"properties":{"currency":{"description":"Currency associated with the data source entity, where applicable (e.g. pdfs)","example":"USD","type":"string"},"filename":{"description":"Name of the file uploaded, where applicable (e.g. pdfs)","example":"202348_JAN_2022.pdf","nullable":true,"type":"string"},"integration_heron_id":{"description":"Unique Heron ID associated with an integration","example":"itg_kiQpir7WkK8AbyhqUNMT5T","type":"string"},"integration_item_id":{"description":"Unique item id associated with integration link data sources","example":"Ed6bjNrDLJfGvZWwnkQlfxwoNz54B5C97ejBr","type":"string"},"last_successful_sync":{"description":"Last successful sync date associated with integration link data sources","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"type":"string"},"notes":{"description":"Customer-facing data source status message. Null for a newly uploaded PDF.","example":"Statement processed successfully. All balances verified.","nullable":true,"type":"string"},"parsing_version":{"description":"Parsing version associated with the data source entity, where applicable (e.g. pdfs)","example":"1.0.0","type":"string"},"sub_type":{"description":"Sub type of the data source entity, where applicable (e.g. integration links)","example":"transaction","type":"string"}},"type":"object"},"EndUserDataSourceSummaries":{"properties":{"status":{"description":"Status of the data source entity, where applicable (e.g. pdfs, integration links)","enum":["new","parsing","parsed","processed","human_reviewing","approved","rejected","failed","transactions_loaded","transactions_unloaded","pending","active","syncing","erroring","sync_disabled","deleted_in_plaid","unknown"],"example":"new","type":"string"},"type":{"description":"Data source type","enum":["api","csv","pdf","integration_link","legacy","legacy_pdf","legacy_integration_link"],"example":"pdf","type":"string"}},"required":["type"],"type":"object"},"EndUserDataSourceSummarySchema":{"properties":{"all_reconciled":{"nullable":true,"type":"boolean"},"alteration_coverage":{"allOf":[{"$ref":"#/components/schemas/AlterationCoverage"}],"description":"Present on PDF sources when alteration results are shown. Null when the file has no alteration check yet, or its stored result cannot be read.","nullable":true},"alteration_risk":{"enum":["green","amber","red"],"type":"string"},"anomaly_reasons":{"items":{"type":"string"},"nullable":true,"type":"array"},"created":{"description":"When the data source was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"data_source_accounts":{"description":"List of data source accounts associated with the data source","example":[{"account_id":"202348","anomaly_reasons":["Statement metadata changed","Manual review flagged suspicious edits"],"anomaly_score":200,"enabled":true,"max_date":"2022-01-31","min_date":"2022-01-01","num_transactions":120,"transactions_match_balances":true}],"items":{"$ref":"#/components/schemas/EndUserDataSourceAccount"},"type":"array"},"end_user_file_heron_id":{"nullable":true,"type":"string"},"end_user_file_reference_id":{"nullable":true,"type":"string"},"file_class":{"description":"File class for PDF sources, such as `bank_statement` or `month_to_date`. Null for non-PDF sources.","nullable":true,"type":"string"},"filename":{"nullable":true,"type":"string"},"has_unexplained_edits":{"nullable":true,"type":"boolean"},"heron_id":{"description":"Unique ID for data source generated by Heron","example":"dso_StvEAbtRd2LLU6n8LjQDwS","readOnly":true,"type":"string"},"is_enabled":{"default":true,"description":"Whether or not the data source is enabled. If disabled, hides related transactions from analytics","example":true,"type":"boolean"},"last_updated":{"description":"When the data source was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"max_anomaly_score":{"nullable":true,"type":"integer"},"max_date":{"format":"date","nullable":true,"type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/EndUserDataSourceMetadata"}],"description":"Metadata associated with the data source","example":{"filename":"202348_JAN_2022.pdf","status":"processed"}},"min_date":{"format":"date","nullable":true,"type":"string"},"num_extracted_transactions":{"nullable":true,"type":"integer"},"num_statements":{"nullable":true,"type":"integer"},"num_transactions":{"type":"integer"},"reconciliation_method":{"description":"How the reconciliation verdict was set: `start_and_end_balance`, `running_balance`, `summary_derived`, `total_debits_credits`, or `zero_balances` for ladder checks; `human` for a reviewer. Null means no method decided the verdict, including when nothing could be checked or when the reconciliation status is null.","enum":["start_and_end_balance","summary_derived","running_balance","total_debits_credits","zero_balances","human",null],"nullable":true},"reconciliation_status":{"description":"Stored reconciliation verdict. `reconciled` means a ladder check passed or a reviewer confirmed the document. `not_possible` means nothing available could verify it. `failed` means a ladder check failed or a reviewer ruled it unreconciled. Null means neither the ladder nor a reviewer set a verdict.","enum":["failed","not_possible","reconciled",null],"nullable":true,"type":"string"},"reference_id":{"nullable":true,"type":"string"},"status":{"nullable":true,"type":"string"},"type":{"description":"Data source type","enum":["api","csv","pdf","integration_link","legacy","legacy_pdf","legacy_integration_link"],"example":"pdf","type":"string"}},"required":["all_reconciled","anomaly_reasons","created","data_source_accounts","end_user_file_heron_id","end_user_file_reference_id","file_class","filename","has_unexplained_edits","heron_id","last_updated","max_anomaly_score","max_date","min_date","num_extracted_transactions","num_statements","num_transactions","reconciliation_method","reconciliation_status","reference_id","status","type"],"type":"object"},"EndUserDataSourceUpdateSchema":{"properties":{"is_enabled":{"default":true,"description":"Whether or not the data source is enabled. If disabled, hides related transactions from analytics","example":true,"type":"boolean"}},"type":"object"},"EndUserDataSources":{"properties":{"created":{"description":"When the data source was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"data_source_accounts":{"description":"List of data source accounts associated with the data source","example":[{"account_id":"202348","anomaly_reasons":["Statement metadata changed","Manual review flagged suspicious edits"],"anomaly_score":200,"enabled":true,"max_date":"2022-01-31","min_date":"2022-01-01","num_transactions":120,"transactions_match_balances":true}],"items":{"$ref":"#/components/schemas/EndUserDataSourceAccount"},"type":"array"},"heron_id":{"description":"Unique ID for data source generated by Heron","example":"dso_StvEAbtRd2LLU6n8LjQDwS","readOnly":true,"type":"string"},"is_enabled":{"default":true,"description":"Whether or not the data source is enabled. If disabled, hides related transactions from analytics","example":true,"type":"boolean"},"last_updated":{"description":"When the data source was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"metadata":{"allOf":[{"$ref":"#/components/schemas/EndUserDataSourceMetadata"}],"description":"Metadata associated with the data source","example":{"filename":"202348_JAN_2022.pdf","status":"processed"}},"reference_id":{"description":"Unique ID to identify the data source","example":"pdf_ipa38qiztYHMFuSDDqN6m5","type":"string"},"status":{"description":"Status of the data source entity, where applicable (e.g. pdfs, integration links)","enum":["new","parsing","parsed","processed","human_reviewing","approved","rejected","failed","transactions_loaded","transactions_unloaded","pending","active","syncing","erroring","sync_disabled","deleted_in_plaid","unknown"],"example":"new","type":"string"},"type":{"description":"Data source type","enum":["api","csv","pdf","integration_link","legacy","legacy_pdf","legacy_integration_link"],"example":"pdf","type":"string"}},"required":["created","data_source_accounts","heron_id","last_updated","reference_id","type"],"type":"object"},"EndUserDetailsResponseSchema":{"description":"The business, its owners and the funding it applied for, with one value per field.","properties":{"business":{"allOf":[{"$ref":"#/components/schemas/ResolvedBusiness"}],"description":"The applicant's business.","nullable":true},"custom_entities":{"additionalProperties":{},"description":"Your custom fields, grouped by entity name. Each entity has its values and a `_sources` object with the source of each value.","type":"object"},"funding_applications":{"description":"The funding the business applied for, newest `received_at` first and those with none last. Each uploaded application form is one entry, and so is each set of values you or your broker sent.","items":{"$ref":"#/components/schemas/ResolvedFundingApplication"},"type":"array"},"owners":{"description":"The business owners. Owners named by more sources come first, then the largest ownership percentage, then the order on the application.","items":{"$ref":"#/components/schemas/ResolvedOwner"},"type":"array"}},"required":["business","custom_entities","funding_applications","owners"],"type":"object"},"EndUserEmail":{"properties":{"cc_addresses":{"items":{"type":"string"},"type":"array"},"date_sent":{"format":"date-time","nullable":true,"type":"string"},"date_sent_string":{"type":"string"},"from_address":{"type":"string"},"from_address_domain":{"type":"string"},"from_name":{"type":"string"},"html_body":{"type":"string"},"html_or_text_body":{"type":"string"},"reply_to":{"nullable":true,"type":"string"},"subject":{"type":"string"},"text_body":{"type":"string"},"to_addresses":{"items":{"type":"string"},"type":"array"}},"type":"object"},"EndUserEmailSchema":{"properties":{"cc_addresses":{"items":{"type":"string"},"type":"array"},"created":{"format":"date-time","type":"string"},"date_sent":{"format":"date-time","nullable":true,"type":"string"},"date_sent_string":{"type":"string"},"from_address":{"type":"string"},"from_address_domain":{"type":"string"},"from_name":{"type":"string"},"heron_id":{"type":"string"},"html_body":{"type":"string"},"html_or_text_body":{"type":"string"},"is_reply":{"nullable":true,"type":"boolean"},"processing_status":{"enum":["new","processing","processed","failed"],"type":"string"},"reply_to":{"nullable":true,"type":"string"},"subject":{"type":"string"},"subject_cleaned":{"type":"string"},"text_body":{"type":"string"},"to_addresses":{"items":{"type":"string"},"type":"array"},"viewer_url":{"description":"a temporary, secure URL for viewing the email contents","type":"string"}},"type":"object"},"EndUserEndUserFile":{"properties":{"file_class":{"nullable":true,"type":"string"},"filename":{"type":"string"},"heron_id":{"type":"string"},"renamed_filename":{"nullable":true,"type":"string"}},"type":"object"},"EndUserEnrichParams":{"properties":{"priority":{"default":"normal","description":"Priority for async enrichment","enum":["normal","high"],"type":"string"}},"type":"object"},"EndUserEntitiesSettings":{"properties":{"date_display_format":{"description":"The format to use for date attributes when they are display in the dashboard","type":"string"}},"type":"object"},"EndUserEntityAttributeSchema":{"properties":{"attribute_description":{"type":"string"},"attribute_name":{"type":"string"},"attribute_type":{"enum":["float","int","decimal","string","date","datetime","bool"]},"display_order":{"nullable":true,"type":"integer"},"heron_id":{"type":"string"},"is_dedupe_key":{"default":false,"type":"boolean"},"reconciliation_config":{"additionalProperties":{},"type":"object"},"reconciliation_strategy":{"enum":["sort_order","llm","comparison","concatenate_lists"]}},"type":"object"},"EndUserEntityAttributeSource":{"properties":{"heron_id":{"nullable":true,"type":"string"},"sort_order":{"type":"integer"},"source_config":{"additionalProperties":{},"type":"object"},"source_type":{"enum":["parsed_end_user_file","api","rel_6","end_user_enricher","company_attribute","static_value","end_user_query","broker_submission_api","crm"]}},"type":"object"},"EndUserEntityAttributeSourceSchema":{"properties":{"heron_id":{"nullable":true,"type":"string"},"sort_order":{"type":"integer"},"source_config":{"additionalProperties":{},"type":"object"},"source_type":{"enum":["parsed_end_user_file","api","rel_6","end_user_enricher","company_attribute","static_value","end_user_query","broker_submission_api","crm"]}},"type":"object"},"EndUserEntityAttributeValueSchema":{"properties":{"heron_id":{"type":"string"},"value":{}},"type":"object"},"EndUserEntitySchema":{"properties":{"display_order":{"type":"integer"},"entity_description":{"type":"string"},"entity_name":{"type":"string"},"entity_post_processor_configs":{"default":[],"items":{"additionalProperties":{},"type":"object"},"nullable":true,"type":"array"},"heron_id":{"type":"string"},"is_list":{"type":"boolean"},"saved_query_heron_id":{"nullable":true,"type":"string"}},"type":"object"},"EndUserFileBase64Schema":{"properties":{"file_b64":{"type":"string"},"mime_type":{"nullable":true,"type":"string"}},"type":"object"},"EndUserFilePageClasses":{"properties":{"confidence":{"default":1.0,"type":"number"},"file_class":{"type":"string"}},"type":"object"},"EndUserFileSchema":{"properties":{"bank_statement":{"allOf":[{"$ref":"#/components/schemas/PdfGet"}],"example":null,"nullable":true,"readOnly":true},"created":{"format":"date-time","type":"string"},"email":{"allOf":[{"$ref":"#/components/schemas/EndUserEmailSchema"}],"example":null,"nullable":true,"readOnly":true},"file_class":{"type":"string"},"file_source_metadata":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"},"filename":{"type":"string"},"heron_id":{"type":"string"},"iso_application":{"allOf":[{"$ref":"#/components/schemas/GetIsoApplication"}],"nullable":true,"readOnly":true},"num_pages":{"nullable":true,"type":"integer"},"page_classes":{"additionalProperties":{"$ref":"#/components/schemas/EndUserFilePageClasses"},"nullable":true,"type":"object"},"parent_heron_id":{"nullable":true,"type":"string"},"parsed_results":{"default":[],"items":{"$ref":"#/components/schemas/ParsedEndUserFile"},"readOnly":true,"type":"array"},"processing_error":{"nullable":true,"readOnly":true,"type":"string"},"reference_id":{"type":"string"},"renamed_filename":{"nullable":true,"type":"string"}},"type":"object"},"EndUserFileSummarySchema":{"properties":{"bank_statement":{"allOf":[{"$ref":"#/components/schemas/PdfGet"}],"example":null,"nullable":true,"readOnly":true},"created":{"format":"date-time","type":"string"},"file_class":{"type":"string"},"file_source_metadata":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"},"filename":{"type":"string"},"heron_id":{"type":"string"},"is_non_actionable_email":{"type":"boolean"},"iso_application":{"allOf":[{"$ref":"#/components/schemas/GetIsoApplication"}],"nullable":true,"readOnly":true},"latest_parsed_at":{"format":"date-time","nullable":true,"type":"string"},"num_pages":{"nullable":true,"type":"integer"},"page_classes":{"additionalProperties":{"$ref":"#/components/schemas/EndUserFilePageClasses"},"nullable":true,"type":"object"},"parent_heron_id":{"nullable":true,"type":"string"},"parse_status":{"enum":["classifying","parsing","parsed","failed","awaiting","processed"],"type":"string"},"processing_error":{"nullable":true,"readOnly":true,"type":"string"},"reference_id":{"type":"string"},"renamed_filename":{"nullable":true,"type":"string"},"validation_counts":{"$ref":"#/components/schemas/EndUserFileValidationCounts"}},"required":["is_non_actionable_email","parse_status","validation_counts"],"type":"object"},"EndUserFileUpdateSchema":{"properties":{"file_class":{"type":"string"},"page_classes":{"additionalProperties":{"$ref":"#/components/schemas/EndUserFilePageClasses"},"nullable":true,"type":"object"},"parent_heron_id":{"nullable":true,"type":"string"},"reference_id":{"type":"string"}},"type":"object"},"EndUserFileUploadSchema":{"properties":{"file_base64":{"description":"Base64 encoded file bytes","type":"string"},"file_class":{"description":"The type of file, e.g., bank_statement","nullable":true,"type":"string"},"filename":{"description":"Name of file","type":"string"},"parent_file_heron_id":{"description":"The Heron ID of the parent file, if this file is a part of another file","nullable":true,"type":"string"},"reference_id":{"description":"Your reference id for file","nullable":true,"type":"string"},"trigger_downstream_processing":{"default":true,"description":"Whether to trigger downstream processing (file classification, parsing, etc.) upon upload","type":"boolean"}},"required":["file_base64","filename"],"type":"object"},"EndUserFileValidationCounts":{"properties":{"failed":{"type":"integer"},"not_applicable":{"type":"integer"},"passed":{"type":"integer"}},"required":["failed","not_applicable","passed"],"type":"object"},"EndUserForecastInputParams":{"properties":{"category_heron_id":{"description":"Heron ID of category to be forecasted; either category_heron_id or category_label must be present","example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","type":"string"},"category_label":{"description":"Label of category to be forecasted; either category_heron_id or category_label must be present","example":"Revenue","type":"string"},"date_granularity":{"default":"month","description":"Aggregate results over time, i.e., aggregate by week or by month","enum":["week","month"],"example":"month","type":"string"},"end_user_heron_id":{"description":"Heron-generated id for end user; either end_user_id or end_user_heron_id is required","example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"},"end_user_id":{"description":"end_user_id for statistics; either end_user_id or end_user_heron_id is required","example":"your_end_user_id","nullable":true,"type":"string"},"from_date":{"description":"The earliest transaction timestamp date to use in forecasting","example":"2022-01-01","format":"date","nullable":true,"type":"string"},"to_currency":{"description":"ISO 4217 currency code to convert to","enum":["GBP","USD","EUR","CAD","AUD",null],"example":"USD","nullable":true,"type":"string"},"to_date":{"description":"The latest transaction timestamp date to use in forecasting","example":"2022-01-31","format":"date","nullable":true,"type":"string"}},"type":"object"},"EndUserForecastOutputSchema":{"properties":{"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"date":{"description":"Forecast date at specified date granularity","example":"2026-02-26","type":"string"},"predicted":{"description":"Predicted amount","example":42.42,"type":"number"},"predicted_lower":{"description":"Predict amount lower bound","example":4.24,"type":"number"},"predicted_upper":{"description":"Predicted amount upper bound","example":420.42,"type":"number"}},"type":"object"},"EndUserGroupedTransactionsReport":{"properties":{"counterparty":{"type":"string"},"merchant":{"$ref":"#/components/schemas/GroupedTransactionMerchant"},"transaction_groups":{"items":{"$ref":"#/components/schemas/EndUserTransactionGroup"},"type":"array"}},"type":"object"},"EndUserInformationPatchSchema":{"properties":{"amount_requested":{"nullable":true,"type":"number"},"annual_revenue":{"nullable":true,"type":"number"},"business_start_date":{"format":"date","nullable":true,"type":"string"},"company_billing_address":{"$ref":"#/components/schemas/Address"},"company_email":{"nullable":true,"type":"string"},"company_legal_business_name":{"nullable":true,"type":"string"},"company_phone_number":{"nullable":true,"type":"string"},"company_physical_address":{"$ref":"#/components/schemas/Address"},"company_website":{"nullable":true,"type":"string"},"dba":{"description":"Doing business as","nullable":true,"type":"string"},"federal_tax_id":{"nullable":true,"type":"string"},"industry_type":{"nullable":true,"type":"string"},"loan_purpose":{"nullable":true,"type":"string"},"monthly_revenue":{"nullable":true,"type":"number"},"naics":{"nullable":true,"type":"string"},"owner_1":{"$ref":"#/components/schemas/Owner"},"owner_2":{"$ref":"#/components/schemas/Owner"},"predicted_industry_probability":{"nullable":true,"type":"number"},"source_email_address":{"nullable":true,"type":"string"},"source_name":{"nullable":true,"type":"string"},"source_notes":{"nullable":true,"type":"string"},"state_of_incorporation":{"nullable":true,"type":"string"},"type_of_business_entity":{"nullable":true,"type":"string"}},"type":"object"},"EndUserInformationSchema":{"properties":{"amount_requested":{"nullable":true,"type":"number"},"annual_revenue":{"nullable":true,"type":"number"},"business_start_date":{"format":"date","nullable":true,"type":"string"},"company_billing_address":{"$ref":"#/components/schemas/Address"},"company_email":{"nullable":true,"type":"string"},"company_legal_business_name":{"nullable":true,"type":"string"},"company_phone_number":{"nullable":true,"type":"string"},"company_physical_address":{"$ref":"#/components/schemas/Address"},"company_website":{"nullable":true,"type":"string"},"dba":{"description":"Doing business as","nullable":true,"type":"string"},"federal_tax_id":{"nullable":true,"type":"string"},"industry_type":{"nullable":true,"type":"string"},"loan_purpose":{"nullable":true,"type":"string"},"monthly_revenue":{"nullable":true,"type":"number"},"naics":{"nullable":true,"type":"string"},"owner_1":{"$ref":"#/components/schemas/Owner"},"owner_2":{"$ref":"#/components/schemas/Owner"},"predicted_industry_probability":{"nullable":true,"type":"number"},"source_email_address":{"nullable":true,"type":"string"},"source_name":{"nullable":true,"type":"string"},"source_notes":{"nullable":true,"type":"string"},"source_type":{"description":"Source of the end user information","enum":["api","iso_application_form","heron_industry_classifier","rel6_industry_classifier","email","end_user_entities"],"example":"iso_application_form","type":"string"},"state_of_incorporation":{"nullable":true,"type":"string"},"type_of_business_entity":{"nullable":true,"type":"string"}},"type":"object"},"EndUserList":{"properties":{"confidence":{"description":"Aggregated confidence for the end user across all transactions; between 0 and 1","example":0.42,"nullable":true,"readOnly":true,"type":"number"},"created":{"description":"When the end user was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"end_user_id":{"description":"id defined by user; links to the end_user_id for transactions","example":"7cb48787-6d91-5b9f-bc60-f30298ea5736","maxLength":140,"minLength":1,"type":"string"},"heron_id":{"description":"Unique id for end user generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","readOnly":true,"type":"string"},"is_portfolio":{"description":"Whether the end user is part of a lending portfolio","example":true,"type":"boolean"},"last_processed_at":{"description":"When the end user was last successfully processed in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"readOnly":true,"type":"string"},"last_updated":{"description":"When the end user was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"meta":{"additionalProperties":{"type":"string"},"description":"Arbitrary key-value metadata. Max 20 keys, key \u226464 chars, value \u2264256 chars, total \u22644KB. Example: {\"attribution_key\": \"lender_42\"}","nullable":true,"type":"object"},"name":{"description":"Name of end user; may help to improve categorisation accuracy","example":"Company Name Inc.","maxLength":128,"nullable":true,"type":"string"},"profit_and_loss_layout":{"nullable":true},"status":{"description":"Status of end user; 'ready' triggers async processing, 'review_requested' triggers manual review request","enum":["new","ready","processed","reviewed","review_requested","failed"],"example":"ready","type":"string"},"tags":{"description":"Tags currently applied to this end user, read-only. Absent unless the endpoint returns them.","items":{"$ref":"#/components/schemas/TagSchema"},"readOnly":true,"type":"array"}},"required":["end_user_id"],"type":"object"},"EndUserMerchantFeedbackRevert":{"properties":{"transaction_heron_ids":{"description":"List of transaction heron IDs to revert merchant feedback","items":{"example":"txn_9oPspuxisSVyboAqnR2L4Q","type":"string"},"type":"array"}},"required":["transaction_heron_ids"],"type":"object"},"EndUserMerchantSummary":{"properties":{"by_merchant_summary":{"items":{"$ref":"#/components/schemas/MerchantSummaryRow"},"type":"array"}},"type":"object"},"EndUserMerchantSummaryParams":{"properties":{"account_ids":{"description":"Account ids to include in the summary, if not provided, all accounts are included","items":{"example":"1234","type":"string"},"nullable":true,"type":"array"},"analytics_group":{"items":{"description":"The category analytics group","enum":["revenue","cost_of_goods_sold","operational_expenses","tax_expenses","intra_company","debt","equity","other_income","special_items","other",null],"example":"debt","nullable":true,"type":"string"},"minItems":1,"nullable":true,"type":"array"},"category_label_or_heron_id":{"items":{"type":"string"},"minItems":1,"nullable":true,"type":"array"},"group_by_counterparty_txn_clusters":{"default":false,"description":"Whether to group by counterparty transaction clusters","type":"boolean"}},"type":"object"},"EndUserPositions":{"properties":{"llm_summary":{"nullable":true,"type":"string"},"positions":{"items":{"$ref":"#/components/schemas/PositionSummary"},"type":"array"},"total_holdback_percentage":{"description":"Active positions' expected monthly repayments divided by average monthly true revenue, as a percentage","nullable":true,"type":"number"}},"type":"object"},"EndUserPositionsParams":{"properties":{"account_ids":{"description":"Account IDs to filter positions by","items":{"type":"string"},"nullable":true,"type":"array"},"include_transactions":{"default":false,"description":"If true, include investment/repayment/reversal/bounced repayment transactions on each position","type":"boolean"}},"type":"object"},"EndUserPostParams":{"properties":{"confidence":{"description":"Aggregated confidence for the end user across all transactions; between 0 and 1","example":0.42,"nullable":true,"readOnly":true,"type":"number"},"created":{"description":"When the end user was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"criteria":{"description":"List of scorecard metrics","items":{"$ref":"#/components/schemas/Metric"},"nullable":true,"readOnly":true,"type":"array"},"data_sources":{"description":"List of data source summaries for the end user","items":{"$ref":"#/components/schemas/DataSource"},"readOnly":true,"type":"array"},"end_user_id":{"description":"id defined by user; links to the end_user_id for transactions","example":"7cb48787-6d91-5b9f-bc60-f30298ea5736","maxLength":140,"minLength":1,"type":"string"},"heron_id":{"description":"Unique id for end user generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","readOnly":true,"type":"string"},"is_portfolio":{"description":"Whether the end user is part of a lending portfolio","example":true,"type":"boolean"},"last_processed_at":{"description":"When the end user was last successfully processed in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"readOnly":true,"type":"string"},"last_updated":{"description":"When the end user was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"meta":{"additionalProperties":{"type":"string"},"description":"Arbitrary key-value metadata. Max 20 keys, key \u226464 chars, value \u2264256 chars, total \u22644KB. Example: {\"attribution_key\": \"lender_42\"}","nullable":true,"type":"object"},"name":{"description":"Name of end user; may help to improve categorisation accuracy","example":"Company Name Inc.","maxLength":128,"nullable":true,"type":"string"},"profit_and_loss_layout":{"nullable":true},"tags":{"description":"Optional tag Heron IDs to apply when creating the end user.","items":{"type":"string"},"type":"array","writeOnly":true}},"required":["end_user_id"],"type":"object"},"EndUserProcessingStatusSchema":{"properties":{"status":{"description":"Current processing status of the end user","enum":["processing","processed"],"example":"processed"}},"required":["status"],"type":"object"},"EndUserReadEnrichedParams":{"properties":{"account_ids":{"description":"Account ids to include. If not provided, all accounts are included","items":{"example":"1234","type":"string"},"nullable":true,"type":"array"},"category_heron_id":{"default":[],"description":"Filter by the heron_id of the category that the transaction is annotated with","example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","items":{"type":"string"},"nullable":true,"type":"array"},"data_source_heron_id":{"description":"Filter by data source Heron ID","type":"string"},"last_updated_min":{"description":"Filter for transactions whose values were last updated in Heron systems after the specified input value, isoformat","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"type":"string"},"order_by":{"default":"id_asc","description":"What to order transactions by","enum":["amount_asc","amount_desc","abs_amount_asc","abs_amount_desc","description_asc","description_desc","timestamp_asc","timestamp_desc","id_asc","id_desc","confidence_asc","confidence_desc","created_asc","created_desc"],"type":"string"},"page":{"default":1,"description":"Results page","minimum":1,"type":"integer"},"per_page":{"default":100,"description":"Desired results per page","maximum":50000,"minimum":1,"type":"integer"}},"type":"object"},"EndUserReadParams":{"properties":{"created_after":{"description":"Return only end users created at or after this ISO 8601 date or datetime","example":"2026-09-11","nullable":true,"type":"string"},"created_before":{"description":"Return only end users created strictly before this ISO 8601 date or datetime","example":"2026-09-18","nullable":true,"type":"string"},"criteria":{"additionalProperties":{},"description":"Information about the end user that can be used as rules for underwriting","example":{"history_days":{"value":40}},"nullable":true,"readOnly":true,"type":"object"},"end_user_id":{"description":"Filter by ID associated with end_user_id field in transactions","example":"your_end_user_id","nullable":true,"type":"string"},"heron_id":{"description":"Unique ID generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"},"include_data_sources":{"default":false,"description":"Whether the to include data sources for each end user","example":true,"type":"boolean"},"include_scorecard_metrics":{"default":false,"description":"Whether to include scorecard metrics for each end user (under field criteria)","example":true,"type":"boolean"},"include_tags":{"default":false,"description":"Whether to include the tags applied to each end user","example":true,"type":"boolean"},"is_portfolio":{"description":"Whether the end user is part of a lending portfolio","example":true,"nullable":true,"type":"boolean"},"last_updated_after":{"description":"Return only end users last updated at or after this ISO 8601 date or datetime","example":"2026-09-11","nullable":true,"type":"string"},"last_updated_before":{"description":"Return only end users last updated strictly before this ISO 8601 date or datetime","example":"2026-09-18","nullable":true,"type":"string"},"limit":{"default":1000,"description":"Pagination limit per page","maximum":10000,"minimum":1,"type":"integer"},"name":{"description":"Filter by name associated with end user","example":"your_end_user_name","nullable":true,"type":"string"},"order_by":{"default":"last_updated_desc","description":"Order to return end users by","enum":["last_updated_desc","last_updated_asc","created_desc","created_asc",null],"nullable":true,"type":"string"},"page":{"default":1,"description":"Pagination page number","minimum":1,"type":"integer"},"status":{"description":"Filter by status of end user","enum":["new","ready","processed","reviewed","review_requested","failed",null],"example":"reviewed","nullable":true,"type":"string"},"tags":{"description":"Filter by tag Heron IDs. End users holding any active requested tag are returned. Unknown and soft-deleted tag IDs do not match any end users.","items":{"type":"string"},"nullable":true,"type":"array"}},"type":"object"},"EndUserReadSummaryParams":{"properties":{"criteria":{"additionalProperties":{},"description":"Information about the end user that can be used as rules for underwriting","example":{"history_days":{"value":40}},"nullable":true,"readOnly":true,"type":"object"},"end_user_id":{"description":"Filter by ID associated with end_user_id field in transactions","example":"your_end_user_id","nullable":true,"type":"string"},"heron_id":{"description":"Unique ID generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"},"in_human_review":{"description":"Filter by whether an active document is pending human review","nullable":true,"type":"boolean"},"include_crm_queue":{"default":false,"description":"Whether to include the CRM queue each end user's workflow last synced it to (currently read from LendSaaS sync steps)","example":true,"type":"boolean"},"include_lendsaas_deal_ids":{"default":false,"description":"Whether to include the LendSaaS deal IDs linked to each end user","example":true,"type":"boolean"},"include_submitting_brokers":{"default":false,"description":"Whether to include the brokers who submitted each end user","example":true,"type":"boolean"},"include_tags":{"default":false,"description":"Whether to include the tags applied to each end user","example":true,"type":"boolean"},"include_updates_in_interval":{"default":false,"description":"When true, interval_start and interval_end match end users created or last updated within the window. Bounds are inclusive only when this flag is true.","type":"boolean"},"interval_end":{"format":"date-time","nullable":true,"type":"string"},"interval_start":{"format":"date-time","nullable":true,"type":"string"},"is_portfolio":{"description":"Whether the end user is part of a lending portfolio","example":true,"nullable":true,"type":"boolean"},"lendsaas_deal_ids":{"description":"Only end users linked to any of these LendSaaS deal IDs. Requires a LendSaaS CRM integration.","items":{"minLength":1,"type":"string"},"maxItems":100,"minItems":1,"nullable":true,"type":"array"},"limit":{"description":"Pagination limit per page (optional). If provided, 'page' must also be provided.","maximum":10000,"minimum":1,"nullable":true,"type":"integer"},"name":{"description":"Filter by name associated with end user","example":"your_end_user_name","nullable":true,"type":"string"},"order_by":{"default":"last_updated_desc","description":"Order to return end users by","enum":["last_updated_desc","last_updated_asc","created_desc","created_asc",null],"nullable":true,"type":"string"},"page":{"description":"Pagination page number (optional). If provided, 'limit' must also be provided.","minimum":1,"nullable":true,"type":"integer"},"status":{"description":"Filter by status of end user","enum":["new","ready","processed","reviewed","review_requested","failed",null],"example":"reviewed","nullable":true,"type":"string"},"tags":{"description":"Filter by tag Heron IDs. End users holding any active requested tag are returned. Unknown and soft-deleted tag IDs do not match any end users.","items":{"type":"string"},"nullable":true,"type":"array"},"with_crm_sync_result":{"enum":["success","failure","no_sync_attempted",null],"nullable":true},"with_policy_result":{"description":"Only end users whose policy result was this.","enum":["passed","failed","review_required","missing_data","execution_error",null],"nullable":true}},"type":"object"},"EndUserRecurringTransaction":{"properties":{"amount":{"$ref":"#/components/schemas/Money"},"category_confidence":{"type":"number"},"category_heron_id":{"type":"string"},"category_label":{"type":"string"},"counterparty":{"type":"string"},"description":{"type":"string"},"heron_id":{"type":"string"},"merchant_group_id":{"type":"string"},"merchant_heron_id":{"type":"string"},"merchant_name":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"required":["amount","heron_id","timestamp"],"type":"object"},"EndUserRecurringTransactionsReport":{"properties":{"avg_amount":{"$ref":"#/components/schemas/Money"},"avg_confidence":{"type":"number"},"counterparty":{"type":"string"},"frequency":{"enum":["not_enough_data","same_day","irregular","daily","weekly","biweekly","monthly","quarterly","annually","weekday","twice_weekly"],"type":"string"},"merchant_group_id":{"type":"string"},"merchant_heron_id":{"type":"string"},"merchant_name":{"type":"string"},"transactions":{"items":{"$ref":"#/components/schemas/EndUserRecurringTransaction"},"type":"array"}},"type":"object"},"EndUserRecurringTransactionsReportParams":{"properties":{"account_ids":{"description":"Account ids to include in the report, if not provided, all accounts are included","items":{"example":"1234","type":"string"},"nullable":true,"type":"array"}},"type":"object"},"EndUserStatsInputParams":{"properties":{"account_ids":{"default":[],"description":"Filter by specific account reference IDs","example":["1234","5678"],"items":{"type":"string"},"type":"array"},"category_heron_ids":{"default":[],"description":"Filter by specific categories","example":["ctg_94bwS4hp5ZQkyi9kBNkqn8","ctg_awhBcHjFLbnf5MpXbuqzj8"],"items":{"type":"string"},"type":"array"},"date_granularity":{"default":"month","description":"Aggregate results over time, e.g., by week or by quarter","enum":["day","week","month","quarter","year"],"example":"month","type":"string"},"end_user_heron_id":{"description":"Heron-generated id for end user; either end_user_id or end_user_heron_id is required","example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"},"end_user_id":{"description":"end_user_id for statistics; either end_user_id or end_user_heron_id is required","example":"your_end_user_id","nullable":true,"type":"string"},"from_date":{"description":"Filter for transactions with timestamp after the input value (as date)","example":"2026-02-26","format":"date","nullable":true,"type":"string"},"group_by":{"default":"category","description":"Pivot results by merchant or by category","enum":["category","merchant"],"example":"category","type":"string"},"merchant_heron_ids":{"default":[],"description":"Filter by specific merchants","example":["mrc_8bYsSyAMW6LGsGFZi8GF9F","mrc_i7UBv8CnXQRyNCRdCUyjbX"],"items":{"type":"string"},"type":"array"},"to_currency":{"description":"ISO 4217 currency code to convert to","enum":["GBP","USD","EUR","CAD","AUD",null],"example":"USD","nullable":true,"type":"string"},"to_date":{"description":"Filter for transactions with timestamp before the input value (as date)","example":"2026-02-26","format":"date","nullable":true,"type":"string"}},"type":"object"},"EndUserStatsOutputMetrics":{"properties":{"inflow":{"allOf":[{"$ref":"#/components/schemas/EndUserStatsOutputMetricsInstance"}],"description":"Metrics only counting inflows"},"net":{"allOf":[{"$ref":"#/components/schemas/EndUserStatsOutputMetricsInstance"}],"description":"Net metrics"},"outflow":{"allOf":[{"$ref":"#/components/schemas/EndUserStatsOutputMetricsInstance"}],"description":"Metrics only counting outflows"}},"type":"object"},"EndUserStatsOutputMetricsInstance":{"properties":{"amount":{"description":"Aggregate amount of transactions","example":42.42,"type":"number"},"avg_amount":{"description":"Average value of transactions","example":1.01,"nullable":true,"type":"number"},"n":{"description":"Number of transactions","example":42,"type":"integer"}},"type":"object"},"EndUserStatsOutputSchema":{"properties":{"currency":{"description":"ISO 4217 currency code","example":"USD","nullable":true,"type":"string"},"dt":{"description":"Date, impacted by input date granularity","example":"2026-02-26","type":"string"},"heron_id":{"description":"Heron ID of either merchant or category, depending on what was specified in group_by","example":"mrc_8bYsSyAMW6LGsGFZi8GF9F","nullable":true,"type":"string"},"label":{"description":"Label of either merchant or category, depending on what was specified in group_by","example":"Revenue","type":"string"},"metrics":{"$ref":"#/components/schemas/EndUserStatsOutputMetrics"}},"type":"object"},"EndUserSummary":{"properties":{"confidence":{"description":"Aggregated confidence for the end user across all transactions; between 0 and 1","example":0.42,"nullable":true,"readOnly":true,"type":"number"},"created":{"description":"When the end user was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"criteria":{"description":"List of scorecard metrics","items":{"$ref":"#/components/schemas/Metric"},"nullable":true,"readOnly":true,"type":"array"},"crm_queue":{"allOf":[{"$ref":"#/components/schemas/CrmQueue"}],"description":"The CRM queue the deal's workflow last synced it to; null when none","nullable":true,"readOnly":true},"crm_sync_result":{"allOf":[{"$ref":"#/components/schemas/CrmSyncEvent"}],"nullable":true},"data_sources":{"description":"List of data source summaries for the end user","items":{"$ref":"#/components/schemas/DataSource"},"readOnly":true,"type":"array"},"end_user_id":{"description":"id defined by user; links to the end_user_id for transactions","example":"7cb48787-6d91-5b9f-bc60-f30298ea5736","maxLength":140,"minLength":1,"type":"string"},"files":{"items":{"$ref":"#/components/schemas/EndUserEndUserFile"},"type":"array"},"heron_id":{"description":"Unique id for end user generated by Heron","example":"eus_9qQBmrBQMMUkek76UmiQ7m","readOnly":true,"type":"string"},"in_human_review":{"description":"Whether an active document is pending human review","readOnly":true,"type":"boolean"},"is_portfolio":{"description":"Whether the end user is part of a lending portfolio","example":true,"type":"boolean"},"last_processed_at":{"description":"When the end user was last successfully processed in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"readOnly":true,"type":"string"},"last_updated":{"description":"When the end user was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"lendsaas_deal_ids":{"description":"LendSaaS deal IDs linked to this end user. Absent unless include_lendsaas_deal_ids is requested.","items":{"type":"string"},"readOnly":true,"type":"array"},"name":{"description":"Name of end user; may help to improve categorisation accuracy","example":"Company Name Inc.","maxLength":128,"nullable":true,"type":"string"},"policy_evaluation_results":{"description":"One entry per use_case, carrying the latest evaluation's policy identity and result","items":{"$ref":"#/components/schemas/PolicyEvaluationResult"},"type":"array"},"policy_evaluations":{"items":{"enum":["passed","failed","review_required","missing_data","execution_error","skipped"]},"type":"array"},"profit_and_loss_layout":{"nullable":true},"status":{"description":"Status of end user; 'ready' triggers async processing, 'review_requested' triggers manual review request","enum":["new","ready","processed","reviewed","review_requested","failed"],"example":"ready","type":"string"},"submitting_brokers":{"description":"Brokers who submitted this deal \u2014 the discriminator between same-named merchants. Absent unless include_submitting_brokers is requested.","items":{"$ref":"#/components/schemas/SubmittingBroker"},"readOnly":true,"type":"array"},"tags":{"description":"Tags currently applied to this end user, read-only. Absent unless the endpoint returns them.","items":{"$ref":"#/components/schemas/TagSchema"},"readOnly":true,"type":"array"}},"required":["end_user_id"],"type":"object"},"EndUserTagsSchema":{"properties":{"tags":{"description":"Heron IDs of the tags to apply to this end user.","items":{"type":"string"},"type":"array"}},"required":["tags"],"type":"object"},"EndUserTransactionDataCoverageFilters":{"properties":{"end_date":{"format":"date","type":"string"},"include_disabled_data_sources":{"default":true,"type":"boolean"},"start_date":{"format":"date","type":"string"}},"required":["end_date","start_date"],"type":"object"},"EndUserTransactionDataCoverageSchema":{"properties":{"by_account":{"additionalProperties":{"items":{"$ref":"#/components/schemas/AccountTransactionDataCoverage"},"type":"array"},"type":"object"},"duplicate_data_source_accounts_by_account":{"additionalProperties":{"example":["dsa_8Wezdyj8LMyX4pv7bLzJ2f"],"items":{"type":"string"},"type":"array"},"nullable":true,"type":"object"},"end_user_heron_id":{"readOnly":true},"reconciliation_by_account":{"additionalProperties":{"$ref":"#/components/schemas/AccountDataSourcesReconciliation"},"type":"object"}},"required":["by_account","end_user_heron_id","reconciliation_by_account"],"type":"object"},"EndUserTransactionGroup":{"properties":{"frequency":{"enum":["not_enough_data","same_day","irregular","daily","weekly","biweekly","monthly","quarterly","annually","weekday","twice_weekly"],"type":"string"},"transactions":{"items":{"$ref":"#/components/schemas/GroupedTransaction"},"type":"array"}},"type":"object"},"EndUserTransactionPostAsync":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"balance":{"description":"The running balance of the account after transaction ocurred","example":423.0,"nullable":true,"type":"number"},"categories_default":{"description":"Category of transaction that you may have received from other sources","example":"shopping","nullable":true,"type":"string","writeOnly":true},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"type":"string"},"date":{"description":"The date of the transaction; 'timestamp' field takes priority over 'date'","example":"2020-04-27","format":"date","nullable":true,"type":"string","writeOnly":true},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"mcc_code":{"description":"Merchant category code associated with transaction that you may have received from other sources","nullable":true,"pattern":"^\\d{4}$","type":"string","writeOnly":true},"order":{"description":"If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction","nullable":true,"type":"integer","writeOnly":true},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"type":"string"},"request_id":{"description":"ID associated with request, e.g., all transactions in same POST request will have same request_id","example":"req_gFci32BgPmpjCF8coABckV","nullable":true,"readOnly":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"},"transaction_code":{"description":"Code associated with transaction to indicate the type of transaction","example":"card","maxLength":140,"nullable":true,"type":"string"}},"required":["account_id","amount","currency","description","reference_id"],"type":"object"},"EndUserTransactionsPostAsyncSchema":{"properties":{"balances":{"description":"Bank account balance information for a particular account_id. The balance here must be the *latest balance* after all the transactions in this batch have been applied.","items":{"$ref":"#/components/schemas/AccountBalance1"},"nullable":true,"type":"array"},"transactions":{"items":{"$ref":"#/components/schemas/EndUserTransactionPostAsync"},"minItems":1,"type":"array"}},"required":["transactions"],"type":"object"},"EndUserWebhookData":{"properties":{"end_user_id":{"description":"Customer-supplied id for the end user","example":"myenduser","type":"string"},"heron_id":{"description":"Heron ID of the end user","example":"eus_9qQBmrBQMMUkek76UmiQ7m","type":"string"},"status":{"description":"Status of the end user (e.g. 'processed', 'reviewed')","example":"processed","type":"string"}},"type":"object"},"EndUserWebhookPayload":{"properties":{"created":{"description":"When the webhook was fired","format":"date-time","type":"string"},"data":{"allOf":[{"$ref":"#/components/schemas/EndUserWebhookData"}],"description":"End user details"},"meta":{"additionalProperties":{},"description":"Customer-provided metadata from the end user, if any","nullable":true,"type":"object"},"topic":{"description":"Webhook topic, e.g. `end_user.processed`","type":"string"}},"type":"object"},"EnhancedSQLCheck":{"properties":{"auto_decline":{"default":false,"type":"boolean"},"check_type":{"enum":["equal","not_equal","greater_than","greater_than_or_equal","less_than","less_than_or_equal","before","before_or_on","after","after_or_on","is_in","is_not_in"]},"column_name":{"type":"string"},"comparison_value":{},"data_type":{"enum":["numeric","date","string"]},"decline_code":{"description":"The CRM's identifier for this decline reason, e.g. a LendSaas reason id. Left unset, the CRM sync falls back to this check's decline_description.","nullable":true,"type":"string"},"decline_description":{"nullable":true,"type":"string"},"email_template_name":{"nullable":true,"type":"string"},"ignore_metric_availability":{"default":false,"type":"boolean"},"is_mandatory":{"default":false,"type":"boolean"},"on_failure":{"default":"fail","enum":["fail","review_required"]},"on_missing":{"default":"missing_data","description":"What the check reports when it would report missing data: `missing_data` (the default), `fail` or `pass`. A check saved with an older flag (`pass_if_value_missing` on a date-delta check) reads as the setting it stands for. With `ignore_metric_availability` or `pass_if_value_missing` set, only that setting is accepted","enum":["missing_data","fail","pass"]},"pass_description":{"nullable":true,"type":"string"},"query_name":{"type":"string"},"transaction_scope":{"allOf":[{"$ref":"#/components/schemas/TransactionScope"}],"nullable":true}},"required":["check_type","column_name","comparison_value","data_type","query_name"],"type":"object"},"EnrichAddressesSchema":{"properties":{"city":{"type":"string"},"state":{"type":"string"},"street":{"type":"string"},"zip":{"type":"string"}},"type":"object"},"EnrichedAddressSchema":{"properties":{"analysis":{"$ref":"#/components/schemas/Analysis"},"candidate_index":{"type":"integer"},"components":{"$ref":"#/components/schemas/Components"},"delivery_line_1":{"type":"string"},"delivery_point_barcode":{"type":"string"},"input_index":{"type":"integer"},"last_line":{"type":"string"},"metadata":{"$ref":"#/components/schemas/Metadata"}},"required":["analysis","candidate_index","components","delivery_line_1","delivery_point_barcode","input_index","last_line","metadata"],"type":"object"},"EnricherFieldsSchema":{"properties":{"enricher_type":{"type":"string"},"fields":{"items":{"type":"string"},"type":"array"},"name":{"type":"string"}},"type":"object"},"EnricherResultSchema":{"properties":{"enriched_at":{"format":"date-time","nullable":true,"type":"string"},"enricher_name":{"type":"string"},"result":{"additionalProperties":{},"type":"object"},"status":{"enum":["succeeded","failed","processing","missing_input_data",null],"nullable":true,"type":"string"}},"required":["enriched_at","enricher_name","status"],"type":"object"},"EvaluatedBranch":{"properties":{"condition_unavailable":{"description":"True when the branch's condition uses an attribute or check that no longer exists, so it can't be evaluated: the deal stopped here without knowing whether it matched, none of its checks ran, and the section is missing data","readOnly":true},"heron_id":{"description":"Stable across renames, so route or compare on this rather than the name","readOnly":true,"type":"string"},"name":{"readOnly":true,"type":"string"}},"type":"object"},"FeatureSettings":{"properties":{"acknowledge_submission_emails":{"type":"boolean"},"auto_dsa_deduplication_enabled":{"type":"boolean"},"auto_iso_app_parsing_enabled":{"type":"boolean"},"auto_sync_to_crm":{"type":"boolean"},"background_check_affiliations":{"type":"boolean"},"background_check_trial_limit":{"minimum":0,"nullable":true,"type":"integer"},"bank_statement_human_review_enabled":{"type":"boolean"},"bank_statement_summary":{"$ref":"#/components/schemas/BankStatementSummarySettings"},"broker_alert_on_failed_funder_submission":{"type":"boolean"},"broker_decision_name_match_window_days":{"maximum":90,"minimum":1,"type":"integer"},"broker_failed_funder_submission_alert_addresses":{"items":{"format":"email","type":"string"},"type":"array"},"broker_submission_dedupe_window_days":{"maximum":90,"minimum":1,"nullable":true,"type":"integer"},"broker_submission_email_cc_deal_owner":{"type":"boolean"},"broker_submission_use_generated_files_as_iso_app":{"description":"Dashboard-triggered funder submissions attach the deal's latest generated_file as the ISO application instead of the uploaded application files, matching the SubmitToFunders node's use_generated_files_as_iso_app input. Set for brokers whose workflow generates the application but leaves submission to the dashboard.","type":"boolean"},"broker_velocity_signal":{"allOf":[{"$ref":"#/components/schemas/BrokerVelocitySignal"}],"description":"Per-customer distinct-domain cut-offs for the broker_velocity fraud enricher's low/medium/high signal."},"broker_waterfall_alert":{"type":"boolean"},"broker_waterfall_alert_addresses":{"items":{"format":"email","type":"string"},"type":"array"},"broker_waterfall_approvals_to_stop":{"minimum":1,"type":"integer"},"broker_waterfall_auto_submit":{"type":"boolean"},"broker_waterfall_max_auto_waves":{"minimum":1,"type":"integer"},"broker_waterfall_max_decision_age_days":{"minimum":1,"type":"integer"},"broker_waterfall_max_first_wave_age_days":{"minimum":1,"type":"integer"},"broker_waterfall_min_decline_percentage":{"maximum":100,"minimum":1,"nullable":true,"type":"integer"},"broker_waterfall_min_declines":{"minimum":1,"nullable":true,"type":"integer"},"broker_waterfall_source":{"enum":["paper","funder_intel"]},"broker_waterfall_wave_size":{"minimum":1,"nullable":true,"type":"integer"},"categorisation_beta":{"$ref":"#/components/schemas/CategorisationBeta"},"count_duplicate_end_users":{"type":"boolean"},"crm_sync_end_users_without_end_user_information":{"type":"boolean"},"crm_sync_n8n_workflow_url":{"nullable":true,"type":"string"},"crm_sync_n8n_workflow_urls":{"items":{"type":"string"},"nullable":true,"type":"array"},"custom_merchant_groups_auto_approve":{"type":"boolean"},"custom_merchant_groups_enabled":{"type":"boolean"},"custom_merchant_groups_to_override":{"items":{"type":"string"},"type":"array"},"daily_crm_sync_report_emails":{"items":{"format":"email","type":"string"},"type":"array"},"deal_confidence":{"$ref":"#/components/schemas/DealConfidence"},"decision_engine":{"$ref":"#/components/schemas/DecisionEngineSettings"},"default_regular_debt_summary":{"type":"boolean"},"derived_features":{"type":"boolean"},"description_masked":{"type":"boolean"},"end_user_created_alert_slack_channel":{"nullable":true,"type":"string"},"evaluate_policies_only_in_flowmingo":{"type":"boolean"},"failed_iso_email_forwarding_addresses":{"items":{"format":"email","type":"string"},"type":"array"},"file_classifier_fallback_model_registry_slug":{"nullable":true,"type":"string"},"file_classifier_model_registry_slug":{"nullable":true,"type":"string"},"financials_alerting_enabled":{"type":"boolean"},"financials_enabled":{"type":"boolean"},"flowmingo_workflow_owners":{"$ref":"#/components/schemas/FlowmingoWorkflowOwners"},"forward_failed_emails":{"type":"boolean"},"forward_rejected_emails":{"type":"boolean"},"fraud_network_scanning":{"type":"boolean"},"grouped_recurring_transactions_enabled":{"type":"boolean"},"has_end_user_in_description":{"type":"boolean"},"has_matching_transaction":{"type":"boolean"},"heron_score":{"type":"boolean"},"heron_score_min_category_confidence":{"maximum":1.0,"minimum":0.0,"type":"number"},"identify_positions":{"type":"boolean"},"incident_reprocess_opt_out":{"type":"boolean"},"is_insurance_demo":{"type":"boolean"},"is_potential_duplicate":{"type":"boolean"},"is_recurring":{"type":"boolean"},"iso_app_parser_version":{"type":"string"},"iso_app_parsing":{"type":"boolean"},"kyb_ui_demo":{"type":"boolean"},"kyb_verification":{"type":"boolean"},"lookup_crm_id_in_email_body":{"type":"boolean"},"mcp_apps_widgets":{"type":"boolean"},"merchant":{"type":"boolean"},"openai_file_classifier_model_slug":{"nullable":true,"type":"string"},"path_to_spreadsheet_export_template":{"nullable":true,"type":"string"},"policy_auto_decline":{"type":"boolean"},"policy_auto_pdf_parsing":{"type":"boolean"},"policy_auto_pdf_parsing_sequential":{"type":"boolean"},"policy_stop_if_iso_app_not_fully_matched":{"type":"boolean"},"predict_naics":{"type":"boolean"},"read_from_entity_graph":{"type":"boolean"},"rejected_iso_email_forwarding_addresses":{"items":{"format":"email","type":"string"},"type":"array"},"reply_to_rejected_emails":{"type":"boolean"},"report_bank_statement_summary_num_calendar_months_to_show":{"nullable":true,"type":"integer"},"report_bank_statement_summary_use_location_specific_months":{"type":"boolean"},"require_attachments_in_submissions":{"type":"boolean"},"resolve_owners_across_iso_applications":{"type":"boolean"},"restrict_end_user_access_by_tag":{"description":"Permission gate: when on, a dashboard member can only see end users sharing one of the tags assigned to them in Stytch. Members with no tags assigned, API keys, and legacy credentials stay unrestricted.","type":"boolean"},"send_email_after_failed_policy_workflow_reason":{"additionalProperties":{},"type":"object"},"show_background_check":{"type":"boolean"},"show_debt_candidates_table":{"type":"boolean"},"skip_send_email_after_failed_crm_sync_cron":{"type":"boolean"},"skip_trial_end_user_alerts":{"type":"boolean"},"small_file_filtering_enabled":{"type":"boolean"},"sos_suggest_first":{"type":"boolean"},"spreadsheet_export_date_columns":{"description":"List of query result columns to export as spreadsheet dates. If null, query values are unchanged.","items":{"type":"string"},"nullable":true,"type":"array"},"spreadsheet_export_eusql_queries":{"description":"List of end user SQL query names to include in spreadsheet export. If null, all queries are exported. If empty list, no queries are exported.","items":{"type":"string"},"nullable":true,"type":"array"},"spreadsheet_export_exclude_hardcoded_sheets":{"description":"List of hardcoded sheet names to exclude from spreadsheet export. If null, no sheets are excluded. Only applies to hardcoded sheets, not query sheets.","items":{"type":"string"},"nullable":true,"type":"array"},"store_customer_graph":{"type":"boolean"},"store_entity_graph":{"type":"boolean"},"submission_finish_event_loopback_days":{"maximum":30,"minimum":0,"type":"integer"},"submission_finish_event_status":{"type":"boolean"},"sync_to_crm_after_failed_policy_workflow_reason":{"additionalProperties":{},"type":"object"},"temporal_workflow_as_policy_workflow":{"type":"boolean"},"temporal_workflow_enabled":{"type":"boolean"},"webhook_event_created_timestamp":{"type":"boolean"},"webhook_retry_backoffs":{"items":{"maximum":86400,"minimum":60,"type":"integer"},"type":"array"}},"type":"object"},"FictitiousNameRecordSchema":{"properties":{"expiry_date":{"description":"Expiry date in ISO 8601 format; null when unavailable.","format":"date","nullable":true,"type":"string"},"file_number":{"description":"Filing number; null when unavailable.","nullable":true,"type":"string"},"filed_date":{"description":"Filing date in ISO 8601 format; null when unavailable.","format":"date","nullable":true,"type":"string"},"filing_state":{"description":"State where the fictitious-name filing was made; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Fictitious business name on the filing; null when unavailable.","nullable":true,"type":"string"},"owner_names":{"description":"Names of the owners listed on the filing. Empty when none are reported.","items":{"type":"string"},"type":"array"},"source":{"description":"Public-record source of the filing; null when unavailable.","nullable":true,"type":"string"},"status":{"description":"Filing status: active, expired, or unknown when no expiry date is available.","enum":["active","expired","unknown"],"type":"string"}},"type":"object"},"FieldCheck":{"properties":{"chosen_by":{"description":"The source `value` was taken from: the first this field prefers that stated anything. Not the source the others are read against, which `source_to_verify` names. Null when nothing stated the field.","enum":["tin","sos","court","background_check","web_presence","web_search","bank_statement","void_check","pnl_statement","tax_return","driving_licence","xactus","industry_prediction","generic_industry_prediction","industry_prediction_v2","datamerch","business_profile_search","api","manual","broker_submission","crm","application","email",null],"nullable":true},"label":{"description":"The field as a reader reads it, such as `Legal business name`.","type":"string"},"source_to_verify":{"description":"The source that is being verified.","enum":["tin","sos","court","background_check","web_presence","web_search","bank_statement","void_check","pnl_statement","tax_return","driving_licence","xactus","industry_prediction","generic_industry_prediction","industry_prediction_v2","datamerch","business_profile_search","api","manual","broker_submission","crm","application","email",null],"nullable":true},"sources":{"description":"One line per source, in the order this field prefers them.","items":{"$ref":"#/components/schemas/SourceVerification"},"type":"array"},"state":{"description":"`verified` when a source independent of the deal confirms what it claimed, `conflict` when any source contradicts it, the deal's own other channels included. `not_verified` means nothing independent confirmed it: nothing else spoke to the claim, or only another channel of the deal restated it, or the deal claimed nothing to check. `blank` means nobody stated a value at all.","enum":["verified","conflict","not_verified","blank"]},"value":{"description":"The best answer the sources hold: the value of the first one this field prefers that stated anything. Not what the deal claimed, which `state` reports on instead, so a field can show a registry's value and read `conflict`. Null when no source stated the field.","nullable":true,"type":"string"}},"type":"object"},"FieldValidation":{"properties":{"failure_reason":{"nullable":true,"type":"string"},"field_name":{"type":"string"},"result":{"enum":["pass","fail","not_applicable"],"example":"pass","type":"string"},"validation_type":{"type":"string"}},"required":["failure_reason","field_name","result","validation_type"],"type":"object"},"FileClass":{"properties":{"description":{"example":"File Class Description","type":"string"},"name":{"example":"File Class Name","type":"string"}},"required":["name"],"type":"object"},"FileClassSchema":{"properties":{"description":{"nullable":true,"type":"string"},"display_group":{"nullable":true,"type":"string"},"display_name":{"nullable":true,"type":"string"},"group":{"nullable":true,"type":"string"},"name":{"type":"string"}},"required":["name"],"type":"object"},"FileSettings":{"properties":{"combined_file_classification_enable_automatic_splitting":{"type":"boolean"},"combined_file_classification_enabled":{"type":"boolean"},"combined_file_classification_keywords":{"items":{"type":"string"},"type":"array"},"combined_file_classification_num_pages_threshold":{"type":"integer"},"combined_file_classification_treat_excel_files_as_combined":{"type":"boolean"},"disable_automatic_parsing":{"description":"a list of file classes to disable automatic parsing for.","items":{"type":"string"},"type":"array"},"file_class_parsers_map":{"additionalProperties":{"items":{"type":"string"},"type":"array"},"type":"object"},"gcs_import_classifies_files":{"type":"boolean"},"human_in_the_loop":{"additionalProperties":{"$ref":"#/components/schemas/HumanInTheLoopParserConfig"},"description":"Configuration for human review per parser. Keys are parser_ids.","type":"object"},"reject_duplicates":{"type":"boolean"},"reject_duplicates_based_on_text":{"type":"boolean"},"required_file_classes":{"items":{"type":"string"},"type":"array"},"total_allowed_files_to_process":{"nullable":true,"type":"integer"}},"type":"object"},"FinancialsSummarySchema":{"properties":{"by_category":{"items":{"$ref":"#/components/schemas/FinancialsValue"},"type":"array"},"by_sub_category":{"items":{"$ref":"#/components/schemas/FinancialsValue"},"type":"array"},"currency":{"type":"string"},"grouping":{"enum":["by_month","by_quarter","by_year"],"type":"string"},"metrics":{"items":{"$ref":"#/components/schemas/FinancialsValue"},"type":"array"}},"type":"object"},"FinancialsValue":{"properties":{"label":{"type":"string"},"time_period_label":{"type":"string"},"value":{"type":"number"}},"type":"object"},"FirmographicIndustryCode":{"properties":{"code":{"description":"Industry classification code.","type":"string"},"description":{"description":"Source description of the industry code.","nullable":true,"type":"string"},"extension":{"description":"Source extension of the industry code; null when absent.","nullable":true,"type":"string"},"rank":{"description":"Position within this source's own list of codes; rank one is that source's primary code. Ranks restart at one for each source, so the same rank appears once per source.","type":"integer"}},"required":["code","rank"],"type":"object"},"FirmographicMSA":{"properties":{"code":{"description":"Metropolitan statistical area code; null when absent.","nullable":true,"type":"string"},"name":{"description":"Metropolitan statistical area name; null when absent.","nullable":true,"type":"string"}},"type":"object"},"FirmographicPerson":{"properties":{"address":{"description":"Address the source recorded for this person, which need not be the business's own. Null when the source gave none.","nullable":true,"type":"string"},"name":{"description":"Name of the person associated with the business.","type":"string"},"title":{"description":"Source-provided role or title; null when absent.","nullable":true,"type":"string"}},"required":["name"],"type":"object"},"FlowmingoWorkflowOwners":{"properties":{"group_slack_name":{"items":{"type":"string"},"type":"array"},"user_email":{"items":{"format":"email","type":"string"},"type":"array"}},"type":"object"},"FormField":{"properties":{"field_type":{"enum":["text","password"]},"label":{"type":"string"},"name":{"type":"string"},"required":{"type":"boolean"}},"required":["field_type","label","name","required"],"type":"object"},"FormattingStep":{"properties":{"name":{"type":"string"},"params":{"additionalProperties":{},"nullable":true,"type":"object"}},"required":["name"],"type":"object"},"FraudNetworkFeature":{"properties":{"confidence":{"enum":["suspected","confirmed_fraud",null],"nullable":true},"evidence":{"$ref":"#/components/schemas/FraudNetworkFeatureEvidence"},"subject":{"type":"string"},"type":{"enum":["fraud_ring_association","corporate_affiliation","money_movement"]},"value":{"enum":["in_ring","lone_actor","linked","none","unknown"]},"visibility":{"enum":["member"]}},"required":["confidence","evidence","subject","type","value","visibility"],"type":"object"},"FraudNetworkFeatureEvidence":{"properties":{"business_heron_ids":{"items":{"type":"string"},"type":"array"},"conclusion":{"type":"string"},"connects_to":{"description":"What the ring traces back to: a reported early default or an MCA lawsuit on public record.","enum":["reported_default","mca_lawsuit",null],"nullable":true},"distance":{"description":"How close the business is to it: the business itself, directly linked, or further away.","enum":["this_business","direct","indirect",null],"nullable":true},"evidence_kinds":{"description":"The kinds of evidence behind the flag, never who supplied them.","items":{"enum":["reported_default","mca_lawsuit","money_movement","heron_review"]},"type":"array"},"link_type":{"enum":["corporate_affiliation","money_movement",null],"nullable":true},"links_away":{"description":"How many links between businesses separate this business from it; 0 is the business itself.","nullable":true,"type":"integer"},"matched_on":{"description":"The submitted business fields that matched. Owner fields are never listed.","items":{"enum":["legal_name","dba","ein","address"]},"type":"array"},"money_link_in_your_statements":{"description":"True when statements this account submitted show the business's money link to the ring.","type":"boolean"}},"required":["business_heron_ids","conclusion","connects_to","distance","evidence_kinds","link_type","links_away","matched_on","money_link_in_your_statements"],"type":"object"},"FraudNetworkInputCoverage":{"properties":{"address":{"type":"boolean"},"dba":{"type":"boolean"},"ein":{"type":"boolean"},"legal_name":{"type":"boolean"},"owner_name":{"type":"boolean"},"owner_ssn":{"type":"boolean"}},"required":["address","dba","ein","legal_name","owner_name","owner_ssn"],"type":"object"},"FraudNetworkMatchMeta":{"properties":{"distance_to_first_payment_default":{"nullable":true,"type":"integer"},"matched_fields":{"items":{"$ref":"#/components/schemas/FraudNetworkResultMatchedField"},"type":"array"},"score":{"type":"number"}},"required":["distance_to_first_payment_default","matched_fields","score"],"type":"object"},"FraudNetworkResultBusiness":{"properties":{"address":{"allOf":[{"$ref":"#/components/schemas/AddressFields"}],"nullable":true},"evidence":{"items":{"$ref":"#/components/schemas/FraudNetworkResultEvidence"},"type":"array"},"heron_id":{"type":"string"},"identifiers":{"items":{"$ref":"#/components/schemas/CompanyId"},"type":"array"},"names":{"items":{"$ref":"#/components/schemas/CompanyName"},"type":"array"},"redacted":{"description":"True when this account has never submitted the node; every identifying field is then empty.","type":"boolean"},"sightings":{"description":"This account's own end users that matched the node.","items":{"$ref":"#/components/schemas/FraudNetworkResultSighting"},"type":"array"},"type_of_entity":{"nullable":true,"type":"string"}},"required":["address","evidence","heron_id","identifiers","names","redacted","sightings","type_of_entity"],"type":"object"},"FraudNetworkResultEdge":{"properties":{"edge_type":{"enum":["owner_of","transacts_with"]},"evidence":{"items":{"$ref":"#/components/schemas/FraudNetworkResultEvidence"},"type":"array"},"from_node_heron_id":{"type":"string"},"heron_id":{"type":"string"},"to_node_heron_id":{"type":"string"}},"required":["edge_type","evidence","from_node_heron_id","heron_id","to_node_heron_id"],"type":"object"},"FraudNetworkResultEvidence":{"properties":{"detail":{"additionalProperties":{},"description":"Kind-specific detail. `public_record` carries `{is_mca}` per case; case numbers, names and links are never returned.","type":"object"},"heron_id":{"type":"string"},"kind":{"enum":["customer_reported_fraud","public_record","detected_money_flow","detected_funding","reviewer_decision"]},"occurred_at":{"format":"date","nullable":true,"type":"string"},"source":{"description":"Where the evidence came from, as a fixed vocabulary derived from its kind.","enum":["court_records","consortium_member_report","heron_bank_data","heron_review"]}},"required":["detail","heron_id","kind","occurred_at","source"],"type":"object"},"FraudNetworkResultMatchedField":{"properties":{"key":{"enum":["legal_name","dba","ein","ssn","owner_name","address"],"type":"string"},"subject":{"enum":["business","owner_1","owner_2"],"type":"string"},"value":{"description":"The submitted value. SSNs and EINs are masked; other values are unchanged.","type":"string"}},"required":["key","subject","value"],"type":"object"},"FraudNetworkResultNetwork":{"properties":{"first_payment_default_count":{"type":"integer"},"heron_id":{"nullable":true,"type":"string"},"mca_suit_member_count":{"type":"integer"},"member_count":{"type":"integer"},"reporting_member_count":{"type":"integer"}},"required":["first_payment_default_count","heron_id","mca_suit_member_count","member_count","reporting_member_count"],"type":"object"},"FraudNetworkResultPerson":{"properties":{"address":{"allOf":[{"$ref":"#/components/schemas/AddressFields"}],"nullable":true},"evidence":{"items":{"$ref":"#/components/schemas/FraudNetworkResultEvidence"},"type":"array"},"heron_id":{"type":"string"},"names":{"items":{"$ref":"#/components/schemas/PersonName"},"type":"array"},"national_ids":{"items":{"$ref":"#/components/schemas/NationalId"},"type":"array"},"redacted":{"description":"True when this account has never submitted the node; every identifying field is then empty.","type":"boolean"},"sightings":{"description":"This account's own end users that matched the node.","items":{"$ref":"#/components/schemas/FraudNetworkResultSighting"},"type":"array"}},"required":["address","evidence","heron_id","names","national_ids","redacted","sightings"],"type":"object"},"FraudNetworkResultSighting":{"properties":{"end_user_heron_id":{"type":"string"},"role":{"enum":["owner_1","owner_2",null],"nullable":true},"seen_at":{"format":"date-time","type":"string"}},"required":["end_user_heron_id","seen_at"],"type":"object"},"FraudNetworkResultSummary":{"properties":{"headline":{"type":"string"},"matched_on":{"nullable":true,"type":"string"},"network":{"nullable":true,"type":"string"},"seen_elsewhere":{"nullable":true,"type":"string"},"this_business":{"type":"string"},"why_listed":{"nullable":true,"type":"string"}},"required":["headline","matched_on","network","seen_elsewhere","this_business","why_listed"],"type":"object"},"FraudNetworkScanResultSchema":{"properties":{"businesses":{"items":{"$ref":"#/components/schemas/FraudNetworkResultBusiness"},"type":"array"},"classification":{"enum":["fraud_network","lone_actor",null],"nullable":true},"edges":{"items":{"$ref":"#/components/schemas/FraudNetworkResultEdge"},"type":"array"},"features":{"items":{"$ref":"#/components/schemas/FraudNetworkFeature"},"type":"array"},"input_coverage":{"$ref":"#/components/schemas/FraudNetworkInputCoverage"},"match_meta":{"allOf":[{"$ref":"#/components/schemas/FraudNetworkMatchMeta"}],"nullable":true},"matched_node_heron_id":{"nullable":true,"type":"string"},"monitoring_until":{"format":"date-time","nullable":true,"type":"string"},"network":{"allOf":[{"$ref":"#/components/schemas/FraudNetworkResultNetwork"}],"nullable":true},"not_run_reason":{"nullable":true,"type":"string"},"people":{"items":{"$ref":"#/components/schemas/FraudNetworkResultPerson"},"type":"array"},"ring_evidence":{"items":{"$ref":"#/components/schemas/FraudNetworkResultEvidence"},"type":"array"},"ring_status":{"enum":["suspected","confirmed_fraud",null],"nullable":true},"scanned_at":{"format":"date-time","type":"string"},"status":{"enum":["match","no_match","insufficient_input"]},"summary":{"$ref":"#/components/schemas/FraudNetworkResultSummary"}},"required":["businesses","classification","edges","features","input_coverage","match_meta","matched_node_heron_id","monitoring_until","network","not_run_reason","people","ring_evidence","ring_status","scanned_at","status","summary"],"type":"object"},"Funder":{"additionalProperties":false,"properties":{"aliases":{"items":{"type":"string"},"nullable":true,"readOnly":true,"type":"array"},"classification_instructions":{"nullable":true,"readOnly":true,"type":"string"},"created":{"format":"date-time","readOnly":true,"type":"string"},"email_domains":{"items":{"type":"string"},"readOnly":true,"type":"array"},"extraction_instructions":{"nullable":true,"readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"last_updated":{"format":"date-time","readOnly":true,"type":"string"},"logo_url":{"nullable":true,"readOnly":true,"type":"string"},"merchant_heron_id":{"readOnly":true,"type":"string"},"name":{"readOnly":true,"type":"string"},"offer_email_instructions":{"nullable":true,"readOnly":true,"type":"string"},"offer_portal_instructions":{"nullable":true,"readOnly":true,"type":"string"},"offer_source":{"enum":["email","api","web_portal","all_offers","crm_lendsaas",null],"nullable":true,"readOnly":true},"slug":{"nullable":true,"readOnly":true,"type":"string"},"submission_channel":{"enum":["email","api","web_portal","all_offers","crm_lendsaas",null],"nullable":true,"readOnly":true},"submission_email_address":{"nullable":true,"readOnly":true,"type":"string"}},"required":["classification_instructions","extraction_instructions","name","offer_email_instructions","offer_portal_instructions","offer_source","submission_channel","submission_email_address"],"type":"object"},"Funder1":{"additionalProperties":false,"properties":{"heron_id":{"readOnly":true,"type":"string"},"name":{"readOnly":true,"type":"string"}},"required":["name"],"type":"object"},"FunderCandidate":{"additionalProperties":false,"properties":{"funder_heron_id":{"readOnly":true,"type":"string"},"funder_name":{"readOnly":true,"type":"string"},"similarity":{"readOnly":true,"type":"number"}},"type":"object"},"FunderCandidateSchema":{"properties":{"funder_heron_id":{"type":"string"},"funder_logo_url":{"nullable":true,"type":"string"},"funder_name":{"type":"string"}},"required":["funder_heron_id","funder_name"],"type":"object"},"FunderExclusionEvidence":{"properties":{"configured_value":{"readOnly":true,"type":"string"},"funder_heron_id":{"readOnly":true,"type":"string"},"match_type":{"enum":["domain","email","name"],"readOnly":true},"observed_value":{"readOnly":true,"type":"string"},"similarity":{"nullable":true,"readOnly":true,"type":"number"},"status":{"enum":["excluded","held"],"readOnly":true}},"type":"object"},"FunderExclusionResolutionSchema":{"additionalProperties":false,"properties":{"resolution":{"enum":["exclude","allow"],"type":"string"}},"required":["resolution"],"type":"object"},"FunderExclusionSenderIdentitySchema":{"additionalProperties":false,"properties":{"sender_domains":{"items":{"pattern":"^(?:[A-Za-z0-9](?:[A-Za-z0-9-]{0,61}[A-Za-z0-9])?\\.)+[A-Za-z]{2,63}$","type":"string"},"type":"array"},"sender_emails":{"items":{"format":"email","type":"string"},"type":"array"},"sender_names":{"items":{"type":"string"},"type":"array"}},"type":"object"},"FunderIntegrationConfig":{"properties":{"display_name":{"type":"string"},"form_fields":{"items":{"$ref":"#/components/schemas/FormField"},"type":"array"},"supports_staging":{"type":"boolean"}},"required":["display_name","form_fields","supports_staging"],"type":"object"},"FunderIntegrationSaved":{"properties":{"status":{"type":"string"}},"type":"object"},"FunderIntegrationViewSchema":{"properties":{"channel":{"enum":["integration","email",null],"nullable":true},"config":{"allOf":[{"$ref":"#/components/schemas/FunderIntegrationConfig"}],"nullable":true},"effective_submission_email_address":{"nullable":true,"type":"string"},"funder_email_domains":{"items":{"type":"string"},"type":"array"},"funder_heron_id":{"type":"string"},"funder_logo_url":{"nullable":true,"type":"string"},"funder_name":{"type":"string"},"production":{"allOf":[{"$ref":"#/components/schemas/IntegrationEnvironment"}],"nullable":true},"sender_address":{"type":"string"},"slug":{"nullable":true,"type":"string"},"staging":{"allOf":[{"$ref":"#/components/schemas/IntegrationEnvironment"}],"nullable":true},"state":{"enum":["not_available","not_configured","staging_configured","staging_live","production_configured","production_live","live"]},"submission_cc_email_addresses":{"items":{"type":"string"},"nullable":true,"type":"array"},"submission_email_address":{"nullable":true,"type":"string"},"submission_email_subject_prefix":{"nullable":true,"type":"string"},"supports_staging":{"type":"boolean"}},"required":["funder_email_domains","funder_heron_id","funder_name","sender_address","state","supports_staging"],"type":"object"},"FunderPolicyEvaluation":{"additionalProperties":false,"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"end_user_heron_id":{"readOnly":true,"type":"string"},"funder":{"allOf":[{"$ref":"#/components/schemas/FunderSearchResultSchema"}],"readOnly":true},"input_data":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"},"last_updated":{"format":"date-time","readOnly":true,"type":"string"},"linked_funder_submission":{"allOf":[{"$ref":"#/components/schemas/LinkedFunderSubmission"}],"nullable":true,"readOnly":true},"matching_priority":{"nullable":true,"readOnly":true,"type":"integer"},"recommendation":{"allOf":[{"$ref":"#/components/schemas/Recommendation"}],"nullable":true,"readOnly":true},"recommendation_rank":{"nullable":true,"readOnly":true,"type":"integer"},"result":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"},"status":{"enum":["not_evaluated","evaluating","matched","mismatched","missing_data","error"],"readOnly":true},"submission_configured":{"readOnly":true,"type":"boolean"}},"type":"object"},"FunderSearchResultSchema":{"additionalProperties":false,"properties":{"heron_id":{"readOnly":true,"type":"string"},"logo_url":{"nullable":true,"readOnly":true,"type":"string"},"name":{"readOnly":true,"type":"string"}},"required":["name"],"type":"object"},"FunderSubmissionAttempt":{"additionalProperties":false,"properties":{"channel":{"enum":["email","api","web_portal","all_offers","crm_lendsaas"],"readOnly":true},"completed_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"created":{"format":"date-time","readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"is_production":{"readOnly":true,"type":"boolean"},"status":{"enum":["in_progress","succeeded","failed","action_required","unknown"],"readOnly":true},"submission_reference_id":{"nullable":true,"readOnly":true,"type":"string"}},"required":["channel","completed_at","is_production","status","submission_reference_id"],"type":"object"},"FunderSubmissionDecision":{"additionalProperties":false,"properties":{"application_identifier":{"nullable":true,"readOnly":true,"type":"string"},"application_status":{"nullable":true,"readOnly":true,"type":"string"},"attribution_method":{"readOnly":true,"type":"string"},"decline_reason":{"nullable":true,"readOnly":true,"type":"string"},"email_classification":{"enum":["general-chatter","request-for-information","initial-decision","term-negotiation","amendment",null],"nullable":true,"readOnly":true},"email_decision_stage":{"enum":["initial-decision","amendment","pre-decision","post-decision",null],"nullable":true,"readOnly":true},"has_competing_offers":{"nullable":true,"readOnly":true,"type":"boolean"},"heron_id":{"readOnly":true,"type":"string"},"lender_notes":{"nullable":true,"readOnly":true,"type":"string"},"offer_link_url":{"nullable":true,"readOnly":true,"type":"string"},"offers":{"items":{"$ref":"#/components/schemas/FunderSubmissionOffer"},"readOnly":true,"type":"array"},"provider_effective_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"raw_application_status":{"nullable":true,"readOnly":true,"type":"string"},"requested_info":{"nullable":true,"readOnly":true,"type":"string"},"source_email_end_user_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"source_email_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"source_received_at":{"format":"date-time","readOnly":true,"type":"string"},"status_reasoning":{"nullable":true,"readOnly":true,"type":"string"},"stipulations":{"nullable":true,"readOnly":true,"type":"string"},"superseded_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"}},"required":["application_identifier","application_status","attribution_method","decline_reason","email_classification","email_decision_stage","has_competing_offers","lender_notes","offer_link_url","offers","provider_effective_at","raw_application_status","requested_info","source_received_at","status_reasoning","stipulations","superseded_at"],"type":"object"},"FunderSubmissionEmailFieldSettings":{"properties":{"broker_contact_number":{"type":"boolean"},"broker_name":{"type":"boolean"},"business_address":{"type":"boolean"},"business_dba":{"type":"boolean"},"business_federal_tax_id":{"type":"boolean"},"business_industry":{"type":"boolean"},"business_legal_name":{"type":"boolean"},"business_start_date":{"type":"boolean"},"business_state_of_incorporation":{"type":"boolean"},"funding_amount_requested":{"type":"boolean"},"funding_annual_revenue":{"type":"boolean"},"funding_loan_purpose":{"type":"boolean"},"funding_monthly_revenue":{"type":"boolean"},"owner_date_of_birth":{"type":"boolean"},"owner_name":{"type":"boolean"},"submission_notes":{"type":"boolean"}},"type":"object"},"FunderSubmissionOffer":{"additionalProperties":false,"properties":{"apr":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"biweekly_payment":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"buy_rate":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"commission_amount":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"commission_percent":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"computed":{"allOf":[{"$ref":"#/components/schemas/FunderSubmissionOfferComputed"}],"readOnly":true},"daily_payment":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"draw_fee_amount":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"draw_fee_percentage":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"factor_rate":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"funded_amount":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"funding_position":{"nullable":true,"readOnly":true,"type":"integer"},"heron_id":{"readOnly":true,"type":"string"},"holdback_percentage":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"interest_rate":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"monthly_payment":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"ordinal":{"readOnly":true,"type":"integer"},"origination_fee_amount":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"origination_fee_percentage":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"payback_amount":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"payment_frequency":{"nullable":true,"readOnly":true,"type":"string"},"raw_product_text":{"nullable":true,"readOnly":true,"type":"string"},"source":{"enum":["email","api","web_portal","all_offers","crm_lendsaas",null],"nullable":true,"readOnly":true},"stipulations":{"nullable":true,"readOnly":true,"type":"string"},"term_days":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"term_months":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"term_number_of_payments":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"term_weeks":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"weekly_payment":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"}},"required":["apr","biweekly_payment","buy_rate","commission_amount","commission_percent","daily_payment","draw_fee_amount","draw_fee_percentage","factor_rate","funded_amount","funding_position","holdback_percentage","interest_rate","monthly_payment","ordinal","origination_fee_amount","origination_fee_percentage","payback_amount","payment_frequency","raw_product_text","source","stipulations","term_days","term_months","term_number_of_payments","term_weeks","weekly_payment"],"type":"object"},"FunderSubmissionOfferComputed":{"additionalProperties":false,"properties":{"biweekly_payment":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"buy_rate":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"commission_amount":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"commission_percent":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"daily_payment":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"factor_rate":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"monthly_payment":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"origination_fee_amount":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"origination_fee_percentage":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"payback_amount":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"payment_frequency":{"readOnly":true,"type":"string"},"term_days":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"term_months":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"term_number_of_payments":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"term_weeks":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"},"weekly_payment":{"format":"decimal","nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"FunderSubmissionPreflightFileSchema":{"additionalProperties":false,"properties":{"end_user_file_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"file_class":{"readOnly":true,"type":"string"},"file_name":{"readOnly":true,"type":"string"},"size_bytes":{"readOnly":true,"type":"integer"}},"required":["end_user_file_heron_id","file_class","file_name","size_bytes"],"type":"object"},"FunderSubmissionPreflightResultSchema":{"additionalProperties":false,"properties":{"files":{"items":{"$ref":"#/components/schemas/FunderSubmissionPreflightFileSchema"},"readOnly":true,"type":"array"},"funder_heron_id":{"readOnly":true,"type":"string"},"funder_name":{"readOnly":true,"type":"string"},"max_message_size_bytes":{"nullable":true,"readOnly":true,"type":"integer"},"message":{"nullable":true,"readOnly":true,"type":"string"},"valid":{"readOnly":true,"type":"boolean"}},"required":["files","funder_heron_id","funder_name"],"type":"object"},"FunderSubmissionSchema":{"additionalProperties":false,"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"end_user_heron_id":{"readOnly":true,"type":"string"},"funder":{"allOf":[{"$ref":"#/components/schemas/Funder1"}],"readOnly":true},"heron_id":{"readOnly":true,"type":"string"},"status":{"enum":["pending","in_progress","submitted_to_funder","invalid_data_for_funder","submission_failed","approved","declined",null],"nullable":true,"readOnly":true},"submission_result":{"readOnly":true},"submitted_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"}},"required":["funder","status","submitted_at"],"type":"object"},"GetAlterationFlagsParams":{"properties":{"cursor":{"description":"next_cursor of the previous page","nullable":true,"type":"string"},"limit":{"default":50,"maximum":200,"minimum":1,"type":"integer"},"months":{"description":"Include flags from this many calendar months ago","enum":[1,3,6,12,null],"nullable":true,"type":"integer"},"risk":{"description":"Risk filters. Repeat the parameter to include both risks.","items":{"enum":["red","amber"],"type":"string"},"type":"array"},"search":{"description":"Filter by deal name","nullable":true,"type":"string"},"since":{"description":"Include flags created on or after this date","format":"date","nullable":true,"type":"string"}},"type":"object"},"GetEndUserDataSourceSummariesParams":{"properties":{"is_enabled":{"description":"Filter by whether the data source is enabled.","nullable":true,"type":"boolean"},"limit":{"default":50,"description":"Pagination limit per page","maximum":200,"minimum":1,"type":"integer"},"page":{"default":1,"description":"Pagination page number","minimum":1,"type":"integer"},"pdf_status":{"description":"Filter to these PDF statuses. Repeat the parameter for more than one.","items":{"enum":["new","parsing","parsed","processed","human_reviewing","approved","rejected","failed","transactions_loaded","transactions_unloaded"],"type":"string"},"nullable":true,"type":"array"}},"type":"object"},"GetEndUserEmailsOptionsSchema":{"properties":{"limit":{"minimum":1,"type":"integer"},"page":{"minimum":0,"type":"integer"}},"required":["limit","page"],"type":"object"},"GetEndUserFileSummariesParams":{"properties":{"file_class":{"description":"Filter to these file classes. Repeat the parameter for more than one.","items":{"type":"string"},"nullable":true,"type":"array"},"has_bank_statement":{"nullable":true,"type":"boolean"},"limit":{"default":50,"description":"Pagination limit per page","maximum":200,"minimum":1,"type":"integer"},"page":{"default":1,"description":"Pagination page number","minimum":1,"type":"integer"}},"type":"object"},"GetFileRenameRulesSchema":{"properties":{"end_user_file_class":{"type":"string"},"file_name_template":{"type":"string"},"heron_id":{"type":"string"},"is_enabled":{"type":"boolean"},"variables":{"items":{"$ref":"#/components/schemas/VariableDefinition"},"type":"array"}},"required":["end_user_file_class","file_name_template","is_enabled"],"type":"object"},"GetFinancialsSummarySchema":{"properties":{"grouping":{"enum":["by_month","by_quarter","by_year",null],"nullable":true,"type":"string"}},"type":"object"},"GetIsoApplication":{"properties":{"heron_id":{"description":"The ISO application's heron_id","example":"iso_XDRt5425jt5xbTnyKv77eS","type":"string"},"processing_status":{"description":"The processing status of the file.","enum":["new","processing","processed","failed"],"example":"processed","type":"string"}},"required":["heron_id","processing_status"],"type":"object"},"GetIsoApplicationSchema":{"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"end_user_heron_id":{"description":"The heron_id of the end_user associated with the iso application, if available","readOnly":true,"type":"string"},"end_user_id":{"description":"The end_user_id of the end_user associated with the iso application, if available","readOnly":true,"type":"string"},"field_validations":{"items":{"$ref":"#/components/schemas/IsoApplicationFieldValidation"},"type":"array"},"filename":{"description":"The original filename of the ISO application form","example":"iso_app.pdf","type":"string"},"heron_id":{"description":"The ISO application's heron_id","example":"iso_XDRt5425jt5xbTnyKv77eS","type":"string"},"processing_status":{"description":"The processing status of the file.","enum":["new","processing","processed","failed"],"example":"processed","type":"string"},"quality_status":{"description":"The overall field validation results. 'fully_matched' indicated all field validations have passed. 'review_required' indicates one or more field validations failed.","enum":["fully_matched","review_required",null],"example":"fully_matched","nullable":true,"type":"string"},"result":{"additionalProperties":{"$ref":"#/components/schemas/IsoApplicationFieldResult"},"description":"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.","type":"object"},"source_email":{"allOf":[{"$ref":"#/components/schemas/EndUserEmail"}],"description":"Original email that contained ISO application, if applicable","nullable":true,"readOnly":true}},"required":["filename","heron_id","processing_status","quality_status"],"type":"object"},"GetTransactionParams":{"properties":{"account_ids":{"description":"Account ids to include. If not provided, all accounts are included","items":{"example":"1234","type":"string"},"nullable":true,"type":"array"},"category_heron_id":{"default":[],"description":"Filter by the heron_id of the category that the transaction is annotated with","example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","items":{"type":"string"},"nullable":true,"type":"array"},"confidence_max":{"description":"Filter by maximum confidence of annotation associated with transaction","maximum":1.0,"minimum":0.0,"type":"number"},"confidence_min":{"description":"Filter by minimum confidence of annotation associated with transaction","maximum":1.0,"minimum":0.0,"type":"number"},"counterparty_keyword":{"description":"Filter by keyword match on transaction counterparty; case insensitive","type":"string"},"created_date_max":{"description":"Filter by latest transaction upload date - when Heron received the transaction","example":"2020-04-27","format":"date","type":"string"},"created_date_min":{"description":"Filter by earliest transaction upload date - when Heron received the transaction","example":"2020-04-27","format":"date","type":"string"},"data_source_heron_id":{"description":"Filter by data source Heron ID","type":"string"},"description_keyword":{"description":"Filter by keyword match on transaction description; case insensitive","type":"string"},"description_regex":{"description":"Filter by regex matching transaction description","type":"string"},"end_user_id":{"description":"End user id of transaction","type":"string"},"from_date":{"description":"Deprecated; see created_date_ or timestamp_date_","format":"date","type":"string"},"has_matching_transaction":{"description":"Filter by whether the transaction has a matching transaction","type":"boolean"},"has_merchant":{"description":"Filter by whether the transaction has a merchant entity associated with it","nullable":true,"type":"boolean"},"heron_id":{"description":"Heron generated Id of transaction","example":"txn_9oPspuxisSVyboAqnR2L4Q","type":"string"},"heron_ids":{"default":[],"description":"Filter to a specific set of transactions by Heron ID, e.g. the transactions an attribute cites","items":{"type":"string"},"maxItems":100,"type":"array"},"include_duplicates":{"description":"Whether or not to include duplicate transactions in the response. Defaults to false unless request_id is provided, in which case it defaults to true.","type":"boolean"},"is_payment_processing":{"description":"Filter by the recorded payment-processing flag. False includes transactions not yet evaluated.","type":"boolean"},"is_recurring":{"description":"Filter by whether the transaction is recurring","type":"boolean"},"last_updated_max":{"description":"Filter for transactions whose values were last updated in Heron systems before the specified input value","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"last_updated_min":{"description":"Filter for transactions whose values were last updated in Heron systems after the specified input value","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"limit":{"default":1000,"description":"Number of transactions to return per page","maximum":10000,"minimum":1,"type":"integer"},"max_amount":{"description":"Filter by maximum amount of transaction","type":"number"},"max_balance":{"description":"Filter by maximum running balance","type":"number"},"merchant_group_id":{"description":"Filter by merchant group id","type":"string"},"merchant_heron_id":{"description":"Filter by merchant heron id","type":"string"},"merchant_name":{"description":"Filter by keyword match on merchant name; case insensitive","type":"string"},"min_amount":{"description":"Filter by minimum amount of transaction","type":"number"},"min_balance":{"description":"Filter by minimum running balance","type":"number"},"order_by":{"default":"id_asc","description":"What to order transactions by","enum":["amount_asc","amount_desc","abs_amount_asc","abs_amount_desc","description_asc","description_desc","timestamp_asc","timestamp_desc","id_asc","id_desc","confidence_asc","confidence_desc","created_asc","created_desc","balance_asc","balance_desc"],"type":"string"},"page":{"default":1,"description":"Page of transaction to return","minimum":1,"type":"integer"},"reference_id":{"description":"Reference Id of transaction","type":"string"},"request_id":{"description":"Request-Id header returned in the response of POST transactions. Sending this parameter will return all transactions sent in a particular POST request, including any duplicates.","type":"string"},"timestamp_date_max":{"description":"Filter by latest transaction timestamp","example":"2020-04-27","format":"date","type":"string"},"timestamp_date_min":{"description":"Filter by earliest transaction timestamp","example":"2020-04-27","format":"date","type":"string"},"to_date":{"description":"Deprecated; see created_date_ or timestamp_date_","format":"date","type":"string"},"transaction_code":{"description":"Filter by transaction code","type":"string"}},"type":"object"},"GroupedTransaction":{"properties":{"amount":{"$ref":"#/components/schemas/Money"},"category":{"$ref":"#/components/schemas/GroupedTransactionsCategory"},"description":{"type":"string"},"heron_id":{"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"GroupedTransactionMerchant":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/MerchantCategory"},"readOnly":true,"type":"array"},"group_id":{"enum":["Uber","Google","Intuit","debt.mca_or_rbf","debt.non_bank_business","debt.equipment_and_auto_leasing","debt.mortgage","debt.personal_non_mortgage","debt.collections","debt.collections.mca","debt.bank","invoice_factoring","fuel_provider","gambling_and_betting","debt.sba","debt.payday_or_pawn","debt_settlement","credit_builder","crypto_exchange","brokerage","insurer","benefits_provider","tax_authority.federal","tax_authority.state","government.benefits","government.child_support","correctional_services","payroll_provider","fuel_provider.truck_stop","tolls","payment_processor","payment_processor.restaurant","payment_processor.salon","payment_processor.field_service","payment_processor.ecommerce","payment_processor.fitness","marketplace","marketplace.food_delivery","marketplace.gig","payment_platform.b2b","software.restaurant","software.salon","software.field_service","software.medical_practice","software.ecommerce","payer.freight_broker","payer.healthcare","payer.auto_dealer","vendor.building_materials","vendor.food_supply","vendor.beverage","vendor.auto_parts","vendor.auto_auction","vendor.medical_supply","vendor.beauty_supply","vendor.cleaning_supply","vendor.shipping","vendor.advertising","vendor.wholesale","vendor.equipment_rental","vendor.trucking_services","vendor.telecom","vendor.waste","vendor.uniforms","consumer.discount_retail","consumer.fast_food","consumer.gaming","consumer.apple_cash",null],"nullable":true,"type":"string"},"heron_id":{"example":"mrc_8bYsSyAMW6LGsGFZi8GF9F","readOnly":true,"type":"string"},"icon_url":{"format":"url","readOnly":true,"type":"string"},"logo_url":{"format":"url","readOnly":true,"type":"string"},"name":{"type":"string"}},"type":"object"},"GroupedTransactionsCategory":{"properties":{"heron_id":{"type":"string"},"label":{"type":"string"}},"type":"object"},"HeronScoreFeatureGroupContribution":{"properties":{"relative_contribution":{"type":"number"},"relative_population_avg":{"type":"number"}},"type":"object"},"HeronScoreSchema":{"properties":{"data_quality_issues":{"description":"A list of data quality issues that may have impacted the score","items":{"enum":["transactions_without_timestamps","date_range_too_low","confidence_too_low","ctg_coverage_too_low","data_volume_too_low","data_not_fresh"],"type":"string"},"type":"array"},"feature_groups_contributions":{"additionalProperties":{"$ref":"#/components/schemas/HeronScoreFeatureGroupContribution"},"type":"object"},"predicted_at":{"description":"When the Heron Score was predicted","format":"date-time","type":"string"},"reference_timestamp":{"description":"When the Heron Score was calculated for; by default the last transaction timestamp for the company","format":"date-time","type":"string"},"status":{"enum":["not_available","partially_available","available"],"type":"string"},"value":{"description":"The Heron Score value","type":"integer"}},"type":"object"},"HumanInTheLoopParserConfig":{"properties":{"alert_channel":{"nullable":true,"type":"string"},"enabled":{"type":"boolean"},"run_jitl":{"type":"boolean"}},"type":"object"},"IdentityFraudFlag":{"properties":{"category":{"description":"Identity-fraud signal category.","enum":["ssn_multiple_identities","deceased_ssn","ssn_anomaly","ssn_address_alert","sex_offender_registry"],"type":"string"},"detail":{"description":"Source-provided signal detail; null when unavailable.","nullable":true,"type":"string"},"flag":{"description":"Identity-fraud signal reported for the applicant.","type":"string"},"support_status":{"description":"Supporting-record state for an affirmative CLEAR flag: supported, conflicting, or clear_only. Null for other signals.","enum":["supported","conflicting","clear_only",null],"nullable":true,"type":"string"}},"required":["category","flag"],"type":"object"},"InboundEmailSettings":{"properties":{"allowed_from_addresses":{"items":{"format":"email","type":"string"},"type":"array"},"allowed_from_domains":{"items":{"type":"string"},"type":"array"},"allowed_to_addresses":{"items":{"format":"email","type":"string"},"type":"array"},"blocked_from_domains":{"items":{"type":"string"},"type":"array"},"email_classification_ignored_domains":{"description":"The customer's own email domains. Addresses from these domains are excluded from the rule-based broker/lender role assignment, since they typically belong to the lender/operator rather than the broker submitting the deal. For example, if big_capital.com is listed and we receive an email from bob@big_capital.com, Bob will not be automatically assigned the broker role \u2014 though the LLM may still assign it if the email content suggests otherwise.","items":{"type":"string"},"type":"array"},"match_emails_with_same_subject_line":{"description":"Whether to group re-submissions with the same subject line into the same end user","type":"boolean"},"skip_to_address_check_from_domains":{"items":{"type":"string"},"type":"array"}},"type":"object"},"IndustryParams":{"properties":{"naics_code_max_digits":{"description":"Maximum number of digits in NAICS code","example":6,"maximum":6,"minimum":2,"type":"integer"},"naics_code_min_digits":{"description":"Minimum number of digits in NAICS code","example":2,"maximum":6,"minimum":2,"type":"integer"}},"type":"object"},"IndustrySchema":{"properties":{"label":{"description":"The text name of the taxonomy value","example":"Fruit and Vegetable Preserving and Specialty Food Manufacturing","type":"string"},"probability":{"description":"The probability that the end user is associated with the industry; we will always return the highest probability industry","example":"0.42","format":"decimal","type":"string"},"taxonomy":{"description":"Industry classification system used","example":"naics","type":"string"},"taxonomy_value":{"description":"The predicted industry for the end user according to taxonomy","example":"3114","nullable":true,"type":"string"}},"type":"object"},"InscribeAccount":{"properties":{"account_type":{"nullable":true,"type":"string"},"beginning_balance":{"allOf":[{"$ref":"#/components/schemas/InscribeNumberPrediction"}],"nullable":true},"ending_balance":{"allOf":[{"$ref":"#/components/schemas/InscribeNumberPrediction"}],"nullable":true},"institution_name":{"nullable":true,"type":"string"},"number":{"$ref":"#/components/schemas/InscribeStringPrediction"},"transactions":{"items":{"$ref":"#/components/schemas/InscribeTransaction"},"type":"array"},"transactions_match_balances":{"nullable":true,"type":"boolean"}},"type":"object"},"InscribeNumberPrediction":{"properties":{"confidence":{"type":"number"},"normalized":{"type":"integer"},"raw":{"type":"string"}},"type":"object"},"InscribeParsedDetails":{"properties":{"bank_accounts":{"items":{"$ref":"#/components/schemas/InscribeAccount"},"type":"array"},"name":{"$ref":"#/components/schemas/InscribeParsedDetailsName"}},"type":"object"},"InscribeParsedDetailsName":{"properties":{"raw":{"type":"string"}},"type":"object"},"InscribeSchema":{"properties":{"customer_name":{"nullable":true,"type":"string"},"parsed_details":{"$ref":"#/components/schemas/InscribeParsedDetails"}},"type":"object"},"InscribeStringPrediction":{"properties":{"confidence":{"type":"number"},"normalized":{"type":"string"},"raw":{"type":"string"}},"type":"object"},"InscribeTransaction":{"properties":{"amount":{"type":"integer"},"date":{"format":"date","type":"string"},"description":{"type":"string"},"id":{"type":"string"}},"type":"object"},"InspectionReportSchema":{"properties":{"inspection_data":{"additionalProperties":{},"nullable":true,"type":"object"},"type_of_inspection":{"enum":["CommercialProperty","CommercialLiability","CommercialPackage","ContractorTelephone","Nonproductive","InsuredFailureToAppear","Mueller","Other",null],"nullable":true,"type":"string"}},"type":"object"},"IntegrationCreatedSchema":{"properties":{"base_url":{"description":"Base URL of the API integration. For Google Drive, use root_dir_path in client_auth instead.","example":"https://sandbox.plaid.com","format":"url","nullable":true,"type":"string"},"client_auth":{"additionalProperties":{},"description":"Client-specific authentication settings depending on the integration type","type":"object","writeOnly":true},"client_id":{"description":"Client ID for API access (this is encrypted in transit and at-rest with a custom key). Required for Plaid integration. Returned in full only in the create response; every later read returns it masked: `****` plus its last four characters when it is at least 16 characters long, otherwise `****`.","nullable":true,"type":"string"},"client_secret":{"description":"Client Secret for API access (this is encrypted in transit and at-rest with a custom key). Required for Plaid integration. Returned in full only in the create response; every later read returns it masked: `****` plus its last four characters when it is at least 16 characters long, otherwise `****`.","nullable":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"name":{"description":"A name for your integration","example":"Plaid Prod","type":"string"},"resource":{"description":"For integrations with multiple available resources, the specific resource","enum":["transaction","assets_report","end_user_application","invoice_factoring_processing","end_user_files","funder_decision"],"type":"string"},"setup_metadata":{"additionalProperties":{},"description":"Details for setting up the integration, such as the Experian sales rep. Stored unencrypted, so never put credentials here.","nullable":true,"type":"object"},"type":{"description":"The integration type, a specific provider","type":"string"},"webhook_url":{"description":"URL provided by you to which we'll forward all webhooks (optional)","example":"https://your-server.yourdomain.com/hooks","format":"url","nullable":true,"type":"string"}},"required":["name","resource","type"],"type":"object"},"IntegrationEnvironment":{"properties":{"has_credentials":{"type":"boolean"},"last_test_attempted_at":{"format":"date-time","nullable":true,"type":"string"},"last_test_deal_id":{"nullable":true,"type":"string"},"last_test_status":{"enum":["not_run","in_progress","succeeded","failed"]},"last_test_status_message":{"nullable":true,"type":"string"}},"required":["has_credentials","last_test_status"],"type":"object"},"IntegrationLinkNewSchema":{"properties":{"access_token":{"description":"The generated token that grants access to the bank (this is encrypted in transit and at-rest with a custom key)","example":"access-sandbox-de3ce8ef-33f8-452c-a685-8671031fc0f6","nullable":false,"type":"string","writeOnly":true},"asset_report_token":{"description":"Optional. If you already have a Plaid asset report, pass the token to skip creating a new one.","nullable":true,"type":"string","writeOnly":true},"assets_report_days_to_sync":{"description":"Plaid assets report only. Days of history for the first report. Defaults to your account setting. Refreshes without this field use your account setting and delete transactions older than it.","example":90,"maximum":730,"minimum":1,"nullable":true,"type":"integer","writeOnly":true},"created":{"description":"When the integration link was created in Heron system","example":"2020-01-01T00:00:00Z","format":"date-time","readOnly":true,"type":"string"},"data_source_heron_id":{"type":"string"},"end_user_id":{"description":"A unique identifier for your end user (customer) generated by you","example":"7cb48787-6d91-5b9f-bc60-f30298ea5736","type":"string","writeOnly":true},"end_user_name":{"description":"An human readable name for this end user, like the company legal name","example":"Acme Corp","type":"string","writeOnly":true},"item_id":{"description":"Unique identifier for each bank connection made by your end users. In Plaid this is the 'item_id'.","example":"M5eVJqLnv3tbzdngLDp9FL5OlDNxlNhlE55op","nullable":false,"type":"string"},"last_successful_sync":{"description":"When the integration link was last successfully synced","example":"2020-01-01T00:00:00Z","format":"date-time","nullable":true,"readOnly":true,"type":"string"},"last_updated":{"description":"When the integration link was last updated in Heron system","example":"2020-01-01T00:00:00Z","format":"date-time","readOnly":true,"type":"string"},"status":{"description":"The integration link status","enum":["pending","active","syncing","erroring","sync_disabled","deleted_in_plaid"],"example":"active","readOnly":true,"type":"string"},"status_message":{"description":"A message describing the 'erroring' status of the integration link","example":"[ITEM_LOGIN_REQUIRED] the login details of this item have changed (credentials, MFA, or required user action) and a user login is required to update this information. use Link's update mode to restore the item to a good state","nullable":true,"readOnly":true,"type":"string"},"type":{"description":"The integration link type, inherited from the integration: plaid_assets_report or plaid_integration","example":"plaid_assets_report","readOnly":true,"type":"string"}},"required":["access_token","end_user_id","item_id"],"type":"object"},"IntegrationLinkRefreshSchema":{"properties":{"assets_report_days_to_sync":{"description":"Plaid assets report only. Days of history to refresh. Defaults to your account setting. WARNING: DESTRUCTIVE. Transactions older than this many days are deleted, with their labels. Dashboard refreshes don't send this field, so they use your account setting.","example":730,"maximum":730,"minimum":1,"nullable":true,"type":"integer"}},"type":"object"},"IntegrationLinkSchema":{"properties":{"access_token":{"description":"The generated token that grants access to the bank (this is encrypted in transit and at-rest with a custom key)","example":"access-sandbox-de3ce8ef-33f8-452c-a685-8671031fc0f6","nullable":false,"type":"string","writeOnly":true},"asset_report_token":{"description":"Optional. If you already have a Plaid asset report, pass the token to skip creating a new one.","nullable":true,"type":"string","writeOnly":true},"assets_report_days_to_sync":{"description":"Plaid assets report only. Days of history for the first report. Defaults to your account setting. Refreshes without this field use your account setting and delete transactions older than it.","example":90,"maximum":730,"minimum":1,"nullable":true,"type":"integer","writeOnly":true},"created":{"description":"When the integration link was created in Heron system","example":"2020-01-01T00:00:00Z","format":"date-time","readOnly":true,"type":"string"},"end_user_id":{"description":"A unique identifier for your end user (customer) generated by you","example":"7cb48787-6d91-5b9f-bc60-f30298ea5736","type":"string","writeOnly":true},"end_user_name":{"description":"An human readable name for this end user, like the company legal name","example":"Acme Corp","type":"string","writeOnly":true},"item_id":{"description":"Unique identifier for each bank connection made by your end users. In Plaid this is the 'item_id'.","example":"M5eVJqLnv3tbzdngLDp9FL5OlDNxlNhlE55op","nullable":false,"type":"string"},"last_successful_sync":{"description":"When the integration link was last successfully synced","example":"2020-01-01T00:00:00Z","format":"date-time","nullable":true,"readOnly":true,"type":"string"},"last_updated":{"description":"When the integration link was last updated in Heron system","example":"2020-01-01T00:00:00Z","format":"date-time","readOnly":true,"type":"string"},"status":{"description":"The integration link status","enum":["pending","active","syncing","erroring","sync_disabled","deleted_in_plaid"],"example":"active","readOnly":true,"type":"string"},"status_message":{"description":"A message describing the 'erroring' status of the integration link","example":"[ITEM_LOGIN_REQUIRED] the login details of this item have changed (credentials, MFA, or required user action) and a user login is required to update this information. use Link's update mode to restore the item to a good state","nullable":true,"readOnly":true,"type":"string"},"type":{"description":"The integration link type, inherited from the integration: plaid_assets_report or plaid_integration","example":"plaid_assets_report","readOnly":true,"type":"string"}},"required":["access_token","end_user_id","item_id"],"type":"object"},"IntegrationLinkUpdateSchema":{"properties":{"access_token":{"description":"The generated token that grants access to the bank (this is encrypted in transit and at-rest with a custom key)","example":"access-sandbox-de3ce8ef-33f8-452c-a685-8671031fc0f6","type":"string","writeOnly":true}},"required":["access_token"],"type":"object"},"IntegrationSchema":{"properties":{"base_url":{"description":"Base URL of the API integration. For Google Drive, use root_dir_path in client_auth instead.","example":"https://sandbox.plaid.com","format":"url","nullable":true,"type":"string"},"client_auth":{"additionalProperties":{},"description":"Client-specific authentication settings depending on the integration type","type":"object","writeOnly":true},"client_id":{"description":"Client ID for API access (this is encrypted in transit and at-rest with a custom key). Required for Plaid integration. Returned in full only in the create response; every later read returns it masked: `****` plus its last four characters when it is at least 16 characters long, otherwise `****`.","nullable":true,"type":"string"},"client_secret":{"description":"Client Secret for API access (this is encrypted in transit and at-rest with a custom key). Required for Plaid integration. Returned in full only in the create response; every later read returns it masked: `****` plus its last four characters when it is at least 16 characters long, otherwise `****`.","nullable":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"name":{"description":"A name for your integration","example":"Plaid Prod","type":"string"},"resource":{"description":"For integrations with multiple available resources, the specific resource","enum":["transaction","assets_report","end_user_application","invoice_factoring_processing","end_user_files","funder_decision"],"type":"string"},"setup_metadata":{"additionalProperties":{},"description":"Details for setting up the integration, such as the Experian sales rep. Stored unencrypted, so never put credentials here.","nullable":true,"type":"object"},"type":{"description":"The integration type, a specific provider","type":"string"},"webhook_url":{"description":"URL provided by you to which we'll forward all webhooks (optional)","example":"https://your-server.yourdomain.com/hooks","format":"url","nullable":true,"type":"string"}},"required":["name","resource","type"],"type":"object"},"InteractionLogResponseSchema":{"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"}},"type":"object"},"IsoAppAddress":{"properties":{"address_line_1":{"nullable":true,"type":"string"},"address_line_2":{"nullable":true,"type":"string"},"city":{"nullable":true,"type":"string"},"state":{"nullable":true,"type":"string"},"zip":{"nullable":true,"type":"string"}},"required":["address_line_1","address_line_2","city","state","zip"],"type":"object"},"IsoAppBusiness":{"properties":{"address":{"allOf":[{"$ref":"#/components/schemas/IsoAppAddress"}],"nullable":true},"annual_revenue":{"nullable":true,"type":"number"},"doing_business_as":{"nullable":true,"type":"string"},"ein":{"nullable":true,"type":"string"},"email":{"nullable":true,"type":"string"},"incorporated_state":{"nullable":true,"type":"string"},"industry":{"nullable":true,"type":"string"},"monthly_revenue":{"nullable":true,"type":"number"},"name":{"nullable":true,"type":"string"},"phone_number":{"nullable":true,"type":"string"},"start_date":{"nullable":true,"type":"string"},"type_of_business_entity":{"nullable":true,"type":"string"},"website":{"nullable":true,"type":"string"}},"required":["address","annual_revenue","doing_business_as","ein","email","incorporated_state","industry","monthly_revenue","name","phone_number","start_date","type_of_business_entity","website"],"type":"object"},"IsoAppFunding":{"properties":{"amount_requested":{"nullable":true,"type":"number"},"loan_purpose":{"nullable":true,"type":"string"}},"required":["amount_requested","loan_purpose"],"type":"object"},"IsoAppOwnerWithSignature":{"properties":{"address":{"allOf":[{"$ref":"#/components/schemas/IsoAppAddress"}],"nullable":true},"cell_phone":{"nullable":true,"type":"string"},"credit_score":{"nullable":true,"type":"integer"},"date_of_signature":{"nullable":true,"type":"string"},"dob":{"nullable":true,"type":"string"},"email":{"nullable":true,"type":"string"},"first_name":{"nullable":true,"type":"string"},"home_phone":{"nullable":true,"type":"string"},"is_signed":{"nullable":true,"type":"boolean"},"last_name":{"nullable":true,"type":"string"},"ownership_percent":{"nullable":true,"type":"string"},"ssn":{"nullable":true,"type":"string"}},"required":["address","cell_phone","date_of_signature","dob","email","first_name","home_phone","is_signed","last_name","ownership_percent","ssn"],"type":"object"},"IsoAppWithOwnerSignaturesResponseSchema":{"properties":{"business":{"allOf":[{"$ref":"#/components/schemas/IsoAppBusiness"}],"nullable":true},"funding":{"allOf":[{"$ref":"#/components/schemas/IsoAppFunding"}],"nullable":true},"owner1":{"allOf":[{"$ref":"#/components/schemas/IsoAppOwnerWithSignature"}],"nullable":true},"owner2":{"allOf":[{"$ref":"#/components/schemas/IsoAppOwnerWithSignature"}],"nullable":true}},"required":["business","funding","owner1","owner2"],"type":"object"},"IsoApplicationFieldResult":{"properties":{"document_field_name":{"description":"The field's original name in the source document","example":"Company Legal Name","type":"string"},"is_empty":{"description":"Whether the value is empty","example":false,"type":"boolean"},"value":{"description":"The value extracted from the document for the current field","example":"Heron Data Ltd","nullable":true,"type":"string"},"value_confidence":{"description":"OCR confidence of the extracted value","example":0.99,"nullable":true,"type":"number"}},"required":["document_field_name","is_empty","value","value_confidence"],"type":"object"},"IsoApplicationFieldValidation":{"properties":{"failure_reason":{"nullable":true,"type":"string"},"field_name":{"type":"string"},"result":{"enum":["pass","fail","not_applicable"],"example":"pass","type":"string"},"validation_type":{"type":"string"}},"required":["failure_reason","field_name","result","validation_type"],"type":"object"},"JsonPatch":{"properties":{"op":{"enum":["add","remove","replace","move","copy","test"]},"path":{"type":"string"},"value":{"nullable":true}},"required":["op","path"],"type":"object"},"LawsuitRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"amount":{"description":"Amount on the case as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"amount_type":{"description":"What the lawsuit amount represents: demand or judgment.","enum":["judgment","award","demand",null],"nullable":true,"type":"string"},"case_category":{"description":"Source-provided case category.","nullable":true,"type":"string"},"case_number":{"description":"Court case reference; null when unavailable.","nullable":true,"type":"string"},"case_status":{"description":"Status classification: active, ended, judgment, or no_status. Judgment means entered and still counts as active.","enum":["active","ended","judgment","no_status",null],"nullable":true},"case_status_date":{"description":"Date of the case status; null when unavailable.","format":"date","nullable":true,"type":"string"},"case_sub_category":{"description":"Source-provided case subcategory.","nullable":true,"type":"string"},"case_title":{"description":"Case title; null when unavailable.","nullable":true,"type":"string"},"case_type":{"description":"Source-provided case type.","nullable":true,"type":"string"},"company_interest":{"description":"The business's role as the source reported it; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Court name; null when unavailable.","nullable":true,"type":"string"},"defendant_name":{"description":"Defendant named on the case.","nullable":true,"type":"string"},"detail":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckRecordDetail"}],"description":"Only populated when include_section_detail=true is passed on the request","nullable":true},"entry_count":{"description":"Number of underlying source entries combined into this record.","type":"integer"},"file_date":{"description":"Filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"is_active":{"description":"True when the lawsuit appears to still be live.","type":"boolean"},"is_felony":{"description":"True when the docket record is felony-graded.","type":"boolean"},"is_mca":{"description":"True when the litigation was brought by a known merchant cash advance funder.","type":"boolean"},"lawsuit_types":{"description":"Matched lawsuit types: antitrust, RICO, class action, malpractice, or eviction.","items":{"enum":["antitrust","rico","class_action","malpractice","eviction"]},"type":"array"},"plaintiff_name":{"description":"Plaintiff named on the case.","nullable":true,"type":"string"},"record_type":{"description":"Record class: Lawsuit or Court docket.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source_entries":{"description":"Underlying source rows combined into this record.","items":{"$ref":"#/components/schemas/LitigationEntrySchema"},"type":"array"},"source_entry_ids":{"description":"References for the underlying source rows combined into this record.","items":{"type":"string"},"type":"array"},"status_text":{"description":"Source-provided status string.","nullable":true,"type":"string"},"subject_role":{"description":"The business's role: defendant, defendant_name_match, plaintiff, or unknown when the source does not say.","enum":["defendant","defendant_name_match","plaintiff","unknown"]}},"type":"object"},"LienJudgmentEntrySchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"amount":{"description":"Amount on the record as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"amount_band":{"description":"Amount band: none, small under $10,000, medium from $10,000 to $49,999.99, or large at $50,000 or more.","enum":["none","small","medium","large"]},"case_number":{"description":"Court case reference; null when unavailable.","nullable":true,"type":"string"},"court_county":{"description":"County of the court; null when unavailable.","nullable":true,"type":"string"},"court_location":{"description":"Location of the court; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Court name; null when unavailable.","nullable":true,"type":"string"},"creditor_count":{"description":"Number of creditors on the case.","type":"integer"},"creditor_name":{"description":"First creditor named on the case; null when unavailable.","nullable":true,"type":"string"},"debtor_name":{"description":"Debtor named on the filing.","nullable":true,"type":"string"},"file_date":{"description":"Filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"filing_relationship":{"description":"Relationship to another filing: released_by or release_of; null when unlinked.","nullable":true,"type":"string"},"is_federal_tax_lien":{"description":"True when the filing is a federal tax lien.","type":"boolean"},"is_mca_creditor":{"description":"True when the creditor is a known merchant cash advance funder.","type":"boolean"},"is_released":{"description":"True when the source no longer shows the lien as outstanding. Vacated and closed records are included, not only released ones.","type":"boolean"},"original_filing_number":{"description":"Original filing number for this source entry.","nullable":true,"type":"string"},"record_type":{"description":"Source-provided record class.","nullable":true,"type":"string"},"related_filing_number":{"description":"Reference of the related filing; null when unlinked.","nullable":true,"type":"string"},"release_date":{"description":"Lien release date; null when unreleased.","format":"date","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"satisfaction_date":{"description":"Date the debt was satisfied as recorded on the source; null when unavailable.","format":"date","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source_entry_id":{"description":"Stable reference for the underlying source row; null when unavailable.","nullable":true,"type":"string"},"type_of_filing":{"description":"Source-provided filing type, such as JUDGMENT LIEN, FEDERAL TAX LIEN, or STATE TAX LIEN.","nullable":true,"type":"string"},"type_of_satisfaction":{"description":"How the debt was satisfied as recorded on the source; null when unavailable.","nullable":true,"type":"string"},"vacate_date":{"description":"Judgment vacate date; null when not vacated.","format":"date","nullable":true,"type":"string"}},"type":"object"},"LienJudgmentRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"amount":{"description":"Amount on the record as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"amount_band":{"description":"Amount band: none, small under $10,000, medium from $10,000 to $49,999.99, or large at $50,000 or more.","enum":["none","small","medium","large"]},"case_number":{"description":"Court case reference; null when unavailable.","nullable":true,"type":"string"},"court_county":{"description":"County of the court; null when unavailable.","nullable":true,"type":"string"},"court_location":{"description":"Location of the court; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Court name; null when unavailable.","nullable":true,"type":"string"},"creditor_count":{"description":"Number of creditors on the case.","type":"integer"},"creditor_name":{"description":"First creditor named on the case; null when unavailable.","nullable":true,"type":"string"},"debtor_name":{"description":"Debtor named on the filing.","nullable":true,"type":"string"},"detail":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckRecordDetail"}],"description":"Only populated when include_section_detail=true is passed on the request","nullable":true},"entry_count":{"description":"Number of underlying source entries combined into this record.","type":"integer"},"file_date":{"description":"Filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"filing_relationship":{"description":"Relationship to another filing: released_by or release_of; null when unlinked.","nullable":true,"type":"string"},"is_federal_tax_lien":{"description":"True when the filing is a federal tax lien.","type":"boolean"},"is_mca_creditor":{"description":"True when the creditor is a known merchant cash advance funder.","type":"boolean"},"is_released":{"description":"True when the source no longer shows the lien as outstanding. Vacated and closed records are included, not only released ones.","type":"boolean"},"lawsuit_types":{"description":"Matched lawsuit types. Eviction appears only on an open eviction judgment.","items":{"enum":["antitrust","rico","class_action","malpractice","eviction"]},"type":"array"},"record_type":{"description":"Source-provided record class.","nullable":true,"type":"string"},"related_filing_number":{"description":"Reference of the related filing; null when unlinked.","nullable":true,"type":"string"},"release_date":{"description":"Lien release date; null when unreleased.","format":"date","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"satisfaction_date":{"description":"Date the debt was satisfied as recorded on the source; null when unavailable.","format":"date","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"shared_case_key":{"description":"Stable key for a record that appears on both owner and business reports; null when not shared.","nullable":true,"type":"string"},"shared_relationship":{"description":"Where the shared record also appears: also_on_business or also_on_owner; null when not shared.","enum":["also_on_owner","also_on_business",null],"nullable":true,"type":"string"},"source_entries":{"description":"Underlying source rows combined into this record.","items":{"$ref":"#/components/schemas/LienJudgmentEntrySchema"},"type":"array"},"source_entry_ids":{"description":"References for the underlying source rows combined into this record.","items":{"type":"string"},"type":"array"},"status":{"description":"Lien status: open, released, vacated, or closed.","enum":["open","released","vacated","closed"]},"type_of_filing":{"description":"Source-provided filing type, such as JUDGMENT LIEN, FEDERAL TAX LIEN, or STATE TAX LIEN.","nullable":true,"type":"string"},"type_of_satisfaction":{"description":"How the debt was satisfied as recorded on the source; null when unavailable.","nullable":true,"type":"string"},"vacate_date":{"description":"Judgment vacate date; null when not vacated.","format":"date","nullable":true,"type":"string"}},"type":"object"},"LinkedFunderSubmission":{"additionalProperties":false,"properties":{"heron_id":{"readOnly":true,"type":"string"},"status":{"enum":["pending","in_progress","submitted_to_funder","invalid_data_for_funder","submission_failed","approved","declined",null],"nullable":true,"readOnly":true},"submitted_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"LitigationEntrySchema":{"properties":{"case_number":{"description":"Court case reference; null when unavailable.","nullable":true,"type":"string"},"court_name":{"description":"Court name; null when unavailable.","nullable":true,"type":"string"},"file_date":{"description":"Filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"record_type":{"description":"Source record class: lawsuit or court docket.","nullable":true,"type":"string"},"source_entry_id":{"description":"Stable reference for the underlying source row; null when unavailable.","nullable":true,"type":"string"},"status_text":{"description":"Source-provided status string.","nullable":true,"type":"string"}},"type":"object"},"LoadUnreconciledTransactionsFilters":{"properties":{"last_n_days":{"minimum":1,"type":"integer"}},"required":["last_n_days"],"type":"object"},"LoadUnreconciledTransactionsRule":{"properties":{"file_class":{"type":"string"},"filters":{"$ref":"#/components/schemas/LoadUnreconciledTransactionsFilters"}},"required":["file_class"],"type":"object"},"LookupKey":{"properties":{"label":{"description":"The variable the table is looked up by","type":"string"},"parameters":{"additionalProperties":{"oneOf":[{"type":"string"},{"items":{"type":"string"},"type":"array"}]},"description":"The variable's settings, e.g. address and part; null when the variable takes none","nullable":true,"type":"object"}},"required":["label","parameters"],"type":"object"},"LookupTableCreateSchema":{"properties":{"change_description":{"maxLength":255,"nullable":true,"type":"string"},"definition":{"additionalProperties":{},"type":"object"},"name":{"maxLength":255,"minLength":1,"type":"string"}},"required":["definition","name"],"type":"object"},"LookupTableSchema":{"properties":{"definition":{"description":"The key, columns, rows and default row, in the shape the create and update routes take. The key is the variable's label, or {\"label\": ..., \"parameters\": {...}} when it has settings","readOnly":true},"heron_id":{"description":"Heron ID of the lookup table","type":"string"},"is_draft":{"description":"True while the version can still be edited","type":"boolean"},"key":{"allOf":[{"$ref":"#/components/schemas/LookupKey"}],"description":"The variable the table is looked up by"},"key_value_set":{"description":"The values the key variable takes with its settings, e.g. us_state; null when it has no fixed list. Its options come from the value sets endpoint","enum":["us_state","naics_industry","naics_code","restricted_industries","merchant","crm_decline_reason","iso_source_name","business_entity_type","fraud_network_finding","broker_velocity","broker_velocity_signal","fraud_network_scan_status","fraud_network_classification","industry_category","datamerch_note_category","complete_months",null],"nullable":true},"name":{"type":"string"},"version":{"description":"The table version this policy version pins","type":"integer"}},"required":["definition","heron_id","is_draft","key","key_value_set","name","version"],"type":"object"},"LookupTableSummarySchema":{"properties":{"heron_id":{"description":"Heron ID of the lookup table","type":"string"},"is_draft":{"description":"True while the newest version can still be edited","type":"boolean"},"key":{"allOf":[{"$ref":"#/components/schemas/LookupKey"}],"description":"The variable the newest version is looked up by; null when it can't be read","nullable":true},"key_value_set":{"description":"The values the key variable takes with its settings, e.g. us_state; null when it has no fixed list","enum":["us_state","naics_industry","naics_code","restricted_industries","merchant","crm_decline_reason","iso_source_name","business_entity_type","fraud_network_finding","broker_velocity","broker_velocity_signal","fraud_network_scan_status","fraud_network_classification","industry_category","datamerch_note_category","complete_months",null],"nullable":true},"name":{"type":"string"},"version":{"description":"The table's newest version","type":"integer"}},"required":["heron_id","is_draft","key","key_value_set","name","version"],"type":"object"},"LookupTableUpdateSchema":{"properties":{"change_description":{"maxLength":255,"nullable":true,"type":"string"},"definition":{"additionalProperties":{},"description":"The whole table, replacing the current one: key (the variable the table is looked up by, as its label or as {\"label\": ..., \"parameters\": {...}} with its settings), columns (may be empty for a plain list), rows (each with keys and values) and unlisted (behaviour and values for a key not in the table). Each column has an id, name and type: years, money, number, list or month_window. A month_window column's cells are chosen from its value set (complete_months, fixed in code). A threshold cannot read it","type":"object"}},"required":["definition"],"type":"object"},"LookupTableVersionDetailSchema":{"properties":{"author_email":{"description":"Who last edited the version","type":"string"},"change_description":{"nullable":true,"type":"string"},"definition":{"additionalProperties":{},"description":"The key attribute, columns, rows and default row, in the shape the create and update routes take","type":"object"},"is_pinned_in_active":{"description":"True when the active policy version pins it","type":"boolean"},"is_pinned_in_draft":{"description":"True when the draft policy version pins it","type":"boolean"},"last_edited_at":{"format":"date-time","nullable":true,"type":"string"},"published_at":{"format":"date-time","nullable":true,"type":"string"},"status":{"description":"draft while the version can still be edited, else published","type":"string"},"version":{"type":"integer"}},"required":["author_email","definition","is_pinned_in_active","is_pinned_in_draft","status","version"],"type":"object"},"LookupTableVersionSchema":{"properties":{"author_email":{"description":"Who last edited the version","type":"string"},"change_description":{"nullable":true,"type":"string"},"is_pinned_in_active":{"description":"True when the active policy version pins it","type":"boolean"},"is_pinned_in_draft":{"description":"True when the draft policy version pins it","type":"boolean"},"last_edited_at":{"format":"date-time","nullable":true,"type":"string"},"published_at":{"format":"date-time","nullable":true,"type":"string"},"status":{"description":"draft while the version can still be edited, else published","type":"string"},"version":{"type":"integer"}},"required":["author_email","is_pinned_in_active","is_pinned_in_draft","status","version"],"type":"object"},"LossRunPolicy":{"properties":{"broker_name":{"description":"The name of the broker that arranged the insurance policy","nullable":true,"type":"string"},"claims":{"description":"A list of the claims associated with the the policy","items":{"$ref":"#/components/schemas/PolicyClaim"},"nullable":true,"type":"array"},"insurance_company_name":{"description":"The insurance company and/or insurance carrier that issued the policy, often listed in the title of the document, e.g. AGMI, National Casualty Company, Atlas Financial Holdings, etc. If multiple possible companies are provided for the policy, include each one separated by forward-slashes.","nullable":true,"type":"string"},"insurance_type":{"description":"The type of insurance for the policy. For example, Liability Loss, Physical Damage, Motor Truck Cargo. Leave blank if not applicable","nullable":true,"type":"string"},"insured_name":{"description":"The name of the person/company on the insurance policy","nullable":true,"type":"string"},"number_of_units":{"description":"The number of individual items or exposures covered under the policy. For example, the number of vehicles covered by the policy. Leave blank if not applicable","nullable":true,"type":"integer"},"policy_cancellation_date":{"description":"The date the policy was cancelled prior to its expiration, if applicable","format":"date","nullable":true,"type":"string"},"policy_effective_date":{"description":"The start date of the policy coverage period in YYYY-MM-DD format","format":"date","nullable":true,"type":"string"},"policy_expiration_date":{"description":"The end date of the policy coverage period in YYYY-MM-DD format","format":"date","nullable":true,"type":"string"},"policy_number":{"description":"The unique identifier assigned to the insurance policy","nullable":true,"type":"string"},"report_generation_date":{"description":"The date the report was generate in YYYY-MM-DD format. This may also be called 'Valuation Date' or 'Individual Risk Experience as of' if not immediately found elsewhere in the document","format":"date","nullable":true,"type":"string"},"total_expense":{"description":"The sum of all expense amounts from all losses in the policy. This value should only be extracted if it is present in the document. Also called 'ALAE Incurred' or 'Total ALAE'","nullable":true,"type":"number"},"total_incurred":{"description":"The sum of total incurred amounts from all losses in the policy. If there were no claims made for the policy, this value should be 0. This value should only be extracted if it is present in the document or if it can be calculated directly from the totals row for the policy using your existing knowledge of loss runs.\nFor example, if there is are Loss Incurred and Total ALAE values for the policy, it is possible to calculate the total incurred","nullable":true,"type":"number"},"total_paid":{"description":"The sum of total paid amounts from all losses in the policy. This value should only be extracted if it is present in the document. If not clearly provided in one of the totals row, 'Total Paid' may be found in the totals row of the 'Paid Loss' column.","nullable":true,"type":"number"},"total_recovered":{"description":"The sum of total recovered amounts from all losses in the policy. This value should only be extracted if it is present in the document.","nullable":true,"type":"number"},"total_reserve":{"description":"The sum of total reserve amounts from all losses in the policy. This value should only be extracted if it is present in the document.","nullable":true,"type":"number"}},"type":"object"},"LossRunResultSchema":{"properties":{"policies":{"description":"A list of the policies on the loss run","items":{"$ref":"#/components/schemas/LossRunPolicy"},"nullable":true,"type":"array"}},"type":"object"},"ManualDealLinkRequest":{"additionalProperties":false,"properties":{"deal_end_user_heron_id":{"type":"string"}},"required":["deal_end_user_heron_id"],"type":"object"},"MarriageRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"ceremony_type":{"description":"Source-provided marriage ceremony type; null for divorce-only rows.","nullable":true,"type":"string"},"county":{"description":"County named on the record.","nullable":true,"type":"string"},"decree_date":{"description":"Divorce decree date; null for marriage-only rows.","format":"date","nullable":true,"type":"string"},"filing_date":{"description":"Divorce filing date; null for marriage-only rows.","format":"date","nullable":true,"type":"string"},"is_active":{"description":"True when the linked divorce case appears active.","type":"boolean"},"is_divorced":{"description":"True when the marriage has a linked divorce record.","type":"boolean"},"location":{"description":"Location named on the record.","nullable":true,"type":"string"},"marriage_date":{"description":"Marriage date; null for divorce-only rows.","format":"date","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"spouse_name":{"description":"Spouse name; null for divorce-only rows.","nullable":true,"type":"string"}},"type":"object"},"MaterialisedEndUserEntityAttribute":{"properties":{"attribute_heron_id":{"type":"string"},"attribute_name":{"type":"string"},"attribute_type":{"enum":["float","int","decimal","string","date","datetime","bool"]},"display_order":{"type":"integer"},"materialised_sources":{"items":{"$ref":"#/components/schemas/MaterialisedEndUserEntityAttributeSource"},"type":"array"},"selected_source":{"allOf":[{"$ref":"#/components/schemas/MaterialisedEndUserEntityAttributeSource"}],"nullable":true}},"type":"object"},"MaterialisedEndUserEntityAttributeSource":{"properties":{"source":{"$ref":"#/components/schemas/EndUserEntityAttributeSourceSchema"},"source_data":{"additionalProperties":{},"type":"object"},"timestamp":{"format":"date-time","type":"string"},"value":{}},"type":"object"},"MaterialisedEndUserEntitySchema":{"properties":{"display_order":{"type":"integer"},"entity_heron_id":{"type":"string"},"entity_name":{"type":"string"},"is_list":{"type":"boolean"},"materialised_attributes":{"items":{"$ref":"#/components/schemas/MaterialisedEndUserEntityAttribute"},"type":"array"}},"type":"object"},"McpEndpointCreatedSchema":{"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"label":{"description":"Human-readable label for this endpoint","readOnly":true,"type":"string"},"request_secret":{"description":"Present only when requested. Shown once; Heron stores only its digest.","readOnly":true,"type":"string"},"request_secret_required":{"description":"Whether MCP requests must carry the endpoint's request secret","readOnly":true,"type":"boolean"}},"required":["label","request_secret_required"],"type":"object"},"McpEndpointSchema":{"properties":{"created":{"format":"date-time","readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"label":{"description":"Human-readable label for this endpoint","readOnly":true,"type":"string"},"request_secret_required":{"description":"Whether MCP requests must carry the endpoint's request secret","readOnly":true,"type":"boolean"}},"required":["label","request_secret_required"],"type":"object"},"McpProtectedResourceMetadataSchema":{"properties":{"authorization_servers":{"items":{"type":"string"},"type":"array"},"resource":{"type":"string"},"scopes_supported":{"items":{"type":"string"},"type":"array"}},"type":"object"},"Merchant":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/MerchantCategory"},"readOnly":true,"type":"array"},"group_id":{"nullable":true,"type":"string"},"heron_id":{"example":"mrc_8bYsSyAMW6LGsGFZi8GF9F","readOnly":true,"type":"string"},"icon_url":{"format":"url","nullable":true,"type":"string"},"is_priority":{"readOnly":true,"type":"boolean"},"logo_url":{"format":"url","nullable":true,"type":"string"},"name":{"type":"string"},"url":{"format":"url","type":"string"}},"required":["name","url"],"type":"object"},"MerchantCategory":{"properties":{"code":{"example":"7311","readOnly":true,"type":"string"},"description":{"example":"Advertising services","nullable":true,"readOnly":true,"type":"string"},"slug":{"example":"advertising_services","nullable":true,"readOnly":true,"type":"string"}},"required":["code"],"type":"object"},"MerchantExtract":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/MerchantCategory"},"readOnly":true,"type":"array"},"confidence":{"maximum":1.0,"minimum":0.0,"nullable":true,"type":"number"},"group_id":{"type":"string"},"heron_id":{"example":"mrc_8bYsSyAMW6LGsGFZi8GF9F","readOnly":true,"type":"string"},"icon_url":{"format":"url","readOnly":true,"type":"string"},"logo_url":{"format":"url","readOnly":true,"type":"string"},"name":{"example":"Amazon","nullable":true,"readOnly":true,"type":"string"},"url":{"example":"https://www.amazon.com/","format":"url","nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"MerchantFeedback":{"properties":{"heron_id":{"description":"heron_id of the correct merchant","example":"mrc_8bYsSyAMW6LGsGFZi8GF9F","type":"string"},"is_correct":{"default":false,"example":false,"type":"boolean"},"name":{"description":"name of the correct merchant","example":"Spotify","type":"string"}},"type":"object"},"MerchantFeedback1":{"properties":{"merchant_group_id":{"description":"Group ID for the merchant (optional, for linking related merchants)","enum":["Uber","Google","Intuit","invoice_factoring","debt.bank","debt.mca_or_rbf","debt.other","debt.non_bank_business","debt.equipment_and_auto_leasing","debt.mortgage","debt.personal_non_mortgage","debt.collections","debt.collections.mca","fuel_provider","gambling_and_betting","debt.sba","debt.payday_or_pawn","debt_settlement","credit_builder","crypto_exchange","brokerage","insurer","benefits_provider","tax_authority.federal","tax_authority.state","government.benefits","government.child_support","correctional_services","payroll_provider","fuel_provider.truck_stop","tolls","payment_processor","payment_processor.restaurant","payment_processor.salon","payment_processor.field_service","payment_processor.ecommerce","payment_processor.fitness","marketplace","marketplace.food_delivery","marketplace.gig","payment_platform.b2b","software.restaurant","software.salon","software.field_service","software.medical_practice","software.ecommerce","payer.freight_broker","payer.healthcare","payer.auto_dealer","vendor.building_materials","vendor.food_supply","vendor.beverage","vendor.auto_parts","vendor.auto_auction","vendor.medical_supply","vendor.beauty_supply","vendor.cleaning_supply","vendor.shipping","vendor.advertising","vendor.wholesale","vendor.equipment_rental","vendor.trucking_services","vendor.telecom","vendor.waste","vendor.uniforms","consumer.discount_retail","consumer.fast_food","consumer.gaming","consumer.apple_cash"],"example":"Uber","type":"string"},"merchant_heron_id":{"description":"Heron ID of the merchant (if known in our database)","example":"mrc_8bYsSyAMW6LGsGFZi8GF9F","type":"string"},"merchant_name":{"description":"Name of the merchant (required if merchant_heron_id not provided)","example":"Acme Corporation","maxLength":140,"type":"string"},"merchant_url":{"description":"URL of the merchant (optional)","example":"https://acme.com","maxLength":2000,"type":"string"}},"type":"object"},"MerchantGroup":{"properties":{"description":{"description":"Description of merchant group","type":"string"},"id":{"description":"Unique ID of merchant group","type":"string"},"name":{"description":"Display name of merchant group","type":"string"}},"type":"object"},"MerchantList":{"properties":{"group_id":{"nullable":true,"type":"string"},"heron_id":{"example":"mrc_8bYsSyAMW6LGsGFZi8GF9F","readOnly":true,"type":"string"},"logo_url":{"format":"url","nullable":true,"type":"string"},"name":{"type":"string"},"url":{"format":"url","type":"string"}},"required":["name","url"],"type":"object"},"MerchantSummaryRow":{"properties":{"group":{"nullable":true,"type":"string"},"heron_id":{"nullable":true,"type":"string"},"inflow_metrics":{"allOf":[{"$ref":"#/components/schemas/MerchantSummaryRowMetrics"}],"nullable":true},"name":{"type":"string"},"net_metrics":{"$ref":"#/components/schemas/MerchantSummaryRowMetrics"},"outflow_metrics":{"$ref":"#/components/schemas/MerchantSummaryRowMetrics"},"transactions":{"items":{"$ref":"#/components/schemas/GroupedTransaction"},"type":"array"}},"type":"object"},"MerchantSummaryRowMetrics":{"properties":{"amount":{"$ref":"#/components/schemas/Money"},"changed_in_last_90_days":{"nullable":true,"type":"boolean"},"count":{"type":"integer"},"duration_days":{"type":"integer"},"estimated_monthly_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"frequency":{"enum":["not_enough_data","same_day","irregular","daily","weekly","biweekly","monthly","quarterly","annually","weekday","twice_weekly",null],"nullable":true,"type":"string"},"is_active":{"type":"boolean"},"max_amount":{"$ref":"#/components/schemas/Money"},"max_timestamp":{"format":"date-time","type":"string"},"mean_amount":{"$ref":"#/components/schemas/Money"},"mean_interval_days":{"format":"decimal","nullable":true,"type":"string"},"median_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Deprecated. This field is no longer being populated","nullable":true},"min_amount":{"$ref":"#/components/schemas/Money"},"min_timestamp":{"format":"date-time","type":"string"},"mode_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Deprecated. This field is no longer being populated","nullable":true},"mode_interval_days":{"nullable":true,"type":"integer"},"std_dev_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true}},"type":"object"},"MergedFiling":{"properties":{"address":{"description":"Address on this filing; null when unavailable.","nullable":true,"type":"string"},"business_name":{"description":"Business name on this filing; null when unavailable.","nullable":true,"type":"string"},"role":{"description":"Role recorded on this filing; null when unavailable.","nullable":true,"type":"string"},"since_date":{"description":"Date this filing reported the affiliation began.","format":"date","nullable":true,"type":"string"},"status":{"description":"Status this filing reported; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"Message":{"properties":{"message":{"type":"string"}},"type":"object"},"Metadata":{"properties":{"carrier_route":{"nullable":true,"type":"string"},"congressional_district":{"nullable":true,"type":"string"},"county_fips":{"nullable":true,"type":"string"},"county_name":{"nullable":true,"type":"string"},"dst":{"nullable":true,"type":"boolean"},"elot_sequence":{"nullable":true,"type":"string"},"elot_sort":{"nullable":true,"type":"string"},"latitude":{"nullable":true,"type":"number"},"longitude":{"nullable":true,"type":"number"},"precision":{"nullable":true,"type":"string"},"rdi":{"nullable":true,"type":"string"},"record_type":{"nullable":true,"type":"string"},"time_zone":{"nullable":true,"type":"string"},"utc_offset":{"nullable":true,"type":"integer"},"zip_type":{"nullable":true,"type":"string"}},"type":"object"},"Metric":{"properties":{"context":{"description":"Context for how to interpret the metric, e.g., whether a higher value is 'better' than a lower value","enum":["higher_is_better","lower_is_better",null],"example":"higher_is_better","nullable":true,"type":"string"},"currency":{"description":"The ISO currency code for metric, where applicable","nullable":true,"type":"string"},"date_range":{"description":"Metric date range","enum":["latest","last_30_days","last_90_days","last_120_days","last_180_days","last_365_days","next_30_days","next_60_days","next_90_days","next_180_days","last_1_calendar_months","last_3_calendar_months","last_4_calendar_months","last_6_calendar_months","last_12_calendar_months","last_15_calendar_months","last_24_calendar_months","last_1_full_calendar_months","last_2_full_calendar_months","last_3_full_calendar_months","last_6_full_calendar_months","last_12_full_calendar_months","last_60_days","last_45_days","last_2_calendar_months"],"example":"last_180_days","type":"string"},"description":{"description":"Description of metric","example":"The number of unique transactions with a timestamp","nullable":true,"type":"string"},"group":{"description":"The type of metric","enum":["data_quality","processing_quality","balance","profit_and_loss","debt","risk_flag","forecast","heron","ml_feature"],"example":"data_quality","type":"string"},"label":{"description":"Metric label, slugified","example":"unique_transactions","type":"string"},"status":{"description":"either 'calculated' or 'not_available' depending on the requested date range vs. date range of the data","enum":["available","partially_available","not_available",null],"example":"not_available","nullable":true,"type":"string"},"unit":{"description":"The unit of measurement for metric","enum":["n","day","ratio","amount","weekday","array","probability"],"example":"n","type":"string"},"value":{"description":"The metric value","example":42.42,"nullable":true}},"type":"object"},"MetricBenchmarksSchema":{"properties":{"date_range":{"enum":["latest","last_30_days","last_90_days","last_120_days","last_180_days","last_365_days","next_30_days","next_60_days","next_90_days","next_180_days","last_1_calendar_months","last_3_calendar_months","last_4_calendar_months","last_6_calendar_months","last_12_calendar_months","last_15_calendar_months","last_24_calendar_months","last_1_full_calendar_months","last_2_full_calendar_months","last_3_full_calendar_months","last_6_full_calendar_months","last_12_full_calendar_months","last_60_days","last_45_days","last_2_calendar_months"],"example":"last_180_days","type":"string"},"label":{"description":"Metric label, slugified","example":"unique_transactions","type":"string"},"percentile":{"description":"The implied percentile based on ranking and sample size","example":0.75,"nullable":true,"type":"number"},"rank":{"description":"Ranking of metric relative to datapoints. 1 is best","example":22,"nullable":true,"type":"integer"},"sample_size":{"description":"The number of datapoints to compare to","example":42,"type":"integer"},"scope":{"default":"user","description":"What end users are included in metric comparisons","enum":["user","heron"],"example":"user","type":"string"}},"type":"object"},"MetricDefinitionSchema":{"properties":{"date_range":{"description":"The date range this metric covers","example":"last_180_days","type":"string"},"description":{"description":"Human-readable description of the metric","example":"Total number of unique transactions","type":"string"},"group":{"description":"The group/category this metric belongs to","example":"transaction_metrics","type":"string"},"label":{"description":"The label/name of the metric","example":"unique_transactions","type":"string"},"unit":{"description":"The unit of measurement for this metric","example":"count","type":"string"}},"type":"object"},"MetricFormula":{"properties":{"add":{"$ref":"#/components/schemas/MetricFormulaAdd"},"aggregation":{"$ref":"#/components/schemas/MetricFormulaAggregation"},"div":{"$ref":"#/components/schemas/MetricFormulaDiv"},"metric":{"$ref":"#/components/schemas/MetricFormulaMetric"},"mult":{"$ref":"#/components/schemas/MetricFormulaMult"},"scalar":{"$ref":"#/components/schemas/MetricFormulaScalar"},"simple_metric":{"$ref":"#/components/schemas/MetricFormulaSimpleMetric"},"sub":{"$ref":"#/components/schemas/MetricFormulaSub"},"type":{"description":"The type of formula to be used","type":"string"}},"required":["type"],"type":"object"},"MetricFormulaAdd":{"properties":{"addend_1":{"$ref":"#/components/schemas/MetricFormula"},"addend_2":{"$ref":"#/components/schemas/MetricFormula"}},"required":["addend_1","addend_2"],"type":"object"},"MetricFormulaAggregation":{"properties":{"by":{"default":[],"description":"The dimension to be used in the aggregation","items":{"type":"string"},"type":"array"},"formula":{"$ref":"#/components/schemas/MetricFormula"},"op":{"description":"The aggregation operation to be used","type":"string"}},"required":["formula","op"],"type":"object"},"MetricFormulaDiv":{"properties":{"dividend":{"$ref":"#/components/schemas/MetricFormula"},"divisor":{"$ref":"#/components/schemas/MetricFormula"}},"required":["dividend","divisor"],"type":"object"},"MetricFormulaMetric":{"properties":{"date_range":{"description":"The date range to be used in the query. It will override the date range specified in the metric spec","nullable":true,"type":"string"},"filters":{"description":"A list of filters to be applied before computing the metric","items":{"$ref":"#/components/schemas/MetricFormulaSimpleMetricFilter"},"nullable":true,"type":"array"},"metric_name":{"description":"The metric to be used","type":"string"}},"required":["metric_name"],"type":"object"},"MetricFormulaMult":{"properties":{"multiplicand":{"$ref":"#/components/schemas/MetricFormula"},"multiplier":{"$ref":"#/components/schemas/MetricFormula"}},"required":["multiplicand","multiplier"],"type":"object"},"MetricFormulaScalar":{"properties":{"value":{"description":"The value to be used in the formula","type":"integer"}},"required":["value"],"type":"object"},"MetricFormulaSimpleMetric":{"properties":{"date_range":{"description":"The date range to be used in the query. It will override the date range specified in the metric spec","nullable":true,"type":"string"},"filter":{"allOf":[{"$ref":"#/components/schemas/MetricFormulaSimpleMetricFilter"}],"description":"A filter to be applied before computing the metric","nullable":true},"filters":{"description":"A list of filters to be applied before computing the metric","items":{"$ref":"#/components/schemas/MetricFormulaSimpleMetricFilter"},"nullable":true,"type":"array"},"metric_name":{"description":"The metric to be used","type":"string"},"value_if_unavailable":{"description":"The value to be used if the metric is not available","nullable":true}},"required":["metric_name"],"type":"object"},"MetricFormulaSimpleMetricFilter":{"properties":{"dimension":{"description":"The dimension to be used","type":"string"},"operator":{"description":"The operator to be used in the filter","type":"string"},"value":{"description":"The dimension value to be used","type":"string"}},"required":["dimension","value"],"type":"object"},"MetricFormulaSub":{"properties":{"minuend":{"$ref":"#/components/schemas/MetricFormula"},"subtrahend":{"$ref":"#/components/schemas/MetricFormula"}},"required":["minuend","subtrahend"],"type":"object"},"MetricSpec":{"properties":{"context":{"description":"The context to be used in the query","type":"string"},"date_ranges":{"description":"A list of date ranges to be used in the query","items":{"type":"string"},"type":"array"},"description":{"type":"string"},"expression":{"description":"The expression to be used in the query","type":"string"},"formula":{"$ref":"#/components/schemas/MetricFormula"},"group":{"description":"The group to be used in the query","type":"string"},"unit":{"description":"The unit to be used in the query","type":"string"}},"required":["context","date_ranges","description","group","unit"],"type":"object"},"MissingAccountSchema":{"properties":{"account_name":{"description":"An account name extracted from the transaction description","example":"Checking","type":"string"},"account_number":{"description":"An account number extracted from the transaction description","example":"****4321","type":"string"},"transactions":{"items":{"$ref":"#/components/schemas/Transaction3"},"type":"array"}},"type":"object"},"MissingReason":{"properties":{"code":{"description":"Why the value is missing, e.g. `not_covered`","enum":["no_data","not_covered","period_not_over","no_revenue","no_search","not_matched","none_in_period","no_identity_to_scan","no_owner_information","broker_account","no_industry_category"],"readOnly":true},"period":{"allOf":[{"$ref":"#/components/schemas/AttributePeriod"}],"description":"The span that failed, e.g. the one uncovered month of three. Null when no span applies","nullable":true,"readOnly":true}},"type":"object"},"ModifiableSettings":{"properties":{"balance_sheet_categories":{"$ref":"#/components/schemas/BalanceSheetCategories"},"bank_statement_summary_columns":{"items":{"type":"string"},"nullable":true,"type":"array"},"disable_data_export":{"type":"boolean"},"financials_metrics":{"additionalProperties":{"$ref":"#/components/schemas/MetricSpec"},"type":"object"},"funder_submission_email_fields":{"$ref":"#/components/schemas/FunderSubmissionEmailFieldSettings"},"industry_naics_enabled":{"type":"boolean"},"low_balance_days_threshold":{"type":"number"},"pnl_categories":{"$ref":"#/components/schemas/PnLCategories"},"query_reports":{"items":{"$ref":"#/components/schemas/QueryReportTabGroup"},"type":"array"},"required_revenue_per_month":{"type":"integer"},"restricted_industries":{"items":{"$ref":"#/components/schemas/RestrictedIndustry"},"type":"array"},"transactions_review_enabled":{"type":"boolean"},"use_new_company_layout":{"type":"boolean"},"use_new_end_user_summary_table":{"type":"boolean"},"use_new_end_user_table":{"type":"boolean"}},"type":"object"},"Money":{"properties":{"amount":{"description":"The amount of money","example":"1234.56","format":"decimal","type":"string"},"currency":{"description":"The currency of the money","example":"USD","type":"string"}},"type":"object"},"MoneyMarketStatementResultSchema":{"properties":{"account_holder_address_city":{"nullable":true,"type":"string"},"account_holder_address_line_1":{"nullable":true,"type":"string"},"account_holder_address_state":{"enum":["AK","AL","AR","AZ","CA","CO","CT","DC","DE","FL","GA","HI","IA","ID","IL","IN","KS","KY","LA","MA","MD","ME","MI","MN","MO","MS","MT","NC","ND","NE","NH","NJ","NM","NV","NY","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VA","VT","WA","WI","WV","WY","PR",null],"nullable":true,"type":"string"},"account_holder_address_zip":{"nullable":true,"type":"string"},"account_holder_name":{"nullable":true,"type":"string"},"account_number":{"nullable":true,"type":"string"},"bank_name":{"nullable":true,"type":"string"},"end_balance":{"format":"decimal","nullable":true,"type":"string"},"end_date":{"nullable":true,"type":"string"},"start_balance":{"format":"decimal","nullable":true,"type":"string"},"start_date":{"nullable":true,"type":"string"}},"type":"object"},"MoneyThumbAccount":{"properties":{"Account Name":{"description":"Institution name","example":"Chase","type":"string"},"Account Number":{"description":"Last 4 digits of account number","example":"1234","type":"string"},"Statements":{"items":{"$ref":"#/components/schemas/MoneyThumbStatementSchema"},"type":"array"}},"type":"object"},"MoneyThumbOutputSchema":{"properties":{"error":{"type":"string"},"results":{"items":{"$ref":"#/components/schemas/MoneyThumbStatement"},"type":"array"}},"type":"object"},"MoneyThumbStatement":{"properties":{"accountNumber":{"nullable":true,"type":"string"},"accountSequence":{"nullable":true,"type":"integer"},"accounttitle":{"nullable":true,"type":"string"},"bankName":{"nullable":true,"type":"string"},"company":{"nullable":true,"type":"string"},"currencycode":{"nullable":true,"type":"string"},"endBalance":{"nullable":true,"type":"number"},"endBalanceCalc":{"nullable":true,"type":"number"},"endDate":{"nullable":true,"type":"string"},"fraudscore":{"nullable":true,"type":"integer"},"isBusiness":{"nullable":true,"type":"boolean"},"isStrongAccountNo":{"nullable":true,"type":"boolean"},"likelyMissingTransactions":{"default":false,"type":"boolean"},"maxResolution":{"nullable":true,"type":"integer"},"minResolution":{"nullable":true,"type":"integer"},"nonTransactions":{"items":{},"nullable":true,"type":"array"},"numCredits":{"type":"integer"},"numDebits":{"type":"integer"},"numTransactions":{"type":"integer"},"ocr":{"nullable":true,"type":"boolean"},"reconciled":{"type":"boolean"},"startBalance":{"nullable":true,"type":"number"},"startDate":{"nullable":true,"type":"string"},"totCredits":{"nullable":true,"type":"number"},"totDebits":{"nullable":true,"type":"number"},"tpreasons":{"items":{},"nullable":true,"type":"array"},"transactions":{"items":{},"nullable":true,"type":"array"},"webReport":{"nullable":true,"type":"boolean"}},"type":"object"},"MoneyThumbStatementSchema":{"properties":{"Transactions":{"items":{"$ref":"#/components/schemas/MoneyThumbTransaction"},"type":"array"},"enddate":{"description":"Statement end date (YYYY-MM-DD), from data source account","example":"2024-03-31","nullable":true,"type":"string"},"startdate":{"description":"Statement start date (YYYY-MM-DD), from data source account","example":"2024-03-01","nullable":true,"type":"string"},"statementid":{"description":"Data source account heron_id","nullable":true,"type":"string"}},"type":"object"},"MoneyThumbStatementSummary":{"properties":{"account_number":{"nullable":true,"type":"string"},"account_title":{"nullable":true,"type":"string"},"bank_name":{"nullable":true,"type":"string"},"company":{"nullable":true,"type":"string"},"currency":{"nullable":true,"type":"string"},"end_balance":{"type":"number"},"fraud_reasons":{"items":{"type":"string"},"nullable":true,"type":"array"},"fraud_score":{"nullable":true,"type":"integer"},"is_business_account":{"nullable":true,"type":"boolean"},"is_ocr":{"nullable":true,"type":"boolean"},"max_resolution":{"nullable":true,"type":"integer"},"min_resolution":{"nullable":true,"type":"integer"},"num_credits":{"type":"integer"},"num_debits":{"type":"integer"},"num_transactions":{"type":"integer"},"reconciled":{"description":"Legacy result for whether this statement's transactions add up to its balances. Prefer a non-null `reconciliation_status`; use this value when that status is null.","type":"boolean"},"start_balance":{"type":"number"},"statement_end_date":{"format":"date-time","type":"string"},"statement_start_date":{"format":"date-time","type":"string"},"total_credits":{"nullable":true,"type":"number"},"total_debits":{"nullable":true,"type":"number"},"unreconciled_end_balance":{"nullable":true,"type":"number"},"web_report":{"nullable":true,"type":"boolean"}},"required":["end_balance","num_credits","num_debits","num_transactions","reconciled","start_balance","total_credits","total_debits"],"type":"object"},"MoneyThumbTransaction":{"properties":{"amount":{"description":"Transaction amount","example":1000.0,"type":"number"},"checknumber":{"description":"Extracted check number, 0 if not a check","type":"integer"},"date":{"description":"Transaction date","example":"2024-03-15","type":"string"},"description":{"description":"Transaction description","example":"DEPOSIT ACH","type":"string"},"memo":{"description":"Transaction memo","type":"string"},"possible":{"description":"Moneythumb internal value - defaults to empty string","type":"boolean"},"tags":{"items":{"$ref":"#/components/schemas/MoneyThumbTransactionTag"},"type":"array"},"trueval":{"description":"Whether the transaction is true revenue","type":"boolean"},"type":{"description":"Moneythumb field - defaults to empty string","type":"string"}},"type":"object"},"MoneyThumbTransactionBounds":{"properties":{"page":{"nullable":true,"type":"integer"},"x_max":{"nullable":true,"type":"integer"},"x_min":{"nullable":true,"type":"integer"},"y_max":{"nullable":true,"type":"integer"},"y_min":{"nullable":true,"type":"integer"}},"required":["page","x_max","x_min","y_max","y_min"],"type":"object"},"MoneyThumbTransactionTag":{"properties":{"metadata":{"additionalProperties":{},"description":"Additional metadata","type":"object"},"tagName":{"description":"Heron category label for the transaction","example":"Revenue","nullable":true,"type":"string"}},"type":"object"},"MoneyThumbTransactionsResponseSchema":{"properties":{"Accounts":{"description":"List of accounts with their statements and transactions","items":{"$ref":"#/components/schemas/MoneyThumbAccount"},"type":"array"}},"type":"object"},"NamedDateSchema":{"properties":{"date":{"description":"The date of the NamedDate","example":"2026-02-26","format":"date","nullable":true,"type":"string"},"name":{"description":"The name of the NamedDate","enum":["end_user_created","end_user_last_updated","last_transaction","end_user_last_enriched","last_data_source_end_date_or_transaction_timestamp","custom_date"],"example":"last_transaction","type":"string"}},"type":"object"},"NationalId":{"properties":{"country":{"description":"Issuing country.","type":"string"},"expires_on":{"description":"Expiry date.","format":"date","nullable":true,"type":"string"},"state":{"description":"Issuing state, for a driving licence.","nullable":true,"type":"string"},"type":{"description":"Type of personal identifier. The prefix is the issuing country: `us_ssn` (US Social Security Number), `ca_sin` (Canadian Social Insurance Number), `uk_nino` (UK National Insurance number), `driving_licence` or `passport`.","enum":["us_ssn","ca_sin","uk_nino","driving_licence","passport"]},"value":{"description":"The identifier.","type":"string"}},"type":"object"},"NationalIdWrite":{"additionalProperties":false,"properties":{"country":{"description":"Issuing country.","type":"string"},"expires_on":{"description":"Expiry date.","format":"date","nullable":true,"type":"string"},"state":{"description":"Issuing state, for a driving licence.","nullable":true,"type":"string"},"type":{"description":"Type of personal identifier. The prefix is the issuing country: `us_ssn` (US Social Security Number), `ca_sin` (Canadian Social Insurance Number), `uk_nino` (UK National Insurance number), `driving_licence` or `passport`.","enum":["us_ssn","ca_sin","uk_nino","driving_licence","passport"]},"value":{"description":"The identifier.","type":"string"}},"type":"object"},"NestedEndUserEntityAttribute":{"properties":{"attribute_description":{"type":"string"},"attribute_name":{"type":"string"},"attribute_sources":{"items":{"$ref":"#/components/schemas/EndUserEntityAttributeSource"},"type":"array"},"attribute_type":{"enum":["float","int","decimal","string","date","datetime","bool"]},"display_order":{"nullable":true,"type":"integer"},"heron_id":{"type":"string"},"is_dedupe_key":{"default":false,"type":"boolean"},"reconciliation_config":{"additionalProperties":{},"type":"object"},"reconciliation_strategy":{"enum":["sort_order","llm","comparison","concatenate_lists"]}},"type":"object"},"NestedEndUserEntityAttributeSchema":{"properties":{"attribute_description":{"type":"string"},"attribute_name":{"type":"string"},"attribute_sources":{"items":{"$ref":"#/components/schemas/EndUserEntityAttributeSource"},"type":"array"},"attribute_type":{"enum":["float","int","decimal","string","date","datetime","bool"]},"display_order":{"nullable":true,"type":"integer"},"heron_id":{"type":"string"},"is_dedupe_key":{"default":false,"type":"boolean"},"reconciliation_config":{"additionalProperties":{},"type":"object"},"reconciliation_strategy":{"enum":["sort_order","llm","comparison","concatenate_lists"]}},"type":"object"},"NestedEndUserEntitySchema":{"properties":{"display_order":{"type":"integer"},"entity_attributes":{"items":{"$ref":"#/components/schemas/NestedEndUserEntityAttribute"},"type":"array"},"entity_description":{"type":"string"},"entity_name":{"type":"string"},"entity_post_processor_configs":{"default":[],"items":{"additionalProperties":{},"type":"object"},"nullable":true,"type":"array"},"heron_id":{"type":"string"},"is_custom":{"description":"True when no entity template the customer set up in full creates this entity.","readOnly":true,"type":"boolean"},"is_list":{"type":"boolean"},"saved_query_heron_id":{"nullable":true,"type":"string"}},"type":"object"},"NumericCheck":{"properties":{"auto_decline":{"default":false,"type":"boolean"},"decline_code":{"description":"The CRM's identifier for this decline reason, e.g. a LendSaas reason id. Left unset, the CRM sync falls back to this check's decline_description.","nullable":true,"type":"string"},"decline_description":{"nullable":true,"type":"string"},"email_template_name":{"nullable":true,"type":"string"},"ignore_metric_availability":{"default":false,"type":"boolean"},"is_mandatory":{"default":false,"type":"boolean"},"on_failure":{"default":"fail","enum":["fail","review_required"]},"on_missing":{"default":"missing_data","description":"What the check reports when it would report missing data: `missing_data` (the default), `fail` or `pass`. A check saved with an older flag (`pass_if_value_missing` on a date-delta check) reads as the setting it stands for. With `ignore_metric_availability` or `pass_if_value_missing` set, only that setting is accepted","enum":["missing_data","fail","pass"]},"pass_description":{"nullable":true,"type":"string"},"transaction_scope":{"allOf":[{"$ref":"#/components/schemas/TransactionScope"}],"nullable":true},"type":{"enum":["equal","not_equal","greater_than","greater_than_or_equal","less_than","less_than_or_equal"]},"value":{"description":"The threshold: a number as a string, {\"variable\": {...}} to compare with another variable (with an optional \"factor\" that scales it), or {\"lookup\": {\"table_heron_id\", \"column_id\"}} to read it from a lookup table column","oneOf":[{"type":"string"},{"$ref":"#/components/schemas/VariableThreshold"}]}},"type":"object"},"OcrolusBankAccount":{"properties":{"account_category":{"type":"string"},"account_number":{"type":"string"},"alternative_lender_transactions":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"daily_balances":{"additionalProperties":{"type":"string"},"type":"object"},"debt_consolidator_txns":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"deposits_max_by_month":{"additionalProperties":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"nullable":true,"type":"array"},"type":"object"},"estimated_expense_txns_list":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"estimated_revenue_txns_list":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"factor_txns":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"holder_country":{"type":"string"},"insurance_credits":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"insurance_debits":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"interbank_transactions":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"merchant_cash_advance_lender_txns":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"non_estimated_revenue_txns_list":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"nsf_transactions":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"nsf_transactions_paid_or_negative_balance":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"nsf_transactions_returned_or_not_paid":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"outside_source_deposits":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"payroll":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"period_balance_mismatches":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"ppp_loan_txns":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"probable_recurring_txns":{"items":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"type":"array"},"returned_items":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"round_number_txns":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"txn_count":{"type":"integer"},"withdrawals":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"type":"array"},"withdrawals_max_by_month":{"additionalProperties":{"items":{"$ref":"#/components/schemas/OcrolusTransaction"},"nullable":true,"type":"array"},"type":"object"}},"type":"object"},"OcrolusResponse":{"properties":{"bank_accounts":{"items":{"$ref":"#/components/schemas/OcrolusBankAccount"},"type":"array"},"name":{"type":"string"}},"required":["bank_accounts","name"],"type":"object"},"OcrolusSchema":{"properties":{"response":{"$ref":"#/components/schemas/OcrolusResponse"}},"required":["response"],"type":"object"},"OcrolusTransaction":{"properties":{"amount":{"type":"string"},"description":{"type":"string"},"pk":{"type":"integer"},"timestamp":{"format":"date-time","type":"string"},"txn_date":{"example":"07/08/2025","format":"date","pattern":"^\\d{2}/\\d{2}/\\d{4}$","type":"string"}},"type":"object"},"OfacRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"action_end_date":{"description":"Date the excluded-party action ended.","format":"date","nullable":true,"type":"string"},"action_start_date":{"description":"Date the excluded-party action began.","format":"date","nullable":true,"type":"string"},"action_term":{"description":"Source-provided duration of the excluded-party action.","nullable":true,"type":"string"},"aliases":{"description":"Aliases listed on the sanctions record.","items":{"type":"string"},"type":"array"},"authority":{"description":"Authority that issued the excluded-party action, such as SAM.","nullable":true,"type":"string"},"charge":{"description":"Charge named on the excluded-party record.","nullable":true,"type":"string"},"city":{"description":"City listed on the sanctions record.","nullable":true,"type":"string"},"country":{"description":"Country listed on the sanctions record.","nullable":true,"type":"string"},"document_title":{"description":"Title of the sanctions document.","nullable":true,"type":"string"},"entity_type":{"description":"Entity type on the source record, such as INDIVIDUAL, COMPANY, or ORGANIZATION.","nullable":true,"type":"string"},"finding":{"description":"Finding stated on the excluded-party record.","nullable":true,"type":"string"},"issuer":{"description":"Issuer named on the sanctions record.","nullable":true,"type":"string"},"issuer_category":{"description":"Category of the sanctions issuer.","nullable":true,"type":"string"},"name":{"description":"Name on the sanctions or excluded-party record.","nullable":true,"type":"string"},"position_role":{"description":"Position or role listed on the sanctions record.","nullable":true,"type":"string"},"publication_date":{"description":"Source publication date; null when unavailable.","format":"date","nullable":true,"type":"string"},"publication_name":{"description":"Publication named on the excluded-party record.","nullable":true,"type":"string"},"region":{"description":"Region listed on the sanctions record.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"sanction_full_text":{"description":"Full text of the sanctions record.","nullable":true,"type":"string"},"sanction_type":{"description":"Type of sanction.","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source":{"description":"Source that supplied the record.","nullable":true,"type":"string"}},"type":"object"},"OneSchemaImporterTokenSchema":{"properties":{"client_id":{"description":"OneSchema importer client id, the token's iss","readOnly":true,"type":"string"},"expires_at":{"format":"date-time","readOnly":true,"type":"string"},"token":{"description":"Short-lived JWT to pass to the OneSchema importer as userJwt","readOnly":true,"type":"string"}},"type":"object"},"OtherSsnRecord":{"properties":{"name":{"description":"Name reported with the linked SSN; null when unavailable.","nullable":true,"type":"string"},"source":{"description":"Source that supplied the record; null when unavailable.","nullable":true,"type":"string"},"ssn":{"description":"Social Security number linked to the person, in 123-45-XXXX form. Source values with fewer than five leading digits are padded with X; records without leading digits are omitted. The full SSN never appears.","nullable":true,"type":"string"}},"type":"object"},"OutboundEmailSettings":{"properties":{"allowed_to_domains":{"items":{"type":"string"},"type":"array"},"restrict_outbound_emails_to_allowed_domains":{"type":"boolean"}},"type":"object"},"Owner":{"properties":{"credit_score":{"nullable":true,"type":"integer"},"date_of_birth":{"example":"1990-01-01","format":"date","nullable":true,"type":"string"},"email_address":{"nullable":true,"type":"string"},"first_name":{"nullable":true,"type":"string"},"has_signed":{"nullable":true,"type":"boolean"},"home_address":{"$ref":"#/components/schemas/Address"},"home_phone":{"nullable":true,"type":"string"},"last_name":{"nullable":true,"type":"string"},"middle_name":{"nullable":true,"type":"string"},"mobile_phone":{"nullable":true,"type":"string"},"ownership_percentage":{"description":"Percentage of ownership","example":100,"nullable":true,"type":"number"},"prefix":{"description":"Name prefix","example":"Mr","nullable":true,"type":"string"},"signed_date":{"format":"date","nullable":true,"type":"string"},"social_security_number":{"nullable":true,"type":"string"},"suffix":{"description":"Generational or professional suffix","example":"Jr","nullable":true,"type":"string"}},"type":"object"},"OwnerSocialMedia":{"description":"Social media profiles of the owner.","properties":{"facebook":{"allOf":[{"$ref":"#/components/schemas/ResolvedSocialProfile"}],"description":"The owner's Facebook page.","nullable":true},"instagram":{"allOf":[{"$ref":"#/components/schemas/ResolvedSocialProfile"}],"description":"The owner's Instagram profile.","nullable":true},"linkedin":{"allOf":[{"$ref":"#/components/schemas/ResolvedSocialProfile"}],"description":"The owner's LinkedIn profile.","nullable":true}},"type":"object"},"OwnerVerification":{"properties":{"credit_scores":{"description":"One check per scoring model, in the order `fico`, `vantagescore`, `unknown`, on the latest score of that model. Sources are compared within one model only. Empty when no source stated a score.","items":{"$ref":"#/components/schemas/CreditScoreCheck"},"type":"array"},"date_of_birth":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The owner's date of birth."},"declared":{"description":"False for a person the sources tie to a share of the company the deal never declared them at.","type":"boolean"},"display_name":{"description":"The name a reader shows the subject under.","nullable":true,"type":"string"},"driving_licence":{"allOf":[{"$ref":"#/components/schemas/DrivingLicence"}],"description":"The owner's driving licence as a parsed identity document stated it. Information only: it carries no verification state. Null when no licence names this owner.","nullable":true},"email":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The owner's email address."},"home_address":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"Where the owner lives."},"home_phone":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The owner's home number."},"key":{"description":"The details response key for this subject's row, so a reader can open it.","type":"string"},"linkedin":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The owner's LinkedIn profile."},"mobile_phone":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The owner's mobile number, and any number no source gave a type."},"name":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The owner's name."},"ownership_percentage":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The share of the company the deal stated for them."},"position":{"description":"Their place in the list, which is what `Owner 1` means. Not an identity: owners are ordered by how well attested each is, so a re-run can move someone.","type":"integer"},"relationship":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"Whether a source puts this person at a share of the company."},"ssn":{"allOf":[{"$ref":"#/components/schemas/FieldCheck"}],"description":"The owner's US social security number."},"subject_type":{"enum":["owner","business"]}},"type":"object"},"Pagination":{"properties":{"next_url":{"description":"the URL of the next page","format":"url","nullable":true,"type":"string"},"num_results":{"description":"the number of results on this page","type":"integer"},"page":{"description":"current page","type":"integer"},"pages":{"description":"the number of pages","type":"integer"},"per_page":{"description":"the max number of results per page","type":"integer"},"prev_url":{"description":"the URL of the last page","format":"url","nullable":true,"type":"string"},"total":{"description":"the number of results across all pages","type":"integer"}},"type":"object"},"ParameterLookupUse":{"properties":{"column_id":{"readOnly":true,"type":"string"},"column_name":{"readOnly":true,"type":"string"},"key":{"description":"The deal's key value, e.g. NY. Null when the table's unlisted default applied, or when the deal has no key value","nullable":true,"readOnly":true,"type":"string"},"setting":{"description":"The variable setting read from the table, e.g. month_count","readOnly":true,"type":"string"},"table_heron_id":{"readOnly":true,"type":"string"},"table_name":{"readOnly":true,"type":"string"},"target":{"description":"`attribute` for the check's own variable, `threshold` for the variable it compares against","readOnly":true,"type":"string"},"value":{"description":"The cell the setting took, e.g. \"4\" complete months. Null when the table gave no cell: the deal's key isn't listed and the table fails or reports missing data for unlisted values, or the cell is blank","nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"ParseFileSchema":{"properties":{"parser_id":{"nullable":true,"type":"string"}},"type":"object"},"ParsedEndUserFile":{"properties":{"attribute_values":{"items":{"additionalProperties":{},"type":"object"},"type":"array"},"bounding_boxes":{"items":{"$ref":"#/components/schemas/ParsedEndUserFileBoundingBox"},"nullable":true,"type":"array"},"created":{"format":"date-time","type":"string"},"field_validations":{"items":{"$ref":"#/components/schemas/FieldValidation"},"type":"array"},"heron_id":{"description":"Unique identifier of the end user file","type":"string"},"id":{"description":"[DEPRECATED] Unique identifier for the parsed file","type":"integer"},"layout_bounding_boxes":{"items":{"$ref":"#/components/schemas/ParsedEndUserFileBoundingBox"},"nullable":true,"type":"array"},"parser_display_name":{"nullable":true,"type":"string"},"parser_id":{"type":"string"},"parsing_status":{"enum":["succeeded","failed","processing"],"type":"string"},"patches":{"items":{"$ref":"#/components/schemas/ParsedEndUserFilePatch"},"type":"array"},"result":{"additionalProperties":{},"description":"Final output result after applying patches","nullable":true,"type":"object"},"result_schema":{"additionalProperties":{},"description":"The output JSON schema the results conform to","nullable":true,"type":"object"},"validation_summary":{"description":"Summary of validation results","nullable":true,"type":"string"}},"required":["created","heron_id","parser_id","parsing_status"],"type":"object"},"ParsedEndUserFileBoundingBox":{"properties":{"bounding_box":{"description":"Bounding box coordinates in the format 'y1,x1,y2,x2'","items":{"type":"number"},"type":"array"},"json_pointer":{"description":"JSON pointer to the field in the parsed result","type":"string"},"page_num":{"description":"Page number where the bounding box is located","type":"integer"},"value":{"description":"The actual value of the field within the bounding box","type":"string"}},"required":["bounding_box","json_pointer","page_num","value"],"type":"object"},"ParsedEndUserFilePatch":{"properties":{"correction_reason":{"nullable":true,"type":"string"},"enabled":{"nullable":true,"type":"boolean"},"op":{"type":"string"},"original_value":{"nullable":true},"path":{"type":"string"},"source":{"nullable":true,"type":"string"},"value":{"nullable":true}},"required":["op","path"],"type":"object"},"ParsedEndUserFileSchema":{"properties":{"attribute_values":{"items":{"additionalProperties":{},"type":"object"},"type":"array"},"bounding_boxes":{"items":{"$ref":"#/components/schemas/ParsedEndUserFileBoundingBox"},"nullable":true,"type":"array"},"created":{"format":"date-time","type":"string"},"field_validations":{"items":{"$ref":"#/components/schemas/FieldValidation"},"type":"array"},"heron_id":{"description":"Unique identifier of the end user file","type":"string"},"id":{"description":"[DEPRECATED] Unique identifier for the parsed file","type":"integer"},"layout_bounding_boxes":{"items":{"$ref":"#/components/schemas/ParsedEndUserFileBoundingBox"},"nullable":true,"type":"array"},"parser_display_name":{"nullable":true,"type":"string"},"parser_id":{"type":"string"},"parsing_status":{"enum":["succeeded","failed","processing"],"type":"string"},"patches":{"items":{"$ref":"#/components/schemas/ParsedEndUserFilePatch"},"type":"array"},"result":{"additionalProperties":{},"description":"Final output result after applying patches","nullable":true,"type":"object"},"result_schema":{"additionalProperties":{},"description":"The output JSON schema the results conform to","nullable":true,"type":"object"},"validation_summary":{"description":"Summary of validation results","nullable":true,"type":"string"}},"required":["created","heron_id","parser_id","parsing_status"],"type":"object"},"ParsedEndUserFilesFilterSchema":{"properties":{"parser_id":{"nullable":true,"type":"string"},"version_number":{"nullable":true,"type":"integer"}},"type":"object"},"ParsedEndUserSubmissionSchema":{"properties":{"end_user_heron_id":{"type":"string"},"result":{"additionalProperties":{},"type":"object"},"status":{"enum":["success","failed"],"type":"string"},"submission_parser":{"$ref":"#/components/schemas/SubmissionParserExternal"}},"type":"object"},"PartialDate":{"properties":{"day":{"description":"Day (1-31).","nullable":true,"type":"integer"},"month":{"description":"Month (1-12).","nullable":true,"type":"integer"},"year":{"description":"Year.","nullable":true,"type":"integer"}},"type":"object"},"PartialDateWrite":{"additionalProperties":false,"properties":{"day":{"description":"Day (1-31).","nullable":true,"type":"integer"},"month":{"description":"Month (1-12).","nullable":true,"type":"integer"},"year":{"description":"Year.","nullable":true,"type":"integer"}},"type":"object"},"PaymentProcessor":{"properties":{"heron_id":{"example":"mrc_nRYdGU7nYuevb7qem65cEb","readOnly":true,"type":"string"},"icon_url":{"example":"https://storage.googleapis.com/heron-merchant-assets/icons/mrc_nRYdGU7nYuevb7qem65cEb.svg","format":"url","nullable":true,"readOnly":true,"type":"string"},"logo_url":{"example":"https://storage.googleapis.com/heron-merchant-assets/logos/mrc_nRYdGU7nYuevb7qem65cEb.svg","format":"url","nullable":true,"readOnly":true,"type":"string"},"name":{"example":"Paypal","nullable":true,"readOnly":true,"type":"string"},"url":{"example":"https://www.paypal.com","format":"url","nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"PdfDefaultCurrencyUpdateSchema":{"properties":{"currency":{"description":"ISO 4217 currency code to update for PDF and all statements","enum":["USD","GBP","EUR","SEK","AED","AUD","SGD","CAD","NOK","IDR","CHF","DKK","MXN","PLN","MYR","VND","RON","TRY","CZK","BGN","HKD","PHP","HUF","NZD","BRL","ILS","COP","RUB","INR","ZAR","THB","JPY","CLP","MAD","RSD","SLE"],"example":"EUR","type":"string"}},"required":["currency"],"type":"object"},"PdfGet":{"properties":{"data_source":{"allOf":[{"$ref":"#/components/schemas/DataSourceNested"}],"description":"The data source for this PDF. Only available after parsing and enrichment has completed, otherwise null.","nullable":true},"heron_id":{"description":"ID generated by Heron Data","example":"pdf_ipa38qiztYHMFuSDDqN6m5","type":"string"},"status":{"description":"Status of PDF","enum":["new","parsing","parsed","processed","human_reviewing","approved","rejected","failed","transactions_loaded","transactions_unloaded"],"example":"processed","type":"string"}},"type":"object"},"PdfGetSchema":{"properties":{"account_id":{"description":"Unique ID for account associated with PDF","example":"checking_account_202348","nullable":true,"type":"string"},"created":{"description":"Timestamp when PDF was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"currency":{"description":"ISO 4217 currency code for transactions in account, one of the supported currencies","enum":["USD","GBP","EUR","SEK","AED","AUD","SGD","CAD","NOK","IDR","CHF","DKK","MXN","PLN","MYR","VND","RON","TRY","CZK","BGN","HKD","PHP","HUF","NZD","BRL","ILS","COP","RUB","INR","ZAR","THB","JPY","CLP","MAD","RSD","SLE"],"example":"USD","type":"string"},"data_source":{"allOf":[{"$ref":"#/components/schemas/DataSourceNested"}],"description":"The data source for this PDF. Only available after parsing and enrichment has completed, otherwise null.","nullable":true},"end_user":{"$ref":"#/components/schemas/EndUser2"},"filename":{"description":"The filename of the PDF","example":"my-favourite.pdf","nullable":true,"type":"string"},"has_unexplained_edits":{"description":"Whether the PDF's edits are worth investigating. Absent when the file has not been checked.","type":"boolean"},"heron_id":{"description":"ID generated by Heron Data","example":"pdf_ipa38qiztYHMFuSDDqN6m5","type":"string"},"is_image_based":{"description":"True if the PDF was processed using image-based OCR. None if not yet processed","nullable":true,"type":"boolean"},"last_updated":{"description":"Timestamp when PDF was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"type":"string"},"notes":{"description":"Customer-facing PDF status message. Null for a newly uploaded PDF.","example":"Statement processed successfully. All balances verified.","nullable":true,"readOnly":true,"type":"string"},"parsing_version":{"description":"Indicates which provider was used to parse this pdf","type":"string"},"reconciliation_method":{"description":"How the reconciliation verdict was set: `start_and_end_balance`, `running_balance`, `summary_derived`, `total_debits_credits`, or `zero_balances` for ladder checks; `human` for a reviewer. Null means no method decided the verdict, including when nothing could be checked or when the reconciliation status is null.","enum":["start_and_end_balance","summary_derived","running_balance","total_debits_credits","zero_balances","human",null],"nullable":true},"reconciliation_status":{"description":"Stored reconciliation verdict. `reconciled` means a ladder check passed or a reviewer confirmed the document. `not_possible` means nothing available could verify it. `failed` means a ladder check failed or a reviewer ruled it unreconciled. Null means neither the ladder nor a reviewer set a verdict.","enum":["failed","not_possible","reconciled",null],"nullable":true,"type":"string"},"reference_id":{"description":"An optional field for your unique identifier for the PDF","example":"my-favourite-pdf","nullable":true,"type":"string"},"statements":{"items":{"$ref":"#/components/schemas/PdfStatement"},"type":"array"},"status":{"description":"Status of PDF","enum":["new","parsing","parsed","processed","human_reviewing","approved","rejected","failed","transactions_loaded","transactions_unloaded"],"example":"processed","type":"string"}},"type":"object"},"PdfPatchStatementSummary":{"properties":{"account_number":{"type":"string"},"bank_name":{"type":"string"},"company":{"type":"string"},"currency":{"description":"ISO 4217 code, case-insensitive, surrounding whitespace ignored. One of: USD, GBP, EUR, SEK, AED, AUD, SGD, CAD, NOK, IDR, CHF, DKK, MXN, PLN, MYR, VND, RON, TRY, CZK, BGN, HKD, PHP, HUF, NZD, BRL, ILS, COP, RUB, INR, ZAR, THB, JPY, CLP, MAD, RSD, SLE","pattern":"^\\s*[A-Za-z]{3}\\s*$","type":"string"},"end_balance":{"type":"number"},"fraud_reasons":{"items":{"type":"string"},"type":"array"},"fraud_score":{"type":"integer"},"start_balance":{"type":"number"},"statement_end_date":{"format":"date-time","type":"string"},"statement_start_date":{"format":"date-time","type":"string"}},"type":"object"},"PdfPatchTransaction":{"properties":{"amount":{"nullable":true,"type":"number"},"balance":{"nullable":true,"type":"number"},"bounds":{"allOf":[{"$ref":"#/components/schemas/MoneyThumbTransactionBounds"}],"nullable":true},"currency":{"nullable":true,"type":"string"},"description":{"nullable":true,"type":"string"},"ocr_suspect":{"nullable":true,"type":"boolean"},"reference_id":{"nullable":true,"type":"string"},"timestamp":{"format":"date-time","nullable":true,"type":"string"},"transaction_code":{"nullable":true,"type":"string"}},"type":"object"},"PdfPostSchema":{"properties":{"account_id":{"description":"Unique ID for account associated with PDF","example":"checking_account_202348","nullable":true,"type":"string"},"currency":{"description":"ISO 4217 currency code for transactions in account. We currently only support GBP and USD PDFs","enum":["USD","GBP",null],"example":"USD","nullable":true,"type":"string"},"filename":{"description":"The filename of the PDF","example":"my-favourite.pdf","nullable":true,"type":"string"},"is_split":{"description":"Whether the file has been manually split","example":false,"nullable":true,"type":"boolean"},"parent_file_heron_id":{"description":"The Heron ID of the parent file, if this PDF is a split from another file","nullable":true,"type":"string"},"pdf_base64":{"description":"The base64 encoded string of the PDF file. If using Javascript, this is directly the output of the FileReader.readAsDataURL() output.","pattern":"^data\\:\\w+\\/\\w+\\;base64\\,","type":"string"},"read_us_dates":{"description":"True if date formats in the statement are US: month/date/year","nullable":true,"type":"boolean"},"reference_id":{"description":"An optional field for your unique identifier for the PDF","example":"my-favourite-pdf","maxLength":140,"nullable":true,"type":"string"}},"required":["pdf_base64"],"type":"object"},"PdfPutSchema":{"properties":{"filename":{"description":"The filename of the PDF","example":"my-favourite.pdf","type":"string"},"fraud_reason":{"description":"If fraud reason ","nullable":true,"type":"string"},"is_fraud":{"description":"True if fraud was detected in the PDF","type":"boolean"},"notes":{"description":"Notes associated with PDF, e.g., rejected reason, failed reason","type":"string"},"reconciliation_status":{"description":"The reconciliation status a reviewer sets for the document.\n\n- `reconciled` \u2014 the reviewer confirmed the document reconciles.\n- `unreconciled` \u2014 load the transactions but keep the document out of the reconciled scope, so default summaries and policy floors skip it.\n- `not_possible` \u2014 there was nothing to reconcile against.\n\nSend it with `status=approved`, or on its own to restamp a document whose transactions already loaded. Any other status, or no status on a document still in review, is a 400. `unreconciled` and `not_possible` also need unreconciled transaction loading enabled. Omit or null the field to leave the automatic status standing.\n\nWhat you send is what a reviewer can decide, not always what gets stored: `unreconciled` is stored as `failed`, the same value an automatic check writes when it does not match. Read `reconciliation_method` to tell them apart \u2014 `human` marks a reviewer's ruling. `GET /integrations/pdfs/<id>`, `GET /end_users/<id>/pdfs`, `GET /end_users/<id>/data_sources/summary`, and End User SQL (EUSQL) `transactions_all` expose both fields. `GET /end_users/<id>/data_source_account_summary` and the `data_source_account_summary.created` webhook expose the status without the method.\n\nRestamping a loaded document changes nothing else: its `status` stays put and no event fires. Scoped summaries follow on the next read, policy data on the next evaluation.\n\n`reconciled` overrides the stored status but not the `pdf.processed` event, so for a document whose automatic check failed that event keeps reporting `is_reconciled: false`.","enum":["reconciled","unreconciled","not_possible",null],"example":"unreconciled","nullable":true,"type":"string"},"reference_id":{"description":"An optional field for your unique identifier for the PDF","example":"my-favourite-pdf","maxLength":140,"type":"string"},"status":{"description":"Status of PDF","enum":["new","parsing","parsed","processed","human_reviewing","approved","rejected","failed","transactions_loaded","transactions_unloaded"],"example":"processed","type":"string"}},"type":"object"},"PdfSettings":{"properties":{"alteration_amber_score":{"type":"integer"},"alteration_red_score":{"type":"integer"},"alteration_summary_llm":{"type":"boolean"},"auto_approve_passing_pdfs":{"type":"boolean"},"auto_fail":{"type":"boolean"},"created_disabled_dsa_for_excluded_statements":{"type":"boolean"},"enabled":{"type":"boolean"},"heron_before_moneythumb":{"type":"boolean"},"identity_account_suffix":{"type":"boolean"},"include_failed_statuses_in_finished_pdfs":{"type":"boolean"},"include_items_returned_unpaid":{"type":"boolean"},"load_unreconciled_transactions":{"oneOf":[{"type":"boolean"},{"items":{"$ref":"#/components/schemas/LoadUnreconciledTransactionsRule"},"minItems":1,"type":"array"}]},"max_fraud_score":{"type":"integer"},"max_pdfs_to_parse":{"nullable":true,"type":"integer"},"parsing_version":{"enum":["0.0.0","1.0.0","2.0.0","3.0.0","4.0.0","4.1.0","5.0.0","6.0.0","7.0.0","7.1.0","8.0.0"],"type":"string"},"reject_duplicated_based_on_text":{"type":"boolean"},"reject_duplicates":{"type":"boolean"},"revision_checks":{"type":"boolean"},"show_alteration_result":{"type":"boolean"},"show_anomaly_score_result":{"type":"boolean"},"use_cache":{"type":"boolean"},"wells_fargo_iru_same_day_pairing":{"type":"boolean"}},"type":"object"},"PdfStatement":{"properties":{"data_source_account":{"allOf":[{"$ref":"#/components/schemas/DataSourceAccountNested"}],"description":"The data source account for this statement. Only available after parsing and enrichment has completed, otherwise null.","nullable":true},"exclude":{"description":"True if the statement should be excluded from processing","nullable":true,"type":"boolean"},"invalid_transaction_partials":{"items":{"$ref":"#/components/schemas/PdfPatchTransaction"},"type":"array"},"reconciliation_method":{"description":"The ladder check that set this statement's verdict: `start_and_end_balance`, `running_balance`, `summary_derived`, `total_debits_credits`, or `zero_balances`. A reviewer can restamp the PDF without changing this value; `human` applies only at PDF level. Use the PDF-level `reconciliation_method` for the document verdict. Null means no ladder check decided the statement verdict.","enum":["start_and_end_balance","summary_derived","running_balance","total_debits_credits","zero_balances","human",null],"nullable":true},"reconciliation_status":{"description":"The reconciliation ladder's verdict for this statement: `reconciled` means a check passed, `not_possible` means no check could decide, and `failed` means a check failed. A reviewer can restamp the PDF without changing this value. Use the PDF-level `reconciliation_status` as the document verdict. Null means the stored parser output has no ladder verdict.","enum":["failed","not_possible","reconciled",null],"nullable":true,"type":"string"},"summary":{"$ref":"#/components/schemas/MoneyThumbStatementSummary"},"transaction_partials":{"items":{"$ref":"#/components/schemas/PdfTransaction"},"type":"array"}},"type":"object"},"PdfStatementPatchSchema":{"properties":{"exclude":{"description":"True if the statement should be excluded from processing","type":"boolean"},"index":{"description":"The index of the statement in the pdf to patch","type":"integer"},"summary":{"$ref":"#/components/schemas/PdfPatchStatementSummary"},"transactions":{"description":"The full list of transactions that will be used to override the extracted transactions for the specified statement","items":{"$ref":"#/components/schemas/PdfPatchTransaction"},"type":"array"}},"required":["index","transactions"],"type":"object"},"PdfTransaction":{"properties":{"amount":{"type":"number"},"balance":{"nullable":true,"type":"number"},"bounds":{"allOf":[{"$ref":"#/components/schemas/MoneyThumbTransactionBounds"}],"nullable":true},"currency":{"nullable":true,"type":"string"},"description":{"type":"string"},"ocr_suspect":{"nullable":true,"type":"boolean"},"reference_id":{"type":"string"},"timestamp":{"format":"date-time","type":"string"},"transaction_code":{"nullable":true,"type":"string"}},"required":["amount","description","timestamp"],"type":"object"},"PendingMatchSchema":{"additionalProperties":false,"properties":{"candidates":{"items":{"$ref":"#/components/schemas/FunderCandidate"},"readOnly":true,"type":"array"},"index":{"readOnly":true,"type":"integer"},"matching_priority":{"nullable":true,"readOnly":true,"type":"integer"},"policy":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"},"resolved_funder_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"spreadsheet_name":{"readOnly":true,"type":"string"},"status":{"readOnly":true,"type":"string"}},"type":"object"},"PeopleAtBusinessAddressRecord":{"properties":{"match_type":{"description":"How the person is linked to the business: same_address or same_phone.","enum":["same_address","same_phone"],"type":"string"},"name":{"description":"Name of the person linked to the business address or phone.","type":"string"},"shared_value":{"description":"Business address or phone linked to the person.","type":"string"},"source":{"description":"Report section containing the link: people_same_address_section or people_same_phone_section.","enum":["people_same_address_section","people_same_phone_section"],"type":"string"}},"required":["match_type","name","shared_value","source"],"type":"object"},"PersonAliasWrite":{"additionalProperties":false,"description":"Another name of the owner.","properties":{"given":{"description":"First name.","nullable":true,"type":"string"},"middle":{"description":"Middle name or initial.","nullable":true,"type":"string"},"prefix":{"description":"Title, for example `Dr`.","nullable":true,"type":"string"},"suffix":{"description":"Suffix, for example `Jr` or `III`.","nullable":true,"type":"string"},"surname":{"description":"Last name.","nullable":true,"type":"string"},"type":{"description":"Type of name, for example `legal` or `aka`.","enum":["legal","aka","maiden","former"]}},"type":"object"},"PersonName":{"properties":{"given":{"description":"First name.","nullable":true,"type":"string"},"middle":{"description":"Middle name or initial.","nullable":true,"type":"string"},"prefix":{"description":"Title, for example `Dr`.","nullable":true,"type":"string"},"raw":{"description":"The full name.","type":"string"},"suffix":{"description":"Suffix, for example `Jr` or `III`.","nullable":true,"type":"string"},"surname":{"description":"Last name.","nullable":true,"type":"string"},"type":{"description":"Type of name, for example `legal` or `aka`.","enum":["legal","aka","maiden","former"]}},"type":"object"},"PersonNameWrite":{"additionalProperties":false,"properties":{"given":{"description":"First name.","nullable":true,"type":"string"},"middle":{"description":"Middle name or initial.","nullable":true,"type":"string"},"prefix":{"description":"Title, for example `Dr`.","nullable":true,"type":"string"},"suffix":{"description":"Suffix, for example `Jr` or `III`.","nullable":true,"type":"string"},"surname":{"description":"Last name.","nullable":true,"type":"string"}},"type":"object"},"PhoneWrite":{"additionalProperties":false,"properties":{"heron_id":{"description":"The `heron_id` of the address or phone from `GET`. Leave it out to add a new one.","nullable":true,"type":"string"},"raw":{"description":"The phone number as provided.","type":"string"}},"type":"object"},"PlaidAccount":{"properties":{"account_id":{"type":"string"},"balances":{"$ref":"#/components/schemas/PlaidAccountSnapshotBalance"},"historical_balances":{"items":{"$ref":"#/components/schemas/PlaidAccountBalance"},"type":"array"},"holder_category":{"nullable":true,"type":"string"},"mask":{"nullable":true,"type":"string"},"name":{"nullable":true,"type":"string"},"official_name":{"nullable":true,"type":"string"},"owners":{"items":{"$ref":"#/components/schemas/PlaidAccountOwners"},"nullable":true,"type":"array"},"subtype":{"nullable":true,"type":"string"},"transactions":{"items":{"$ref":"#/components/schemas/PlaidTransaction"},"type":"array"},"type":{"nullable":true,"type":"string"}},"required":["account_id","balances","historical_balances","transactions"],"type":"object"},"PlaidAccountBalance":{"properties":{"current":{"type":"number"},"date":{"format":"date","type":"string"},"iso_currency_code":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"}},"type":"object"},"PlaidAccountOwners":{"properties":{"names":{"items":{"type":"string"},"type":"array"}},"required":["names"],"type":"object"},"PlaidAccountSnapshot":{"properties":{"account_id":{"type":"string"},"balances":{"allOf":[{"$ref":"#/components/schemas/PlaidAccountSnapshotBalance"}],"description":"Balance information for the account as an object. This is optional, but if not provided, balance calculations will not be performed for individual transactions.","nullable":true},"holder_category":{"nullable":true,"type":"string"},"institution_name":{"nullable":true,"type":"string"},"mask":{"nullable":true,"type":"string"},"name":{"type":"string"},"official_name":{"nullable":true,"type":"string"},"owners":{"items":{"$ref":"#/components/schemas/PlaidAccountOwners"},"nullable":true,"type":"array"},"subtype":{"type":"string"},"type":{"type":"string"}},"type":"object"},"PlaidAccountSnapshotBalance":{"properties":{"available":{"nullable":true,"type":"number"},"current":{"nullable":true,"type":"number"},"iso_currency_code":{"type":"string"},"limit":{"nullable":true,"type":"number"}},"type":"object"},"PlaidAssetReport":{"properties":{"date_generated":{"format":"date-time","type":"string"},"days_requested":{"type":"integer"},"items":{"items":{"$ref":"#/components/schemas/PlaidAssetReportItem"},"type":"array"}},"required":["date_generated","days_requested","items"],"type":"object"},"PlaidAssetReportItem":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/PlaidAccount"},"type":"array"},"institution_name":{"type":"string"}},"required":["accounts","institution_name"],"type":"object"},"PlaidAssetsSchema":{"properties":{"report":{"$ref":"#/components/schemas/PlaidAssetReport"}},"required":["report"],"type":"object"},"PlaidSettings":{"properties":{"account_types_enabled_for_analysis":{"items":{"type":"string"},"type":"array"},"account_types_to_ingest":{"items":{"type":"string"},"type":"array","writeOnly":true},"assets_report_days_to_sync":{"type":"integer"},"auto_enrich_after_sync":{"type":"boolean"},"balance_anchor_field":{"enum":["current","posted"]},"days_to_sync":{"type":"integer"},"owner_types_enabled_for_analysis":{"items":{"enum":["business","personal","unknown"]},"type":"array"},"store_raw_responses":{"type":"boolean"}},"type":"object"},"PlaidTransaction":{"properties":{"account_id":{"type":"string"},"amount":{"type":"number"},"balance":{"type":"number"},"category":{"nullable":true,"type":"string"},"date":{"format":"date","type":"string"},"iso_currency_code":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"merchant_name":{"nullable":true,"type":"string"},"name":{"type":"string"},"pending":{"type":"boolean"},"pending_transaction_id":{"nullable":true,"type":"string"},"timestamp":{"format":"date-time","type":"string"},"transaction_code":{"nullable":true,"type":"string"},"transaction_id":{"type":"string"}},"type":"object"},"PlaidTransactionsSchema":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/PlaidAccountSnapshot"},"type":"array"},"transactions":{"items":{"$ref":"#/components/schemas/PlaidTransaction"},"type":"array"}},"required":["transactions"],"type":"object"},"PnLCategories":{"properties":{"cogs":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"},"income":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"},"operating_expenses":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"},"other_expenses":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"},"other_income":{"additionalProperties":{"description":"A list of example line item labels that map to this category","items":{"type":"string"},"type":"array"},"type":"object"}},"type":"object"},"PnLLineItem":{"properties":{"amount":{"nullable":true,"type":"number"},"category":{"enum":["income","cogs","operating_expenses","other_expenses","other_income",null],"nullable":true,"type":"string"},"id":{"nullable":true,"type":"string"},"label":{"nullable":true,"type":"string"},"row_id":{"nullable":true,"type":"string"},"row_index":{"nullable":true,"type":"integer"},"sub_category":{"nullable":true,"type":"string"}},"type":"object"},"PnLStatementSchema":{"properties":{"basis":{"enum":["accrual","cash","unknown",null],"nullable":true,"type":"string"},"currency":{"nullable":true,"type":"string"},"is_reconciled":{"nullable":true,"type":"boolean"},"reports":{"items":{"$ref":"#/components/schemas/PnlReport"},"nullable":true,"type":"array"},"total_revenue":{"nullable":true,"type":"number"}},"type":"object"},"PnLTimePeriod":{"properties":{"column_index":{"nullable":true,"type":"integer"},"end_date":{"format":"date","nullable":true,"type":"string"},"label":{"nullable":true,"type":"string"},"start_date":{"format":"date","nullable":true,"type":"string"},"time_interval":{"enum":["year_end","quarter","month","interim_one_off",null],"nullable":true,"type":"string"}},"type":"object"},"PnLTotalGroup":{"properties":{"gross_profit":{"nullable":true,"type":"number"},"net_operating_profit":{"nullable":true,"type":"number"},"net_other_profit":{"nullable":true,"type":"number"},"net_profit":{"nullable":true,"type":"number"},"total_cogs":{"nullable":true,"type":"number"},"total_operating_expenses":{"nullable":true,"type":"number"},"total_other_expenses":{"nullable":true,"type":"number"},"total_other_income":{"nullable":true,"type":"number"},"total_revenue":{"nullable":true,"type":"number"}},"type":"object"},"PnlMetric":{"properties":{"confidence":{"description":"Amount weighted confidence for the metric, based on the confidene associated with category labels of related transactions","nullable":true,"type":"number"},"indent":{"description":"Indentation level for formatting purposes","type":"integer"},"is_ratio":{"description":"Whether the metric is a ratio or not","type":"boolean"},"name":{"description":"Name of metric","type":"string"},"values":{"description":"The list of values ordered according to date","items":{"nullable":true,"type":"number"},"type":"array"}},"type":"object"},"PnlMetricFractionTerm":{"properties":{"labels":{"description":"List of category labels associated with the fraction term","items":{"type":"string"},"type":"array"},"sections":{"description":"List of section slugs associated with the fraction term","items":{"type":"string"},"type":"array"}},"type":"object"},"PnlMetricLayout":{"properties":{"denominator":{"allOf":[{"$ref":"#/components/schemas/PnlMetricFractionTerm"}],"description":"If the metric is a ratio, the denominator of the metric; otherwise this is just 1","nullable":true},"indent":{"description":"Indentation level for formatting purposes","type":"integer"},"is_growth":{"description":"If true, calculates the % growth in the metric over time","type":"boolean"},"name":{"description":"Name of metric","type":"string"},"numerator":{"allOf":[{"$ref":"#/components/schemas/PnlMetricFractionTerm"}],"description":"The numerator of the metric"}},"type":"object"},"PnlReport":{"properties":{"extracted_totals":{"allOf":[{"$ref":"#/components/schemas/PnLTotalGroup"}],"nullable":true},"is_reconciled":{"nullable":true,"type":"boolean"},"line_items":{"items":{"$ref":"#/components/schemas/PnLLineItem"},"nullable":true,"type":"array"},"summed_totals":{"allOf":[{"$ref":"#/components/schemas/PnLTotalGroup"}],"nullable":true},"time_period":{"allOf":[{"$ref":"#/components/schemas/PnLTimePeriod"}],"nullable":true}},"type":"object"},"PnlSection":{"properties":{"metrics":{"description":"Ordered list of P&L metrics","items":{"$ref":"#/components/schemas/PnlMetric"},"type":"array"},"name":{"description":"Name of P&L section, e.g,. Operating Expenses","type":"string"},"slug":{"description":"Slugified version of the name","type":"string"}},"type":"object"},"PnlSectionLayout":{"properties":{"labels":{"description":"The category labels associated with the section","items":{"type":"string"},"type":"array"},"metrics":{"description":"An ordered list of metric layouts","items":{"$ref":"#/components/schemas/PnlMetricLayout"},"type":"array"},"name":{"description":"Name of P&L section, e.g,. Operating Expenses","type":"string"},"slug":{"description":"Slugified version of the name","type":"string"}},"type":"object"},"PolicyBranch":{"properties":{"checks":{"items":{"$ref":"#/components/schemas/Check"},"type":"array"},"condition":{"allOf":[{"$ref":"#/components/schemas/Check"}],"description":"Selects this branch when it passes. Branches are tried in order and the first match runs; a condition that fails or is missing data does not match."},"heron_id":{"description":"Stable across renames; omit for a new branch and one is minted","nullable":true,"type":"string"},"name":{"type":"string"}},"required":["condition","name"],"type":"object"},"PolicyClaim":{"properties":{"claim_description":{"description":"A detailed description of the nature of the claim and cause of loss, if applicable and different to the claim_summary.","nullable":true,"type":"string"},"claim_number":{"description":"The unique identifier assigned to the claim","nullable":true,"type":"string"},"claim_summary":{"description":"A brief description of the nature of the claim (e.g., property damage, bodily injury)","nullable":true,"type":"string"},"date_closed":{"description":"The date when the claim was closed","format":"date","nullable":true,"type":"string"},"date_of_loss":{"description":"The date when the loss on the claim happened in YYYY-MM-DD format","format":"date","nullable":true,"type":"string"},"date_reported":{"description":"The date when the claim was reported to the insurer in YYYY-MM-DD format","format":"date","nullable":true,"type":"string"},"losses":{"description":"A list of losses associated with this claim","items":{"$ref":"#/components/schemas/PolicyLoss"},"nullable":true,"type":"array"}},"type":"object"},"PolicyDefinition":{"properties":{"policy_sections":{"items":{"$ref":"#/components/schemas/PolicyVersionSection"},"type":"array"}},"required":["policy_sections"],"type":"object"},"PolicyDefinitionValidateSchema":{"properties":{"policy_definition":{"$ref":"#/components/schemas/PolicyDefinition"}},"required":["policy_definition"],"type":"object"},"PolicyDefinitionValidationSchema":{"properties":{"errors":{"description":"Every problem saving this definition as the draft would refuse; empty when it would save","items":{"$ref":"#/components/schemas/DefinitionIssue"},"type":"array"}},"required":["errors"],"type":"object"},"PolicyEvaluationResult":{"properties":{"policy_heron_id":{"description":"Heron ID of the policy that was evaluated","type":"string"},"policy_name":{"description":"Name of the policy that was evaluated","type":"string"},"result":{"description":"Result of the policy evaluation","enum":["passed","failed","review_required","missing_data","execution_error","skipped"]},"use_case":{"description":"Use case of the policy; null only for evaluations predating the backfill","enum":["background_check","cashflow",null],"nullable":true}},"type":"object"},"PolicyEvaluationSchema":{"properties":{"branch":{"allOf":[{"$ref":"#/components/schemas/EvaluatedBranch"}],"description":"The branch the deal reached - the first whose condition passed, else the default, or one whose condition can't be evaluated (condition_unavailable: true). Null for a section with no branches (only shared checks), one not yet evaluated, or no match with no default","nullable":true,"readOnly":true},"condition_evaluations":{"description":"The branch conditions evaluated, in order, up to the one that matched. They choose the branch and never fail the section. Empty for a section without branches","items":{"$ref":"#/components/schemas/ConditionEvaluation"},"readOnly":true,"type":"array"},"decision_time_seconds":{"description":"Seconds from intake to decision, measured across the workflow run that produced this evaluation. Null unless that run completed - still running, failed, a dry run, or evaluated outside a workflow. A restarted deal is timed from the restart","nullable":true,"readOnly":true,"type":"number"},"failed_checks":{"items":{"$ref":"#/components/schemas/CheckEvaluation"},"type":"array"},"missing_data_checks":{"items":{"$ref":"#/components/schemas/CheckEvaluation"},"type":"array"},"pass_status":{"description":"Where the evaluation pass this row belongs to has got to. Null when the deal was evaluated outside a workflow, or by a policy with no active version","enum":["in_progress","completed","failed",null],"nullable":true,"readOnly":true},"passed_checks":{"items":{"$ref":"#/components/schemas/CheckEvaluation"},"type":"array"},"policy":{"$ref":"#/components/schemas/PolicySchema"},"policy_version":{"nullable":true,"readOnly":true,"type":"integer"},"result":{"description":"The section's verdict. Null when the evaluation pass has not decided this section yet - read it with `pass_status`, which is `in_progress` for those rows","enum":["passed","failed","review_required","missing_data","execution_error","skipped",null],"nullable":true}},"type":"object"},"PolicyLoss":{"properties":{"claimant_name":{"description":"The name of the claimant for the loss","nullable":true,"type":"string"},"claims_examiner":{"description":"The name of the claims examiner for this loss event. Also known as the 'Handler' or 'Adjuster' for the loss.","nullable":true,"type":"string"},"expense_paid":{"description":"The absolute amount already paid out for expenses related to the loss (e.g. legal fees, investigation costs). Also called 'Paid Fees', 'Paid ALAE (Allocated loss adjustment expenses)', 'Payment Expense(s)'","nullable":true,"type":"number"},"expense_reserve":{"description":"The absolute amount reserved specifically for expenses related to the loss (e.g. legal fees, investigation costs). Also called 'Reserve ALAE (Allocated loss adjustment expenses)', 'Outstanding Expense(s)'","nullable":true,"type":"number"},"loss_paid":{"description":"The absolute amount paid for the loss itself (excluding expenses). Also called 'Paid Loss', 'Indemnity Paid', 'Payment Loss'","nullable":true,"type":"number"},"loss_reserve":{"description":"The absolute amount reserved for the loss itself (excluding expenses). Also called 'Reserve Loss', 'Indemnity Reserve', 'Outstanding Loss'","nullable":true,"type":"number"},"loss_type":{"description":"The loss type for this event. E.g. AL (Auto Liability), PD (Property Damage), BI (Bodily Injury), UM/UIM (Uninsured/Underinsured Motorist), SLL (Single Limit Liability) etc.","nullable":true,"type":"string"},"status":{"description":"The current status of the loss event","enum":["Open","Closed","Denied","Pending"],"nullable":true,"type":"string"},"total_incurred":{"description":"The absolute amount incurred by this loss after recoveries (only include this if it appears in the document, do not attempt to calculate it). Also called 'Total Net Payment' or 'Incurred Total'","nullable":true,"type":"number"},"total_recovered":{"description":"The absolute amount recovered from third parties or other insurers for the loss. Sometimes also called 'Total Collected' when used in the context of an insurance loss run. Also called 'Recovery'","nullable":true,"type":"number"}},"type":"object"},"PolicySchema":{"properties":{"checks":{"items":{"$ref":"#/components/schemas/Check"},"type":"array"},"display_order":{"nullable":true,"type":"integer"},"heron_id":{"type":"string"},"name":{"type":"string"},"use_case":{"enum":["background_check","cashflow"]}},"required":["heron_id","name"],"type":"object"},"PolicyVersionBacktestStatus":{"properties":{"backtest_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"deal_count":{"description":"Deals the backtest covered","nullable":true,"readOnly":true,"type":"integer"},"finished_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"flipped_deal_count":{"description":"Deals whose outcome changed, null unless the run completed","nullable":true,"readOnly":true,"type":"integer"},"run_status":{"description":"Status of this version's latest backtest, null if it has never been backtested","enum":["pending","running","complete","failed",null],"nullable":true,"readOnly":true},"stale":{"description":"The version was edited after that backtest was asked for, so re-run before publishing","readOnly":true,"type":"boolean"}},"required":["stale"],"type":"object"},"PolicyVersionCreateSchema":{"properties":{"change_description":{"maxLength":255,"nullable":true,"type":"string"}},"type":"object"},"PolicyVersionPublishSchema":{"properties":{"expected_active_version":{"description":"The active version number when you reviewed the draft, or null if none was active.","nullable":true,"type":"integer"},"expected_draft_revision":{"description":"The draft_revision of the draft you reviewed.","type":"string"},"expected_tables_revision":{"description":"The tables_revision of the publish preview you reviewed. Refuses the publish if a lookup table the draft uses changed since, including between the preview and saving the draft.","type":"string"}},"required":["expected_active_version","expected_draft_revision"],"type":"object"},"PolicyVersionSchema":{"properties":{"author_email":{"description":"Email of whoever last acted on this version: the drafter while it is a draft, the publisher once published","readOnly":true,"type":"string"},"backtest_status":{"allOf":[{"$ref":"#/components/schemas/PolicyVersionBacktestStatus"}],"readOnly":true},"change_description":{"description":"What changed in this version","nullable":true,"readOnly":true,"type":"string"},"created":{"format":"date-time","readOnly":true,"type":"string"},"last_edited_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"policy_definition":{"allOf":[{"$ref":"#/components/schemas/PolicyDefinition"}],"readOnly":true},"published_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"status":{"enum":["draft","active","archived"],"readOnly":true},"version":{"description":"Version number, unique per account","readOnly":true,"type":"integer"}},"required":["policy_definition"],"type":"object"},"PolicyVersionSection":{"properties":{"branches":{"description":"Ordered routes through the section; the section's own checks run on every route","items":{"$ref":"#/components/schemas/PolicyBranch"},"type":"array"},"checks":{"items":{"$ref":"#/components/schemas/Check"},"type":"array"},"default_branch":{"allOf":[{"$ref":"#/components/schemas/DefaultPolicyBranch"}],"description":"Runs when no branch's condition passes","nullable":true},"display_order":{"nullable":true,"type":"integer"},"heron_id":{"nullable":true,"type":"string"},"name":{"type":"string"},"use_case":{"enum":["background_check","cashflow"]}},"required":["name"],"type":"object"},"PolicyVersionSectionAvailabilitySchema":{"properties":{"sections":{"description":"A variable in none of a section's lists, and not in variables_not_in_workflow, is available","items":{"$ref":"#/components/schemas/SectionAvailability"},"type":"array"},"variables_not_in_workflow":{"description":"Variables no step in the workflow produces, so no section can read them","items":{"type":"string"},"type":"array"}},"required":["sections","variables_not_in_workflow"],"type":"object"},"PolicyVersionSummarySchema":{"properties":{"author_email":{"description":"Email of whoever last acted on this version: the drafter while it is a draft, the publisher once published","readOnly":true,"type":"string"},"change_description":{"description":"What changed in this version","nullable":true,"readOnly":true,"type":"string"},"created":{"format":"date-time","readOnly":true,"type":"string"},"last_edited_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"published_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"status":{"enum":["draft","active","archived"],"readOnly":true},"version":{"description":"Version number, unique per account","readOnly":true,"type":"integer"}},"type":"object"},"PolicyVersionUpdateSchema":{"properties":{"change_description":{"maxLength":255,"nullable":true,"type":"string"},"policy_definition":{"allOf":[{"$ref":"#/components/schemas/PolicyDefinition"}],"nullable":true}},"type":"object"},"PolicyWorkflowBranchReason":{"properties":{"kind":{"description":"outcomes: the policy outcomes taken; answer: what the branch means, as its node names it","enum":["outcomes","answer"]},"outcomes":{"description":"For outcomes, the policy handles taken","items":{"type":"string"},"type":"array"},"text":{"description":"The reason as one sentence, e.g. Fraud checks passed","type":"string"}},"required":["kind","outcomes","text"],"type":"object"},"PolicyWorkflowSummarySchema":{"properties":{"nodes":{"description":"The workflow as customers read it, from the trigger down. Failure handles are left out.","items":{"$ref":"#/components/schemas/PolicyWorkflowTreeNode"},"type":"array"},"sections_not_in_workflow":{"description":"Active policy version sections no workflow node evaluates, in policy order","items":{"$ref":"#/components/schemas/PolicyWorkflowSummarySectionNotInWorkflow"},"type":"array"},"workflow_readable":{"description":"False when the default workflow has no published version or cannot be read; nodes are then empty and every section is listed as not in the workflow","type":"boolean"}},"required":["nodes","sections_not_in_workflow","workflow_readable"],"type":"object"},"PolicyWorkflowSummarySectionNotInWorkflow":{"properties":{"section_heron_id":{"nullable":true,"type":"string"},"section_name":{"type":"string"}},"required":["section_heron_id","section_name"],"type":"object"},"PolicyWorkflowSummaryStep":{"properties":{"id":{"description":"Opaque id, unique within this response; a goto names the step it points back to by it","type":"string"},"kind":{"enum":["parser","enricher","data","policy_section"]},"label":{"type":"string"},"section_heron_id":{"description":"Match sections on this, never on the label","nullable":true,"type":"string"},"section_name":{"nullable":true,"type":"string"}},"required":["id","kind","label"],"type":"object"},"PolicyWorkflowTreeArm":{"properties":{"nodes":{"items":{"$ref":"#/components/schemas/PolicyWorkflowTreeNode"},"type":"array"},"reasons":{"description":"Why a run takes this arm, in the order it decides; empty when nothing customers see decides it","items":{"$ref":"#/components/schemas/PolicyWorkflowBranchReason"},"type":"array"}},"required":["nodes","reasons"],"type":"object"},"PolicyWorkflowTreeNode":{"properties":{"arms":{"description":"For a fork","items":{"$ref":"#/components/schemas/PolicyWorkflowTreeArm"},"type":"array"},"kind":{"description":"step: one step; fork: arms a run picks one of, laid out side by side when parallel; goto: the run continues at a step drawn earlier; group: data steps that feed the same section, placed before it","enum":["step","fork","goto","group"]},"parallel":{"description":"For a fork, whether its arms are laid out side by side: steps that run together, or the routes of a decision customers don't see. False when a run takes one named arm","type":"boolean"},"question":{"description":"For a fork, the question its arms answer, e.g. Required files present?; each arm's answer reason is then a short answer such as Yes","nullable":true,"type":"string"},"rejoins":{"description":"For a fork, whether its arms meet again; when not, each arm ends the run","type":"boolean"},"step":{"allOf":[{"$ref":"#/components/schemas/PolicyWorkflowSummaryStep"}],"description":"For step and goto","nullable":true},"steps":{"description":"For a group, in no particular order","items":{"$ref":"#/components/schemas/PolicyWorkflowSummaryStep"},"type":"array"}},"required":["arms","kind","parallel","question","rejoins","step","steps"],"type":"object"},"PositionInflowMetrics":{"properties":{"count":{"type":"integer"},"max_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"max_timestamp":{"format":"date-time","nullable":true,"type":"string"},"min_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"min_timestamp":{"format":"date-time","nullable":true,"type":"string"},"total_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true}},"type":"object"},"PositionOutflowMetrics":{"properties":{"changed_in_last_90_days":{"type":"boolean"},"confidence_reasons":{"description":"Machine-readable reasons for the estimated confidence band","items":{"type":"string"},"type":"array"},"count":{"type":"integer"},"duration_days":{"nullable":true,"type":"integer"},"estimated_confidence":{"description":"Confidence band for outflow estimates: high, medium, low, or none","enum":["high","medium","low","none",null],"nullable":true,"type":"string"},"estimated_monthly_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Expected monthly repayment. An MCA with a regular cadence: the regular payment, or the latest pull day if lower, times the payments that cadence makes in a month, plus any second schedule still pulling alongside at its own cadence. A line of credit, a revenue share, or an MCA with no regular cadence: the repayments in the 30 days ending where the paying accounts' bank data ends. An open MCA with no repayment in that window reports its latest payment","nullable":true},"estimated_remaining_balance":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"estimated_right_to_receive_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"fallback_estimated_monthly_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"Monthly fallback amount using the latest repayment for low and medium confidence estimates","nullable":true},"frequency":{"enum":["not_enough_data","same_day","irregular","daily","weekly","biweekly","monthly","quarterly","annually","weekday","twice_weekly",null],"nullable":true,"type":"string"},"has_repayment_modifications":{"type":"boolean"},"latest_estimated_monthly_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"description":"A regular-cadence MCA: the latest repayment times payments_per_month. A line of credit, a revenue share, or an MCA with no regular cadence: the same window total as estimated_monthly_amount","nullable":true},"latest_repayment_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"latest_repayment_frequency":{"enum":["not_enough_data","same_day","irregular","daily","weekly","biweekly","monthly","quarterly","annually","weekday","twice_weekly",null],"nullable":true,"type":"string"},"max_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"max_timestamp":{"format":"date-time","nullable":true,"type":"string"},"mean_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"mean_interval_days":{"format":"decimal","nullable":true,"type":"string"},"min_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"min_timestamp":{"format":"date-time","nullable":true,"type":"string"},"mode_interval_days":{"nullable":true,"type":"integer"},"payments_per_month":{"description":"Payments a month. A regular-cadence MCA: the payments its cadence makes in a month. A line of credit, a revenue share, or an MCA with no regular cadence: the repayment days counted in the window estimated_monthly_amount sums","format":"decimal","nullable":true,"type":"string"},"remaining_repayment_duration_days":{"nullable":true,"type":"integer"},"std_dev_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"total_amount":{"allOf":[{"$ref":"#/components/schemas/Money"}],"nullable":true},"total_expected_duration_days":{"nullable":true,"type":"integer"},"total_expected_payments_to_date":{"nullable":true,"type":"integer"}},"type":"object"},"PositionOverride":{"properties":{"created":{"format":"date-time","type":"string"},"created_by":{"description":"Email of the person who made the edit","type":"string"},"heron_id":{"description":"Heron ID of the override","type":"string"},"is_deleted":{"nullable":true,"type":"boolean"},"latest_repayment_amount":{"nullable":true,"type":"number"},"merchant_name":{"description":"Funder of the edited position","nullable":true,"type":"string"},"original_latest_repayment_amount":{"nullable":true,"type":"number"},"original_repayment_frequency":{"enum":["not_enough_data","same_day","irregular","daily","weekly","biweekly","monthly","quarterly","annually","weekday","twice_weekly",null],"nullable":true,"type":"string"},"original_status":{"enum":["none","active","inactive","defaulted","potential_default","renewal_active","renewal_inactive","new_position","likely_paid_off"],"type":"string"},"position_heron_id":{"description":"Position the override applies to; null when positions were rebuilt and it no longer applies","nullable":true,"readOnly":true},"position_override_set_id":{"description":"Shared by every edit to the same position","format":"uuid","type":"string"},"product_type":{"enum":["mca","line_of_credit","reverse_consolidation","revenue_share"],"type":"string"},"repayment_frequency":{"enum":["not_enough_data","same_day","irregular","daily","weekly","biweekly","monthly","quarterly","annually","weekday","twice_weekly",null],"nullable":true,"type":"string"},"status":{"enum":["none","active","inactive","defaulted","potential_default","renewal_active","renewal_inactive","new_position","likely_paid_off",null],"nullable":true,"type":"string"}},"type":"object"},"PositionOverrideRequest":{"properties":{"latest_repayment_amount":{"description":"Overridden latest repayment amount","minimum":0.0,"nullable":true,"type":"number"},"repayment_frequency":{"description":"Overridden repayment frequency; regular cadences only","enum":["not_enough_data","same_day","irregular","daily","weekly","biweekly","monthly","quarterly","annually","weekday","twice_weekly",null],"nullable":true,"type":"string"},"status":{"description":"Overridden status","enum":["none","active","inactive","defaulted","potential_default","renewal_active","renewal_inactive","new_position","likely_paid_off",null],"nullable":true,"type":"string"}},"required":["latest_repayment_amount","repayment_frequency","status"],"type":"object"},"PositionOverrides":{"properties":{"overrides":{"items":{"$ref":"#/components/schemas/PositionOverride"},"type":"array"}},"type":"object"},"PositionSummary":{"properties":{"bounced_repayment_transactions":{"description":"Repayments a reversal returned. Not counted as repaid; each one is a missed payment. Only populated when include_transactions=true is passed on the request","items":{"$ref":"#/components/schemas/PositionTransaction"},"nullable":true,"type":"array"},"collecting_accounts":{"description":"Every account a repayment was debited from, most-collected first","items":{"$ref":"#/components/schemas/CollectingAccount"},"type":"array"},"funder_holdback_percentage":{"description":"Funder expected monthly repayments divided by average monthly true revenue, as a percentage","nullable":true,"type":"number"},"group":{"nullable":true,"type":"string"},"has_possible_payoff":{"description":"A lump was left out of the estimate but lacks the corroboration needed to call the position paid off","type":"boolean"},"heron_id":{"type":"string"},"holdback_percentage":{"description":"Position expected monthly repayment divided by average monthly true revenue, as a percentage","nullable":true,"type":"number"},"inflow_metrics":{"allOf":[{"$ref":"#/components/schemas/PositionInflowMetrics"}],"nullable":true},"investment_transactions":{"description":"Only populated when include_transactions=true is passed on the request","items":{"$ref":"#/components/schemas/PositionTransaction"},"nullable":true,"type":"array"},"is_active":{"description":"True for new, active and renewal active positions: the positions total holdback counts.","type":"boolean"},"is_renewal":{"nullable":true,"type":"boolean"},"likely_paid_off":{"description":"Judged likely paid off: repaid past the paid-off factor rate, or settled by a payoff or a funder refund after the last pull. Positions built before this field existed take it from their status (null until backfilled).","nullable":true,"type":"boolean"},"llm_summary":{"nullable":true,"type":"string"},"merchant":{"nullable":true,"type":"string"},"missed_payments":{"items":{"format":"date","type":"string"},"nullable":true,"type":"array"},"nsf_fees":{"items":{"$ref":"#/components/schemas/RelatedPayment"},"nullable":true,"type":"array"},"outflow_metrics":{"allOf":[{"$ref":"#/components/schemas/PositionOutflowMetrics"}],"nullable":true},"parent_position_heron_id":{"nullable":true,"type":"string"},"payoffs":{"description":"Payments that settled the position rather than servicing it","items":{"$ref":"#/components/schemas/RelatedPayment"},"nullable":true,"type":"array"},"primary_collecting_account":{"allOf":[{"$ref":"#/components/schemas/CollectingAccount"}],"description":"The account most repayments were debited from. Ties go to the larger total debited, then to the account with the most recent repayment. Null when no repayment is linked to an account.","nullable":true},"product_type":{"enum":["mca","line_of_credit","reverse_consolidation","revenue_share",null],"nullable":true,"type":"string"},"repayment_transactions":{"description":"Only populated when include_transactions=true is passed on the request","items":{"$ref":"#/components/schemas/PositionTransaction"},"nullable":true,"type":"array"},"reversal_transactions":{"description":"Only populated when include_transactions=true is passed on the request","items":{"$ref":"#/components/schemas/PositionTransaction"},"nullable":true,"type":"array"},"reversals":{"items":{"$ref":"#/components/schemas/RelatedPayment"},"nullable":true,"type":"array"},"servicing_fees":{"items":{"$ref":"#/components/schemas/RelatedPayment"},"nullable":true,"type":"array"},"status":{"enum":["none","active","inactive","defaulted","potential_default","renewal_active","renewal_inactive","new_position","likely_paid_off"],"type":"string"},"stop_payments":{"items":{"$ref":"#/components/schemas/RelatedPayment"},"nullable":true,"type":"array"}},"type":"object"},"PositionTransaction":{"properties":{"account_owner_name":{"description":"Name the bank statement lists as the owner of the account the money was collected from","example":"ACME TRADING LLC","nullable":true,"type":"string"},"amount":{"$ref":"#/components/schemas/Money"},"description":{"type":"string"},"display_account_id":{"description":"Human-readable label for the bank account the money was collected from: the last four digits of the account number without heron_account_suffix (falling back to the account title). Not unique and not a key.","example":"7505","nullable":true,"type":"string"},"file_class":{"description":"Class of the file this transaction was loaded from, such as `bank_statement` or `month_to_date`. Null when there is no file.","example":"bank_statement","nullable":true,"type":"string"},"heron_account_suffix":{"description":"Added by Heron to tell apart accounts that print the same account number, such as a checking account and its reserve line. Not printed by the bank. A 3-digit suffix is the order the accounts appear in one file, so the same account can get a different one in another file. Null when the printed number needed no suffix.","example":"001","nullable":true,"type":"string"},"heron_id":{"type":"string"},"statement_reconciliation_method":{"description":"How the file's verdict was set: `start_and_end_balance`, `running_balance`, `summary_derived`, `total_debits_credits` or `zero_balances` for an automatic check; `human` for a reviewer. Null when no method decided it, including `not_possible` files, or when there is no file.","enum":["start_and_end_balance","summary_derived","running_balance","total_debits_credits","zero_balances","human",null],"nullable":true},"statement_reconciliation_status":{"description":"Whether the file this transaction was loaded from reconciled. `reconciled`: a check passed or a reviewer confirmed it. `not_possible`: nothing on the file to check against. `failed`: a check did not match, or a reviewer ruled it unreconciled. A `failed` file can still load transactions: when unreconciled transaction loading is on, or after a reviewer approves it. Null when there is no file (bank connection, API-posted or legacy source), when the file is still processing, or when it was parsed before 14 Aug 2026.","enum":["failed","not_possible","reconciled",null],"nullable":true,"type":"string"},"timestamp":{"format":"date-time","type":"string"}},"type":"object"},"PositionTransactions":{"properties":{"bounced_repayment_transactions":{"items":{"$ref":"#/components/schemas/PositionTransaction"},"type":"array"},"investment_transactions":{"items":{"$ref":"#/components/schemas/PositionTransaction"},"type":"array"},"position_heron_id":{"type":"string"},"repayment_transactions":{"items":{"$ref":"#/components/schemas/PositionTransaction"},"type":"array"},"reversal_transactions":{"items":{"$ref":"#/components/schemas/PositionTransaction"},"type":"array"}},"type":"object"},"PostIsoApplicationBase64Schema":{"properties":{"file_base64":{"description":"The base64 encoded string of the file","example":"base64_encoded_string","pattern":"^data\\:\\w+\\/\\w+\\;base64\\,","type":"string"},"filename":{"description":"The original filename of the ISO application form","example":"iso_app.pdf","type":"string"},"reference_id":{"description":"A reference id for the file","example":"your-file-id","nullable":true,"type":"string"}},"required":["file_base64","filename"],"type":"object"},"PostProcessorConfigSchema":{"properties":{"description":{"nullable":true,"type":"string"},"inputs":{"additionalProperties":{},"nullable":true,"type":"object"},"name":{"type":"string"}},"required":["name"],"type":"object"},"PostProcessorsResponseSchema":{"properties":{"post_processors":{"items":{"$ref":"#/components/schemas/PostProcessorConfigSchema"},"type":"array"}},"required":["post_processors"],"type":"object"},"PotentialSpouseMatch":{"properties":{"affiliation_index":{"description":"Position of the matching person in that `affiliations` list.","type":"integer"},"affiliation_list":{"description":"Which list on the `affiliations` section holds the match: `records` (associates) or `relatives`.","type":"string"},"age":{"description":"Reported age of the person; null for relatives and when unavailable.","nullable":true,"type":"integer"},"city_state":{"description":"Reported city and state of the person; null for relatives.","nullable":true,"type":"string"},"name":{"description":"Name of the matching person.","nullable":true,"type":"string"},"relationship":{"description":"How the person is linked to the subject, such as shared address or 1st-degree relative.","nullable":true,"type":"string"},"shares_address":{"description":"True when an associate shares an address with the subject; false for relatives.","type":"boolean"},"spouse_name":{"description":"Spouse name on the subject's profile that matched.","type":"string"}},"required":["affiliation_index","affiliation_list","spouse_name"],"type":"object"},"Producer":{"properties":{"key":{"description":"The parser, enricher or node, for kinds that name one","nullable":true,"type":"string"},"kind":{"enum":["bank_statements","enriched_transactions","positions","parsed_file","parsed_submission","enricher","node_output","entity_graph","company_attribute","materialisation_attribute"]}},"required":["kind"],"type":"object"},"ProfessionalLicenseRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"disciplinary_action":{"description":"Disciplinary action reported by the board.","nullable":true,"type":"string"},"issuing_state":{"description":"State that issued the licence.","nullable":true,"type":"string"},"license_discipline":{"description":"Whether the licensing board marked the licence disciplined.","type":"boolean"},"license_sanction_date":{"description":"Date of the licence sanction.","format":"date","nullable":true,"type":"string"},"license_type":{"description":"Professional licence type.","nullable":true,"type":"string"},"licensing_agency":{"description":"Professional licensing board or agency.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source":{"description":"Source area containing the licence: professional_license_section or license_summary.","enum":["professional_license_section","license_summary"],"type":"string"},"status":{"description":"Licence status reported by the licensing board.","nullable":true,"type":"string"}},"type":"object"},"ProfileAddress":{"properties":{"address":{"description":"Reported address.","nullable":true,"type":"string"},"city_state":{"description":"Reported city and state.","nullable":true,"type":"string"},"first_reported_date":{"description":"First reported date; null when unavailable.","format":"date","nullable":true,"type":"string"},"is_po_box":{"description":"Whether this specific address is classified as a PO Box.","type":"boolean"},"last_reported_date":{"description":"Last reported date; null when unavailable.","format":"date","nullable":true,"type":"string"},"source":{"description":"Source that supplied the record.","nullable":true,"type":"string"}},"type":"object"},"ProfileEmail":{"properties":{"email":{"description":"Email address.","nullable":true,"type":"string"},"source":{"description":"Source that supplied the record.","nullable":true,"type":"string"}},"type":"object"},"ProfilePhone":{"properties":{"carrier":{"description":"Phone carrier; null when unavailable.","nullable":true,"type":"string"},"number":{"description":"Phone number.","nullable":true,"type":"string"},"source":{"description":"Source that supplied the record.","nullable":true,"type":"string"},"type":{"description":"Source-provided phone type.","nullable":true,"type":"string"}},"type":"object"},"ProfileSsnIssuance":{"properties":{"expiration_date":{"description":"SSN issuance expiration date; null when unavailable.","nullable":true,"type":"string"},"issuance_text":{"description":"Source-provided SSN issuance summary.","nullable":true,"type":"string"},"issue_date":{"description":"SSN issuance date; null when unavailable.","nullable":true,"type":"string"},"issue_state":{"description":"State where the SSN was issued; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"ProfitAndLossLayoutSchema":{"properties":{"sections":{"description":"Ordered list of P&L sections","items":{"$ref":"#/components/schemas/PnlSectionLayout"},"type":"array"}},"type":"object"},"ProfitAndLossLayoutUpdateSchema":{"properties":{"category_labels":{"description":"List of category labels to assign to a different section","example":["Postage"],"items":{"type":"string"},"minItems":1,"type":"array"},"section_slug":{"description":"Slug of section to assign labels to","example":"operational_expenses","type":"string"}},"required":["category_labels","section_slug"],"type":"object"},"ProfitAndLossParams":{"properties":{"currency":{"description":"ISO 4217 currency code for balance","enum":["GBP","USD","EUR","CAD","AUD",null],"example":"USD","nullable":true,"type":"string"},"dates_ascending":{"default":false,"description":"If true, dates are sorted left to right by ascending order. False by default, i.e., by default sorted in descending date order so more recent dates are first","type":"boolean"},"from_date":{"description":"The earliest transaction timestamp date to use","example":"2022-01-01","format":"date","nullable":true,"type":"string"},"to_date":{"description":"The latest transaction timestamp date to use","example":"2022-01-31","format":"date","nullable":true,"type":"string"}},"type":"object"},"ProfitAndLossSchema":{"properties":{"dates":{"description":"Ordered list of dates representing the columns of the P&L table","items":{"format":"date","type":"string"},"type":"array"},"sections":{"description":"Ordered list of P&L sections","items":{"$ref":"#/components/schemas/PnlSection"},"type":"array"}},"type":"object"},"ProgressPolicySchema":{"properties":{"end_user_heron_id":{"type":"string"}},"required":["end_user_heron_id"],"type":"object"},"PropertyRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"absentee_indicator":{"description":"Source-provided absentee-owner indicator; null when unavailable.","nullable":true,"type":"string"},"appraised_value":{"description":"Total appraised value on the tax record as a decimal string; null on deeds or when unavailable.","format":"decimal","nullable":true,"type":"string"},"assessed_value":{"description":"Total assessed value on the tax record as a decimal string; null on deeds or when unavailable.","format":"decimal","nullable":true,"type":"string"},"attorney_name":{"description":"Attorney named on the foreclosure filing; null when unavailable.","nullable":true,"type":"string"},"body_type":{"description":"Source-provided vehicle body type; null when unavailable.","nullable":true,"type":"string"},"building_square_ft":{"description":"Building area in square feet; null when unavailable.","nullable":true,"type":"integer"},"case_number":{"description":"Foreclosure case reference; null when unavailable.","nullable":true,"type":"string"},"county":{"description":"County where the property is located; null when unavailable.","nullable":true,"type":"string"},"deed_type":{"description":"Source-provided deed type; null when unavailable.","nullable":true,"type":"string"},"dmv_history":{"description":"Earlier DMV registrations, as the source lists them; empty on real-time rows.","items":{"$ref":"#/components/schemas/VehicleDmvHistory"},"type":"array"},"filed_date":{"description":"Foreclosure filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"filing_source":{"description":"Foreclosure filing source: lis_pendens or judgment; absent on other rows.","enum":["lis_pendens","judgment",null],"nullable":true,"type":"string"},"filing_type":{"description":"Source-provided foreclosure filing type; null when unavailable.","nullable":true,"type":"string"},"is_current_owner":{"description":"True on every deed tied for the latest sale date reported for its parcel; false on older deeds. Null on tax records and on deeds without a parcel number or sale date.","nullable":true,"type":"boolean"},"land_use":{"description":"Source-provided land use; null when unavailable.","nullable":true,"type":"string"},"legal_description":{"description":"Legal property description; null when unavailable.","nullable":true,"type":"string"},"lender_name":{"description":"Lender named on the record; null when unavailable.","nullable":true,"type":"string"},"lien_holders":{"description":"Lien holders listed on the vehicle record; empty on real-time rows.","items":{"$ref":"#/components/schemas/VehicleLienHolder"},"type":"array"},"make":{"description":"Vehicle make; null when unavailable.","nullable":true,"type":"string"},"market_value":{"description":"Total market value on the tax record as a decimal string; null on deeds or when unavailable.","format":"decimal","nullable":true,"type":"string"},"model":{"description":"Vehicle model; null when unavailable.","nullable":true,"type":"string"},"model_year":{"description":"Vehicle model year; null when unavailable.","nullable":true,"type":"integer"},"mortgage_amount":{"description":"Recorded mortgage amount as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"mortgage_due_date":{"description":"Mortgage due date; null when unavailable.","format":"date","nullable":true,"type":"string"},"mortgage_type":{"description":"Source-provided mortgage type; null when unavailable.","nullable":true,"type":"string"},"original_loan_amount":{"description":"Original loan amount as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"original_loan_date":{"description":"Original loan date; null when unavailable.","format":"date","nullable":true,"type":"string"},"owner_is_corporate":{"description":"Whether the listed owner is a business; null when unavailable.","nullable":true,"type":"boolean"},"owner_name":{"description":"Owner name listed on the record; null when unavailable.","nullable":true,"type":"string"},"owners":{"description":"Owners listed on the vehicle record.","items":{"$ref":"#/components/schemas/VehicleOwnerSchema"},"type":"array"},"parcel_number":{"description":"Parcel reference; null when unavailable.","nullable":true,"type":"string"},"plaintiff_name":{"description":"Plaintiff named on the foreclosure filing; null when unavailable.","nullable":true,"type":"string"},"plate_expiration_date":{"description":"Plate expiration date, as the source sent it; it is the latest registration. Null when unavailable.","format":"date","nullable":true,"type":"string"},"plate_expiration_date_suspect":{"description":"True when the plate expiration date cannot be right: before 1950, or earlier than the year before the model year. False means checked and plausible. Null means not checked, including real-time rows.","nullable":true,"type":"boolean"},"plate_number":{"description":"Vehicle registration plate; null when unavailable.","nullable":true,"type":"string"},"plate_registration_date":{"description":"Date the current plate was registered; null on real-time or unavailable rows.","format":"date","nullable":true,"type":"string"},"plate_state":{"description":"State that issued the plate; null when unavailable.","nullable":true,"type":"string"},"plate_type":{"description":"Source-provided plate type; null when unavailable.","nullable":true,"type":"string"},"property_address":{"description":"Property address named on the record; null when unavailable.","nullable":true,"type":"string"},"record_group":{"description":"Which record list this row came from. It is the only field separating a vehicle row from a real-time vehicle row.","enum":["pre_foreclosure","real_property","vehicle","real_time_vehicle","pre_foreclosure_at_address","property_at_address","vehicle_at_address"],"type":"string"},"record_type":{"description":"Property record class: deed or tax; absent on foreclosure and vehicle rows.","enum":["deed","tax",null],"nullable":true,"type":"string"},"registration_registrants":{"description":"Registrant names and owner types used to calculate registration status; empty on other rows.","items":{"$ref":"#/components/schemas/VehicleOwnerSchema"},"type":"array"},"registration_status":{"description":"Vehicles rows only, as of the report pull. current: the applicant is a registrant and the plate has not expired. historic: the plate has expired, or the named registrants are not the applicant. unknown: the expiry is missing or suspect, or no registrant can be compared with the applicant. Null on other rows.","enum":["current","historic","unknown",null],"nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"sale_date":{"description":"Recorded sale date; null when unavailable.","format":"date","nullable":true,"type":"string"},"sale_price":{"description":"Recorded sale price as a decimal string; null when unavailable.","format":"decimal","nullable":true,"type":"string"},"seller_name":{"description":"Seller name listed on the deed; null when unavailable.","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source":{"description":"Source that supplied the record; null when unavailable.","nullable":true,"type":"string"},"subject_address":{"description":"Applicant address the record was found under; present only on the at-address record groups and absent on the others. Identifies the address that was searched, not proof of ownership.","nullable":true,"type":"string"},"tax_amount":{"description":"Property tax billed on the tax record as a decimal string; null on deeds or when unavailable.","format":"decimal","nullable":true,"type":"string"},"tax_year":{"description":"Tax year the valuations apply to; null on deeds or when unavailable.","nullable":true,"type":"integer"},"title_company":{"description":"Title company listed on the record; null when unavailable.","nullable":true,"type":"string"},"transaction_type":{"description":"Source-provided transaction type on the deed, such as resale or refinance; null when unavailable.","nullable":true,"type":"string"},"vin":{"description":"Vehicle identification number; null when unavailable.","nullable":true,"type":"string"}},"required":["record_group"],"type":"object"},"PublishIssueSchema":{"properties":{"attribute_label":{"description":"The variable the check reads","nullable":true,"type":"string"},"available_after":{"description":"Customer-facing name of the step after which every deal has the variable","nullable":true,"type":"string"},"blocks_publish":{"description":"Publishing is refused while this is true; saving never is","type":"boolean"},"check_name":{"description":"The top-level check, even when a condition in it reads the variable","nullable":true,"type":"string"},"code":{"enum":["data_on_no_path","data_not_in_workflow","data_on_some_paths_only","data_unverified","policy_node_left_without_sections","routed_branch_removed","unknown_attribute","invalid_attribute_parameters","incompatible_compared_variable","unreadable_lookup_threshold","email_address_compared_with_domain","eusql_check_not_allowed"]},"message":{"type":"string"},"path":{"description":"The check that reads the variable, as a save error would point at it, down to a condition inside a group; empty for a workflow node","items":{},"type":"array"},"policy_node_id":{"description":"Workflow node left with no sections","nullable":true,"type":"string"},"section_heron_id":{"nullable":true,"type":"string"},"section_name":{"nullable":true,"type":"string"}},"required":["blocks_publish","code","message","path"],"type":"object"},"PublishPreview":{"properties":{"active_policy_definition":{"allOf":[{"$ref":"#/components/schemas/PolicyDefinition"}],"nullable":true},"active_version":{"description":"Null when no version is active","nullable":true,"type":"integer"},"changed_section_heron_ids":{"description":"Sections added, removed or with a changed check","items":{"type":"string"},"type":"array"},"draft_revision":{"description":"Send it to POST /policy_version/publish as expected_draft_revision. Null when previewing unsaved edits: save them, then use the draft_revision PUT /policy_version returns.","nullable":true,"type":"string"},"draft_version":{"description":"Null when previewing edits before a draft exists","nullable":true,"type":"integer"},"has_rule_changes":{"type":"boolean"},"issues":{"description":"What publishing would break; an issue with blocks_publish set stops the publish","items":{"$ref":"#/components/schemas/PublishIssueSchema"},"type":"array"},"policy_definition":{"allOf":[{"$ref":"#/components/schemas/PolicyDefinition"}],"description":"The draft as publishing would put it live"},"table_changes":{"description":"Lookup tables the draft adds, drops or uses another version of","items":{"$ref":"#/components/schemas/TableChange"},"type":"array"},"tables_revision":{"description":"Send it to POST /policy_version/publish as expected_tables_revision, so a lookup table edited after this preview, even before the draft is saved, refuses the publish","type":"string"}},"required":["active_policy_definition","active_version","changed_section_heron_ids","draft_revision","draft_version","has_rule_changes","issues","policy_definition","table_changes","tables_revision"],"type":"object"},"PublishPreviewRequest":{"properties":{"policy_definition":{"allOf":[{"$ref":"#/components/schemas/PolicyDefinition"}],"description":"Unsaved edits to the draft, in the shape PUT /policy_version takes. Omit to preview the saved draft.","nullable":true}},"type":"object"},"QueryReportTab":{"properties":{"tab_name":{"type":"string"},"widgets":{"items":{"$ref":"#/components/schemas/QueryReportWidget"},"type":"array"}},"required":["tab_name","widgets"],"type":"object"},"QueryReportTabGroup":{"properties":{"tab_group":{"type":"string"},"tabs":{"items":{"$ref":"#/components/schemas/QueryReportTab"},"type":"array"}},"required":["tab_group","tabs"],"type":"object"},"QueryReportWidget":{"properties":{"description":{"nullable":true,"type":"string"},"query_name":{"type":"string"},"title":{"type":"string"}},"required":["query_name","title"],"type":"object"},"QueryResultSchema":{"properties":{"column_order":{"items":{"type":"string"},"type":"array"},"records":{"items":{"additionalProperties":{},"type":"object"},"type":"array"}},"required":["column_order","records"],"type":"object"},"QueryResults":{"properties":{"results":{"additionalProperties":{"$ref":"#/components/schemas/QueryResultSchema"},"type":"object"}},"type":"object"},"ReannotatePositionOverrideRequest":{"properties":{"position_heron_id":{"description":"Rebuilt position to apply the edit to","type":"string"}},"required":["position_heron_id"],"type":"object"},"Recommendation":{"additionalProperties":false,"properties":{"always_sent":{"readOnly":true,"type":"boolean"},"blockers":{"items":{"$ref":"#/components/schemas/RecommendationBlocker"},"readOnly":true,"type":"array"},"deal":{"allOf":[{"$ref":"#/components/schemas/DealRead"}],"nullable":true,"readOnly":true},"odds":{"nullable":true,"readOnly":true,"type":"number"},"overridden_checks":{"items":{"type":"string"},"readOnly":true,"type":"array"},"rank":{"nullable":true,"readOnly":true,"type":"integer"},"reason":{"nullable":true,"readOnly":true,"type":"string"},"sheet_order":{"nullable":true,"readOnly":true,"type":"integer"},"signals":{"items":{"$ref":"#/components/schemas/RecommendationSignal"},"readOnly":true,"type":"array"},"source":{"readOnly":true,"type":"string"}},"type":"object"},"RecommendationBlocker":{"additionalProperties":false,"properties":{"code":{"readOnly":true,"type":"string"},"text":{"readOnly":true,"type":"string"}},"type":"object"},"RecommendationSignal":{"additionalProperties":false,"properties":{"comparison":{"nullable":true,"readOnly":true,"type":"string"},"display":{"readOnly":true,"type":"string"},"effect":{"readOnly":true,"type":"string"},"feature":{"readOnly":true,"type":"string"},"funder_specific":{"readOnly":true,"type":"boolean"},"label":{"readOnly":true,"type":"string"},"value":{"nullable":true,"readOnly":true}},"type":"object"},"RefreshAssetsReportsResponseSchema":{"properties":{"failed_links":{"description":"Array of item_ids that failed to refresh","example":["item_123","item_456"],"items":{"type":"string"},"type":"array"},"processed_links":{"description":"Number of links processed for refresh","example":2,"type":"integer"}},"required":["failed_links","processed_links"],"type":"object"},"RelatedPayment":{"properties":{"amount":{"type":"number"},"date":{"format":"date","type":"string"},"merchant":{"nullable":true,"type":"string"}},"type":"object"},"RelativeRecord":{"properties":{"degree":{"description":"Degree of relationship to the reported person: 1, 2, or 3.","enum":[1,2,3],"type":"integer"},"name":{"description":"Name of the relative; null when unavailable.","nullable":true,"type":"string"},"relative_of_name":{"description":"Name of the person this relative is related to; null when unavailable.","nullable":true,"type":"string"}},"required":["degree"],"type":"object"},"ReorderEndUserEntitiesSchema":{"properties":{"ordered_entity_heron_ids":{"items":{"type":"string"},"type":"array"}},"required":["ordered_entity_heron_ids"],"type":"object"},"ReorderEndUserEntityAttributesSchema":{"properties":{"ordered_attribute_heron_ids":{"items":{"type":"string"},"type":"array"}},"required":["ordered_attribute_heron_ids"],"type":"object"},"RequiredError":{"properties":{"error":{"type":"string"}},"required":["error"],"type":"object"},"RequiredMessage":{"properties":{"message":{"type":"string"}},"required":["message"],"type":"object"},"ResolvePendingMatchRequestSchema":{"additionalProperties":false,"properties":{"funder_heron_id":{"description":"Heron ID of the funder to match with","type":"string"}},"required":["funder_heron_id"],"type":"object"},"ResolvedAddress":{"description":"An address.","properties":{"_sources":{"additionalProperties":{"type":"string"},"description":"The source of each field, keyed by field name.","type":"object"},"city":{"description":"City or town.","nullable":true,"type":"string"},"country":{"description":"Country.","nullable":true,"type":"string"},"heron_id":{"description":"The Heron ID of this entity. Send it in `PATCH /end_users/{id}/details` to update the entity.","nullable":true,"type":"string"},"is_po_box":{"description":"Whether the address is a PO box.","type":"boolean"},"line_1":{"description":"Street and building number.","nullable":true,"type":"string"},"line_2":{"description":"Apartment, unit or suite.","nullable":true,"type":"string"},"postal_code":{"description":"ZIP or postal code.","nullable":true,"type":"string"},"raw":{"description":"The full address in one line.","type":"string"},"state_province":{"description":"State, province or county. A US state is its two-letter code.","nullable":true,"type":"string"}},"type":"object"},"ResolvedBusiness":{"description":"The applicant's business.","properties":{"_sources":{"additionalProperties":{"type":"string"},"description":"The source of each field, keyed by field name.","type":"object"},"annual_revenue":{"description":"Annual revenue of the business.","nullable":true,"type":"number"},"billing_address":{"allOf":[{"$ref":"#/components/schemas/ResolvedAddress"}],"description":"Billing address of the business.","nullable":true},"dba":{"description":"Trading name (DBA) of the business.","nullable":true,"type":"string"},"emails":{"description":"Email addresses of the business.","items":{"$ref":"#/components/schemas/SourcedEmail"},"type":"array"},"entity_type":{"description":"Legal structure of the business, for example `llc` or `corp`.","enum":["llc","inc","corp","lp","llp","partnership","sole_proprietor","ltd","plc","co","pc","pllc","unknown",null],"nullable":true},"heron_id":{"description":"The Heron ID of this entity. Send it in `PATCH /end_users/{id}/details` to update the entity.","nullable":true,"type":"string"},"identifiers":{"description":"Business identifiers, such as the EIN.","items":{"$ref":"#/components/schemas/SourcedCompanyId"},"type":"array"},"industry":{"allOf":[{"$ref":"#/components/schemas/ResolvedIndustry"}],"description":"Main industry of the business.","nullable":true},"legal_name":{"description":"Legal name of the business.","nullable":true,"type":"string"},"other_addresses":{"description":"Other addresses found for the business.","items":{"$ref":"#/components/schemas/ResolvedAddress"},"type":"array"},"phone_number":{"allOf":[{"$ref":"#/components/schemas/ResolvedPhone"}],"description":"Phone number of the business.","nullable":true},"physical_address":{"allOf":[{"$ref":"#/components/schemas/ResolvedAddress"}],"description":"Physical address of the business.","nullable":true},"social_media":{"allOf":[{"$ref":"#/components/schemas/BusinessSocialMedia"}],"description":"Social media profiles of the business."},"standing":{"description":"How the winning filing reads on filings and fees, null when that filing states none.","enum":["good","not_stated","not_good","pending_end",null],"nullable":true,"type":"string"},"started_on":{"allOf":[{"$ref":"#/components/schemas/PartialDate"}],"description":"Date the business started. The month or day can be missing.","nullable":true},"state_of_incorporation":{"description":"State where the business is incorporated. A US state is its two-letter code.","nullable":true,"type":"string"},"status":{"description":"The company's status across its filings: `active` or `inactive`, null when no source states one.","enum":["active","inactive",null],"nullable":true,"type":"string"},"status_raw":{"description":"The winning filing's status in the registry's own words, null when none was stated.","nullable":true,"type":"string"},"website":{"description":"Website of the business.","nullable":true,"type":"string"}},"type":"object"},"ResolvedCreditScore":{"description":"A credit score of the owner.","properties":{"_sources":{"additionalProperties":{"type":"string"},"description":"The source of each field, keyed by field name.","type":"object"},"bureau":{"description":"Credit bureau that produced the score, or `unknown`.","enum":["equifax","experian","transunion","unknown"]},"heron_id":{"description":"The Heron ID of this entity. Send it in `PATCH /end_users/{id}/details` to update the entity.","nullable":true,"type":"string"},"score":{"description":"The score.","type":"integer"},"score_model":{"description":"Scoring model, for example `fico`, or `unknown`.","enum":["fico","vantagescore","unknown"]},"score_model_raw":{"description":"Scoring model name as provided.","nullable":true,"type":"string"},"score_version_raw":{"description":"Scoring model version, for example `8`.","nullable":true,"type":"string"},"scored_on":{"description":"Date of the score.","format":"date","nullable":true,"type":"string"}},"required":["score"],"type":"object"},"ResolvedFundingApplication":{"description":"The funding the business applied for, and who sent the deal. A deal that names only who sent it has one row with just the source.","properties":{"_sources":{"additionalProperties":{"type":"string"},"description":"The source of each field, keyed by field name.","type":"object"},"amount_requested":{"description":"The amount the business asked for.","nullable":true,"type":"number"},"heron_id":{"description":"The Heron ID of this entity. Send it in `PATCH /end_users/{id}/details` to update the entity.","nullable":true,"type":"string"},"loan_purpose":{"description":"What the business will use the funds for.","nullable":true,"type":"string"},"received_at":{"description":"When Heron received the application. Null if we do not know.","format":"date-time","nullable":true,"type":"string"},"source_email_address":{"description":"The email address of whoever sent the deal, as the customer gave it or the email was sent from.","nullable":true,"type":"string"},"source_name":{"description":"Who sent the deal, as the customer named them or as the email that created the deal shows.","nullable":true,"type":"string"},"source_notes":{"description":"What whoever sent the deal said about it, as the customer gave it or the email's body.","nullable":true,"type":"string"}},"type":"object"},"ResolvedIndustry":{"description":"Main industry of the business.","properties":{"_sources":{"additionalProperties":{"type":"string"},"description":"The source of each field, keyed by field name.","type":"object"},"code":{"description":"Industry code, for example `722511`.","nullable":true,"type":"string"},"description":{"description":"Industry name, for example `Full-Service Restaurants`.","nullable":true,"type":"string"},"heron_id":{"description":"The Heron ID of this entity. Send it in `PATCH /end_users/{id}/details` to update the entity.","nullable":true,"type":"string"},"scheme":{"description":"Classification system: `naics`, `sic` or `free_text`.","enum":["naics","sic","free_text"]}},"type":"object"},"ResolvedOwner":{"description":"An owner of the business.","properties":{"_sources":{"additionalProperties":{"type":"string"},"description":"The source of each field, keyed by field name.","type":"object"},"aliases":{"description":"Other names or spellings found for the owner.","items":{"$ref":"#/components/schemas/PersonName"},"type":"array"},"country_of_residence":{"description":"Country where the owner lives.","nullable":true,"type":"string"},"credit_scores":{"description":"The latest credit score for each scoring model.","items":{"$ref":"#/components/schemas/ResolvedCreditScore"},"type":"array"},"date_of_birth":{"allOf":[{"$ref":"#/components/schemas/PartialDate"}],"description":"Date of birth. The day can be missing.","nullable":true},"deceased_on":{"description":"Date of death, if a source provides one.","format":"date","nullable":true,"type":"string"},"emails":{"description":"Email addresses of the owner.","items":{"$ref":"#/components/schemas/SourcedEmail"},"type":"array"},"has_signed":{"description":"Whether the owner signed the application. True if they signed any of the application forms. False if the forms say they did not sign. Null if the forms do not say.","nullable":true,"type":"boolean"},"heron_id":{"description":"The Heron ID of this entity. Send it in `PATCH /end_users/{id}/details` to update the entity.","nullable":true,"type":"string"},"home_address":{"allOf":[{"$ref":"#/components/schemas/ResolvedAddress"}],"description":"Home address of the owner.","nullable":true},"home_phone_number":{"allOf":[{"$ref":"#/components/schemas/ResolvedPhone"}],"description":"Home phone number of the owner.","nullable":true},"is_deceased":{"description":"Whether the owner is recorded as deceased.","nullable":true,"type":"boolean"},"mobile_phone_number":{"allOf":[{"$ref":"#/components/schemas/ResolvedPhone"}],"description":"Mobile phone number of the owner.","nullable":true},"name":{"allOf":[{"$ref":"#/components/schemas/PersonName"}],"description":"Name of the owner, split into its parts.","nullable":true},"national_ids":{"description":"National identifiers, such as the SSN.","items":{"$ref":"#/components/schemas/SourcedNationalId"},"type":"array"},"other_addresses":{"description":"Other addresses found for the owner.","items":{"$ref":"#/components/schemas/ResolvedAddress"},"type":"array"},"ownership_percentage":{"description":"Percentage of the business the owner owns, from 0 to 100.","nullable":true,"type":"number"},"signed_date":{"description":"The date the owner signed the application. If they signed more than one form, this is the most recent date. A date on a form that says they did not sign is ignored. Null if there is no date.","format":"date","nullable":true,"type":"string"},"social_media":{"allOf":[{"$ref":"#/components/schemas/OwnerSocialMedia"}],"description":"Social media profiles of the owner."}},"type":"object"},"ResolvedPhone":{"description":"A phone number.","properties":{"_sources":{"additionalProperties":{"type":"string"},"description":"The source of each field, keyed by field name.","type":"object"},"country_code":{"description":"Country calling code, without the `+`.","nullable":true,"type":"string"},"heron_id":{"description":"The Heron ID of this entity. Send it in `PATCH /end_users/{id}/details` to update the entity.","nullable":true,"type":"string"},"is_valid":{"description":"Whether the number is valid.","type":"boolean"},"line_type":{"description":"Type of line, for example `mobile` or `fixed_line`.","enum":["fixed_line","mobile","fixed_line_or_mobile","toll_free","premium_rate","shared_cost","voip","personal_number","pager","universal_access_number","voicemail","unknown"]},"national_destination_code":{"description":"Area code.","nullable":true,"type":"string"},"normalized":{"description":"The number in international format, for example `+17635550143`.","nullable":true,"type":"string"},"raw":{"description":"The phone number as provided.","type":"string"},"subscriber_number":{"description":"The number without the country and area codes.","nullable":true,"type":"string"}},"type":"object"},"ResolvedSocialProfile":{"description":"A social media profile.","properties":{"_sources":{"additionalProperties":{"type":"string"},"description":"The source of each field, keyed by field name.","type":"object"},"heron_id":{"description":"The Heron ID of this entity. Send it in `PATCH /end_users/{id}/details` to update the entity.","nullable":true,"type":"string"},"url":{"description":"Link to the profile.","type":"string"}},"type":"object"},"RestrictedIndustry":{"properties":{"description":{"type":"string"},"name":{"type":"string"}},"type":"object"},"ReviewedStateChangedErrorSchema":{"properties":{"code":{"enum":["reviewed_state_changed"],"type":"string"},"message":{"type":"string"},"path":{"description":"Empty: the change is to the whole draft or version","items":{},"type":"array"}},"required":["code","message","path"],"type":"object"},"Rule":{"properties":{"condition":{"description":"Key for how to compare metric value to rule value","enum":["equal","not_equal","greater_than","greater_than_or_equal","less_than","less_than_or_equal","contains"],"example":"equal","type":"string"},"created":{"description":"When the rule was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"date_range":{"description":"Date range corresponding to metric","enum":["latest","last_30_days","last_90_days","last_120_days","last_180_days","last_365_days","next_30_days","next_60_days","next_90_days","next_180_days","last_1_calendar_months","last_3_calendar_months","last_4_calendar_months","last_6_calendar_months","last_12_calendar_months","last_15_calendar_months","last_24_calendar_months","last_1_full_calendar_months","last_2_full_calendar_months","last_3_full_calendar_months","last_6_full_calendar_months","last_12_full_calendar_months","last_60_days","last_45_days","last_2_calendar_months"],"example":"last_180_days","type":"string"},"group":{"description":"Used to display rules by the stage in the underwriting workflow to which they apply.","enum":["data_quality_datasource","data_quality_account","data_quality_transaction",null],"example":"data_quality_datasource","nullable":true,"type":"string"},"heron_id":{"description":"Unique id for rule generated by Heron","example":"rul_cJ6iKdHzvFEmmBtLyjG4dL","readOnly":true,"type":"string"},"last_updated":{"description":"When the rule was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"metric_label":{"description":"Label corresponding to metric","enum":["data_volume","date_range","date_range_with_data_sources","data_freshness","has_balance_ratio","data_coverage","accounts","potentially_duplicated_account_pairs","category_coverage","inflows","outflows","deposit_days","net_amount","inflow_monthly_avg_amount","inflow_amount","inflow_growth_rate","merchant_coverage","confidence","revenue_anomalies","last_debt_investment","last_debt_investment_days","merchant_heron_ids","distinct_mcas","distinct_mcas_from_outflows","distinct_mcas_from_inflows","latest_largest_mca_funding_amount","min_revenue_count_per_statement_ignoring_savings_and_loc_accounts","max_negative_balance_days_per_statement","min_total_revenue_per_statement","max_low_balance_days_per_statement","min_average_daily_balance_per_statement","has_unreconciled_data","revenue_daily_average","cogs_daily_average","opex_daily_average","debt_repayment_daily_average","debt_investment","debt_investors","nsf_fees","nsf_days","inflow_daily_average","average_monthly_revenue_sources","debt_investment_count","debt_collection","tax_payments","tax_payment_amount","unconnected_account_ratio","outflow_daily_average","revenue_sources","atm_withdrawals","revenue","annualized_revenue","cogs","average_credit_card_spend","opex","revenue_profit_and_loss","annualized_revenue_profit_and_loss","cogs_profit_and_loss","opex_profit_and_loss","revenue_monthly_average","number_months_revenue_less_monthly_target","min_number_of_revenue_deposits","debt_repayment","revenue_growth_rate","category_debt_repayment_count","category_other_expenses_count","category_revenue_count","category_postage_count","category_debt_investment_count","category_atm_cash_outflows_count","category_rent_count","insurance_in_out_ratio","rent_in_out_ratio","taxes_in_out_ratio","travel_in_out_ratio","company_investments_in_out_ratio","atm_cash_outflows_in_out_ratio","overdraft_nsf_fees_in_out_ratio","reconciled_intra_company_transfers_to_insurance_ratio","insurance_to_general_payment_ratio","insurance_to_advertising_ratio","insurance_to_credit_card_ratio","insurance_to_check_deposits_ratio","insurance_to_atm_cash_inflows_ratio","insurance_to_debt_repayment_ratio","insurance_to_charges_fees_ratio","insurance_to_travel_ratio","insurance_to_inventory_ratio","insurance_to_none_ratio","equity_investment_to_advertising_ratio","equity_investment_to_debt_repayment_ratio","equity_investment_to_charges_fees_ratio","equity_investment_to_unreconciled_intra_company_transfers_ratio","equity_investment_to_travel_ratio","equity_investment_to_company_investments_ratio","general_payment_to_credit_card_ratio","general_payment_to_p2p_transfers_ratio","general_payment_to_company_investments_ratio","general_payment_to_none_ratio","debt_investment_to_overdraft_nsf_fees_ratio","debt_investment_to_other_expenses_ratio","debt_investment_to_none_ratio","advertising_to_p2p_transfers_ratio","advertising_to_other_expenses_ratio","credit_card_to_check_deposits_ratio","credit_card_to_charges_fees_ratio","credit_card_to_travel_ratio","credit_card_to_inventory_ratio","credit_card_to_revenue_ratio","credit_card_to_payroll_and_consultants_ratio","credit_card_to_none_ratio","rent_to_check_deposits_ratio","rent_to_postage_ratio","rent_to_special_outflows_ratio","rent_to_travel_ratio","rent_to_p2p_transfers_ratio","rent_to_payroll_and_consultants_ratio","check_deposits_to_debt_repayment_ratio","check_deposits_to_postage_ratio","check_deposits_to_unreconciled_intra_company_transfers_ratio","check_deposits_to_revenue_ratio","special_inflows_to_charges_fees_ratio","special_inflows_to_utilities_ratio","special_inflows_to_unreconciled_intra_company_transfers_ratio","special_inflows_to_travel_ratio","special_inflows_to_revenue_ratio","special_inflows_to_atm_cash_outflows_ratio","special_inflows_to_payroll_and_consultants_ratio","refunds_to_atm_cash_inflows_ratio","refunds_to_charges_fees_ratio","refunds_to_utilities_ratio","refunds_to_unreconciled_intra_company_transfers_ratio","refunds_to_travel_ratio","refunds_to_overdraft_nsf_fees_ratio","refunds_to_atm_cash_outflows_ratio","atm_cash_inflows_to_charges_fees_ratio","atm_cash_inflows_to_utilities_ratio","atm_cash_inflows_to_unreconciled_intra_company_transfers_ratio","atm_cash_inflows_to_atm_cash_outflows_ratio","atm_cash_inflows_to_other_expenses_ratio","debt_repayment_to_taxes_ratio","debt_repayment_to_postage_ratio","debt_repayment_to_special_outflows_ratio","debt_repayment_to_atm_cash_outflows_ratio","debt_repayment_to_payroll_and_consultants_ratio","check_outflows_to_charges_fees_ratio","check_outflows_to_utilities_ratio","check_outflows_to_travel_ratio","check_outflows_to_p2p_transfers_ratio","check_outflows_to_revenue_ratio","check_outflows_to_other_expenses_ratio","check_outflows_to_payroll_and_consultants_ratio","taxes_to_travel_ratio","taxes_to_p2p_transfers_ratio","taxes_to_revenue_ratio","taxes_to_atm_cash_outflows_ratio","taxes_to_other_expenses_ratio","taxes_to_payroll_and_consultants_ratio","charges_fees_to_postage_ratio","charges_fees_to_overdraft_nsf_fees_ratio","charges_fees_to_revenue_ratio","charges_fees_to_company_investments_ratio","charges_fees_to_other_expenses_ratio","charges_fees_to_none_ratio","utilities_to_postage_ratio","utilities_to_special_outflows_ratio","utilities_to_travel_ratio","utilities_to_overdraft_nsf_fees_ratio","utilities_to_other_expenses_ratio","postage_to_unreconciled_intra_company_transfers_ratio","postage_to_p2p_transfers_ratio","postage_to_none_ratio","unreconciled_intra_company_transfers_to_travel_ratio","unreconciled_intra_company_transfers_to_p2p_transfers_ratio","unreconciled_intra_company_transfers_to_atm_cash_outflows_ratio","unreconciled_intra_company_transfers_to_other_expenses_ratio","special_outflows_to_p2p_transfers_ratio","special_outflows_to_atm_cash_outflows_ratio","travel_to_p2p_transfers_ratio","travel_to_inventory_ratio","travel_to_other_expenses_ratio","travel_to_payroll_and_consultants_ratio","travel_to_none_ratio","p2p_transfers_to_overdraft_nsf_fees_ratio","p2p_transfers_to_atm_cash_outflows_ratio","inventory_to_overdraft_nsf_fees_ratio","inventory_to_company_investments_ratio","inventory_to_atm_cash_outflows_ratio","inventory_to_other_expenses_ratio","overdraft_nsf_fees_to_other_expenses_ratio","revenue_to_payroll_and_consultants_ratio","latest_balance","balance_minimum","balance_maximum","balance_average","change_in_balance","negative_balance_days","negative_balance_days_by_account","mean_balance_velocity","mean_abs_balance_velocity","weekday_balance_average","weekday_with_highest_avg","weekday_with_lowest_avg","gross_operating_cashflow_daily_average","net_operating_cashflow_daily_average","gross_operating_cashflow","net_operating_cashflow","gross_operating_cashflow_profit_and_loss","net_operating_cashflow_profit_and_loss","net_operating_cashflow_monthly_average","debt_service_coverage_ratio","predicted_nsf_fees","predicted_balance_daily_average","heron_score"],"example":"unique_transactions","type":"string"},"name":{"description":"Description of rule. Sent with webhook response, so can be used as a reference to the rule","example":"notify_if_debt_investment_count_gt_0_last_180d","maxLength":140,"nullable":true,"type":"string"},"selector":{"additionalProperties":{},"description":"key-value pairs of the desired selector that should select whichend users to apply this rule. They are evaluated as an AND condition(all must be true to run this rule for an end user). Leave empty toapply to all end users.","example":{"is_portfolio":true},"type":"object"},"value":{"description":"Numeric value to compare to a metric; use this when the threshold is numeric","example":42.42,"nullable":true,"type":"number"},"value_str":{"description":"String value to compare to a metric; use this when the threshold is a string","example":"mrc_8bYsSyAMW6LGsGFZi8GF9F","nullable":true,"type":"string"}},"type":"object"},"RuleEvaluationSchema":{"properties":{"metric":{"allOf":[{"$ref":"#/components/schemas/Metric"}],"nullable":true},"result":{"enum":["PASS","FAIL","NOT_AVAILABLE"],"type":"string"},"rule":{"$ref":"#/components/schemas/Rule"}},"type":"object"},"RuleUpdateSchema":{"properties":{"condition":{"description":"Key for how to compare metric value to rule value","enum":["equal","not_equal","greater_than","greater_than_or_equal","less_than","less_than_or_equal","contains"],"example":"equal","type":"string"},"created":{"description":"When the rule was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"date_range":{"description":"Date range corresponding to metric","enum":["latest","last_30_days","last_90_days","last_120_days","last_180_days","last_365_days","next_30_days","next_60_days","next_90_days","next_180_days","last_1_calendar_months","last_3_calendar_months","last_4_calendar_months","last_6_calendar_months","last_12_calendar_months","last_15_calendar_months","last_24_calendar_months","last_1_full_calendar_months","last_2_full_calendar_months","last_3_full_calendar_months","last_6_full_calendar_months","last_12_full_calendar_months","last_60_days","last_45_days","last_2_calendar_months"],"example":"last_180_days","type":"string"},"group":{"description":"Used to display rules by the stage in the underwriting workflow to which they apply.","enum":["data_quality_datasource","data_quality_account","data_quality_transaction",null],"example":"data_quality_datasource","nullable":true,"type":"string"},"heron_id":{"description":"Unique id for rule generated by Heron","example":"rul_cJ6iKdHzvFEmmBtLyjG4dL","readOnly":true,"type":"string"},"last_updated":{"description":"When the rule was last updated in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","readOnly":true,"type":"string"},"metric_label":{"description":"Label corresponding to metric","enum":["data_volume","date_range","date_range_with_data_sources","data_freshness","has_balance_ratio","data_coverage","accounts","potentially_duplicated_account_pairs","category_coverage","inflows","outflows","deposit_days","net_amount","inflow_monthly_avg_amount","inflow_amount","inflow_growth_rate","merchant_coverage","confidence","revenue_anomalies","last_debt_investment","last_debt_investment_days","merchant_heron_ids","distinct_mcas","distinct_mcas_from_outflows","distinct_mcas_from_inflows","latest_largest_mca_funding_amount","min_revenue_count_per_statement_ignoring_savings_and_loc_accounts","max_negative_balance_days_per_statement","min_total_revenue_per_statement","max_low_balance_days_per_statement","min_average_daily_balance_per_statement","has_unreconciled_data","revenue_daily_average","cogs_daily_average","opex_daily_average","debt_repayment_daily_average","debt_investment","debt_investors","nsf_fees","nsf_days","inflow_daily_average","average_monthly_revenue_sources","debt_investment_count","debt_collection","tax_payments","tax_payment_amount","unconnected_account_ratio","outflow_daily_average","revenue_sources","atm_withdrawals","revenue","annualized_revenue","cogs","average_credit_card_spend","opex","revenue_profit_and_loss","annualized_revenue_profit_and_loss","cogs_profit_and_loss","opex_profit_and_loss","revenue_monthly_average","number_months_revenue_less_monthly_target","min_number_of_revenue_deposits","debt_repayment","revenue_growth_rate","category_debt_repayment_count","category_other_expenses_count","category_revenue_count","category_postage_count","category_debt_investment_count","category_atm_cash_outflows_count","category_rent_count","insurance_in_out_ratio","rent_in_out_ratio","taxes_in_out_ratio","travel_in_out_ratio","company_investments_in_out_ratio","atm_cash_outflows_in_out_ratio","overdraft_nsf_fees_in_out_ratio","reconciled_intra_company_transfers_to_insurance_ratio","insurance_to_general_payment_ratio","insurance_to_advertising_ratio","insurance_to_credit_card_ratio","insurance_to_check_deposits_ratio","insurance_to_atm_cash_inflows_ratio","insurance_to_debt_repayment_ratio","insurance_to_charges_fees_ratio","insurance_to_travel_ratio","insurance_to_inventory_ratio","insurance_to_none_ratio","equity_investment_to_advertising_ratio","equity_investment_to_debt_repayment_ratio","equity_investment_to_charges_fees_ratio","equity_investment_to_unreconciled_intra_company_transfers_ratio","equity_investment_to_travel_ratio","equity_investment_to_company_investments_ratio","general_payment_to_credit_card_ratio","general_payment_to_p2p_transfers_ratio","general_payment_to_company_investments_ratio","general_payment_to_none_ratio","debt_investment_to_overdraft_nsf_fees_ratio","debt_investment_to_other_expenses_ratio","debt_investment_to_none_ratio","advertising_to_p2p_transfers_ratio","advertising_to_other_expenses_ratio","credit_card_to_check_deposits_ratio","credit_card_to_charges_fees_ratio","credit_card_to_travel_ratio","credit_card_to_inventory_ratio","credit_card_to_revenue_ratio","credit_card_to_payroll_and_consultants_ratio","credit_card_to_none_ratio","rent_to_check_deposits_ratio","rent_to_postage_ratio","rent_to_special_outflows_ratio","rent_to_travel_ratio","rent_to_p2p_transfers_ratio","rent_to_payroll_and_consultants_ratio","check_deposits_to_debt_repayment_ratio","check_deposits_to_postage_ratio","check_deposits_to_unreconciled_intra_company_transfers_ratio","check_deposits_to_revenue_ratio","special_inflows_to_charges_fees_ratio","special_inflows_to_utilities_ratio","special_inflows_to_unreconciled_intra_company_transfers_ratio","special_inflows_to_travel_ratio","special_inflows_to_revenue_ratio","special_inflows_to_atm_cash_outflows_ratio","special_inflows_to_payroll_and_consultants_ratio","refunds_to_atm_cash_inflows_ratio","refunds_to_charges_fees_ratio","refunds_to_utilities_ratio","refunds_to_unreconciled_intra_company_transfers_ratio","refunds_to_travel_ratio","refunds_to_overdraft_nsf_fees_ratio","refunds_to_atm_cash_outflows_ratio","atm_cash_inflows_to_charges_fees_ratio","atm_cash_inflows_to_utilities_ratio","atm_cash_inflows_to_unreconciled_intra_company_transfers_ratio","atm_cash_inflows_to_atm_cash_outflows_ratio","atm_cash_inflows_to_other_expenses_ratio","debt_repayment_to_taxes_ratio","debt_repayment_to_postage_ratio","debt_repayment_to_special_outflows_ratio","debt_repayment_to_atm_cash_outflows_ratio","debt_repayment_to_payroll_and_consultants_ratio","check_outflows_to_charges_fees_ratio","check_outflows_to_utilities_ratio","check_outflows_to_travel_ratio","check_outflows_to_p2p_transfers_ratio","check_outflows_to_revenue_ratio","check_outflows_to_other_expenses_ratio","check_outflows_to_payroll_and_consultants_ratio","taxes_to_travel_ratio","taxes_to_p2p_transfers_ratio","taxes_to_revenue_ratio","taxes_to_atm_cash_outflows_ratio","taxes_to_other_expenses_ratio","taxes_to_payroll_and_consultants_ratio","charges_fees_to_postage_ratio","charges_fees_to_overdraft_nsf_fees_ratio","charges_fees_to_revenue_ratio","charges_fees_to_company_investments_ratio","charges_fees_to_other_expenses_ratio","charges_fees_to_none_ratio","utilities_to_postage_ratio","utilities_to_special_outflows_ratio","utilities_to_travel_ratio","utilities_to_overdraft_nsf_fees_ratio","utilities_to_other_expenses_ratio","postage_to_unreconciled_intra_company_transfers_ratio","postage_to_p2p_transfers_ratio","postage_to_none_ratio","unreconciled_intra_company_transfers_to_travel_ratio","unreconciled_intra_company_transfers_to_p2p_transfers_ratio","unreconciled_intra_company_transfers_to_atm_cash_outflows_ratio","unreconciled_intra_company_transfers_to_other_expenses_ratio","special_outflows_to_p2p_transfers_ratio","special_outflows_to_atm_cash_outflows_ratio","travel_to_p2p_transfers_ratio","travel_to_inventory_ratio","travel_to_other_expenses_ratio","travel_to_payroll_and_consultants_ratio","travel_to_none_ratio","p2p_transfers_to_overdraft_nsf_fees_ratio","p2p_transfers_to_atm_cash_outflows_ratio","inventory_to_overdraft_nsf_fees_ratio","inventory_to_company_investments_ratio","inventory_to_atm_cash_outflows_ratio","inventory_to_other_expenses_ratio","overdraft_nsf_fees_to_other_expenses_ratio","revenue_to_payroll_and_consultants_ratio","latest_balance","balance_minimum","balance_maximum","balance_average","change_in_balance","negative_balance_days","negative_balance_days_by_account","mean_balance_velocity","mean_abs_balance_velocity","weekday_balance_average","weekday_with_highest_avg","weekday_with_lowest_avg","gross_operating_cashflow_daily_average","net_operating_cashflow_daily_average","gross_operating_cashflow","net_operating_cashflow","gross_operating_cashflow_profit_and_loss","net_operating_cashflow_profit_and_loss","net_operating_cashflow_monthly_average","debt_service_coverage_ratio","predicted_nsf_fees","predicted_balance_daily_average","heron_score"],"example":"unique_transactions","type":"string"},"name":{"description":"Description of rule. Sent with webhook response, so can be used as a reference to the rule","example":"notify_if_debt_investment_count_gt_0_last_180d","maxLength":140,"nullable":true,"type":"string"},"selector":{"additionalProperties":{},"description":"key-value pairs of the desired selector that should select whichend users to apply this rule. They are evaluated as an AND condition(all must be true to run this rule for an end user). Leave empty toapply to all end users.","example":{"is_portfolio":true},"type":"object"},"value":{"description":"Numeric value to compare to a metric; use this when the threshold is numeric","example":42.42,"nullable":true,"type":"number"},"value_str":{"description":"String value to compare to a metric; use this when the threshold is a string","example":"mrc_8bYsSyAMW6LGsGFZi8GF9F","nullable":true,"type":"string"}},"type":"object"},"RuleViolation":{"properties":{"metric":{"allOf":[{"$ref":"#/components/schemas/Metric"}],"nullable":true},"rule":{"$ref":"#/components/schemas/Rule"}},"type":"object"},"SQLCheck":{"properties":{"auto_decline":{"default":false,"type":"boolean"},"column_name":{"type":"string"},"decline_code":{"description":"The CRM's identifier for this decline reason, e.g. a LendSaas reason id. Left unset, the CRM sync falls back to this check's decline_description.","nullable":true,"type":"string"},"decline_description":{"nullable":true,"type":"string"},"email_template_name":{"nullable":true,"type":"string"},"ignore_metric_availability":{"default":false,"type":"boolean"},"is_mandatory":{"default":false,"type":"boolean"},"on_failure":{"default":"fail","enum":["fail","review_required"]},"on_missing":{"default":"missing_data","description":"What the check reports when it would report missing data: `missing_data` (the default), `fail` or `pass`. A check saved with an older flag (`pass_if_value_missing` on a date-delta check) reads as the setting it stands for. With `ignore_metric_availability` or `pass_if_value_missing` set, only that setting is accepted","enum":["missing_data","fail","pass"]},"pass_description":{"nullable":true,"type":"string"},"query_name":{"type":"string"},"transaction_scope":{"allOf":[{"$ref":"#/components/schemas/TransactionScope"}],"nullable":true}},"required":["column_name","query_name"],"type":"object"},"SalesforceObjectJsonSchema":{"properties":{"applicant_addresses":{"items":{"additionalProperties":{},"type":"object"},"nullable":true,"type":"array"},"policy_number":{"nullable":true,"type":"string"},"property":{"additionalProperties":{},"nullable":true,"type":"object"},"property_addresses":{"items":{"additionalProperties":{},"type":"object"},"nullable":true,"type":"array"}},"type":"object"},"SaltEdgeCsvSchema":{"properties":{"account_id":{"type":"integer"},"amount":{"type":"number"},"category":{"type":"string"},"closing_balance":{"nullable":true,"type":"number"},"currency_code":{"type":"string"},"description":{"type":"string"},"made_on":{"format":"date","type":"string"},"payee":{"nullable":true,"type":"string"},"payer":{"nullable":true,"type":"string"},"transaction_id":{"type":"integer"}},"type":"object"},"SaveFunderIntegrationRequestSchema":{"properties":{"environment":{"enum":["staging","production"]},"form_values":{"additionalProperties":{"type":"string"},"type":"object"}},"required":["environment","form_values"],"type":"object"},"ScorecardQueryParams":{"properties":{"date":{"description":"Cut-off date to consider transactions to for calculating scorecard (inclusive)","example":"2023-01-19","format":"date","nullable":true,"type":"string"},"named_date":{"description":"Qualitative description for date to calculate scorecard","enum":["end_user_created","end_user_last_updated","last_transaction","end_user_last_enriched","last_data_source_end_date_or_transaction_timestamp","custom_date",null],"example":"end_user_created","nullable":true,"type":"string"}},"type":"object"},"ScorecardSettings":{"properties":{"balance_prediction":{"type":"boolean"},"company_overview_layout":{"items":{"$ref":"#/components/schemas/WidgetGroup"},"type":"array"},"metrics_benchmarks":{"type":"boolean"}},"type":"object"},"SearchAttempt":{"properties":{"candidate_count":{"description":"Number of candidates this step returned.","type":"integer"},"candidate_refs":{"description":"References into candidates for every candidate returned by this search step.","items":{"$ref":"#/components/schemas/SearchAttemptCandidateRef"},"type":"array"},"inputs":{"allOf":[{"$ref":"#/components/schemas/SearchInputsUsed"}],"description":"Exact identifiers sent on this search step."},"is_resolving_match":{"description":"True on the search step whose match became the subject resolution.","type":"boolean"},"matched_group_id":{"description":"Opaque source group identifier for support investigations; null when unmatched.","nullable":true,"type":"string"},"outcome":{"description":"Search outcome: matched, no_match, one_candidate, multiple_candidates, verification_failed, or error.","enum":["matched","no_match","one_candidate","multiple_candidates","verification_failed","error"],"type":"string"},"outcome_reason":{"allOf":[{"$ref":"#/components/schemas/SearchAttemptOutcomeReason"}],"description":"Human-readable explanation of the search outcome; null when unavailable.","nullable":true},"resolved":{"description":"True when this search confidently resolved the subject and ended the search waterfall.","type":"boolean"},"search_method":{"description":"Search method: ssn_only, name_state_dob, name_address, name_state, corp_id, ein, manual_recovery, or linked_entity_id (see the resolution method).","type":"string"},"top_relevance":{"description":"Source relevance score of the best hit; null when no candidate was returned.","nullable":true,"type":"integer"}},"required":["candidate_count","candidate_refs","inputs","is_resolving_match","outcome","resolved","search_method"],"type":"object"},"SearchAttemptCandidateRef":{"properties":{"id":{"description":"Reference to the matching entry in candidates.","type":"string"},"matched_address":{"description":"Address matched on this step; present only when it differs from the canonical entry.","type":"string"},"matched_aka_name":{"description":"AKA name matched on this step; present only when it differs from the canonical entry.","type":"string"},"rank":{"description":"Rank on this step; present only when it differs from the canonical entry.","type":"integer"},"relevance":{"description":"Relevance on this step; present only when it differs from the canonical entry.","type":"integer"},"score_total":{"description":"Match score on this step; present only when it differs from the canonical entry.","type":"number"}},"required":["id"],"type":"object"},"SearchAttemptOutcomeReason":{"properties":{"details":{"description":"Label and value pairs explaining the search outcome.","items":{"$ref":"#/components/schemas/SearchAttemptOutcomeReasonDetail"},"type":"array"},"label":{"description":"Summary of the search outcome.","type":"string"}},"required":["details","label"],"type":"object"},"SearchAttemptOutcomeReasonDetail":{"properties":{"label":{"description":"Display label for the outcome detail.","type":"string"},"value":{"description":"Value paired with the label; null when unavailable.","nullable":true}},"required":["label"],"type":"object"},"SearchInputsUsed":{"properties":{"address":{"description":"Address sent on this step; null when unused.","nullable":true,"type":"string"},"address_source":{"description":"Application address used: company_physical_address or company_billing_address.","enum":["company_physical_address","company_billing_address",null],"nullable":true,"type":"string"},"business_name":{"description":"The business name queried on this step; null on person attempts.","nullable":true,"type":"string"},"business_name_source":{"description":"Which name variant was queried; null on person attempts.","enum":["legal","dba","candidate_fallback","linked_address_fallback",null],"nullable":true,"type":"string"},"corporation_id":{"description":"Corporation identifier sent on this step; null when unused.","nullable":true,"type":"string"},"date_of_birth":{"description":"Date of birth sent on this step; null when unused.","format":"date","nullable":true,"type":"string"},"ein":{"description":"Business EIN sent on this step; null when unused.","nullable":true,"type":"string"},"email":{"description":"Email sent on this step; null when unused.","nullable":true,"type":"string"},"filing_state":{"description":"Filing state sent on this step; null when unused.","nullable":true,"type":"string"},"fuzzy":{"description":"True when this step allowed fuzzy matching.","type":"boolean"},"name":{"description":"Person name sent on this step; null when unused.","nullable":true,"type":"string"},"phone":{"description":"Phone number sent on this step; null when unused.","nullable":true,"type":"string"},"ssn":{"description":"Masked SSN sent on this step; null when unused.","nullable":true,"type":"string"},"state":{"description":"State sent on this step; null when unused.","nullable":true,"type":"string"}},"required":["fuzzy"],"type":"object"},"SectionAvailability":{"properties":{"partially_available_variables":{"description":"Variables only some workflow paths produce before this section; missing data on the others","items":{"$ref":"#/components/schemas/VariableAvailability"},"type":"array"},"section_heron_id":{"description":"Match sections on this","nullable":true,"type":"string"},"section_name":{"type":"string"},"unavailable_variables":{"description":"Variables the workflow produces, but on no path before this section","items":{"$ref":"#/components/schemas/VariableAvailability"},"type":"array"},"unverified_variables":{"description":"Variables whose routes were too many to check; treat as unavailable and say why","items":{"$ref":"#/components/schemas/VariableAvailability"},"type":"array"}},"required":["partially_available_variables","section_name","unavailable_variables","unverified_variables"],"type":"object"},"SendEligibility":{"additionalProperties":false,"properties":{"detail":{"nullable":true,"readOnly":true,"type":"string"},"evidence":{"items":{"$ref":"#/components/schemas/FunderExclusionEvidence"},"nullable":true,"readOnly":true,"type":"array"},"reason":{"enum":["excluded","held","unconfigured","in_progress","ambiguous_attempt","sent","decided",null],"nullable":true,"readOnly":true},"sendable":{"readOnly":true,"type":"boolean"}},"required":["detail","reason","sendable"],"type":"object"},"SetParsedFileReviewStatusSchema":{"properties":{"review_status":{"description":"The review status to set for the parsed file","enum":["review_not_required","in_review","reviewed","approved"],"type":"string"}},"required":["review_status"],"type":"object"},"SkippedDeal":{"properties":{"end_user_heron_id":{"readOnly":true,"type":"string"},"reason":{"enum":["not_found","not_backtestable_status"],"readOnly":true,"type":"string"}},"type":"object"},"SourceVerification":{"properties":{"source":{"description":"The source this line speaks for.","enum":["tin","sos","court","background_check","web_presence","web_search","bank_statement","void_check","pnl_statement","tax_return","driving_licence","xactus","industry_prediction","generic_industry_prediction","industry_prediction_v2","datamerch","business_profile_search","api","manual","broker_submission","crm","application","email"]},"source_inputs":{"additionalProperties":{"nullable":true,"type":"string"},"description":"What this source was searched on, keyed by the field name in that source's own spelling, such as `ein` and `legal_name` for the IRS or `name` and `state` for the registry. Null where the source was sent nothing, which is every line the deal stated itself: those are the input. **A key present with a null value means the field was sent and its value is not printed; a key absent means the field was not sent.** The two are different answers, and the reason this is a map rather than fixed columns: a background check is searched on an SSN that must never be echoed back, so its key carries no value. Not the same as `value`, which is what the source returned.","nullable":true,"type":"object"},"value":{"description":"The one value this source is read on, as it wrote it: the one that met the field's `value` where it states one, and its own leading answer where it does not. Null when it stated nothing, which `verification_status` then explains.","nullable":true,"type":"string"},"verification_status":{"description":"`agree` and `disagree` are this source read against what the deal claimed, not against `value`. `stated` marks the claim itself, which is compared against nothing: the application on every field it can state, and otherwise the first source this field prefers that spoke. `not_compared` marks a source's value on a field that is not verified, listed and compared against nothing. `silent` means the source ran and returned no value for this field, `not_run` that no run of it reached the deal, and `cannot` that this source states no such field at all.","enum":["agree","disagree","stated","silent","not_run","cannot","not_compared"]}},"type":"object"},"SourcedCompanyId":{"description":"A business identifier.","properties":{"_source":{"description":"Where this value came from.","nullable":true,"type":"string"},"country":{"description":"Issuing country, as a two-letter code.","nullable":true,"type":"string"},"type":{"description":"Type of business identifier. The prefix is the issuing country: `us_ein` (US Employer Identification Number), `us_taxpayer_number` (US state taxpayer number), `uk_company_number` (UK Companies House number), `duns` (D-U-N-S number, worldwide) or `vat` (VAT number).","enum":["us_ein","us_taxpayer_number","duns","uk_company_number","vat"]},"value":{"description":"The identifier.","type":"string"}},"type":"object"},"SourcedCurrentStatusValue":{"properties":{"as_of":{"description":"Date of the record that supplied the value, in ISO 8601 format. Null where the source states no date, which is always the case for CLEAR Business Overview.","format":"date","nullable":true,"type":"string"},"filing_id":{"description":"Groups the readings that came from the same corporate filing, so a business with several filings can show each one's status, dates and agent together. Set only on Corporate Filing values; null for every other source. Stable within a response, not across responses.","nullable":true,"type":"string"},"note":{"description":"Any further wording the source attached to the figure, such as whether principals are counted in an employee total. Source-verbatim; null when the source added nothing.","nullable":true,"type":"string"},"qualifier":{"description":"How the source derived the figure: ACTUAL (reported), ESTIMATED (approximated by the source), or MODELED (statistically inferred). Only ever set on employee and revenue figures; null everywhere else.","enum":["ACTUAL","ESTIMATED","MODELED",null],"nullable":true,"type":"string"},"source":{"description":"Which record supplied this value. Corporate Filing is a company registry filing; Dun & Bradstreet and Worldbase are commercial business registers; CLEAR Business Profile is aggregated trade and public-record data; CLEAR Business Overview is a combined summary record. Sources are not reconciled \u2014 two sources may disagree on the same field.","enum":["CLEAR Business Overview","CLEAR Business Profile","Corporate Filing","Dun & Bradstreet","Worldbase"],"type":"string"},"value":{"description":"active or inactive as the source's status wording reads; unknown when no source's wording reads as either. The wording itself is in note.","enum":["active","inactive","unknown"],"type":"string"}},"required":["source","value"],"type":"object"},"SourcedDateValue":{"properties":{"as_of":{"description":"Date of the record that supplied the value, in ISO 8601 format. Null where the source states no date, which is always the case for CLEAR Business Overview.","format":"date","nullable":true,"type":"string"},"filing_id":{"description":"Groups the readings that came from the same corporate filing, so a business with several filings can show each one's status, dates and agent together. Set only on Corporate Filing values; null for every other source. Stable within a response, not across responses.","nullable":true,"type":"string"},"note":{"description":"Any further wording the source attached to the figure, such as whether principals are counted in an employee total. Source-verbatim; null when the source added nothing.","nullable":true,"type":"string"},"qualifier":{"description":"How the source derived the figure: ACTUAL (reported), ESTIMATED (approximated by the source), or MODELED (statistically inferred). Only ever set on employee and revenue figures; null everywhere else.","enum":["ACTUAL","ESTIMATED","MODELED",null],"nullable":true,"type":"string"},"source":{"description":"Which record supplied this value. Corporate Filing is a company registry filing; Dun & Bradstreet and Worldbase are commercial business registers; CLEAR Business Profile is aggregated trade and public-record data; CLEAR Business Overview is a combined summary record. Sources are not reconciled \u2014 two sources may disagree on the same field.","enum":["CLEAR Business Overview","CLEAR Business Profile","Corporate Filing","Dun & Bradstreet","Worldbase"],"type":"string"},"value":{"description":"Source-provided date in ISO 8601 format.","format":"date","type":"string"}},"required":["source","value"],"type":"object"},"SourcedEmail":{"description":"An email address.","properties":{"_source":{"description":"Where this value came from.","nullable":true,"type":"string"},"email_address":{"description":"The email address.","type":"string"}},"type":"object"},"SourcedIndustryCodeValue":{"properties":{"as_of":{"description":"Date of the record that supplied the value, in ISO 8601 format. Null where the source states no date, which is always the case for CLEAR Business Overview.","format":"date","nullable":true,"type":"string"},"filing_id":{"description":"Groups the readings that came from the same corporate filing, so a business with several filings can show each one's status, dates and agent together. Set only on Corporate Filing values; null for every other source. Stable within a response, not across responses.","nullable":true,"type":"string"},"note":{"description":"Any further wording the source attached to the figure, such as whether principals are counted in an employee total. Source-verbatim; null when the source added nothing.","nullable":true,"type":"string"},"qualifier":{"description":"How the source derived the figure: ACTUAL (reported), ESTIMATED (approximated by the source), or MODELED (statistically inferred). Only ever set on employee and revenue figures; null everywhere else.","enum":["ACTUAL","ESTIMATED","MODELED",null],"nullable":true,"type":"string"},"source":{"description":"Which record supplied this value. Corporate Filing is a company registry filing; Dun & Bradstreet and Worldbase are commercial business registers; CLEAR Business Profile is aggregated trade and public-record data; CLEAR Business Overview is a combined summary record. Sources are not reconciled \u2014 two sources may disagree on the same field.","enum":["CLEAR Business Overview","CLEAR Business Profile","Corporate Filing","Dun & Bradstreet","Worldbase"],"type":"string"},"value":{"allOf":[{"$ref":"#/components/schemas/FirmographicIndustryCode"}],"description":"Industry classification supplied by the source."}},"required":["source","value"],"type":"object"},"SourcedIntegerValue":{"properties":{"as_of":{"description":"Date of the record that supplied the value, in ISO 8601 format. Null where the source states no date, which is always the case for CLEAR Business Overview.","format":"date","nullable":true,"type":"string"},"filing_id":{"description":"Groups the readings that came from the same corporate filing, so a business with several filings can show each one's status, dates and agent together. Set only on Corporate Filing values; null for every other source. Stable within a response, not across responses.","nullable":true,"type":"string"},"note":{"description":"Any further wording the source attached to the figure, such as whether principals are counted in an employee total. Source-verbatim; null when the source added nothing.","nullable":true,"type":"string"},"qualifier":{"description":"How the source derived the figure: ACTUAL (reported), ESTIMATED (approximated by the source), or MODELED (statistically inferred). Only ever set on employee and revenue figures; null everywhere else.","enum":["ACTUAL","ESTIMATED","MODELED",null],"nullable":true,"type":"string"},"source":{"description":"Which record supplied this value. Corporate Filing is a company registry filing; Dun & Bradstreet and Worldbase are commercial business registers; CLEAR Business Profile is aggregated trade and public-record data; CLEAR Business Overview is a combined summary record. Sources are not reconciled \u2014 two sources may disagree on the same field.","enum":["CLEAR Business Overview","CLEAR Business Profile","Corporate Filing","Dun & Bradstreet","Worldbase"],"type":"string"},"value":{"description":"Source-provided whole-number value.","type":"integer"}},"required":["source","value"],"type":"object"},"SourcedMSAValue":{"properties":{"as_of":{"description":"Date of the record that supplied the value, in ISO 8601 format. Null where the source states no date, which is always the case for CLEAR Business Overview.","format":"date","nullable":true,"type":"string"},"filing_id":{"description":"Groups the readings that came from the same corporate filing, so a business with several filings can show each one's status, dates and agent together. Set only on Corporate Filing values; null for every other source. Stable within a response, not across responses.","nullable":true,"type":"string"},"note":{"description":"Any further wording the source attached to the figure, such as whether principals are counted in an employee total. Source-verbatim; null when the source added nothing.","nullable":true,"type":"string"},"qualifier":{"description":"How the source derived the figure: ACTUAL (reported), ESTIMATED (approximated by the source), or MODELED (statistically inferred). Only ever set on employee and revenue figures; null everywhere else.","enum":["ACTUAL","ESTIMATED","MODELED",null],"nullable":true,"type":"string"},"source":{"description":"Which record supplied this value. Corporate Filing is a company registry filing; Dun & Bradstreet and Worldbase are commercial business registers; CLEAR Business Profile is aggregated trade and public-record data; CLEAR Business Overview is a combined summary record. Sources are not reconciled \u2014 two sources may disagree on the same field.","enum":["CLEAR Business Overview","CLEAR Business Profile","Corporate Filing","Dun & Bradstreet","Worldbase"],"type":"string"},"value":{"allOf":[{"$ref":"#/components/schemas/FirmographicMSA"}],"description":"Metropolitan statistical area supplied by the source."}},"required":["source","value"],"type":"object"},"SourcedNationalId":{"description":"A national identifier of the owner.","properties":{"_source":{"description":"Where this value came from.","nullable":true,"type":"string"},"country":{"description":"Issuing country.","type":"string"},"expires_on":{"description":"Expiry date.","format":"date","nullable":true,"type":"string"},"state":{"description":"Issuing state, for a driving licence.","nullable":true,"type":"string"},"type":{"description":"Type of personal identifier. The prefix is the issuing country: `us_ssn` (US Social Security Number), `ca_sin` (Canadian Social Insurance Number), `uk_nino` (UK National Insurance number), `driving_licence` or `passport`.","enum":["us_ssn","ca_sin","uk_nino","driving_licence","passport"]},"value":{"description":"The identifier.","type":"string"}},"type":"object"},"SourcedPersonValue":{"properties":{"as_of":{"description":"Date of the record that supplied the value, in ISO 8601 format. Null where the source states no date, which is always the case for CLEAR Business Overview.","format":"date","nullable":true,"type":"string"},"filing_id":{"description":"Groups the readings that came from the same corporate filing, so a business with several filings can show each one's status, dates and agent together. Set only on Corporate Filing values; null for every other source. Stable within a response, not across responses.","nullable":true,"type":"string"},"note":{"description":"Any further wording the source attached to the figure, such as whether principals are counted in an employee total. Source-verbatim; null when the source added nothing.","nullable":true,"type":"string"},"qualifier":{"description":"How the source derived the figure: ACTUAL (reported), ESTIMATED (approximated by the source), or MODELED (statistically inferred). Only ever set on employee and revenue figures; null everywhere else.","enum":["ACTUAL","ESTIMATED","MODELED",null],"nullable":true,"type":"string"},"source":{"description":"Which record supplied this value. Corporate Filing is a company registry filing; Dun & Bradstreet and Worldbase are commercial business registers; CLEAR Business Profile is aggregated trade and public-record data; CLEAR Business Overview is a combined summary record. Sources are not reconciled \u2014 two sources may disagree on the same field.","enum":["CLEAR Business Overview","CLEAR Business Profile","Corporate Filing","Dun & Bradstreet","Worldbase"],"type":"string"},"value":{"allOf":[{"$ref":"#/components/schemas/FirmographicPerson"}],"description":"Person and role supplied by the source."}},"required":["source","value"],"type":"object"},"SourcedStringValue":{"properties":{"as_of":{"description":"Date of the record that supplied the value, in ISO 8601 format. Null where the source states no date, which is always the case for CLEAR Business Overview.","format":"date","nullable":true,"type":"string"},"filing_id":{"description":"Groups the readings that came from the same corporate filing, so a business with several filings can show each one's status, dates and agent together. Set only on Corporate Filing values; null for every other source. Stable within a response, not across responses.","nullable":true,"type":"string"},"note":{"description":"Any further wording the source attached to the figure, such as whether principals are counted in an employee total. Source-verbatim; null when the source added nothing.","nullable":true,"type":"string"},"qualifier":{"description":"How the source derived the figure: ACTUAL (reported), ESTIMATED (approximated by the source), or MODELED (statistically inferred). Only ever set on employee and revenue figures; null everywhere else.","enum":["ACTUAL","ESTIMATED","MODELED",null],"nullable":true,"type":"string"},"source":{"description":"Which record supplied this value. Corporate Filing is a company registry filing; Dun & Bradstreet and Worldbase are commercial business registers; CLEAR Business Profile is aggregated trade and public-record data; CLEAR Business Overview is a combined summary record. Sources are not reconciled \u2014 two sources may disagree on the same field.","enum":["CLEAR Business Overview","CLEAR Business Profile","Corporate Filing","Dun & Bradstreet","Worldbase"],"type":"string"},"value":{"description":"Source-provided text value.","type":"string"}},"required":["source","value"],"type":"object"},"StandaloneProcessFileSchema":{"properties":{"expected_file_class":{"description":"Expected file classification (e.g., 'bank_statement')","nullable":true,"type":"string"},"file_content_base64":{"description":"Base64 encoded file content","type":"string"},"filename":{"description":"Original filename (helps with MIME type detection)","type":"string"},"reference_id":{"description":"Reference ID for tracking","type":"string"}},"required":["file_content_base64","filename","reference_id"],"type":"object"},"StartEnrichEndUserResponseSchema":{"properties":{"end_user_id":{"type":"integer"},"enricher_name":{"type":"string"}},"required":["end_user_id","enricher_name"],"type":"object"},"StringCheck":{"properties":{"auto_decline":{"default":false,"type":"boolean"},"decline_code":{"description":"The CRM's identifier for this decline reason, e.g. a LendSaas reason id. Left unset, the CRM sync falls back to this check's decline_description.","nullable":true,"type":"string"},"decline_description":{"nullable":true,"type":"string"},"email_template_name":{"nullable":true,"type":"string"},"ignore_metric_availability":{"default":false,"type":"boolean"},"is_mandatory":{"default":false,"type":"boolean"},"match_count":{"nullable":true,"type":"integer"},"on_failure":{"default":"fail","enum":["fail","review_required"]},"on_missing":{"default":"missing_data","description":"What the check reports when it would report missing data: `missing_data` (the default), `fail` or `pass`. A check saved with an older flag (`pass_if_value_missing` on a date-delta check) reads as the setting it stands for. With `ignore_metric_availability` or `pass_if_value_missing` set, only that setting is accepted","enum":["missing_data","fail","pass"]},"pass_description":{"nullable":true,"type":"string"},"transaction_scope":{"allOf":[{"$ref":"#/components/schemas/TransactionScope"}],"nullable":true},"type":{"enum":["equal","not_equal","starts_with","starts_with_any_of","does_not_start_with_any_of","contains","does_not_start_with","does_not_contain","is_in","is_not_in","has_none_of","has_any_of","has_only","has_fewer_than_n_matches","has_more_than_n_matches","is_valid","is_invalid"]},"value":{"description":"The value as a string, or {\"lookup\": {\"table_heron_id\"}} for is_in, is_not_in, has_any_of, has_none_of or has_only to read the list from a lookup table's rows","oneOf":[{"type":"string"},{"$ref":"#/components/schemas/TableList"}]}},"type":"object"},"SubmissionParserExternal":{"properties":{"description":{"type":"string"},"heron_id":{"type":"string"},"name":{"type":"string"},"slug":{"type":"string"}},"type":"object"},"SubmitFunderSubmissionRequestSchema":{"additionalProperties":false,"properties":{"resend":{"default":false,"description":"Resend a settled lane with a successful production attempt. Requires use_sandbox=false.","type":"boolean"},"selected_file_heron_ids":{"items":{"type":"string"},"nullable":true,"type":"array"},"use_sandbox":{"type":"boolean"}},"required":["use_sandbox"],"type":"object"},"SubmitFunderSubmissionResponseSchema":{"additionalProperties":false,"properties":{"submission_heron_id":{"readOnly":true,"type":"string"}},"type":"object"},"SubmittingBroker":{"additionalProperties":false,"properties":{"company":{"nullable":true,"readOnly":true,"type":"string"},"domain":{"nullable":true,"readOnly":true,"type":"string"},"email":{"nullable":true,"readOnly":true,"type":"string"}},"type":"object"},"TableChange":{"properties":{"heron_id":{"type":"string"},"name":{"type":"string"},"previous_version":{"description":"The version the active version uses; null when the table is new","nullable":true,"type":"integer"},"version":{"description":"The version the draft uses; null when the draft drops the table","nullable":true,"type":"integer"}},"required":["heron_id","name","previous_version","version"],"type":"object"},"TableColumn":{"properties":{"lookup":{"$ref":"#/components/schemas/TableColumnReference"}},"required":["lookup"],"type":"object"},"TableColumnReference":{"properties":{"column_id":{"description":"ID of the table column the setting reads","type":"string"},"table_heron_id":{"description":"Heron ID of the lookup table","type":"string"}},"required":["column_id","table_heron_id"],"type":"object"},"TableList":{"properties":{"lookup":{"$ref":"#/components/schemas/TableListReference"}},"required":["lookup"],"type":"object"},"TableListReference":{"properties":{"table_heron_id":{"description":"Heron ID of the lookup table whose row keys are the list","type":"string"}},"required":["table_heron_id"],"type":"object"},"TagPatchSchema":{"properties":{"color":{"description":"Optional display color as a six-digit hex code such as #1a2b3c. Pass null to clear.","nullable":true,"type":"string"},"description":{"description":"Optional human-readable description of the tag. Pass null to clear.","nullable":true,"type":"string"},"name":{"description":"Identifier normalized to lowercase: alphanumeric plus '_', '-', ':', up to 140 chars. Unique to your account (case-insensitive).","type":"string"}},"type":"object"},"TagSchema":{"properties":{"color":{"description":"Optional display color as a six-digit hex code such as #1a2b3c, normalized to lowercase.","nullable":true,"type":"string"},"description":{"description":"Optional human-readable description of the tag.","nullable":true,"type":"string"},"heron_id":{"description":"Unique identifier for the tag","readOnly":true,"type":"string"},"is_system_managed":{"description":"Whether the tag is managed by Heron and cannot be changed through the tag API.","readOnly":true,"type":"boolean"},"name":{"description":"Identifier normalized to lowercase: alphanumeric plus '_', '-', ':', up to 140 chars. Unique to your account (case-insensitive).","type":"string"}},"required":["name"],"type":"object"},"TaxReturn":{"properties":{"balance_sheet_report":{"allOf":[{"$ref":"#/components/schemas/BalanceSheetReport"}],"nullable":true},"ein":{"nullable":true,"type":"string"},"form_name":{"nullable":true,"type":"string"},"page_indexes":{"items":{"type":"integer"},"nullable":true,"type":"array"},"pnl_report":{"allOf":[{"$ref":"#/components/schemas/PnlReport"}],"nullable":true},"taxpayer_name":{"nullable":true,"type":"string"}},"type":"object"},"TaxReturnsSchema":{"properties":{"annual_revenue":{"nullable":true,"type":"number"},"business_name":{"nullable":true,"type":"string"},"ein":{"nullable":true,"type":"string"},"tax_returns":{"items":{"$ref":"#/components/schemas/TaxReturn"},"nullable":true,"type":"array"}},"type":"object"},"Transaction":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"nullable":true,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"balance":{"description":"The running balance of the account after transaction ocurred","example":423.0,"nullable":true,"type":"number"},"categories_default":{"description":"Category of transaction that you may have received from other sources","example":"shopping","nullable":true,"type":"string","writeOnly":true},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"date":{"description":"The date of the transaction; 'timestamp' field takes priority over 'date'","example":"2020-04-27","format":"date","nullable":true,"type":"string","writeOnly":true},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"end_user_id":{"description":"Your unique ID for end user associated with transaction","example":"my_best_customer_203948","maxLength":140,"nullable":true,"type":"string"},"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"mcc_code":{"description":"Merchant category code associated with transaction that you may have received from other sources","nullable":true,"pattern":"^\\d{4}$","type":"string","writeOnly":true},"order":{"description":"If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction","nullable":true,"type":"integer","writeOnly":true},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"nullable":true,"type":"string"},"request_id":{"description":"ID associated with request, e.g., all transactions in same POST request will have same request_id","example":"req_gFci32BgPmpjCF8coABckV","nullable":true,"readOnly":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"},"transaction_code":{"description":"Code associated with transaction to indicate the type of transaction","example":"card","maxLength":140,"nullable":true,"type":"string"}},"required":["amount","description"],"type":"object"},"Transaction1":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"nullable":true,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"balance":{"description":"The running balance of the account after transaction ocurred","example":423.0,"nullable":true,"type":"number"},"categories_default":{"description":"Category of transaction that you may have received from other sources","example":"shopping","nullable":true,"type":"string","writeOnly":true},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"date":{"description":"The date of the transaction; 'timestamp' field takes priority over 'date'","example":"2020-04-27","format":"date","nullable":true,"type":"string","writeOnly":true},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"end_user_id":{"description":"Your unique ID for end user associated with transaction","example":"my_best_customer_203948","maxLength":140,"nullable":true,"type":"string"},"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"mcc_code":{"description":"Merchant category code associated with transaction that you may have received from other sources","nullable":true,"pattern":"^\\d{4}$","type":"string","writeOnly":true},"order":{"description":"If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction","nullable":true,"type":"integer","writeOnly":true},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"nullable":true,"type":"string"},"request_id":{"description":"ID associated with request, e.g., all transactions in same POST request will have same request_id","example":"req_gFci32BgPmpjCF8coABckV","nullable":true,"readOnly":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"},"transaction_code":{"description":"Code associated with transaction to indicate the type of transaction","example":"card","maxLength":140,"nullable":true,"type":"string"}},"required":["amount","description"],"type":"object"},"Transaction2":{"properties":{"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"nullable":true,"type":"string"}},"type":"object"},"Transaction3":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"nullable":true,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"}},"required":["amount","description"],"type":"object"},"TransactionAnnotation":{"properties":{"annotator":{"description":"Annotator type","example":"predicted","type":"string"},"confidence":{"description":"The confidence associated with the category annotation","example":0.5,"nullable":true,"type":"number"},"heron_id":{"description":"Unique ID of category; generated by Heron Data","example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","type":"string"},"label":{"description":"Label of category","example":"Rent","type":"string"},"model_version":{"description":"The model version that produced the categorisation","example":"7cb48787-6d91-5b9f-bc60-f30298ea5736","nullable":true,"type":"string"}},"type":"object"},"TransactionDeleteReference":{"properties":{"transactions":{"description":"list of transactions (only ids) that have been deleted","items":{"$ref":"#/components/schemas/Transaction2"},"type":"array"}},"type":"object"},"TransactionDeleteWebhook":{"properties":{"created":{"description":"time webhook was sent","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"data":{"allOf":[{"$ref":"#/components/schemas/TransactionDeleteReference"}],"description":"payload of the webhook"},"meta":{"additionalProperties":{},"description":"meta information about the webhook","type":"object"},"topic":{"description":"topic of webhook","example":"transactions.deleted","type":"string"}},"type":"object"},"TransactionEnriched":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"nullable":true,"type":"string"},"account_number":{"description":"The account number of the data source account associated with the transaction","example":"1234567890","nullable":true,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"annotation":{"allOf":[{"$ref":"#/components/schemas/Annotation"}],"description":"The category annotation associated with the transaction"},"balance":{"description":"The running balance of the account after transaction ocurred","example":423.0,"nullable":true,"type":"number"},"categories_default":{"description":"Category of transaction that you may have received from other sources","example":"shopping","nullable":true,"type":"string","writeOnly":true},"counterparty":{"description":"The counterparty associated with the transaction, if available","example":"GOOGLE","nullable":true,"type":"string"},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"data_source_account_heron_id":{"description":"The heron ID of the data source account associated with the transaction","example":"dsa_8Wezdyj8LMyX4pv7bLzJ2f","nullable":true,"type":"string"},"data_source_heron_id":{"description":"The heron ID of the data source associated with the transaction","example":"dso_StvEAbtRd2LLU6n8LjQDwS","nullable":true,"type":"string"},"date":{"description":"The date of the transaction; 'timestamp' field takes priority over 'date'","example":"2020-04-27","format":"date","nullable":true,"type":"string","writeOnly":true},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"end_user_id":{"description":"Your unique ID for end user associated with transaction","example":"my_best_customer_203948","maxLength":140,"nullable":true,"type":"string"},"features":{"allOf":[{"$ref":"#/components/schemas/TransactionFeatures"}],"description":"Features calculated from transaction"},"file_class":{"description":"Class of the file this transaction was loaded from, such as `bank_statement` or `month_to_date`. Null when there is no file.","example":"bank_statement","nullable":true,"type":"string"},"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"last_updated":{"description":"When the transaction was last updated, either by updating its enrichments or the values of the transaction itself","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"mcc_code":{"description":"Merchant category code associated with transaction that you may have received from other sources","nullable":true,"pattern":"^\\d{4}$","type":"string","writeOnly":true},"merchant":{"allOf":[{"$ref":"#/components/schemas/Merchant"}],"description":"The merchant associated with the transaction"},"order":{"description":"If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction","nullable":true,"type":"integer","writeOnly":true},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"nullable":true,"type":"string"},"request_id":{"description":"ID associated with request, e.g., all transactions in same POST request will have same request_id","example":"req_gFci32BgPmpjCF8coABckV","nullable":true,"readOnly":true,"type":"string"},"statement_reconciliation_method":{"description":"How the file's verdict was set: `start_and_end_balance`, `running_balance`, `summary_derived`, `total_debits_credits` or `zero_balances` for an automatic check; `human` for a reviewer. Null when no method decided it, including `not_possible` files, or when there is no file.","enum":["start_and_end_balance","summary_derived","running_balance","total_debits_credits","zero_balances","human",null],"nullable":true},"statement_reconciliation_status":{"description":"Whether the file this transaction was loaded from reconciled. `reconciled`: a check passed or a reviewer confirmed it. `not_possible`: nothing on the file to check against. `failed`: a check did not match, or a reviewer ruled it unreconciled. A `failed` file can still load transactions: when unreconciled transaction loading is on, or after a reviewer approves it. Null when there is no file (bank connection, API-posted or legacy source), when the file is still processing, or when it was parsed before 14 Aug 2026.","enum":["failed","not_possible","reconciled",null],"nullable":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"},"transaction_code":{"description":"Code associated with transaction to indicate the type of transaction","example":"card","maxLength":140,"nullable":true,"type":"string"}},"required":["amount","description"],"type":"object"},"TransactionFeatures":{"properties":{"description_clean":{"description":"The cleaned description of the transaction","example":"GOOGLE ADS","nullable":true,"type":"string"},"duplicate_of_id":{"description":"Indicates that the transaction is a duplicate and gives the heron_id of the original","example":"txn_9oPspuxisSVyboAqnR2L4Q"},"has_matching_transaction":{"description":"Whether the transaction is a transfer; requires end_user_id and timestamp to be present","nullable":true,"type":"boolean"},"is_payment_processing":{"description":"Whether enrichment matched a payment-processing heuristic while the active category was in the revenue analytics group. False can also mean the transaction has not been evaluated.","readOnly":true,"type":"boolean"},"is_potential_duplicate":{"description":"Indicates whether the transaction has another transaction similar to it","nullable":true,"readOnly":true,"type":"boolean"},"is_recurring":{"description":"Whether the transaction is recurring or not; requires end_user_id and timestamp to be present","nullable":true,"type":"boolean"}},"type":"object"},"TransactionFeedbackParams":{"properties":{"trigger_webhook":{"default":true,"description":"If true, enables the triggering of transaction_updated webhook. Set to false to suppress trigger. Default true","type":"boolean"}},"type":"object"},"TransactionFeedbackResult":{"properties":{"category":{"description":"The new category, or an empty object when the feedback had none","oneOf":[{"$ref":"#/components/schemas/Category"},{"maxProperties":0,"type":"object"}]},"merchant":{"anyOf":[{"$ref":"#/components/schemas/Merchant"},{"$ref":"#/components/schemas/MerchantFeedback"}],"description":"The new merchant, else the merchant feedback as sent, else null","nullable":true}},"type":"object"},"TransactionFeedbackSchema":{"properties":{"category":{"allOf":[{"$ref":"#/components/schemas/CategoryFeedback"}],"default":{},"example":{"heron_id":"ctg_94bwS4hp5ZQkyi9kBNkqn8","label":"Insurance"}},"merchant":{"allOf":[{"$ref":"#/components/schemas/MerchantFeedback"}],"default":{},"example":{"heron_id":"mrc_8bYsSyAMW6LGsGFZi8GF9F","is_correct":false,"name":"Spotify"}},"source":{"description":"your identifier for where the feedback comes from e.g. bob_the_underwriter","maxLength":120,"nullable":true,"type":"string"}},"type":"object"},"TransactionGetOutput":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"nullable":true,"type":"string"},"account_number":{"description":"The account number associated with the transaction","example":"1234567890","nullable":true,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"balance":{"description":"The running balance of the account after transaction ocurred","example":423.0,"nullable":true,"type":"number"},"categories":{"description":"The category associated with the transaction","items":{"$ref":"#/components/schemas/TransactionAnnotation"},"type":"array"},"counterparty":{"description":"The counterparty associated with the transaction, if available","example":"GOOGLE","nullable":true,"type":"string"},"created":{"description":"When transaction was created in Heron system","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"data_source_account_heron_id":{"description":"Unique ID of the transaction's data source account","example":"dsa_8Wezdyj8LMyX4pv7bLzJ2f","nullable":true,"readOnly":true,"type":"string"},"data_source_heron_id":{"description":"Unique ID of the transaction's data source","example":"dso_StvEAbtRd2LLU6n8LjQDwS","nullable":true,"readOnly":true,"type":"string"},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"description_clean":{"description":"The cleaned description of the transaction","example":"GOOGLE ADS","nullable":true,"type":"string"},"duplicate_of_id":{"description":"Indicates that the transaction is a duplicate and gives the heron_id of the original","example":"txn_9oPspuxisSVyboAqnR2L4Q"},"end_user_id":{"description":"Your unique ID for end user associated with transaction","example":"my_best_customer_203948","maxLength":140,"nullable":true,"type":"string"},"file_class":{"description":"Class of the file this transaction was loaded from, such as `bank_statement` or `month_to_date`. Null when there is no file.","example":"bank_statement","nullable":true,"type":"string"},"has_matching_transaction":{"description":"Whether the transaction is a transfer; requires end_user_id and timestamp to be present","nullable":true,"type":"boolean"},"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"is_payment_processing":{"description":"Whether enrichment matched a payment-processing heuristic while the active category was in the revenue analytics group. False can also mean the transaction has not been evaluated.","readOnly":true,"type":"boolean"},"is_potential_duplicate":{"description":"Indicates whether the transaction has another transaction similar to it","nullable":true,"readOnly":true,"type":"boolean"},"is_recurring":{"description":"Whether the transaction is recurring or not; requires end_user_id and timestamp to be present","nullable":true,"type":"boolean"},"last_updated":{"description":"When transaction was last updated in Heron system; could be from recategorisation or attribute updates","example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"},"mcc_code":{"description":"Merchant category code associated with transaction that you may have received from other sources","nullable":true,"pattern":"^\\d{4}$","type":"string","writeOnly":true},"merchant":{"allOf":[{"$ref":"#/components/schemas/Merchant"}],"description":"The merchant associated with the transaction"},"order":{"description":"If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction","nullable":true,"type":"integer","writeOnly":true},"payment_processor":{"allOf":[{"$ref":"#/components/schemas/PaymentProcessor"}],"description":"The payment processor associated with the transaction"},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"nullable":true,"type":"string"},"request_id":{"description":"ID associated with request, e.g., all transactions in same POST request will have same request_id","example":"req_gFci32BgPmpjCF8coABckV","nullable":true,"readOnly":true,"type":"string"},"statement_reconciliation_method":{"description":"How the file's verdict was set: `start_and_end_balance`, `running_balance`, `summary_derived`, `total_debits_credits` or `zero_balances` for an automatic check; `human` for a reviewer. Null when no method decided it, including `not_possible` files, or when there is no file.","enum":["start_and_end_balance","summary_derived","running_balance","total_debits_credits","zero_balances","human",null],"nullable":true},"statement_reconciliation_status":{"description":"Whether the file this transaction was loaded from reconciled. `reconciled`: a check passed or a reviewer confirmed it. `not_possible`: nothing on the file to check against. `failed`: a check did not match, or a reviewer ruled it unreconciled. A `failed` file can still load transactions: when unreconciled transaction loading is on, or after a reviewer approves it. Null when there is no file (bank connection, API-posted or legacy source), when the file is still processing, or when it was parsed before 14 Aug 2026.","enum":["failed","not_possible","reconciled",null],"nullable":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"},"transaction_code":{"description":"Code associated with transaction to indicate the type of transaction","example":"card","maxLength":140,"nullable":true,"type":"string"}},"required":["amount","description"],"type":"object"},"TransactionPartialSchema":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"nullable":true,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"balance":{"description":"The running balance of the account after transaction ocurred","example":423.0,"nullable":true,"type":"number"},"categories_default":{"description":"Category of transaction that you may have received from other sources","example":"shopping","nullable":true,"type":"string","writeOnly":true},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"date":{"description":"The date of the transaction; 'timestamp' field takes priority over 'date'","example":"2020-04-27","format":"date","nullable":true,"type":"string","writeOnly":true},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"end_user_id":{"description":"Your unique ID for end user associated with transaction","example":"my_best_customer_203948","maxLength":140,"nullable":true,"type":"string"},"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"mcc_code":{"description":"Merchant category code associated with transaction that you may have received from other sources","nullable":true,"pattern":"^\\d{4}$","type":"string","writeOnly":true},"order":{"description":"If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction","nullable":true,"type":"integer","writeOnly":true},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"nullable":true,"type":"string"},"request_id":{"description":"ID associated with request, e.g., all transactions in same POST request will have same request_id","example":"req_gFci32BgPmpjCF8coABckV","nullable":true,"readOnly":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"},"transaction_code":{"description":"Code associated with transaction to indicate the type of transaction","example":"card","maxLength":140,"nullable":true,"type":"string"}},"type":"object"},"TransactionPostAsync":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"balance":{"description":"The running balance of the account after transaction ocurred","example":423.0,"nullable":true,"type":"number"},"categories_default":{"description":"Category of transaction that you may have received from other sources","example":"shopping","nullable":true,"type":"string","writeOnly":true},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"type":"string"},"date":{"description":"The date of the transaction; 'timestamp' field takes priority over 'date'","example":"2020-04-27","format":"date","nullable":true,"type":"string","writeOnly":true},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"end_user_id":{"description":"Your unique ID for end user associated with transaction","example":"my_best_customer_203948","maxLength":140,"type":"string"},"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"mcc_code":{"description":"Merchant category code associated with transaction that you may have received from other sources","nullable":true,"pattern":"^\\d{4}$","type":"string","writeOnly":true},"order":{"description":"If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction","nullable":true,"type":"integer","writeOnly":true},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"type":"string"},"request_id":{"description":"ID associated with request, e.g., all transactions in same POST request will have same request_id","example":"req_gFci32BgPmpjCF8coABckV","nullable":true,"readOnly":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"},"transaction_code":{"description":"Code associated with transaction to indicate the type of transaction","example":"card","maxLength":140,"nullable":true,"type":"string"}},"required":["account_id","amount","currency","description","end_user_id","reference_id"],"type":"object"},"TransactionPostOutput":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"nullable":true,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"balance":{"description":"The running balance of the account after transaction ocurred","example":423.0,"nullable":true,"type":"number"},"categories":{"description":"The category associated with the transaction","items":{"$ref":"#/components/schemas/TransactionAnnotation"},"type":"array"},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"description_clean":{"description":"The cleaned description of the transaction","example":"GOOGLE ADS","nullable":true,"type":"string"},"duplicate_of_id":{"description":"Indicates that the transaction is a duplicate and gives the heron_id of the original","example":"txn_9oPspuxisSVyboAqnR2L4Q"},"end_user_id":{"description":"Your unique ID for end user associated with transaction","example":"my_best_customer_203948","maxLength":140,"nullable":true,"type":"string"},"has_matching_transaction":{"description":"Whether the transaction is a transfer; requires end_user_id and timestamp to be present","nullable":true,"type":"boolean"},"is_payment_processing":{"description":"Whether enrichment matched a payment-processing heuristic while the active category was in the revenue analytics group. False can also mean the transaction has not been evaluated.","readOnly":true,"type":"boolean"},"is_potential_duplicate":{"description":"Indicates whether the transaction has another transaction similar to it","nullable":true,"readOnly":true,"type":"boolean"},"is_recurring":{"description":"Whether the transaction is recurring or not; requires end_user_id and timestamp to be present","nullable":true,"type":"boolean"},"mcc_code":{"description":"Merchant category code associated with transaction that you may have received from other sources","nullable":true,"pattern":"^\\d{4}$","type":"string","writeOnly":true},"merchant":{"allOf":[{"$ref":"#/components/schemas/Merchant"}],"description":"The merchant associated with the transaction"},"order":{"description":"If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction","nullable":true,"type":"integer","writeOnly":true},"payment_processor":{"allOf":[{"$ref":"#/components/schemas/PaymentProcessor"}],"description":"The payment processor associated with the transaction"},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"nullable":true,"type":"string"},"request_id":{"description":"ID associated with request, e.g., all transactions in same POST request will have same request_id","example":"req_gFci32BgPmpjCF8coABckV","nullable":true,"readOnly":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"},"transaction_code":{"description":"Code associated with transaction to indicate the type of transaction","example":"card","maxLength":140,"nullable":true,"type":"string"}},"required":["amount","description"],"type":"object"},"TransactionScope":{"properties":{"file_classes":{"items":{"type":"string"},"nullable":true,"type":"array"},"min_reconciliation_status":{"enum":["failed","not_possible","reconciled",null],"nullable":true,"type":"string"}},"type":"object"},"TransactionUserPostSyncAsyncOutput":{"properties":{"account_id":{"description":"Your unique ID for account associated with transaction","example":"checking_account_202348","maxLength":400,"nullable":true,"type":"string"},"amount":{"description":"Amount. Inflows to an account should be positive, and outflows from an account should be negative. If using Plaid, please flip the amount sign for all transactions.","example":-42.42,"type":"number"},"balance":{"description":"The running balance of the account after transaction ocurred","example":423.0,"nullable":true,"type":"number"},"categories":{"description":"The category associated with the transaction","items":{"$ref":"#/components/schemas/TransactionAnnotation"},"type":"array"},"currency":{"description":"ISO 4217 currency code","example":"USD","maxLength":3,"minLength":3,"nullable":true,"type":"string"},"description":{"description":"The text description for the transaction","example":"GOOGLE *ADS12340929 cc@google.com US","type":"string"},"description_clean":{"description":"The cleaned description of the transaction","example":"GOOGLE ADS","nullable":true,"type":"string"},"duplicate_of_id":{"description":"Indicates that the transaction is a duplicate and gives the heron_id of the original","example":"txn_9oPspuxisSVyboAqnR2L4Q"},"end_user_id":{"description":"Your unique ID for end user associated with transaction","example":"my_best_customer_203948","maxLength":140,"nullable":true,"type":"string"},"has_matching_transaction":{"description":"Whether the transaction is a transfer; requires end_user_id and timestamp to be present","nullable":true,"type":"boolean"},"heron_id":{"description":"Unique ID of transaction; generated by Heron Data","example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"readOnly":true,"type":"string"},"is_payment_processing":{"description":"Whether enrichment matched a payment-processing heuristic while the active category was in the revenue analytics group. False can also mean the transaction has not been evaluated.","readOnly":true,"type":"boolean"},"is_potential_duplicate":{"description":"Indicates whether the transaction has another transaction similar to it","nullable":true,"readOnly":true,"type":"boolean"},"is_recurring":{"description":"Whether the transaction is recurring or not; requires end_user_id and timestamp to be present","nullable":true,"type":"boolean"},"mcc_code":{"description":"Merchant category code associated with transaction that you may have received from other sources","nullable":true,"pattern":"^\\d{4}$","type":"string","writeOnly":true},"merchant":{"allOf":[{"$ref":"#/components/schemas/Merchant"}],"description":"The merchant associated with the transaction"},"order":{"description":"If sending a batch of transactions, the order in which the transaction occurs, where a higher value is equivalent to a more recent transaction","nullable":true,"type":"integer","writeOnly":true},"payment_processor":{"allOf":[{"$ref":"#/components/schemas/PaymentProcessor"}],"description":"The payment processor associated with the transaction"},"reference_id":{"description":"Your unique ID for transaction","example":"my_favourite_transaction_231098","maxLength":140,"minLength":1,"nullable":true,"type":"string"},"request_id":{"description":"ID associated with request, e.g., all transactions in same POST request will have same request_id","example":"req_gFci32BgPmpjCF8coABckV","nullable":true,"readOnly":true,"type":"string"},"timestamp":{"description":"The ISO 8601 timezone aware timestamp of the transaction; takes precedence over 'date'","example":"2021-11-12T10:38:05Z","format":"date-time","nullable":true,"type":"string"},"transaction_code":{"description":"Code associated with transaction to indicate the type of transaction","example":"card","maxLength":140,"nullable":true,"type":"string"}},"required":["amount","description"],"type":"object"},"TransactionsPostAsyncSchema":{"properties":{"balances":{"description":"Bank account balance information for a particular account_id. The balance here must be the *latest balance* after all the transactions in this batch have been applied.","items":{"$ref":"#/components/schemas/AccountBalance1"},"nullable":true,"type":"array"},"transactions":{"items":{"$ref":"#/components/schemas/TransactionPostAsync"},"minItems":1,"type":"array"}},"required":["transactions"],"type":"object"},"TransactionsPostCreatedResponse":{"properties":{"_summary":{"$ref":"#/components/schemas/TransactionsPostSummary"},"transactions":{"description":"only returned for combined sync and async enrichment requests","items":{"$ref":"#/components/schemas/TransactionUserPostSyncAsyncOutput"},"type":"array"}},"type":"object"},"TransactionsPostSummary":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"},"task_id":{"type":"string"},"transactions_categorised":{"type":"integer"},"transactions_loaded":{"type":"integer"}},"type":"object"},"TransactionsPostSyncResponse":{"properties":{"_summary":{"$ref":"#/components/schemas/TransactionsPostSummary"},"transactions":{"description":"only returned for sync enrichment requests","items":{"$ref":"#/components/schemas/TransactionPostOutput"},"type":"array"}},"type":"object"},"TransactionsPostSyncSchema":{"properties":{"transactions":{"items":{"$ref":"#/components/schemas/Transaction1"},"minItems":1,"type":"array"}},"required":["transactions"],"type":"object"},"TriggerTestRequestSchema":{"properties":{"environment":{"default":"staging","enum":["staging","production"]}},"type":"object"},"TriggerTestResponseSchema":{"properties":{"funder_submission_heron_id":{"type":"string"}},"required":["funder_submission_heron_id"],"type":"object"},"UCCFilingEntrySchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"collateral_description":{"description":"Collateral description on the filing.","nullable":true,"type":"string"},"collateral_descriptions":{"description":"Collateral descriptions across the filing chain.","items":{"type":"string"},"type":"array"},"debtor_address":{"description":"Address of the debtor.","nullable":true,"type":"string"},"debtor_name":{"description":"Debtor named on the filing.","nullable":true,"type":"string"},"expire_date":{"description":"Filing lapse date; null when unavailable.","format":"date","nullable":true,"type":"string"},"file_date":{"description":"Filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"filing_number":{"description":"Filing reference number.","nullable":true,"type":"string"},"filing_office_name":{"description":"Office where the filing was recorded.","nullable":true,"type":"string"},"filing_state":{"description":"State where the filing was recorded.","nullable":true,"type":"string"},"filing_type":{"description":"Filing type, such as FINANCING STATEMENT, CONTINUATION, or TERMINATION.","nullable":true,"type":"string"},"in_recent_cluster":{"description":"True when the filing is among at least three new UCC liens in the last six months.","type":"boolean"},"is_recent":{"description":"True when the filing originated recently.","type":"boolean"},"original_file_number_full":{"description":"Full reference for the original filing in the chain.","nullable":true,"type":"string"},"record_type":{"description":"Source-provided record class.","nullable":true,"type":"string"},"reference_file_number":{"description":"Reference linking this row to the original filing in the chain.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"secured_party_address":{"description":"Address of the secured party.","nullable":true,"type":"string"},"secured_party_name":{"description":"Name of the secured party.","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source_entry_id":{"description":"Stable reference for the underlying source row; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"UCCRecordSchema":{"description":"A background-check finding. Risk and severity carry the same none, low, medium, or high tier.","properties":{"collateral_description":{"description":"Collateral description on the filing.","nullable":true,"type":"string"},"collateral_descriptions":{"description":"Collateral descriptions across the filing chain.","items":{"type":"string"},"type":"array"},"debtor_address":{"description":"Address of the debtor.","nullable":true,"type":"string"},"debtor_name":{"description":"Debtor named on the filing.","nullable":true,"type":"string"},"detail":{"allOf":[{"$ref":"#/components/schemas/BackgroundCheckRecordDetail"}],"description":"Only populated when include_section_detail=true is passed on the request","nullable":true},"entry_count":{"description":"Number of underlying source entries combined into this record.","type":"integer"},"expire_date":{"description":"Filing lapse date; null when unavailable.","format":"date","nullable":true,"type":"string"},"file_date":{"description":"Filing date; null when unavailable.","format":"date","nullable":true,"type":"string"},"filing_number":{"description":"Filing reference number.","nullable":true,"type":"string"},"filing_office_name":{"description":"Office where the filing was recorded.","nullable":true,"type":"string"},"filing_state":{"description":"State where the filing was recorded.","nullable":true,"type":"string"},"filing_type":{"description":"Filing type, such as FINANCING STATEMENT, CONTINUATION, or TERMINATION.","nullable":true,"type":"string"},"in_recent_cluster":{"description":"True when the filing is among at least three new UCC liens in the last six months.","type":"boolean"},"is_active":{"description":"True when the filing chain is active.","type":"boolean"},"is_recent":{"description":"True when the filing originated recently.","type":"boolean"},"is_terminated":{"description":"True when the filing chain is terminated.","type":"boolean"},"original_file_number_full":{"description":"Full reference for the original filing in the chain.","nullable":true,"type":"string"},"record_type":{"description":"Source-provided record class.","nullable":true,"type":"string"},"reference_file_number":{"description":"Reference linking this row to the original filing in the chain.","nullable":true,"type":"string"},"risk":{"description":"Record risk tier.","enum":["none","low","medium","high"]},"secured_party_address":{"description":"Address of the secured party.","nullable":true,"type":"string"},"secured_party_name":{"description":"Name of the secured party.","nullable":true,"type":"string"},"severity":{"description":"Record severity tier, mirroring risk.","readOnly":true},"source_entries":{"description":"Underlying source rows combined into this record.","items":{"$ref":"#/components/schemas/UCCFilingEntrySchema"},"type":"array"},"source_entry_ids":{"description":"References for the underlying source rows combined into this record.","items":{"type":"string"},"type":"array"},"status":{"description":"UCC filing-chain status: active, terminated, expired, or unknown.","enum":["active","terminated","expired","unknown"]}},"type":"object"},"UpdateEndUserEntityAttributeSchema":{"properties":{"attribute_description":{"type":"string"},"attribute_name":{"type":"string"},"attribute_type":{"enum":["float","int","decimal","string","date","datetime","bool"]},"is_dedupe_key":{"type":"boolean"},"reconciliation_config":{"additionalProperties":{},"type":"object"},"reconciliation_strategy":{"enum":["sort_order","llm","comparison","concatenate_lists"]}},"type":"object"},"UpdateEndUserEntityAttributeSourceSchema":{"properties":{"sort_order":{"type":"integer"},"source_config":{"additionalProperties":{},"type":"object"},"source_type":{"enum":["parsed_end_user_file","api","rel_6","end_user_enricher","company_attribute","static_value","end_user_query","broker_submission_api","crm"]}},"type":"object"},"UpdateEndUserEntitySchema":{"properties":{"display_order":{"type":"integer"},"entity_description":{"type":"string"},"entity_name":{"type":"string"},"entity_post_processor_configs":{"items":{"additionalProperties":{},"type":"object"},"type":"array"},"is_list":{"type":"boolean"},"saved_query_heron_id":{"nullable":true,"type":"string"}},"type":"object"},"UpdateFileRenameRuleSchema":{"properties":{"file_name_template":{"type":"string"},"is_enabled":{"type":"boolean"},"variables":{"default":[],"items":{"$ref":"#/components/schemas/VariableDefinition"},"type":"array"}},"required":["file_name_template","is_enabled"],"type":"object"},"UpdateFunderIntegrationRequestSchema":{"properties":{"channel":{"enum":["integration","email",null],"nullable":true},"submission_cc_email_addresses":{"items":{"type":"string"},"nullable":true,"type":"array"},"submission_email_address":{"nullable":true,"type":"string"},"submission_email_subject_prefix":{"nullable":true,"type":"string"}},"type":"object"},"UpdateParsedResultSchema":{"properties":{"json_patch_operations":{"description":"List of HITL corrections to apply","items":{"$ref":"#/components/schemas/JsonPatch"},"type":"array"},"json_result":{"additionalProperties":{},"description":"Complete replacement result object","nullable":true,"type":"object"}},"type":"object"},"UpsertEndUserEntityAttributeValueSchema":{"properties":{"attribute_heron_id":{"type":"string"},"source_heron_id":{"type":"string"},"value":{"nullable":true}},"required":["attribute_heron_id","source_heron_id","value"],"type":"object"},"UpsertFunderSubmissionRequestSchema":{"additionalProperties":false,"properties":{"end_user_heron_id":{"type":"string"},"funder_heron_id":{"type":"string"}},"required":["end_user_heron_id","funder_heron_id"],"type":"object"},"User":{"properties":{"alias":{"type":"string"},"available_deal_stages":{"description":"Deal stages this tenant's pipeline can produce; empty for non-broker use cases.","items":{"enum":["ready","missing_docs","shopped","offers_in","funded","closed"]},"readOnly":true,"type":"array"},"created":{"format":"date-time","readOnly":true,"type":"string"},"email":{"type":"string"},"environment":{"enum":["dev","prod","internal"],"type":"string"},"id":{"readOnly":true,"type":"integer"},"is_active":{"default":true,"type":"boolean"},"is_self_sign_up":{"nullable":true,"type":"boolean"},"last_updated":{"format":"date-time","readOnly":true,"type":"string"},"organization_id":{"type":"integer"},"password":{"type":"string"},"profit_and_loss_layout":{"nullable":true},"settings":{"$ref":"#/components/schemas/UserSettings"},"username":{"type":"string"}},"required":["email","id","organization_id","username"],"type":"object"},"UserLogoBase64Schema":{"properties":{"file_b64":{"description":"Base64 encoded logo file","type":"string"},"mime_type":{"description":"MIME type of the logo file","type":"string"}},"type":"object"},"UserLogoFileSchema":{"properties":{"filename":{"type":"string"},"user_id":{"type":"string"}},"type":"object"},"UserLogoUploadSchema":{"properties":{"file_base64":{"description":"Base64 encoded file bytes","type":"string"},"filename":{"description":"Name of file","type":"string"}},"required":["file_base64","filename"],"type":"object"},"UserMerchantGroupSchema":{"properties":{"group_id":{"nullable":true,"type":"string"},"merchant_heron_id":{"type":"string"},"merchant_name":{"type":"string"}},"required":["merchant_heron_id","merchant_name"],"type":"object"},"UserMerchantGroupsSchema":{"properties":{"custom_merchants":{"default":[],"items":{"$ref":"#/components/schemas/UserMerchantGroupSchema"},"type":"array"},"pending_merchants":{"default":[],"items":{"$ref":"#/components/schemas/UserMerchantGroupSchema"},"type":"array"},"rejected_merchants":{"default":[],"items":{"$ref":"#/components/schemas/UserMerchantGroupSchema"},"type":"array"}},"type":"object"},"UserModifiableSettings":{"properties":{"balance_sheet_categories":{"$ref":"#/components/schemas/BalanceSheetCategories"},"bank_statement_summary_columns":{"items":{"type":"string"},"nullable":true,"type":"array"},"disable_data_export":{"type":"boolean"},"financials_metrics":{"additionalProperties":{"$ref":"#/components/schemas/MetricSpec"},"type":"object"},"funder_submission_email_fields":{"$ref":"#/components/schemas/FunderSubmissionEmailFieldSettings"},"industry_naics_enabled":{"type":"boolean"},"low_balance_days_threshold":{"type":"number"},"pnl_categories":{"$ref":"#/components/schemas/PnLCategories"},"query_reports":{"items":{"$ref":"#/components/schemas/QueryReportTabGroup"},"type":"array"},"required_revenue_per_month":{"type":"integer"},"restricted_industries":{"items":{"$ref":"#/components/schemas/RestrictedIndustry"},"type":"array"},"transactions_review_enabled":{"type":"boolean"},"use_new_company_layout":{"type":"boolean"},"use_new_end_user_summary_table":{"type":"boolean"},"use_new_end_user_table":{"type":"boolean"}},"type":"object"},"UserSettings":{"properties":{"annotations":{"$ref":"#/components/schemas/AnnotationSettings"},"api_version":{"type":"string"},"cache_global_enrich":{"type":"boolean"},"currency_iso_code":{"enum":["GBP","USD","EUR","CAD","AUD"],"type":"string"},"data_retention_days":{"minimum":1,"nullable":true,"type":"integer"},"data_retention_turned_on":{"type":"boolean"},"email_domains":{"items":{"type":"string"},"type":"array"},"enabled_enrichers":{"items":{"type":"string"},"type":"array"},"end_user_entities":{"$ref":"#/components/schemas/EndUserEntitiesSettings"},"end_user_query_static_csvs":{"additionalProperties":{"type":"string"},"description":"Static CSV configurations for end user queries. Dict mapping table_name to gcs_path.","type":"object"},"enrich_global_ttl_days":{"minimum":1,"type":"integer"},"enricher_inputs_mapping":{"additionalProperties":{},"description":"Mapping of enricher names to input field names. Used to map LLM enricher inputs to end user fields.","type":"object"},"features":{"$ref":"#/components/schemas/FeatureSettings"},"files":{"$ref":"#/components/schemas/FileSettings"},"formatting":{"additionalProperties":{"items":{"$ref":"#/components/schemas/FormattingStep"},"type":"array"},"type":"object"},"high_priority_async_slots":{"type":"integer"},"inbound_emails":{"$ref":"#/components/schemas/InboundEmailSettings"},"include_in_analytics":{"type":"boolean"},"ip_whitelist":{"items":{"type":"string"},"nullable":true,"type":"array"},"is_priority_async":{"type":"boolean"},"legacy_data_sources":{"type":"boolean"},"modifiable":{"$ref":"#/components/schemas/ModifiableSettings"},"outbound_emails":{"$ref":"#/components/schemas/OutboundEmailSettings"},"pdf":{"$ref":"#/components/schemas/PdfSettings"},"plaid":{"$ref":"#/components/schemas/PlaidSettings"},"rate_limit":{"pattern":"^[0-9]{1,4}/minute$","type":"string"},"restrict_api_keys_in_dashboard":{"type":"boolean"},"restrict_downloading_data":{"type":"boolean"},"scorecard":{"$ref":"#/components/schemas/ScorecardSettings"},"slack_channel_id":{"nullable":true,"pattern":"^[CG][A-Z0-9]+(?![\\s\\S])","type":"string"},"sync_async_enrich":{"type":"boolean"},"sync_enrich":{"type":"boolean"},"use_case_type":{"enum":["iso_underwriting","non_iso_underwriting","commercial_insurance","commercial_law","equipment_finance","broker","other"],"type":"string"},"use_ses_outbound":{"type":"boolean"}},"type":"object"},"UserWorkflowSchema":{"properties":{"alerts_muted_until":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"dashboard_trigger_enabled":{"readOnly":true,"type":"boolean"},"dashboard_trigger_label":{"nullable":true,"readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"is_default":{"readOnly":true,"type":"boolean"},"name":{"readOnly":true,"type":"string"},"owners":{"allOf":[{"$ref":"#/components/schemas/FlowmingoWorkflowOwners"}],"readOnly":true}},"required":["alerts_muted_until","dashboard_trigger_enabled","dashboard_trigger_label","is_default","name"],"type":"object"},"ValueSetOptionSchema":{"properties":{"label":{"description":"The display name for the value","type":"string"},"value":{"description":"The value used in the check","type":"string"}},"type":"object"},"VariableAvailability":{"properties":{"attribute_label":{"type":"string"},"available_after":{"allOf":[{"$ref":"#/components/schemas/AvailableAfter"}],"description":"First later step that writes this variable and after which every deal reaching it has it, so a section placed after it can read the variable; null when no later step does","nullable":true}},"required":["attribute_label"],"type":"object"},"VariableDefinition":{"properties":{"description":{"type":"string"},"examples":{"items":{"type":"string"},"type":"array"},"key":{"type":"string"},"name":{"type":"string"}},"required":["description","examples","key","name"],"type":"object"},"VariableThreshold":{"properties":{"factor":{"anyOf":[{"type":"number"},{"format":"decimal","type":"string"}],"description":"Scales the variable: the check passes when the value <type> factor \u00d7 variable. Default 1. More than 0, at most 100, up to 4 decimal places"},"variable":{"$ref":"#/components/schemas/ComparedVariable"}},"required":["variable"],"type":"object"},"VehicleDmvHistory":{"properties":{"plate_expiration_date":{"description":"Plate expiration date of the earlier registration; null when unavailable.","format":"date","nullable":true,"type":"string"},"plate_number":{"description":"Plate on the earlier registration; null when unavailable.","nullable":true,"type":"string"},"plate_state":{"description":"State that issued the plate; null when unavailable.","nullable":true,"type":"string"},"plate_type":{"description":"Source-provided plate type; null when unavailable.","nullable":true,"type":"string"},"registrant_name":{"description":"Registrant named on the earlier DMV registration; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"VehicleLienHolder":{"properties":{"lien_holder_type":{"description":"The lien holder's role as the source reports it; null when unavailable.","nullable":true,"type":"string"},"lien_status":{"description":"Lien status as the source reports it; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Name of the lien holder; null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"VehicleOwnerSchema":{"properties":{"address":{"description":"Address reported for the vehicle owner; null when unavailable.","nullable":true,"type":"string"},"name":{"description":"Name of the vehicle owner; null when unavailable.","nullable":true,"type":"string"},"owner_type":{"description":"The owner's role as the source reports it, uppercase, such as REGISTRANT, LESSEE or LIENHOLDER. On real-time registrations with no reported role it is REGISTERED, SECONDARY or ADDITIONAL, from the owner's position on the registration. Null when unavailable.","nullable":true,"type":"string"}},"type":"object"},"VerificationResponseSchema":{"properties":{"business":{"allOf":[{"$ref":"#/components/schemas/BusinessVerification"}],"description":"The company the deal applied as. Null when no source named one, which leaves nothing to verify.","nullable":true},"owners":{"description":"Every person the deal's sources put at a share of the company. Ordered by the largest share stated, then the newest application form, then the order they appear on it. An owner stated through the API counts as older than any application form. The ones a form declared come before the ones only a source found.","items":{"$ref":"#/components/schemas/OwnerVerification"},"type":"array"}},"type":"object"},"VoidCheckResultSchema":{"properties":{"account_number":{"nullable":true,"type":"string"},"address_city":{"nullable":true,"type":"string"},"address_line_1":{"nullable":true,"type":"string"},"address_state":{"enum":["AK","AL","AR","AZ","CA","CO","CT","DC","DE","FL","GA","HI","IA","ID","IL","IN","KS","KY","LA","MA","MD","ME","MI","MN","MO","MS","MT","NC","ND","NE","NH","NJ","NM","NV","NY","OH","OK","OR","PA","RI","SC","SD","TN","TX","UT","VA","VT","WA","WI","WV","WY","PR",null],"nullable":true,"type":"string"},"address_zip":{"nullable":true,"type":"string"},"bank_name":{"nullable":true,"type":"string"},"check_number":{"nullable":true,"type":"string"},"company_name":{"nullable":true,"type":"string"},"routing_number":{"nullable":true,"type":"string"}},"type":"object"},"WebhookDeliveryDetailSchema":{"properties":{"attempt":{"description":"Number of attempts made in this delivery chain, including this one","nullable":true,"readOnly":true,"type":"integer"},"end_user_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"http_status":{"nullable":true,"readOnly":true,"type":"integer"},"max_attempts":{"description":"Maximum attempts in this delivery chain","nullable":true,"readOnly":true,"type":"integer"},"next_retry_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"occurred_at":{"format":"date-time","readOnly":true,"type":"string"},"payload":{"additionalProperties":{},"nullable":true,"readOnly":true,"type":"object"},"resend_of":{"nullable":true,"readOnly":true,"type":"string"},"status":{"readOnly":true,"type":"string"},"topic":{"nullable":true,"readOnly":true,"type":"string"},"trigger":{"enum":["automatic","manual",null],"nullable":true,"readOnly":true,"type":"string"},"webhook":{"allOf":[{"$ref":"#/components/schemas/WebhookDeliveryWebhook"}],"nullable":true,"readOnly":true}},"type":"object"},"WebhookDeliverySchema":{"properties":{"attempt":{"description":"Number of attempts made in this delivery chain, including this one","nullable":true,"readOnly":true,"type":"integer"},"end_user_heron_id":{"nullable":true,"readOnly":true,"type":"string"},"heron_id":{"readOnly":true,"type":"string"},"http_status":{"nullable":true,"readOnly":true,"type":"integer"},"max_attempts":{"description":"Maximum attempts in this delivery chain","nullable":true,"readOnly":true,"type":"integer"},"next_retry_at":{"format":"date-time","nullable":true,"readOnly":true,"type":"string"},"occurred_at":{"format":"date-time","readOnly":true,"type":"string"},"resend_of":{"nullable":true,"readOnly":true,"type":"string"},"status":{"readOnly":true,"type":"string"},"topic":{"nullable":true,"readOnly":true,"type":"string"},"trigger":{"enum":["automatic","manual",null],"nullable":true,"readOnly":true,"type":"string"},"webhook":{"allOf":[{"$ref":"#/components/schemas/WebhookDeliveryWebhook"}],"nullable":true,"readOnly":true}},"type":"object"},"WebhookDeliveryWebhook":{"properties":{"heron_id":{"readOnly":true,"type":"string"},"url":{"format":"url","readOnly":true,"type":"string"}},"type":"object"},"WebhookResendRequestSchema":{"properties":{"event_ids":{"items":{"type":"string"},"maxItems":50,"minItems":1,"type":"array"}},"required":["event_ids"],"type":"object"},"WebhookResendResponseSchema":{"properties":{"status":{"enum":["queued"],"readOnly":true,"type":"string"}},"type":"object"},"WebhookSchema":{"properties":{"headers":{"additionalProperties":{},"description":"Headers to send webhook with","example":{"Content-Type":"application/json"},"nullable":true,"type":"object"},"heron_id":{"description":"Unique ID for webhook generated by Heron","example":"wbh_KiQiPskBvdJHD5HX5RfCGU","readOnly":true,"type":"string"},"is_enabled":{"description":"Whether the webhook is enabled","example":true,"type":"boolean"},"topic":{"description":"Webhook topic for different Heron events","enum":["data_source.enabled","data_source_account_summary.created","data_source.disabled","end_user.created","end_user.processed","end_user.failed","end_user.reviewed","end_user.transactions_updated","end_user.review_required","end_user.files_changed","end_user.files_classified","end_user_information.updated","end_user.policy_workflow_finished","end_user.policy_workflow_failed","enrich_workflow.finished","transactions.deleted","transactions.updated","pdf.processed","pdf.checks_passed","pdf.checks_failed","pdf.transactions_loaded","pdf.failed","pdf.parsed","pdf.human_reviewing","pdf.approved","integration_link.erroring","iso_application.processed","iso_application.processed_simple","iso_application.created","iso_application.failed","end_user_email.processed","end_user_email.failed","end_user_file.parsed","end_user_file.parse_failed","end_user_file.processed_standalone","end_user_file.deleted","end_user_files.processing_failed","enricher.succeeded","enricher.failed","pricing_template.generation_succeeded","pricing_template.generation_failed","pricing_template.delivery_succeeded","pricing_template.delivery_failed","workflow.event"],"example":"end_user.processed","type":"string"},"url":{"description":"URL where webhook should be sent","example":"https://www.your-webhook-endpoint.com/heron","format":"url","type":"string"}},"required":["topic","url"],"type":"object"},"WebhookUpdateSchema":{"properties":{"headers":{"additionalProperties":{},"description":"Headers to send webhook with","example":{"Content-Type":"application/json"},"nullable":true,"type":"object"},"heron_id":{"description":"Unique ID for webhook generated by Heron","example":"wbh_KiQiPskBvdJHD5HX5RfCGU","readOnly":true,"type":"string"},"is_enabled":{"description":"Whether the webhook is enabled","example":true,"type":"boolean"},"topic":{"description":"Webhook topic for different Heron events","enum":["data_source.enabled","data_source_account_summary.created","data_source.disabled","end_user.created","end_user.processed","end_user.failed","end_user.reviewed","end_user.transactions_updated","end_user.review_required","end_user.files_changed","end_user.files_classified","end_user_information.updated","end_user.policy_workflow_finished","end_user.policy_workflow_failed","enrich_workflow.finished","transactions.deleted","transactions.updated","pdf.processed","pdf.checks_passed","pdf.checks_failed","pdf.transactions_loaded","pdf.failed","pdf.parsed","pdf.human_reviewing","pdf.approved","integration_link.erroring","iso_application.processed","iso_application.processed_simple","iso_application.created","iso_application.failed","end_user_email.processed","end_user_email.failed","end_user_file.parsed","end_user_file.parse_failed","end_user_file.processed_standalone","end_user_file.deleted","end_user_files.processing_failed","enricher.succeeded","enricher.failed","pricing_template.generation_succeeded","pricing_template.generation_failed","pricing_template.delivery_succeeded","pricing_template.delivery_failed","workflow.event"],"example":"end_user.processed","type":"string"},"url":{"description":"URL where webhook should be sent","example":"https://www.your-webhook-endpoint.com/heron","format":"url","type":"string"}},"type":"object"},"Widget":{"properties":{"id":{"description":"A unique id used to reference the widget","type":"string"},"scorecard_metric_date_range":{"enum":["latest","last_30_days","last_90_days","last_120_days","last_180_days","last_365_days","next_30_days","next_60_days","next_90_days","next_180_days","last_1_calendar_months","last_3_calendar_months","last_4_calendar_months","last_6_calendar_months","last_12_calendar_months","last_15_calendar_months","last_24_calendar_months","last_1_full_calendar_months","last_2_full_calendar_months","last_3_full_calendar_months","last_6_full_calendar_months","last_12_full_calendar_months","last_60_days","last_45_days","last_2_calendar_months"],"type":"string"},"scorecard_metric_label":{"type":"string"},"type":{"enum":["scorecard_metric","heron_score","loan_revenue_ratio","deposit_trends_ratio"],"type":"string"}},"required":["id","type"],"type":"object"},"WidgetGroup":{"properties":{"group_name":{"type":"string"},"id":{"description":"A unique id used to reference the group","type":"string"},"widgets":{"items":{"$ref":"#/components/schemas/Widget"},"type":"array"}},"required":["group_name","id","widgets"],"type":"object"},"WorkAffiliation":{"properties":{"address":{"description":"Address of the business; null when unavailable.","nullable":true,"type":"string"},"business_name":{"description":"Business the subject is affiliated with.","nullable":true,"type":"string"},"merged_from":{"description":"Every filing behind this affiliation, each as the source reported it, including the one whose values the affiliation shows. A single-filing affiliation lists that one filing, so more than one entry means values were combined.","items":{"$ref":"#/components/schemas/MergedFiling"},"type":"array"},"role":{"description":"Role at the business, such as CEO, DIRECTOR, or Registered Agent.","nullable":true,"type":"string"},"since_date":{"description":"Date the affiliation began; null when unavailable.","format":"date","nullable":true,"type":"string"},"status":{"description":"Source-provided status of the affiliation.","nullable":true,"type":"string"}},"type":"object"},"WorkflowStartByHeronIdRequestSchema":{"properties":{"end_user_heron_id":{"type":"string"},"trigger_id":{"description":"Trigger node ID on the resolved workflow version.","nullable":true,"type":"string"},"trigger_payload":{"additionalProperties":{},"description":"JSON payload validated against the trigger node schema when present.","type":"object"},"workflow_heron_id":{"type":"string"},"workflow_parameters":{"additionalProperties":{},"default":{},"type":"object"}},"required":["end_user_heron_id","workflow_heron_id"],"type":"object"},"WorkflowStartByNameRequestSchema":{"properties":{"end_user_heron_id":{"type":"string"},"trigger_id":{"description":"Trigger node ID on the resolved workflow version.","nullable":true,"type":"string"},"trigger_payload":{"additionalProperties":{},"description":"JSON payload validated against the trigger node schema when present.","type":"object"},"workflow_name":{"type":"string"},"workflow_parameters":{"additionalProperties":{},"default":{},"type":"object"}},"required":["end_user_heron_id","workflow_name"],"type":"object"},"WorkflowStartResponseSchema":{"properties":{"action":{"readOnly":true,"type":"string"},"status":{"readOnly":true,"type":"string"},"workflow_execution_id":{"readOnly":true,"type":"string"},"workflow_id":{"readOnly":true,"type":"string"}},"type":"object"},"YodleeAccount":{"properties":{"balance":{"$ref":"#/components/schemas/YodleeAmount"},"classification":{"nullable":true,"type":"string"},"id":{"type":"integer"}},"type":"object"},"YodleeAmount":{"properties":{"amount":{"type":"number"},"currency":{"type":"string"}},"type":"object"},"YodleeSchema":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/YodleeAccount"},"type":"array"},"transactions":{"items":{"$ref":"#/components/schemas/YodleeTransaction"},"type":"array"}},"type":"object"},"YodleeTransaction":{"properties":{"accountId":{"type":"integer"},"amount":{"$ref":"#/components/schemas/YodleeAmount"},"baseType":{"enum":["CREDIT","DEBIT"],"type":"string"},"category":{"type":"string"},"date":{"example":"2025-07-08","pattern":"^\\d{4}-\\d{2}-\\d{2}$","type":"string"},"description":{"$ref":"#/components/schemas/YodleeTransactionDescription"},"id":{"type":"integer"}},"type":"object"},"YodleeTransactionDescription":{"properties":{"original":{"type":"string"},"simple":{"type":"string"}},"type":"object"}},"securitySchemes":{"ApiKeyAuth":{"in":"header","name":"x-api-key","type":"apiKey"},"OAuthBearer":{"scheme":"bearer","type":"http"}}},"externalDocs":{"description":"Read Tutorial","url":"https://docs.herondata.io/"},"info":{"contact":{"email":"support@herondata.io","name":"Support"},"title":"Heron Data API","version":"2021-07-19"},"openapi":"3.0.0","paths":{"/.well-known/oauth-protected-resource/api/hello_world/oauth":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"authorization_servers":{"items":{"type":"string"},"type":"array"},"resource":{"type":"string"},"scopes_supported":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Protected resource metadata"},"503":{"description":"OAuth hello-world is not configured"}},"security":[],"summary":"Discover the OAuth hello-world authorization server","tags":["Testing"],"x-hidden":true}},"/.well-known/oauth-protected-resource/api/mcp/{endpoint_id}":{"get":{"parameters":[{"in":"path","name":"endpoint_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpProtectedResourceMetadataSchema"}}},"description":"Protected resource metadata"},"503":{"description":"OAuth is not configured"}},"security":[],"summary":"Discover the authorization server protecting an MCP endpoint","tags":["MCP"],"x-hidden":true}},"/api/analytics/decline":{"get":{"description":"Returns aggregated decline analytics for end users within a date range, including total end users, total declined, and per-check pass/fail/missing counts. Only the latest policy evaluation per end user is considered.\n","parameters":[{"description":"Start of the date range (filters by end_user created date)","in":"query","name":"start_date","required":true,"schema":{"format":"date-time","type":"string"}},{"description":"End of the date range (filters by end_user created date)","in":"query","name":"end_date","required":true,"schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"check_analytics":{"items":{"properties":{"check_name":{"type":"string"},"total_failed":{"type":"integer"},"total_missing_data":{"type":"integer"},"total_passed":{"type":"integer"}},"type":"object"},"type":"array"},"total_declined":{"description":"Number of end users with at least one failed check","type":"integer"},"total_end_users":{"description":"Total number of end users with policy evaluations","type":"integer"}},"type":"object"}}},"description":"Decline analytics retrieved successfully"},"400":{"description":"User does not have analytics configured"},"401":{"description":"Authentication required"},"422":{"description":"Missing required parameters"}},"summary":"Get decline analytics for a user","tags":["Analytics"]}},"/api/app_store/list":{"get":{"description":"List available apps","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AppStoreSchema"}}},"description":"OK"}},"summary":"List available apps","tags":["AppStore"]}},"/api/app_store/types":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"types":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"OK"}},"summary":"List valid app store types","tags":["AppStore"],"x-hidden":true}},"/api/app_store/use_cases":{"get":{"description":"Returns the list of available AppStore use cases","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"use_cases":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"OK"}},"summary":"List available app store use cases","tags":["AppStore"],"x-hidden":true}},"/api/auth/environments":{"get":{"description":"Get all available environments for the current user\n","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AvailableEnvironments"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get available environments","tags":["Authentication"],"x-hidden":true}},"/api/broker/end_users/summary":{"get":{"description":"Get the broker deal list. Broker customers only; responds 404 for others.","parameters":[{"description":"Filter by name associated with end user","in":"query","name":"name","required":false,"schema":{"example":"your_end_user_name","nullable":true,"type":"string"}},{"description":"Filter by status of end user","in":"query","name":"status","required":false,"schema":{"enum":["new","ready","processed","reviewed","review_requested","failed",null],"example":"reviewed","nullable":true,"type":"string"}},{"description":"Whether the end user is part of a lending portfolio","in":"query","name":"is_portfolio","required":false,"schema":{"example":true,"nullable":true,"type":"boolean"}},{"description":"Order to return broker end users by","in":"query","name":"order_by","required":false,"schema":{"default":"last_updated_desc","enum":["last_updated_desc","last_updated_asc","created_desc","created_asc","latest_activity_desc"],"type":"string"}},{"description":"Unique ID generated by Heron","in":"query","name":"heron_id","required":false,"schema":{"example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"}},{"description":"Filter by ID associated with end_user_id field in transactions","in":"query","name":"end_user_id","required":false,"schema":{"example":"your_end_user_id","nullable":true,"type":"string"}},{"description":"Filter by tag Heron IDs. End users holding any active requested tag are returned. Unknown and soft-deleted tag IDs do not match any end users.","explode":true,"in":"query","name":"tags","required":false,"schema":{"items":{"type":"string"},"nullable":true,"type":"array"},"style":"form"},{"description":"Pagination page number (optional). If provided, 'limit' must also be provided.","in":"query","name":"page","required":false,"schema":{"minimum":1,"nullable":true,"type":"integer"}},{"description":"Pagination limit per page (optional). If provided, 'page' must also be provided.","in":"query","name":"limit","required":false,"schema":{"maximum":10000,"minimum":1,"nullable":true,"type":"integer"}},{"description":"Whether to include the tags applied to each end user","in":"query","name":"include_tags","required":false,"schema":{"default":false,"example":true,"type":"boolean"}},{"description":"Only end users whose policy result was this.","in":"query","name":"with_policy_result","required":false,"schema":{"enum":["passed","failed","review_required","missing_data","execution_error",null],"nullable":true}},{"in":"query","name":"with_crm_sync_result","required":false,"schema":{"enum":["success","failure","no_sync_attempted",null],"nullable":true}},{"description":"Filter by whether an active document is pending human review","in":"query","name":"in_human_review","required":false,"schema":{"nullable":true,"type":"boolean"}},{"in":"query","name":"interval_start","required":false,"schema":{"format":"date-time","nullable":true,"type":"string"}},{"in":"query","name":"interval_end","required":false,"schema":{"format":"date-time","nullable":true,"type":"string"}},{"description":"When true, interval_start and interval_end match end users created or last updated within the window. Bounds are inclusive only when this flag is true.","in":"query","name":"include_updates_in_interval","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Filter by broker intake classification.","in":"query","name":"broker_classification","required":false,"schema":{"enum":["submission","decision","other",null],"nullable":true}},{"description":"Filter by broker deal stage.","in":"query","name":"deal_stage","required":false,"schema":{"enum":["ready","missing_docs","shopped","offers_in","funded","closed",null],"nullable":true}},{"description":"Filter by broker decision review state.","in":"query","name":"broker_link_status","required":false,"schema":{"enum":["unlinked","linked","dismissed","reclassified",null],"nullable":true}},{"description":"Filter to end users holding a live funder verdict on their own submission lane.","in":"query","name":"holds_decision","required":false,"schema":{"nullable":true,"type":"boolean"}},{"description":"Filter by the funder on the end user's submission lane.","in":"query","name":"funder_heron_id","required":false,"schema":{"nullable":true,"type":"string"}},{"description":"Include funder lane decision counts for submission rows.","in":"query","name":"include_decision_counts","required":false,"schema":{"default":false,"example":true,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"$ref":"#/components/schemas/Pagination"},"end_users":{"items":{"$ref":"#/components/schemas/BrokerEndUserSummary"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"Not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List broker EndUsers with deal summary information","tags":["Brokers"]}},"/api/broker/end_users/{end_user_heron_id}/funder_submissions/":{"get":{"description":"One row per funder submission on the deal, newest first, each carrying the funder, outbound status, send eligibility, send attempts, the current (non-superseded) decision, and the full decision history with each decision's offers. The envelope also identifies the requested record's broker link, records linked to it, and submitting broker identities evaluated for funder exclusions. Broker customers only; responds 404 for others.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"description":"Page number","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"description":"Page size, default 25, max 50","in":"query","name":"limit","required":false,"schema":{"default":25,"maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerLifecyclePage"}}},"description":"One page of funder submissions"},"404":{"description":"End user not found or not a broker customer"}},"security":[{"ApiKeyAuth":[]}],"summary":"List funder submissions with their current decision and offers"}},"/api/broker/end_users/{end_user_heron_id}/funder_submissions/preflight/":{"get":{"description":"Returns validation failures without submitting or changing submission state.","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"description":"Include this submission in preflight when explicitly resending it.","in":"query","name":"submission_heron_id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FunderSubmissionPreflightResultSchema"},"type":"array"}}},"description":"Per-funder validation results"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Validate an end user for configured funders"}},"/api/broker/end_users/{end_user_heron_id}/funder_submissions/submit_to_funders/":{"post":{"description":"Queues eligible submissions and reports each requested submission separately.","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkSubmitFunderSubmissionsRequestSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BulkSubmitFunderSubmissionResultSchema"},"type":"array"}}},"description":"Per-submission queue outcomes"},"404":{"description":"End user not found"},"422":{"description":"Invalid request"}},"security":[{"ApiKeyAuth":[]}],"summary":"Submit an end user to multiple funders"}},"/api/broker/end_users/{end_user_heron_id}/funder_submissions/{submission_heron_id}/exclusion_resolution/":{"post":{"parameters":[{"in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"submission_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunderExclusionResolutionSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerFunderExclusionRuleSchema"}}},"description":"Resolved funder exclusion rule"},"404":{"description":"Broker customer, end user, or submission not found"},"409":{"description":"Submission is no longer held"}},"security":[{"ApiKeyAuth":[]}],"summary":"Resolve a held funder submission"}},"/api/broker/end_users/{end_user_id_or_heron_id}":{"get":{"description":"Get end-user detail with broker link context. Broker customers only; responds 404 for others.","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"end_user":{"allOf":[{"$ref":"#/components/schemas/EndUser"},{"properties":{"broker_link":{"allOf":[{"$ref":"#/components/schemas/BrokerLink"}],"nullable":true}},"type":"object"}]}},"type":"object"}}},"description":"OK"},"404":{"description":"Not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get broker EndUser detail","tags":["Brokers"]}},"/api/broker/end_users/{end_user_id_or_heron_id}/deal_link/":{"post":{"parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ManualDealLinkRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerLink"}}},"description":"OK"},"404":{"description":"Not found"},"422":{"description":"Invalid deal link"}},"security":[{"ApiKeyAuth":[]}],"summary":"Link a broker decision record to a deal; its live decisions move onto that deal's submissions","tags":["Brokers"]}},"/api/broker/end_users/{end_user_id_or_heron_id}/deal_link/dismiss":{"post":{"parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerLink"}}},"description":"OK"},"404":{"description":"Not found"},"422":{"description":"Invalid deal link"}},"security":[{"ApiKeyAuth":[]}],"summary":"Dismiss a broker decision from deal-link review","tags":["Brokers"]}},"/api/broker/end_users/{end_user_id_or_heron_id}/deal_link_candidates/":{"get":{"parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DealLinkCandidate"},"type":"array"}}},"description":"OK"},"404":{"description":"Not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List deal-link candidates for a broker decision","tags":["Brokers"]}},"/api/broker/end_users/{end_user_id_or_heron_id}/outcome":{"delete":{"parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerDealOutcomeResponse"}}},"description":"OK"},"404":{"description":"Not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Clear a broker deal's outcome","tags":["Brokers"]},"put":{"parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerDealOutcomeRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerDealOutcomeResponse"}}},"description":"OK"},"404":{"description":"Not found"},"422":{"description":"Invalid deal outcome"}},"security":[{"ApiKeyAuth":[]}],"summary":"Set a broker deal's outcome","tags":["Brokers"]}},"/api/broker_funder_links/":{"delete":{"description":"Remove the relationship between the authenticated broker user and one or more funders","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerFunderLinkDeleteSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"message":{"example":"Broker-funder links deleted successfully","type":"string"}},"type":"object"}}},"description":"Broker-funder links deleted successfully"},"404":{"description":"Funder not found, or link does not exist"},"409":{"description":"Cannot delete link due to associated records (e.g., API keys)"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete broker-funder links","x-hidden":true}},"/api/broker_funder_policies/":{"get":{"description":"Get all broker funder policies for the current user, ordered by matching priority","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BrokerFunderPolicy"},"type":"array"}}},"description":"List of broker funder policies"}},"security":[{"ApiKeyAuth":[]}],"summary":"List broker funder policies for current user"},"patch":{"description":"Create or update broker funder policies for the current user","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateBrokerFunderPoliciesSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BrokerFunderPolicy"},"type":"array"}}},"description":"Broker funder policies updated successfully"},"404":{"description":"One or more funders not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Bulk update broker funder policies"}},"/api/broker_funder_policies/export/":{"get":{"description":"Download the current user's broker funder policies as an Excel spreadsheet.\nThe exported file can be re-uploaded via POST /broker_funder_policies/upload/ to round-trip policies.\n","responses":{"200":{"content":{"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"format":"binary","type":"string"}}},"description":"Excel file containing funder policies"}},"security":[{"ApiKeyAuth":[]}],"summary":"Export broker funder policies as Excel"}},"/api/broker_funder_policies/funders/":{"post":{"description":"Add a funder to the current broker's funder policies table. Idempotent \u2014 if the funder already exists in the broker's table, returns the existing record without modification. New entries start with empty criteria.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddFunderToPoliciesSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerFunderLink"}}},"description":"Funder already exists in policies (no modification)"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerFunderLink"}}},"description":"Funder added to policies"},"404":{"description":"Funder not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Add a funder to broker's policies"}},"/api/broker_funder_policies/funders/{funder_heron_id}/":{"delete":{"description":"Remove a funder from the current broker's funder policies table. Blocked if the broker-funder pair has active submission integrations (API keys).\n","parameters":[{"description":"The Heron ID of the funder to remove","in":"path","name":"funder_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}},"description":"Funder removed from policies"},"404":{"description":"Funder not found or not linked to this broker"},"409":{"description":"Cannot remove funder due to active submission integrations"}},"security":[{"ApiKeyAuth":[]}],"summary":"Remove a funder from broker's policies"}},"/api/broker_funder_policies/upload/":{"post":{"description":"Upload a spreadsheet (XLS, XLSX, CSV) or PDF containing funder policies.\nThe file will be parsed asynchronously and policies will be upserted for the current user.\nOnly one upload job can be active at a time per user.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerFunderPolicyUploadSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerFunderPolicyUploadJobSchema"}}},"description":"Upload job created successfully"},"400":{"description":"Invalid file or another job is already in progress"},"409":{"description":"Another upload job is already active"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload funder policy file for parsing"}},"/api/broker_funder_policies/upload/status/":{"get":{"description":"Get the status of the most recent policy upload job for the current user","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerFunderPolicyUploadJobSchema"}}},"description":"Upload job status"},"404":{"description":"No upload job found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get policy upload job status"}},"/api/broker_funder_policies/upload/{job_heron_id}/":{"get":{"description":"Get a specific policy upload job by its Heron ID","parameters":[{"description":"The Heron ID of the upload job","in":"path","name":"job_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BrokerFunderPolicyUploadJobSchema"}}},"description":"Upload job details"},"404":{"description":"Upload job not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get specific policy upload job"}},"/api/broker_funder_policies/upload/{job_heron_id}/pending/":{"get":{"description":"Get all pending funder matches that need manual resolution for a specific upload job","parameters":[{"description":"The Heron ID of the upload job","in":"path","name":"job_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PendingMatchSchema"},"type":"array"}}},"description":"List of pending matches"},"404":{"description":"Job not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List pending funder matches for a job"}},"/api/broker_funder_policies/upload/{job_heron_id}/pending/{index}/resolve/":{"post":{"description":"Resolve a pending match by selecting a funder. This will create the broker_funder\nrecord with the policy data and mark the pending match as resolved.\n","parameters":[{"description":"The Heron ID of the upload job","in":"path","name":"job_heron_id","required":true,"schema":{"type":"string"}},{"description":"The index of the pending match to resolve","in":"path","name":"index","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolvePendingMatchRequestSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingMatchSchema"}}},"description":"Pending match resolved successfully"},"400":{"description":"Invalid request or match already resolved"},"404":{"description":"Job or pending match not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Resolve a pending funder match"}},"/api/broker_funder_policies/upload/{job_heron_id}/pending/{index}/skip/":{"post":{"description":"Skip a pending match without resolving it. This will mark it as skipped.","parameters":[{"description":"The Heron ID of the upload job","in":"path","name":"job_heron_id","required":true,"schema":{"type":"string"}},{"description":"The index of the pending match to skip","in":"path","name":"index","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PendingMatchSchema"}}},"description":"Pending match skipped successfully"},"400":{"description":"Match already resolved or skipped"},"404":{"description":"Job or pending match not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Skip a pending funder match"}},"/api/broker_submissions/":{"post":{"description":"Create a new broker submission with end user details.\n**Authentication**: Requires a broker API key in the `x-api-key` header. Generate keys using the `/api/broker_submissions/api_keys/generate` endpoint.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBrokerSubmissionSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"heron_id":{"description":"Heron ID of the created submission","type":"string"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create broker submission","tags":["BrokerSubmissions"]}},"/api/broker_submissions/api_keys":{"get":{"description":"Retrieve all Broker API keys associated with the authenticated user's funder account. Returns a list of broker-funder relationships with their corresponding API keys. Each token is masked: `****` plus its last four characters when it is at least 16 characters long, otherwise `****`. The full token is returned only by `/api/broker_submissions/api_keys/generate` when the key is created.\n","responses":{"200":{"content":{"application/json":{"schema":{"items":{"properties":{"broker":{"description":"The broker's name","type":"string"},"broker_funder_api_key_heron_id":{"description":"The API key's unique identifier","type":"string"},"broker_funder_api_key_token":{"description":"The API key token, masked to `****` plus its last four characters","type":"string"}},"type":"object"},"type":"array"}}},"description":"OK"},"404":{"description":"Funder account not found for the authenticated user"}},"summary":"List broker API keys for a given user.","tags":["BrokerSubmissions"]}},"/api/broker_submissions/api_keys/generate":{"post":{"description":"Create a new API key for a broker-funder relationship. The broker is identified by email domain. If the funder account or broker-funder relationship doesn't exist, they will be created automatically. Returns an error if an API key already exists for this relationship. The full token is returned only in this response; the list endpoint returns it masked.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateBrokerFunderApiKeySchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"broker_funder_token":{"description":"The generated API key token, returned in full only here","type":"string"}},"type":"object"}}},"description":"OK"},"404":{"description":"Broker with the specified email domain does not exist"},"409":{"description":"API key already exists for this broker-funder relationship"}},"summary":"Generate broker API key","tags":["BrokerSubmissions"]}},"/api/broker_submissions/api_keys/{broker_funder_api_key_heron_id}":{"delete":{"description":"Delete an existing API key for a broker-funder relationship. The authenticated user must own the funder account associated with the API key.\n","parameters":[{"description":"The unique identifier of the API key to delete","in":"path","name":"broker_funder_api_key_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"API key successfully deleted"},"404":{"description":"API key not found"}},"summary":"Delete broker API key","tags":["BrokerSubmissions"]}},"/api/broker_submissions/{submission_heron_id}/files":{"post":{"description":"Upload one or more PDF files for a specified broker submission.\nAuthenticate by passing a broker API key in the `x-api-key` header. Generate keys via the `/api/broker_submissions/api_keys/generate` endpoint.\n","parameters":[{"description":"The unique identifier for the broker submission to upload files to","in":"path","name":"submission_heron_id","required":true,"schema":{"example":"sub_1a2b3c4d5e6f","type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"examples":{"multiple_files":{"summary":"Upload multiple files","value":{"files":["january.pdf","february.pdf","march.pdf"]}},"single_file":{"summary":"Upload single file","value":{"files":["file_q4.pdf"]}},"with_file_class":{"summary":"Upload with explicit file class","value":{"file_class":"iso_application_form","files":["iso_app.pdf"]}},"without_downstream_processing":{"summary":"Upload without triggering downstream processing","value":{"downstream_processing":false,"files":["statement.pdf"]}}},"schema":{"properties":{"downstream_processing":{"default":true,"description":"(Optional) Whether to trigger downstream processing (classification, parsing, Flowmingo workflow start, etc.) after the files are uploaded. Defaults to true to preserve existing behaviour. Set to false to upload files without triggering downstream processing \u2014 useful when uploading multiple files in sequence and you only want the workflow to start after the final upload.\n","example":true,"type":"boolean"},"file_class":{"description":"(Optional) The type of document being uploaded. Applies to all files in this request. If omitted, Heron's file classifier will automatically determine the file type. Common values: bank_statement, iso_application_form, debt_summary, void_check, invoice, pnl_statement, balance_sheet, tax_return.\n","example":"bank_statement","type":"string"},"files":{"description":"Array of PDF files to upload.","items":{"format":"binary","type":"string"},"maxItems":12,"minItems":1,"type":"array"}},"required":["files"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BrokerSubmissionFileUploaded"},"type":"array"}}},"description":"All files uploaded successfully"},"207":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BrokerSubmissionFileResult"},"type":"array"}}},"description":"Partial success - some files uploaded, others failed"},"400":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BrokerSubmissionFileFailed"},"type":"array"}}},"description":"All files failed validation or upload, or no files attached"},"401":{"content":{"application/json":{"schema":{"properties":{"description":{"example":"Unauthorized","type":"string"}},"type":"object"}}},"description":"Missing or invalid API key"},"404":{"content":{"application/json":{"schema":{"properties":{"description":{"example":"Broker submission sub_1a2b3c4d5e6f not found","type":"string"}},"type":"object"}}},"description":"Broker submission not found, or does not belong to the authenticated broker"},"422":{"content":{"application/json":{"schema":{"properties":{"description":{"example":"Invalid file_class 'invalid_value'. Must be a valid file class name.","type":"string"}},"type":"object"}}},"description":"Request payload failed validation (e.g. invalid file_class, file too large, wrong mime type, too few or too many files)"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload PDF files for broker submission","tags":["BrokerSubmissions"]}},"/api/broker_submissions/{submission_heron_id}/update_information":{"post":{"description":"Add company and owner details to existing broker submission.\n**Authentication**: Requires a broker API key in the `x-api-key` header. Generate keys using the `/api/broker_submissions/api_keys/generate` endpoint.\n","parameters":[{"in":"path","name":"submission_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserInformationPatchSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserInformationSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Add details to broker submission","tags":["BrokerSubmissions"]}},"/api/categories":{"get":{"description":"Get available categories","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"categories":{"items":{"$ref":"#/components/schemas/Category"},"type":"array"}},"type":"object"}}},"description":"OK"},"401":{"description":"Unauthorized"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get categories","tags":["Categories"]}},"/api/company_attributes":{"get":{"description":"Returns the authenticated account's launch catalogue with picker metadata.\n","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CompanyAttributeCatalogueSchema"},"type":"array"}}},"description":"Ok"},"404":{"description":"Account or policy access not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List company attributes available for policy checks","tags":["Policy"]}},"/api/credentials/keys":{"get":{"description":"List all API keys for the authenticated user. Returns key metadata including name, token prefix, creation date, and active status. The `last_used` field is when the key last authenticated a request, up to an hour behind, or null if it has not been used since usage tracking began on 8 October 2026. Full tokens are never returned - only the first 8 characters where the first 4 are \"key_\".\n","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"keys":{"items":{"$ref":"#/components/schemas/ApiKeyWithLastUsedSchema"},"type":"array"}},"type":"object"}}},"description":"List of API keys"}},"summary":"List API keys","tags":["Credentials"]},"post":{"description":"Create a new named API key for the authenticated user. The full token is returned only in this response - it cannot be retrieved again.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateKeySchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyCreatedSchema"}}},"description":"API key created. The full token is only returned in this response."},"400":{"description":"Invalid request"}},"summary":"Create a new API key","tags":["Credentials"],"x-hidden":true}},"/api/credentials/keys/{heron_id}":{"delete":{"description":"Permanently delete an API key. This cannot be undone. Consider deactivating instead if you might need to rollback.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Key deleted"},"404":{"description":"Key not found"}},"summary":"Delete an API key","tags":["Credentials"]}},"/api/credentials/keys/{heron_id}/activate":{"put":{"description":"Re-activate a previously deactivated API key. A key unused for longer than the allowed duration cannot be reactivated: create a new key instead.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyStatusSchema"}}},"description":"Key activated"},"404":{"description":"Key not found"},"409":{"description":"Key unused for longer than the allowed duration"}},"summary":"Activate an API key","tags":["Credentials"],"x-hidden":true}},"/api/credentials/keys/{heron_id}/deactivate":{"put":{"description":"Deactivate an API key. The key will stop working immediately but can be re-activated later. Use this instead of deleting to allow rollback.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ApiKeyStatusSchema"}}},"description":"Key deactivated"},"404":{"description":"Key not found"}},"summary":"Deactivate an API key","tags":["Credentials"]}},"/api/crm_integrations":{"get":{"description":"Get a list of CRM Integrations","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"crm_integrations":{"items":{"$ref":"#/components/schemas/CrmIntegrationSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"List CRM Integrations","tags":["CrmIntegrations"]},"post":{"description":"Create a CRM integration, e.g., with Salesforce","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmIntegrationSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"crm_integration":{"$ref":"#/components/schemas/CrmIntegrationSchema"}},"type":"object"}}},"description":"Created"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create a CRM integration","tags":["CrmIntegrations"]}},"/api/crm_integrations/{heron_id}":{"patch":{"description":"patch a CRM integration","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmIntegrationPatchSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CrmIntegrationSchema"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Patch a CRM integration","tags":["CrmIntegrations"]}},"/api/data_source_accounts/{dsa_heron_id_to_update}/update_number":{"post":{"description":"Update a data source account's account number\n","parameters":[{"in":"path","name":"dsa_heron_id_to_update","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceAccountUpdateNumberSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserDataSourceAccount"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update a data source account's account number","tags":["EndUserDataSourceAccounts"]}},"/api/data_source_accounts/{heron_id}":{"put":{"description":"Update a data source account\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserDataSourceAccountUpdateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserDataSourceAccount"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update a data source account","tags":["EndUserDataSourceAccounts"]}},"/api/data_sources/{heron_id}":{"put":{"description":"Update a data source\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserDataSourceUpdateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserDataSource"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update a data source","tags":["EndUserDataSources"]}},"/api/email_templates":{"get":{"description":"Read all available templates","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"rules":{"items":{"$ref":"#/components/schemas/EmailTemplateSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get email templates","tags":["EmailTemplates"]},"post":{"description":"Create an email template used to send emails conditional on events like policy evaluation\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplateSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"email_template":{"$ref":"#/components/schemas/EmailTemplateSchema"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create an email template","tags":["EmailTemplates"]}},"/api/email_templates/{heron_id}":{"patch":{"description":"Update an email template\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmailTemplatePatchSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"email_template":{"$ref":"#/components/schemas/EmailTemplateSchema"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Patch an email template","tags":["EmailTemplates"]}},"/api/embed/background_check":{"get":{"parameters":[{"in":"header","name":"X-Heron-Embed-Token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbedBackgroundCheckSchema"}}},"description":"Background check state"},"401":{"description":"Invalid or expired embed token"}},"summary":"Read an embedded background check","tags":["EndUsers"],"x-hidden":true}},"/api/embed/background_check/trigger":{"post":{"parameters":[{"in":"header","name":"X-Heron-Embed-Token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EmbedBackgroundCheckSchema"}}},"description":"Background check state"},"401":{"description":"Invalid or expired embed token"},"403":{"description":"Background check trial limit reached"}},"summary":"Start an embedded background check","tags":["EndUsers"],"x-hidden":true}},"/api/end_user_emails":{"get":{"description":"Get all emails for all end users associate with this user","parameters":[{"in":"query","name":"page","required":true,"schema":{"minimum":0,"type":"integer"}},{"in":"query","name":"limit","required":true,"schema":{"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"properties":{"count":{"type":"number"},"has_more":{"type":"boolean"},"page":{"type":"number"},"total_pages":{"type":"number"}},"type":"object"},"emails":{"items":{"properties":{"email":{"$ref":"#/components/schemas/EndUserEmailSchema"},"end_user_heron_id":{"type":"string"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser emails","tags":["EndUsers"]}},"/api/end_user_emails/{heron_id}/export":{"get":{"description":"Export an end user email as an EML file. Attachments are not included.","parameters":[{"description":"The heron_id of the email to export","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"message/rfc822":{"schema":{"format":"binary","type":"string"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Export an end user email as an EML file","tags":["EndUserEmails"]}},"/api/end_user_emails/{token}/viewer":{"get":{"parameters":[{"description":"Signed, expiring viewer token for one email","in":"path","name":"token","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"text/html":{"schema":{"type":"string"}}},"description":"The email rendered as an HTML page"},"404":{"description":"Invalid or expired token, or email not found"}},"summary":"View an email through a signed link","tags":["EndUserEmails"],"x-hidden":true}},"/api/end_user_enrichers/definitions/{enricher_definition_name}/start_enrich":{"post":{"description":"Dispatches an enricher task for an end user and returns immediately.\n","parameters":[{"description":"The name of the enricher definition to execute","example":"industry_prediction","in":"path","name":"enricher_definition_name","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"end_user_heron_id":{"description":"The Heron ID of the end user to enrich","example":"eun_abc123","type":"string"}},"required":["end_user_heron_id"],"type":"object"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StartEnrichEndUserResponseSchema"}}},"description":"Enrichment task dispatched successfully"},"400":{"description":"Invalid input"},"403":{"description":"Background check trial limit reached"},"404":{"description":"Enricher or end user not found"},"422":{"description":"Unprocessable entity"}},"security":[{"ApiKeyAuth":[]}],"summary":"Start enricher execution for a specific end user asynchronously","tags":["EndUserEnrichers"]}},"/api/end_user_enrichers/fields":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EnricherFieldsSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get all fields for all enrichers for a given user","tags":["EndUserEnrichers"]}},"/api/end_user_enrichers/{end_user_heron_id}/enrich":{"post":{"description":"Executes a specified enricher for an end user and returns the enrichment result.\nThe enrichment result is automatically saved to the database.\n","parameters":[{"description":"The Heron ID of the end user to enrich","example":"eus_abc123","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"enricher_name":{"description":"The name of the enricher to execute","example":"industry_prediction","type":"string"}},"required":["enricher_name"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnricherResultSchema"}}},"description":"Enricher executed successfully"},"403":{"description":"Background check trial limit reached"}},"security":[{"ApiKeyAuth":[]}],"summary":"Trigger enricher execution for a specific end user","tags":["EndUserEnrichers"]}},"/api/end_user_enrichers/{end_user_heron_id}/enricher_results":{"get":{"description":"Get all latest enrichment results for a given end user by their Heron ID.\n","parameters":[{"in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EnricherResultSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get enrichment results for an end user","tags":["EndUserEnrichers"]}},"/api/end_user_enrichers/{end_user_heron_id}/enricher_results/{enricher_name}":{"get":{"description":"Retrieve the latest result for a specific enricher and end user","parameters":[{"description":"The heron ID of the end user","example":"eus_abc123","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"description":"The name of the enricher","example":"industry_prediction","in":"path","name":"enricher_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EnricherResultSchema"}}},"description":"Successfully retrieved enricher result"},"404":{"description":"Enricher result not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get enricher result by enricher name and end user","tags":["EndUserEnrichers"]}},"/api/end_user_entities":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/NestedEndUserEntitySchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get the definitions for all end user entities","tags":["EndUserEntity"]},"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEndUserEntitySchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserEntitySchema"}}},"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change, or the name duplicates an MCA template entity or field"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create an end user entity","tags":["EndUserEntity"]}},"/api/end_user_entities/attribute_values/export":{"get":{"description":"Export a spreadsheet with saved entity attribute values (API sources only) for all end users under the current user.\n","responses":{"200":{"content":{"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"format":"binary","type":"string"}}},"description":"OK"},"404":{"description":"No end users or API attribute values found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Export all saved attribute for all end users to an Excel file","tags":["EndUserEntity"]}},"/api/end_user_entities/reorder":{"patch":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReorderEndUserEntitiesSchema"}}},"required":true},"responses":{"200":{"description":"OK"},"400":{"description":"The order moves a template entity and the entity graph is on"}},"security":[{"ApiKeyAuth":[]}],"summary":"Set the display order of end user entities","tags":["EndUserEntity"]}},"/api/end_user_entities/{entity_heron_id}/attributes":{"post":{"parameters":[{"in":"path","name":"entity_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEndUserEntityAttributeSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserEntityAttributeSchema"}}},"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change, or the name duplicates an MCA template entity or field"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create an end user entity attribute","tags":["EndUserEntity"]}},"/api/end_user_entities/{entity_heron_id}/attributes/reorder":{"patch":{"parameters":[{"in":"path","name":"entity_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReorderEndUserEntityAttributesSchema"}}},"required":true},"responses":{"200":{"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change"}},"security":[{"ApiKeyAuth":[]}],"summary":"Set the display order of end user entity attributes","tags":["EndUserEntity"]}},"/api/end_user_entities/{entity_heron_id}/attributes/{attribute_heron_id}":{"delete":{"parameters":[{"in":"path","name":"entity_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"attribute_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"success":{"description":"Indicates if the delete operation was successful","type":"boolean"}},"required":["success"],"type":"object"}}},"description":"Successfully deleted the EndUserEntity attribute"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change"},"404":{"description":"EndUserEntity attribute not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete an EndUserEntityAttribute","tags":["EndUserEntity"]},"patch":{"parameters":[{"in":"path","name":"entity_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"attribute_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEndUserEntityAttributeSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserEntityAttributeSchema"}}},"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change, or the name duplicates an MCA template entity or field"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update an end user entity","tags":["EndUserEntity"]}},"/api/end_user_entities/{entity_heron_id}/attributes/{attribute_heron_id}/clone":{"post":{"parameters":[{"in":"path","name":"entity_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"attribute_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CloneEndUserEntityAttributeSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserEntityAttributeSchema"}}},"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change, or the name duplicates an MCA template entity or field"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create an end user entity attribute","tags":["EndUserEntity"]}},"/api/end_user_entities/{entity_heron_id}/attributes/{attribute_heron_id}/sources":{"post":{"parameters":[{"in":"path","name":"entity_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"attribute_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateEndUserEntityAttributeSourceSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserEntityAttributeSourceSchema"}}},"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create an end user entity attribute source","tags":["EndUserEntity"]}},"/api/end_user_entities/{entity_heron_id}/attributes/{attribute_heron_id}/sources/{source_heron_id}":{"delete":{"parameters":[{"in":"path","name":"entity_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"attribute_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"source_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"}},"type":"object"}}},"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete an EndUserEntityAttribute","tags":["EndUserEntity"]},"patch":{"parameters":[{"in":"path","name":"entity_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"attribute_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"source_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEndUserEntityAttributeSourceSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserEntityAttributeSourceSchema"}}},"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upsert an end user entity","tags":["EndUserEntity"]}},"/api/end_user_entities/{heron_id}":{"delete":{"parameters":[{"description":"The Integration's heron_id","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"}},"type":"object"}}},"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete an EndUserEntity","tags":["EndUserEntity"]},"patch":{"parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateEndUserEntitySchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserEntitySchema"}}},"description":"OK"},"400":{"description":"The entity is a template entity and the entity graph is on, so its shape cannot change, or the name duplicates an MCA template entity or field"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update an end user entity","tags":["EndUserEntity"]}},"/api/end_user_files":{"get":{"description":"Get all files uploaded to Heron by your users, not including parsed results from files","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndUserFileSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"All EndUserFiles","tags":["EndUserFiles"]}},"/api/end_user_files/alteration_flags":{"get":{"description":"List the latest amber or red alteration flag for each live bank statement.","parameters":[{"description":"Include flags created on or after this date","in":"query","name":"since","required":false,"schema":{"format":"date","nullable":true,"type":"string"}},{"description":"Include flags from this many calendar months ago","in":"query","name":"months","required":false,"schema":{"enum":[1,3,6,12,null],"nullable":true,"type":"integer"}},{"description":"Risk filters. Repeat the parameter to include both risks.","explode":true,"in":"query","name":"risk","required":false,"schema":{"items":{"enum":["red","amber"],"type":"string"},"type":"array"},"style":"form"},{"description":"Filter by deal name","in":"query","name":"search","required":false,"schema":{"nullable":true,"type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},{"description":"next_cursor of the previous page","in":"query","name":"cursor","required":false,"schema":{"nullable":true,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"properties":{"next_cursor":{"nullable":true,"type":"string"},"per_page":{"type":"integer"},"total":{"description":"Matching flags, capped at 10,000. Counted on the first page only.","nullable":true,"type":"integer"},"total_capped":{"description":"True when total hit the 10,000 cap. Null after the first page.","nullable":true,"type":"boolean"}},"type":"object"},"flags":{"items":{"$ref":"#/components/schemas/AlterationFlagSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"List flagged bank statements","tags":["EndUserFiles"]}},"/api/end_user_files/file_classes":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FileClassSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get all file classes","tags":["FileClass"]}},"/api/end_user_files/process_standalone":{"post":{"description":"Process a file for classification and parsing without storing it as an EndUserFile. Results are delivered via webhook to subscribed endpoints.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandaloneProcessFileSchema"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"properties":{"reference_id":{"description":"The reference ID provided in the request","type":"string"}},"type":"object"}}},"description":"Accepted"}},"security":[{"ApiKeyAuth":[]}],"summary":"Process file without creating EndUserFile record","tags":["EndUserFiles"]}},"/api/end_user_files/recent_by_file_class":{"get":{"description":"Retrieve the most recent files for the specified file class.","parameters":[{"description":"The file class to filter by.","in":"query","name":"file_class","required":true,"schema":{"type":"string"}},{"description":"The maximum number of files to return, defaults to 20","in":"query","name":"limit","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndUserFileSchema"},"type":"array"}}},"description":"A list of recent files."}},"security":[{"ApiKeyAuth":[]}],"summary":"Get recent files by file class","tags":["EndUserFiles"]}},"/api/end_user_files/rename_rules":{"get":{"description":"Retrieve all file rename rules for the current user.","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/GetFileRenameRulesSchema"},"type":"array"}}},"description":"A list of file rename rules"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get file rename rules","tags":["EndUserFiles"]},"post":{"description":"Add a new rename rule for files.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateFileRenameRuleSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFileRenameRulesSchema"}}},"description":"The created file rename rule"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create a file rename rule","tags":["EndUserFiles"]}},"/api/end_user_files/rename_rules/slugs":{"get":{"description":"Retrieve all file rename rules slugs for the current user.","responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}},"description":"A list of file rename rule slugs"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get file rename rule variable slugs","tags":["EndUserFiles"]}},"/api/end_user_files/rename_rules/{heron_id}":{"patch":{"description":"Update an existing rename rule identified by its `heron_id`.","parameters":[{"description":"The unique identifier of the rename rule.","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateFileRenameRuleSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetFileRenameRulesSchema"}}},"description":"The updated file rename rule"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update a file rename rule","tags":["EndUserFiles"]}},"/api/end_user_files/{euf_heron_id}/alteration_feedback":{"post":{"description":"Stores an analyst's view that a bank statement's alteration result is right or wrong. The risk, detectors and findings are read from the stored result. A result marked wrong is posted for review.","parameters":[{"description":"The Heron ID of the end user file (e.g. euf_...)","in":"path","name":"euf_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlterationFeedbackRequestSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AlterationFeedbackResponseSchema"}}},"description":"Feedback stored"},"403":{"description":"Alteration results are not enabled for this account"},"404":{"description":"End user file not found, or it has no alteration result"},"422":{"description":"Invalid body, or a finding ID that is not in the file's alteration result"},"429":{"description":"Too many feedback requests"}},"summary":"Rate a file's alteration result","tags":["EndUserFiles"],"x-hidden":true}},"/api/end_user_files/{heron_id}":{"delete":{"parameters":[{"description":"The Heron ID of the end user file to delete","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"}},"type":"object"}}},"description":"OK"},"403":{"description":"Unauthorized to delete this end user file"},"404":{"description":"End user file not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete an EndUserFile","tags":["EndUserFiles"]},"get":{"description":"Retrieve a single end user file by its Heron ID. Returns file metadata including filename, file class, parsed results (if any), and related info. Use this endpoint when you have an end user file Heron ID and need its details without listing or filtering all files.\n","parameters":[{"description":"The Heron ID of the end user file (e.g. euf_...)","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserFileSchema"}}},"description":"The end user file"},"404":{"description":"End user file not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get a single end user file by Heron ID","tags":["EndUserFiles"]},"patch":{"description":"Use this endpoint to change the end user file's class. The file will be reprocessed as the new type.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserFileUpdateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserFileSchema"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update the end user file's class","tags":["EndUserFiles"]}},"/api/end_user_files/{heron_id}/file":{"get":{"description":"Get the base64 string representation of an end user file","parameters":[{"description":"The heron_id of the end user file","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserFileBase64Schema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUserFile as a base64 string","tags":["EndUserFiles"]}},"/api/end_user_files/{heron_id}/parse_file":{"post":{"parameters":[{"description":"The file's heron_id","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParseFileSchema"}}},"required":true},"responses":{"201":{"description":"Parsing triggered"}},"security":[{"ApiKeyAuth":[]}],"summary":"Trigger async parsing of an end user file","tags":["EndUserFiles"]}},"/api/end_user_files/{heron_id}/parsed_results":{"get":{"parameters":[{"description":"The file's heron_id - beginning with 'euf_'","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"parser_id","required":false,"schema":{"nullable":true,"type":"string"}},{"in":"query","name":"version_number","required":false,"schema":{"nullable":true,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ParsedEndUserFileSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get parsed results from uploaded files","tags":["EndUserFiles"]}},"/api/end_user_files/{heron_id}/trigger_rename":{"post":{"parameters":[{"description":"The file's heron_id - starting with euf_","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserFileSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Trigger file's rename rule","tags":["EndUserFiles"]}},"/api/end_user_files/{heron_id}/trigger_split":{"post":{"parameters":[{"description":"The file's heron_id","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndUserFileSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Trigger splitting a combined end user file into its child files based on its page_classes","tags":["EndUserFiles"]}},"/api/end_user_files/{parsed_end_user_file_id}/parsed_results":{"patch":{"parameters":[{"description":"The ID of the parsed end user file","in":"path","name":"parsed_end_user_file_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateParsedResultSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParsedEndUserFileSchema"}}},"description":"OK"},"404":{"description":"Parsed end user file not found"},"422":{"description":"Neither or both of json_result and json_patch_operations given, or the result is invalid"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update Parsed Results","tags":["EndUserFiles"],"x-hidden":true}},"/api/end_user_files/{parsed_end_user_file_id}/review_status":{"patch":{"description":"Updates the review status of the most recent parsed result for an end user file","parameters":[{"description":"The ID of the parsed end user file","in":"path","name":"parsed_end_user_file_id","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetParsedFileReviewStatusSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"review_status":{"enum":["review_not_required","in_review","reviewed","approved"],"type":"string"}},"type":"object"}}},"description":"Status updated successfully"},"400":{"description":"Invalid request"},"404":{"description":"End user file or parsed results not found"}},"summary":"Set parsed file review status","tags":["End User Files"],"x-hidden":true}},"/api/end_user_queries/execute":{"post":{"description":"Execute saved SQL queries by name for a specific end user and return results\n","requestBody":{"content":{"application/json":{"schema":{"properties":{"end_user_heron_id":{"description":"Heron ID of the end user","example":"eu_abc123","type":"string"},"query_names":{"description":"List of saved query names to execute","example":["monthly_revenue","top_transactions"],"items":{"type":"string"},"type":"array"}},"required":["query_names","end_user_heron_id"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"example":{"results":{"monthly_revenue":{"column_order":["month","revenue"],"records":[{"month":"2024-01","revenue":50000}]},"top_transactions":{"column_order":["id","amount"],"records":[{"amount":1000,"id":1}]}}},"schema":{"$ref":"#/components/schemas/QueryResults"}}},"description":"Successfully executed queries"}},"security":[{"ApiKeyAuth":[]}],"summary":"Execute saved queries","tags":["EndUserQueries"],"x-hidden":true}},"/api/end_users":{"get":{"description":"Get a list of EndUsers","parameters":[{"description":"Filter by name associated with end user","in":"query","name":"name","required":false,"schema":{"example":"your_end_user_name","nullable":true,"type":"string"}},{"description":"Filter by status of end user","in":"query","name":"status","required":false,"schema":{"enum":["new","ready","processed","reviewed","review_requested","failed",null],"example":"reviewed","nullable":true,"type":"string"}},{"description":"Whether the end user is part of a lending portfolio","in":"query","name":"is_portfolio","required":false,"schema":{"example":true,"nullable":true,"type":"boolean"}},{"description":"Return only end users created at or after this ISO 8601 date or datetime","in":"query","name":"created_after","required":false,"schema":{"example":"2026-09-11","nullable":true,"type":"string"}},{"description":"Return only end users created strictly before this ISO 8601 date or datetime","in":"query","name":"created_before","required":false,"schema":{"example":"2026-09-18","nullable":true,"type":"string"}},{"description":"Return only end users last updated at or after this ISO 8601 date or datetime","in":"query","name":"last_updated_after","required":false,"schema":{"example":"2026-09-11","nullable":true,"type":"string"}},{"description":"Return only end users last updated strictly before this ISO 8601 date or datetime","in":"query","name":"last_updated_before","required":false,"schema":{"example":"2026-09-18","nullable":true,"type":"string"}},{"description":"Order to return end users by","in":"query","name":"order_by","required":false,"schema":{"default":"last_updated_desc","enum":["last_updated_desc","last_updated_asc","created_desc","created_asc",null],"nullable":true,"type":"string"}},{"description":"Unique ID generated by Heron","in":"query","name":"heron_id","required":false,"schema":{"example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"}},{"description":"Filter by ID associated with end_user_id field in transactions","in":"query","name":"end_user_id","required":false,"schema":{"example":"your_end_user_id","nullable":true,"type":"string"}},{"description":"Filter by tag Heron IDs. End users holding any active requested tag are returned. Unknown and soft-deleted tag IDs do not match any end users.","explode":true,"in":"query","name":"tags","required":false,"schema":{"items":{"type":"string"},"nullable":true,"type":"array"},"style":"form"},{"description":"Pagination page number","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"description":"Pagination limit per page","in":"query","name":"limit","required":false,"schema":{"default":1000,"maximum":10000,"minimum":1,"type":"integer"}},{"description":"Whether the to include data sources for each end user","in":"query","name":"include_data_sources","required":false,"schema":{"default":false,"example":true,"type":"boolean"}},{"description":"Whether to include scorecard metrics for each end user (under field criteria)","in":"query","name":"include_scorecard_metrics","required":false,"schema":{"default":false,"example":true,"type":"boolean"}},{"description":"Whether to include the tags applied to each end user","in":"query","name":"include_tags","required":false,"schema":{"default":false,"example":true,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"$ref":"#/components/schemas/Pagination"},"end_users":{"items":{"$ref":"#/components/schemas/EndUser"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"List EndUsers","tags":["EndUsers"]},"post":{"description":"Create a new end user. If transactions have previously been sent for this `end_user_id`, use `PUT end_users` to update instead.\n","requestBody":{"content":{"application/json":{"schema":{"properties":{"end_user":{"$ref":"#/components/schemas/EndUserPostParams"}},"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"end_user":{"$ref":"#/components/schemas/EndUser"}},"type":"object"}}},"description":"OK"},"422":{"description":"A tag is unknown or outside the member's access scope"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create EndUser","tags":["EndUsers"]},"put":{"callbacks":{"onData":{"$yourWebhookUrl":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserWebhookPayload"}}},"description":"Webhook payload with end_user"},"responses":{"200":{"description":"Your webhook implementation should return this HTTP status code\nif the data was received successfully."}}}}}},"description":"Confirm an end user is ready for async processing by sending a status of \"ready\". The `end_user_id` must have previously been sent with at least one Transaction if attempting to update the status.\n","externalDocs":{"description":"Webhook Tutorial","url":"https://docs.herondata.io/webhooks"},"requestBody":{"content":{"application/json":{"schema":{"properties":{"end_user":{"$ref":"#/components/schemas/EndUser"}},"type":"object"}}},"description":"Dictionary representing an EndUser","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"end_user":{"$ref":"#/components/schemas/EndUser"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update EndUser","tags":["EndUsers"]}},"/api/end_users/background_check/verification/coverage":{"get":{"deprecated":true,"description":"Deprecated \u2014 use `GET /end_users/verification/coverage` instead.\nGet, for every field the verification response carries, the sources that could check it, best authority first. A constant rather than a fact about one submission: it says what the product can verify at all, which is why it takes no end user.\nA channel the submission stated through is never one of them. The form, the customer's own rows and the broker's submission are the claim under check, so they appear on a field's check with their value and nowhere here. An empty list means no run can ever verify that field.\n","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverageResponseSchema"}}},"description":"OK"},"404":{"description":"Verification is not enabled for this account"}},"security":[{"ApiKeyAuth":[]}],"summary":"Which sources could check each verification field","tags":["EndUsers"],"x-hidden":true}},"/api/end_users/balance":{"get":{"description":"Get balance for given EndUser on a daily and account granularity","parameters":[{"description":"end_user_id for statistics; either end_user_id or end_user_heron_id is required","in":"query","name":"end_user_id","required":false,"schema":{"example":"your_end_user_id","nullable":true,"type":"string"}},{"description":"Heron-generated id for end user; either end_user_id or end_user_heron_id is required","in":"query","name":"end_user_heron_id","required":false,"schema":{"example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"}},{"description":"ISO 4217 currency code to convert to","in":"query","name":"to_currency","required":false,"schema":{"enum":["GBP","USD","EUR","CAD","AUD",null],"example":"USD","nullable":true,"type":"string"}},{"description":"Deprecated (use date_min instead). Filter for transactions with timestamp after the input value","in":"query","name":"timestamp_min","required":false,"schema":{"example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"type":"string"}},{"description":"Filter for transactions with timestamp after the input value (inclusive). It has precedence over timestamp_min","in":"query","name":"date_min","required":false,"schema":{"example":"2026-02-26","format":"date","nullable":true,"type":"string"}},{"description":"Deprecated (use date_max instead). Filter for transactions with timestamp earlier than the input value","in":"query","name":"timestamp_max","required":false,"schema":{"example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"type":"string"}},{"description":"Filter for transactions with date earlier than the input value (inclusive). It has precedence over timestamp_max","in":"query","name":"date_max","required":false,"schema":{"example":"2026-02-26","format":"date","nullable":true,"type":"string"}},{"description":"If true, forecasts the balances of each account","in":"query","name":"include_forecast","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Filter by specific account reference IDs","explode":true,"in":"query","name":"account_ids","required":false,"schema":{"default":[],"example":["1234","5678"],"items":{"type":"string"},"type":"array"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserBalanceOutputSchema"}}},"description":"OK. Empty balances include a warning reason when no balance data is available."},"404":{"description":"EndUser not found or inaccessible"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser balance","tags":["EndUserCalculations"]}},"/api/end_users/forecast":{"get":{"description":"Get forecast amounts for a given EndUser and category","parameters":[{"description":"end_user_id for statistics; either end_user_id or end_user_heron_id is required","in":"query","name":"end_user_id","required":false,"schema":{"example":"your_end_user_id","nullable":true,"type":"string"}},{"description":"Heron-generated id for end user; either end_user_id or end_user_heron_id is required","in":"query","name":"end_user_heron_id","required":false,"schema":{"example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"}},{"description":"ISO 4217 currency code to convert to","in":"query","name":"to_currency","required":false,"schema":{"enum":["GBP","USD","EUR","CAD","AUD",null],"example":"USD","nullable":true,"type":"string"}},{"description":"Aggregate results over time, i.e., aggregate by week or by month","in":"query","name":"date_granularity","required":false,"schema":{"default":"month","enum":["week","month"],"example":"month","type":"string"}},{"description":"Heron ID of category to be forecasted; either category_heron_id or category_label must be present","in":"query","name":"category_heron_id","required":false,"schema":{"example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","type":"string"}},{"description":"Label of category to be forecasted; either category_heron_id or category_label must be present","in":"query","name":"category_label","required":false,"schema":{"example":"Revenue","type":"string"}},{"description":"The earliest transaction timestamp date to use in forecasting","in":"query","name":"from_date","required":false,"schema":{"example":"2022-01-01","format":"date","nullable":true,"type":"string"}},{"description":"The latest transaction timestamp date to use in forecasting","in":"query","name":"to_date","required":false,"schema":{"example":"2022-01-31","format":"date","nullable":true,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndUserForecastOutputSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser forecasts","tags":["EndUserCalculations"]}},"/api/end_users/merge":{"post":{"description":"Merge two end users, combining their files and data. The older end user will be kept and the younger end user's data will be merged into it.\n","requestBody":{"content":{"application/json":{"schema":{"properties":{"source_end_user_heron_id":{"description":"Heron ID of the second end user to merge","type":"string"},"target_end_user_heron_id":{"description":"Heron ID of the end user to merge into","type":"string"}},"required":["target_end_user_heron_id","source_end_user_heron_id"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"message":{"description":"Success message","type":"string"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Merge two end users","tags":["EndUsers"],"x-hidden":true}},"/api/end_users/statistics":{"get":{"description":"Get summarized statistics for a given EndUser","parameters":[{"description":"end_user_id for statistics; either end_user_id or end_user_heron_id is required","in":"query","name":"end_user_id","required":false,"schema":{"example":"your_end_user_id","nullable":true,"type":"string"}},{"description":"Heron-generated id for end user; either end_user_id or end_user_heron_id is required","in":"query","name":"end_user_heron_id","required":false,"schema":{"example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"}},{"description":"ISO 4217 currency code to convert to","in":"query","name":"to_currency","required":false,"schema":{"enum":["GBP","USD","EUR","CAD","AUD",null],"example":"USD","nullable":true,"type":"string"}},{"description":"Filter for transactions with timestamp after the input value (as date)","in":"query","name":"from_date","required":false,"schema":{"example":"2026-02-26","format":"date","nullable":true,"type":"string"}},{"description":"Filter for transactions with timestamp before the input value (as date)","in":"query","name":"to_date","required":false,"schema":{"example":"2026-02-26","format":"date","nullable":true,"type":"string"}},{"description":"Aggregate results over time, e.g., by week or by quarter","in":"query","name":"date_granularity","required":false,"schema":{"default":"month","enum":["day","week","month","quarter","year"],"example":"month","type":"string"}},{"description":"Pivot results by merchant or by category","in":"query","name":"group_by","required":false,"schema":{"default":"category","enum":["category","merchant"],"example":"category","type":"string"}},{"description":"Filter by specific categories","explode":true,"in":"query","name":"category_heron_ids","required":false,"schema":{"default":[],"example":["ctg_94bwS4hp5ZQkyi9kBNkqn8","ctg_awhBcHjFLbnf5MpXbuqzj8"],"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Filter by specific merchants","explode":true,"in":"query","name":"merchant_heron_ids","required":false,"schema":{"default":[],"example":["mrc_8bYsSyAMW6LGsGFZi8GF9F","mrc_i7UBv8CnXQRyNCRdCUyjbX"],"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Filter by specific account reference IDs","explode":true,"in":"query","name":"account_ids","required":false,"schema":{"default":[],"example":["1234","5678"],"items":{"type":"string"},"type":"array"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"statistics":{"items":{"$ref":"#/components/schemas/EndUserStatsOutputSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser statistics","tags":["EndUserCalculations"]}},"/api/end_users/summary":{"get":{"description":"Get a list of EndUsers","parameters":[{"description":"Filter by name associated with end user","in":"query","name":"name","required":false,"schema":{"example":"your_end_user_name","nullable":true,"type":"string"}},{"description":"Filter by status of end user","in":"query","name":"status","required":false,"schema":{"enum":["new","ready","processed","reviewed","review_requested","failed",null],"example":"reviewed","nullable":true,"type":"string"}},{"description":"Whether the end user is part of a lending portfolio","in":"query","name":"is_portfolio","required":false,"schema":{"example":true,"nullable":true,"type":"boolean"}},{"description":"Order to return end users by","in":"query","name":"order_by","required":false,"schema":{"default":"last_updated_desc","enum":["last_updated_desc","last_updated_asc","created_desc","created_asc",null],"nullable":true,"type":"string"}},{"description":"Unique ID generated by Heron","in":"query","name":"heron_id","required":false,"schema":{"example":"eus_9qQBmrBQMMUkek76UmiQ7m","nullable":true,"type":"string"}},{"description":"Filter by ID associated with end_user_id field in transactions","in":"query","name":"end_user_id","required":false,"schema":{"example":"your_end_user_id","nullable":true,"type":"string"}},{"description":"Filter by tag Heron IDs. End users holding any active requested tag are returned. Unknown and soft-deleted tag IDs do not match any end users.","explode":true,"in":"query","name":"tags","required":false,"schema":{"items":{"type":"string"},"nullable":true,"type":"array"},"style":"form"},{"description":"Pagination page number (optional). If provided, 'limit' must also be provided.","in":"query","name":"page","required":false,"schema":{"minimum":1,"nullable":true,"type":"integer"}},{"description":"Pagination limit per page (optional). If provided, 'page' must also be provided.","in":"query","name":"limit","required":false,"schema":{"maximum":10000,"minimum":1,"nullable":true,"type":"integer"}},{"description":"Whether to include the tags applied to each end user","in":"query","name":"include_tags","required":false,"schema":{"default":false,"example":true,"type":"boolean"}},{"description":"Only end users whose policy result was this.","in":"query","name":"with_policy_result","required":false,"schema":{"enum":["passed","failed","review_required","missing_data","execution_error",null],"nullable":true}},{"in":"query","name":"with_crm_sync_result","required":false,"schema":{"enum":["success","failure","no_sync_attempted",null],"nullable":true}},{"description":"Filter by whether an active document is pending human review","in":"query","name":"in_human_review","required":false,"schema":{"nullable":true,"type":"boolean"}},{"description":"Whether to include the brokers who submitted each end user","in":"query","name":"include_submitting_brokers","required":false,"schema":{"default":false,"example":true,"type":"boolean"}},{"description":"Only end users linked to any of these LendSaaS deal IDs. Requires a LendSaaS CRM integration.","explode":true,"in":"query","name":"lendsaas_deal_ids","required":false,"schema":{"items":{"minLength":1,"type":"string"},"maxItems":100,"minItems":1,"nullable":true,"type":"array"},"style":"form"},{"description":"Whether to include the LendSaaS deal IDs linked to each end user","in":"query","name":"include_lendsaas_deal_ids","required":false,"schema":{"default":false,"example":true,"type":"boolean"}},{"description":"Whether to include the CRM queue each end user's workflow last synced it to (currently read from LendSaaS sync steps)","in":"query","name":"include_crm_queue","required":false,"schema":{"default":false,"example":true,"type":"boolean"}},{"in":"query","name":"interval_start","required":false,"schema":{"format":"date-time","nullable":true,"type":"string"}},{"in":"query","name":"interval_end","required":false,"schema":{"format":"date-time","nullable":true,"type":"string"}},{"description":"When true, interval_start and interval_end match end users created or last updated within the window. Bounds are inclusive only when this flag is true.","in":"query","name":"include_updates_in_interval","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"allOf":[{"$ref":"#/components/schemas/Pagination"}],"description":"Pagination metadata. Present only if pagination parameters ('page' and 'limit') are provided in the request."},"end_users":{"items":{"$ref":"#/components/schemas/EndUserSummary"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"List EndUsers with Summary Information","tags":["EndUsers"]}},"/api/end_users/verification/coverage":{"get":{"description":"Get, for every field the verification response carries, the sources that could check it, best authority first. A constant rather than a fact about one submission: it says what the product can verify at all, which is why it takes no end user.\nA channel the submission stated through is never one of them. The form, the customer's own rows and the broker's submission are the claim under check, so they appear on a field's check with their value and nowhere here. An empty list means no run can ever verify that field.\n","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CoverageResponseSchema"}}},"description":"OK"},"404":{"description":"Verification is not enabled for this account"}},"security":[{"ApiKeyAuth":[]}],"summary":"Which sources could check each verification field","tags":["EndUsers"],"x-hidden":true}},"/api/end_users/{end_user_heron_id}/background_check":{"get":{"description":"Get the background check results for an end user, including the screening run status, each subject's identity matches and records, and the outcome of each policy check.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"description":"If true, each record additionally carries its full vendor detail under `detail`","in":"query","name":"include_section_detail","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"If true, each subject's search trail is taken from that subject's most recent run that used an automatic identity search, ignoring runs where the subject was manually pinned. Records and policy outcomes are unaffected.\n","in":"query","name":"exclude_manual","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckResponseSchema"}}},"description":"OK"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser background check dashboard payload","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/background_check/affiliations":{"get":{"description":"Lists every business and person the deal's background check connects it to: the businesses each owner is recorded as affiliated with, the businesses filed under each owner (corporate filings), the people associated with them, and the people and companies named as officers on the business's own filings. Each row carries the state of any report requested for it - shared across rows naming the same business - and is absent until a background check has completed.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckAffiliationsViewSchema"}}},"description":"OK"},"404":{"description":"End user not found, or affiliations are not enabled for this account"}},"security":[{"ApiKeyAuth":[]}],"summary":"List an end user's background check affiliations","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/background_check/affiliations/reports":{"post":{"description":"Requests a background check report for each affiliation selected, business or person. Where the source records already identify the party, its report is retrieved for that party directly; otherwise a search runs first, and a search that settles on no single party returns `not_found` along with the parties it did find, so one can be confirmed. Poll the affiliations endpoint for progress.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckAffiliateReportRequestSchema"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckAffiliateRequestAcceptedSchema"}}},"description":"Report requests accepted"},"403":{"description":"Background check trial limit reached"},"404":{"description":"End user not found, or affiliations are not enabled for this account"},"409":{"description":"The affiliation list has changed, this affiliation cannot have a report requested for it, or no completed background check exists"}},"security":[{"ApiKeyAuth":[]}],"summary":"Request background check reports for affiliations","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/background_check/affiliations/reports/confirm":{"post":{"description":"Chooses which of the parties a search found the affiliation's report should cover, either when the search settled on none of them or to correct an earlier choice. Only a party that affiliation's own search identified can be chosen. Its report is retrieved in the background, replacing any report already held for that affiliation; poll the affiliations endpoint for progress.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckAffiliateConfirmSchema"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckAffiliationReportState"}}},"description":"Report pull accepted"},"403":{"description":"Background check trial limit reached"},"404":{"description":"End user not found, or affiliations are not enabled for this account"},"409":{"description":"No report has been requested for this affiliation, or no report can be ordered for the chosen party - it is not one this affiliation's search identified"}},"security":[{"ApiKeyAuth":[]}],"summary":"Confirm a candidate for an affiliate report","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/background_check/affiliations/reports/{ref}":{"delete":{"description":"Removes an affiliate report request, so later screening runs no longer pull a report for that affiliation. Reports already pulled remain on the runs that produced them.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"description":"The affiliate report request reference returned when it was requested","in":"path","name":"ref","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Request removed"},"404":{"description":"End user not found, or affiliations are not enabled for this account"},"409":{"description":"The affiliate report request does not exist"}},"security":[{"ApiKeyAuth":[]}],"summary":"Stop tracking an affiliate report","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/background_check/override":{"delete":{"description":"Clears every subject's CLEAR candidate pin so the enricher runs its full search waterfall for all subjects on the next run.","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Overrides cleared"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Clear all CLEAR candidate overrides for a background check","tags":["EndUsers"]},"get":{"description":"Returns the per-subject CLEAR entity_id pins the background-check enricher fetches reports for directly, skipping its search. An empty value means that subject still runs the full search waterfall.","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckCandidateOverrideSchema"}}},"description":"OK"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get the pinned CLEAR candidate overrides for a background check","tags":["EndUsers"]},"post":{"description":"Pins a CLEAR entity_id per subject (owner_1, owner_2, business) so the enricher fetches that candidate's report directly and skips its search. A null value clears that subject's pin; unpinned subjects still run the full search waterfall. Returns the current pins.","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckCandidateOverrideSchema"}}}},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckCandidateOverrideSchema"}}},"description":"OK"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Pin CLEAR candidate overrides for a background check","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/background_check/pdf":{"get":{"description":"One PDF for the whole deal - a contents index, the outcome, every policy check, and each subject's findings. Renders the same data the background check page shows, and returns the file itself rather than a JSON envelope, so a client can save the response directly.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/pdf":{"schema":{"format":"binary","type":"string"}}},"description":"The rendered PDF, as an attachment."},"404":{"description":"End user not found, or no background check has been run for the deal"},"409":{"description":"The deal's background check is still running, or did not succeed"}},"security":[{"ApiKeyAuth":[]}],"summary":"Download the background check as a PDF","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/background_check/subjects/{subject_key}/raw_report":{"get":{"description":"Returns the requested subject's background check as machine-readable XML, base64-encoded in a JSON payload.\n\nThe document is rooted at `<background_check>` carrying `end_user_id`, `end_user_name`, `status`, `subject_key` and a UTC `generated_at`. Under it: `<outcome>` with the deal's result, severity and check counts; `<policy_checks count=\"n\">` of `<check>`; and `<subjects>` holding the one requested `<subject>`. Within the subject, `<application>` is the identity that was searched, and each exported section is an element named for its key (`criminal`, `liens`, `ofac`, ...) carrying `count` and one `<record>` per row. A section's list fields are siblings of those elements rather than nested in them, in the same `count`/`<record>` shape \u2014 `phones`, `addresses`, `emails`, `business_profile_details`, `business_contacts` and `work_affiliations` \u2014 so `profile` itself has no element, only its lists.\n\nElement and field names are those of `BackgroundCheckResponseSchema`, which is the data dictionary for their meaning. Values are machine-typed rather than display-formatted: a boolean is `true`/`false`, a list is a repeated element, an amount is a bare decimal, and an absent field is omitted rather than empty so a consumer can test for presence. The deal's outcome and policy checks are repeated in every subject's file, so each file stands on its own.\n\nA check's `id` is `<scope>:<signal>`, and the scope is what the check covers rather than necessarily this subject: `owner_1`, `owner_2` and `business` each name one subject, `any_owner` is the worst outcome across the owners, and `submission` is computed over the whole deal. So a subject's file carries checks about the other subjects too, and a failing `any_owner` or `submission` check should not be attributed to the subject whose file it arrived in.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"description":"The background check subject to export","in":"path","name":"subject_key","required":true,"schema":{"enum":["owner_1","owner_2","business"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BackgroundCheckRawReportSchema"}}},"description":"OK"},"404":{"description":"End user not found, or the deal has no completed check for that subject"}},"security":[{"ApiKeyAuth":[]}],"summary":"Download a subject's background check as XML","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/background_check/subjects/{subject_key}/records/{record_id}/mugshot":{"get":{"description":"Returns the mug shot for one criminal or arrest record as authenticated image bytes.","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"description":"The background check subject whose record should be viewed","in":"path","name":"subject_key","required":true,"schema":{"enum":["owner_1","owner_2","business"],"type":"string"}},{"description":"Stable reference of the criminal or arrest record","in":"path","name":"record_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"image/jpeg":{"schema":{"format":"binary","type":"string"}},"image/png":{"schema":{"format":"binary","type":"string"}}},"description":"Mug shot image"},"404":{"description":"End user, record, or mug shot not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"View a criminal-record mug shot","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/background_check/verification":{"get":{"deprecated":true,"description":"Deprecated \u2014 use `GET /end_users/{end_user_heron_id}/verification` instead.\n\nReturns a field-by-field verification of a submission's subjects \u2014 the business and its\nowners \u2014 against every independent source that ran a KYB check for the submission.\n\nFor each field, the response gives a `state`, the independent sources consulted, and the\nvalue each returned. States are:\n\n- `verified` \u2014 the merchant stated this value and an independent source agrees\n- `conflict` \u2014 the merchant stated this value and an independent source disagrees\n- `not_verified` \u2014 no independent source confirmed it\n- `blank` \u2014 no value was provided on the submission\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationResponseSchema"}}},"description":"OK"},"404":{"description":"End user not found, or verification is not enabled for this account"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get an end user's background check verification","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/company_attributes":{"get":{"description":"Get calculated attribute values for a given end user","parameters":[{"in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CompanyAttributeValueSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser attribute values","tags":["EndUserAttributes"]}},"/api/end_users/{end_user_heron_id}/deal_link/":{"get":{"description":"List all end users linked to the same CRM opportunity as this end user \u2014 the original submission end user plus one end user per funder decision email.","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/DealLinkEntry"},"type":"array"}}},"description":"List of deal link entries"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get deal link entries for an end user"}},"/api/end_users/{end_user_heron_id}/details":{"get":{"description":"Returns the applicant's business, its owners and the funding it applied for, with one value per field. `_sources` gives the source of each value.\n\n`custom_entities` holds your custom fields.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserDetailsResponseSchema"}}},"description":"OK"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get the business and owner details of an end user","tags":["EndUsers"]},"patch":{"description":"Send only the fields that change. Fields you do not send stay as they are.\n\nEach business, owner, address, phone and credit score in `GET /end_users/{id}/details` has a `heron_id`. To change one of them, send its `heron_id` with the fields you want to change. To add a new one, send it without a `heron_id`. The business must always include its `heron_id`, if the deal already has a business.\n\nTo remove a value you set, send `null`. For a list, `[]` removes the whole list. To remove one item from a list, send the full list again without that item, because a list replaces the previous one.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DetailsWriteSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserDetailsResponseSchema"}}},"description":"OK"},"400":{"description":"The details stated do not fit this submission"},"403":{"description":"Editing company details is not enabled for this account"},"404":{"description":"End user not found"},"422":{"description":"A body this schema cannot read, such as a key it does not name"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update the business and owner details of an end user","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/duplicate_end_users":{"get":{"description":"Find duplicate end users for the given end user by matching on EIN (federal_tax_id) or normalized legal business name. Only returns duplicates within the same user (lender). Matching strategy: (1) Priority - Match by EIN when available (fast indexed query), (2) Fallback - Match by normalized company_legal_business_name when EIN is missing. Requires the count_duplicate_end_users feature flag to be enabled for the user.\n","parameters":[{"description":"The Heron ID of the end user to check for duplicates","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DuplicateEndUsersResponse"}}},"description":"List of duplicate end users found"},"403":{"description":"Feature not enabled for this user"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get duplicate end users for an end user","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/entities":{"get":{"parameters":[{"in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/MaterialisedEndUserEntitySchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get the materialised end user entities for an end user","tags":["EndUserEntity"]}},"/api/end_users/{end_user_heron_id}/entities/values/bulk":{"put":{"description":"Save multiple entity attribute values in a single request.\nEach item specifies the entity name, attribute name, and value to set.\nIf an API source doesn't exist for an attribute, one will be created.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkSaveEntityAttributeValuesSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BulkSaveEntityAttributeValueResultSchema"},"type":"array"}}},"description":"Results for each item in the bulk request"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Bulk save entity attribute values by entity name and attribute name","tags":["EndUserEntity"]}},"/api/end_users/{end_user_heron_id}/entities/{entity_heron_id}":{"post":{"parameters":[{"in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"entity_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertEndUserEntityAttributeValueSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserEntityAttributeValueSchema"}}},"description":"OK"},"204":{"description":"No Content (value was deleted)"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upsert the attribute value for an end user entity attribute source","tags":["EndUserEntity"]}},"/api/end_users/{end_user_heron_id}/fraud_detection/fraud_network":{"get":{"description":"Returns the last fraud network scan for a submission: whether the identity it stated matches\nHeron's fraud network, and Heron's business-only conclusions in `features`. People, ring size,\nmember data, amounts and dates are never returned, so `network`, `match_meta`,\n`matched_node_heron_id`, `businesses`, `people` and `edges` are always empty.\n\nTo test the integration, first `POST /end_users` with\n`{\"end_user\":{\"end_user_id\":\"sandbox-fraud-test-001\",\n\"name\":\"HERON SANDBOX FRAUD RING LLC\"}}`. Use an unused `end_user_id`. Before the workflow\nruns the enrichers, `PATCH /end_users/<heron_id>/end_user_information` with\n`{\"company_legal_business_name\":\"HERON SANDBOX FRAUD RING LLC\",\"owner_1\":\n{\"first_name\":\"HERON SANDBOX\",\"last_name\":\"FRAUD RING\"}}`. Do not send an EIN or SSN.\nInstead of the PATCH, you can send an application form that names the business\n`HERON SANDBOX FRAUD RING LLC` and the owner `HERON SANDBOX FRAUD RING`. It works whether\nthe form's owner name is parsed as `HERON SANDBOX` / `FRAUD RING` or as first `HERON`,\nmiddle `SANDBOX`, last `FRAUD RING`.\n\nThis endpoint returns `status=match`, `classification=fraud_network`, and the sample ring's\nbusiness-only conclusions in `features`. Read the sample velocity result from\n`GET /end_user_enrichers/<heron_id>/enricher_results`: select `broker_velocity`, then read\n`broker_velocity_signal`, which is `high`.\n\nFor a lone actor, use `HERON SANDBOX LONE ACTOR LLC` with owner `HERON SANDBOX` /\n`LONE ACTOR`; this endpoint returns `classification=lone_actor`. Any other made-up identity\nreturns `status=no_match`.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FraudNetworkScanResultSchema"}}},"description":"OK"},"403":{"description":"Fraud detection is not enabled for this account"},"404":{"description":"End user not found, or no scan has run for this end user"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get an end user's fraud network scan","tags":["EndUsers"]}},"/api/end_users/{end_user_heron_id}/funder_policy_evaluations/":{"get":{"description":"Get all funder policy evaluations for a specific end user","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FunderPolicyEvaluation"},"type":"array"}}},"description":"List of funder policy evaluations"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List funder policy evaluations for an end user"}},"/api/end_users/{end_user_heron_id}/funder_submissions/{submission_heron_id}/submit_to_funder/":{"post":{"description":"Triggers an async submission for a specific funder submission. Returns 202 immediately; poll the submission status to check progress. Set resend=true with use_sandbox=false to submit a previously sent or declined lane with a successful production attempt again.\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}},{"description":"The Heron ID of the funder submission","in":"path","name":"submission_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitFunderSubmissionRequestSchema"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitFunderSubmissionResponseSchema"}}},"description":"Submission accepted and queued for processing"},"400":{"description":"Submission cannot be submitted in its current status"},"404":{"description":"End user or funder submission not found"},"409":{"description":"Submission is already in progress"},"503":{"description":"Submission could not be queued"}},"security":[{"ApiKeyAuth":[]}],"summary":"Submit an end user to a single funder"}},"/api/end_users/{end_user_heron_id}/verification":{"get":{"description":"Returns a field-by-field verification of a submission's subjects \u2014 the business and its\nowners \u2014 against every independent source that ran a KYB check for the submission.\n\nFor each field, the response gives a `state`, the independent sources consulted, and the\nvalue each returned. States are:\n\n- `verified` \u2014 the merchant stated this value and an independent source agrees\n- `conflict` \u2014 the merchant stated this value and an independent source disagrees\n- `not_verified` \u2014 no independent source confirmed it\n- `blank` \u2014 no value was provided on the submission\n","parameters":[{"description":"The Heron ID of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/VerificationResponseSchema"}}},"description":"OK"},"404":{"description":"End user not found, or verification is not enabled for this account"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get an end user's verification","tags":["EndUsers"]}},"/api/end_users/{end_user_id_or_heron_id}":{"delete":{"deprecated":true,"description":"Synchronously delete an end user and its associated transactions. Deprecated \u2014 use POST /end_users/{end_user_id_or_heron_id}/delete for async deletion instead.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete EndUser by heron_id or end_user_id (sync)","tags":["EndUsers"]},"get":{"description":"Get an end user using its end_user_id or heron_id\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"end_user":{"$ref":"#/components/schemas/EndUser"}},"type":"object"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser by heron_id or end_user_id","tags":["EndUsers"]}},"/api/end_users/{end_user_id_or_heron_id}/accounts":{"get":{"description":"`heron_id` is always null; `group_key` is unstable and must never be persisted or compared across requests.\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"accounts":{"items":{"$ref":"#/components/schemas/DeduplicatedAccountSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get deduplicated accounts","tags":["EndUserAccounts"],"x-hidden":true}},"/api/end_users/{end_user_id_or_heron_id}/anomalies":{"get":{"description":"Get anomalies for given EndUser given a category label or heron id","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Label or Heron ID of category to find anomalies for","in":"query","name":"category_label_or_heron_id","required":true,"schema":{"example":"Revenue","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AnomalySchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser anomalies","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/bank_statement_summary":{"get":{"description":"Get the bank statement summary by month for an end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Determines how to group transactions. It supports calendar month (by_month) or rolling 30-day period (from last txns with rolling_30_days_from_last_txn or from today with rolling_30_days_from_today)","in":"query","name":"grouping","required":false,"schema":{"default":"by_month","enum":["by_month","by_data_source_account_heron_id","rolling_30_days_from_last_txn","rolling_30_days_from_today","by_month_by_data_source_account_heron_id","by_month_by_account","by_data_source_account_by_monthly_intervals"],"type":"string"}},{"description":"Number of full calendar months to show in the summary","in":"query","name":"num_full_calendar_months","required":false,"schema":{"minimum":1,"nullable":true,"type":"integer"}},{"description":"Account ids to include in the summary, if not provided, all accounts are included","explode":true,"in":"query","name":"account_ids","required":false,"schema":{"items":{"example":"1234","type":"string"},"nullable":true,"type":"array"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserBankStatementSummary"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser bank statement summary","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/benchmarks":{"get":{"description":"Get the benchmarks for each metric for an end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"benchmarks":{"items":{"$ref":"#/components/schemas/MetricBenchmarksSchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"Metric benchmarks are not enabled for this user"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser metric benchmarks","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/bulk_category_feedback":{"post":{"description":"Provide bulk feedback on Transaction Categories for a specified end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Whether to process the feedback with high priority","in":"query","name":"high_priority","required":false,"schema":{"default":false,"type":"boolean"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserBulkCategoryFeedback"}}},"description":"A list of objects containing a Transaction's heron id and the suggested Category. If you provide a `heron_id` for Category, you don't need to provide other fields. If `heron_id` is provided, we disregard `label`.\n","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"category":{"description":"The applied category","properties":{"description":{"description":"Description of the category","type":"string"},"heron_id":{"description":"Unique ID of the category","type":"string"},"label":{"description":"The label of the category","type":"string"}},"type":"object"},"num_annotations":{"description":"The number of category annotations added","example":1,"type":"integer"},"transaction_heron_ids":{"description":"List of affected transaction heron IDs","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Bulk create category feedback for an end user","tags":["EnrichmentFeedback"]}},"/api/end_users/{end_user_id_or_heron_id}/combined_financials":{"get":{"description":"Get the combined P&L & Balance Sheet data from financial documents for an EndUser","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"grouping","required":false,"schema":{"enum":["by_month","by_quarter","by_year",null],"nullable":true,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FinancialsSummarySchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser's combined financials","tags":["EndUserFinancials"]}},"/api/end_users/{end_user_id_or_heron_id}/data_source_account_summary":{"get":{"description":"Get a list of data sources accounts & their summarised information for a company\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"by_data_source_account_heron_id (default): one row per data source account. by_data_source_account_by_monthly_intervals: splits each account's coverage into ~1-month rows anchored on end_date, each with its own period_start_date/period_end_date and metrics computed only over that period's window.\n","in":"query","name":"grouping","schema":{"default":"by_data_source_account_heron_id","enum":["by_data_source_account_heron_id","by_data_source_account_by_monthly_intervals"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DataSourceAccountSummaryPublicSchema"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get data source account summary","tags":["EndUserDataSources"]}},"/api/end_users/{end_user_id_or_heron_id}/data_source_accounts/disable_duplicates":{"post":{"parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"start_date","required":false,"schema":{"format":"date","nullable":true,"type":"string"}},{"in":"query","name":"end_date","required":false,"schema":{"format":"date","nullable":true,"type":"string"}}],"responses":{"200":{"description":"OK"},"409":{"description":"Deduplication is already running for this end user"}},"security":[{"ApiKeyAuth":[]}],"summary":"Disable duplicate data source accounts for an end user","tags":["EndUserDataSourceAccounts"]}},"/api/end_users/{end_user_id_or_heron_id}/data_sources":{"get":{"description":"Get a list of data sources for a company\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndUserDataSources"},"type":"array"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get data sources","tags":["EndUserDataSources"]}},"/api/end_users/{end_user_id_or_heron_id}/data_sources/summary":{"get":{"description":"Get a page of an end user's data sources with dashboard aggregates, newest first.","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Pagination page number","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"description":"Pagination limit per page","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},{"description":"Filter to these PDF statuses. Repeat the parameter for more than one.","explode":true,"in":"query","name":"pdf_status","required":false,"schema":{"items":{"enum":["new","parsing","parsed","processed","human_reviewing","approved","rejected","failed","transactions_loaded","transactions_unloaded"],"type":"string"},"nullable":true,"type":"array"},"style":"form"},{"description":"Filter by whether the data source is enabled.","in":"query","name":"is_enabled","required":false,"schema":{"nullable":true,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"allOf":[{"$ref":"#/components/schemas/Pagination"},{"properties":{"counts":{"properties":{"by_pdf_status":{"additionalProperties":{"type":"integer"},"type":"object"},"disabled":{"type":"integer"},"total":{"type":"integer"}},"required":["total","disabled","by_pdf_status"],"type":"object"}},"required":["counts"],"type":"object"}]},"data_sources":{"items":{"$ref":"#/components/schemas/EndUserDataSourceSummarySchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get paginated data source summaries","tags":["EndUserDataSources"]}},"/api/end_users/{end_user_id_or_heron_id}/debt_candidates":{"get":{"description":"Identify potential debt candidates.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserMerchantSummary"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser debt candidates","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/decision_logic":{"post":{"description":"Upload DecisionLogic XML files for a specified end user to translate into Heron Data format and add transactions for the end user\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"ISO 4217 currency code","in":"query","name":"currency","required":false,"schema":{"example":"USD","type":"string"}}],"requestBody":{"content":{"application/xml":{"schema":{"type":"string"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"_summary":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload DecisionLogic XML","tags":["EndUserIntegrations"]}},"/api/end_users/{end_user_id_or_heron_id}/delete":{"post":{"description":"Asynchronously delete an end user and its associated transactions. Returns immediately with a 202 status while deletion proceeds in the background.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"properties":{"heron_id":{"example":"eus_Eqio3Y4dhyNiMphrXwG58p","type":"string"},"status":{"example":"pending","type":"string"}},"type":"object"}}},"description":"Accepted \u2014 deletion is in progress"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete EndUser by heron_id or end_user_id (async)","tags":["EndUsers"]}},"/api/end_users/{end_user_id_or_heron_id}/derived_features":{"get":{"description":"Calculates the end user's derived features from their transactions, statements and application\nat the time of the request.\n\nEach feature is one column of ECG's retro data study. Features with similar names are separate columns\nthere and are calculated differently: `stmt_avg_ending_balance` is the statement summary's average\nending balance, and `cashflow_balance_end` is the end-of-day balance on the last day.\n","parameters":[{"description":"The Heron ID of the end user, or your own end_user_id for it","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DerivedFeaturesSchema"}}},"description":"OK"},"403":{"description":"Derived features are not enabled for this account"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get an end user's derived features","tags":["EndUsers"],"x-hidden":true}},"/api/end_users/{end_user_id_or_heron_id}/emails":{"get":{"description":"Get the emails associated with an end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndUserEmailSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser emails","tags":["EndUsers"]}},"/api/end_users/{end_user_id_or_heron_id}/end_user_information":{"get":{"description":"Get the company details of an end user including loan information","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserInformationSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser information","tags":["EndUsers"]},"patch":{"description":"Update the end user information","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserInformationPatchSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserInformationSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Patch EndUser information","tags":["EndUsers"]}},"/api/end_users/{end_user_id_or_heron_id}/enrich":{"post":{"description":"Enriches transactions of an end user identified by its end_user_id or heron_id. There is an optional `priority` parameter that can be set to `high` to prioritize the enrichment over `normal` (default) priority. High priority enrichment is only enabled for enterprise-level accounts. Please contact support@herondata.io to upgrade your account.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Priority for async enrichment","in":"query","name":"priority","required":false,"schema":{"default":"normal","enum":["normal","high"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"end_user":{"$ref":"#/components/schemas/EndUser"}},"type":"object"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Enrich transactions of EndUser","tags":["EndUsers"]}},"/api/end_users/{end_user_id_or_heron_id}/evaluate_rules":{"get":{"parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/RuleEvaluationSchema"},"type":"array"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Evaluate all rules for an end user","tags":["EndUserRules"]}},"/api/end_users/{end_user_id_or_heron_id}/export_spreadsheet":{"get":{"description":"Export a spreadsheet for an end user containing key metrics and reports\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"format":"binary","type":"string"}}},"description":"OK"},"400":{"description":"No transaction data available for the end user"},"500":{"description":"Spreadsheet generation failed"}},"security":[{"ApiKeyAuth":[]}],"summary":"Export as a spreadsheet","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/files":{"get":{"description":"Get all files for an end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndUserFileSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUserFiles","tags":["EndUserFiles"]},"post":{"deprecated":true,"description":"Deprecated \u2014 use [Post EndUserFile V2](/api-reference/enduserfiles/post-enduserfile-v2) instead.","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserFileUploadSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserFileSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Post EndUserFile","tags":["EndUserFiles"]}},"/api/end_users/{end_user_id_or_heron_id}/files/download":{"get":{"description":"Download all files for an end user as a zip","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/zip":{"schema":{"format":"binary","type":"string"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Download EndUserFiles","tags":["EndUserFiles"]}},"/api/end_users/{end_user_id_or_heron_id}/files/parsed_results/xlsx":{"get":{"parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"format":"binary","type":"string"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Download xlsx of parsed results from uploaded files","tags":["EndUserFiles"]}},"/api/end_users/{end_user_id_or_heron_id}/files/summary":{"get":{"description":"Get a page of an end user's files, newest first, with the parse status, field validation counts and email classification the full files response carries inside parsed_results, but without the parsed bodies themselves.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Pagination page number","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"description":"Pagination limit per page","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},{"description":"Filter to these file classes. Repeat the parameter for more than one.","explode":true,"in":"query","name":"file_class","required":false,"schema":{"items":{"type":"string"},"nullable":true,"type":"array"},"style":"form"},{"in":"query","name":"has_bank_statement","required":false,"schema":{"nullable":true,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"$ref":"#/components/schemas/Pagination"},"files":{"items":{"$ref":"#/components/schemas/EndUserFileSummarySchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUserFile summaries","tags":["EndUserFiles"]}},"/api/end_users/{end_user_id_or_heron_id}/files/v2":{"post":{"description":"Upload file to an end user & asynchronously classify its type. After uploading, call the `/start_workflow` endpoint to trigger downstream processing (parsing, bank statement extraction, etc.).\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"file":{"description":"The file to upload","format":"binary","type":"string"},"file_class":{"description":"(Optional) - The type of file. Common values: bank_statement, iso_application_form, debt_summary, void_check, invoice, pnl_statement, balance_sheet, tax_return, money_market_statement. Contact Heron support for the full list of file classes available for your account.","type":"string"},"reference_id":{"description":"Your reference id for the file","type":"string"}},"required":["file"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserFileSchema"}}},"description":"OK"},"409":{"content":{"application/json":{"schema":{"properties":{"code":{"example":409,"type":"integer"},"description":{"type":"string"},"end_user_file_heron_id":{"description":"Heron ID of the existing duplicate file","type":"string"},"name":{"example":"Conflict","type":"string"}},"type":"object"}}},"description":"File content duplicates an already uploaded file, or an identical file is still being saved. If an earlier upload of the same file was interrupted, retries get this 409 for up to 100 seconds. Returned only when duplicate rejection is enabled for the account.\n"}},"security":[{"ApiKeyAuth":[]}],"summary":"Post EndUserFile V2","tags":["EndUserFiles"]}},"/api/end_users/{end_user_id_or_heron_id}/grouped_transactions_report":{"get":{"description":"Get a report of transactions grouped by merchant or counterparty for an end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndUserGroupedTransactionsReport"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser transactions grouped by counterparty or merchant","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/heron_score":{"get":{"description":"Get Heron Score for end user with a breakdown of the feature group contributions which resulted in the score. The score is calculated for the day of last transaction. This is a beta feature and is subject to change.","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Minimum company categorisation confidence to calculate Heron Score","in":"query","name":"min_category_confidence","required":false,"schema":{"example":0.8,"nullable":true,"type":"number"}},{"description":"Cut-off date to consider transactions to for calculating heron score (inclusive)","in":"query","name":"date","required":false,"schema":{"example":"2023-01-19","format":"date","nullable":true,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HeronScoreSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser Heron Score (beta)","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/industry":{"get":{"description":"Predict the industry of the end user based on its name","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Maximum number of digits in NAICS code","in":"query","name":"naics_code_max_digits","required":false,"schema":{"example":6,"maximum":6,"minimum":2,"type":"integer"}},{"description":"Minimum number of digits in NAICS code","in":"query","name":"naics_code_min_digits","required":false,"schema":{"example":2,"maximum":6,"minimum":2,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IndustrySchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser industry","tags":["EndUserCalculations"],"x-hidden":true}},"/api/end_users/{end_user_id_or_heron_id}/inscribe":{"post":{"description":"Upload Inscribe JSON for a specified end user to translate into Heron Data format and add transactions for the end user\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/InscribeSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"_summary":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload Inscribe","tags":["EndUserIntegrations"]}},"/api/end_users/{end_user_id_or_heron_id}/integration_links":{"get":{"description":"Get a list of integration links for a specified end user\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"links":{"items":{"$ref":"#/components/schemas/IntegrationLinkSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get Integration Links","tags":["EndUserIntegrations"]}},"/api/end_users/{end_user_id_or_heron_id}/iso_application_form":{"post":{"description":"Use this endpoint to upload an ISO application PDF. Once uploaded, the file will be automatically scrubbed asynchronously. You can use the returned iso_application heron_id (prefixed \"iso_\") to fetch the scrubbing results. Please contact support@herondata.io to enable this endpoint.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"file":{"format":"binary","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserFileSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload an ISO application PDF for for an end user","tags":["ISOApplication"]}},"/api/end_users/{end_user_id_or_heron_id}/iso_applications":{"get":{"description":"Get all ISO applications for an end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/GetIsoApplicationSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser ISO Applications","tags":["ISOApplication"]}},"/api/end_users/{end_user_id_or_heron_id}/location":{"get":{"description":"Get the company physical address coordinates","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserAddressLocationSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser physical location","tags":["EndUsers"]}},"/api/end_users/{end_user_id_or_heron_id}/merchant_feedback":{"post":{"description":"Provide bulk feedback on Transaction Merchants for a specified end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserBulkMerchantFeedback"}}},"description":"Merchant feedback for transactions. Provide either a merchant_heron_id (for known merchants) or merchant_name (for unknown merchants to be logged).\n","required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"num_annotations":{"description":"The number of merchant annotations added","example":1,"type":"integer"},"transaction_heron_ids":{"description":"List of affected transaction heron IDs","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Bulk create merchant feedback for an end user","tags":["EnrichmentFeedback"]}},"/api/end_users/{end_user_id_or_heron_id}/merchant_feedback/revert":{"post":{"description":"Revert merchant feedback annotations created by the feedback_client annotator","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserMerchantFeedbackRevert"}}},"description":"List of transaction heron IDs to revert merchant feedback","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"reverted":{"description":"List of transaction heron IDs that were reverted","items":{"type":"string"},"type":"array"},"skipped":{"description":"List of transaction heron IDs that were skipped","items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Revert merchant feedback for an end user","tags":["EnrichmentFeedback"]}},"/api/end_users/{end_user_id_or_heron_id}/merchant_summary":{"get":{"description":"Get the summary of transactions by merchant for an end user for given categories or analytics groups","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"explode":true,"in":"query","name":"category_label_or_heron_id","required":false,"schema":{"items":{"type":"string"},"minItems":1,"nullable":true,"type":"array"},"style":"form"},{"explode":true,"in":"query","name":"analytics_group","required":false,"schema":{"items":{"description":"The category analytics group","enum":["revenue","cost_of_goods_sold","operational_expenses","tax_expenses","intra_company","debt","equity","other_income","special_items","other",null],"example":"debt","nullable":true,"type":"string"},"minItems":1,"nullable":true,"type":"array"},"style":"form"},{"description":"Whether to group by counterparty transaction clusters","in":"query","name":"group_by_counterparty_txn_clusters","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"Account ids to include in the summary, if not provided, all accounts are included","explode":true,"in":"query","name":"account_ids","required":false,"schema":{"items":{"example":"1234","type":"string"},"nullable":true,"type":"array"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserMerchantSummary"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser merchant summary","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/missing_accounts":{"get":{"description":"Get a list of possible missing accounts for a given End User. This endpoint is in beta and likely to change.","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"missing_accounts":{"items":{"$ref":"#/components/schemas/MissingAccountSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get Missing Accounts (beta)","tags":["EndUserAccounts"]}},"/api/end_users/{end_user_id_or_heron_id}/moneythumb":{"post":{"description":"Upload MoneyThumb JSON files for a specified end user to translate into Heron Data format and add transactions for the end user. Note for actual PDF files, please use the pdfs endpoint\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoneyThumbOutputSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"_summary":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload MoneyThumb","tags":["EndUserIntegrations"],"x-hidden":true}},"/api/end_users/{end_user_id_or_heron_id}/moneythumb/scorecard":{"get":{"description":"Returns daily balance and MCA transaction data for the end user in MoneyThumb scorecard format.\n","parameters":[{"description":"The `end_user_id` or `heron_id` of the EndUser","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get MoneyThumb scorecard","tags":["EndUserIntegrations"],"x-hidden":true}},"/api/end_users/{end_user_id_or_heron_id}/moneythumb/transactions":{"get":{"description":"Returns all transactions for the end user grouped into the MoneyThumb Accounts \u2192 Statements \u2192 Transactions hierarchy, with category tags mapped to MoneyThumb tag names.\n","parameters":[{"description":"The `end_user_id` or `heron_id` of the EndUser","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MoneyThumbTransactionsResponseSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get MoneyThumb transactions","tags":["EndUserIntegrations"],"x-hidden":true}},"/api/end_users/{end_user_id_or_heron_id}/named_dates":{"get":{"description":"Get the named dates associated with an end user, e.g., date of last transaction","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"named_dates":{"items":{"$ref":"#/components/schemas/NamedDateSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser named dates","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/ocrolus":{"post":{"description":"Upload Ocrolus JSON for a specified end user to translate into Heron Data format and add transactions for the end user\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Skip the check for the number of transactions in the payload","in":"query","name":"skip_num_txns_check","required":false,"schema":{"type":"boolean"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OcrolusSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"_summary":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload Ocrolus","tags":["EndUserIntegrations"]}},"/api/end_users/{end_user_id_or_heron_id}/pdfs":{"get":{"description":"Get list of PDFs for a specified end user\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Include processed results where applicable per pdf","in":"query","name":"with_processed_results","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"pdfs":{"items":{"$ref":"#/components/schemas/PdfGetSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get PDFs","tags":["EndUserIntegrations"]},"post":{"description":"Upload encoded PDF of transactions for a specified end user to translate into Heron Data format\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PdfPostSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"pdf_heron_id":{"description":"Heron id of the uploaded pdf file","type":"string"},"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}}},"description":"OK"},"409":{"description":"File content duplicates an already uploaded file, or an identical file is still being saved. If an earlier upload of the same file was interrupted, retries get this 409 for up to 100 seconds. Duplicates are rejected only when duplicate rejection is enabled for the account."}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload PDF","tags":["EndUserIntegrations"],"x-hidden":true}},"/api/end_users/{end_user_id_or_heron_id}/pdfs/parse":{"post":{"description":"Starts parsing all PDFs for a specified end users. This will not restart any PDFs that are already being parsed\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"pdf_heron_ids":{"items":{"type":"string"},"type":"array"},"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Parse all PDF","tags":["EndUserIntegrations"]}},"/api/end_users/{end_user_id_or_heron_id}/pdfs/v1":{"post":{"description":"Upload encoded PDF of transactions for a specified end user to translate into Heron Data format\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PdfPostSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"pdf_heron_id":{"description":"Heron id of the uploaded pdf file","type":"string"},"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}}},"description":"OK"},"409":{"description":"File content duplicates an already uploaded file, or an identical file is still being saved. If an earlier upload of the same file was interrupted, retries get this 409 for up to 100 seconds. Duplicates are rejected only when duplicate rejection is enabled for the account."}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload PDF","tags":["EndUserIntegrations"]}},"/api/end_users/{end_user_id_or_heron_id}/plaid/assets":{"post":{"description":"Upload Plaid asset JSON for a specified end user to translate into Heron Data format and add transactions for the end user\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaidAssetsSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"_summary":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload Plaid assets","tags":["EndUserIntegrations"]}},"/api/end_users/{end_user_id_or_heron_id}/plaid/transactions":{"post":{"description":"Upload Plaid transactions JSON for a specified end user to translate into Heron Data format and add transactions for the end user\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlaidTransactionsSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"_summary":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload Plaid transactions","tags":["EndUserIntegrations"]}},"/api/end_users/{end_user_id_or_heron_id}/policy_evaluations":{"get":{"description":"Evaluates the user's policies against end user on-the-fly\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PolicyEvaluationSchema"},"type":"array"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get the policy evaluations for an end user","tags":["Policy"]}},"/api/end_users/{end_user_id_or_heron_id}/positions":{"get":{"description":"Returns positions with calculated metrics for an end user, optionally filtered by account IDs","parameters":[{"description":"The end user ID or heron ID","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Account IDs to filter positions by","in":"query","name":"account_ids","schema":{"items":{"type":"string"},"type":"array"}},{"description":"If true, include investment/repayment/reversal transactions on each position","in":"query","name":"include_transactions","schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserPositions"}}},"description":"Positions summary retrieved successfully"},"404":{"description":"End user not found"}},"summary":"Get positions summary for end user","tags":["Positions"]}},"/api/end_users/{end_user_id_or_heron_id}/positions/stale_overrides":{"get":{"description":"The latest edit to each position that was rebuilt since it was edited and could not be matched to a rebuilt position.","parameters":[{"description":"The end user ID or heron ID","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionOverrides"}}},"description":"Stale edits"},"404":{"description":"End user not found"}},"summary":"Get edits that no longer apply","tags":["Positions"]}},"/api/end_users/{end_user_id_or_heron_id}/processing_status":{"get":{"description":"Get the current processing status of an end user by heron_id or end_user_id. Returns whether the end user is currently being processed or has completed processing.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserProcessingStatusSchema"}}},"description":"Successfully retrieved processing status"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser processing status","tags":["EndUsers"]}},"/api/end_users/{end_user_id_or_heron_id}/profit_and_loss":{"get":{"description":"Calculates the cashflow profit & loss table for an end user, based on the layout defined (if any)\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"The earliest transaction timestamp date to use","in":"query","name":"from_date","required":false,"schema":{"example":"2022-01-01","format":"date","nullable":true,"type":"string"}},{"description":"The latest transaction timestamp date to use","in":"query","name":"to_date","required":false,"schema":{"example":"2022-01-31","format":"date","nullable":true,"type":"string"}},{"description":"If true, dates are sorted left to right by ascending order. False by default, i.e., by default sorted in descending date order so more recent dates are first","in":"query","name":"dates_ascending","required":false,"schema":{"default":false,"type":"boolean"}},{"description":"ISO 4217 currency code for balance","in":"query","name":"currency","required":false,"schema":{"enum":["GBP","USD","EUR","CAD","AUD",null],"example":"USD","nullable":true,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfitAndLossSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser cashflow P&L","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/profit_and_loss_layout":{"put":{"description":"Update the profit and loss layout for the end user, which determines how the profit and loss table is calculated\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfitAndLossLayoutUpdateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfitAndLossLayoutSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update EndUser P&L layout","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/recurring_transactions_report":{"get":{"description":"Get a report of recurring transactions grouped by merchant or counterparty for an end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Account ids to include in the report, if not provided, all accounts are included","explode":true,"in":"query","name":"account_ids","required":false,"schema":{"items":{"example":"1234","type":"string"},"nullable":true,"type":"array"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EndUserRecurringTransactionsReport"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser recurring transactions report","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/saltedge":{"post":{"description":"Upload Salt Edge CSV in JSON for a specified end user to translate into Heron Data format and add transactions for the end user\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/SaltEdgeCsvSchema"},"type":"array"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"_summary":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload Salt Edge CSV","tags":["EndUserIntegrations"],"x-hidden":true}},"/api/end_users/{end_user_id_or_heron_id}/scorecard":{"get":{"description":"Get scorecard metrics and rule violations for a user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Cut-off date to consider transactions to for calculating scorecard (inclusive)","in":"query","name":"date","required":false,"schema":{"example":"2023-01-19","format":"date","nullable":true,"type":"string"}},{"description":"Qualitative description for date to calculate scorecard","in":"query","name":"named_date","required":false,"schema":{"enum":["end_user_created","end_user_last_updated","last_transaction","end_user_last_enriched","last_data_source_end_date_or_transaction_timestamp","custom_date",null],"example":"end_user_created","nullable":true,"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"metrics":{"items":{"$ref":"#/components/schemas/Metric"},"type":"array"},"rule_violations":{"items":{"$ref":"#/components/schemas/RuleViolation"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser scorecard","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/scorecard/async":{"post":{"description":"Request scorecard metrics for a date and end user","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Cut-off date to consider transactions to for calculating scorecard (inclusive)","in":"query","name":"date","required":true,"schema":{"example":"2023-01-19","format":"date","type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Request EndUser scorecard","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/start_workflow":{"post":{"description":"Starts your configured Heron workflow for an end user","parameters":[{"description":"The end user's ID or heron_id","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"}},"type":"object"}}},"description":"Heron workflow triggered successfully"},"404":{"description":"End user not found"},"429":{"description":"Start Workflow called too often for this user"}},"security":[{"ApiKeyAuth":[]}],"summary":"Start Workflow","tags":["EndUserFiles"]}},"/api/end_users/{end_user_id_or_heron_id}/tags":{"get":{"description":"Return the tags currently applied to the end user, ordered by name.","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"tags":{"items":{"$ref":"#/components/schemas/TagSchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List an end user's tags","tags":["Tags"]},"post":{"description":"Add the given tags to the end user, leaving any tags already applied in place. Re-sending a tag that is already applied is a no-op, so retries are safe. Every tag heron_id must exist, otherwise none are applied. Where your access is restricted by tag, you can only add tags you hold.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserTagsSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"tags":{"items":{"$ref":"#/components/schemas/TagSchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"End user not found"},"422":{"description":"A tag is unknown, or is outside your access scope"}},"security":[{"ApiKeyAuth":[]}],"summary":"Add tags to an end user","tags":["Tags"]},"put":{"description":"Set the end user's tags to exactly the tags given, adding and removing as needed. Send an empty list to clear every tag. Every tag heron_id must exist, otherwise nothing changes. Where your access is restricted by tag, this replaces only the tags you hold: any other tag already on the end user stays applied, so the response can include tags you did not send.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserTagsSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"tags":{"items":{"$ref":"#/components/schemas/TagSchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"End user not found"},"422":{"description":"A tag is unknown, or is outside your access scope"}},"security":[{"ApiKeyAuth":[]}],"summary":"Replace an end user's tags","tags":["Tags"]}},"/api/end_users/{end_user_id_or_heron_id}/tags/{tag_heron_id}":{"delete":{"description":"Remove one tag from the end user. Removing a tag that is not applied succeeds, so retries are safe. The tag itself is not deleted. Where your access is restricted by tag, you can only remove tags you hold.\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"tag_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"No Content"},"404":{"description":"End user not found"},"422":{"description":"The tag is unknown, or is outside your access scope"}},"security":[{"ApiKeyAuth":[]}],"summary":"Remove a tag from an end user","tags":["Tags"]}},"/api/end_users/{end_user_id_or_heron_id}/transaction_data_coverage":{"get":{"description":"Information about dates covered by any transaction data source","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"start_date","required":true,"schema":{"format":"date","type":"string"}},{"in":"query","name":"end_date","required":true,"schema":{"format":"date","type":"string"}},{"in":"query","name":"include_disabled_data_sources","required":false,"schema":{"default":true,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserTransactionDataCoverageSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get EndUser transaction data coverage","tags":["EndUserCalculations"]}},"/api/end_users/{end_user_id_or_heron_id}/transactions":{"get":{"description":"Get all unique transactions for a single end user. Set end user status to \"ready\" to initiate transaction enrichment, otherwise may contain both enriched and unenriched transactions\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}},{"description":"Filter for transactions whose values were last updated in Heron systems after the specified input value, isoformat","in":"query","name":"last_updated_min","required":false,"schema":{"example":"2026-02-26T09:30:00+00:00","format":"date-time","nullable":true,"type":"string"}},{"description":"Results page","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"description":"Desired results per page","in":"query","name":"per_page","required":false,"schema":{"default":100,"maximum":50000,"minimum":1,"type":"integer"}},{"description":"Account ids to include. If not provided, all accounts are included","explode":true,"in":"query","name":"account_ids","required":false,"schema":{"items":{"example":"1234","type":"string"},"nullable":true,"type":"array"},"style":"form"},{"description":"Filter by the heron_id of the category that the transaction is annotated with","explode":true,"in":"query","name":"category_heron_id","required":false,"schema":{"default":[],"example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","items":{"type":"string"},"nullable":true,"type":"array"},"style":"form"},{"description":"Filter by data source Heron ID","in":"query","name":"data_source_heron_id","required":false,"schema":{"type":"string"}},{"description":"What to order transactions by","in":"query","name":"order_by","required":false,"schema":{"default":"id_asc","enum":["amount_asc","amount_desc","abs_amount_asc","abs_amount_desc","description_asc","description_desc","timestamp_asc","timestamp_desc","id_asc","id_desc","confidence_asc","confidence_desc","created_asc","created_desc"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"$ref":"#/components/schemas/Pagination"},"transactions_enriched":{"items":{"$ref":"#/components/schemas/TransactionEnriched"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get end user transactions","tags":["EnrichedTransactions"]},"post":{"description":"Upload transactions for a specific end user. Does not include enriching transactions -- set end user status = 'ready' to initiate processing. For synchronous enrichment, please instead use \"Enrich transactions (sync). Either timestamp (preferred) or date must be present in the transaction payload.\"\n","parameters":[{"in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EndUserTransactionsPostAsyncSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"},"transactions_loaded":{"description":"The number of transactions loaded","type":"integer"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create end user transactions (async)","tags":["Transactions"]}},"/api/end_users/{end_user_id_or_heron_id}/trigger_file_processing":{"post":{"description":"Starts your configured Heron workflow for an end user","parameters":[{"description":"The end user's ID or heron_id","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"success":{"type":"boolean"}},"type":"object"}}},"description":"Heron workflow triggered successfully"},"404":{"description":"End user not found"},"429":{"description":"Start Workflow called too often for this user"}},"security":[{"ApiKeyAuth":[]}],"summary":"Start Workflow","tags":["EndUserFiles"],"x-hidden":true}},"/api/end_users/{end_user_id_or_heron_id}/yodlee":{"post":{"description":"Upload Yodlee JSON files for a specified end user to translate into Heron Data format and add transactions for the end user\n","parameters":[{"description":"The `end_user_id` or `heron_id` of EndUser to upload","in":"path","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/YodleeSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"_summary":{"properties":{"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload Yodlee","tags":["EndUserIntegrations"]}},"/api/end_users/{heron_id}/crm_sync":{"get":{"parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CrmSyncEventSchema"},"type":"array"}}},"description":"The list of CRM events that occurred for this end user"}},"security":[{"ApiKeyAuth":[]}],"summary":"Retrieve CRM sync events for an end user","tags":["EndUsers"]},"post":{"parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"properties":{"crm_sync_triggered":{"type":"boolean"},"heron_id":{"description":"The Heron ID of the End User","type":"string"}},"type":"object"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Trigger a CRM Sync for an End User","tags":["EndUsers"]}},"/api/entities/post_processors":{"get":{"description":"Returns a list of all available post processors that can be applied to entity attributes","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostProcessorsResponseSchema"}}},"description":"List of available post processor and configurations"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get all available post processors","tags":["EndUserEntity"],"x-hidden":true}},"/api/funder_exclusion_rules/":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CustomerFunderExclusionRuleSchema"},"type":"array"}}},"description":"Customer funder exclusion rules"},"404":{"description":"Broker customer not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List funder exclusion rules"}},"/api/funder_exclusion_rules/bulk/":{"delete":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkFunderExclusionRuleTargetSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BulkFunderExclusionRuleResultSchema"},"type":"array"}}},"description":"Outcome per deduplicated funder, in request order; key by funder_heron_id, not index"},"404":{"description":"Broker customer, funder, or funder exclusion rule not found"},"422":{"description":"Invalid request body"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete many funder exclusion rules"},"patch":{"description":"A rule left with no senders is deleted.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkFunderExclusionRuleUpdateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BulkFunderExclusionRuleResultSchema"},"type":"array"}}},"description":"Outcome per deduplicated funder, in request order; key by funder_heron_id, not index"},"400":{"description":"Nothing to add or remove"},"404":{"description":"Broker customer, funder, or funder exclusion rule not found"},"422":{"description":"Invalid request body"}},"security":[{"ApiKeyAuth":[]}],"summary":"Add and remove sender matchers across many funder exclusion rules"},"post":{"description":"Creates a rule for each funder without one, and unions the senders into the rest.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkFunderExclusionRuleCreateSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/BulkFunderExclusionRuleResultSchema"},"type":"array"}}},"description":"Outcome per deduplicated funder, in request order; key by funder_heron_id, not index"},"400":{"description":"Missing sender matcher"},"404":{"description":"Broker customer or funder not found"},"422":{"description":"Invalid request body"}},"security":[{"ApiKeyAuth":[]}],"summary":"Add sender matchers to many funder exclusion rules"}},"/api/funder_exclusion_rules/{funder_heron_id}/":{"delete":{"parameters":[{"in":"path","name":"funder_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Message"}}},"description":"Deleted funder exclusion rule"},"404":{"description":"Broker customer or rule not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete a funder exclusion rule"},"put":{"parameters":[{"in":"path","name":"funder_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerFunderExclusionRuleInputSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CustomerFunderExclusionRuleSchema"}}},"description":"Replaced funder exclusion rule"},"400":{"description":"Invalid matcher"},"404":{"description":"Broker customer or funder not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create or replace a funder exclusion rule"}},"/api/funder_integrations/":{"get":{"description":"Returns one entry per linked integration (API/portal) funder, with its current state, configuration, and last test result.\n","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FunderIntegrationViewSchema"},"type":"array"}}},"description":"List of funder integration states"}},"security":[{"ApiKeyAuth":[]}],"summary":"List funder integration states for the current broker"},"post":{"description":"Links a funder the broker can configure. Returns the new entry in the same shape as `GET /api/funder_integrations/`.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AddFunderIntegrationRequestSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunderIntegrationViewSchema"}}},"description":"Funder linked"},"400":{"description":"Funder not supported for self-service"},"404":{"description":"Funder not found"},"409":{"description":"Broker is already linked to this funder"}},"security":[{"ApiKeyAuth":[]}],"summary":"Link a funder to the current broker for self-service"}},"/api/funder_integrations/candidates/":{"get":{"description":"Returns the funders the broker can link but hasn't yet, sorted alphabetically.\n","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FunderCandidateSchema"},"type":"array"}}},"description":"List of available funders"}},"security":[{"ApiKeyAuth":[]}],"summary":"List funders available for self-service that the broker hasn't linked yet"}},"/api/funder_integrations/{funder_heron_id}/":{"delete":{"description":"With an `environment`, deletes that environment's saved integration. With `remove=true`, removes the funder entirely. Exactly one of the two must be given: full removal is destructive (scrubs credentials and deletes the funder's policies row), so it must be requested explicitly \u2014 an absent or mistyped `environment` must never escalate into it.\n","parameters":[{"in":"path","name":"funder_heron_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"environment","required":false,"schema":{"enum":["staging","production"],"type":"string"}},{"in":"query","name":"remove","required":false,"schema":{"type":"boolean"}}],"responses":{"204":{"description":"Funder removed, or environment integration deleted"},"400":{"description":"Neither `environment` nor `remove=true` given, or both given"},"404":{"description":"Funder not linked, or no integration configured for this environment"},"409":{"description":"Funder cannot be removed due to active API keys"}},"security":[{"ApiKeyAuth":[]}],"summary":"Remove a funder, or delete one environment's saved integration"},"patch":{"description":"Saves the funder's submission email address and CC list, and optionally switches its submission channel (integration or email). An omitted or null `channel` keeps the current channel, so email-field saves can never change how deals are routed. Returns the updated funder entry.\n","parameters":[{"in":"path","name":"funder_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateFunderIntegrationRequestSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunderIntegrationViewSchema"}}},"description":"Funder updated"},"400":{"description":"Invalid input (unsupported channel, malformed email)"},"404":{"description":"Funder not linked to current broker"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update a funder's submission channel and email configuration"},"put":{"description":"Saves the funder's staging or production configuration.\n","parameters":[{"in":"path","name":"funder_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SaveFunderIntegrationRequestSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunderIntegrationSaved"}}},"description":"Integration saved"},"400":{"description":"Invalid input (missing fields, unsupported funder, promotion gate)"},"404":{"description":"Funder not linked to current broker"}},"security":[{"ApiKeyAuth":[]}],"summary":"Save staging or production form values for a funder integration"}},"/api/funder_integrations/{funder_heron_id}/test/":{"post":{"description":"Submits the synthetic test end user to the selected funder environment. Returns the funder submission Heron ID. Frontend polls `/funder_submissions/{id}/` for the result.\n","parameters":[{"in":"path","name":"funder_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerTestRequestSchema"}}},"required":false},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TriggerTestResponseSchema"}}},"description":"Test triggered"},"400":{"description":"Credentials not configured"},"404":{"description":"Funder not linked to current broker"},"409":{"description":"A test is already in progress for this funder"}},"security":[{"ApiKeyAuth":[]}],"summary":"Trigger a staging or production test submission for this funder"}},"/api/funder_submissions/":{"post":{"description":"Find or create a funder submission for the given end user and funder pair. Returns the existing submission if one already exists (unique per end_user + funder).\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpsertFunderSubmissionRequestSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunderSubmissionSchema"}}},"description":"Funder submission found or created"},"404":{"description":"End user or funder not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upsert a funder submission"}},"/api/funder_submissions/{submission_heron_id}/":{"get":{"description":"Returns the status and details of a funder submission. Use this to poll after triggering a submission.","parameters":[{"description":"The Heron ID of the funder submission","in":"path","name":"submission_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunderSubmissionSchema"}}},"description":"Funder submission details"},"404":{"description":"Funder submission not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get funder submission status"}},"/api/funder_submissions/{submission_heron_id}/trigger/":{"post":{"description":"Triggers an async submission to a funder. Returns 202 immediately; poll via GET /funder_submissions/{submission_heron_id}/ to check progress. Set resend=true with use_sandbox=false to submit a previously sent or declined lane with a successful production attempt again.\n","parameters":[{"description":"The Heron ID of the funder submission","in":"path","name":"submission_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitFunderSubmissionRequestSchema"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FunderSubmissionSchema"}}},"description":"Submission accepted and queued for processing"},"400":{"description":"Submission has a non-submittable status"},"404":{"description":"Funder submission not found"},"409":{"description":"Submission is already in progress"},"503":{"description":"Submission could not be queued"}},"security":[{"ApiKeyAuth":[]}],"summary":"Trigger a funder submission"}},"/api/funders/":{"get":{"description":"Returns funders whose name or aliases fuzzy-match `q`, capped at `limit` (max 50).\nRequires `q` (min 3 characters); bulk listing is no longer supported.\n","parameters":[{"description":"Funder name (or alias) prefix/fuzzy search term.","in":"query","name":"q","required":true,"schema":{"minLength":3,"type":"string"}},{"description":"Maximum number of matching funders to return (capped server-side).","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":50,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Funder"},"type":"array"}}},"description":"Matching funders sorted by similarity descending."}},"security":[{"ApiKeyAuth":[]}],"summary":"Search funders by name","tags":["Funders"]}},"/api/funders/linked":{"get":{"description":"Get a list of funders linked to the current user","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/Funder"},"type":"array"}}},"description":"List of user's linked funders"}},"security":[{"ApiKeyAuth":[]}],"summary":"List your linked funders","tags":["Funders"]}},"/api/funders/search/":{"get":{"description":"Search the Heron funder database by name using fuzzy matching. Returns a lightweight list of matching funders for the frontend picker UI.\n","parameters":[{"description":"Funder name to search for (e.g. 'iwoca', 'Funding Circle')","in":"query","name":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FunderSearchResultSchema"},"type":"array"}}},"description":"List of matching funders"}},"security":[{"ApiKeyAuth":[]}],"summary":"Search funders by name"}},"/api/funders/{heron_id}":{"get":{"description":"Get details of a specific funder by heron_id","parameters":[{"description":"The funder's heron_id","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"funder":{"$ref":"#/components/schemas/Funder"}},"type":"object"}}},"description":"Funder details"},"404":{"description":"Funder not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get a single funder","tags":["Funders"]}},"/api/hello_world":{"get":{"description":"Test endpoint (no authentication)","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"hello":{"type":"string"}},"type":"object"}}},"description":"url works"}},"tags":["Testing"]}},"/api/hello_world/authenticated":{"get":{"description":"Test authentication","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"hello":{"type":"string"}},"type":"object"}}},"description":"Authentication works"},"401":{"description":"Unauthorized"}},"security":[{"ApiKeyAuth":[]}],"tags":["Testing"]}},"/api/hello_world/oauth":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"hello":{"type":"string"},"organization_id":{"type":"string"},"scopes":{"items":{"type":"string"},"type":"array"},"subject":{"type":"string"}},"type":"object"}}},"description":"Token grants identity:read; no Heron tenant authorization is performed"},"401":{"description":"Missing or invalid OAuth token"},"403":{"description":"Token lacks identity:read"},"503":{"description":"OAuth configuration or signing keys unavailable"}},"security":[{"OAuthBearer":[]}],"summary":"Verify an OAuth token without accessing customer data","tags":["Testing"],"x-hidden":true}},"/api/hello_world/oauth/{endpoint_id}":{"get":{"parameters":[{"description":"heron_id of an MCP endpoint","in":"path","name":"endpoint_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"environment":{"type":"string"},"environment_type":{"type":"string"},"hello":{"type":"string"},"organization_slug":{"type":"string"},"subject":{"type":"string"}},"type":"object"}}},"description":"The token's member may act on this environment"},"401":{"description":"Missing or invalid OAuth token"},"403":{"description":"Token lacks identity:read, or the member's roles do not cover the environment"},"404":{"description":"No MCP endpoint with that id belongs to the token's organization"},"503":{"description":"OAuth configuration, signing keys or member directory unavailable"}},"security":[{"OAuthBearer":[]}],"summary":"Resolve an OAuth token plus an MCP endpoint to the Heron environment it may act on","tags":["Testing"],"x-hidden":true}},"/api/ingestion/crm/{crm_integration_heron_id}":{"post":{"description":"Receives a webhook payload from a CRM integration and syncs the end user via the ingestion pipeline. Per-CRM payload shapes are parsed by the matching CRM client; only the generic ingestion controls documented below are read directly here.\n","parameters":[{"description":"Heron ID of the CRM integration","in":"path","name":"crm_integration_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"start_workflow":{"default":false,"description":"When true, entity data nudges the policy workflow only if no files are saved. Saved files start the workflow through their classification pipeline. Broker callers omit it because their submission trigger owns workflow progress.\n","type":"boolean"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"end_user_heron_id":{"type":"string"}},"type":"object"}}},"description":"End user successfully ingested"},"400":{"description":"Invalid payload or unsupported CRM provider"},"404":{"description":"CRM integration not found"}},"summary":"Ingest end user data from a CRM webhook"}},"/api/integration_links/{item_id}":{"put":{"description":"Allows refreshing the access_token of an existing Integration Link","parameters":[{"in":"path","name":"item_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationLinkUpdateSchema"}}},"description":"IntegrationLink","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"integration_link":{"$ref":"#/components/schemas/IntegrationLinkSchema"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update an Integration Link","tags":["Integrations"]}},"/api/integrations":{"get":{"description":"Get a list of Integrations. Each `client_id` and `client_secret` is masked: `****` plus its last four characters when it is at least 16 characters long, otherwise `****`. The full values are returned only when the integration is created.\n","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"integrations":{"items":{"$ref":"#/components/schemas/IntegrationSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"List Integrations","tags":["Integrations"]},"post":{"description":"Create an integration e.g. with Plaid. The full `client_id` and `client_secret` are returned only in this response; every later read returns them masked: `****` plus the last four characters when the value is at least 16 characters long, otherwise `****`.\n","requestBody":{"content":{"application/json":{"schema":{"properties":{"integration":{"$ref":"#/components/schemas/IntegrationSchema"}},"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"integration":{"$ref":"#/components/schemas/IntegrationCreatedSchema"}},"type":"object"}}},"description":"Created. The full `client_id` and `client_secret` are returned only in this response."},"409":{"description":"The user already requested Experian Connector setup."},"422":{"description":"The integration, or its `setup_metadata` for this type, is not valid."}},"security":[{"ApiKeyAuth":[]}],"summary":"Create an integration","tags":["Integrations"]}},"/api/integrations/enrich_addresses":{"post":{"requestBody":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EnrichAddressesSchema","type":"object"},"type":"array"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/EnrichedAddressSchema","type":"object"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Enrich Addresses via SmartyStreets","tags":["Integrations"],"x-hidden":true}},"/api/integrations/pdfs/{heron_id}":{"get":{"description":"Retrieve a single PDF document by its heron_id. Returns the PDF metadata, status information, and optionally the processed statements/transactions. Users can only access their own PDFs.\n","parameters":[{"description":"The heron_id of the PDF to retrieve","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}},{"description":"Include processed statements/transactions in the response","in":"query","name":"with_processed_results","required":false,"schema":{"default":false,"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"pdf":{"$ref":"#/components/schemas/PdfGetSchema"}},"type":"object"}}},"description":"Successfully retrieved PDF"},"404":{"content":{"application/json":{"schema":{"properties":{"message":{"example":"no pdf with heron_id=example_id found","type":"string"}},"type":"object"}}},"description":"PDF not found or user does not have access"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get single PDF by heron_id","tags":["EndUserIntegrations"]},"put":{"description":"Update PDF attributes including status\n","parameters":[{"description":"heron_id of the pdf","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PdfPutSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"pdf":{"$ref":"#/components/schemas/PdfGetSchema"},"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update PDF attributes including status","tags":["EndUserIntegrations"]}},"/api/integrations/pdfs/{heron_id}/processed":{"patch":{"description":"Send patch transactions processed pdf that will override the extracted transactions in the specified statement\n","parameters":[{"description":"heron_id of the pdf","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PdfStatementPatchSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"ok":{"type":"boolean"}},"type":"object"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Send patch transactions for a pdf statement","tags":["EndUserIntegrations"]}},"/api/integrations/pdfs/{heron_id}/reload_transactions":{"post":{"description":"This will load transactions for the pdf that is in a transactions unloaded status\n","parameters":[{"description":"heron_id of the pdf","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"ok":{"type":"boolean"}},"type":"object"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Reloads transactions for a pdf","tags":["EndUserIntegrations"]}},"/api/integrations/pdfs/{heron_id}/unload_transactions":{"post":{"description":"This will delete all transactions that were previously loaded for the pdf\n","parameters":[{"description":"heron_id of the pdf","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"ok":{"type":"boolean"}},"type":"object"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Unloads transactions for a pdf","tags":["EndUserIntegrations"]}},"/api/integrations/pdfs/{heron_id}/update_currency":{"post":{"description":"Update the currency for a PDF and all its statement summaries. The PDF must be in transactions_unloaded status.\n","parameters":[{"description":"heron_id of the PDF","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PdfDefaultCurrencyUpdateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"ok":{"type":"boolean"},"pdf":{"$ref":"#/components/schemas/PdfGetSchema"},"request_id":{"description":"Unique UUID per request","type":"string"}},"type":"object"}}},"description":"PDF currency updated successfully"},"400":{"description":"Bad request - PDF not in correct status"},"404":{"description":"PDF not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update PDF currency","tags":["EndUserIntegrations"]}},"/api/integrations/{heron_id}":{"put":{"description":"Update an Integration. The response masks `client_id` and `client_secret`: `****` plus its last four characters when it is at least 16 characters long, otherwise `****`. Sending a masked value back leaves the stored value unchanged; send a new value to replace it.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"integration":{"properties":{"base_url":{"format":"url","nullable":true,"type":"string"},"client_auth":{"additionalProperties":true,"type":"object"},"client_id":{"nullable":true,"type":"string"},"client_secret":{"nullable":true,"type":"string"},"name":{"type":"string"},"resource":{"enum":["transaction","assets_report","end_user_application","invoice_factoring_processing","end_user_files","funder_decision"],"type":"string"},"setup_metadata":{"additionalProperties":true,"description":"Only the keys to change","type":"object"},"type":{"type":"string"},"webhook_url":{"format":"url","nullable":true,"type":"string"}},"type":"object"}},"type":"object"}}},"description":"Integration fields to change; omitted fields are left as they are","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"integration":{"$ref":"#/components/schemas/IntegrationSchema"}},"type":"object"}}},"description":"OK"},"400":{"description":"A change of type"},"404":{"description":"Integration not found"},"422":{"description":"Invalid fields"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update Integration","tags":["Integrations"]}},"/api/integrations/{heron_id}/links":{"delete":{"description":"Soft-deletes of an integration link (sync is disabled)","parameters":[{"description":"The Integration's heron_id","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}},{"description":"Delete that end user's IntegrationLinks","in":"query","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"(Soft-)Delete an integration link","tags":["Integrations"]},"get":{"description":"Get a list of IntegrationLinks for an Integration filtered by end user","parameters":[{"description":"The Integration's heron_id","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}},{"description":"Return only IntegrationLinks for that end user","in":"query","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"links":{"items":{"$ref":"#/components/schemas/IntegrationLinkSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get IntegrationLinks by Integration","tags":["Integrations"]},"post":{"description":"Create a Link for an active Integration every time a customer connects their bank. In Plaid, this is a Plaid Link every time a customer connects their bank. For Plaid, call this after exchanging a public token for an Item access_token.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationLinkSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"link":{"$ref":"#/components/schemas/IntegrationLinkNewSchema"}},"type":"object"}}},"description":"Created"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create an integration Link","tags":["Integrations"]},"put":{"description":"Refresh assets reports for an integration and specific end user. This will trigger a refresh operation for all active Plaid assets report links associated with the integration and end user.\n","parameters":[{"description":"The Integration's heron_id","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}},{"description":"Filter to refresh only links for this specific end user","in":"query","name":"end_user_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationLinkRefreshSchema"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshAssetsReportsResponseSchema"}}},"description":"Assets reports refresh completed successfully"},"404":{"description":"Integration not found or no assets reports found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RefreshAssetsReportsResponseSchema"}}},"description":"Some assets reports failed to refresh (partial success)"}},"security":[{"ApiKeyAuth":[]}],"summary":"Refresh assets reports for integration links","tags":["Integrations"]}},"/api/integrations/{heron_id}/links/{link_item_id}/refresh":{"post":{"description":"Trigger a refresh operation for an IntegrationLink. A link can be refreshed once every 6 hours.","parameters":[{"description":"The Integration's heron_id","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}},{"description":"The IntegrationLink's item_id","in":"path","name":"link_item_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IntegrationLinkRefreshSchema"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"link":{"$ref":"#/components/schemas/IntegrationLinkSchema"}},"type":"object"}}},"description":"OK"},"400":{"description":"assets_report_days_to_sync was sent for a link that is not a Plaid assets report"},"409":{"description":"The link was deleted in Plaid, or a sync is already running"},"429":{"description":"The link synced in the last 6 hours"}},"security":[{"ApiKeyAuth":[]}],"summary":"Refresh an IntegrationLink","tags":["Integrations"]}},"/api/interaction_logs":{"post":{"description":"Log a user interaction from the frontend.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateInteractionLogSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"interaction_log":{"$ref":"#/components/schemas/InteractionLogResponseSchema"}},"required":["interaction_log"],"type":"object"}}},"description":"Interaction log created"},"404":{"description":"End user not found"}},"summary":"Create an interaction log","tags":["Interaction Logs"],"x-hidden":true}},"/api/iso_applications/":{"post":{"description":"Use this endpoint to upload an ISO application PDF. Once uploaded, the file will be automatically scrubbed asynchronously. You can use the returned heron_id (prefixed \"iso_\") to fetch the scrubbing results from the GET endpoint below. Please contact support@herondata.io to enable this endpoint.\n","requestBody":{"content":{"multipart/form-data":{"schema":{"properties":{"file":{"format":"binary","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"heron_id":{"description":"e.g. iso_","type":"string"},"status":{"enum":["processing"],"type":"string"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload an ISO application PDF for automated scrubbing in under 15 seconds","tags":["ISOApplication"]}},"/api/iso_applications/base64":{"post":{"description":"This endpoint is for uploading ISO application PDFs in base64 format.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PostIsoApplicationBase64Schema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"heron_id":{"description":"e.g. iso_","type":"string"},"status":{"enum":["processing"],"type":"string"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Upload an ISO application PDF for automated scrubbing in under 15 seconds (base64)","tags":["ISOApplication"]}},"/api/iso_applications/reprocess/{heron_id}":{"post":{"description":"Use this endpoint to trigger reprocessing of a specific ISO application. This will re-run the parsing and validation process for the specified application.\n","parameters":[{"description":"The heron_id of the ISO application to reprocess","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Reprocessing queued"}},"security":[{"ApiKeyAuth":[]}],"summary":"Reprocess a single ISO application","tags":["ISOApplication"]}},"/api/iso_applications/{heron_id}":{"get":{"description":"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\".\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetIsoApplicationSchema"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get the scrubbed results and data validations of an uploaded ISO application by its heron_id (prefixed \"iso_\")","tags":["ISOApplication"]}},"/api/mcp/{endpoint_id}":{"post":{"parameters":[{"description":"heron_id of the MCP endpoint naming the environment to act on","in":"path","name":"endpoint_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object"},{"items":{"type":"object"},"type":"array"}]}}},"description":"A JSON-RPC 2.0 request or notification","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"oneOf":[{"type":"object"},{"items":{"type":"object"},"type":"array"}]}}},"description":"JSON-RPC response, or an array of responses to a batch"},"202":{"description":"Notification accepted"},"400":{"description":"Invalid JSON-RPC request"},"429":{"description":"The member has used this environment's MCP budget; retry after Retry-After seconds"}},"security":[{"OAuthBearer":[]}],"summary":"MCP JSON-RPC endpoint authenticated with an OAuth access token","tags":["MCP"],"x-hidden":true}},"/api/mcp_endpoints":{"get":{"description":"Each endpoint names this environment in an MCP server URL by its id. The MCP client authenticates the caller\nwith OAuth.\n","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"endpoints":{"items":{"$ref":"#/components/schemas/McpEndpointSchema"},"type":"array"}},"type":"object"}}},"description":"The environment's endpoints"}},"summary":"List MCP endpoints","tags":["MCP endpoints"],"x-hidden":true},"post":{"description":"Creates an endpoint for this environment. Its id becomes part of the MCP server URL. With\nrequire_request_secret, the response carries a secret, shown once, that every MCP request to the endpoint must\nsend in the X-Auth-Token header.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateMcpEndpointSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/McpEndpointCreatedSchema"}}},"description":"Endpoint created"},"403":{"description":"Only the organization's admins can manage MCP endpoints"},"422":{"description":"Invalid label"}},"summary":"Create an MCP endpoint","tags":["MCP endpoints"],"x-hidden":true}},"/api/mcp_endpoints/{heron_id}":{"delete":{"description":"Deletes the endpoint. Its MCP server URL stops resolving immediately.","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Endpoint deleted"},"403":{"description":"Only the organization's admins can manage MCP endpoints"},"404":{"description":"Endpoint not found"}},"summary":"Delete an MCP endpoint","tags":["MCP endpoints"],"x-hidden":true}},"/api/merchants/extract":{"post":{"description":"Extract Merchant from a transaction description","requestBody":{"content":{"application/json":{"schema":{"properties":{"description":{"example":"PAYPAL* AMZN Mktp 198748320","type":"string"}},"required":["description"],"type":"object"}}},"description":"The bank transaction description as a string"},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"description_clean":{"example":"Amzn Mktp","nullable":true,"type":"string"},"merchant":{"$ref":"#/components/schemas/MerchantExtract","nullable":true},"payment_processor":{"$ref":"#/components/schemas/PaymentProcessor","nullable":true}},"type":"object"}}},"description":"The `merchant` key is not null when we find a positive match to our database. When we could not match a merchant, `merchant` is null and `description_clean` is set to a substring of the original description that our models identified as the relevant entity.\n"}},"security":[{"ApiKeyAuth":[]}],"summary":"Extract merchant","tags":["Merchants"]}},"/api/merchants/groups":{"get":{"description":"Get Merchant groups","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/MerchantGroup"},"type":"array"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"List merchant groups","tags":["Merchants"]}},"/api/merchants/list":{"get":{"description":"Get a paginated list of merchants with optional name and group_id filtering. Results are ordered by merchant ID for stable pagination.","parameters":[{"description":"Filter merchants by name (full or partial match)","in":"query","name":"name","required":false,"schema":{"type":"string"}},{"description":"Filter merchants by group ID","in":"query","name":"group_id","required":false,"schema":{"type":"string"}},{"description":"Number of merchants to return per page","in":"query","name":"limit","required":false,"schema":{"default":50,"maximum":200,"minimum":1,"type":"integer"}},{"description":"Number of merchants to skip","in":"query","name":"offset","required":false,"schema":{"default":0,"minimum":0,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"data":{"items":{"$ref":"#/components/schemas/MerchantList"},"type":"array"},"has_more":{"type":"boolean"},"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}},"type":"object"}}},"description":"List of merchants with pagination metadata"}},"security":[{"ApiKeyAuth":[]}],"summary":"List merchants","tags":["Merchants"]}},"/api/merchants/search":{"get":{"description":"Search Merchants by name","parameters":[{"description":"Full or partial name, minimum 3 characters","in":"query","name":"name","required":true,"schema":{"type":"string"}},{"description":"If true, only returns priority merchants","in":"query","name":"only_priority","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"merchants":{"items":{"$ref":"#/components/schemas/Merchant"},"type":"array"}},"type":"object"}}},"description":"A list of up to 5 merchants which match the search term, sorted by descending order of their URL rank and the frequency this merchant has been seen historically.\n"}},"security":[{"ApiKeyAuth":[]}],"summary":"Search merchants","tags":["Merchants"]}},"/api/merchants/{heron_id}":{"get":{"description":"Get Merchant by heron_id","parameters":[{"description":"The Merchant `heron_id`","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"merchant":{"$ref":"#/components/schemas/Merchant"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get merchant by ID","tags":["Merchants"]}},"/api/merchants/{merchant_heron_id}/user_merchant_group":{"patch":{"description":"Update the group id for a merchant for the current user","parameters":[{"description":"The Merchant `heron_id`","in":"path","name":"merchant_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"group_id":{"example":"debt.mca_or_rbf","nullable":true,"type":"string"}},"required":["group_id"],"type":"object"}}},"description":"Group ID to assign to the merchant"},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserMerchantGroupSchema"}}},"description":"OK"},"404":{"description":"Merchant not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Set merchant group override","tags":["Merchants"]}},"/api/oauth/scopes":{"get":{"description":"Unauthenticated because consent happens before sign-in. Names and descriptions only: it describes permissions, it does not grant them.\n","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"scopes":{"additionalProperties":{"type":"string"},"type":"object"}},"type":"object"}}},"description":"Scope id to consent description"}},"security":[],"summary":"The OAuth scopes this API accepts and the words consent shows for each","tags":["OAuth"],"x-hidden":true}},"/api/oneschema/importer_token":{"get":{"description":"The dashboard passes `token` as `userJwt` and `client_id` as `clientId` when it opens the\nOneSchema importer. The token is signed with the OneSchema client secret and expires after an hour.\n","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OneSchemaImporterTokenSchema"}}},"description":"Token minted"},"503":{"description":"OneSchema is not configured in this environment"}},"summary":"Mint a short-lived OneSchema importer token for the current user","tags":["OneSchema"],"x-hidden":true}},"/api/policies":{"get":{"description":"Gets all policy definitions set up for a user\n","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PolicySchema"},"type":"array"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get all policy definitions","tags":["Policy"]}},"/api/policies/progress":{"post":{"description":"Triggers the policy progression workflow for a specific end user\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProgressPolicySchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"ok":{"example":true,"type":"boolean"}},"type":"object"}}},"description":"Ok"},"404":{"description":"End user not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Progress policies for an end user","tags":["Policy"]}},"/api/policy/{heron_id}":{"delete":{"parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequiredMessage"}}},"description":"Deleted"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RequiredError"}}},"description":"Policy section not found for this account"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete a policy section","tags":["Policy"],"x-hidden":true}},"/api/policy_value_sets":{"get":{"description":"Keyed by value set, so a check's `attribute_value_set` looks its options up directly. Restricted-industry options come from your account's settings, and `crm_decline_reason` lists the codes a check's `decline_code` can take, named from your account's CRM integration.\n","responses":{"200":{"content":{"application/json":{"schema":{"additionalProperties":{"items":{"$ref":"#/components/schemas/ValueSetOptionSchema"},"type":"array"},"type":"object"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"The options for every finite-valued policy condition","tags":["Policy"],"x-hidden":true}},"/api/policy_version":{"delete":{"description":"Delete the draft. Active and archived versions cannot be deleted.","responses":{"204":{"description":"No Content"},"404":{"description":"No draft policy version"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete the draft policy version","tags":["Policy Versions"],"x-hidden":true},"get":{"description":"Return every policy version on your account, newest first, without their policy_definition payloads.\n","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"policy_versions":{"items":{"$ref":"#/components/schemas/PolicyVersionSummarySchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"Not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List policy versions","tags":["Policy Versions"]},"post":{"description":"Create a new draft cloned from the current active version's policy_definition, or a blank definition if there is no active version.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyVersionCreateSchema"}}},"required":false},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"policy_version":{"$ref":"#/components/schemas/PolicyVersionSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"Not found"},"422":{"description":"A draft already exists, or policy versions changed concurrently. When a draft exists, `errors` holds one entry with code `draft_exists` and the open draft's `draft_version`, `draft_author_email` and `draft_last_edited_at`. Nothing is changed: publish or delete that draft, or check with its author, before starting new changes. An automated sync should stop and tell someone rather than edit and publish a draft it didn't open."}},"security":[{"ApiKeyAuth":[]}],"summary":"Create a draft policy version","tags":["Policy Versions"]},"put":{"description":"Update the draft's policy_definition and/or change_description. Section names must be unique within the definition. Send each existing check's heron_id back: a check without one is saved as a new check with a new heron_id.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyVersionUpdateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"draft_revision":{"description":"Identifies the draft as saved. Send it to POST /policy_version/publish as expected_draft_revision to publish only this draft.\n","type":"string"},"issues":{"description":"What publishing this draft would break. Saving never blocks; an issue with blocks_publish set will stop the publish.\n","items":{"$ref":"#/components/schemas/PublishIssueSchema"},"type":"array"},"policy_version":{"$ref":"#/components/schemas/PolicyVersionSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"No draft policy version"},"422":{"content":{"application/json":{"schema":{"properties":{"description":{"type":"string"},"errors":{"items":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"items":{},"type":"array"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"The policy definition is invalid. `errors` lists every problem with the path of the field it belongs to, a stable code and a message.\n"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update the draft policy version","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/active":{"get":{"description":"Return the currently active policy version, including its policy_definition.","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"policy_version":{"$ref":"#/components/schemas/PolicyVersionSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"No active policy version"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get the active policy version","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/active/sections":{"get":{"description":"Return the name, ID and display order of each section of the active policy version, without its checks. Open to every member of the environment, whatever their policy role and whether or not the policy area is switched on, because the submissions list names these sections on every deal it returns.","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"policy_sections":{"items":{"$ref":"#/components/schemas/ActivePolicySectionSchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"No active policy version"}},"security":[{"ApiKeyAuth":[]}],"summary":"List the active policy version's sections","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/draft/archive":{"post":{"description":"Archive the open draft so a new one can be created. Nothing goes live, and the archived draft keeps its edits and lookup tables, so it can be restored with the rollback route. An automated sync that gets `draft_exists` from creating a draft archives the open draft this way, then creates its own, so the sync never publishes edits from the draft it archived. Edits made in the sync's new draft before it publishes do go live with it.\n","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"archived_version":{"type":"integer"}},"type":"object"}}},"description":"OK"},"404":{"description":"No draft policy version"},"422":{"description":"Policy versions changed concurrently, please retry"}},"security":[{"ApiKeyAuth":[]}],"summary":"Archive the draft policy version","tags":["Policy Versions"]}},"/api/policy_version/draft/check":{"patch":{"description":"Create a new draft from the active version with the check values you send. The live version can't be edited. Identify each check by its heron_id (from GET /policy_version/{version}). If a draft already exists, it is archived and its edits are not carried over. Checks you don't name keep their active values. All updates are validated first; if any fails, nothing is saved and the call returns 422 with every error listed. This does not publish the draft: call POST /policy_version/publish to make it live.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CheckValuesUpdateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"changed":{"type":"boolean"},"policy_version":{"$ref":"#/components/schemas/PolicyVersionSchema"}},"type":"object"}}},"description":"OK. `changed` is false when every value already matches the active version; then no draft is created and any existing draft is left as it is.\n"},"404":{"description":"No active policy version"},"422":{"content":{"application/json":{"schema":{"properties":{"description":{"type":"string"},"errors":{"items":{"properties":{"code":{"type":"string"},"message":{"type":"string"},"path":{"items":{},"type":"array"}},"type":"object"},"type":"array"}},"type":"object"}}},"description":"An update is invalid, or the policy versions changed concurrently. `errors` lists every problem with its path, a stable code and a message. Codes are check_not_found, unsupported_check_class, invalid_value and duplicate_check, plus the check's own validation codes (e.g. type_mismatch, out_of_range) when the new value breaks one of its rules.\n"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create a draft policy version with new check values","tags":["Policy Versions"]}},"/api/policy_version/draft/lookup_tables":{"post":{"description":"Create a lookup table and pin its first version in the draft policy version.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupTableCreateSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"lookup_table":{"$ref":"#/components/schemas/LookupTableSchema"}},"type":"object"}}},"description":"Created"},"404":{"description":"No draft policy version"},"422":{"description":"The table is invalid. `errors` lists every problem with the path of the field it belongs to, a stable code and a message."}},"security":[{"ApiKeyAuth":[]}],"summary":"Create a lookup table in the draft","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/draft/lookup_tables/{heron_id}":{"delete":{"description":"Unpin a lookup table from the draft policy version and delete its draft version. A table with no published version is deleted entirely, which frees its name. Published versions stay, because archived policy versions pin them.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Deleted"},"404":{"description":"No draft policy version, or the draft doesn't pin such a lookup table"},"422":{"description":"The table can't be deleted yet: it still has rows, or a check in the draft reads it. `errors` lists each reason with a path, a stable code and a message."}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete a lookup table from the draft","tags":["Policy Versions"],"x-hidden":true},"put":{"description":"Replace a lookup table's definition. Edits the table's draft version, or starts the next version and pins it in the draft when the pinned version is published. A table the draft doesn't pin is pinned again, starting from its newest version.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LookupTableUpdateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"lookup_table":{"$ref":"#/components/schemas/LookupTableSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"No draft policy version, or the account has no such lookup table"},"422":{"description":"The table is invalid. `errors` lists every problem with the path of the field it belongs to, a stable code and a message."}},"security":[{"ApiKeyAuth":[]}],"summary":"Update a lookup table in the draft","tags":["Policy Versions"]}},"/api/policy_version/draft/validate":{"post":{"description":"Runs every check saving the definition as the draft runs, and saves nothing. With no draft yet, it checks\nagainst the active version, which the first save copies. A definition that would save returns an empty\n`errors`.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyDefinitionValidateSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyDefinitionValidationSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Check a policy definition without saving it","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/lookup_tables":{"get":{"description":"Every lookup table the account has, at its newest version, whether or not a policy version pins it. Editing one the draft doesn't pin pins it in the draft.\n","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"column_type_value_sets":{"description":"Column types whose cells come from a value set, e.g. month_window","items":{"$ref":"#/components/schemas/ColumnTypeValueSetSchema"},"type":"array"},"lookup_tables":{"items":{"$ref":"#/components/schemas/LookupTableSummarySchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"List the account's lookup tables","tags":["Policy Versions"]}},"/api/policy_version/lookup_tables/{heron_id}/versions":{"get":{"description":"Every version of a lookup table, newest first, with whether the draft and active policy versions pin it. Definitions are left out; fetch one version for its definition. To restore an older version, update the table with that definition.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"versions":{"items":{"$ref":"#/components/schemas/LookupTableVersionSchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"The account has no such lookup table"}},"security":[{"ApiKeyAuth":[]}],"summary":"List a lookup table's versions","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/lookup_tables/{heron_id}/versions/{version}":{"get":{"description":"One version of a lookup table with its definition, and whether the draft and active policy versions pin it.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}},{"in":"path","name":"version","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"version":{"$ref":"#/components/schemas/LookupTableVersionDetailSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"The account has no such lookup table or version"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get one version of a lookup table","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/publish":{"post":{"description":"Make the draft the active version. The whole draft goes live, including any edits made in the dashboard, not only values set through the API. The previously active version is archived, and author_email becomes the publisher's email. Refused when a check reads data that no workflow path produces before its section's policy node. Send the draft_revision and active version you reviewed; the publish is refused if either changed since.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyVersionPublishSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"issues":{"description":"Warnings that did not stop the publish","items":{"$ref":"#/components/schemas/PublishIssueSchema"},"type":"array"},"policy_version":{"$ref":"#/components/schemas/PolicyVersionSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"No draft policy version"},"422":{"content":{"application/json":{"schema":{"properties":{"description":{"type":"string"},"errors":{"items":{"oneOf":[{"$ref":"#/components/schemas/PublishIssueSchema"},{"$ref":"#/components/schemas/ReviewedStateChangedErrorSchema"}]},"type":"array"}},"type":"object"}}},"description":"A concurrent change won the race, the reviewed draft or active version changed (one ReviewedStateChangedErrorSchema), or the draft has issues that block publishing.\n"}},"security":[{"ApiKeyAuth":[]}],"summary":"Publish the draft policy version","tags":["Policy Versions"]}},"/api/policy_version/publish/preview":{"post":{"description":"What publishing the draft would put live, without changing anything: the draft as it would be\nstored, the active version it replaces, which sections and lookup tables change, and the issues\npublishing would hit. Send policy_definition to preview unsaved edits, or omit it to preview\nthe saved draft.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishPreviewRequest"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PublishPreview"}}},"description":"OK"},"404":{"description":"No draft policy version, and no policy_definition sent"},"422":{"description":"The policy definition sent is invalid; save it to see each problem"}},"security":[{"ApiKeyAuth":[]}],"summary":"Preview publishing the draft","tags":["Policy Versions"]}},"/api/policy_version/workflow_summary":{"get":{"description":"Return the default workflow's latest published version laid out as the tree customers read: the parsers and enrichers that produce data and the active policy version's sections, with forks named by what decides them. Sections no workflow node evaluates are listed separately.","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyWorkflowSummarySchema"}}},"description":"OK"},"404":{"description":"Not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get the workflow summary","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/{version}":{"get":{"description":"Return a single policy version by number, including its policy_definition.","parameters":[{"in":"path","name":"version","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"policy_version":{"$ref":"#/components/schemas/PolicyVersionSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"Policy version not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get a policy version","tags":["Policy Versions"]}},"/api/policy_version/{version}/backtest":{"get":{"description":"Every backtest run against this version, newest first, with its result counts.","parameters":[{"in":"path","name":"version","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"backtests":{"items":{"$ref":"#/components/schemas/BacktestListingSchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"Policy version not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List a policy version's backtests","tags":["Policy Backtests"],"x-hidden":true},"post":{"description":"Compare a policy version over historical deals and return immediately with the run's id to poll. The baseline defaults to the account's active version. `as_evaluated` compares each deal with its newest stored section evaluations. A run whose workflow could not be started comes back with `status` failed and the reason in `error`.\n","parameters":[{"in":"path","name":"version","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestCreateSchema"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"backtest":{"$ref":"#/components/schemas/BacktestSchema"}},"type":"object"}}},"description":"The run was recorded; its `status` says whether the workflow started"},"403":{"description":"The member is limited to tagged submissions, and a backtest runs over every deal"},"404":{"description":"Policy version not found"},"422":{"description":"No active version to compare against"},"429":{"description":"The environment already has as many backtests running as it may"}},"security":[{"ApiKeyAuth":[]}],"summary":"Start a backtest of a policy version","tags":["Policy Backtests"],"x-hidden":true}},"/api/policy_version/{version}/backtest/count":{"post":{"description":"Return the matching count and the count retained after applying the run limit.","parameters":[{"in":"path","name":"version","required":true,"schema":{"type":"integer"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestSelectionSchema"}}},"required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/BacktestDealCountSchema"}}},"description":"Matching and selected deal counts"},"404":{"description":"Policy version not found"},"422":{"description":"Invalid deal selection"}},"security":[{"ApiKeyAuth":[]}],"summary":"Count deals matching a backtest selection","tags":["Policy Backtests"],"x-hidden":true}},"/api/policy_version/{version}/backtest/{heron_id}":{"get":{"description":"Poll a run. `recorded_deal_count` against `deal_count` is its progress, `result_counts` holds every evaluation_result bucket, and `changed_checks` names the checks behind the deals that moved. A failed run carries the reason in `error`.\n","parameters":[{"in":"path","name":"version","required":true,"schema":{"type":"integer"}},{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"backtest":{"$ref":"#/components/schemas/BacktestSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"Policy version or backtest not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get a backtest's status and summary","tags":["Policy Backtests"],"x-hidden":true}},"/api/policy_version/{version}/backtest/{heron_id}/results":{"get":{"description":"One page of deals, each carrying its evaluation_result, both versions' results, the checks that moved, and the note explaining the classification. Pass `after_id` to fetch rows recorded after that cursor in ascending row-ID order. Cursor-mode `_meta` keeps `total` and `per_page`, sets `next_url` and `prev_url` to null, and omits `page` and `pages`.\n","parameters":[{"in":"path","name":"version","required":true,"schema":{"type":"integer"}},{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}},{"in":"query","name":"page","required":false,"schema":{"type":"integer"}},{"in":"query","name":"limit","required":false,"schema":{"type":"integer"}},{"description":"Return rows recorded after this deal row ID; cannot be combined with page","in":"query","name":"after_id","required":false,"schema":{"minimum":0,"type":"integer"}},{"in":"query","name":"evaluation_result","required":false,"schema":{"type":"string"}},{"in":"query","name":"detail","required":false,"schema":{"enum":["full"],"type":"string"}},{"description":"Only these deals; repeat the parameter for several","explode":true,"in":"query","name":"end_user_heron_id","required":false,"schema":{"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Fill each deal's lendsaas_deal_ids","in":"query","name":"include_lendsaas_deal_ids","required":false,"schema":{"type":"boolean"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"$ref":"#/components/schemas/Pagination"},"backtest_deals":{"items":{"$ref":"#/components/schemas/BacktestDealSchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"Policy version or backtest not found"},"422":{"description":"Invalid filters or after_id combined with page"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get a backtest's per-deal results","tags":["Policy Backtests"],"x-hidden":true}},"/api/policy_version/{version}/lookup_tables":{"get":{"description":"The lookup tables a policy version pins, each at the version it pins.","parameters":[{"in":"path","name":"version","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"column_type_value_sets":{"description":"Column types whose cells come from a value set, e.g. month_window","items":{"$ref":"#/components/schemas/ColumnTypeValueSetSchema"},"type":"array"},"lookup_tables":{"items":{"$ref":"#/components/schemas/LookupTableSchema"},"type":"array"}},"type":"object"}}},"description":"OK"},"404":{"description":"Policy version not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"List a policy version's lookup tables","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/{version}/rollback":{"post":{"description":"Clone an archived version's policy_definition into a new draft. Pass publish=true to publish the new version immediately.\n","parameters":[{"in":"path","name":"version","required":true,"schema":{"type":"integer"}},{"in":"query","name":"publish","required":false,"schema":{"type":"boolean"}},{"description":"Replace an existing draft in the same transaction. Without it, an existing draft returns 422.","in":"query","name":"overwrite_draft","required":false,"schema":{"type":"boolean"}}],"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"issues":{"description":"With publish=true, warnings that did not stop the publish","items":{"$ref":"#/components/schemas/PublishIssueSchema"},"type":"array"},"policy_version":{"$ref":"#/components/schemas/PolicyVersionSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"Policy version not found"},"422":{"content":{"application/json":{"schema":{"properties":{"description":{"type":"string"},"errors":{"items":{"$ref":"#/components/schemas/PublishIssueSchema"},"type":"array"}},"type":"object"}}},"description":"Version is not archived, a draft already exists and overwrite_draft is not set, a concurrent publish won the race, the version reads a variable the account no longer has, or with publish=true the version has issues that block publishing. Issues are listed in `errors`; a refused rollback leaves any existing draft in place.\n"}},"security":[{"ApiKeyAuth":[]}],"summary":"Roll back to an archived policy version","tags":["Policy Versions"],"x-hidden":true}},"/api/policy_version/{version}/section_availability":{"get":{"description":"For each section, the variables every deal has by the time the section runs in the default workflow, those only some workflow paths produce, and those no path produces yet, with the step after which a missing variable becomes available.","parameters":[{"in":"path","name":"version","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PolicyVersionSectionAvailabilitySchema"}}},"description":"OK"},"404":{"description":"Policy version not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get which variables each section of a policy version can read","tags":["Policy Versions"],"x-hidden":true}},"/api/position_overrides/{override_heron_id}/reannotate":{"post":{"description":"Saves the stale edit's values against the chosen position, continuing its edit history.","parameters":[{"description":"Heron ID of the stale edit","in":"path","name":"override_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReannotatePositionOverrideRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionOverride"}}},"description":"Edit applied"},"404":{"description":"Stale edit or position not found"},"409":{"description":"The end user is still processing"},"422":{"description":"The position already has an override"}},"summary":"Apply an edit that no longer applies to a rebuilt position","tags":["Positions"]}},"/api/positions/{position_heron_id}/overrides":{"delete":{"description":"The position goes back to Heron's values. The edit history is kept.","parameters":[{"description":"The position heron ID","in":"path","name":"position_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Override removed"},"404":{"description":"Position or override not found"},"409":{"description":"The end user is still processing"}},"summary":"Remove a position's override","tags":["Positions"]},"get":{"description":"Every edit made to the position, oldest first, including removed ones.","parameters":[{"description":"The position heron ID","in":"path","name":"position_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionOverrides"}}},"description":"Edit history"},"404":{"description":"Position not found"}},"summary":"Get a position's edit history","tags":["Positions"]},"post":{"description":"Saves a customer edit to a position. Each save is a new entry in the position's edit history and replaces the previous edit. Values left null are not overridden.","parameters":[{"description":"The position heron ID","in":"path","name":"position_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionOverrideRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionOverride"}}},"description":"Override saved"},"404":{"description":"Position not found"},"409":{"description":"The end user is still processing"},"422":{"description":"No value overridden"}},"summary":"Override a position's status, frequency or payment amount","tags":["Positions"]}},"/api/positions/{position_heron_id}/transactions":{"get":{"description":"Returns investment, repayment, reversal and bounced repayment transactions for a specific position","operationId":"getPositionTransactions","parameters":[{"description":"The position heron ID","in":"path","name":"position_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PositionTransactions"}}},"description":"Position transactions retrieved successfully"},"404":{"description":"Position not found"}},"summary":"Get transactions for a specific position","tags":["Positions"]}},"/api/rules/":{"get":{"description":"Read all available rules","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"rules":{"items":{"$ref":"#/components/schemas/Rule"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get rules","tags":["Rules"]},"post":{"description":"Create a new rule to send a 'end_user.review_required' webhook after processing if rule condition evaluates to true\n","requestBody":{"content":{"application/json":{"schema":{"properties":{"rule":{"$ref":"#/components/schemas/Rule"}},"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"rule":{"$ref":"#/components/schemas/Rule"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create a single rule","tags":["Rules"]}},"/api/rules/metrics":{"get":{"description":"Read all available metrics to define rules on","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/MetricDefinitionSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get metrics","tags":["Rules"]}},"/api/rules/{heron_id}":{"delete":{"description":"Delete a rule\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"content":{"application/json":{"schema":{"properties":{"heron_id":{"type":"string"}},"type":"object"}}},"description":"Deleted"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete rule by heron_id","tags":["Rules"]},"put":{"description":"Update a rule\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"rule":{"$ref":"#/components/schemas/RuleUpdateSchema"}},"type":"object"}}},"description":"Rule","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"rule":{"$ref":"#/components/schemas/Rule"}},"type":"object"}}},"description":"Updated"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update rule by heron_id","tags":["Rules"]}},"/api/submission_parsers/{end_user_heron_id}":{"get":{"parameters":[{"description":"The heron_id of the end user","in":"path","name":"end_user_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ParsedEndUserSubmissionSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get parsed submissions for an End User","tags":["ParsedEndUserSubmission"]}},"/api/tags":{"get":{"description":"Return every tag on your account, excluding deleted ones.","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"tags":{"items":{"$ref":"#/components/schemas/TagSchema"},"type":"array"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"List tags","tags":["Tags"]},"post":{"description":"Create a tag. Names are normalized to lowercase. They must contain 1-140 alphanumeric characters plus _ - : and\nare unique to your account (case-insensitive).\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"tag":{"$ref":"#/components/schemas/TagSchema"}},"type":"object"}}},"description":"OK"},"400":{"description":"Invalid request body"},"422":{"description":"Tag name already exists or is reserved for a system-managed tag"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create a tag","tags":["Tags"]}},"/api/tags/{heron_id}":{"delete":{"description":"Delete a tag. It is removed from everything it is currently applied to and no longer appears in tag lists. Where\nyour access is restricted by tag, you can only delete tags you hold. Where access is restricted by tag, a tag\napplied to any end user cannot be deleted: remove it from them first, since deleting it revokes access for\neveryone holding it.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"No Content"},"404":{"description":"Tag not found"},"422":{"description":"System-managed tag, outside your access scope, or applied to end users"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete a tag","tags":["Tags"]},"get":{"description":"Return a single tag by its heron_id. Deleted tags return 404.","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"tag":{"$ref":"#/components/schemas/TagSchema"}},"type":"object"}}},"description":"OK"},"404":{"description":"Tag not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get a tag","tags":["Tags"]},"patch":{"description":"Update a tag's name, description, or color. Only the fields you send are changed; send null to clear the\ndescription or color. Where your access is restricted by tag, you can only update tags you hold.\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TagPatchSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"tag":{"$ref":"#/components/schemas/TagSchema"}},"type":"object"}}},"description":"OK"},"400":{"description":"Invalid request body"},"404":{"description":"Tag not found"},"422":{"description":"Tag name already exists, is system-managed, or is outside your access scope"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update a tag","tags":["Tags"]}},"/api/transactions":{"delete":{"callbacks":{"onData":{"$yourWebhookUrl":{"post":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionDeleteWebhook","type":"object"}}},"description":"Webhook payload with transactions"},"responses":{"200":{"description":"Your webhook implementation should return this HTTP status code\nif the data was received successfully."}}}}}},"description":"Please provide at least one of the following parameters: heron_ids, heron_id, request_id or end_user_id.\n","parameters":[{"description":"(legacy) Heron ID of transaction to be deleted","in":"query","name":"heron_id","required":false,"schema":{"example":"txn_9oPspuxisSVyboAqnR2L4Q","nullable":true,"type":"string"}},{"description":"Heron IDs of transactions to be deleted","explode":true,"in":"query","name":"heron_ids","required":false,"schema":{"default":[],"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Reference IDs of transactions to be deleted","explode":true,"in":"query","name":"reference_ids","required":false,"schema":{"default":[],"items":{"type":"string"},"type":"array"},"style":"form"},{"description":"Request ID of transactions to be deleted","in":"query","name":"request_id","required":false,"schema":{"nullable":true,"type":"string"}},{"description":"end_user_id of transactions to be deleted","in":"query","name":"end_user_id","required":false,"schema":{"nullable":true,"type":"string"}},{"description":"account_id of transactions to be deleted","in":"query","name":"account_id","required":false,"schema":{"nullable":true,"type":"string"}},{"description":"if true, deletes only transactions that are marked as duplicates","in":"query","name":"only_duplicates","required":false,"schema":{"nullable":true,"type":"boolean"}}],"responses":{"202":{"content":{"application/json":{"schema":{"properties":{"message":{"type":"string"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete transactions","tags":["Transactions"]},"get":{"description":"Get transactions. At least `end_user_id`, `heron_id` or `request_id` must be provided.","parameters":[{"description":"Deprecated; see created_date_ or timestamp_date_","in":"query","name":"from_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Deprecated; see created_date_ or timestamp_date_","in":"query","name":"to_date","required":false,"schema":{"format":"date","type":"string"}},{"description":"Filter by earliest transaction upload date - when Heron received the transaction","in":"query","name":"created_date_min","required":false,"schema":{"example":"2020-04-27","format":"date","type":"string"}},{"description":"Filter by latest transaction upload date - when Heron received the transaction","in":"query","name":"created_date_max","required":false,"schema":{"example":"2020-04-27","format":"date","type":"string"}},{"description":"Filter for transactions whose values were last updated in Heron systems after the specified input value","in":"query","name":"last_updated_min","required":false,"schema":{"example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"}},{"description":"Filter for transactions whose values were last updated in Heron systems before the specified input value","in":"query","name":"last_updated_max","required":false,"schema":{"example":"2026-02-26T09:30:00+00:00","format":"date-time","type":"string"}},{"description":"Filter by earliest transaction timestamp","in":"query","name":"timestamp_date_min","required":false,"schema":{"example":"2020-04-27","format":"date","type":"string"}},{"description":"Filter by latest transaction timestamp","in":"query","name":"timestamp_date_max","required":false,"schema":{"example":"2020-04-27","format":"date","type":"string"}},{"description":"Filter by the heron_id of the category that the transaction is annotated with","explode":true,"in":"query","name":"category_heron_id","required":false,"schema":{"default":[],"example":"ctg_94bwS4hp5ZQkyi9kBNkqn8","items":{"type":"string"},"nullable":true,"type":"array"},"style":"form"},{"description":"Request-Id header returned in the response of POST transactions. Sending this parameter will return all transactions sent in a particular POST request, including any duplicates.","in":"query","name":"request_id","required":false,"schema":{"type":"string"}},{"description":"Reference Id of transaction","in":"query","name":"reference_id","required":false,"schema":{"type":"string"}},{"description":"Heron generated Id of transaction","in":"query","name":"heron_id","required":false,"schema":{"example":"txn_9oPspuxisSVyboAqnR2L4Q","type":"string"}},{"description":"Filter to a specific set of transactions by Heron ID, e.g. the transactions an attribute cites","explode":true,"in":"query","name":"heron_ids","required":false,"schema":{"default":[],"items":{"type":"string"},"maxItems":100,"type":"array"},"style":"form"},{"description":"End user id of transaction","in":"query","name":"end_user_id","required":false,"schema":{"type":"string"}},{"description":"Whether or not to include duplicate transactions in the response. Defaults to false unless request_id is provided, in which case it defaults to true.","in":"query","name":"include_duplicates","required":false,"schema":{"type":"boolean"}},{"description":"Filter by transaction code","in":"query","name":"transaction_code","required":false,"schema":{"type":"string"}},{"description":"Filter by whether the transaction is recurring","in":"query","name":"is_recurring","required":false,"schema":{"type":"boolean"}},{"description":"Filter by the recorded payment-processing flag. False includes transactions not yet evaluated.","in":"query","name":"is_payment_processing","required":false,"schema":{"type":"boolean"}},{"description":"Filter by whether the transaction has a matching transaction","in":"query","name":"has_matching_transaction","required":false,"schema":{"type":"boolean"}},{"description":"Filter by keyword match on transaction description; case insensitive","in":"query","name":"description_keyword","required":false,"schema":{"type":"string"}},{"description":"Filter by keyword match on transaction counterparty; case insensitive","in":"query","name":"counterparty_keyword","required":false,"schema":{"type":"string"}},{"description":"Filter by regex matching transaction description","in":"query","name":"description_regex","required":false,"schema":{"type":"string"}},{"description":"Filter by minimum amount of transaction","in":"query","name":"min_amount","required":false,"schema":{"type":"number"}},{"description":"Filter by maximum amount of transaction","in":"query","name":"max_amount","required":false,"schema":{"type":"number"}},{"description":"Filter by minimum running balance","in":"query","name":"min_balance","required":false,"schema":{"type":"number"}},{"description":"Filter by maximum running balance","in":"query","name":"max_balance","required":false,"schema":{"type":"number"}},{"description":"Filter by minimum confidence of annotation associated with transaction","in":"query","name":"confidence_min","required":false,"schema":{"maximum":1.0,"minimum":0.0,"type":"number"}},{"description":"Filter by maximum confidence of annotation associated with transaction","in":"query","name":"confidence_max","required":false,"schema":{"maximum":1.0,"minimum":0.0,"type":"number"}},{"description":"Filter by merchant group id","in":"query","name":"merchant_group_id","required":false,"schema":{"type":"string"}},{"description":"Filter by merchant heron id","in":"query","name":"merchant_heron_id","required":false,"schema":{"type":"string"}},{"description":"Filter by data source Heron ID","in":"query","name":"data_source_heron_id","required":false,"schema":{"type":"string"}},{"description":"Filter by keyword match on merchant name; case insensitive","in":"query","name":"merchant_name","required":false,"schema":{"type":"string"}},{"description":"Filter by whether the transaction has a merchant entity associated with it","in":"query","name":"has_merchant","required":false,"schema":{"nullable":true,"type":"boolean"}},{"description":"What to order transactions by","in":"query","name":"order_by","required":false,"schema":{"default":"id_asc","enum":["amount_asc","amount_desc","abs_amount_asc","abs_amount_desc","description_asc","description_desc","timestamp_asc","timestamp_desc","id_asc","id_desc","confidence_asc","confidence_desc","created_asc","created_desc","balance_asc","balance_desc"],"type":"string"}},{"description":"Page of transaction to return","in":"query","name":"page","required":false,"schema":{"default":1,"minimum":1,"type":"integer"}},{"description":"Number of transactions to return per page","in":"query","name":"limit","required":false,"schema":{"default":1000,"maximum":10000,"minimum":1,"type":"integer"}},{"description":"Account ids to include. If not provided, all accounts are included","explode":true,"in":"query","name":"account_ids","required":false,"schema":{"items":{"example":"1234","type":"string"},"nullable":true,"type":"array"},"style":"form"}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"$ref":"#/components/schemas/Pagination"},"_summary":{"properties":{"returned_transactions":{"type":"integer"},"transactions":{"type":"integer"}},"type":"object"},"transactions":{"items":{"$ref":"#/components/schemas/TransactionGetOutput"},"type":"array"}},"type":"object"}}},"description":"OK"},"401":{"description":"Unauthorized"}},"security":[{"ApiKeyAuth":[]}],"tags":["Transactions"]},"post":{"description":"Enrich and categorize transactions and consume them in a sync response. For business lending and underwriting, please use \"Create end user transactions\" instead. Please send a maximum of 249 transactions per request.\n","parameters":[{"description":"Override the account's sync enrichment setting","in":"query","name":"sync","required":false,"schema":{"type":"boolean"}},{"description":"Override the account's combined sync and async enrichment setting","in":"query","name":"sync_async","required":false,"schema":{"type":"boolean"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionsPostSyncSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionsPostSyncResponse"}}},"description":"OK"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TransactionsPostCreatedResponse"}}},"description":"Created. Combined sync and async enrichment returns the enriched transactions; async enrichment returns only the summary."},"413":{"content":{"application/json":{"schema":{"properties":{"code":{"example":413,"type":"integer"},"description":{"example":"Transaction batch size exceeds max of 2500","type":"string"},"name":{"example":"Payload Too Large","type":"string"}},"type":"object"}}},"description":"Payload Too Large"}},"security":[{"ApiKeyAuth":[]}],"summary":"Enrich transactions (sync)","tags":["Transactions"]}},"/api/transactions/{heron_id}/feedback":{"put":{"description":"Provide feedback on a Transaction's Categories and Merchants","parameters":[{"description":"Transaction `heron_id`","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}},{"description":"Set to false to suppress the transaction_updated webhook. Defaults to true.","in":"query","name":"trigger_webhook","required":false,"schema":{"type":"boolean"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"transaction":{"$ref":"#/components/schemas/TransactionFeedbackSchema"}},"type":"object"}}},"description":"A partial Transaction object with the suggested Category and/or Merchant. If you provide a `heron_id` for Category or Merchant, you don't need to provide other fields. If you don't know the Merchant `heron_id` nor name, you can just send the `is_correct` boolean. If `heron_id` is provided, we disregard `name` and `label`. If `is_correct` is set to true, we disregard all other Merchant fields.\n","required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"transaction":{"$ref":"#/components/schemas/TransactionFeedbackResult"}},"type":"object"}}},"description":"OK"},"401":{"description":"Unauthorized"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create category, merchant feedback","tags":["EnrichmentFeedback"]}},"/api/transactions/{reference_id_or_heron_id}":{"get":{"description":"Get enriched transaction","parameters":[{"in":"path","name":"reference_id_or_heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"transaction_enriched":{"$ref":"#/components/schemas/TransactionEnriched"}},"type":"object"}}},"description":"OK"},"401":{"description":"Unauthorized"}},"security":[{"ApiKeyAuth":[]}],"tags":["EnrichedTransactions"]},"put":{"description":"Update single transaction","parameters":[{"in":"path","name":"reference_id_or_heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"transaction":{"$ref":"#/components/schemas/TransactionPartialSchema"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Transaction","type":"object"}}},"description":"OK"},"401":{"description":"Unauthorized"}},"security":[{"ApiKeyAuth":[]}],"tags":["Transactions"],"x-hidden":true}},"/api/user_merchant_groups":{"get":{"parameters":[{"description":"The group_id of the merchant","in":"query","name":"group_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserMerchantGroupsSchema"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"This endpoint returns merchant groups categorized as pending, custom, or rejected.","tags":["UserMerchantGroups"]}},"/api/users/company_overview_layout":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CompanyOverviewLayoutSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get user's company overview layout","tags":["Users"]},"put":{"requestBody":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CompanyOverviewLayoutSchema"},"type":"array"}}},"description":"The new company overview layout","required":true},"responses":{"204":{"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Save user's company overview layout","tags":["Users"]}},"/api/users/current":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"member":{"description":"The logged-in member's customer roles in this environment, from the session.","properties":{"roles":{"items":{"type":"string"},"type":"array"}},"type":"object"},"user":{"$ref":"#/components/schemas/User"}},"type":"object"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get the current user","tags":["Users"],"x-hidden":true}},"/api/users/current/settings":{"put":{"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserModifiableSettings"}}},"description":"The new settings","required":true},"responses":{"204":{"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Save user's settings","tags":["Users"]}},"/api/users/file_class_groups":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"items":{"type":"string"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get file class groups enabled for a User","tags":["FileClass"]}},"/api/users/file_classes":{"get":{"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FileClassSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get current file classes used in classification","tags":["FileClass"]}},"/api/users/file_classes/{file_class_name}":{"delete":{"parameters":[{"in":"path","name":"file_class_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FileClassSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Remove a FileClass from Classification for a User","tags":["FileClass"]},"post":{"parameters":[{"in":"path","name":"file_class_name","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/FileClassSchema"},"type":"array"}}},"description":"OK"}},"security":[{"ApiKeyAuth":[]}],"summary":"Add a FileClass to Classify for a User","tags":["FileClass"]}},"/api/users/secret/rotate":{"post":{"description":"Invalidates the old secret immediately. New, pending, and retried webhook deliveries use the new secret. Update every receiver before rotating or new webhook sends will fail until receivers use the new secret.","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"secret":{"type":"string"}},"required":["secret"],"type":"object"}}},"description":"Webhook signing secret rotated"},"429":{"description":"Rotation rate limit exceeded"}},"security":[{"ApiKeyAuth":[]}],"summary":"Rotate the webhook signing secret","tags":["Users"]}},"/api/watermarks/logo":{"get":{"description":"Retrieve the logo file for the current user as base64.","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLogoBase64Schema"}}},"description":"Logo file retrieved successfully"},"401":{"description":"Unauthorized"},"404":{"description":"Logo not found for user"}},"summary":"Retrieve user logo","tags":["Watermarks"]},"post":{"description":"Upload a logo file for the current user. The file is validated for security and stored in GCS.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLogoUploadSchema"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UserLogoFileSchema"}}},"description":"Logo uploaded successfully"},"400":{"description":"Invalid file format or content"},"401":{"description":"Unauthorized"},"413":{"description":"File too large"}},"summary":"Upload user logo","tags":["Watermarks"]}},"/api/webhooks":{"get":{"description":"Get webhook\n","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"webhooks":{"items":{"$ref":"#/components/schemas/WebhookSchema"},"type":"array"}},"type":"object"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get webhooks","tags":["Webhooks"]},"post":{"description":"Create a webhook\n","requestBody":{"content":{"application/json":{"schema":{"properties":{"webhook":{"$ref":"#/components/schemas/WebhookSchema"}},"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"webhook":{"$ref":"#/components/schemas/WebhookSchema"}},"type":"object"}}},"description":"Created"},"400":{"description":"Invalid webhook URL"}},"security":[{"ApiKeyAuth":[]}],"summary":"Create a webhook","tags":["Webhooks"]}},"/api/webhooks/deliveries":{"get":{"description":"Lists sent and failed webhook attempts from the last 7 days. HTTP status 0 marks a connection error.","parameters":[{"in":"query","name":"limit","schema":{"default":25,"maximum":50,"minimum":10,"type":"integer"}},{"in":"query","name":"cursor","schema":{"type":"string"}},{"in":"query","name":"status","schema":{"enum":["sent","failed"],"type":"string"}},{"in":"query","name":"end_user_heron_id","schema":{"type":"string"}},{"description":"Older values are clamped to the 7-day history window.","in":"query","name":"interval_start","schema":{"format":"date-time","type":"string"}},{"description":"Must fall within the last 7 days.","in":"query","name":"interval_end","schema":{"format":"date-time","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"_meta":{"properties":{"next_cursor":{"nullable":true,"type":"string"},"per_page":{"type":"integer"},"total":{"description":"Matching deliveries, capped at 10,000. Counted on the first page only; null when a cursor is passed.","nullable":true,"type":"integer"},"total_capped":{"description":"True when total hit the 10,000 cap. Null when a cursor is passed.","nullable":true,"type":"boolean"}},"type":"object"},"webhook_deliveries":{"items":{"$ref":"#/components/schemas/WebhookDeliverySchema"},"type":"array"}},"type":"object"}}},"description":"Webhook delivery attempts"},"422":{"description":"Invalid filters or cursor"}},"security":[{"ApiKeyAuth":[]}],"summary":"List webhook delivery attempts","tags":["Webhooks"]}},"/api/webhooks/deliveries/resend":{"post":{"description":"Queues fresh attempts with each failed delivery's original data and meta. If next_retry_at is in the future, an automatic retry is still scheduled, so a manual resend may deliver the webhook twice. Receivers must handle duplicates. New attempts use each webhook's current URL, topic, and headers.","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookResendRequestSchema"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookResendResponseSchema"}}},"description":"Resends queued"},"404":{"description":"A failed delivery was not found"},"409":{"description":"A webhook was deleted or disabled, or a stored payload cannot be resent"},"422":{"description":"event_ids is empty, invalid, or contains more than 50 IDs"},"429":{"description":"Resend rate limit exceeded","headers":{"Retry-After":{"description":"Seconds until another request is allowed","schema":{"type":"integer"}}}}},"security":[{"ApiKeyAuth":[]}],"summary":"Resend failed webhook deliveries","tags":["Webhooks"]}},"/api/webhooks/deliveries/{heron_id}":{"get":{"description":"Returns one sent or failed webhook attempt from the last 7 days, using the heron_id from the delivery list. payload is the JSON body sent and is only stored for failed attempts; it is null for sent ones. response_text is not truncated.","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryDetailSchema"}}},"description":"Webhook delivery attempt"},"404":{"description":"Delivery not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get a webhook delivery attempt","tags":["Webhooks"]}},"/api/webhooks/topics":{"get":{"description":"Get webhook topics\n","responses":{"200":{"content":{"application/json":{"schema":{"properties":{"topics":{"items":{"type":"string"},"type":"array"}},"type":"object"}}},"description":"Ok"}},"security":[{"ApiKeyAuth":[]}],"summary":"Get webhook topics","tags":["Webhooks"]}},"/api/webhooks/{heron_id}":{"delete":{"description":"Delete a webhook by its heron_id. The webhook must belong to the authenticated user.\n","parameters":[{"description":"The heron_id of the webhook to delete","in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"responses":{"204":{"description":"Webhook successfully deleted. No response body."},"404":{"content":{"application/json":{"schema":{"properties":{"description":{"example":"webhook with heron_id {heron_id} not found","type":"string"}},"type":"object"}}},"description":"Webhook not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Delete a webhook","tags":["Webhooks"]},"put":{"description":"Update a webhook\n","parameters":[{"in":"path","name":"heron_id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"webhook":{"$ref":"#/components/schemas/WebhookUpdateSchema"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"webhook":{"$ref":"#/components/schemas/WebhookSchema"}},"type":"object"}}},"description":"Ok"},"400":{"description":"Invalid webhook URL"}},"security":[{"ApiKeyAuth":[]}],"summary":"Update a webhook","tags":["Webhooks"]}},"/api/workflow/start_by_heron_id":{"post":{"description":"Start a workflow by Heron ID for an end user","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowStartByHeronIdRequestSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowStartResponseSchema"}}},"description":"Workflow started successfully"},"400":{"description":"Trigger ID or payload is invalid"},"404":{"description":"End user or workflow not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Start a workflow by Heron ID for an end user","tags":["Workflows"]}},"/api/workflow/start_by_name":{"post":{"description":"Start a workflow by name for an end user","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowStartByNameRequestSchema"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WorkflowStartResponseSchema"}}},"description":"Workflow started successfully"},"400":{"description":"Trigger ID or payload is invalid"},"404":{"description":"End user or workflow not found"}},"security":[{"ApiKeyAuth":[]}],"summary":"Start a workflow by name for an end user","tags":["Workflows"]}},"/api/workflow/user/workflows":{"get":{"description":"Returns all workflows belonging to the authenticated user.","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/UserWorkflowSchema"},"type":"array"}}},"description":"List of workflows"}},"security":[{"ApiKeyAuth":[]}],"summary":"List workflows for the current user","tags":["Workflows"]}}},"security":[{"ApiKeyAuth":["key_XXX"]}],"servers":[{"description":"Production","url":"https://app.herondata.io"}]}
