Register a new user account (and optionally auto-create their organization)

POST/api/v1/auth/register

Public Access

Request Body (JSON)

Field	Type	Default	Description
firstName	stringrequired	—	Given first name.
lastName	stringrequired	—	Family surname.
email	stringrequired	—	Valid email address.
password	stringrequired	—	Strong password string.
phone	stringoptional	—	Mobile phone number.

Response Status Codes

Status	Meaning	Description
200 / 201	Success / Created	Request fulfilled successfully with standard JSON envelope.
422 Unprocessable	DTO Validation Error	Payload validation failed. Returns key `VALIDATION_FAILED` with field details in `details`.
403 Forbidden	RBAC Role Violation	Authenticated user lacks required role or permission for this resource.

curl -X POST "http://localhost:6500/api/v1/auth/register" \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d '{ "firstName": "example_value", "lastName": "example_value", "email": "dev@showvaana.com", "password": "example_value", "phone": "+233200000000" }'

{ "status": "success", "statusCode": 201, "key": "OPERATION_SUCCESSFUL", "code": "SVF_S2001", "label": "Resource created successfully", "message": "Operation completed successfully", "data": { "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6", "firstName": "Ada", "lastName": "Lovelace", "email": "ada@showvaana.com", "phone": "+233200000000", "userType": "USER", "status": "active", "emailVerified": "false", "phoneVerified": "false", "organizationId": null, "createdAt": "2026-09-24T14:30:00.000Z" }, "timestamp": "2026-09-24T14:30:00.000Z" }