Pay-per-call countries lookup from AviationStack via MPP on Tempo L2
What it does
This endpoint provides a countries lookup service sourced from AviationStack, a well-known aviation data provider offering real-time and historical flight tracking, airport, airline, and schedule information. The endpoint is wrapped with the Micropayment Protocol (MPP) and settles payments on the Tempo L2 chain (chainId 4217) using pathUSD.
Each call costs 5,000 base units of pathUSD. Assuming pathUSD uses 6 decimals (consistent with other USD stablecoins), this translates to $0.005 (half a cent) per request. The endpoint is live and responds with a proper 402 Payment Required challenge on unauthenticated GET requests. Payment is one-shot (intent: charge), meaning each API call is individually settled. The provider covers gas fees (feePayer: true).
No documentation, OpenAPI schema, or example responses were found on the provider's domain — all auxiliary pages (docs, api, pricing, README) return 404. The endpoint path `/v1/countries` and the description "Countries lookup" suggest it returns a list or filtered set of countries relevant to aviation data (likely including country codes, names, and related metadata), but the exact response schema is unknown. Agents should expect a JSON response consistent with AviationStack's public countries API, though the precise field set cannot be confirmed from available material.
Capabilities
Use cases
- —Retrieving a list of countries for aviation-related applications
- —Looking up country metadata (codes, names) to enrich flight or airport data
- —Building travel or logistics tools that need standardized country references
- —Populating dropdowns or filters in flight search interfaces
Fit
Best for
- —Agents needing on-demand country reference data without API key management
- —Micropayment-based access to AviationStack data
- —Low-cost, per-call aviation reference lookups
Not for
- —Bulk downloading entire country datasets (pay-per-call adds up)
- —Use cases requiring detailed country geospatial boundaries or polygons
- —Free-tier or high-volume batch processing where per-call costs are prohibitive
Quick start
curl -i https://aviationstack.mpp.tempo.xyz/v1/countries
# Returns 402 with WWW-Authenticate: Payment header.
# Pay the challenge (~$0.005 in pathUSD on Tempo L2) and resend with payment proof.Endpoint
Quality
The endpoint is live and returns a valid MPP 402 challenge, confirming it is operational. However, there is no documentation, no OpenAPI schema, no example responses, and all auxiliary pages return 404. The response format and query parameters are entirely unknown. Pricing is inferrable but the currency contract address is not independently verified.
Warnings
- —No documentation found — all doc/api/pricing/README pages return 404
- —No OpenAPI or response schema available; response format is unknown
- —Query parameters (if any) are undocumented
- —Currency contract address 0x20c0...8b50 on chainId 4217 is assumed to be pathUSD with 6 decimals but could not be independently verified
Citations
- —The endpoint returns a 402 MPP challenge with method=tempo, intent=charge, amount=5000, chainId=4217https://aviationstack.mpp.tempo.xyz/v1/countries
- —Part of AviationStack: Real-time and historical flight tracking, airports, airlines, and scheduleshttps://aviationstack.mpp.tempo.xyz/v1/countries