Airport services

Besides transfers you can sell airport services: fast track security and passport control, VIP lounge access, and meet & assist from the aircraft door to the car. They can be booked alone or together with a transfer in the same booking.

Hints in transfer quotes

When a transfer starts or ends at an airport, POST /quotes also returns airport_services: one hint per airport end that has bookable services. Picking up at the airport means arrival, dropping off at the airport means departure (lounges are only offered on departure).

"airport_services": [
  { "airport": "AYT", "direction": "departure", "count": 2, "types": ["fast_track", "lounge"],
    "from": { "amount": 60.0, "currency": "EUR" }, "suggested_at": "2026-11-20T11:15",
    "search": "/api/v1/airport-services?airport=AYT&date=2026-11-20&time=11:15&direction=departure&adults=2&children=0&infants=0" }
]

suggested_at: on arrival the pick-up time, on departure the estimated time at the airport (pick-up + drive + security margin).
search: call it (with your key) to get the services and their offer_id values. The array is empty when no service is available, and for hourly quotes.

Finding services

curl "https://paxvelhub.com/api/v1/airport-services?airport=IST&date=2026-11-20&time=09:30&direction=arrival&adults=2&children=1" \
  -H "Authorization: Bearer $PAXVEL_KEY"

Parameter	Required	Meaning
`airport`	yes	IATA code of the airport.
`date`	yes	Service date, `YYYY-MM-DD`.
`time`	no	Local time (landing or departure), `HH:MM`. Default `12:00`.
`direction`	no	`arrival` or `departure`. Without it, options for both are returned.
`adults`, `children`, `infants`	no	Number of travellers; prices depend on it.

{
  "data": [
    {
      "id": 7, "type": "meet_assist", "name": "IST Meet & Assist", "airport": "IST", "terminal": "International",
      "meeting_point": "Aircraft door, name board",
      "description": "Personal greeter, fast track through passport control and baggage assistance to your car.",
      "options": [
        { "offer_id": "of_eyJ2Ijo…", "name": "Arrival — standard", "duration_hours": 2, "direction": "arrival", "price": 95.0, "currency": "EUR", "expires_at": "2026-11-01T09:30:00+00:00" }
      ]
    }
  ]
}

Each option has its own offer_id and total price for the given travellers.

Booking a service

Send service offers in services — next to transfer items if you want both in one booking:

POST /bookings
{
  "services": [ { "offer_id": "of_eyJ2Ijo…", "flight_number": "TK1984", "at": "2026-11-20 09:30", "for_item": 0 } ],
  "items":    [ { "offer_id": "of_eyJ3Ij…", "flight_number": "TK1984" } ],
  "lead_passenger": { "name": "Anna Peeters", "phone": "+32 470 12 34 56" }
}

at (optional) changes the service time on the quoted date, YYYY-MM-DD HH:MM local time.
flight_number is required in practice: the greeter needs it to meet the traveller.
for_item (optional) links the service to a transfer in the same request: the 0-based index in items. Linked services are handled together with that transfer (e.g. when its time changes).

In the booking, a service appears as an item with "type": "airport_service" and a service object (name, option). A linked service also carries linked_item_id, the id of its transfer item.

← Quotes and booking Booking lifecycle →