Astrocartography Relocation

POST/api/v1/western/astrocartography/relocation

Return a full relocated chart for a target city, plus a lighter relocation summary tuned for relocation UX. This endpoint is the full-chart companion to the summary blocks exposed by recommendations and city check.

Full URL

https://api.freeastroapi.com/api/v1/western/astrocartography/relocation

What This Endpoint Returns

This endpoint returns both a relocation interpretation layer and the full relocated Western chart at the same UTC birth instant for the target city.

Use relocation_summary for map cards and quick UI, and use the nested chart block when you need full chart data for an astrologer-facing product.

The target city timezone is surfaced in city.timezone and relocation_summary.resolved_timezone.

Request Body Parameters

Parameter	Type	Req	Description
`natal`	object	Yes	Same timed natal request block used across the Western endpoints. Relocation requires known birth time and resolved birth coordinates.
`city`	string	Yes	Target city for the relocated chart. The live example uses Lisbon.
`country`	string	No	Optional country code to disambiguate city lookup.
`lat / lng`	number / number	No	Optional direct coordinates for the target city when you want to bypass or constrain place lookup.
`natal.house_system`	string	No	House system passed through the natal block. The live example uses placidus and the relocated chart preserves that house system.

Sample Code

This request is the real live production payload used on April 14, 2026, with the API key redacted.

curl -X POST "https://api.freeastroapi.com/api/v1/western/astrocartography/relocation" \
 -H "Content-Type: application/json" \
 -H "x-api-key: YOUR_API_KEY" \
 -d '{
  "natal": {
    "year": 1995,
    "month": 9,
    "day": 5,
    "hour": 20,
    "minute": 0,
    "city": "Paris",
    "lat": 48.8566,
    "lng": 2.3522,
    "tz_str": "Europe/Paris",
    "time_known": true,
    "house_system": "placidus"
  },
  "city": "Lisbon",
  "country": "PT"
}'

Real Response Example

This is a trimmed version of the real production response for Lisbon. The shown fields and values are real; repeated chart sections are abbreviated for readability.

{
  "city": {
    "name": "Lisbon",
    "country": "PT",
    "state": "Lisbon",
    "lat": 38.72509,
    "lng": -9.1498,
    "timezone": "Europe/Lisbon",
    "population": 517802
  },
  "relocation_summary": {
    "resolved_timezone": "Europe/Lisbon",
    "angles": {
      "asc": 320.812,
      "mc": 247.047,
      "ic": 67.047,
      "dc": 140.812
    },
    "angles_details": {
      "asc": {
        "sign": "Aqu",
        "sign_id": "aquarius",
        "pos": 20.812,
        "abs_pos": 320.812,
        "house": 1
      },
      "mc": {
        "sign": "Sag",
        "sign_id": "sagittarius",
        "pos": 7.047,
        "abs_pos": 247.047,
        "house": 10
      },
      "ic": {
        "sign": "Gem",
        "sign_id": "gemini",
        "pos": 7.047,
        "abs_pos": 67.047,
        "house": 4
      },
      "dc": {
        "sign": "Leo",
        "sign_id": "leo",
        "pos": 20.812,
        "abs_pos": 140.812,
        "house": 7
      }
    },
    "angular_planets": [
      {
        "body": "jupiter",
        "angle": "mc",
        "orb_deg": 0.2,
        "house": 10
      }
    ],
    "dominant_themes": ["career", "spiritual"],
    "summary_short": "Relocated chart emphasizes career, spiritual through Jupiter MC.",
    "summary_caution": "Main caution is balance: strong angular emphasis can still narrow life around a few themes."
  },
  "chart": {
    "subject": {
      "name": "User",
      "datetime": "1995-09-05T20:00:00+02:00",
      "location": {
        "city": "Lisbon",
        "lat": 38.72509,
        "lng": -9.1498,
        "timezone": "Europe/Lisbon"
      },
      "settings": {
        "house_system": "placidus",
        "julian_day": 2449966.25,
        "zodiac_type": "Tropical",
        "time_known": true
      }
    },
    "planets": [
      {
        "id": "sun",
        "name": "Sun",
        "sign": "Vir",
        "sign_id": "virgo",
        "pos": 12.705,
        "abs_pos": 162.705,
        "retrograde": false,
        "house": 7
      },
      {
        "id": "jupiter",
        "name": "Jupiter",
        "sign": "Sag",
        "sign_id": "sagittarius",
        "pos": 7.247,
        "abs_pos": 247.247,
        "retrograde": false,
        "house": 10
      },
      {
        "id": "saturn",
        "name": "Saturn",
        "sign": "Pis",
        "sign_id": "pisces",
        "pos": 22.019,
        "abs_pos": 352.019,
        "retrograde": true,
        "house": 1
      },
      "... more planets in the real response ..."
    ],
    "aspects": [
      {
        "p1": "sun",
        "p2": "venus",
        "type": "conjunction",
        "orb": 4.31,
        "deg": 0,
        "is_major": true
      },
      {
        "p1": "jupiter",
        "p2": "sun",
        "type": "square",
        "orb": 5.46,
        "deg": 90,
        "is_major": true
      }
    ],
    "aspects_summary": {
      "total": 31,
      "major": 31,
      "minor": 0,
      "by_type": {
        "conjunction": 5,
        "square": 9,
        "sextile": 8,
        "trine": 7,
        "opposition": 2
      }
    },
    "confidence": {
      "houses": "high",
      "angles": "high",
      "overall": "high"
    },
    "houses": [
      {
        "house": 1,
        "name": "1",
        "sign": "Aqu",
        "sign_id": "aquarius",
        "pos": 20.812,
        "abs_pos": 320.812
      },
      {
        "house": 10,
        "name": "10",
        "sign": "Sag",
        "sign_id": "sagittarius",
        "pos": 7.047,
        "abs_pos": 247.047
      }
    ],
    "angles": {
      "asc": 320.812,
      "mc": 247.047,
      "ic": 67.047,
      "dc": 140.812,
      "vertex": 162.498
    },
    "...": "full relocated chart continues in the real response"
  },
  "meta": {
    "mode": "in_mundo",
    "timezone": "Europe/Paris",
    "house_system": "placidus"
  },
  "warnings": [
    "Astrocartography results are exploratory and should be treated as directional rather than deterministic."
  ]
}

Response Fields

Field	Meaning
`city`	Resolved target city payload, including the resolved target timezone.
`relocation_summary`	Condensed interpretation layer with relocated angles, angular planets, dominant themes, and short summary text.
`relocation_summary.resolved_timezone`	Resolved timezone for the target city. This is the timezone to use when presenting the relocated location context.
`chart.subject`	Relocated chart subject block, including the target location and the settings used to produce the chart.
`chart.planets`	Full relocated planetary positions and houses.
`chart.aspects / chart.aspects_summary`	Relocated aspect list plus a summarized count by aspect type.
`chart.confidence`	Confidence labels for the relocated chart output. The live example returns high confidence for houses, angles, and overall.
`chart.houses / chart.angles / chart.angles_details`	Full relocated house cusps and angles, including sign and absolute-position breakdowns.
`meta.mode / meta.house_system`	Resolved calculation metadata for the relocation request.
`meta.timezone`	Natal-side calculation timezone used to derive the base instant. The relocated target timezone is returned separately under `city.timezone` and `relocation_summary.resolved_timezone`.
`warnings`	Interpretive caveats or calculation notes returned with the payload.