Astrology icon

Astrology

Perform astrological calculations via Astrology API

Actions231

Tarot → Analysis - Transit Report

AI-generated

Summary

Generate a tarot transit report interpreting current planetary transits against the user's natal birth data.

Inputs

  • year (required) — Birth year in 4-digit format (e.g., 1990)
  • month (required) — Birth month as number 1-12 (January=1, December=12)
  • day (required) — Birth day of month (1-31)
  • hour (required) — Birth hour in 24-hour format (0-23, where 0=midnight, 12=noon)
  • minute (required) — Birth minute (0-59)
  • locationType (required) — Choose how to specify birth location: by city name (auto-detects coordinates) or exact latitude/longitude
  • city — Birth city name (e.g., 'London'). Required when locationType is 'city'
  • countryCode — 2-letter ISO country code for the birth city (e.g., US, GB, UA, DE, FR). Required when locationType is 'city'
  • latitude — Geographic latitude of birth location in decimal degrees (-90 to 90, positive=North). Required when locationType is 'coordinates'
  • longitude — Geographic longitude of birth location in decimal degrees (-180 to 180, positive=East). Required when locationType is 'coordinates'
  • language — Language for response text and interpretations
  • tradition — Tarot interpretation tradition/style
  • useReversals — Whether to include reversed card orientations
  • includeDignities — Whether to include elemental dignity analysis
  • includeTiming — Whether to include timing predictions
  • includeAstroContext — Whether to include current astrological influences
  • includeBirthCards — Whether to include personal birth cards in analysis
  • simplify — Whether to return simplified response with key data only. Disable for full API response with all metadata.

Output shape

A tarot transit report object. When simplify is enabled (default) returns key data only: card interpretations, transit influences, and selected optional elements (reversed cards, dignities, timing, astrological context, birth cards). When disabled returns the full API response with all metadata including all card details, elemental dignities, timing predictions, astrological context, and birth card analysis.

The operation builds birth data from the provided year/month/day/hour/minute and location parameters, then generates a transit report combining natal birth data with current transiting planetary positions. Optional flags control inclusion of reversals, dignities, timing, astrological context, and birth cards in the response.

Examples

Example 1: Basic transit report for 1990-06-15 14:30 in London, GB

year=1990, month=6, day=15, hour=14, minute=30, locationType=city, city=London, countryCode=GB, simplify=true

Links

Discussion