Calculator Endpoints & Responses

All 208+ calculators share one generic endpoint, with a couple of dedicated routes for the most-used tools. This keeps your integration simple: learn the pattern once and you can reach every calculator.

The generic endpoint

POST /api/v1/calculator/{tool_id}

Each calculator has its own tool_id (for example life_path_calculator, abjad, or kundli_calculator) and its own set of input parameters (a name, a birth date, a place of birth, and so on). You send those inputs in the JSON body.

Discovering tool ids and inputs

The authoritative list of every calculator, with its id, is available at:

GET /api/v1/plugin/calculators

This is the same listing the WordPress plugin and the white-label site use to stay in sync, so new calculators appear there automatically. For a human-readable list grouped by tradition, see the Calculator Reference in these docs.

Reading the result

The response is JSON. The result object holds the calculated values, and for chart tools it also includes the geometry needed to draw a wheel, grid or timeline on your side. Alongside it you get usage metadata. Parse the JSON and read the fields you need; do not rely on the exact string formatting, which can change.