List individual profiles

get

https://openapi.advance.ai/v1/individual/profiles

Lists profiles for the authenticated tenant using cursor pagination.
To retrieve a profile by caller-assigned identifier, pass externalUserId
as a query parameter. Do not encode externalUserId as a path segment.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Query Params

externalUserId

string

Exact caller-assigned external user identifier.

status

string

enum

Profile lifecycle filter. ALL includes INIT, ACTIVE, and INACTIVE;
DELETED is never returned. When omitted, broad list queries default to ACTIVE;
an externalUserId lookup searches all visible statuses. Legacy lowercase input
remains accepted during transition.

Allowed:

levelId

string

nationality

string

ISO 3166-1 alpha-3 nationality.

tagTypes

array of strings

Risk tag types. Repeat the query parameter for multiple values.

tagTypes

tagSources

array of strings

Risk tag sources. Repeat the query parameter for multiple values.

tagSources

Allowed:

createdAtFrom

date-time

Inclusive creation-time lower bound.

createdAtTo

date-time

Inclusive creation-time upper bound.

pageToken

string

Opaque cursor from a previous response's nextPageToken field. Omit for the first page.

limit

integer

1 to 100

Defaults to 20

Maximum number of items to return per page. Range 1-100.

Headers

X-Request-Id

string

Unique request identifier. Injected by the API gateway if not provided by the client.
The same value is available in the response body requestId field for business-layer tracing.

X-Trace-Id

string

Distributed tracing identifier. Injected by the API gateway if not provided by the client.
Used for cross-service request correlation in logs and monitoring.

Responses

error.type	Meaning	Action
insufficient_balance	Account balance is insufficient.	Top up the account balance.
test_quota_exceeded	Account test quota is exceeded.	Contact your account manager.

200A page of profile summaries.

400Request validation failed or malformed JSON.

401Authentication failed. Access token is missing, invalid, or expired.

403The calling account is not authorized for the service (permission_error).

500Unexpected server error.