Applications

Apply for jobs via TalentHub and track application status.

Candidate Authentication

Applications and profile data require a valid candidate token (JWT). Candidates receive this token after logging in at POST /v1/auth/login.

POST /applications — Submit Application

POSThttps://api.aeroselect.io/api/v1/public/applications
FeldTypPflichtBeschreibung
job_idintegerPflichtJob ID (from the job search)
cover_letterstringOptionalCover letter (max. 5,000 characters)
use_aerocvbooleanOptionalAutomatically include the candidate profile's aviation data
cv_urlstringOptionalDirect link to an uploaded CV
cURLBash
curl -X POST "https://api.aeroselect.io/api/v1/public/applications" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..." \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": 1,
    "cover_letter": "Dear Hiring Team...",
    "use_aerocv": true
  }'
Response 201JSON
{
  "data": {
    "id": 5001,
    "code": "APP7XK9M",
    "status": "pending",
    "job": { "id": 1, "title": "First Officer A320" },
    "aerocv_used": true,
    "submitted_at": "2026-05-22T10:00:00Z"
  },
  "message": "Application submitted successfully."
}

GET /applications/{id}/status — Retrieve Status

GEThttps://api.aeroselect.io/api/v1/public/applications/{id}/status
cURLBash
curl "https://api.aeroselect.io/api/v1/public/applications/5001/status" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiJ9..."
Response 200JSON
{
  "id": 5001,
  "code": "APP7XK9M",
  "status": "shortlisted",
  "status_label": "Shortlisted",
  "job": { "id": 1, "title": "First Officer A320" },
  "last_updated_at": "2026-05-25T14:30:00Z"
}