AstroWay/api v2.157.16 · nl
alle systemen normaal
// astrology api · POST /v1/reports/relocation

Relocation report PDF

Up to five places compared for one birth chart, as a multi-page PDF a customer can keep. Per place: the relocated angles with their shift from birth, which planets changed house, every astrocartography line running within 300 km with its interpretation, and supportive and challenging scores across the nineteen areas of life.

Endpoint
POST /v1/reports/relocation
Cost
5000 credits
Latency
~6100 ms
Tier
Tier 7
// 01 / What it computes

Relocation report PDF

A relocated chart is the same sky seen from somewhere else, so every planet keeps the zodiac degree it held at birth and only the houses and angles are re-cast. The report says that before anything else, then shows the consequence: the ascendant and midheaven with a signed shift, and the list of planets whose house actually changed, diffed rather than left as two tables for the reader to compare. Distance to each angular line is computed from the body's hour angle and altitude rather than against a drawn polyline, which makes it exact. Category scores reuse the same weights and polarities the by-category endpoint uses, and each total is printed next to the percentage of what that category could award at best, because a raw total carries no scale of its own.

// 02 / Live request

POST/v1/reports/relocation

curl -X POST https://api.astroway.info/v1/reports/relocation \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
  "chart": {
    "date": "1990-05-15",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.45,
    "longitude": 30.52
  },
  "locations": [
    { "name": "Lisbon", "latitude": 38.7223, "longitude": -9.1393 },
    { "name": "Vancouver", "latitude": 49.2827, "longitude": -123.1207 }
  ],
  "categories": ["career", "love"],
  "language": "en"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "url": "https://api.astroway.info/reports/abc-relocation.pdf",
    "storage_key": "reports/abc-relocation.pdf",
    "byte_length": 190518,
    "page_count": 6,
    "duration_ms": 3435,
    "expires_at": "2026-08-14T21:19:34.527Z"
  }
}
// 03 / Parameters

Parameters

nametypeRequired
chart object yes The birth chart. Coordinates are required, as everywhere on /v1.
locations object[] yes One to five places, each with latitude, longitude and an optional name. Coordinates are required per place and never defaulted.
categories string[] no Which of the 19 life areas to score. Omit for all of them. The list is at GET /v1/acg/categories.
orbKm number no How far a line reaches when scoring the categories. Default 1126, the 700 miles Jim Lewis used. It does not affect the angular-line section, which is fixed at 300 km.
language string no One of the 21 report locales. Defaults to uk.
whitelabel boolean no Apply the caller's stored branding to the document.
format "html" (query) no Add ?format=html to stream the document instead of rendering a PDF.
// 04 / When to use it

When to use it

Use it when the question has moved from data to document. The best-places endpoint answers where to go; this is what you hand someone who has narrowed it to a shortlist and wants to understand the difference between the places rather than the ranking of them. It is also the natural paid tier on top of a free map: the JSON endpoints let a product draw lines, and this is the artefact the customer pays for and keeps.

// 05 / Notes

Notes

No AI narrative and no chart wheel, both deliberate. A wheel of the relocated chart shows the same planets in a rotated frame, which reads as a second chart and is exactly the misconception the opening section exists to prevent; and a narrative about a place would be advice on where to live, which this is not. The report ranks and explains. Where a place scores nothing positive in any requested area, the comparison table says so with a dash rather than naming the least bad area as its strength. Coordinates are required per place: a relocation report cast at 0N 0E is a confident document about the Gulf of Guinea, and unlike a wrong JSON field a PDF is kept.

Try the Relocation report API

Grab a key and make your first call in under a minute.

99.9% SLA · betaalde plannen · 30d status →