POST/api/astro/muhurat/1 crédito

Muhurats de cerimônias

Encontra os horários, dentro de um intervalo de datas, em que um de cinco ritos de passagem hindus pode ser realizado. Cada rito tem sua própria lista de nakshatras permitidos, além de condições adicionais sobre tithi, dia da semana ou signo do Sol, e cada instante amostrado no intervalo é testado contra os cinco. Os cinco são mundan (a primeira tonsura de uma criança), vidyarambha (o início da educação formal), upanayana (o cordão sagrado), graha_pravesha (a entrada em uma casa nova) e deva_pratishtha (a instalação de uma divindade). O mundan também verifica a idade da criança com base em birth_date e só permite os anos 1, 3, 5, 7, 10 e 11. Passe start_date, end_date, birth_date, interval_hours e o local. A varredura percorre o intervalo em passos de interval_hours e informa cada passo que se qualifica como uma janela própria de duas horas; assim, um dia que se qualifica produz várias linhas sobrepostas que, em geral, você vai querer mesclar. Um intervalo menor dá limites mais precisos e muito mais linhas. Limite o intervalo de datas a poucas semanas — custa um crédito de qualquer forma, mas cada passo recalcula um panchanga completo. A única chave é find_muhurats_in_range.

https://api.occultapi.com/api/astro/muhurat/

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos da requisição

Campo	Tipo	Obrigatório	Observações
birth_date	string (date-time)	obrigatório
date_time	string (date-time)	obrigatório	O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes.
end_date	string (date-time)	obrigatório
interval_hours	integer	obrigatório
keys	array	obrigatório	Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas.
latitude	number (double)	obrigatório	Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. min -90 · max 90
longitude	number (double)	obrigatório	Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. min -180 · max 180
start_date	string (date-time)	obrigatório
timezone	number (double)	obrigatório	Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30). Equivale a timezone_as_float, nome que outros endpoints usam para o mesmo valor. min -12 · max 14

Chaves disponíveis (1)

Liste em keys só os cálculos que você quer. Uma chave desconhecida faz a requisição inteira ser rejeitada. O custo é 1 crédito, não importa quantas chaves você peça — então agrupe tudo numa chamada só.

Chave	Campos extras exigidos	Descrição
find_muhurats_in_range	start_date, end_date, birth_date, interval_hours	Varre de start_date a end_date em passos de interval_hours e informa cada passo em que uma das cinco cerimônias é permitida. Retorna uma lista de {muhurat, start_time, end_time, nakshatra, tithi}, em que muhurat é um de mundan, vidyarambha, upanayana, graha_pravesha ou deva_pratishtha. end_time é sempre start_time mais duas horas, e passos consecutivos que se qualificam saem como entradas separadas e sobrepostas, sem mesclagem; por isso, um dia que se qualifica gera várias linhas.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/muhurat/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["find_muhurats_in_range"],"date_time":"2025-03-27T13:50:05.104Z","latitude":26.9124,"longitude":75.7873,"timezone":5.5,"start_date":"2025-02-27T13:50:05.104Z","end_date":"2025-03-27T13:50:05.104Z","birth_date":"2025-03-27T13:50:05.104Z","interval_hours":2}'

Resposta

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"find_muhurats_in_range\": [{\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 01:20:05.104000+05:30\", \"end_time\": \"2025-02-28 03:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 03:20:05.104000+05:30\", \"end_time\": \"2025-02-28 05:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 05:20:05.104000+05:30\", \"end_time\": \"2025-02-28 07:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 07:20:05.104000+05:30\", \"end_time\": \"2025-02-28 09:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-02-28 09:20:05.104000+05:30\", \"end_time\": \"2025-02-28 11:20:05.104000+05:30\", \"nakshatra\": \"Satabhishak\", \"tithi\": 1}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-02 01:20:05.104000+05:30\", \"end_time\": \"2025-03-02 03:20:05.104000+05:30\", \"nakshatra\": \"Uttaraabhaadra\", \"tithi\": 3}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-02 03:20:05.104000+05:30\", \"end_time\": \"2025-03-02 05:20:05.104000+05:30\", \"nakshatra\": \"Uttaraabhaadra\", \"tithi\": 3}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 13:20:05.104000+05:30\", \"end_time\": \"2025-03-03 15:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 13:20:05.104000+05:30\", \"end_time\": \"2025-03-03 15:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 15:20:05.104000+05:30\", \"end_time\": \"2025-03-03 17:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 15:20:05.104000+05:30\", \"end_time\": \"2025-03-03 17:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 17:20:05.104000+05:30\", \"end_time\": \"2025-03-03 19:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 17:20:05.104000+05:30\", \"end_time\": \"2025-03-03 19:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 19:20:05.104000+05:30\", \"end_time\": \"2025-03-03 21:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 19:20:05.104000+05:30\", \"end_time\": \"2025-03-03 21:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 21:20:05.104000+05:30\", \"end_time\": \"2025-03-03 23:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 21:20:05.104000+05:30\", \"end_time\": \"2025-03-03 23:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"vidyarambha\", \"start_time\": \"2025-03-03 23:20:05.104000+05:30\", \"end_time\": \"2025-03-04 01:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-03 23:20:05.104000+05:30\", \"end_time\": \"2025-03-04 01:20:05.104000+05:30\", \"nakshatra\": \"Ashwini\", \"tithi\": 5}, {\"muhurat\": \"graha_pravesha\", \"start_time\": \"2025-03-05 21:20:05.104000+05:30\", \"end_time\": \"2025-03-05 23:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-05 21:20:05.104000+05:30\", \"end_time\": \"2025-03-05 23:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"graha_pravesha\", \"start_time\": \"2025-03-05 23:20:05.104000+05:30\", \"end_time\": \"2025-03-06 01:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"deva_pratishtha\", \"start_time\": \"2025-03-05 23:20:05.104000+05:30\", \"end_time\": \"2025-03-06 01:20:05.104000+05:30\", \"nakshatra\": \"Rohini\", \"tithi\": 7}, {\"muhurat\": \"graha_pravesha\", \"start_time\": \"2025-03-06 01:20:05.104000+05:30\", \"end_time\": \"2025-03-06 03:20:05.104000+05:30\", \"nakshatra\": "
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data, sob cada chave que você pediu.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.