🚀 Quick Start

📚 View Swagger Documentation ❤️ Health Check 💻 GitHub Repository

📊 API Statistics

6
Regions
250
Countries
5,038
States
151,072
Cities

🔗 API Endpoints

GET Regions

/api/regions
Get all geographic regions with pagination, filtering, and sorting support.
Try it →

GET Countries

/api/countries
Get all countries with ISO codes, currency info, timezones, and region relations.
Try it →

GET States

/api/states
Get all states/provinces with country relations and geographic coordinates.
Try it →

GET Cities

/api/cities
Get all cities with state and country relations, coordinates, and search capabilities.
Try it →

GET Country States

/api/countries/:id/states
Get all states for a specific country by country ID.

GET Country Cities

/api/countries/:id/cities
Get all cities for a specific country by country ID.

GET State Cities

/api/states/:id/cities
Get all cities for a specific state/province by state ID.

📖 Example Queries

Try these example queries to explore AinixIt's Country Database API:

🔍 Search Countries

/api/countries?search=United&limit=10
Search for countries containing "United" with instant results
Try it →

🌏 Filter by Region

/api/countries?region_id=3&populate=true
Get all countries in Asia region with complete region details
Try it →

🏙️ Get Cities by Country

/api/cities?country_code=US&page=1&limit=20
Get cities in United States with efficient pagination
Try it →

🗺️ Get State with Country

/api/states/:id?populate=true
Get a state with its country information included in one request

✨ Features by AinixIt

Our API is designed with enterprise-grade features to meet your business needs:

🔍

Advanced Search

Full-text search across names with case-insensitive matching powered by AinixIt's optimized algorithms

📄

Smart Pagination

Efficient pagination with comprehensive metadata (total, pages, hasNext, hasPrev) for seamless data navigation

🔗

Rich Relations

Populate related documents (regions, countries, states) on demand with optimized query performance

🎯

Powerful Filtering

Filter by ISO codes, IDs, country codes, and more with lightning-fast response times

📊

Flexible Sorting

Sort by any field in ascending or descending order with MongoDB-optimized indexes

📚

Interactive Docs

Comprehensive Swagger documentation with try-it-out functionality for seamless integration

⚡

High Performance

Optimized MongoDB queries with indexed fields for sub-millisecond response times

🔒

Secure & Reliable

Enterprise-grade security with 99.9% uptime guarantee and robust error handling

🌐

Global Coverage

Comprehensive geographic data covering 250+ countries, 5,000+ states, and 150,000+ cities

✨ About AinixIt

🎯 Our Mission

AinixIt delivers cutting-edge API solutions and innovative technology services to empower businesses worldwide. We specialize in creating robust, scalable, and developer-friendly APIs that drive digital transformation.

💡 Why Choose Us

  • ✓ Enterprise-grade API infrastructure
  • ✓ 99.9% uptime guarantee
  • ✓ Comprehensive documentation
  • ✓ 24/7 technical support
  • ✓ Scalable and secure solutions

🚀 Get Started with AinixIt

📝 For Developers

Start integrating our API in minutes. Comprehensive documentation, code examples, and interactive Swagger UI make integration seamless.

View Documentation →

💼 For Businesses

Leverage our enterprise-grade geographic data API to power your applications. Scalable, reliable, and backed by AinixIt's expertise.

Contact Sales →

🔧 Support

Need help? Our technical team is available 24/7 to assist with integration, troubleshooting, and custom solutions.

Get Support →