POST budgetatlas/v1/search_flights

POSTbudgetatlas/v1/search_flightsverifiedsync

Find observed round-trip fares from European hubs into Southeast Asian cities. Returns the observed fare distribution per route (minimum, quartiles, maximum), how many itineraries it was computed from, the fewest stops and shortest duration seen, and provenance. Fares are whole-trip totals for the whole party and are historical observations, not live availability. Rows marked `provisional` were read before the source's result list settled, so their minimum is biased high. Aggregates only: no itinerary-level fares or booking links are published. A priced call is settled only when the response contains observations; a no-data answer (`no_data_reason` set) is returned unbilled, marked by the `X-BUDGETATLAS-BILLED` response header.

Provider rate: $0.002 per call

Billed: $0.0022 per call ($0.002 + 10% fee)

Call get_dataset_coverage first. It is free and lists the cities and cohorts that exist.

An answer with no data (no_data_reason set) is not settled upstream. OpenTools bills zero for it.

Provider documentation →

Input schema

destination_city_idstring

Southeast Asian city ID, e.g. 'th-bangkok'. Resolves to that city's airport(s).

destination_iatastring

Destination airport IATA code, e.g. 'BKK'.

origin_iatastring

European origin airport IATA code, e.g. 'CDG'.

depart_monthstring

Departure month, e.g. '2026-09'. Each month is represented by one sampled departure date.

max_price_usdnumber

Ceiling on the observed minimum fare for the route.

nonstop_onlyboolean

Keep only routes with an observed nonstop itinerary.

include_provisionalboolean

Include readings taken before the source's result list settled (sample_count < 20 or status != 'ok'). They are always marked; set false to exclude them.

trip_typestring

adultsinteger

cabinstring

stay_nightsstring

limitinteger

Use this exact tool

Every snippet below names budgetatlas/v1/search_flights, so an agent runs this endpoint instead of searching for something similar.

Paste into your agent

Use the OpenTools tool budgetatlas/v1/search_flights (https://opentools.fulinlabs.com/tools/budgetatlas/v1/search_flights?method=POST). Connect to the OpenTools MCP server at https://opentools.fulinlabs.com/mcp (or install the CLI with `npm i -g @aeither/opentools`). Do not search the catalog — call `inspect` with provider "budgetatlas" and endpoint "/v1/search_flights" and method "POST" for the input schema, then `run` with the same provider and endpoint.

CLI

opentools run -p budgetatlas -e /v1/search_flights --method POST -i '{"body":{"destination_city_id":"","destination_iata":"","origin_iata":"","depart_month":"","max_price_usd":0,"nonstop_only":false,"include_provisional":false,"trip_type":"","adults":0,"cabin":"","stay_nights":"","limit":0}}' -w

HTTP

curl -X POST https://opentools.fulinlabs.com/v1/run \
  -H "Authorization: Bearer opentools_live_..." \
  -H "content-type: application/json" \
  -d '{"provider":"budgetatlas","endpoint":"/v1/search_flights","method":"POST","input":{"body":{"destination_city_id":"","destination_iata":"","origin_iata":"","depart_month":"","max_price_usd":0,"nonstop_only":false,"include_provisional":false,"trip_type":"","adults":0,"cabin":"","stay_nights":"","limit":0}}}'

Connect

Skill

set up https://opentools.fulinlabs.com/SKILL.md

MCP

https://opentools.fulinlabs.com/mcp

CLI

npm i -g @aeither/opentools

Try it →

Share this tool

Send this link to whoever should use it. It carries the schema, the price, and the snippets above — they need an OpenTools key and a balance, nothing from you.

https://opentools.fulinlabs.com/tools/budgetatlas/v1/search_flights?method=POST