POST/api/vrat-upavas/1 crédito

Vrat e upavas

Vrat e upavas são os dias recorrentes de jejum e de observância do mês hindu, cada um ligado a um tithi específico. Este endpoint retorna todas as ocorrências dos tipos que você pedir ao longo de um ano inteiro, lidas de uma tabela pré-calculada em vez de calculadas na requisição; assim, um ano inteiro de dezoito tipos de observância sai de uma única consulta indexada. Cada tipo é definido apenas pelos números de tithi aos quais corresponde, no esquema de 1-30 em que 1-15 são de Shukla Pratipada a Purnima, 16-29 são de Krishna Pratipada a Chaturdashi e 30 é Amavasya. Assim, `ekadashi` retorna os dois Ekadashis de cada mês, `pradosham` os dois Trayodashis, `shivarathri` o Krishna Chaturdashi de cada mês (o Masik Shivaratri mensal, não apenas o Maha Shivaratri), `sashti`, `durgashtami` e `vinayaka_chathurthi` o sexto, o oitavo e o quarto dias de Shukla, `kaalashtami` e `sankatahara_chathurthi` os seus equivalentes de Krishna, `amavasya` e `pournami` as luas novas e cheias, `sathyanarayana_puja` a lua cheia, `chandra_dharshan` e `moondraam_pirai` o primeiro e o terceiro dias da lua crescente, e `srartha_yoga`, `ashtaka`, `manvaadhi` e `yugadhi` os seus próprios pequenos conjuntos de tithis. Atenção: `mahalaya_paksha` corresponde a todos os tithis de 15 a 30, o que significa a quinzena escura inteira de cada mês lunar, e não apenas o Pitru Paksha de Bhadrapada. `year` e `keys` são obrigatórios. Passar também `latitude`, `longitude` e `timezone_as_float` acrescenta dois campos calculados em tempo real a cada evento: `moonrise`, o nascer da lua vespertino que cai dentro da janela do tithi desse evento, na sua localização, e, apenas nas linhas de `vinayaka_chathurthi`, `puja_muhurat` com `start`, `end` e `duration_minutes` para a janela de Madhyahna Ganesha Puja. Ambos são retornados como null se não puderem ser calculados, e nenhum dos dois aparece se você omitir as coordenadas. A resposta é `{data}`, indexada por cada tipo solicitado, cada um contendo uma lista cronológica de `{date, month, tithi, paksha, start_time, end_time}`, em que os horários são os instantes exatos em que o tithi começa e termina. As datas são pré-calculadas de 2006 a 2046, inclusive; um ano fora desse intervalo retorna listas vazias em vez de um erro.

https://api.occultapi.com/api/vrat-upavas/

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
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. `amavasyaashtakachandra_dharshandurgashtamiekadashikaalashtamimahalaya_pakshamanvaadhimoondraam_piraipournamipradoshamsankatahara_chathurthi` Quais observâncias retornar. Peça várias em uma única chamada - a resposta é indexada por tipo e o custo é o mesmo.
year	integer	obrigatório	Ano de nascimento como número, por exemplo 1990. Quatro dígitos. Ano com quatro dígitos. As datas são pré-calculadas de 2006 a 2046; fora desse intervalo, a resposta é vazia.
latitude	number (double)	opcional	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.
longitude	number (double)	opcional	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.
timezone_as_float	number (double)	opcional	Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/vrat-upavas/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026,"month":9,"keys":["ekadashi","amavasya","pradosham"]}'

Resposta

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"ekadashi\": [{\"date\": \"2026-01-14\", \"month\": \"Magha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-01-13T15:19:08+05:30\", \"end_time\": \"2026-01-14T17:53:57+05:30\"}, {\"date\": \"2026-01-29\", \"month\": \"Phalguna\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-01-28T16:37:06+05:30\", \"end_time\": \"2026-01-29T13:56:12+05:30\"}, {\"date\": \"2026-02-13\", \"month\": \"Phalguna\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-02-12T12:23:19+05:30\", \"end_time\": \"2026-02-13T14:27:04+05:30\"}, {\"date\": \"2026-02-27\", \"month\": \"Chaitra\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-02-27T00:34:31+05:30\", \"end_time\": \"2026-02-27T22:33:54+05:30\"}, {\"date\": \"2026-03-15\", \"month\": \"Chaitra\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-03-14T08:12:06+05:30\", \"end_time\": \"2026-03-15T09:17:39+05:30\"}, {\"date\": \"2026-03-29\", \"month\": \"Vaisakha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-03-28T08:46:49+05:30\", \"end_time\": \"2026-03-29T07:47:32+05:30\"}, {\"date\": \"2026-04-13\", \"month\": \"Vaisakha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-04-13T01:18:00+05:30\", \"end_time\": \"2026-04-14T01:09:45+05:30\"}, {\"date\": \"2026-04-27\", \"month\": \"Jyeshtha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-04-26T18:08:02+05:30\", \"end_time\": \"2026-04-27T18:17:03+05:30\"}, {\"date\": \"2026-05-13\", \"month\": \"Jyeshtha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-05-12T14:53:26+05:30\", \"end_time\": \"2026-05-13T13:30:53+05:30\"}, {\"date\": \"2026-05-26\", \"month\": \"Ashadha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-05-26T05:11:58+05:30\", \"end_time\": \"2026-05-27T06:22:50+05:30\"}, {\"date\": \"2026-05-27\", \"month\": \"Ashadha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-05-26T05:11:58+05:30\", \"end_time\": \"2026-05-27T06:22:50+05:30\"}, {\"date\": \"2026-06-11\", \"month\": \"Ashadha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-06-11T00:58:46+05:30\", \"end_time\": \"2026-06-11T22:37:13+05:30\"}, {\"date\": \"2026-06-25\", \"month\": \"Ashadha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-06-24T18:13:24+05:30\", \"end_time\": \"2026-06-25T20:10:27+05:30\"}, {\"date\": \"2026-07-25\", \"month\": \"Shravana\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-07-24T09:13:54+05:30\", \"end_time\": \"2026-07-25T11:35:24+05:30\"}, {\"date\": \"2026-08-09\", \"month\": \"Shravana\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-08-08T14:00:14+05:30\", \"end_time\": \"2026-08-09T11:05:59+05:30\"}, {\"date\": \"2026-08-23\", \"month\": \"Bhadrapada\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-08-23T02:01:28+05:30\", \"end_time\": \"2026-08-24T04:19:48+05:30\"}, {\"date\": \"2026-09-07\", \"month\": \"Bhadrapada\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-09-06T19:30:12+05:30\", \"end_time\": \"2026-09-07T17:05:07+05:30\"}, {\"date\": \"2026-09-22\", \"month\": \"Ashwin\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-09-21T20:01:57+05:30\", \"end_time\": \"2026-09-22T21:44:20+05:30\"}, {\"date\": \"2026-10-06\", \"month\": \"Ashwin\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-10-06T02:08:30+05:30\", \"end_time\": \"2026-10-07T00:35:31+05:30\"}, {\"date\": \"2026-10-22\", \"month\": \"Kartika\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-10-21T14:12:55+05:30\", \"end_time\": \"2026-10-22T14:49:06+05:30\"}, {\"date\": \"2026-11-05\", \"month\": \"Kartika\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-11-04T11:04:18+05:30\", \"end_time\": \"2026-11-05T10:36:40+05:30\"}, {\"date\": \"2026-11-21\", \"month\": \"Margashirsha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Sukla\", \"start_time\": \"2026-11-20T07:16:41+05:30\", \"end_time\": \"2026-11-21T06:32:32+05:30\"}, {\"date\": \"2026-12-04\", \"month\": \"Margashirsha\", \"tithi\": \"Ekadashi\", \"paksha\": \"Krishna\", \"start_time\": \"2026-12-03T23:04:36+05:30\", \"end_time\": \"2026-12-04T23:45:50+05:30\"}, {\"date\": \"2026-12-20\", \"month\": \"Pausha\", \"tithi\": \"Ekadashi\", \"paksha\""
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

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.