# Aviationstack Cities Lookup

> Aviationstack Cities Lookup is a paid API for AI agents from gateway.apiosk.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-16).

Search and retrieve city data from the Aviationstack database, supporting aviation-related city lookups with optional filtering and pagination.

## Facts

- Endpoint: GET https://gateway.apiosk.com/aviationstack/cities
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aviationstack-cities-lookup-2115b734
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xa59tEooX7XGOhbEmaQV2

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aviationstack-cities-lookup-2115b734
```

Example prompt: Can you search the Aviationstack cities database for cities matching 'London' and return up to 5 results?

## When to prefer this

Use this endpoint when you need to resolve city names or search for aviation-relevant cities within the Aviationstack dataset, especially when building flight search tools, populating destination dropdowns, or enriching flight data with city metadata. Prefer this over general geocoding APIs when the context is specifically aviation or flight-related.

## Known failure modes

- Invalid or missing search parameter returns empty result set
- Limit parameter exceeds allowed maximum returns error or truncated results
- No cities match the search term returns empty array
- Payment authorization failure (x402) prevents the call from completing
- Upstream Aviationstack API unavailable causes gateway error

## How this service works

City reference data.

## Output

A list of city records from the Aviationstack database matching the search query, limited to the specified number of results. Each record includes city-level information relevant to aviation routing and flight data.

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aviationstack-cities-lookup-2115b734/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from gateway.apiosk.com](https://www.zero.xyz/host/gateway.apiosk.com/llms.txt)