> ## Documentation Index
> Fetch the complete documentation index at: https://docs.countrystatecity.in/llms.txt
> Use this file to discover all available pages before exploring further.

# SDKs & Packages

> Official client packages and community libraries for the Country State City API

## 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.

<CardGroup cols={2}>
  <Card title="npm Packages" icon="npm" href="/api/sdks/npm">
    Five packages for Node.js and browser environments — countries, timezones, currencies, and translations.
  </Card>

  <Card title="Python Packages" icon="python" href="/api/sdks/python">
    Type-safe Python packages built with Pydantic, with lazy loading and zero external dependencies.
  </Card>
</CardGroup>

***

## Coming Soon

We're currently developing official SDKs for the following languages and platforms:

<CardGroup cols={2}>
  <Card title="JavaScript/TypeScript" icon="js" color="#f7df1e">
    Node.js and browser-compatible SDK with full TypeScript support
  </Card>

  <Card title="Python" icon="python" color="#3776ab">
    Pythonic client library with async support
  </Card>

  <Card title="PHP" icon="php" color="#777bb4">
    Modern PHP SDK with PSR compliance
  </Card>

  <Card title="Ruby" icon="gem" color="#cc342d">
    Ruby gem for seamless Rails integration
  </Card>

  <Card title="Go" icon="golang" color="#00add8">
    Idiomatic Go client with context support
  </Card>

  <Card title="Java" icon="java" color="#007396">
    Java SDK compatible with Java 8+
  </Card>

  <Card title=".NET" icon="microsoft" color="#512bd4">
    C# SDK for .NET Core and .NET Framework
  </Card>

  <Card title="Swift" icon="apple" color="#fa7343">
    Native iOS/macOS SDK
  </Card>
</CardGroup>

## Get Notified

Want to be notified when SDKs are available? [Contact our support team](mailto:api@countrystatecity.in) to join the early access list.

## In the Meantime

While we work on official SDKs, you can integrate with our API using:

<Steps>
  <Step title="Direct HTTP Requests">
    Use your favorite HTTP client library to make requests directly to our API endpoints. Check our [API Reference](/api/introduction) for detailed endpoint documentation.
  </Step>

  <Step title="OpenAPI Generator">
    Generate a client library in your preferred language using our [OpenAPI specification](https://github.com/OpenAPITools/openapi-generator).
  </Step>

  <Step title="Community Libraries">
    Check our [GitHub](https://github.com) for community-contributed libraries and examples.
  </Step>
</Steps>

## Request a Language

Don't see your preferred language listed? Let us know! We prioritize SDK development based on community feedback.

<Card title="Request an SDK" icon="message" href="mailto:api@countrystatecity.in?subject=SDK%20Request">
  Tell us which language or platform you'd like to see supported
</Card>