KiteCareer

API Reference

Build on top of KiteCareer. All endpoints are JSON, available at https://api.kitecareer.com.

Authentication

Endpoints marked "auth" require a Bearer JWT in the Authorization header.

POST /auth/login HTTP/1.1
Content-Type: application/json

{ "email": "you@example.com", "password": "..." }

→ { "access_token": "eyJhbGc...", "refresh_token": "..." }

# Then on every request:
Authorization: Bearer eyJhbGc...

Rate limits

  • Anonymous: 60 req/min
  • Free: 120 req/min, 50 jobs/day, 5 AI suggestions/day
  • Basic: 300 req/min, 1000 jobs/day, 50 AI suggestions/day
  • Pro: 1000 req/min, unlimited features

429 responses include Retry-After header. Failures fail open during Redis outages.

Auth

POST/auth/signup
POST/auth/login
POST/auth/refresh
GET/auth/meauth
PATCH/auth/meauth
POST/auth/password/forgot
POST/auth/password/reset
GET/auth/oauth/{provider}/start

Jobs

GET/jobs
GET/jobs/{id}
POST/jobs/applicationsauth
GET/jobs/applicationsauth
PATCH/jobs/applications/{id}auth
POST/jobs/saved/{id}auth
GET/jobs/alertsauth
POST/jobs/alertsauth
POST/jobs/recruiterauth

Resumes

GET/resumesauth
POST/resumesauth
POST/resumes/{id}/pdfauth
POST/resumes/parseauth
POST/resumes/ai/suggestauth
POST/resumes/ai/improveauth
POST/resumes/ats/scoreauth

Interviews

POST/interviews/sessionsauth
POST/interviews/chat/sendauth
GET/interviews/chat/streamauth
POST/interviews/sessions/{id}/feedbackauth

Assessments

GET/assessments/skills
POST/assessments/startauth
POST/assessments/submitauth
GET/assessments/my-resultsauth

Payments

GET/payments/plans
POST/payments/subscriptions/createauth
GET/payments/subscriptions/meauth
POST/payments/subscriptions/cancelauth
POST/payments/webhooks/{gateway}

For machine-readable specs, every service exposes its OpenAPI schema at /openapi.json. The aggregated gateway schema is at /api/openapi.json.