API pública · v1

Informação aberta.
Mais caminhos para o encontro.

Queremos que encontrar uma missa seja simples, inclusive quando a busca começa em outro aplicativo ou em um assistente de IA. Nossa API compartilha informações sobre igrejas e horários para ajudar mais pessoas a chegar à comunidade.

Sem loginSomente leituraRespostas em JSON

Comece por aqui

Uma consulta simples.

Busque igrejas por cidade e use o link de cada ficha para que a pessoa possa conferir as informações e planejar sua visita.

Exemplo com curl

curl "https://www.horadamissa.online/api/v1/igrejas?cidade=Campinas"

Ver a resposta em JSON

O que você pode consultar

GET /api/v1/igrejas: Encontre igrejas por cidade (nome completo, sem diferenciar maiúsculas) ou nome (um trecho literal). Informe ao menos um desses filtros, e junte uf quando o município existir em mais de um estado — há um Guaraci em São Paulo e outro no Paraná.
GET /api/v1/igrejas/[slug]: Consulte uma igreja usando o slug retornado na busca.
GET /api/v1/missas: Busque por cidade e data no formato AAAA-MM-DD. Use apos=18:00, por exemplo, para incluir missas a partir das 18h, inclusive, e uf para desempatar municípios homónimos.

O campo uf acompanha cada igreja na resposta: sem ele, duas cidades com o mesmo nome chegam como uma. Fica null nas fichas em que o estado ainda não foi apurado — nenhuma UF é melhor do que a errada.

Nas listas, limite aceita até 50 resultados (padrão: 20) e offset indica quantos pular (padrão: 0, máximo: 10.000). Os resultados ficam em data; use meta.next_offset como próximo offset enquanto houver uma próxima página.

Erros HTTP: 400 para parâmetros inválidos, 404 para igreja não encontrada e 503 quando a consulta está indisponível. Veja o contrato completo na especificação OpenAPI.