Sign in

v1

latestOpenAPI 3.0.02026-07-26224386470.0 KB
EndUserDataSources

Get data sources

Get a list of data sources for a company

get/api/end_users/{end_user_id_or_heron_id}/data_sources

Path parameters

end_user_id_or_heron_idstring required

Response

Ok

createdstring date-time required

When the data source was created in Heron system

heron_idstring required

Unique ID for data source generated by Heron

is_enabledboolean

Whether or not the data source is enabled. If disabled, hides related transactions from analytics

last_updatedstring date-time required

When the data source was last updated in Heron system

reference_idstring required

Unique ID to identify the data source

status'new' | 'parsing' | 'parsed' | 'processed' | 'human_reviewing' | 'approved' | 'rejected' | 'failed' | 'transactions_loaded' | 'transactions_unloaded' | 'pending' | 'active' | 'syncing' | 'erroring' | 'sync_disabled' | 'deleted_in_plaid' | 'unknown'

Status of the data source entity, where applicable (e.g. pdfs, integration links)

type'api' | 'csv' | 'pdf' | 'integration_link' | 'legacy' | 'legacy_pdf' | 'legacy_integration_link' required

Data source type

Example response

[
  {
    "created": "2026-06-11T19:53:47.134564",
    "data_source_accounts": [
      {
        "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
      }
    ],
    "heron_id": "dso_Voz4MiFfCsdRcFRGdeeEQr",
    "is_enabled": true,
    "last_updated": "2026-07-23T19:53:47.134594",
    "metadata": {
      "currency": "USD",
      "filename": "202348_JAN_2022.pdf",
      "integration_heron_id": "itg_Qz4JR9HpTCveV9DT7BvXnp",
      "integration_item_id": "Ed6bjNrDLJfGvZWwnkQlfxwoNz54B5C97ejBr",
      "last_successful_sync": "2026-07-23T19:53:47.133729",
      "notes": "error with processing, 52 invalid transaction(s) extracted from statement",
      "parsing_version": "1.0.0",
      "sub_type": "transaction"
    },
    "reference_id": "pdf_Tnx6TaGVo4MykKizfYwoLh",
    "status": "new",
    "type": "pdf"
  }
]