API Reference
Complete REST API for TalentFlow AI. Protected routes require aBearertoken from the auth endpoints.
Base URL
https://smart-ats-production.up.railway.app/api
Auth
JWT Bearer · 7d expiry
Rate Limit
200 req / 15 min
Format
JSON · HTTPS
Authorization: Bearer <your_jwt_token>
Roles: admin · recruiter · hiring_manager. First registered user becomes admin automatically.
Auth
User registration, login, Google OAuth, profile management, and admin user controls.
Jobs
Create, search, and manage job postings. Full-text search via MongoDB text index on title, description, and skills.
Candidates
Manage candidate profiles. Resume uploads trigger AI parsing. Duplicate detection uses MD5 fingerprint of name + email.
Applications
Track candidates through the hiring pipeline. Each application has a stage, full history, and optional AI fit score (0–100).
Interviews
Schedule, manage, and collect feedback. Scheduling auto-advances the application stage and emails the candidate.
Analytics
Pre-aggregated recruitment metrics for the dashboard. All read-only, all require authentication.
Notifications
In-app notification feed scoped to the authenticated user. Frontend polls every 30 seconds for the unread badge count.
Payments
Cashfree Payments integration for the ₹999/month Premium subscription. Implements order creation, client-side verification, and signed webhook.