Lookup API

A free JSON API: India PIN code to post offices, district and state; an Indian place to its district; public holidays for the US, UK, Australia and Canada. No key, open CORS, 60 requests a minute per IP. Every response lists its sources, licences and an attribution line.

Examples: PIN 110001 · PIN 600043 · Adoni · next US holiday · GB 25 Dec 2027 · NSW 2027

Endpoints

RequestReturns
GET /v1/pin/{pin}Post offices with taluk, the district for each (current district where it can be matched safely, else India Post's label), the state
GET /v1/place?name=&state=Matching places with district, state, basis and a link to the place page
GET /v1/holidays?country=&date= or &year= (&region=)Holidays for US, GB, AU or CA; regions such as NSW, Scotland or ON; 2026 to 2028, not every region has every year
GET /v1/holidays/next?country=&from=The next holiday day on or after a date
curl https://api.at01.io/v1/pin/110001
curl "https://api.at01.io/v1/place?name=Adoni&state=Andhra%20Pradesh"
curl "https://api.at01.io/v1/holidays/next?country=US"

OpenAPI: /openapi.json · llms.txt · Embeddable widgets (PIN lookup, next holiday, UK take-home pay)

Using the data

India: post offices from India Post as published in the GeoNames postal codes (CC BY 4.0); districts from the Local Government Directory (GODL), matched by Census 2011 district code only where that is safe. Holidays: US OPM, GOV.UK (Open Government Licence v3.0) and the Australian and Canadian government pages named in each row. Please keep the attribution line when you show the data. The lists are snapshots (2026-11-21): post offices and holiday dates change, so check the source for anything that matters.

Limits and logging

60 requests a minute per IP; over that you get HTTP 429 with a Retry-After header. Our server logs record each request's IP address and browser string, for bot verification and visit counts. No cookies. We also keep the query you send (a PIN, a place or a country and date) and the calling site's host, to count how the API is used. Requests over the limit are logged at most once a minute per IP. No key or sign-up exists.