A API IndiaStack fornece acesso estruturado e pronto para desenvolvedores a dados essenciais da Índia em três categorias: pesquisa de código postal, validação de código bancário IFSC e dados de feriados públicos
Pesquisa de Código Postal — Consulte qualquer um dos 19.097 códigos postais indianos e receba de volta a cidade, distrito, estado e fuso horário em JSON limpo. Perfeito para preencher automaticamente formulários de endereço, validar zonas de entrega ou enriquecer dados de usuários em qualquer aplicação do mercado indiano
Pesquisa de Código Bancário IFSC — Valide e decifre qualquer um dos 164.836 códigos IFSC de todos os bancos e agências indianos. Retorna nome do banco, agência, cidade, estado, endereço completo e bandeiras de suporte a métodos de pagamento, incluindo IMPS, RTGS, NEFT, UPI e SWIFT. Essencial para qualquer fintech, pagamentos ou aplicação de faturamento que opere na Índia
Dados de Feriados Públicos — Obtenha a lista completa de feriados públicos indianos para um dado ano, filtrável por tipo de feriado obrigatório ou restrito. Retorna data, dia da semana, nome do feriado e tipo. Útil para ferramentas de agendamento, sistemas de folha de pagamento, plataformas de RH, ETAs de entrega e qualquer aplicação que precise considerar os calendários de trabalho indianos
Todos os endpoints retornam JSON consistente e limpo com mensagens de erro adequadas e códigos de status HTTP. A autenticação é feita via uma chave de API passada no cabeçalho da solicitação. A API está hospedada no Railway com respostas de baixa latência abaixo de 50ms
Construída para desenvolvedores que criam produtos para o mercado indiano que desejam dados estruturados e confiáveis sem raspar sites do governo ou manter seus próprios conjuntos de dados
Retorna cidade, distrito, estado e fuso horário para qualquer código postal indiano de 6 dígitos válido. Abrange 19.097 códigos postais em todos os estados e territórios da união indianos
{"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'
Retorna o nome do banco, agência, cidade, estado, endereço e suporte ao método de pagamento (IMPS, RTGS, NEFT, UPI) para qualquer código IFSC indiano válido. Abrange 164836 agências bancárias
{"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'
Retorna todos os feriados públicos da Índia para um ano específico, filtráveis por tipo obrigatório ou restrito. Inclui data, dia, nome da festividade e tipo
{"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'
| Cabeçalho | Descrição |
|---|---|
Authorization
|
[Obrigatório] Deve ser Bearer access_key. Veja "Sua chave de acesso à API" acima quando você estiver inscrito. |
Sem compromisso de longo prazo. Faça upgrade, downgrade ou cancele a qualquer momento. O teste gratuito inclui até 50 requisições.
A API retorna dados JSON estruturados O endpoint de Pincode fornece cidade distrito estado e fuso horário O endpoint de IFSC retorna nome do banco agência cidade estado endereço e suporte a métodos de pagamento O endpoint de Feriados Públicos lista datas nomes e tipos de feriados
Os campos chave incluem "código postal", "cidade", "distrito", "estado" e "fuso horário" para o ponto final do código postal "ifsc", "banco", "agência", "endereço" e bandeiras de pagamento para o ponto final do IFSC e "data", "nome" e "tipo" para o ponto final dos feriados públicos
O endpoint Pincode requer um pincode válido de 6 dígitos O endpoint IFSC requer um código IFSC válido O endpoint Feriados Públicos aceita um parâmetro de ano para filtrar feriados para aquele ano específico
Cada resposta inclui um booleano de "sucesso" seguido de um objeto "dados" que contém detalhes relevantes Por exemplo a resposta do IFSC inclui detalhes bancários em uma estrutura aninhada enquanto a resposta de Dias Festivos lista os dias festivos em um formato de array
Os dados são obtidos de bancos de dados oficiais do governo e de instituições financeiras na Índia, garantindo alta precisão e confiabilidade Atualizações e validações regulares são realizadas para manter a integridade dos dados
Os casos de uso comuns incluem a automação da validação de endereços no comércio eletrônico a integração de informações bancárias em aplicativos fintech e a gestão de sistemas de folha de pagamento que requerem dados de férias para a programação
Os usuários podem analisar a resposta JSON para extrair campos relevantes para seus aplicativos Por exemplo, eles podem usar as informações da cidade e do estado do endpoint Pincode para preencher automaticamente formulários de endereço ou validar detalhes bancários para transações usando os dados do IFSC
Se uma solicitação retornar um resultado vazio, verifique a validade dos parâmetros de entrada A API fornece mensagens de erro e códigos de status para indicar problemas, permitindo que os usuários solucionem e ajustem suas solicitações de acordo
O endpoint de Pincode fornece informações como a cidade, distrito, estado e fuso horário associados a qualquer código postal indiano de 6 dígitos válido. Esses dados são úteis para aplicativos que requerem validação de endereço ou informações geográficas
Os usuários podem personalizar os pedidos fornecendo um código IFSC específico para recuperar informações detalhadas sobre o banco correspondente a agência e os métodos de pagamento aceitos Isso permite uma validação precisa dos detalhes bancários
O endpoint de Feriados Públicos abrange todos os estados indianos e territórios da união, fornecendo uma lista abrangente de feriados aplicáveis em todo o país para qualquer ano especificado
Na resposta do IFSC, campos como "imps", "rtgs", "neft" e "upi" indicam os métodos de pagamento admitidos pela agência bancária "micr" refere-se ao código de Reconhecimento de Caracteres de Tinta Magnética utilizado para processar cheques
A precisão dos dados é mantida por meio de atualizações regulares extraídas de bancos de dados oficiais do governo e instituições financeiras Processos de validação contínua garantem que as informações permaneçam confiáveis e atualizadas
A resposta de Feriados Públicos geralmente inclui uma "contagem" de feriados, com contagens separadas para feriados obrigatórios e restritos. Cada entrada de feriado contém campos para "data", "dia", "nome" e "tipo", permitindo fácil filtragem e análise
Os usuários podem aproveitar os dados do fuso horário para ajustar os horários ou tempos de entrega de acordo com a hora local da área do código postal melhorando a experiência do usuário em aplicações como o comércio eletrônico ou a logística
Aplicações como plataformas de comércio eletrônico para a validação de endereços soluções fintech para informações bancárias e sistemas de recursos humanos para a gestão de horários de férias podem se beneficiar dos dados estruturados fornecidos pela API do India-Stack
Nível de serviço:
100%
Tempo de resposta:
3.422ms
Nível de serviço:
100%
Tempo de resposta:
5.334ms
Nível de serviço:
100%
Tempo de resposta:
3.050ms
Nível de serviço:
100%
Tempo de resposta:
1.659ms
Nível de serviço:
100%
Tempo de resposta:
338ms
Nível de serviço:
100%
Tempo de resposta:
23ms
Nível de serviço:
100%
Tempo de resposta:
16ms
Nível de serviço:
100%
Tempo de resposta:
15ms
Nível de serviço:
100%
Tempo de resposta:
6.408ms
Nível de serviço:
100%
Tempo de resposta:
15ms