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

Numerologia

A numerologia reduz um nome e uma data de nascimento a dígitos únicos e os interpreta. Este endpoint implementa quatro sistemas, escolhidos com system, e cada um tem sua própria tabela de letras e seu próprio conjunto de chaves disponíveis. 'chaldean' (o padrão) e 'pythagorean' formam o par ocidental e compartilham dezesseis chaves — caminho de vida, expressão, desejo da alma, personalidade e as demais. Eles diferem nos valores das letras e em um comportamento importante: o pitagórico preserva os números mestres 11 e 22, enquanto o caldeu sempre reduz a um único dígito; assim, expression_number, soul_urge_number, maturity_number e life_path_number só podem vir como 11 ou 22 no sistema pitagórico. O pitagórico acrescenta três chaves próprias: pinnacle_cycles, balance_number e rational_thought. 'chinese' e 'vedic' são conjuntos separados, sem sobreposição, exceto personal_year_number, que o sistema chinês também aceita. Pedir uma chave fora do sistema escolhido gera um HTTP 400 que aponta a chave inválida. Envie date_time e name em todas as chamadas. year, month e day são a data-alvo das chaves de ano, mês e dia pessoais, e o padrão é a data de hoje; house_number e phone_number só são obrigatórios quando essas chaves são solicitadas. Junto com o resultado de cada chave, a resposta traz um objeto <key>_metadata com a entrada, a fórmula e o significado dessa chave, além de vedic_planet_associations ou, no sistema chinês, chinese_number_meanings.

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

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
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.
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. As chaves disponíveis dependem de `system`. Os sistemas caldeu e pitagórico compartilham dezesseis chaves; o pitagórico acrescenta pinnacle_cycles, balance_number e rational_thought; o chinês e o védico têm conjuntos próprios e não aceitam nenhuma outra. Pedir uma chave fora do sistema escolhido retorna um 400 que aponta a chave inválida.
name	string	obrigatório
day	integer	opcional	Dia do mês como número, de 1 a 31.
house_number	string	opcional	Número da casa ou do apartamento. Obrigatório apenas se 'house_number' estiver incluído em 'keys'.
month	integer	opcional	Mês de nascimento como número, 1-12. Janeiro é 1.
phone_number	string	opcional	Número de telefone completo. Obrigatório apenas se 'phone_number' estiver incluído em 'keys'.
system	string	opcional	O sistema numerológico a usar. Nota: há suporte aos sistemas caldeu, pitagórico, chinês e védico. `chaldeanpythagoreanchinesevedic`
year	integer	opcional	Ano de nascimento como número, por exemplo 1990. Quatro dígitos.

Chaves disponíveis (34)

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
balance_number	—	A letra inicial de cada palavra do nome, convertida, somada e depois reduzida — o recurso ao qual a pessoa recorre sob pressão. Um único inteiro de 1 a 9. Apenas no sistema pitagórico.
bhagyank	—	O número do destino védico: todos os oito dígitos da data de nascimento escrita como DDMMYYYY, somados e reduzidos. Um único inteiro de 1 a 9. Apenas no sistema védico.
birthday_number	—	Retorna o mesmo valor que psychic_number — o dia do nascimento reduzido a um único dígito, um único inteiro de 1 a 9. Observe que isso difere da convenção comum, em que o número do aniversário é o dia sem redução, de 1 a 31. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
bridge_number	—	A distância entre quem você é e o que você faz: a diferença absoluta entre o número do caminho de vida reduzido e o número de expressão reduzido. Um único inteiro de 0 a 8, em que um valor menor significa que os dois estão mais próximos. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
challenge_number	—	A diferença absoluta entre o mês de nascimento reduzido e o dia de nascimento reduzido. Um único inteiro de 0 a 8. Observe que isto retorna um único número, e não o conjunto de quatro números de desafio que alguns sistemas produzem. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
chinese_name_number	—	O nome avaliado por uma tabela de sons do pinyin, e não por uma tabela de letras ocidental, e depois reduzido. Os caracteres chineses são consultados em uma pequena tabela de sobrenomes (com um valor de reserva para os caracteres não listados) e as letras latinas usam o mapa de pinyin. Um único inteiro de 1 a 9. Apenas no sistema chinês.
compound_meaning	—	O nome clássico do número composto, de uma tabela que cobre de 10 a 52 — 'The Wheel of Fortune', 'The Star of the Magi', 'The Crown of the Magi' e assim por diante. Uma única string, ou 'No specific meaning defined' quando o total composto fica fora de 10-52, o que é comum em nomes mais longos. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
compound_number	—	O total sem redução de todas as letras do nome completo, segundo a tabela do sistema escolhido — o número que compound_meaning consulta. Um único inteiro, normalmente algo entre vinte e duzentos, dependendo do comprimento do nome. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
expression_number	—	O número do destino: todas as letras do nome completo convertidas com a tabela de letras do sistema escolhido, somadas e reduzidas. Um único inteiro — sempre de 1 a 9 no sistema caldeu, e de 1 a 9 ou os números mestres 11 ou 22 no pitagórico, que os preserva. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
five_element_balance	—	Como os dígitos da data de nascimento, o número do caminho de vida e o número do nome chinês se distribuem entre os cinco elementos. Retorna {balance, interpretation}, em que balance tem as chaves Wood, Fire, Earth, Metal e Water e cada entrada é {count, percentage, meaning, associated_numbers}. Wood fica com 3 e 4, Fire com 9, Earth com 2, 5 e 8, Metal com 6 e 7, Water com 1; os zeros não são contados em lugar nenhum. Apenas no sistema chinês.
growth_number	—	O dia de nascimento somado ao mês de nascimento e reduzido. Um único inteiro de 1 a 9. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
hidden_passion_number	—	O valor de letra que mais se repete no nome completo — o talento que o nome não para de repetir. Um único inteiro; quando vários valores empatam como mais frequentes, retorna o menor, e 0 se o nome não tiver nenhuma letra com valor na tabela. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
house_number	house_number	Os dígitos do número da casa ou do apartamento passado no campo house_number, somados e reduzidos a um único dígito. Um único inteiro de 1 a 9, ou 0 se o valor não contiver dígitos. Apenas no sistema chinês, e o campo da requisição é obrigatório sempre que esta chave for pedida.
karmic_debt_numbers	—	Os valores de letra que nunca ocorrem no nome completo — o que a maioria dos sistemas chama de lições cármicas, e não de dívidas cármicas. Retorna uma lista dos valores ausentes, tirados do intervalo de 1 a 8 no sistema caldeu (cuja tabela não tem 9) e de 1 a 9 no pitagórico. Não retorna os números de dívida clássicos 13/14/16/19. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
life_path_number	—	O dia, o mês e o ano de nascimento, cada um reduzido, somados e reduzidos novamente. Um único inteiro, preservando 11 e 22 no sistema pitagórico. Compare com personal_life_path_number e bhagyank, que, em vez disso, somam os dígitos brutos da data e podem dar um resultado diferente. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
loshu_grid_arrows	—	As quatro setas do Lo Shu: cada uma está presente quando a data de nascimento contém os três dígitos da sua linha. Retorna um objeto com as chaves arrow_of_determination (1-5-9), arrow_of_emotional_balance (2-5-8), arrow_of_practicality (1-4-7) e arrow_of_intellect (3-6-9), cada uma no formato {present, meaning}. Só a presença é informada; setas vazias não são tratadas como um resultado à parte. Apenas no sistema chinês.
lucky_numbers	—	Os números da sorte do animal do zodíaco chinês do ano de nascimento, combinados com os números 8, 6 e 9, auspiciosos em geral. Retorna uma lista ordenada de inteiros distintos, geralmente de quatro a seis. Apenas no sistema chinês.
maturity_number	—	O número de expressão somado ao número do caminho de vida e reduzido. Um único inteiro, preservando 11 e 22 no sistema pitagórico. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
moolank	—	O número psíquico védico: o dia do nascimento reduzido a um único dígito. Um único inteiro de 1 a 9. Apenas no sistema védico, e com valor idêntico ao de psychic_number.
namank	—	O número do nome védico: o nome completo pontuado na tabela de letras caldeia e reduzido. Um único inteiro de 1 a 9. Apenas no sistema védico, e sempre usa a tabela caldeia, independentemente de qualquer outra coisa.
name_number	—	Apenas o primeiro nome — tudo até o primeiro espaço —, convertido com a tabela de letras escolhida, somado e reduzido. Um único inteiro de 1 a 9; os números mestres não são preservados aqui, nem mesmo no sistema pitagórico. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
personal_life_path_number	—	Todos os dígitos da data de nascimento escrita como DDMMYYYY, somados e reduzidos a um único dígito. Um único inteiro de 1 a 9. Apenas no sistema chinês; a chave védica bhagyank calcula exatamente o mesmo valor.
personal_year_number	year	O tema de um determinado ano civil: o dia de nascimento, o mês de nascimento e o ano-alvo, cada um reduzido primeiro, depois somados e reduzidos novamente. Recebe year, cujo padrão é o ano atual. Um único inteiro de 1 a 9, e a única chave disponível em todos os sistemas.
personality_number	—	As consoantes do nome completo, somadas e reduzidas — a impressão exterior, em contraste com a interior de soul_urge_number. Um único inteiro de 1 a 9, nunca um número mestre. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
phone_number	phone_number	Os dígitos do número de telefone passado no campo phone_number, somados e reduzidos. Um único inteiro de 1 a 9, ou 0 se não houver dígitos. Apenas no sistema chinês, e o campo é obrigatório sempre que esta chave for pedida.
pinnacle_cycles	—	Os quatro pináculos, as fases sucessivas da vida na numerologia pitagórica, calculados a partir do mês, do dia e do ano de nascimento reduzidos. Retorna {first, second, third, fourth}, cada um deles um inteiro, com 11 e 22 preservados. Apenas no sistema pitagórico.
psychic_number	—	O número raiz ou psíquico: o dia do mês de nascimento reduzido a um único dígito. Um único inteiro de 1 a 9. Apenas nos sistemas caldeu e pitagórico.
rational_thought	—	A soma das letras do primeiro nome mais o dia do nascimento, reduzida — lida como a maneira de a pessoa raciocinar diante de um problema. Um único inteiro de 1 a 9. Apenas no sistema pitagórico.
soul_urge_number	—	O número do desejo do coração: apenas as vogais do nome completo, somadas e reduzidas. Um único inteiro, preservando 11 e 22 no sistema pitagórico. A, E, I, O e U contam; Y não. Disponível quando `system` é `chaldean` ou `pythagorean`; os demais retornam 400.
unlucky_numbers	—	Os números de azar desse mesmo animal do zodíaco, combinados com 4. Retorna uma lista ordenada de inteiros distintos. Apenas no sistema chinês.
vedic_grid	—	A grade de nascimento 3×3 com seus regentes planetários. Retorna {grid, grid_layout, details}: grid_layout é o arranjo fixo [[4,9,2],[3,5,7],[8,1,6]], grid guarda quantas vezes cada um desses dígitos ocorre na data de nascimento, nas mesmas posições, e details tem chaves de '1' a '9' com {planet, meaning, count, active}. Apenas no sistema védico.
vedic_personal_day	year, month, day	O dia pessoal: ((mês pessoal védico + dia-alvo − 1) mod 9) + 1. Recebe year, month e day, todos com padrão na data de hoje. Um único inteiro de 1 a 9. Apenas no sistema védico.
vedic_personal_month	year, month	O mês pessoal: ((ano pessoal védico + mês-alvo − 1) mod 9) + 1. Recebe year e month, ambos com padrão na data de hoje. Um único inteiro de 1 a 9. Apenas no sistema védico.
vedic_personal_year	year	O ano pessoal pela fórmula védica ((dia de nascimento + mês de nascimento + ano-alvo − 1) mod 9) + 1. Observe que ela soma os valores brutos em vez de reduzir cada um primeiro, então pode diferir de personal_year_number para a mesma pessoa e o mesmo ano. Recebe year, cujo padrão é o ano atual. Um único inteiro de 1 a 9. Apenas no sistema védico.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/numerology/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-01T06:00:00+05:30","name":"Ramesh Kumar","day":1,"month":9,"year":2026,"system":"chaldean","keys":["birthday_number","expression_number","life_path_number"]}'

Resposta

{
  "data": {
    "birthday_number": 1,
    "expression_number": 8,
    "life_path_number": 2,
    "birthday_number_metadata": {
      "name": "Birthday Number",
      "input": "Day of Birth (DD)",
      "formula": "Use the day directly if it's a single digit; if it's a double-digit number, reduce to a single digit.",
      "meaning": "Reveals natural talents and key characteristics based on birthdate."
    },
    "expression_number_metadata": {
      "name": "Expression Number (Destiny Number)",
      "input": "Full Name (Chaldean letter chart)",
      "formula": "Sum the values of all letters based on Chaldean chart and reduce to a single digit.",
      "meaning": "Reflects overall potential and life path, linked to name vibration."
    },
    "vedic_planet_associations": {
      "1": {
        "planet": "Sun (Surya)",
        "meaning": "Leadership, authority, soul, father"
      },
      "2": {
        "planet": "Moon (Chandra)",
        "meaning": "Mind, emotions, mother, intuition"
      },
      "3": {
        "planet": "Jupiter (Guru)",
        "meaning": "Wisdom, knowledge, expansion, teacher"
      },
      "4": {
        "planet": "Rahu (North Node)",
        "meaning": "Illusion, material desires, sudden changes"
      },
      "5": {
        "planet": "Mercury (Buddh)",
        "meaning": "Communication, intellect, business, speech"
      },
      "6": {
        "planet": "Venus (Shukra)",
        "meaning": "Love, luxury, arts, relationships"
      },
      "7": {
        "planet": "Ketu (South Node)",
        "meaning": "Spirituality, detachment, intuition, moksha"
      },
      "8": {
        "planet": "Saturn (Shani)",
        "meaning": "Discipline, karma, hard work, delays"
      },
      "9": {
        "planet": "Mars (Mangal)",
        "meaning": "Energy, courage, action, aggression"
      }
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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.