Api Endpoint

tollbooth

Up to 5 airports with scheduled service nearest a named place, ranked by real road drive time (never a straight-line guess), with IATA and ICAO codes. airport_size 'large' keeps large airports only. Within 300 km; none in range is a 422; airports with no road route are left out. OpenStreetMap routing, OurAirports data, worldwide.

Open interactive test console

Offering

Provider
api.flipvo.com
Method
POST
Offering type
Api Endpoint
Transport type
http
Category
Location And Travel
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://api.flipvo.com/v1/airport/nearest
MIME type
Not provided
First seen
2026-10-16T01:50:38.788Z
Last seen
Tags
Geo, routing, distance, travel, airports

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.02 USDC
Atomic price: 20000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "20000",
    "payTo": "0x849610c11c1e9b309235932faab6368cee7f7c57"
  }
]

Observed health

Status
Reachable
Latest latency
45 ms
Average latency
47 ms
HTTP status
405
Last checked
Reachability
100% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "additionalProperties": false,
  "properties": {
    "body": {
      "description": "A place to search from, how many airports to return, and which airports count.",
      "properties": {
        "airport_size": {
          "default": "scheduled",
          "description": "scheduled: any airport with scheduled passenger service. large: OurAirports type large_airport with scheduled service.",
          "enum": [
            "scheduled",
            "large"
          ],
          "title": "Airport Size",
          "type": "string"
        },
        "k": {
          "default": 3,
          "description": "How many airports",
          "maximum": 5,
          "minimum": 1,
          "title": "K",
          "type": "integer"
        },
        "location": {
          "examples": [
            "Lakeland, FL"
          ],
          "maxLength": 200,
          "minLength": 1,
          "pattern": "\\S",
          "title": "Location",
          "type": "string"
        },
        "near": {
          "anyOf": [
            {
              "maxLength": 200,
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Disambiguation hint, e.g. 'Florida'",
          "title": "Near"
        }
      },
      "required": [
        "location"
      ],
      "title": "NearestAirportRequest",
      "type": "object"
    },
    "bodyType": {
      "enum": [
        "json",
        "form-data",
        "text"
      ],
      "type": "string"
    },
    "method": {
      "enum": [
        "POST",
        "PUT",
        "PATCH"
      ],
      "type": "string"
    },
    "type": {
      "const": "http",
      "type": "string"
    }
  },
  "required": [
    "type",
    "method",
    "bodyType",
    "body"
  ],
  "type": "object"
}

Output schema

{
  "properties": {
    "example": {
      "properties": {
        "airports": {
          "description": "Nearest first by road drive time",
          "items": {
            "properties": {
              "distance_m": {
                "title": "Distance M",
                "type": "integer"
              },
              "duration_s": {
                "title": "Duration S",
                "type": "integer"
              },
              "iata": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "null for the few scheduled airports without one",
                "title": "Iata"
              },
              "icao": {
                "description": "OurAirports ident: the ICAO code where one exists",
                "title": "Icao",
                "type": "string"
              },
              "lat": {
                "title": "Lat",
                "type": "number"
              },
              "lon": {
                "title": "Lon",
                "type": "number"
              },
              "miles": {
                "title": "Miles",
                "type": "number"
              },
              "minutes": {
                "title": "Minutes",
                "type": "number"
              },
              "municipality": {
                "title": "Municipality",
                "type": "string"
              },
              "name": {
                "title": "Name",
                "type": "string"
              },
              "type": {
                "description": "OurAirports type: large_airport, medium_airport, ...",
                "title": "Type",
                "type": "string"
              }
            },
            "required": [
              "iata",
              "icao",
              "name",
              "municipality",
              "type",
              "lat",
              "lon",
              "distance_m",
              "duration_s",
              "miles",
              "minutes"
            ],
            "title": "AirportOut",
            "type": "object"
          },
          "title": "Airports",
          "type": "array"
        },
        "airports_data_as_of": {
          "description": "When our OurAirports file was fetched (UTC)",
          "title": "Airports Data As Of",
          "type": "string"
        },
        "attribution": {
          "title": "Attribution",
          "type": "string"
        },
        "origin": {
          "properties": {
            "confidence": {
              "title": "Confidence",
              "type": "number"
            },
            "kind": {
              "title": "Kind",
              "type": "string"
            },
            "lat": {
              "title": "Lat",
              "type": "number"
            },
            "lon": {
              "title": "Lon",
              "type": "number"
            },
            "name": {
              "title": "Name",
              "type": "string"
            },
            "source": {
              "title": "Source",
              "type": "string"
            }
          },
          "required": [
            "name",
            "lat",
            "lon",
            "kind",
            "source",
            "confidence"
          ],
          "title": "PlaceOut",
          "type": "object"
        }
      },
      "required": [
        "origin",
        "airports",
        "attribution",
        "airports_data_as_of"
      ],
      "title": "NearestAirportResponse",
      "type": "object"
    },
    "type": {
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}