Official Packages
The Country State City ecosystem provides live REST API clients for TypeScript and Python, plus offline data packages for JavaScript/TypeScript and Python. Use a live client when you need managed, current data, server-side search, or plan-aware errors. Use an offline package when your application must run without an API key or network access.npm Packages
Six packages for Node.js and browser environments, including the API-backed CLI.
Python Packages
Live sync and async API client, plus type-safe offline data packages.
TypeScript SDK
Live REST API client for Node.js and browser — search, usage tracking, and always-current data over HTTP.
Python API SDK
Official typed REST API client with synchronous and asynchronous interfaces.
Coming Soon
We’re currently developing official SDKs for the following languages and platforms: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 another language SDK is available? Contact our support team to join the early access list.In the Meantime
For languages without an official SDK, you can integrate with our API using:1
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.
2
OpenAPI Generator
Generate a client library in your preferred language using our OpenAPI specification.
3
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