Applications
Manage applications, update status and add notes.
Application Object
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | integer | Pflicht | Unique application ID |
| code | string | Optional | Public application codez.B. APP8XK2P |
| status | enum | Pflicht | pending | reviewed | shortlisted | interview | offered | hired | rejected | withdrawn |
| source | string | Optional | Application sourcez.B. api |
| cover_letter | string|null | Optional | Candidate cover letter |
| job_id | integer | Optional | Job ID |
| job | object | Optional | { id, title } — Brief job info |
| candidate | object | Optional | { id, first_name, last_name, email, phone } |
| pipeline_stage | object|null | Optional | { id, name } — Current pipeline stage |
| hired_at | datetime|null | Optional | Time of hire |
| rejected_at | datetime|null | Optional | Time of rejection |
| submitted_at | datetime | Optional | Submission timestamp (ISO 8601) |
| created_at | datetime | Optional | Creation 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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| job_id | integer | Optional | Filter by job ID |
| status | string | Optional | Filter by application status |
| page | integer | Optional | Page 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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| job_id | integer | Pflicht | Job ID |
| first_name | string | Pflicht | First name (max. 100 characters) |
| last_name | string | Pflicht | Last name (max. 100 characters) |
string | Pflicht | Candidate email address | |
| phone | string | Optional | Phone number (max. 50 characters) |
| cover_letter | string | Optional | Cover letter (max. 5,000 characters) |
| source | string | Optional | Application 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
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| note_text | string | Pflicht | Note text (max. 5,000 characters) |
| visibility | enum | Optional | internal (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."
}