Actions231
- Analysis Actions
- Career Analysis
- Compatibility
- Compatibility Score
- Composite Report
- Direction Report
- Health Analysis
- Karmic Analysis
- Lunar Analysis
- Lunar Return Report
- Lunar Return Transit Report
- Natal Report
- Natal Transit Report
- Predictive Analysis
- Progression Report
- Psychological Profile
- Relationship Analysis
- Relationship Score
- Relocation Analysis
- Solar Return Report
- Solar Return Transit Report
- Spiritual Analysis
- Synastry Report
- Transit Report
- Vocational Analysis
- Astrocartography Actions
- Chart Actions
- Chinese Actions
- Data Actions
- Eclipses Actions
- Enhanced Actions
- Fengshui Actions
- Fixed Stars Actions
- Glossary Actions
- Horary Actions
- Horoscope Actions
- Human Design Actions
- Insights Actions
- Business: Department Compatibility
- Business: Hiring Compatibility
- Business: Leadership Style
- Business: Succession Planning
- Business: Team Dynamics
- Business: Timing
- Discover Insights
- Discover Relationship Insights
- Financial: Bradley Siderograph
- Financial: Crypto Timing
- Financial: Forex Timing
- Financial: Gann Analysis
- Financial: Market Timing
- Financial: Personal Trading
- Pet: Compatibility
- Pet: Health Sensitivities
- Pet: Multi-Pet Dynamics
- Pet: Personality
- Pet: Training Windows
- Relationship: Compatibility
- Relationship: Compatibility Score
- Relationship: Davison Chart
- Relationship: Love Languages
- Relationship: Red/Green Flags
- Relationship: Timing
- Wellness: Biorhythms
- Wellness: Body Mapping
- Wellness: Energy Patterns
- Wellness: Moon Calendar
- Wellness: Score
- Wellness: Timing
- Kabbalah Actions
- Lunar Actions
- Numerology Actions
- PDF Actions
- Render Actions
- Tarot Actions
- Analysis - Birth Cards
- Analysis - Dignities
- Analysis - Natal Report
- Analysis - Optimal Times
- Analysis - Quintessence
- Analysis - Timing
- Analysis - Transit Report
- Daily Card
- Draw Cards
- Glossary - Card Detail
- Glossary - Cards
- Glossary - Spreads
- Report - Celtic Cross
- Report - Houses
- Report - Single Card
- Report - Synastry
- Report - Three Card
- Report - Tree of Life
- Search Cards
- Traditional Actions
- Vedic Actions
- Ziwei Actions
Insights → Relationship: Timing
AI-generatedSummary
Computes relationship timing insights for two people by sending both subjects' birth data and a date range to the Astrology API, returning astrological timing/transit analysis for the relationship over that period.
Inputs
- year (required) — Birth year of the first person (e.g., 1990).
- month (required) — Birth month of the first person, 1-12.
- day (required) — Birth day of the first person, 1-31.
- hour (required) — Birth hour of the first person in 24-hour format, 0-23.
- minute (required) — Birth minute of the first person, 0-59.
- locationType (required) — How to specify the first person's birth location: city name or exact coordinates.
- city (required) — First person's birth city; required when locationType is 'city'.
- countryCode (required) — 2-letter ISO country code for the first person's birth city; required when locationType is 'city'.
- latitude (required) — First person's birth latitude in decimal degrees; required when locationType is 'coordinates'.
- longitude (required) — First person's birth longitude in decimal degrees; required when locationType is 'coordinates'.
- subject2Name — Optional name for the second person, used in report titles.
- subject2Year (required) — Birth year of the second person.
- subject2Month (required) — Birth month of the second person, 1-12.
- subject2Day (required) — Birth day of the second person, 1-31.
- subject2Hour (required) — Birth hour of the second person in 24-hour format, 0-23.
- subject2Minute (required) — Birth minute of the second person, 0-59.
- subject2LocationType (required) — How to specify the second person's birth location: city name or exact coordinates.
- subject2City (required) — Second person's birth city; required when subject2LocationType is 'city'.
- subject2CountryCode (required) — 2-letter ISO country code for the second person's birth city; required when subject2LocationType is 'city'.
- subject2Latitude (required) — Second person's birth latitude; required when subject2LocationType is 'coordinates'.
- subject2Longitude (required) — Second person's birth longitude; required when subject2LocationType is 'coordinates'.
- startDate (required) — Start date for the transit analysis period, in YYYY-MM-DD format.
- endDate (required) — End date for the transit analysis period, in YYYY-MM-DD format.
- language — Language for response text and interpretations. Options: en, ru, de, es, fr, it, pt, zh, ja, ko. Default: en.
- simplify — When true, returns a simplified response with key data only. When false, returns the full API response with all metadata. Default: true.
Output shape
JSON object from the Astrology API. If simplify is true, the response is reduced to a subset of top-level fields (nested objects preserved). If simplify is false, the complete API response is returned.
Returns the Insights API response for relationship timing. With simplify enabled, only key top-level fields are returned; with simplify disabled, the full API response including metadata is returned.
Examples
Example 1: Determine favorable or challenging timing windows for a relationship over a given date range by comparing two people's birth charts.
Insights → Relationship: Timing