Core Endpoints
GET
/api/health
Check service health, uptime, and database connectivity status.
curl -s "http://www.orbicost.com/api/health"
// Response:
{ "status": "ok" }
GET
/api/search?q={query}&lang={lang}
Search 93 indexed metropolitan centers across 20 languages with fuzzy string matching.
curl -s "http://www.orbicost.com/api/search?q=tokyo&lang=en"
POST
/api/verify-city
Verify existence of a city in the index and obtain geospatial coordinate anchors.
curl -s -X POST "http://www.orbicost.com/api/verify-city" \
-H "Content-Type: application/json" \
-d '{"cityName":"Berlin","country":"Germany"}'
GET
/api/status
Query current client session status, usage limits, and active access tiers.
curl -s "http://www.orbicost.com/api/status"