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
| Request | Returns |
|---|---|
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= (®ion=) | 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.