GET
/
api
/
end_users
curl --request GET \
  --url https://app.herondata.io/api/end_users \
  --header 'Authorization: Basic <encoded-value>'
{
  "_meta": {
    "limit": 1000,
    "next_url": "<string>",
    "page": 1,
    "pages": 3,
    "prev_url": "<string>",
    "total": 3500
  },
  "end_users": [
    {
      "confidence": 0.42,
      "created": "2025-03-04T17:04:45.036344",
      "criteria": [
        {
          "context": "higher_is_better",
          "currency": "<string>",
          "date_range": "last_180_days",
          "description": "The number of unique transactions with a timestamp",
          "group": "data_quality",
          "label": "unique_transactions",
          "status": "not_available",
          "unit": "n",
          "value": "<any>"
        }
      ],
      "data_sources": [
        {
          "status": "new",
          "type": "pdf"
        }
      ],
      "end_user_id": "aa9a5fc0-b76d-42f6-baa4-57720087f802",
      "heron_id": "eus_eax7aztRyuAq5wvtsBZZSQ",
      "is_portfolio": true,
      "last_processed_at": "2025-04-15T17:04:45.036555",
      "last_updated": "2025-04-15T17:04:45.036373",
      "name": "Company Name Inc.",
      "profit_and_loss_layout": "<any>",
      "status": "ready"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

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

Query Parameters

​
heron_id
string | null

Unique ID generated by Heron

Example:

"eus_CUoRzuGgoXV7ESd9xajDaJ"

​
status
enum<string> | null

Filter by status of end user

Available options:
new,
ready,
processed,
reviewed,
review_requested,
failed
Example:

"reviewed"

​
limit
integer
default:1000

Pagination limit per page

Required range: 1 <= x <= 10000
​
order_by
enum<string>
default:last_updated_desc

Order to return end users by

Available options:
last_updated_desc,
last_updated_asc,
created_desc,
created_asc
​
include_data_sources
boolean
default:false

Whether the to include data sources for each end user

Example:

true

​
end_user_id
string | null

Filter by ID associated with end_user_id field in transactions

Example:

"your_end_user_id"

​
include_scorecard_metrics
boolean
default:false

Whether to include scorecard metrics for each end user (under field criteria)

Example:

true

​
page
integer
default:1

Pagination page number

Required range: x >= 1
​
name
string | null

Filter by name associated with end user

Example:

"your_end_user_name"

​
is_portfolio
boolean | null

Whether the end user is part of a lending portfolio

Example:

true

Response

200 - application/json
OK
​
_meta
object
​
end_users
object[]

Was this page helpful?