POST/v2/flight/init-search

Start a search

Fire-and-forget. You get a searchId immediately; fares arrive when you poll.

Bearer tokenAuthority: B2C_FLIGHT_SEARCHhttps://booking.aerolink.dev

A 200 means the search started, not that results exist. Providers are queried in the background. The storefront agency is attached server-side from the principal so rows are priced with your markup — a client cannot influence that.

cURL

bash

curl -X POST https://booking.aerolink.dev/v2/flight/init-search \
  -H "Authorization: Bearer eyJ..." \
  -H "Content-Type: application/json" \
  -d '{"originDest":[{"departure":"DAC","arrival":"DXB","date":"2026-10-15"}],"travellers":{"adults":1,"children":0,"kids":0,"infants":0},"tripType":"ONE_WAY","cabinClass":"ECONOMY"}'

Headers

AuthorizationBearer

required

Customer access token

Content-Typeapplication/json

required

JSON body

`Authorization` Bearer required	Customer access token
`Content-Type` application/json required	JSON body

Request

JSON

{
  "originDest": [
    { "departure": "DAC", "arrival": "DXB", "date": "2026-10-15" }
  ],
  "travellers": { "adults": 1, "children": 0, "kids": 0, "infants": 0 },
  "tripType": "ONE_WAY",
  "cabinClass": "ECONOMY",
  "preferredAirlines": ["EK"],
  "isStudentFare": false,
  "isOmrahFare": false,
  "directFlight": false,
  "radiusSearch": { "enabled": false, "miles": 50, "allowBorderCross": true }
}

Body fields

originDestarray

required

One entry per leg. Must be non-empty.

originDest[].departurestring

required

Origin IATA. Trimmed and upper-cased.

originDest[].arrivalstring

required

Destination IATA

originDest[].datestring

required

Journey date

travellers.adultsnumber

required

Must be ≥ 1

travellers.childrennumber

optional

Aged 8 when childAges is absent

travellers.kidsnumber

optional

Aged 5 when childAges is absent

travellers.infantsnumber

optional

Aged 1 when childAges is absent

travellers.childAgesnumber[]

optional

When present, replaces children, kids and infants entirely.

tripTypeenum

optional

ONE_WAY, RETURN, …

cabinClassenum

optional

ECONOMY, PREMIUM_ECONOMY, BUSINESS, PREMIUM_BUSINESS, FIRST_CLASS

preferredAirlinesstring[]

optional

Restricts which PCC sources are queried

isStudentFareboolean

optional

Sabre pax type STU

isOmrahFareboolean

optional

Sabre pax type ADR

directFlightboolean

optional

Nonstop only. Connecting itineraries are dropped after merge.

radiusSearchobject

optional

Sabre nearby-airport shop. BdFare ignores it. miles is 1–100 when enabled.

`originDest` array required	One entry per leg. Must be non-empty.
`originDest[].departure` string required	Origin IATA. Trimmed and upper-cased.
`originDest[].arrival` string required	Destination IATA
`originDest[].date` string required	Journey date
`travellers.adults` number required	Must be ≥ 1
`travellers.children` number optional	Aged 8 when childAges is absent
`travellers.kids` number optional	Aged 5 when childAges is absent
`travellers.infants` number optional	Aged 1 when childAges is absent
`travellers.childAges` number[] optional	When present, replaces children, kids and infants entirely.
`tripType` enum optional	ONE_WAY, RETURN, …
`cabinClass` enum optional	ECONOMY, PREMIUM_ECONOMY, BUSINESS, PREMIUM_BUSINESS, FIRST_CLASS
`preferredAirlines` string[] optional	Restricts which PCC sources are queried
`isStudentFare` boolean optional	Sabre pax type STU
`isOmrahFare` boolean optional	Sabre pax type ADR
`directFlight` boolean optional	Nonstop only. Connecting itineraries are dropped after merge.
`radiusSearch` object optional	Sabre nearby-airport shop. BdFare ignores it. miles is 1–100 when enabled.

Response

200

{
  "message": "Success",
  "data": {
    "searchId": "9f2c...",
    "initiatedAt": "2026-09-02T15:30:00"
  },
  "error": null
}

Response fields

searchIdstring

Poll results with this

initiatedAtdatetime

When the search started

`searchId` string	Poll results with this
`initiatedAt` datetime	When the search started

Business rules

The agency is part of the itinerary cache key, so two storefronts with different markups never share cached prices.
IATA codes are trimmed and upper-cased for you.

Errors

400validation failed

Empty originDest, missing leg fields, no travellers, adults < 1, negative child counts, or both student and omrah fares.

401 / 403UNAUTHORIZED

Missing token or missing B2C_FLIGHT_SEARCH

HTTP	message	When
400	validation failed	Empty originDest, missing leg fields, no travellers, adults < 1, negative child counts, or both student and omrah fares.
401 / 403	UNAUTHORIZED	Missing token or missing B2C_FLIGHT_SEARCH