Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/harshalw2003/BidAuc/llms.txt

Use this file to discover all available pages before exploring further.

After requesting an OTP with POST /user/generateOtp, use this endpoint to create a new BidAuc account. The submitted OTP is validated against the record in the database, then a new user is created with the supplied profile details. On success, the server issues a JWT and writes it to an httpOnly cookie so subsequent requests are authenticated automatically.

​
Endpoint

POST /user/register
No authentication is required for this endpoint.

​
Request body

​
phoneNumber
string
required
The 10-digit phone number used to request the OTP.
​
otp
string
required
The one-time password received for the phone number. In development this is always "123456".
​
role
string
required
Account role. Accepted values: "Seeker" or "Provider".
​
email
string
required
Email address for the account. Must be unique — registration fails if this email is already in use.
​
userName.firstName
string
required
User’s first name.
​
userName.lastName
string
required
User’s last name.

​
Example request

# Step 1: Request OTP
curl -X POST http://localhost:5000/user/generateOtp \
  -H "Content-Type: application/json" \
  -d '{"phoneNumber": "9876543210"}'

# Step 2: Register
curl -X POST http://localhost:5000/user/register \
  -H "Content-Type: application/json" \
  -c cookies.txt \
  -d '{
    "phoneNumber": "9876543210",
    "otp": "123456",
    "role": "Seeker",
    "email": "user@example.com",
    "userName": { "firstName": "Rahul", "lastName": "Sharma" }
  }'

​
Response

​
Success — 200 OK

{
  "message": "User Registered Successfully!!",
  "success": true,
  "jwtToken": "<jwt>"
}
​
message
string
Confirmation that the account was created.
​
success
boolean
true on successful registration.
​
jwtToken
string
Signed JWT for the new session. Also set as the token cookie in the response.

​
Errors

OTP expired — 400 Bad Request 
{
  "message": "OTP Expired"
}
Invalid OTP — 400 Bad Request 
{
  "message": "Invalid OTP"
}
Phone number already registered 
{
  "success": false,
  "message": "User already exist with this email"
}
On a successful registration the server sets an httpOnly cookie named token. Browsers send this cookie automatically with every subsequent request, so you do not need to manage the JWT manually in client-side code. When using curl, pass -c cookies.txt to save the cookie and -b cookies.txt to send it on later requests.

Build docs developers (and LLMs) love

Get started for freeTalk to us