Register a new user

POST

/api/v1/auth/register

Register a new user with institution or partner role.
After registration, an OTP will be sent to the email for verification.

Request

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Registration successful

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/auth/register' \
--header 'Content-Type: application/json' \
--data-raw '{
    "user": {
        "email": "john.doe@example.com",
        "password": "SecurePass123",
        "password_confirmation": "SecurePass123",
        "full_name": "John Doe",
        "phone": "+6281234567890",
        "role": "institution"
    }
}'

Response Example

201 - Success

{
    "success": true,
    "data": {
        "message": "Registration successful. Please verify your email.",
        "user": {
            "id": 1,
            "email": "john.doe@example.com",
            "full_name": "John Doe",
            "phone": "+6281234567890",
            "role": "institution",
            "confirmed": false,
            "status": "active"
        },
        "verification": {
            "expires_at": "2025-12-07T12:10:00Z",
            "provider": "email"
        }
    }
}

Modified at 2026-06-08 00:59:16

Nukitu API V1