curl -X GET 'https://api.countrystatecity.in/v1/states' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/states?q=texas' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/states?include_translations=true' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/states',
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

states = response.json()
print(f'Found {len(states)} states')

const response = await fetch('https://api.countrystatecity.in/v1/states', {
  headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' }
});

const states = await response.json();
console.log(`Found ${states.length} states`);

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.countrystatecity.in/v1/states',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => array(
    'X-CSCAPI-KEY: YOUR_API_KEY'
  ),
));

$response = curl_exec($curl);
curl_close($curl);

$states = json_decode($response, true);
echo "Found " . count($states) . " states\n";
?>

package main

import (
    "encoding/json"
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    url := "https://api.countrystatecity.in/v1/states"
    
    client := &http.Client{}
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Add("X-CSCAPI-KEY", "YOUR_API_KEY")
    
    res, _ := client.Do(req)
    defer res.Body.Close()
    
    body, _ := ioutil.ReadAll(res.Body)
    
    var states []map[string]interface{}
    json.Unmarshal(body, &states)
    
    fmt.Printf("Found %d states\n", len(states))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import com.google.gson.Gson;
import com.google.gson.reflect.TypeToken;
import java.lang.reflect.Type;
import java.util.List;
import java.util.Map;

public class AllStates {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://api.countrystatecity.in/v1/states"))
            .header("X-CSCAPI-KEY", "YOUR_API_KEY")
            .build();

        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());
            
        Gson gson = new Gson();
        Type listType = new TypeToken<List<Map<String, Object>>>(){}.getType();
        List<Map<String, Object>> states = gson.fromJson(response.body(), listType);
        
        System.out.println("Found " + states.size() + " states");
    }
}

require 'net/http'
require 'json'

uri = URI("https://api.countrystatecity.in/v1/states")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = true

request = Net::HTTP::Get.new(uri)
request['X-CSCAPI-KEY'] = 'YOUR_API_KEY'

response = http.request(request)
states = JSON.parse(response.body)

puts "Found #{states.length} states"

[
  {
    "id": 4008,
    "name": "Maharashtra",
    "country_id": 101,
    "country_code": "IN",
    "iso2": "MH",
    "latitude": "19.75147980",
    "longitude": "75.71388840",
    "timezone": "Asia/Kolkata"
  }
]

[
  {
    "id": 4008,
    "name": "Maharashtra",
    "country_id": 101,
    "country_code": "IN",
    "iso2": "MH",
    "latitude": "19.75147980",
    "longitude": "75.71388840",
    "timezone": "Asia/Kolkata",
    "fips_code": "16",
    "iso3166_2": "IN-MH",
    "type": "state",
    "level": 1,
    "parent_id": null,
    "native": "महाराष्ट्र",
    "population": 112374333,
    "translations": "{\"kr\":\"마하라슈트라\",\"de\":\"Maharashtra\",\"fr\":\"Maharashtra\",\"cn\":\"马哈拉施特拉邦\"}",
    "wikiDataId": "Q1191"
  }
]

{
  "error": "Unauthorized. You shouldn't be here."
}