Jobs

Create, read, edit job listings and manage status for your AeroHire tenant.

Job Object

FeldTypPflichtBeschreibung
idintegerPflichtUnique job ID
titlestringPflichtJob titlez.B. First Officer A320
descriptionstring|nullOptionalJob description (HTML allowed)
requirementsstring|nullOptionalRequirements (HTML allowed)
statusenumPflichtdraft | online | offline | archived
work_modelenum|nullOptionalonsite | remote | hybrid
job_typeenum|nullOptionalfull-time | part-time | contract | internship | temporary
salary_minnumber|nullOptionalMinimum salaryz.B. 45000
salary_maxnumber|nullOptionalMaximum salaryz.B. 65000
salary_currencystring|nullOptionalISO 4217 currency codez.B. EUR
salary_periodenum|nullOptionalhourly | monthly | yearly
remote_okbooleanOptionalRemote work possible
visa_sponsorshipbooleanOptionalVisa sponsorship available
skillsarray|nullOptionalDesired skillsz.B. ["ATPL", "A320 Type Rating"]
certificationsarray|nullOptionalRequired certifications
applications_countintegerOptionalNumber of applications received
expires_atdatetime|nullOptionalListing expiry date (ISO 8601)
created_atdatetimeOptionalCreation timestamp (ISO 8601)
updated_atdatetimeOptionalLast 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

FeldTypPflichtBeschreibung
statusstringOptionalFilter by status: draft, online, offline, archived
searchstringOptionalFull-text search in title
pageintegerOptionalPage number (default: 1)
per_pageintegerOptionalEntries 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
FeldTypPflichtBeschreibung
titlestringPflichtJob title (max. 255 characters)
descriptionstringOptionalJob description
requirementsstringOptionalRequirements
work_modelenumOptionalonsite | remote | hybrid
job_typeenumOptionalfull-time | part-time | contract | internship | temporary
salary_minnumberOptionalMinimum salary
salary_maxnumberOptionalMaximum salary
salary_currencystringOptionalISO 4217 (e.g. EUR, USD)
salary_periodenumOptionalhourly | monthly | yearly
remote_okbooleanOptionalRemote work possible
visa_sponsorshipbooleanOptionalVisa sponsorship
skillsarrayOptionalArray of skills as strings
certificationsarrayOptionalArray of certifications as strings
expires_atdatetimeOptionalExpiry 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."
}