Pay-per-call cities lookup from the AviationStack aviation data API via MPP on Tempo L2.
What it does
This endpoint provides a cities lookup service as part of the AviationStack suite, which covers real-time and historical flight tracking, airports, airlines, and schedules. The cities endpoint is accessible at `https://aviationstack.mpp.tempo.xyz/v1/cities` and is gated behind the Machine Payment Protocol (MPP) using the Tempo settlement method on chain ID 4217.
Each request is charged per call (intent: "charge") at 5,000 base units of pathUSD (0x20c0…8b50 on Tempo L2, 6 decimals), which works out to $0.005 (half a cent) per request. The provider covers gas fees (feePayer: true), so callers only pay the data fee. Payment settles to recipient address 0xca4e835F803cB0b7C428222B3A3B98518d4779Fe.
No OpenAPI schema, documentation pages, or example responses were found on the provider's origin. The endpoint is confirmed live — it returns a well-formed 402 MPP challenge on GET. Based on the AviationStack upstream API, the cities endpoint likely returns paginated city records including city name, IATA code, country, latitude/longitude, and timezone, but the exact response schema for this MPP-wrapped version is unverified.
Capabilities
Use cases
- —Look up city metadata (name, country, coordinates) for flight-related applications
- —Enrich airport or route data with associated city information
- —Build travel search interfaces that resolve city names and codes
- —Power autocomplete for city selection in booking or tracking tools
Fit
Best for
- —Agents needing on-demand city reference data for aviation workflows
- —Pay-per-call access without subscription commitments
- —Programmatic micropayment-based data retrieval on Tempo L2
Not for
- —Bulk export of entire city databases (per-call pricing adds up)
- —Use cases requiring detailed city demographics or non-aviation metadata
- —Users who cannot settle payments on Tempo L2 (chain 4217)
Quick start
curl -X GET "https://aviationstack.mpp.tempo.xyz/v1/cities" \
-H "Authorization: Payment <tempo-payment-token>"Endpoint
Quality
The endpoint is confirmed live with a valid 402 MPP challenge, and pricing is clear ($0.005/call in pathUSD on Tempo). However, no documentation, OpenAPI schema, or example responses are available — all crawled pages return 404. The response format and query parameters are entirely unverified.
Warnings
- —No documentation or OpenAPI schema found — all doc paths return 404.
- —Response schema and supported query parameters are unknown; behavior is inferred from the upstream AviationStack API.
- —Currency contract address 0x20c0…8b50 assumed to be pathUSD with 6 decimals on Tempo chain 4217; if decimals differ, the stated price is wrong.
Citations
- —Endpoint returns a 402 MPP challenge with method=tempo, intent=charge, amount=5000, chainId=4217https://aviationstack.mpp.tempo.xyz/v1/cities
- —Part of AviationStack: Real-time and historical flight tracking, airports, airlines, and scheduleshttps://aviationstack.mpp.tempo.xyz/v1/cities