Authentication Workflow

Nimbus uses a secure OTP-based authentication system to ensure agency identity.

Step 1: Request an OTP

Initiate the authentication flow by providing an email or phone number.

POST /api/auth/send-otp
{
  "identifier": "[email protected]",
  "type": "EMAIL"
}

Once the agent receives the 6-digit code, verify it to receive a session token.

POST /api/auth/verify-otp
{
  "identifier": "[email protected]",
  "code": "123456"
}

Use the returned verification_token or the session cookie for all subsequent API calls.

Authorization: Bearer <your_token>