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

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

curl -X GET 'https://api.countrystatecity.in/v1/search/fuzzy?q=Munchen&type=city&threshold=0.2&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/fuzzy?${params}`,
  { headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } }
);

const matches = await response.json();
matches.forEach((m) => console.log(`${m.name} (${m.match_score})`));

import requests

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

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

[
  {
    "id": 132649,
    "name": "Mumbai",
    "state_id": 4008,
    "state_code": "MH",
    "country_id": 101,
    "country_code": "IN",
    "latitude": "19.07283000",
    "longitude": "72.88261000",
    "timezone": "Asia/Kolkata",
    "native": "मुंबई",
    "match_score": 0.87,
    "matched_alias": null
  }
]

[
  {
    "id": 132649,
    "name": "Mumbai",
    "native": "मुंबई",
    "match_score": 1,
    "matched_alias": "मुंबई"
  }
]

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

{
  "status": "error",
  "message": "Invalid query parameters: country: country is not a valid filter when type=country"
}

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