ApiAuth
Login user
POST
Authenticate user with email and password. Rate limited to 10 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
password*stringUser password
Login successful
response?unknownapplication/jsoncurl -X POST 'http://localhost:3001/api/v1/auth/login' \ -H 'Content-Type: application/json' \ -d '{ "email": "john.doe@example.com", "password": "SecurePass123!"}'Example Response
{ "status": "success", "statusCode": 200, "message": "Login successful", "data": { "user": { "id": "123e4567-e89b-12d3-a456-426614174000", "email": "john.doe@example.com", "firstName": "John", "lastName": "Doe", "isActive": true, "isEmailVerified": true, "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", "is_email_verified": true }, "timestamp": "2026-01-31T10:00:00.000Z", "path": "/api/v1/auth/login"}