Skip to main content
GET
/
api
/
end_users
List EndUsers
curl --request GET \
  --url https://app.herondata.io/api/end_users \
  --header 'x-api-key: <api-key>'
{
  "_meta": {
    "limit": 1000,
    "next_url": "<string>",
    "page": 1,
    "pages": 3,
    "prev_url": "<string>",
    "total": 3500
  },
  "end_users": [
    {
      "end_user_id": "eaf333e4-c1b6-4def-b2b3-67c47a8fd383",
      "confidence": 0.42,
      "created": "2025-11-27T11:54:09.631302",
      "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": 42.42
        }
      ],
      "data_sources": [
        {
          "type": "pdf",
          "status": "new"
        }
      ],
      "heron_id": "eus_2BJu3H4AxQfdWyqyjZciZf",
      "is_portfolio": true,
      "last_processed_at": "2026-01-08T11:54:09.631500",
      "last_updated": "2026-01-08T11:54:09.631330",
      "name": "Company Name Inc.",
      "profit_and_loss_layout": "<unknown>",
      "status": "ready"
    }
  ]
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
heron_id
string | null

Unique ID generated by Heron

Example:

"eus_6PquF7tjLZVfQKqY7mx4jG"

​
name
string | null

Filter by name associated with end user

Example:

"your_end_user_name"

​
include_scorecard_metrics
boolean
default:false

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

Example:

true

​
end_user_id
string | null

Filter by ID associated with end_user_id field in transactions

Example:

"your_end_user_id"

​
limit
integer
default:1000

Pagination limit per page

Required range: 1 <= x <= 10000
​
status
enum<string> | null

Filter by status of end user

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

"reviewed"

​
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
​
is_portfolio
boolean | null

Whether the end user is part of a lending portfolio

Example:

true

​
page
integer
default:1

Pagination page number

Required range: x >= 1
​
include_data_sources
boolean
default:false

Whether the to include data sources for each end user

Example:

true

Response

200 - application/json

OK

​
_meta
object
​
end_users
object[]