Total Human DesignDashboard|
Documentation

All Planets Transit

GET/api/transits/allPro

Get positions for all 13 Human Design planets over a date range with configurable granularity (daily/hourly/minute).

Legacy URL supported

The previous endpoint path /api/transit-range is still supported and will continue to work.

Request

Parameters

ParameterTypeRequiredDescription
startDatestringYesStart date in YYYY-MM-DD format
endDatestringYesEnd date in YYYY-MM-DD format
granularitystringNo"daily" (default), "hourly", or "minute" (default: daily)
formatstringNo"full" (default) or "compact" for minimal payload (default: full)
thd-api

Response (full format)

Response200

{
"success": true,
"meta": {
  "endpoint": "transit-range",
  "planets": ["Sun", "Earth", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "NorthNode", "SouthNode"],
  "startDate": "2026-03-01",
  "endDate": "2026-03-07",
  "granularity": "daily",
  "count": 7
},
"data": [
  {
    "datetime": "2026-03-01T12:00:00.000Z",
    "planets": {
      "Sun": {
        "longitude": 340.52,
        "gate": 22,
        "line": 4,
        "color": 2,
        "tone": 5,
        "sign": "Pisces",
        "isRetrograde": false
      },
      "Earth": {
        "longitude": 160.52,
        "gate": 46,
        "line": 4,
        "color": 2,
        "tone": 5,
        "sign": "Virgo",
        "isRetrograde": false
      },
      "Moon": {
        "longitude": 145.32,
        "gate": 46,
        "line": 3,
        "sign": "Leo",
        "isRetrograde": false,
        "moonPhase": { "phase": "Waxing Gibbous", "illumination": 82 }
      }
    }
  }
]
}

Planets returned

All 13 Human Design planets: Sun, Earth, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, NorthNode, SouthNode.

Earth is always 180° opposite the Sun. SouthNode is always 180° opposite NorthNode.

Compact format

Use format=compact for a minimal payload — useful for charts and visualizations:

Response200

{
"success": true,
"meta": {
  "format": "compact",
  "planets": ["Sun", "Earth", "Moon", "Mercury", "Venus", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "NorthNode", "SouthNode"],
  "count": 7
},
"data": [
  {
    "t": "2026-03-01T12:00:00.000Z",
    "l": [340.52, 160.52, 145.32, 328.1, 15.6, 92.3, 70.1, 345.2, 56.8, 357.1, 304.2, 12.5, 192.5],
    "r": ["Mercury"]
  }
]
}

In compact format, l contains longitudes in the same order as meta.planets, and r lists only the currently retrograde planets.

Unit consumption

GranularityUnits per DayMax Range
daily1366 days
hourly24366 days
minute1,44030 days