IndiaStack API provides structured, developer-ready access to essential Indian data across three categories: pincode lookup, IFSC bank code validation, and public holiday data.
Pincode Lookup — Query any of 19,097 Indian pincodes and get back the city, district, state, and timezone in clean JSON. Perfect for auto-filling address forms, validating delivery zones, or enriching user data in any Indian-market application.
IFSC Bank Code Lookup — Validate and decode any of 164,836 IFSC codes across all Indian banks and branches. Returns bank name, branch, city, state, full address, and payment method support flags including IMPS, RTGS, NEFT, UPI, and SWIFT. Essential for any fintech, payments, or invoicing application operating in India.
Public Holiday Data — Get the full list of Indian public holidays for a given year, filterable by compulsory or restricted holiday type. Returns date, day of week, holiday name, and type. Useful for scheduling tools, payroll systems, HR platforms, delivery ETAs, and any application that needs to account for Indian working calendars.
All endpoints return consistent, clean JSON with proper error messages and HTTP status codes. Authentication is handled via an API key passed in the request header. The API is hosted on Railway with low-latency responses under 50ms.
Built for developers building products for the Indian market who want reliable, structured data without scraping government websites or maintaining their own datasets.
Returns city, district, state and timezone for any valid 6-digit Indian pincode. Covers 19,097 pincodes across all Indian states and union territories.
{"success":true,"data":{"pincode":"411001","office":"Pune City","city":"Pune City","district":"Pune","state":"Maharashtra","timezone":"Asia/Kolkata"}}
curl --location --request GET 'https://zylalabs.com/api/12450/india-stack+api/23566/pincode+lookup&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Returns bank name, branch, city, state, address and payment method support (IMPS, RTGS, NEFT, UPI) for any valid Indian IFSC code. Covers 164,836 bank branches.
{"success":true,"data":{"ifsc":"HDFC0001234","bank":"HDFC Bank","branch":"PARK STREET","city":"JAIPUR","district":"JAIPUR","state":"RAJASTHAN","address":"3 PARK STREET M I ROAD M I ROAD","contact":"+919875003333","imps":true,"rtgs":true,"neft":true,"upi":true,"micr":"302240007","swift":"HDFCINBB"}}
curl --location --request GET 'https://zylalabs.com/api/12450/india-stack+api/23567/ifsc+bank+code+lookup&code=Required' --header 'Authorization: Bearer YOUR_API_KEY'
Returns all Indian public holidays for a given year, filterable by compulsory or restricted type. Includes date, day, holiday name and type.
{"success":true,"year":"2026","count":49,"compulsory_count":17,"restricted_count":32,"holidays":[{"date":"2026-01-01","day":"Thursday","name":"New Year's Day","type":"restricted"},{"date":"2026-01-03","day":"Saturday","name":"Hazarat Ali's Birthday","type":"restricted"},{"date":"2026-01-14","day":"Wednesday","name":"Makar Sankranti / Magha Bihu / Pongal","type":"restricted"},{"date":"2026-01-23","day":"Friday","name":"Sri Panchami, Basant Panchami","type":"restricted"},{"date":"2026-01-26","day":"Monday","name":"Republic Day","type":"compulsory"},{"date":"2026-02-01","day":"Sunday","name":"Guru Ravi Das's Birthday","type":"restricted"},{"date":"2026-02-12","day":"Thursday","name":"Birthday of Swami Dayananda Saraswati","type":"restricted"},{"date":"2026-02-15","day":"Sunday","name":"Maha Shivaratri","type":"restricted"},{"date":"2026-02-19","day":"Thursday","name":"Shiva Ji Jayanti","type":"restricted"},{"date":"2026-03-03","day":"Tuesday","name":"Holika Dahan / Dolyatra","type":"restricted"},{"date":"2026-03-04","day":"Wednesday","name":"Holi","type":"compulsory"},{"date":"2026-03-19","day":"Thursday","name":"Chaitra Sukaldi / Gudi Padava / Ugadi / Cheti Chand","type":"restricted"},{"date":"2026-03-20","day":"Friday","name":"Jamat-Ul-Vida","type":"restricted"},{"date":"2026-03-21","day":"Saturday","name":"Id-ul-Fitr","type":"compulsory"},{"date":"2026-03-26","day":"Thursday","name":"Ram Navami","type":"compulsory"},{"date":"2026-03-31","day":"Tuesday","name":"Mahavir Jayanti","type":"compulsory"},{"date":"2026-04-03","day":"Friday","name":"Good Friday","type":"compulsory"},{"date":"2026-04-05","day":"Sunday","name":"Easter Sunday","type":"restricted"},{"date":"2026-04-14","day":"Tuesday","name":"Vaisakhi / Vishu / Meshadi (Tamil New Year's Day)","type":"restricted"},{"date":"2026-04-15","day":"Wednesday","name":"Vaisakhadi (Bengal) / Bahag Bihu (Assam)","type":"restricted"},{"date":"2026-05-01","day":"Friday","name":"Budha Purnima","type":"compulsory"},{"date":"2026-05-09","day":"Saturday","name":"Birthday of Guru Rabindranath Tagore","type":"restricted"},{"date":"2026-05-27","day":"Wednesday","name":"Id-ul-Zuha (Bakrid)","type":"compulsory"},{"date":"2026-06-26","day":"Friday","name":"Muharram","type":"compulsory"},{"date":"2026-07-16","day":"Thursday","name":"Rath Yatra","type":"restricted"},{"date":"2026-08-15","day":"Saturday","name":"Independence Day","type":"compulsory"},{"date":"2026-08-15","day":"Saturday","name":"Parsi New Year's Day / Nauraj","type":"restricted"},{"date":"2026-08-26","day":"Wednesday","name":"Milad-un-Nabi (Birthday of Prophet Mohammad)","type":"compulsory"},{"date":"2026-08-26","day":"Wednesday","name":"Onam or Thiru Onam Day","type":"restricted"},{"date":"2026-08-28","day":"Friday","name":"Raksha Bandhan","type":"restricted"},{"date":"2026-09-04","day":"Friday","name":"Janmashtami (Vaishnava)","type":"compulsory"},{"date":"2026-09-14","day":"Monday","name":"Ganesh Chaturthi / Vinayaka Chaturthi","type":"restricted"},{"date":"2026-10-02","day":"Friday","name":"Mahatma Gandhi's Birthday","type":"compulsory"},{"date":"2026-10-18","day":"Sunday","name":"Dussehra (Saptami)","type":"restricted"},{"date":"2026-10-19","day":"Monday","name":"Dussehra (Mahashtami)","type":"restricted"},{"date":"2026-10-20","day":"Tuesday","name":"Dussehra","type":"compulsory"},{"date":"2026-10-20","day":"Tuesday","name":"Dussehra (Mahanavmi)","type":"restricted"},{"date":"2026-10-26","day":"Monday","name":"Maharishi Valmiki's Birthday","type":"restricted"},{"date":"2026-10-29","day":"Thursday","name":"Karaka Chaturthi (Karwa Chouth)","type":"restricted"},{"date":"2026-11-08","day":"Sunday","name":"Diwali (Deepavali)","type":"compulsory"},{"date":"2026-11-08","day":"Sunday","name":"Naraka Chaturdasi","type":"restricted"},{"date":"2026-11-09","day":"Monday","name":"Goverdhan Puja","type":"restricted"},{"date":"2026-11-11","day":"Wednesday","name":"Bhai Duj","type":"restricted"},{"date":"2026-11-15","day":"Sunday","name":"Pratihar Shashthi or Surya Shashthi (Chhat Puja)","type":"restricted"},{"date":"2026-11-24","day":"Tuesday","name":"Guru Nanak's Birthday","type":"compulsory"},{"date":"2026-11-24","day":"Tuesday","name":"Guru Teg Bahadur's Martyrdom Day","type":"restricted"},{"date":"2026-12-23","day":"Wednesday","name":"Hazarat Ali's Birthday","type":"restricted"},{"date":"2026-12-24","day":"Thursday","name":"Christmas Eve","type":"restricted"},{"date":"2026-12-25","day":"Friday","name":"Christmas Day","type":"compulsory"}]}
curl --location --request GET 'https://zylalabs.com/api/12450/india-stack+api/23568/indian+public+holidays&year=Required' --header 'Authorization: Bearer YOUR_API_KEY'
| Header | Description |
|---|---|
Authorization
|
[Required] Should be Bearer access_key. See "Your API Access Key" above when you are subscribed. |
No long-term commitment. Upgrade, downgrade, or cancel anytime. Free Trial includes up to 50 requests.
The API returns structured JSON data. The Pincode endpoint provides city, district, state, and timezone. The IFSC endpoint returns bank name, branch, city, state, address, and payment method support. The Public Holidays endpoint lists holiday dates, names, and types.
Key fields include "pincode," "city," "district," "state," and "timezone" for the Pincode endpoint; "ifsc," "bank," "branch," "address," and payment flags for the IFSC endpoint; and "date," "name," and "type" for the Public Holidays endpoint.
The Pincode endpoint requires a valid 6-digit pincode. The IFSC endpoint requires a valid IFSC code. The Public Holidays endpoint accepts a year parameter to filter holidays for that specific year.
Each response includes a "success" boolean, followed by a "data" object containing relevant details. For example, the IFSC response includes bank details in a nested structure, while the Public Holidays response lists holidays in an array format.
The data is sourced from official government databases and financial institutions in India, ensuring high accuracy and reliability. Regular updates and validations are performed to maintain data integrity.
Common use cases include automating address validation in e-commerce, integrating banking information in fintech applications, and managing payroll systems that require holiday data for scheduling.
Users can parse the JSON response to extract relevant fields for their applications. For instance, they can use the city and state information from the Pincode endpoint to auto-fill address forms or validate bank details for transactions using the IFSC data.
If a request returns an empty result, check the validity of the input parameters. The API provides error messages and status codes to indicate issues, allowing users to troubleshoot and refine their requests accordingly.
The Pincode endpoint provides information such as the city, district, state, and timezone associated with any valid 6-digit Indian pincode. This data is useful for applications requiring address validation or geographic information.
Users can customize requests by providing a specific IFSC code to retrieve detailed information about the corresponding bank, branch, and payment methods supported. This allows for precise validation of banking details.
The Public Holidays endpoint covers all Indian states and union territories, providing a comprehensive list of holidays applicable across the country for any specified year.
In the IFSC response, fields such as "imps," "rtgs," "neft," and "upi" indicate the payment methods supported by the bank branch. "micr" refers to the Magnetic Ink Character Recognition code used for processing cheques.
Data accuracy is maintained through regular updates sourced from official government databases and financial institutions. Continuous validation processes ensure that the information remains reliable and up-to-date.
The Public Holidays response typically includes a "count" of holidays, with separate counts for compulsory and restricted holidays. Each holiday entry contains fields for "date," "day," "name," and "type," allowing for easy filtering and analysis.
Users can leverage the timezone data to adjust scheduling or delivery times based on the local time of the pincode area, enhancing user experience in applications like e-commerce or logistics.
Applications such as e-commerce platforms for address validation, fintech solutions for banking information, and HR systems for managing holiday schedules can all benefit from the structured data provided by the India-Stack API.
Zyla API Hub is like a big store for APIs, where you can find thousands of them all in one place. We also offer dedicated support and real-time monitoring of all APIs. Once you sign up, you can pick and choose which APIs you want to use. Just remember, each API needs its own subscription. But if you subscribe to multiple ones, you'll use the same key for all of them, making things easier for you.
Service Level:
100%
Response Time:
3,422ms
Service Level:
100%
Response Time:
338ms
Service Level:
100%
Response Time:
1,659ms
Service Level:
100%
Response Time:
5,334ms
Service Level:
100%
Response Time:
3,050ms
Service Level:
100%
Response Time:
23ms
Service Level:
100%
Response Time:
16ms
Service Level:
100%
Response Time:
15ms
Service Level:
100%
Response Time:
6,408ms
Service Level:
100%
Response Time:
10,047ms