Register Job Seeker

Create a new job seeker account

POST /api/v1/auth/register/job-seeker

Register Job Seeker

cURL

curl --request POST \
  --url https://api.example.com/api/v1/auth/register/job-seeker \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": "<string>",
  "password": "<string>",
  "firstName": "<string>",
  "lastName": "<string>"
}
'

import requests

url = "https://api.example.com/api/v1/auth/register/job-seeker"

payload = {
    "email": "<string>",
    "password": "<string>",
    "firstName": "<string>",
    "lastName": "<string>"
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    email: '<string>',
    password: '<string>',
    firstName: '<string>',
    lastName: '<string>'
  })
};

fetch('https://api.example.com/api/v1/auth/register/job-seeker', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/v1/auth/register/job-seeker",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'email' => '<string>',
    'password' => '<string>',
    'firstName' => '<string>',
    'lastName' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/v1/auth/register/job-seeker"

	payload := strings.NewReader("{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.example.com/api/v1/auth/register/job-seeker")
  .header("Content-Type", "application/json")
  .body("{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/v1/auth/register/job-seeker")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"email\": \"<string>\",\n  \"password\": \"<string>\",\n  \"firstName\": \"<string>\",\n  \"lastName\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

200

{
  "success": true,
  "data": {
    "email": "<string>",
    "role": "<string>"
  },
  "message": "<string>",
  "meta": {
    "timestamp": "<string>",
    "path": "<string>",
    "method": "<string>"
  }
}

Endpoint

POST /api/v1/auth/register/job-seeker

Base URL: http://localhost:3000/api/v1

This endpoint is public and does not require authentication.

Request Body

email · string · required

User’s email address. Must be unique and valid format.

password · string · required

User’s password. Minimum 6 characters.

firstName · string · required

User’s first name.

lastName · string · required

User’s last name.

Request Shape

interface RegisterJobSeekerDto {
  email: string;
  password: string;
  firstName: string;
  lastName: string;
}

Response

Success Response (201 Created)

interface RegisterJobSeekerResponse {
  success: boolean;
  data: {
    email: string;
    role: 'job-seeker';
  };
  message: string;
  meta: {
    timestamp: string;
    path: string;
    method: string;
  };
}

{
  "success": true,
  "data": {
    "email": "[e-mail]",
    "role": "job-seeker"
  },
  "message": "Registration successful. Please check your email to verify your account.",
  "meta": {
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/auth/register/job-seeker",
    "method": "POST"
  }
}

success · boolean

Indicates if the registration was successful.

data · object

Contains the registered user’s email.

Show properties

email · string

The email address of the newly registered user.

role · string

The role of the user. Always returns “job-seeker” for this endpoint.

message · string

Success message: “Registration successful. Please check your email to verify your account.”

meta · object

Request metadata from global response interceptor.

Show properties

timestamp · string

ISO timestamp of the response.

path · string

Request path.

method · string

HTTP method.

What Happens After Registration

1. Account Created

   User account is created in database with: - isVerified: false - isActive: true - profileImageUrl: null - lastLoginAt: null

2. Password Hashed

   Password is securely hashed using bcrypt before storage
3. OTP Generated

   A 6-digit OTP code is generated and stored in Redis (valid for 10 minutes)

4. Email Queued

   Verification email with OTP is queued via BullMQ for async delivery

5. Next Step

   User must verify email using the Verify Email endpoint

Error Responses

400 Bad Request - Validation Error

Returned when request validation fails.

{
  "success": false,
  "error": {
    "message": ["email must be an email", "password must be longer than or equal to 6 characters"],
    "statusCode": 400,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/auth/register/job-seeker",
    "method": "POST",
    "details": "Bad Request"
  }
}

Common validation errors:

• email must be an email - Invalid email format
• password must be longer than or equal to 6 characters - Password too short
• firstName should not be empty - Missing first name
• lastName should not be empty - Missing last name

409 Conflict - Email Already Exists

Returned when the email is already registered.

{
  "success": false,
  "error": {
    "message": "An account with this email already exists",
    "statusCode": 409,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/auth/register/job-seeker",
    "method": "POST",
    "details": "Conflict"
  }
}

Solution: Use a different email or login with existing account.

500 Internal Server Error

Returned when an unexpected error occurs.

{
  "success": false,
  "error": {
    "message": "Failed to create job seeker",
    "statusCode": 500,
    "timestamp": "2026-04-23T20:00:00.000Z",
    "path": "/auth/register/job-seeker",
    "method": "POST",
    "details": "Internal Server Error"
  }
}

Error responses follow the global API envelope: success: false and an error object containing message, statusCode, timestamp, path, method, and details.

Validation Rules

Field	Type	Required	Rules
email	string	Yes	Must be valid email format, must be unique
password	string	Yes	Minimum 6 characters
firstName	string	Yes	Must be non-empty string
lastName	string	Yes	Must be non-empty string

Notes

Email Verification Required: Users cannot login until they verify their email using the OTP sent to their inbox.

OTP Expiration: The verification OTP expires after 10 minutes. If expired, users will need to request a new OTP.

Password Security: While the minimum is 6 characters, encourage users to create strong passwords with a mix of uppercase, lowercase, numbers, and special characters.

Related Endpoints

• Verify Email - Verify email with OTP after registration
• Login - Login to existing account
• Register Company - Register as a company instead