Synastry Horoscope

Generates a daily synastry forecast by calculating the natal charts of two individuals and comparing them against the day's transits, highlighting shared dynamics, tensions, and areas of growth. The same endpoint supports romantic and friendship wording.

POST/api/v1/western/synastry/horoscope

Timing expansion: High plan

Endpoint Overview

Accepts full birth details (time, location) for two people to calculate composite and individual transit triggers for a specific date.

Switching To Friendship Text

Add ?relationship_context=friendship to return friendship-specific interpretation blocks from friendship_horoscope_daily, plus friendship domains such as social_chemistry, reliability, and emotional_boundaries. Omit the parameter or use romantic to keep the couples-style text set.

Timing Expansion

Add include_timing=true to include activation windows for each returned trigger. Timing describes the temporary transit-driven trigger window, not the permanent natal synastry. Returned fields include orb entry, exact hit timing, orb exit, duration, and the trigger phase around the daily snapshot.

Body Parameters

Parameter	Type	Required	Description
person_a	object	Yes	Birth details for the first person
person_b	object	Yes	Birth details for the second person
date	string	No	Target date (YYYY-MM-DD). Default: today
tz_str	string	No	Timezone string. Default: UTC
relationship_context	query	No	Use romantic (default) or friendship to switch the text set, domains, bands, and rituals
include_timing	query	No	High plan required. Include activation windows for returned transit-driven triggers.

Person Object

Parameter	Type	Required	Description
person.datetime	string	Yes	ISO 8601 offset string (e.g. 1990-05-15T14:30:00+00:00)
person.location	object	Yes	{ lat: float, lng: float, city: string }
person.name	string	No	The partner's name
person.tz_str	string	No	Timezone string. Default: AUTO

Example Request

curl -X POST "https://api.freeastroapi.com/api/v1/western/synastry/horoscope?relationship_context=friendship&include_timing=true" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
    "person_a": {
        "datetime": "1990-01-01T12:00:00+00:00",
        "location": { "lat": 40.71, "lng": -74.00, "city": "New York" }
    },
    "person_b": {
        "datetime": "1992-05-15T14:30:00+00:00",
        "location": { "lat": 48.85, "lng": 2.35, "city": "Paris" }
    },
    "date": "2026-02-25",
    "tz_str": "America/New_York"
}'

Response Example

{
  "meta": {
    "report_id": "dch_a769c82d-a275-43dc-91ac-89fbc6878b4d",
    "calculation": {
      "mode": "daily_couples_horoscope",
      "date": "2026-02-25",
      "timezone": "America/New_York"
    },
    "features": {
      "timing_included": true,
      "plan_required": "high"
    },
    "generated_at": "2026-02-25T13:40:51Z"
  },
  "summary": {
    "scores": {
      "romance": 50,
      "communication": 81,
      "stability": 71,
      "intimacy": 65,
      "growth": 61,
      "tension": 76,
      "overall": 57
    },
    "score_meta": {
      "tension_higher_is_more": true
    },
    "strengths": [
      "trigger.transit_sun_trine_partner_a_lilith"
    ],
    "challenges": [
      "trigger.transit_pluto_opposition_partner_b_chiron"
    ],
    "drivers_by_domain": {
      "romance": ["trigger.transit_sun_trine_partner_a_lilith"]
    },
    "narrative": "Explosive Words: Clarity builds structure.",
    "bands": {
      "theme": "Explosive Words",
      "core": "Clarity builds structure.",
      "shadow": "Attraction burns out during conflict."
    }
  },
  "aspects": [
    {
      "key": "trigger.transit_sun_conjunction_partner_a_moon",
      "label": "Transit Sun Conjunction Partner A's Moon",
      "strength_label": "high",
      "polarity": "mixed",
      "domains": ["communication", "intimacy"],
      "display_policy": "both_sides",
      "blocks": {
        "supportive": {
          "title": "Emotional Fusion",
          "one_liner": "Today brings a chance for mutual emotional support.",
          "insight": "Today, one partner may find themselves feeling more sensitive..."
        },
        "challenging": {
           "title": "Emotional Fusion",
          "one_liner": "Today brings a chance for mutual emotional support.",
          "insight": "Today, one partner may find themselves feeling more sensitive..."
        }
      },
      "timing": {
        "is_active_on_date": true,
        "phase": "applying",
        "start_datetime": "2026-02-24T08:12:00Z",
        "exact_datetimes": ["2026-02-25T15:44:10Z"],
        "end_datetime": "2026-02-26T20:03:00Z",
        "duration_hours": 35.85,
        "duration_days": 1.49375,
        "continues_before_date": true,
        "continues_after_date": true,
        "precision": "high"
      }
    }
  ],
  "ritual": {
    "id": "two_sentence_repair",
    "title": "Two-Sentence Repair",
    "duration_seconds": 90,
    "steps": [
      "Partner A: one sentence about what you felt today (no blame).",
      "Partner B: mirror it back in your own words."
    ],
    "domains": ["communication", "intimacy"],
    "bond_xp_reward": 10
  }
}

Response Features

This endpoint provides dynamic relationship forecasts with a romantic mode by default and a friendship text mode when relationship_context=friendship is present.

Narrative Bands

Provides a distinct one-liner combining the current vibe of the relationship based on scoring thresholds (theme) with an actionable core insight, and a shadow warning.

Dual-Polarity Interpretations

If an aspect has a mixed polarity, the system natively adapts and supplies identical, neutral-perspective AI analysis blocks in both the supportive and challenging response fields under a unified display_policy: both_sides.

Playful Rituals

A simple actionable step tuned to the current relationship context. Romantic requests return couple-oriented rituals, while friendship requests return check-in and coordination rituals aligned with the friendship domains.