Register

POST /api/mobile/register

○ Public

Создать новый аккаунт

Создаёт нового пользователя в Finance OS и сразу выпускает Sanctum-токен. Email и phone должны быть уникальны в системе.

Request body

Name	Type	Required	Description
`email`	`string`	required	Email пользователя. Должен быть уникальным и валидным.
`phone`	`string`	required	Телефон в формате E.164: `+79001234567`.
`password`	`string`	required	Минимум 8 символов, должен содержать букву и цифру.
`name`	`string`	required	Имя пользователя, 2-50 символов.
`device_name`	`string`	optional	Имя устройства для отображения в сессиях. По умолчанию — User-Agent.
`referral_code`	`string`	optional	Реферальный код для привязки к рекомендателю.
`accept_terms`	`boolean`	required	Должно быть `true`. Иначе 422.

Response

Responses

{
  "data": {
    "user": {
      "id": "usr_5f8d7a3c-1234-4567-89ab-cdef01234567",
      "email": "new@example.com",
      "name": "Иван Петров",
      "phone": "+79001234567",
      "created_at": "2026-05-27T14:23:00Z",
      "kyc_status": "not_started",
      "two_factor_enabled": false
    },
    "token": "1|aBcDeFgHiJkLmNoPqRsTuVwXyZ123456789",
    "token_type": "Bearer"
  }
}

{
  "message": "The given data was invalid.",
  "errors": {
    "email": ["The email has already been taken."],
    "password": ["The password must be at least 8 characters."]
  },
  "error_code": "VALIDATION_FAILED"
}

{
  "message": "Too Many Attempts.",
  "retry_after": 60
}

⚠

Сохраните токен сразу

Токен возвращается один раз при регистрации. Если потеряли — пользователь должен заново войти через POST /mobile/login.

Что дальше

Свежесозданный аккаунт имеет kyc_status: "not_started" — депозиты/выводы заблокированы до прохождения KYC.
2FA выключен по умолчанию — рекомендуйте включить через личный кабинет.
Email-верификация не обязательна для базовых операций, но требуется для вывода средств выше $1000/день.

curl -X POST https://fin-os.io/api/mobile/register \ -H "Content-Type: application/json" \ -H "Accept: application/json" \ -d '{ "email": "new@example.com", "phone": "+79001234567", "password": "MySecurePass123", "name": "Иван Петров", "device_name": "iPhone 15", "accept_terms": true }'

const res = await fetch('https://fin-os.io/api/mobile/register', { method: 'POST', headers: { 'Content-Type': 'application/json', 'Accept': 'application/json', }, body: JSON.stringify({ email: 'new@example.com', phone: '+79001234567', password: 'MySecurePass123', name: 'Иван Петров', device_name: 'Web Browser', accept_terms: true, }), }); const { data } = await res.json(); localStorage.setItem('finos_token', data.token); console.log('Welcome,', data.user.name);

$response = Http::acceptJson()->post('https://fin-os.io/api/mobile/register', [ 'email' => 'new@example.com', 'phone' => '+79001234567', 'password' => 'MySecurePass123', 'name' => 'Иван Петров', 'device_name' => 'Backend Service', 'accept_terms' => true, ]); if ($response->successful()) { $token = $response->json('data.token'); $user = $response->json('data.user'); }

import requests response = requests.post( 'https://fin-os.io/api/mobile/register', json={ 'email': 'new@example.com', 'phone': '+79001234567', 'password': 'MySecurePass123', 'name': 'Иван Петров', 'device_name': 'Python Client', 'accept_terms': True, }, headers={'Accept': 'application/json'}, ) if response.ok: data = response.json()['data'] token = data['token'] user = data['user']