Finance OS / API

Get Current User

GET /api/mobile/user
⚷ Bearer Token

Профиль владельца токена

Возвращает данные пользователя, которому принадлежит текущий Bearer-токен. Используется на старте приложения для проверки валидности токена.

Request

Тело не требуется. Достаточно заголовка Authorization: Bearer {token}.

Response

Responses

{
  "data": {
    "id": "usr_5f8d7a3c-1234-4567-89ab-cdef01234567",
    "email": "you@example.com",
    "phone": "+79001234567",
    "name": "Иван Петров",
    "avatar_url": "https://fin-os.io/storage/avatars/abc.webp",
    "created_at": "2025-08-12T09:15:00Z",
    "kyc_status": "approved",
    "kyc_level": 2,
    "two_factor_enabled": true,
    "email_verified_at": "2025-08-12T09:20:00Z",
    "preferences": {
      "language": "ru",
      "timezone": "Europe/Moscow",
      "currency_display": "RUB"
    },
    "balances_summary": {
      "rub_equivalent": "152340.50",
      "currencies_count": 5
    }
  }
}
{
  "message": "Unauthenticated.",
  "error_code": "TOKEN_INVALID"
}

KYC статусы

Name Type Required Description
not_started optional Пользователь не начал KYC. Депозиты/выводы заблокированы.
in_progress optional Документы загружены, ожидают проверки (обычно 1-24ч).
approved optional KYC пройден. Все операции разрешены.
rejected optional Документы отклонены. Поле kyc_rejection_reason содержит причину.
expired optional KYC истёк (раз в 3 года). Нужно перепройти.

KYC Levels

Name Type Required Description
0 Anonymous optional Только просмотр курсов. Без операций.
1 Email + Phone optional Депозиты до $500/день, без вывода.
2 ID Verified optional Все операции до $10,000/день.
3 Address Proof optional Без лимитов (subject to AML monitoring).