Download

Numerology API reference

Updated Nov 7, 2026

The Numerology API reference from API for Astrology (apiforastrology.com) lists all 16 endpoints in 7 groups. Each endpoint shows its inputs, its response fields and a real recorded answer. Code comes in curl, JavaScript, Python and PHP. The OpenAPI file behind the reference also downloads, for Postman or code generators.

To send a test request, add your API key under Authentication, open an endpoint and choose Test Request.

About your key here: test requests are real calls that count toward your plan. The key you paste stays in this browser tab only. It stays until you close the tab or choose Forget my API key. It is only sent with your test requests.

Base URL: https://apiforastrology.com/api/numerology
Authentication: Authorization: Bearer or X-API-Key. Get a key
Guides: Docs overview, Quickstart, Authentication, Errors, Conventions, Chaldean vs Pythagorean, Changelog

Loading the interactive reference…

Endpoints by group

All 16 endpoints in 7 groups. Paths are relative to https://apiforastrology.com/api/numerology.

Core numbers

The core numbers for one person: the mulank (birth day number), the bhagyank (destiny number) and the name number, with the Lo Shu grid, lucky day, colors and dates, gemstone and mantra. Also one number on its own, and the whole reading as a printable report.

Mulank and bhagyank API reference: inputs, response fields and curl examples

Names

Names: a name and its spellings against a person's numbers, spellings that sound the same and suit them, and baby names whose number suits a child.

Name numerology API reference: inputs, response fields and curl examples

Number checks

Number checks: a mobile, vehicle or house number, several numbers side by side, and a business name with its launch date.

Mobile number numerology API reference: inputs, response fields and curl examples

Compatibility

Two people's numbers, read both ways.

POST/v1/compatibilityTwo people

Numerology compatibility API reference: inputs, response fields and curl examples

Western numbers

The Western (Pythagorean) numbers: life path, expression, soul urge, personality, maturity, birthday, karmic debt and lessons, challenges and pinnacles.