Pipeline Stages
Retrieve the configured pipeline stages for the tenant. Pipeline stages structure the recruiting process from application to hire.
What are Pipeline Stages?
Pipeline stages define the steps in the recruiting process through which applicants are guided. Each tenant can configure custom stages. In addition there are system-fixed stages (is_fixed: true) that cannot be deleted.
Pipeline Stage Object
| Field | Type | Description |
|---|---|---|
| id | integer | Unique stage ID |
| name | string | Name of the pipeline stage |
| order | integer | Order in the pipeline (ascending) |
| is_fixed | boolean | true = system stage (cannot be deleted) |
| color | string|null | Display color as hex code |
GET /pipeline-stages — Get All Stages
Requires scope settings:read.
GEThttps://api.aeroselect.io/api/v2/external/pipeline-stages
cURLBash
curl "https://api.aeroselect.io/api/v2/external/pipeline-stages" \
-H "X-API-Key: ak_live_YOUR_KEY"Response 200JSON
{
"data": [
{
"id": 1,
"name": "Incoming",
"order": 1,
"is_fixed": true,
"color": "#6b7280"
},
{
"id": 2,
"name": "Pre-selection",
"order": 2,
"is_fixed": false,
"color": "#3b82f6"
},
{
"id": 3,
"name": "Phone Interview",
"order": 3,
"is_fixed": false,
"color": "#8b5cf6"
},
{
"id": 4,
"name": "Assessment Center",
"order": 4,
"is_fixed": false,
"color": "#f59e0b"
},
{
"id": 5,
"name": "Final Interview",
"order": 5,
"is_fixed": false,
"color": "#10b981"
},
{
"id": 6,
"name": "Offer",
"order": 6,
"is_fixed": true,
"color": "#22c55e"
}
]
}Read-only via API
Pipeline stages can currently only be created and edited through the AeroHire user interface. The API provides a read-only endpoint so integrations know the stage IDs for application assignments.
Node.js — Cache stagesJavaScript
// Pipeline-Stufen einmal abrufen und cachen
const CACHE_TTL = 60 * 60 * 1000; // 1 Stunde
let stagesCache: { data: PipelineStage[]; fetchedAt: number } | null = null;
async function getPipelineStages() {
if (stagesCache && Date.now() - stagesCache.fetchedAt < CACHE_TTL) {
return stagesCache.data;
}
const response = await fetch(
"https://api.aeroselect.io/api/v2/external/pipeline-stages",
{ headers: { "X-API-Key": process.env.AEROSELECT_API_KEY } }
);
const { data } = await response.json();
stagesCache = { data, fetchedAt: Date.now() };
return data;
}
// Stage-ID nach Name finden
const stages = await getPipelineStages();
const finalInterview = stages.find((s) => s.name === "Final Interview");