Official Packages
The Country State City ecosystem provides official packages for JavaScript/TypeScript and Python. These packages embed the geographical data directly, so you can query countries, states, and cities without making HTTP requests or managing an API key.npm Packages
Five packages for Node.js and browser environments — countries, timezones, currencies, and translations.
Python Packages
Type-safe Python packages built with Pydantic, with lazy loading and zero external dependencies.
Coming Soon
We’re currently developing official SDKs for the following languages and platforms:JavaScript/TypeScript
Node.js and browser-compatible SDK with full TypeScript support
Python
Pythonic client library with async support
PHP
Modern PHP SDK with PSR compliance
Ruby
Ruby gem for seamless Rails integration
Go
Idiomatic Go client with context support
Java
Java SDK compatible with Java 8+
.NET
C# SDK for .NET Core and .NET Framework
Swift
Native iOS/macOS SDK
Get Notified
Want to be notified when SDKs are available? Contact our support team to join the early access list.In the Meantime
While we work on official SDKs, you can integrate with our API using:Direct HTTP Requests
Use your favorite HTTP client library to make requests directly to our API endpoints. Check our API Reference for detailed endpoint documentation.
OpenAPI Generator
Generate a client library in your preferred language using our OpenAPI specification.
Community Libraries
Check our GitHub for community-contributed libraries and examples.
Request a Language
Don’t see your preferred language listed? Let us know! We prioritize SDK development based on community feedback.Request an SDK
Tell us which language or platform you’d like to see supported