MAX Full Profile Checker API: Gender, Last Seen, Avatar

For phone numbers registered on MAX messenger (oneme.ru), retrieve their full profile information: account id, display name, gender, last seen time, and avatar link.

Upload detection file — example:

curl --location 'https://api.checknumber.ai/v1/tasks' \
--header 'X-API-Key: API-KEY' \
--form 'file=@"./numbers.txt"' \
--form 'task_type="max_full"'

Check task status — example:

curl --location 'https://api.checknumber.ai/v1/gettasks' \
--header 'X-API-Key: API-KEY' \
--form 'task_id="task_id"'

Response after upload succeeds

{
    "task_id": "d4g8o46p2jvh04o9uolg",
    "status": "pending",
    "total": 2049,
    "message": "Task created successfully",
    "created_at": "2026-05-18T11:00:00.000000000Z"
}

Response while processing

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:01:30.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "processing",
    "total": 2049,
    "success": 1024,
    "failure": 0
}

Response when finished (exported)

{
    "created_at": "2026-05-18T11:00:00.000Z",
    "updated_at": "2026-05-18T11:03:00.000Z",
    "task_id": "d4g24nep2jvh04o9uoh0",
    "user_id": "wfi7wGPS4B4PdtTMox5Y",
    "status": "exported",
    "total": 2049,
    "success": 2049,
    "failure": 0,
    "result_url": "https://example-link-to-results.zip"
}

Upload file request URL

POST https://api.checknumber.ai/v1/tasks

Upload file request parameters

Parameter	Description
file	file, one phone number per line (E.164 format, e.g. +79991234567)
task_type	string, set to max_full

Minimum batch size: 1000 numbers per task.

Check task status request URL

POST https://api.checknumber.ai/v1/gettasks

Check task status request parameters

Parameter	Description
task_id	string, Task ID returned from task creation

Result fields

Field	Description	Example
Number	Phone number in E.164 format	+79991234567
max	Whether the number is registered on MAX messenger	yes, no
id	MAX account internal user id (only when max=yes)	75240310
name	Account display name (first / last name, may be partially empty)	Екатерина Сагайдак
gender	Account gender (when populated by the user)	male, female
last_seen	Activity status / last seen description	last seen recently, last seen 2 days ago
avatar	Avatar image URL (empty when user has no avatar)	https://i.oneme.ru/i?r=…

Rows with max=no have all profile columns empty.

Response format

Field	Description
created_at	Timestamp when task was created
updated_at	Timestamp of last task status update
task_id	Unique task identifier
user_id	User ID
status	pending · processing · exported
total	Total phone numbers processed
success	Numbers successfully identified
failure	Numbers that failed processing
result_url	Download URL when status is exported

Status codes

Status	Description
200	charge, request successful
400	free, bad request
500	free, server error