Applications

Manage applications, update status and add notes.

Application Object

FeldTypPflichtBeschreibung
idintegerPflichtUnique application ID
codestringOptionalPublic application codez.B. APP8XK2P
statusenumPflichtpending | reviewed | shortlisted | interview | offered | hired | rejected | withdrawn
sourcestringOptionalApplication sourcez.B. api
cover_letterstring|nullOptionalCandidate cover letter
job_idintegerOptionalJob ID
jobobjectOptional{ id, title } — Brief job info
candidateobjectOptional{ id, first_name, last_name, email, phone }
pipeline_stageobject|nullOptional{ id, name } — Current pipeline stage
hired_atdatetime|nullOptionalTime of hire
rejected_atdatetime|nullOptionalTime of rejection
submitted_atdatetimeOptionalSubmission timestamp (ISO 8601)
created_atdatetimeOptionalCreation timestamp

Application State Machine

pending → reviewed → shortlisted → interview → offered → hired
                                                          ↓
                                                       rejected

pending → withdrawn (Kandidat zieht zurück)
* → rejected (jederzeit möglich)

GET /applications — List Applications

GEThttps://api.aeroselect.io/api/v2/external/applications
FeldTypPflichtBeschreibung
job_idintegerOptionalFilter by job ID
statusstringOptionalFilter by application status
pageintegerOptionalPage number
cURLBash
curl "https://api.aeroselect.io/api/v2/external/applications?job_id=1&status=shortlisted" \
  -H "X-API-Key: ak_live_YOUR_KEY"
Response 200JSON
{
  "data": [
    {
      "id": 101,
      "code": "APP8XK2P",
      "status": "shortlisted",
      "source": "talenthub",
      "job": { "id": 1, "title": "First Officer A320" },
      "candidate": {
        "id": 55,
        "first_name": "Max",
        "last_name": "Müller",
        "email": "[email protected]"
      },
      "pipeline_stage": { "id": 3, "name": "Telefoninterview" },
      "submitted_at": "2026-05-10T08:30:00Z"
    }
  ],
  "meta": { "total": 47, "page": 1, "per_page": 25 }
}

POST /applications — Submit Application

Submits a new application. If the candidate does not yet exist, an account is created automatically. Duplicate applications for the same job are rejected with HTTP 409. Requires scope applications:write.

POSThttps://api.aeroselect.io/api/v2/external/applications
FeldTypPflichtBeschreibung
job_idintegerPflichtJob ID
first_namestringPflichtFirst name (max. 100 characters)
last_namestringPflichtLast name (max. 100 characters)
emailstringPflichtCandidate email address
phonestringOptionalPhone number (max. 50 characters)
cover_letterstringOptionalCover letter (max. 5,000 characters)
sourcestringOptionalApplication sourcez.B. hris_sync
cURLBash
curl -X POST "https://api.aeroselect.io/api/v2/external/applications" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": 1,
    "first_name": "Anna",
    "last_name": "Schmidt",
    "email": "[email protected]",
    "phone": "+49 170 123 4567",
    "cover_letter": "Sehr geehrte Damen und Herren...",
    "source": "hris_sync"
  }'
Response 201JSON
{
  "data": {
    "id": 102,
    "code": "APPZQR9M",
    "status": "pending",
    "job_id": 1,
    "submitted_at": "2026-05-22T10:00:00Z"
  },
  "message": "Application submitted successfully."
}

Duplicate Protection

If a candidate with the same email has already applied for this job, the API responds with HTTP 409 Conflict. Check the status of the existing application before resubmitting.

PATCH /applications/{id}/status — Change Status

Requires scope applications:write.

PATCHhttps://api.aeroselect.io/api/v2/external/applications/{id}/status
cURLBash
curl -X PATCH "https://api.aeroselect.io/api/v2/external/applications/101/status" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "interview" }'

Automatic Timestamps

When setting status hired , hired_at is set automatically. For rejected , rejected_at is set.

POST /applications/{id}/notes — Add Note

Adds an internal or public note to an application. Requires scope applications:write.

POSThttps://api.aeroselect.io/api/v2/external/applications/{id}/notes
FeldTypPflichtBeschreibung
note_textstringPflichtNote text (max. 5,000 characters)
visibilityenumOptionalinternal (default) | public — whether the candidate can see the note
cURLBash
curl -X POST "https://api.aeroselect.io/api/v2/external/applications/101/notes" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "note_text": "Kandidat hat hervorragende ATPL-Erfahrung. Für finales Interview einplanen.",
    "visibility": "internal"
  }'
Response 201JSON
{
  "data": {
    "id": 201,
    "note_text": "Kandidat hat hervorragende ATPL-Erfahrung...",
    "visibility": "internal",
    "created_at": "2026-05-22T11:00:00Z"
  },
  "message": "Note added."
}