New Numerology API

Docs

Astrology and numerology API docs

The docs of API for Astrology (apiforastrology.com) cover two APIs. The Astrology API has 65 endpoints and the Numerology API has 16. One API key works for both. Each API has a quickstart, guides and a full reference. The shared guides explain API keys, rate limits and the errors both APIs send.

Updated

Astrology quickstartNumerology quickstart
© API for Astrology (apiforastrology.com). "Docs map". All rights reserved. Not to be copied or reused.DocsAstrology APILiveAuthenticationErrorsChangelog

APIs

Each API has its own quickstart, guides and reference. One key works for both. Not sure which one you need? Compare the two APIs.

Astrology API

Vedic astrology, the traditional astrology of India, over HTTPS. Send birth details as JSON. You get back charts, dashas (planet periods), the panchang (the Hindu calendar for a day), matching scores and written readings. 65 endpoints in 12 groups, each with examples in curl, JavaScript, Python and PHP.

Overview · Quickstart · API reference · Conventions · Sections and IDs

Open the Astrology API docs

Your first call: John Doe’s birth chart

# John Doe, born Aug 15, 1990, 10:30 AM, New York
curl -X POST "https://apiforastrology.com/api/astrology/v1/planets" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":1990,"month":8,"day":15,"hour":10,"minute":30,"second":0,"latitude":40.7128,"longitude":-74.006,"timezone":"America/New_York"}'

Numerology API

Indian and Western numerology over HTTPS. Send a name and a birth date as JSON. You get back the mulank (birth day number), the bhagyank (destiny number), the name number and the Lo Shu grid (a 3 by 3 number square). There are also name and number checks, compatibility and a full report. 16 endpoints in 7 groups, each with examples in curl, JavaScript, Python and PHP.

Overview · Quickstart · API reference · Conventions · Changelog

Open the Numerology API docs

Your first call: John Doe’s core numbers

# John Doe, born Aug 15, 1990
curl -X POST "https://apiforastrology.com/api/numerology/v1/profile" \
  -H "Authorization: Bearer $ASTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"John Doe","birth_date":"1990-08-15"}'

Postman and OpenAPI files

Every endpoint with the sample people filled in, so a test key answers each request.

Astrology API

65 endpoints. Import into Postman, Insomnia, Bruno or Hoppscotch, then set apiKey to your key.

https://apiforastrology.com/api/astrology
Postman collectionOpenAPI file

Numerology API

16 endpoints. Import into Postman, Insomnia, Bruno or Hoppscotch, then set apiKey to your key.

https://apiforastrology.com/api/numerology
Postman collectionOpenAPI file

Guides for every API

One key works for every API, so these pages apply to all of them.

Languages

Readings in your users’ language

The Astrology API and the Numerology API answer in English and Hindi today. Names and reading text change with the language. Endpoint paths, codes and error messages stay in English.

  1. Supported

    2 languages

    Works today

    • EnglishDefault
    • हिन्दीHindilang=hi

  2. Coming soon

    2 languages

    Next on the list

    • 中文Chinese
    • EspañolSpanish

  3. Planned

    9 languages

    Not scheduled yet

    • தமிழ்Tamil
    • తెలుగుTelugu
    • 日本語Japanese
    • ಕನ್ನಡKannada
    • FrançaisFrench
    • മലയാളംMalayalam
    • PortuguêsPortuguese
    • РусскийRussian
    • বাংলাBengali

Need a language sooner?Tell us which one. Requests help decide what comes next, and a language in progress gets a target quarter once its schedule is set.

Request a language

Developer tools

Pages you will use often.