> ## Documentation Index
> Fetch the complete documentation index at: https://careerk.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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        |

<Note>
  There are currently no OAuth login endpoints in this API.
</Note>

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