curl -X GET 'https://api.countrystatecity.in/v1/search/autocomplete?q=Mumbay&type=city&country=IN' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/search/autocomplete?q=Maharashtra&type=state&country=IN' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/search/autocomplete?q=Pune&type=city&country=IN&state=MH&limit=5' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

const params = new URLSearchParams({ q: 'Mumbay', type: 'city', country: 'IN' });
const response = await fetch(
  `https://api.countrystatecity.in/v1/search/autocomplete?${params}`,
  { headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } }
);

const results = await response.json();
results.forEach((r) => console.log(`${r.label} (${r.match_score})`));

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/search/autocomplete',
  params={'q': 'Mumbay', 'type': 'city', 'country': 'IN'},
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

for result in response.json():
    print(f"{result['label']} -> {result['match_score']}")

[
  {
    "id": 132332,
    "name": "Mumbai",
    "state_id": 4008,
    "state_code": "MH",
    "country_id": 101,
    "country_code": "IN",
    "latitude": "19.07283000",
    "longitude": "72.88261000",
    "timezone": "Asia/Kolkata",
    "native": "मुंबई",
    "type": "city",
    "label": "Mumbai, Maharashtra, India",
    "match_score": 0.75,
    "matched_field": "name"
  }
]

[
  {
    "id": 4008,
    "name": "Maharashtra",
    "iso2": "MH",
    "country_id": 101,
    "country_code": "IN",
    "latitude": "19.75147980",
    "longitude": "75.71388840",
    "timezone": "Asia/Kolkata",
    "type": "state",
    "label": "Maharashtra, India",
    "match_score": 1,
    "matched_field": "name"
  }
]

{
  "status": "error",
  "message": "Invalid query parameters: q: Search query must be at least 2 characters"
}

{
  "status": "error",
  "message": "Invalid query parameters: state: country is required when filtering by state"
}

{
  "status": "error",
  "message": "Invalid query parameters: state: state is only a valid filter when type=city"
}

{
  "status": "error",
  "message": "This feature is not available on your current plan.",
  "details": {
    "feature": "autocomplete",
    "currentTier": "starter",
    "requiredTier": "supporter",
    "upgradeUrl": "https://app.countrystatecity.in/pricing"
  }
}