Login

Authenticate user and receive access and refresh tokens.

POST /api/v1/auth/login

Request Body

Field	Type	Required	Description
email	string	Yes	User's email address
password	string	Yes	User's password

{
  "email": "user@example.com",
  "password": "securepassword123"
}

Response

200: OK

{
  "meta": {
    "success": true,
    "message": "Login successful"
  },
  "data": {
    "access_token": "eyJhbGciOiJIUzI1NiIs...",
    "refresh_token": "dGhpcyBpcyBhIHJlZnJl...",
    "token_type": "Bearer",
    "expires_in": 3600,
    "user": {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "email": "user@example.com",
      "name": "John Doe",
      "role": "user",
      "created_at": "2025-01-01T00:00:00Z",
      "updated_at": "2025-01-01T00:00:00Z"
    }
  }
}

400: Bad Request

{
  "meta": {
    "success": false,
    "message": "Validation failed",
    "details": {
      "email": "email is required",
      "password": "password is required"
    }
  },
  "data": null
}

401: Unauthorized

{
  "meta": {
    "success": false,
    "message": "Invalid email or password"
  },
  "data": null
}