Register a new user

POST

/v1/auth/register

Creates a new retail or business user in identity-service. Exactly one of email or phone must be provided (not both). Password must meet complexity rules (upper, lower, digit, special). Individual users require first_name, last_name, and a full postal address with ISO 3166-1 alpha-2 country. Returns 201 with user_id and verification instructions. Conflicts if email/phone is already registered (409 CONFLICT).

Authentication: none. Rate limit: auth_register (gateway).

Request

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

User registered

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/auth/register' \
--header 'Content-Type: application/json' \
--data-raw '{
    "email": "user@example.com",
    "phone": "string",
    "password": "stringst",
    "type": "individual",
    "first_name": "string",
    "last_name": "string",
    "address": {
        "street": "string",
        "city": "string",
        "postal_code": "string",
        "country": "st"
    }
}'

Response Example

201 - Example 1

{
    "user_id": "a169451c-8525-4352-b8ca-070dd449a1a5",
    "verification_required": true,
    "message": "string",
    "email": "string",
    "phone": "string"
}

Modified at 2026-06-23 04:24:01

Refresh access token

Initiate step-up authentication