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
O Zyla API Hub é como uma grande loja de APIs, onde você pode encontrar milhares delas em um só lugar. Também oferecemos suporte dedicado e monitoramento em tempo real de todas as APIs. Após se cadastrar, você pode escolher quais APIs deseja usar. Lembre-se apenas de que cada API precisa de sua própria assinatura. Mas se você se inscrever em várias, usará a mesma chave para todas elas, facilitando as coisas para você.
Os preços são listados em USD (Dólar Americano), EUR (Euro), CAD (Dólar Canadense), AUD (Dólar Australiano) e GBP (Libra Esterlina). Aceitamos todos os principais cartões de débito e crédito. Nosso sistema de pagamento usa a mais recente tecnologia de segurança e é operado pela Stripe, uma das empresas de pagamento mais confiáveis do mundo. Se tiver problemas para pagar com cartão, entre em contato conosco em [email protected]
Além disso, se você já tiver uma assinatura ativa em qualquer uma dessas moedas (USD, EUR, CAD, AUD, GBP), essa moeda será mantida para assinaturas subsequentes. Você pode alterar a moeda a qualquer momento, desde que não tenha assinaturas ativas.
A moeda local exibida na página de preços é baseada no país do seu endereço IP e é fornecida apenas como referência. Os preços reais são em USD (Dólar Americano). Ao efetuar o pagamento, a cobrança aparecerá no extrato do seu cartão em USD, mesmo que você veja o valor equivalente em sua moeda local em nosso site. Isso significa que você não pode pagar diretamente com sua moeda local.
Ocasionalmente, o banco pode recusar a cobrança devido às configurações de proteção contra fraude. Sugerimos contatar seu banco inicialmente para verificar se estão bloqueando nossas cobranças. Você também pode acessar o Portal de Cobrança e alterar o cartão associado para realizar o pagamento. Se isso não funcionar e precisar de mais ajuda, entre em contato com nossa equipe em [email protected]
Os preços são determinados por uma assinatura recorrente mensal ou anual, dependendo do plano escolhido.
As chamadas de API são descontadas do seu plano com base nas requisições bem-sucedidas. Cada plano possui um número específico de chamadas por mês. Apenas chamadas bem-sucedidas, indicadas por uma resposta com Status 200, serão contabilizadas, garantindo que falhas não afetem sua cota mensal.
O Zyla API Hub funciona com um sistema de assinatura mensal recorrente. Seu ciclo de cobrança começa no dia em que você compra um dos planos pagos e será renovado no mesmo dia do mês seguinte. Portanto, cancele sua assinatura com antecedência se quiser evitar cobranças futuras.
Para fazer upgrade do seu plano atual, acesse a página de preços da API e selecione o novo plano desejado. O upgrade é instantâneo, permitindo aproveitar imediatamente os recursos do novo plano. Observe que as chamadas restantes do plano anterior não serão transferidas; você será cobrado pelo valor integral do novo plano.
Para verificar quantas chamadas de API restam para o mês atual, consulte o campo 'X-Zyla-API-Calls-Monthly-Remaining' no cabeçalho da resposta. Por exemplo, se seu plano permite 1.000 requisições por mês e você usou 100, este campo no cabeçalho da resposta indicará 900 chamadas restantes.
Para ver o número máximo de requisições de API que seu plano permite, verifique o cabeçalho de resposta 'X-Zyla-RateLimit-Limit'. Por exemplo, se seu plano inclui 1.000 requisições por mês, este cabeçalho exibirá 1.000.
O cabeçalho 'X-Zyla-RateLimit-Reset' mostra o número de segundos até seu limite de taxa ser redefinido. Isso informa quando sua contagem de requisições começará do zero. Por exemplo, se exibir 3.600, significa que restam 3.600 segundos até o limite ser redefinido.
Sim, você pode cancelar seu plano a qualquer momento acessando sua conta e selecionando a opção de cancelamento na página de Cobrança. Observe que upgrades, downgrades e cancelamentos têm efeito imediato. Além disso, após o cancelamento, você não terá mais acesso ao serviço, mesmo que ainda tenha chamadas restantes na sua cota.
Você pode nos contatar via chat para receber assistência imediata. Estamos online de 8h às 17h (EST). Se nos contatar após esse horário, retornaremos o mais rápido possível. Além disso, você pode enviar um e-mail para [email protected]
Para oferecer a oportunidade de experimentar nossas APIs sem compromisso, oferecemos um teste gratuito de 7 dias que permite realizar até 50 chamadas de API sem custo. Esse teste pode ser usado apenas uma vez; recomendamos aplicá-lo à API que mais interessa. Embora a maioria das APIs ofereça teste gratuito, algumas podem não oferecer. O teste termina após 7 dias ou quando você atingir 50 requisições, o que ocorrer primeiro. Se atingir o limite, será necessário "Iniciar seu plano pago" para continuar. Você encontra esse botão no perfil em Assinatura -> Escolha a API -> aba Preços. Se não cancelar até o 7º dia, sua assinatura será cobrada automaticamente, liberando todas as chamadas do plano.
Após 7 dias, será cobrado o valor total do plano ao qual você estava inscrito durante o teste. Portanto, é importante cancelar antes do término do período. Solicitações de reembolso por esquecimento de cancelamento não são aceitas.
Ao assinar um teste gratuito de API, você pode fazer até 50 chamadas. Se desejar fazer chamadas adicionais além desse limite, a API solicitará que você "Inicie seu plano pago". Você encontra o botão no perfil em Assinatura -> Escolha a API -> aba Preços.
As Ordens de Pagamento são processadas entre os dias 20 e 30 de cada mês. Se você enviar sua solicitação antes do dia 20, seu pagamento será processado dentro desse período.
Nível de serviço:
100%
Tempo de resposta:
3.422ms
Nível de serviço:
100%
Tempo de resposta:
338ms
Nível de serviço:
100%
Tempo de resposta:
1.659ms
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:
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:
11.677ms
Nível de serviço:
91%
Tempo de resposta:
4ms
Nível de serviço:
100%
Tempo de resposta:
3.478ms
Nível de serviço:
100%
Tempo de resposta:
53ms
Nível de serviço:
82%
Tempo de resposta:
4ms
Nível de serviço:
100%
Tempo de resposta:
595ms
Nível de serviço:
100%
Tempo de resposta:
260ms
Nível de serviço:
100%
Tempo de resposta:
52ms
Nível de serviço:
100%
Tempo de resposta:
205ms
Nível de serviço:
100%
Tempo de resposta:
184ms
Nível de serviço:
100%
Tempo de resposta:
7.220ms