GET
/
api
/
end_users
/
{end_user_id_or_heron_id}
/
data_sources
curl --request GET \
  --url https://app.herondata.io/api/end_users/{end_user_id_or_heron_id}/data_sources \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "created": "2025-03-04T17:04:44.990021",
    "data_source_accounts": [
      {
        "account_id": "202348",
        "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_3iB95q3Jhagqxzdr5L6gmr",
    "is_enabled": true,
    "last_updated": "2025-04-15T17:04:44.990040",
    "metadata": {
      "filename": "202348_JAN_2022.pdf",
      "status": "processed"
    },
    "reference_id": "pdf_NfK6GMXXkCjB9LwcSLZCD5",
    "status": "new",
    "type": "pdf"
  }
]

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

​
end_user_id_or_heron_id
string
required

Response

200 - application/json
Ok
​
created
string
required

When the data source was created in Heron system

Example:

"2025-03-04T17:04:44.990021"

​
data_source_accounts
object[]
required

List of data source accounts associated with the data source

Example:
[
  {
    "account_id": "202348",
    "anomaly_score": 200,
    "enabled": true,
    "max_date": "2022-01-31",
    "min_date": "2022-01-01",
    "num_transactions": 120,
    "transactions_match_balances": true
  }
]
​
heron_id
string
required

Unique ID for data source generated by Heron

Example:

"dso_3iB95q3Jhagqxzdr5L6gmr"

​
last_updated
string
required

When the data source was last updated in Heron system

Example:

"2025-04-15T17:04:44.990040"

​
reference_id
string
required

Unique ID to identify the data source

Example:

"pdf_NfK6GMXXkCjB9LwcSLZCD5"

​
type
enum<string>
required

Data source type

Available options:
api,
csv,
pdf,
integration_link,
legacy,
legacy_pdf,
legacy_integration_link
Example:

"pdf"

​
is_enabled
boolean
default:true

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

Example:

true

​
metadata
object

Metadata associated with the data source

Example:
{
  "filename": "202348_JAN_2022.pdf",
  "status": "processed"
}
​
status
enum<string>

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

Available options:
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"

Was this page helpful?