Jobs
Create, read, edit job listings and manage status for your AeroHire tenant.
Job Object
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | integer | Pflicht | Unique job ID |
| title | string | Pflicht | Job titlez.B. First Officer A320 |
| description | string|null | Optional | Job description (HTML allowed) |
| requirements | string|null | Optional | Requirements (HTML allowed) |
| status | enum | Pflicht | draft | online | offline | archived |
| work_model | enum|null | Optional | onsite | remote | hybrid |
| job_type | enum|null | Optional | full-time | part-time | contract | internship | temporary |
| salary_min | number|null | Optional | Minimum salaryz.B. 45000 |
| salary_max | number|null | Optional | Maximum salaryz.B. 65000 |
| salary_currency | string|null | Optional | ISO 4217 currency codez.B. EUR |
| salary_period | enum|null | Optional | hourly | monthly | yearly |
| remote_ok | boolean | Optional | Remote work possible |
| visa_sponsorship | boolean | Optional | Visa sponsorship available |
| skills | array|null | Optional | Desired skillsz.B. ["ATPL", "A320 Type Rating"] |
| certifications | array|null | Optional | Required certifications |
| applications_count | integer | Optional | Number of applications received |
| expires_at | datetime|null | Optional | Listing expiry date (ISO 8601) |
| created_at | datetime | Optional | Creation timestamp (ISO 8601) |
| updated_at | datetime | Optional | Last modified (ISO 8601) |
GET /jobs — List All Jobs
Returns a paginated list of all jobs for the tenant.
GEThttps://api.aeroselect.io/api/v2/external/jobs
Query Parameters
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| status | string | Optional | Filter by status: draft, online, offline, archived |
| search | string | Optional | Full-text search in title |
| page | integer | Optional | Page number (default: 1) |
| per_page | integer | Optional | Entries per page (default: 25, max: 100) |
cURLBash
curl "https://api.aeroselect.io/api/v2/external/jobs?status=online&page=1" \
-H "X-API-Key: ak_live_YOUR_KEY"Node.jsJavaScript
const response = await fetch(
"https://api.aeroselect.io/api/v2/external/jobs?status=online&page=1",
{ headers: { "X-API-Key": process.env.AEROSELECT_API_KEY } }
);
const { data: jobs, meta } = await response.json();
console.log(`${meta.total} Jobs gefunden`);Response 200JSON
{
"data": [
{
"id": 1,
"title": "First Officer A320",
"status": "online",
"work_model": "onsite",
"job_type": "full-time",
"salary_min": 48000,
"salary_max": 72000,
"salary_currency": "EUR",
"salary_period": "yearly",
"remote_ok": false,
"visa_sponsorship": true,
"skills": ["ATPL", "A320 Type Rating", "EASA Medical Class 1"],
"applications_count": 23,
"expires_at": "2026-08-31T00:00:00Z",
"created_at": "2026-05-01T10:00:00Z",
"updated_at": "2026-05-15T14:30:00Z"
}
],
"meta": {
"current_page": 1,
"last_page": 3,
"per_page": 25,
"total": 67
},
"links": {
"first": "https://api.aeroselect.io/api/v2/external/jobs?page=1",
"next": "https://api.aeroselect.io/api/v2/external/jobs?page=2",
"prev": null,
"last": "https://api.aeroselect.io/api/v2/external/jobs?page=3"
}
}GET /jobs/{id} — Get Single Job
GEThttps://api.aeroselect.io/api/v2/external/jobs/{id}
Bash
curl "https://api.aeroselect.io/api/v2/external/jobs/1" \
-H "X-API-Key: ak_live_YOUR_KEY"POST /jobs — Create Job
Creates a new job with status draft. . Requires scope jobs:write.
POSThttps://api.aeroselect.io/api/v2/external/jobs
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| title | string | Pflicht | Job title (max. 255 characters) |
| description | string | Optional | Job description |
| requirements | string | Optional | Requirements |
| work_model | enum | Optional | onsite | remote | hybrid |
| job_type | enum | Optional | full-time | part-time | contract | internship | temporary |
| salary_min | number | Optional | Minimum salary |
| salary_max | number | Optional | Maximum salary |
| salary_currency | string | Optional | ISO 4217 (e.g. EUR, USD) |
| salary_period | enum | Optional | hourly | monthly | yearly |
| remote_ok | boolean | Optional | Remote work possible |
| visa_sponsorship | boolean | Optional | Visa sponsorship |
| skills | array | Optional | Array of skills as strings |
| certifications | array | Optional | Array of certifications as strings |
| expires_at | datetime | Optional | Expiry date (must be in the future) |
cURLBash
curl -X POST "https://api.aeroselect.io/api/v2/external/jobs" \
-H "X-API-Key: ak_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Captain B737",
"work_model": "onsite",
"job_type": "full-time",
"salary_min": 95000,
"salary_max": 130000,
"salary_currency": "EUR",
"salary_period": "yearly",
"visa_sponsorship": true,
"skills": ["ATPL", "B737 Type Rating"],
"expires_at": "2026-09-30"
}'Response 201JSON
{
"data": {
"id": 42,
"title": "Captain B737",
"status": "draft",
"code": "JOB8XK2P",
"slug": "captain-b737-abc123",
"work_model": "onsite",
"job_type": "full-time",
"salary_min": 95000,
"salary_max": 130000,
"salary_currency": "EUR",
"salary_period": "yearly",
"visa_sponsorship": true,
"skills": ["ATPL", "B737 Type Rating"],
"applications_count": 0,
"created_at": "2026-05-22T09:15:00Z"
},
"message": "Job created."
}PATCH /jobs/{id} — Edit Job
Updates individual fields of a job. Fields not specified remain unchanged (PATCH semantics). Requires scope jobs:write.
PATCHhttps://api.aeroselect.io/api/v2/external/jobs/{id}
cURLBash
curl -X PATCH "https://api.aeroselect.io/api/v2/external/jobs/42" \
-H "X-API-Key: ak_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "salary_max": 140000, "visa_sponsorship": true }'PATCH /jobs/{id}/status — Change Status
Changes only the status of a job. Requires scope jobs:write.
PATCHhttps://api.aeroselect.io/api/v2/external/jobs/{id}/status
Status Workflow
Jobs typically follow this workflow:
draft → online → archived. A job with status online is visible on the career page. offline hides the job without archiving it.cURLBash
curl -X PATCH "https://api.aeroselect.io/api/v2/external/jobs/42/status" \
-H "X-API-Key: ak_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{ "status": "online" }'Response 200JSON
{
"data": {
"id": 42,
"title": "Captain B737",
"status": "online",
"updated_at": "2026-05-22T10:00:00Z"
},
"message": "Job status updated."
}