CareerTrack API is a RESTful backend service built for developers and job seekers who want a structured, programmatic way to manage their job hunt. It handles everything from user registration and secure authentication to full lifecycle tracking of job applications — so you can focus on landing the role, not wrangling spreadsheets.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/ericcobasdev/careertrack-api/llms.txt
Use this file to discover all available pages before exploring further.
What the API Provides
CareerTrack exposes three core capability groups:- Authentication — Register and log in users. Every session is secured with a personal API token issued by Laravel Sanctum, keeping each user’s data completely private.
- Job Application CRUD — Create, read, update, and delete job application records. Each application captures the company, role, status, salary range, source, location, notes, and key dates.
- Statistics — A dedicated stats endpoint aggregates your application pipeline so you can see totals by status at a glance.
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Laravel 13 |
| Language | PHP 8.3 |
| Authentication | Laravel Sanctum (token-based) |
| Database (dev) | SQLite |
| Response Format | JSON via API Resources |
Key Features
Sanctum Token Auth
Every user receives a personal Bearer token on registration or login. All protected endpoints validate this token via the
auth:sanctum middleware — no sessions, no cookies.Full CRUD for Applications
Create, retrieve, update, and delete job application records through a clean set of RESTful endpoints under
/api/applications.Status Tracking
Track where each application stands using a defined status enum:
applied, interview, technical_test, offer, or rejected.Per-User Data Isolation
Applications are scoped to the authenticated user. Multi-user deployments are supported out of the box — users never see each other’s records.
API Resources
Responses are formatted through Laravel API Resource classes, giving you a consistent, predictable JSON structure across every endpoint.
Form Request Validation
Incoming data is validated using dedicated Laravel Form Request classes before it ever touches the database, returning clear error messages on failure.
Statistics Endpoint
GET /api/stats returns a real-time breakdown of your application pipeline — total count plus per-status counts — in a single request.Salary & Source Tracking
Each application record stores optional salary range (
salary_min / salary_max), a source label (e.g. “LinkedIn”), a source URL, location, and freeform notes.Next Steps
Quickstart
Clone the repo, run the server, and make your first API call in under five minutes.
Authentication
Learn how to register a user, obtain a token, and authenticate every request.
Installation Guide
Detailed setup instructions including environment configuration and database migration.
List Applications
Browse the full API reference for the job applications collection endpoint.