AsterConsult Country - Global Geo-Location API

🚀

Fast & Reliable

Lightning-fast API responses with 99.9% uptime. Built with Bun and Elysia for maximum performance.

Low latency responses
Auto-scaling infrastructure
Global CDN ready

📍

Complete Data

Access detailed information about countries, states, and cities including timezones and coordinates.

ISO codes & standards
Timezone data
Geographic coordinates

🔍

Powerful Search

Search and filter by country names, codes, currencies, cities, and more with flexible pagination.

Full-text search
Pagination support
Multi-field filtering

✨ Key Features

🎯 Action-Oriented API

RESTful endpoints designed for real-world use cases with clear, descriptive action names like get-all-countries, search-cities-by-name.

📊 Smart Pagination

Built-in pagination with configurable page and limit parameters (default 20, max 200 items per page).

🗺️ Geographic Hierarchy

Fully structured data: Countries → States/Regions → Cities with complete administrative hierarchy.

🌐 Multi-Language Ready

Country names, currencies, and city data compatible with international applications and localization.

⏰ Timezone Support

IANA timezone identifiers for all countries and cities for accurate time conversion and scheduling.

📚 Well-Documented

Interactive Swagger/OpenAPI documentation with examples for every endpoint. Try before you code.

🔗 API Endpoints

Countries

GET /api/country/get-all-countries

Get all countries with pagination

GET /api/country/get-countries?q=search

Search countries by name, code, or currency

GET /api/country/get-country-by-code?code=US

Get single country details

GET /api/country/get-country-timezones?code=US

Get all timezones for a country

States / Provinces

GET /api/state/get-states-of-country?countryCode=US

Get all states of a country

GET /api/state/get-state-by-code?countryCode=US&stateCode=CA

Get single state details

Cities

GET /api/city/get-all-cities-in-world

Get all cities in the world

GET /api/city/get-all-cities-of-country?countryCode=US

Get all cities in a country

GET /api/city/get-cities-of-state?countryCode=US&stateCode=CA

Get all cities in a state

GET /api/city/search-cities-by-name?name=New%20York

Search cities by name

GET /api/city/get-timezone-for-city?countryCode=US&cityName=New%20York

Get timezone for a city

🌍 AsterConsult Country