Search airport transfer options via Amadeus GDS for $0.003 per request, paid with USDC micropayments.
What it does
This endpoint searches available airport transfer offers through the Amadeus Transfer API, exposed as a pay-per-request service by StableTravel. Send a POST request with a pickup airport code, drop-off location (address or geocode), transfer type, date/time, and passenger count. The API returns available transfer offers including private cars, shared shuttles, taxis, airport express, and airport bus options with pricing.
The endpoint is part of StableTravel's broader travel API suite that wraps Amadeus GDS data. It costs $0.003 per call, settled via x402 or MPP protocol using USDC on Base, Solana, or Tempo. No API keys or accounts are required — payment serves as authentication. The typical workflow is: search transfers → book a selected offer via /api/transfers/book. Cancellation is available via /api/transfers/cancel.
The request body requires at minimum `startLocationCode` (IATA airport code) and `startDateTime` (ISO 8601). Drop-off can be specified via address fields (endAddressLine + endCityName + endCountryCode), endGeoCode, or endLocationCode. Optional parameters include transferType (PRIVATE, SHARED, TAXI, HOURLY, AIRPORT_EXPRESS, AIRPORT_BUS), vehicleCategory, vehicleCode, connected flight segments, equipment codes, and extra services. The response returns an array of transfer offer objects with pricing and availability details.
Capabilities
Use cases
- —An AI travel agent searching for private car transfers from CDG airport to a Paris hotel
- —Comparing shared shuttle vs private transfer pricing for a group arriving at JFK
- —Building an end-to-end trip planner that books flights, hotels, and ground transport in one workflow
- —Automating corporate travel arrangements including airport pickup for arriving employees
- —A chatbot helping a user find the cheapest airport-to-city transfer options
Fit
Best for
- —AI agents that need programmatic airport transfer search and booking
- —Travel automation workflows combining flights, hotels, and ground transport
- —Developers who want Amadeus transfer data without managing API keys or OAuth
Not for
- —Searching for inter-city ground transport not connected to airports
- —Real-time ride-hailing (Uber/Lyft style) — this is pre-booked transfers only
- —High-volume batch processing where per-request pricing may not be cost-effective
Quick start
npx agentcash fetch -X POST -H "Content-Type: application/json" \
-d '{"startLocationCode":"CDG","endAddressLine":"Avenue des Champs-Elysees 1","endCityName":"Paris","endCountryCode":"FR","transferType":"PRIVATE","startDateTime":"2025-06-15T10:00:00","passengers":2}' \
"https://stabletravel.dev/api/transfers/search"Example
Request
{
"endGeoCode": "48.8566,2.3522",
"endZipCode": "75008",
"passengers": 2,
"endCityName": "Paris",
"transferType": "PRIVATE",
"startDateTime": "2025-06-15T10:00:00",
"endAddressLine": "Avenue des Champs-Elysees 1",
"endCountryCode": "FR",
"startLocationCode": "CDG"
}Response
{
"data": [
{
"id": "1",
"end": {
"address": {
"line": "Avenue des Champs-Elysees 1",
"cityName": "Paris",
"countryCode": "FR"
}
},
"type": "transfer-offer",
"start": {
"dateTime": "2025-06-15T10:00:00",
"locationCode": "CDG"
},
"vehicle": {
"code": "SED",
"category": "ST",
"description": "Standard Sedan"
},
"quotation": {
"currencyCode": "EUR",
"monetaryAmount": "45.00"
},
"passengers": 2,
"transferType": "PRIVATE"
}
],
"warnings": []
}Endpoint
Quality
Full OpenAPI 3.1 schema with detailed request body, clear pricing ($0.003/call), comprehensive documentation and parameter descriptions. The endpoint returned 405 on HEAD/GET probes which is expected since it's POST-only; the OpenAPI spec confirms it's a live POST endpoint with 402 payment challenge. No actual 402 challenge was captured for this specific endpoint due to method mismatch in probing.
Warnings
- —Probe returned 405 on HEAD and GET — endpoint is POST-only, which is consistent with the OpenAPI spec. No direct 402 challenge was captured for this endpoint.
- —Example response is inferred from Amadeus transfer API patterns and the OpenAPI schema; no actual response sample was provided in the docs.
Citations
- —Transfer search endpoint costs $0.003 per requesthttps://stabletravel.dev/openapi.json
- —Payment via USDC on Base, Solana, or Tempo using x402/MPP protocolhttps://stabletravel.dev
- —No API keys needed — payment serves as authenticationhttps://stabletravel.dev
- —Drop-off requires either full address fields or endGeoCode, or bothhttps://stabletravel.dev/openapi.json
- —Transfer types include PRIVATE, SHARED, TAXI, HOURLY, AIRPORT_EXPRESS, AIRPORT_BUShttps://stabletravel.dev/openapi.json
- —Required fields are startDateTime and startLocationCodehttps://stabletravel.dev/openapi.json
- —Typical workflow is search → book for transfershttps://stabletravel.dev/docs