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

FieldTypeDescription
idintegerUnique stage ID
namestringName of the pipeline stage
orderintegerOrder in the pipeline (ascending)
is_fixedbooleantrue = system stage (cannot be deleted)
colorstring|nullDisplay 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");