Introduction

Authentication API - Register, verify, login, and refresh sessions

Authentication API

The Authentication API provides endpoints for account creation, email verification, login, session refresh, and password recovery.

Base URL

http://localhost:3000/api/v1

Endpoints Overview

Registration

Method	Endpoint	Description	Auth Required
POST	/auth/register/job-seeker	Register a new job seeker account	No
POST	/auth/register/company	Register a new company account	No

Verification and Login

Method	Endpoint	Description	Auth Required
POST	/auth/verify-email	Verify account email using OTP	No
POST	/auth/resend-verification	Resend verification OTP	No
POST	/auth/login	Login with email and password	No

Session Management

Method	Endpoint	Description	Auth Required
POST	/auth/refresh-token	Refresh access token using refreshToken cookie	No
POST	/auth/logout	Invalidate the current refresh token and clear cookie	Cookie

Password Management

Method	Endpoint	Description	Auth Required
POST	/auth/forgot-password	Request password reset OTP	No
POST	/auth/reset-password	Reset password with email + OTP	No
POST	/auth/change-password	Change password for authenticated user	Bearer

There are currently no OAuth login endpoints in this API.

See detailed documentation for each endpoint in the API Reference section.