/api/v1/applicants
List applicants
Newest first, cursor pagination.
Parameters
-
external_idstring query -
flowstring queryFlow key. -
created_fromstring (date-time) query -
created_tostring (date-time) query -
limitinteger query -
cursorstring queryOpaquenext_cursorfrom the previous page.
Responses
200 A page of applicants. object
{
"data": [
{
"id": "apl_01j9…",
"external_id": "user-8812",
"flow": "basic-kyc",
"locale": "uz",
"status": "init",
"decision": "GREEN",
"risk_score": 0.5,
"last_verification_id": "string",
"metadata": {},
"purpose": "string",
"valid_until": "2026-11-07T10:00:00Z",
"created_at": "2026-11-07T10:00:00Z",
"updated_at": "2026-11-07T10:00:00Z",
"identity": {
"verification_id": "string",
"verified_at": "2026-11-07T10:00:00Z",
"document": {
"type": "string",
"country": "string",
"data": {
"first_name": "ANNA MARIA",
"last_name": "ERIKSSON",
"middle_name": null,
"full_name": "ANNA MARIA ERIKSSON",
"birth_date": null,
"place_of_birth": null,
"sex": "M",
"nationality": "UTO",
"document_type": "passport",
"document_subtype": "P",
"issuing_country": "UTO",
"number": "L898902C3",
"personal_number": null,
"personal_number_type": "JShShIR (PINFL)",
"personal_number_valid": null,
"issue_date": null,
"expiry_date": null,
"issuing_authority": null,
"address": null,
"series": null,
"division_code": null,
"age": null,
"is_expired": null,
"days_to_expiry": null,
"names": null,
"fields": null
}
}
}
}
],
"next_cursor": "string"
}
400
validation_failed (field errors in error.fields) or bad_request.
Error
{
"error": {
"code": "validation_failed",
"message": "The external id field is required.",
"fields": {
"external_id": [
"The external id field is required."
]
},
"request_id": "req_01j9…"
}
}
401
unauthenticated — missing or invalid API key.
Error
{
"error": {
"code": "bad_request",
"message": "string",
"fields": {},
"request_id": "req_01j9…"
}
}
429
rate_limited
Error
{
"error": {
"code": "bad_request",
"message": "string",
"fields": {},
"request_id": "req_01j9…"
}
}