curl 'https://api.countrystatecity.in/v1/countries/IN/postcodes?limit=20' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl 'https://api.countrystatecity.in/v1/countries/IN/postcodes?q=110001&type=full' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

import requests

def search_postcodes(country_code, **params):
    response = requests.get(
        f'https://api.countrystatecity.in/v1/countries/{country_code}/postcodes',
        params=params,
        headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
    )
    response.raise_for_status()
    return response.json()

page = search_postcodes('IN', q='110001', type='full')

const searchPostcodes = async (countryCode, params = {}) => {
  const url = new URL(`https://api.countrystatecity.in/v1/countries/${countryCode}/postcodes`);
  for (const [key, value] of Object.entries(params)) url.searchParams.set(key, value);

  const response = await fetch(url, { headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } });
  if (!response.ok) throw new Error(await response.text());
  return response.json();
};

const page = await searchPostcodes('IN', { q: '110001', type: 'full' });

async function* allPostcodes(countryCode, params = {}) {
  let cursor;
  do {
    const url = new URL(`https://api.countrystatecity.in/v1/countries/${countryCode}/postcodes`);
    for (const [key, value] of Object.entries(params)) url.searchParams.set(key, value);
    if (cursor) url.searchParams.set('cursor', cursor);

    const response = await fetch(url, { headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } });
    if (!response.ok) throw new Error(await response.text());
    const page = await response.json();

    yield* page.data;
    cursor = page.pagination.has_more ? page.pagination.next_cursor : null;
  } while (cursor);
}

for await (const postcode of allPostcodes('IN', { state_code: 'DL' })) {
  console.log(postcode.code, postcode.locality_name);
}