Skip to content

Transits – Physical, Mental & Spiritual Cycles

Transits reveal your current cycles of influence across three levels of consciousness:

  • Physical – health, energy, material influence
  • Mental – thinking, planning, learning
  • Spiritual – intuition, soul growth, inner wisdom

Note: Masters (11, 22, 33) are not supported in transits calculations.


Endpoint

Method Path
GET https://the-numerology-api.p.rapidapi.com/transits
POST https://the-numerology-api.p.rapidapi.com/transits

Required Headers

x-rapidapi-key: YOUR_RAPIDAPI_KEY
x-rapidapi-host: the-numerology-api.p.rapidapi.com
Content-Type: application/json   (POST only)

Get your key from RapidAPI.


Parameters

Param Type Required Description
full_name string Yes Full name of the person (e.g., "Alexander Graham Bell").
dob string No Date of birth in YYYY-MM-DD format (used to calculate age if age not provided).
age integer No Current age. Overrides age derived from dob. Must be non-negative.

Either dob or age is required if not providing both.


Example Requests

GET Request

curl --request GET \
  --url "https://the-numerology-api.p.rapidapi.com/transits?full_name=Alexander%20Graham%20Bell&dob=1847-03-03" \
  --header "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  --header "x-rapidapi-host: the-numerology-api.p.rapidapi.com"

POST Request (JSON Body)

curl --request POST \
  --url "https://the-numerology-api.p.rapidapi.com/transits" \
  --header "x-rapidapi-key: YOUR_RAPIDAPI_KEY" \
  --header "x-rapidapi-host: the-numerology-api.p.rapidapi.com" \
  --header "Content-Type: application/json" \
  --data '{
    "full_name": "Alexander Graham Bell",
    "dob": "1847-03-03"
  }'

Response Example

{
  "full_name": "Alexander Graham Bell",
  "current_age": 178,
  "current_transits": {
    "physical": {
      "letter": "D",
      "value": 4,
      "plane": "Physical",
      "duration_years": 4,
      "meaning": "Structure, discipline, and building foundations.",
      "detailed_meaning": "The 4 demands order and hard work. Systems are built. Responsibilities increase. This is a time to create lasting form. The gift: security through effort. Shadow: release rigidity; true structure allows growth."
    },
    "mental": {
      "letter": "M",
      "value": 4,
      "plane": "Mental",
      "duration_years": 4,
      "meaning": "Structure, discipline, and building foundations.",
      "detailed_meaning": "The 4 demands order and hard work. Systems are built. Responsibilities increase. This is a time to create lasting form. The gift: security through effort. Shadow: release rigidity; true structure allows growth."
    },
    "spiritual": {
      "letter": "L",
      "value": 3,
      "plane": "Spiritual",
      "duration_years": 3,
      "meaning": "Creativity, joy, and self-expression.",
      "detailed_meaning": "The 3 opens a cycle of inspiration and play. Art, communication, and social connection flourish. Your words carry magic. The discipline: focus scattered energy. Shadow: confront superficiality; true joy requires emotional honesty."
    }
  },
  "cycle_summary": "You are in a 4-year Physical cycle of structure, discipline, and building foundations. (D), a 4-year Mental cycle of structure, discipline, and building foundations. (M), and a 3-year Spiritual cycle of creativity, joy, and self-expression. (L). This is a time of building, letting go, and awakening.",
  "note": "Transits are derived from the letters in your names—first, middle, and last—each reflecting a level of consciousness: physical, mental, and spiritual."
}

Interpretation

  • Physical, Mental, Spiritual planes – correspond to first, middle, and last names, respectively.
  • Cycle Value – number of years for the current transit.
  • Letter – active letter governing the transit.
  • Meaning / Detailed Meaning – explains the quality and purpose of each cycle.
  • Cycle Summary – dynamic narrative combining all three planes for holistic insight.

View on RapidAPI


Note

  • Input must include a valid full name.
  • DOB or age is required to calculate current transit position.
  • Masters (11, 22, 33) are ignored in this endpoint.
  • Useful for personal growth, cycle awareness, and spiritual coaching.