Get Individual End Users Paginated

Returns a paginated list of individual end users with complete personal information, address, identification documents, and registration details.

Auth:Bearer <api_key>

Tags:BankingSandbox

This endpoint is only available in the Sandbox environment. It will not work in production.

Request

cURL

curl -G https://publicapi.sandbox.hercle.financial/api/v1/end-users/individuals?pageSize={pageSize} \
  -H "Authorization: Bearer eyJhb..." \

Query Parameters

Name	Type	Required	Description
pageSize	number	Yes	Number of items per page (must be between 5 and 50) Example: `10`
from	string	No	Start date in ISO 8601 format (e.g., 2024-01-01T00:00:00Z) Example: `2025-12-01T00:00:00Z`
to	string	No	End date in ISO 8601 format (e.g., 2024-12-31T23:59:59Z) Example: `2025-12-30T23:59:59Z`
paginationToken	string	No	Token for fetching the next page of results

Headers

Name	Type	Required	Description
Authorization	string	Yes	Bearer token for authentication

Response

Success Response Schema

Individual end users retrieved successfully

Field	Type	Description
`payload`	array	Array of individual end user objects
`paginationToken`	string	Token for retrieving the next page of results

Payload Individual End User Object

Field	Type	Description
`id`	string	Unique identifier of the individual end user
`person`	object	Personal details of the individual (see Person Object)
`ipAddress`	string	IP address used during registration
`registrationStatus`	string	Current status (e.g., ACTIVE, PENDING, REJECTED)
`createdAt`	number	Unix timestamp of creation (milliseconds)
`updatedAt`	number	Unix timestamp of last update (milliseconds)

Person Object

Field	Type	Description
`firstName`	string	First name
`middleName`	string	Middle name
`lastName`	string	Last name
`email`	string	Email address
`phone`	string	Contact phone number
`dob`	string	Date of birth (YYYY-MM-DD)
`birthCountry`	string	Country of birth (ISO 3166-1 alpha-2)
`nationality`	array	Array of nationality codes (ISO 3166-1 alpha-2, e.g., ["IT"])
`address`	object	Residential address (see Address Object)
`identificationDocument`	object	Identification document details (see Identification Document Object)

Address Object

Field	Type	Description
`line1`	string	Primary address line
`line2`	string	Secondary address line
`city`	string	City
`state`	string	State or region
`postalCode`	string	Postal or ZIP code
`country`	string	Country code (ISO 3166-1 alpha-2, e.g., IT)

Identification Document Object

Field	Type	Description
`type`	string	Document type (e.g., PASSPORT, NATIONAL_ID, DRIVERS_LICENCE)
`number`	string	Document number

Responses

Individual end users retrieved successfully

200 application/json

{
  "payload": [
    {
      "id": "eus_ong3zm73p8dr0b2jkr",
      "person": {
        "firstName": "Mario",
        "middleName": "",
        "lastName": "Rossi",
        "email": "mario.rossi@example.com",
        "phone": "+393121212",
        "dob": "1990-05-20",
        "birthCountry": "IT",
        "nationality": [
          "IT"
        ],
        "address": {
          "line1": "Via Roma 1022",
          "line2": "",
          "city": "Milano",
          "state": "MI",
          "postalCode": "20100",
          "country": "IT"
        },
        "identificationDocument": {
          "type": "PASSPORT",
          "number": "AX1234567222"
        }
      },
      "ipAddress": "192.168.1.1",
      "registrationStatus": "",
      "createdAt": 1769770000000,
      "updatedAt": 1769777275289
    }
  ],
  "paginationToken": ""
}

API Tester

Test this endpoint directly against the sandbox environment

API Key

Get your API key from Hercle Sandbox

Query Parameters

pageSize

Required

Number of items per page (must be between 5 and 50)

from

Start date in ISO 8601 format (e.g., 2024-01-01T00:00:00Z)

End date in ISO 8601 format (e.g., 2024-12-31T23:59:59Z)

paginationToken

Token for fetching the next page of results

Request URL

https://publicapi.sandbox.hercle.financial/api/v1/end-users/individuals