API reference › Biorhythm

Biorhythm Reading API

The three cycles on a date, with their state, trend, next critical date and meaning

POST/v1/biorhythm/reading

1 credit · Secret key (test or live) · getBiorhythmReading

Value = 100 × sin(2π × days since birth ÷ period), with periods of 23, 28 and 33 days. Controlled studies have not found that biorhythm predicts events.

Request body

  • birth_date string (date) required

    The date of birth. It is used for this response and not stored.

    e.g. "1990-08-13"

  • date string (date) required

    e.g. "1990-08-13"

  • lang string

    one of en, hi · default "en"

No other fields are accepted.

Response

JSON { data, meta, warnings }, where data is:

  • date string (date) required

    e.g. "1990-08-13"

  • days_since_birth integer required
  • cycles array of object required
    • id string required

      one of physical, emotional, intellectual

    • name string required
    • period_days integer required
    • value number required

      ≥ -100 · ≤ 100

    • state string required

      one of positive, negative, critical

    • trend string required

      one of rising, falling

    • day_in_cycle integer required
    • next_critical string (date) required

      e.g. "1990-08-13"

    • meaning string required
  • critical_today array of string required
  • note string required

Errors: 400, 401, 403, 404, 422, 429, 500. See error codes.

Example request

curl -X POST 'https://api.astrologics.in/v1/biorhythm/reading' \
  -H 'Authorization: Bearer al_test_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"birth_date":"1990-05-15","date":"2026-11-02"}'
Node.js
const res = await fetch("https://api.astrologics.in/v1/biorhythm/reading", {
  method: "POST",
  headers: { Authorization: "Bearer al_test_YOUR_KEY", "Content-Type": "application/json" },
  body: JSON.stringify({
    "birth_date": "1990-05-15",
    "date": "2026-11-02"
  }),
});
console.log(JSON.stringify(await res.json(), null, 2));
Python
import json
import urllib.error
import urllib.request

body = {
    "birth_date": "1990-05-15",
    "date": "2026-11-02",
}

req = urllib.request.Request(
    "https://api.astrologics.in/v1/biorhythm/reading",
    method="POST",
    headers={"Authorization": "Bearer al_test_YOUR_KEY", "Content-Type": "application/json"},
    data=json.dumps(body).encode(),
)
try:
    with urllib.request.urlopen(req) as res:
        print(json.dumps(json.load(res), indent=2, ensure_ascii=False))
except urllib.error.HTTPError as err:
    print(err.code, err.read().decode())
PHP
<?php
$ch = curl_init('https://api.astrologics.in/v1/biorhythm/reading');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => ['Authorization: Bearer al_test_YOUR_KEY', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS => '{"birth_date":"1990-05-15","date":"2026-11-02"}',
    CURLOPT_RETURNTRANSFER => true,
]);
echo curl_exec($ch), PHP_EOL;

Example response

200 OK · 1,595 characters
{
  "data": {
    "date": "2026-11-02",
    "days_since_birth": 13320,
    "cycles": [
      {
        "id": "physical",
        "name": "Physical",
        "period_days": 23,
        "value": 73.1,
        "state": "positive",
        "trend": "rising",
        "day_in_cycle": 3,
        "next_critical": "2026-11-10",
        "meaning": "The physical cycle is in its upper half, which biorhythm charts read as more energy and stamina."
      },
      {
        "id": "emotional",
        "name": "Emotional",
        "period_days": 28,
        "value": -97.5,
        "state": "negative",
        "trend": "falling",
        "day_in_cycle": 20,
        "next_critical": "2026-11-10",
        "meaning": "The emotional cycle is in its lower half, which biorhythm charts read as a quieter or more sensitive mood."
      },
      {
        "id": "intellectual",
        "name": "Intellectual",
        "period_days": 33,
        "value": -75.6,
        "state": "negative",
        "trend": "falling",
        "day_in_cycle": 21,
        "next_critical": "2026-11-14",
        "meaning": "The intellectual cycle is in its lower half, which biorhythm charts read as a time for review over new work."
      }
    ],
    "critical_today": [],
    "note": "Biorhythm is a tradition of counting days from birth. Controlled studies have not found that it predicts events, so read this for interest and not for decisions."
  },
  "meta": {
    "request_id": "req_example",
    "api_version": "v1",
    "engine_version": "2026.10.10",
    "mode": "live",
    "credits_charged": 1
  },
  "warnings": []
}
Try it

Leave empty to use the shared demo key (limited). Test keys only: never charged. Kept in this browser tab and sent through this site to the API. Create one

More in Biorhythm

Get a free API key Biorhythm product page