Transits

Current planetary transits to a natal chart, with interpretations and intensity ratings. Costs 5 credits.

POST /v1/transits

Parameters

Name	Type	Required	Description
`date`	string	Yes	Date for the transit reading, `YYYY-MM-DD`.
`time`	string	No	Time `HH:MM` for the natal chart.
`latitude`	number	Yes	Decimal degrees, north positive.
`longitude`	number	Yes	Decimal degrees, east positive.
`timezone`	string	No	IANA timezone.

Example request

curl -X POST https://api.gitstrology.dev/v1/transits \
  -H "X-API-Key: $GITSTROLOGY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "2026-08-02",
    "latitude": 44.8,
    "longitude": 20.4
  }'

Example response

{
  "data": {
    "date": "2026-08-02",
    "birth": {
      "date": "2026-08-02",
      "latitude": 44.8,
      "longitude": 20.4
    },
    "activeTransits": [
      {
        "transitingPlanet": "saturn",
        "natalPlanet": "sun",
        "type": "square",
        "orb": 1.5,
        "interpretation": "A test of resolve and structure.",
        "theme": "challenge",
        "intensity": "major"
      }
    ],
    "summary": "Saturn challenges your sun — stay disciplined."
  },
  "credits": { "used": 5, "remaining": 95 }
}

Response fields

Field	Type	Description
`data.date`	string	Date of the transit reading.
`data.birth`	object	Birth data echoed back.
`data.activeTransits`	array	Active transits to the natal chart. See below.
`data.summary`	string	Plain-language summary.

Active transit object

Field	Type	Description
`transitingPlanet`	string	The planet currently transiting.
`natalPlanet`	string	The natal planet being aspected.
`type`	string	Aspect type (conjunction, square, trine, …).
`orb`	number	Orb in degrees.
`interpretation`	string	Human-readable meaning.
`theme`	string	growth, challenge, love, career, spiritual, or release.
`intensity`	string	minor, moderate, or major.