ApiAuth
Register a new user
POST
Creates a new user account and sends email verification link. Rate limited to 5 requests per minute.
X-API-Version?stringAPI version for header-based versioning
Default
"1"Value in
"1""2"application/json- body
email*stringUser email address
firstName*stringUser first name
Length
2 <= length <= 50lastName*stringUser last name
Length
2 <= length <= 50password*stringUser password (min 8 chars, must include uppercase, lowercase, number, and special character)
Length
8 <= length <= 100User registered successfully
response?unknownapplication/jsoncurl -X POST 'http://localhost:3001/api/v1/auth/register' \ -H 'Content-Type: application/json' \ -d '{ "email": "john.doe@example.com", "firstName": "John", "lastName": "Doe", "password": "SecurePass123!"}'Example Response
{ "status": "success", "statusCode": 201, "message": "Registration successful. Please check your email to verify your account.", "data": { "user": { "id": "123e4567-e89b-12d3-a456-426614174000", "email": "john.doe@example.com", "firstName": "John", "lastName": "Doe", "isActive": true, "isEmailVerified": false, "createdAt": "2026-01-31T10:00:00.000Z", "updatedAt": "2026-01-31T10:00:00.000Z" }, "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...", "refreshToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." }, "meta": { "user_id": "123e4567-e89b-12d3-a456-426614174000", "created_at": "2026-01-31T10:00:00.000Z", "email_verification_required": true }, "timestamp": "2026-01-31T10:00:00.000Z", "path": "/api/v1/auth/register"}