API Reference
Welcome to the AstroAPI Reference documentation. This section provides detailed information about all available endpoints.
OpenAPI Specification
The complete API is documented using the OpenAPI 3.1 specification. Use the sidebar to browse available endpoints organized by category.
Base URL
https://api.astroapi.cloudAuthentication
All API requests require authentication via:
- API Key:
X-Api-Keyheader
See the Authentication Guide for details.
Response Format
All responses follow the JSON:API specification:
{
"data": {
"type": "resource-type",
"id": "resource-id",
"attributes": { ... }
}
}Error Responses
Errors follow JSON:API error format:
{
"errors": [{
"status": "400",
"title": "Bad Request",
"detail": "Detailed error message"
}]
}Common HTTP Status Codes
| Code | Description |
|---|---|
| 200 | Success |
| 201 | Created |
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Missing or invalid authentication |
| 403 | Forbidden - Insufficient permissions or module access |
| 404 | Not Found |
| 429 | Too Many Requests - Rate limit exceeded |
| 500 | Internal Server Error |
Professional astrology API for natal charts, transits, synastry, and interpretations
Servers
Content
Content management and interpretation texts
Operations
Create Custom Copy
Create an organization-specific copy of system content for customization.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Create a custom copy of system content
Restore Content
Restore custom content to match the original system content.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Restore custom content to match system content
Delete Content by ID
Delete a content item by its ID.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Delete one content item
List Content
Retrieve a paginated list of content items filtered by horoscope and content type.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Retrieve content items
Create Content
Create a new content item for a specific horoscope and content type.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Create content item
Get Content
Retrieve a single content item by its ID.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Retrieve one content item
Delete Content
Delete a content item by horoscope type, content type, and ID.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Delete one content item
Update Content
Update the title, body or metadata of a content item.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Update one content item
Calculations
Astrological calculations including natal charts, transits, synastry, and more
Operations
Natal Chart
Calculate a natal (birth) chart with planetary positions, house cusps, and aspects. By default the Moon is topocentric (parallax-corrected for the birth location); set moonCenter to geocentric for Earth-center Moon positions.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate natal chart
AI Summary (natal)
Generate a short narrative summary of what this horoscope means, written from the strongest placements and aspects of the chart. Open the signed summary.url returned by the matching calculation endpoint — it carries the whole request, so no body is needed. Generating a summary counts as 10 API requests and takes several seconds; a summary that was generated before is served from cache and counts as one. Requires the AI Summary module (included in the Premium and Deluxe plans) plus the interpretation texts of this horoscope type.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
The generated summary
Synastry Chart
Calculate synastry aspects between two birth charts for relationship analysis.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate synastry chart
AI Summary (synastry)
Generate a short narrative summary of what this horoscope means, written from the strongest placements and aspects of the chart. Open the signed summary.url returned by the matching calculation endpoint — it carries the whole request, so no body is needed. Generating a summary counts as 10 API requests and takes several seconds; a summary that was generated before is served from cache and counts as one. Requires the AI Summary module (included in the Premium and Deluxe plans) plus the interpretation texts of this horoscope type.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
The generated summary
Composite Chart
Calculate a composite chart by combining midpoints of two birth charts.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate composite chart
AI Summary (composite)
Generate a short narrative summary of what this horoscope means, written from the strongest placements and aspects of the chart. Open the signed summary.url returned by the matching calculation endpoint — it carries the whole request, so no body is needed. Generating a summary counts as 10 API requests and takes several seconds; a summary that was generated before is served from cache and counts as one. Requires the AI Summary module (included in the Premium and Deluxe plans) plus the interpretation texts of this horoscope type.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
The generated summary
Transit Chart
Calculate planetary transits over a natal chart for a specified time period.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate transits chart
AI Summary (transit)
Generate a short narrative summary of what this horoscope means, written from the strongest placements and aspects of the chart. Open the signed summary.url returned by the matching calculation endpoint — it carries the whole request, so no body is needed. Generating a summary counts as 10 API requests and takes several seconds; a summary that was generated before is served from cache and counts as one. Requires the AI Summary module (included in the Premium and Deluxe plans) plus the interpretation texts of this horoscope type.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
The generated summary
Transit iCal Export
Generate an iCal (.ics) file containing transit aspects as calendar events.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
iCal file with transit aspects
Compatibility Analysis
Calculate sun sign compatibility between two people with interpretation text.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate compatibility between two birth charts
Solar Return
Calculate the solar return chart for a specific year (birthday chart).
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate solar return chart
AI Summary (solar)
Generate a short narrative summary of what this horoscope means, written from the strongest placements and aspects of the chart. Open the signed summary.url returned by the matching calculation endpoint — it carries the whole request, so no body is needed. Generating a summary counts as 10 API requests and takes several seconds; a summary that was generated before is served from cache and counts as one. Requires the AI Summary module (included in the Premium and Deluxe plans) plus the interpretation texts of this horoscope type.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
The generated summary
Lunar Return
Calculate the lunar return chart when the Moon returns to its natal position.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate lunar return chart
AI Summary (lunar)
Generate a short narrative summary of what this horoscope means, written from the strongest placements and aspects of the chart. Open the signed summary.url returned by the matching calculation endpoint — it carries the whole request, so no body is needed. Generating a summary counts as 10 API requests and takes several seconds; a summary that was generated before is served from cache and counts as one. Requires the AI Summary module (included in the Premium and Deluxe plans) plus the interpretation texts of this horoscope type.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
The generated summary
Secondary Progressions
Calculate secondary progressions chart using the day-for-a-year method. Returns progressed planet positions and aspects to both progressed and natal planets.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate secondary progressions chart
AI Summary (progressions)
Generate a short narrative summary of what this horoscope means, written from the strongest placements and aspects of the chart. Open the signed summary.url returned by the matching calculation endpoint — it carries the whole request, so no body is needed. Generating a summary counts as 10 API requests and takes several seconds; a summary that was generated before is served from cache and counts as one. Requires the AI Summary module (included in the Premium and Deluxe plans) plus the interpretation texts of this horoscope type.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
The generated summary
Moon & Sun Info
Get Moon and Sun information for a specific place and time. Includes moon phase, illumination, distance, and sun rise/set/twilight times.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Moon and Sun information
Moon Calendar Day
Get detailed moon calendar information for a single day, including void of course periods, moon phase, sign transits, and upcoming aspects.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Moon calendar day information
Moon Calendar Range
Get moon calendar information for a date range (max 31 days), including all void of course periods, major lunar phases, and sign transits.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Moon calendar range information
Retrograde Planets Calendar
Calculate retrograde periods for planets within a date range. Returns station dates (when planets turn retrograde/direct), shadow periods, signs traversed, and duration for each retrograde period.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Retrograde calendar data
Declinations
Declinations, parallels and out-of-bounds flags for one moment.
A horoscope is a projection onto the ecliptic, and that projection throws away the north-south
axis. Two bodies with no zodiacal aspect between them can share a declination — a parallel,
which behaves like a conjunction. The same distance from the equator on opposite sides is a
contraparallel, which behaves like an opposition. Both are measured with a much tighter orb
than a longitude aspect; 1° is the convention and the default.
Out of bounds is a body past the Sun's own maximum declination. The Moon is out of bounds a
few days a month around a major lunar standstill; Mercury, Venus, Mars and Pluto go there at
intervals. The flag is judged against the true obliquity of the requested date, which is returned
alongside it as obliquity.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Declinations, parallels and out-of-bounds flags
Declination Series
Declination over a period, plus the dates each body crosses the out-of-bounds limit.
The crossings are the point of this endpoint. A graph is pleasant; the dates the Moon goes out of
bounds are what an astrologer writes down. They are searched on a finer grid than the one the
series is sampled at, so a coarse stepDays costs resolution in the curve but not in the dates.
The series is capped at 400 points. A year at a daily step is 365; a
longer range needs a wider step.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Declination series and out-of-bounds crossings
Event Search
Find every date in a window on which something happens: aspect crossings to the natal chart,
retrograde and direct stations, lunations and eclipses, sign ingresses and natal house ingresses.
Ask for as many of the five kinds as you like — they share one ephemeris load, so a second kind is nearly free, and a
kind that is not in kinds is not searched and costs nothing.
Every event comes back in the same envelope: kind, exactAt, window, label, strength and a per-kind
details. For an aspect, details.pass and details.ofPasses mark the passes of a retrograde series, so a triple
Saturn square reads as one stretch rather than three unrelated rows.
Window limits. The Moon covers 13° a day and has to be sampled many times a day; Pluto gets away with weeks. So how
long a window may be depends on what is in it:
| Bodies being scanned | Maximum window |
|---|---|
| Slow bodies only | 25 years |
| Including Mercury, Venus or the Sun | 5 years |
| Including the Moon | 1 year |
A lunation search does not count as a Moon search: phases are reached by estimate and refinement, not by a fine grid.
limit defaults to 100 and caps at 500. Paging is on time, not on an offset: pass
the nextCursor you were given back as cursor. truncated says there was more inside the window than fitted.
Cost. This counts for more than one request, because it is honestly more than one calculation:
1 + ceil(windowDays / 365) × (1 + number of fast transiting bodies), capped at 50. A repeated query is served from
cache and counts as one — events never change, so the answer never goes stale.
Set ical: true to get icalUrl alongside the events: a signed, subscribable calendar feed of this exact query that
needs no API key, so it can be pasted straight into a calendar application.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
The events found in the window
Event Calendar Feed
The signed calendar feed of an event search, as an .ics file.
Get the URL from icalUrl on a POST /api/calc/events with ical: true, then paste it into a calendar
application as a subscription. It carries its own signature, so it needs no API key and no session — the same mechanism
as a signed chart image URL — and for the same reason it does not count against the request quota. The search that
produced the URL was charged when it ran.
The signature covers the path and every query parameter, so a feed URL can be neither pointed at another endpoint nor
edited into a different query. It is valid for thirty days.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
iCal file with the events
Annual, Monthly and Daily Profections
Annual profections: one whole sign per year of life from a natal place, with the ruler of the sign arrived at as the Lord of the Year, plus the monthly and daily subdivisions.
The year turns on the solar return, not on the calendar birthday — the Sun comes back to its natal degree up to a day either side, and a year that starts on the wrong day puts the wrong lord in charge at both ends. Each year in the window therefore costs one solar return to find its boundary, which is why years is capped at 30.
from chooses the place profected. The Ascendant is the standard and the default; Valens also profects the Moon, the Sun, the Lot of Fortune and the Midheaven, each answering a different question.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Profections over the requested window
Zodiacal Releasing
Zodiacal releasing from the Lot of Spirit or the Lot of Fortune, after Valens, Anthology Book IV. Periods released in zodiacal order from the sign of the lot, each as long as the planetary years of that sign's ruler, subdivided one twelfth at a time.
Loosing of the bond is applied by default: when the sequence arrives at Cancer or Capricorn the next period is the opposite sign rather than the next one, after which it carries on in order. Omitting it leaves the first two or three decades correct and everything after them wrong, so it is on unless you switch it off to match software that lacks it.
Peak periods are the ones reaching the angles of the lot. Valens measures the angular triad from the Lot of Fortune even when releasing from Spirit, so peakFrom defaults to fortune; peakSigns says which of the angles is the peak, the tenth by default.
Levels 3 and 4 are only expanded inside detailWindow — the unit shrinks twelvefold per level, and a fourth level over a lifetime is tens of thousands of periods.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
The releasing tree
Firdaria
The Persian system of planetary periods, from Abu Ma'shar and Bonatti. Seven main periods of fixed length, each divided into seven sub-periods, the cycle closing after seventy-five years.
The sequence starts with the Sun in a day chart and with the Moon in a night chart — the same seven-planet cycle, rotated. The sect is resolved from the chart, with the same traditional.sectMethod parameter every other traditional endpoint takes.
includeNodes (default true) gives the Head and Tail of the Dragon their three and two years at the end of the cycle, the majority reading; without them the cycle is seventy years. The node periods run whole unless subdivideNodes is set.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Main periods and sub-periods
Solar Arc Directions
Every point in the chart, the angles included, moved forward by the arc the Sun has travelled since birth, and read against the natal positions.
Three keys. true (the default) uses the arc the Sun actually travelled to the secondary-progressed date, which is what "solar arc" means without qualification and what the progression calculation already produces. naibod advances 0.9856262833° per year, the Sun's mean daily motion, and does not depend on the season of birth. ptolemy advances exactly one degree a year.
Directions to the Midheaven and Ascendant are included by default: they are the contacts that date an event most sharply, and the measurement rectification reads.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Directed positions and their contacts with the natal chart
Birth Time Rectification
Rank candidate birth times against dated life events.
This is not an oracle, and the response says so itself. There is no validated ground truth
for rectification: no astrological technique is known to recover a birth time. What this
endpoint does is rank the candidate times in a window by how well each fits the rules you
turned on, and show per candidate what produced its score. It is a structured way of working
that replaces hours of doing the same comparison by hand — not a claim to have found anything.
Three things follow, and they are part of the contract:
- There is never one answer.
candidatesis a ranking with scores, always several. - The reasoning comes with it. Every candidate lists what each rule contributed and why,
so you can read the ranking and reject it. - Flatness is reported.
discriminationis the normalized entropy of the ranking. At
verdict: "none"the evidence separated nothing and the order is arbitrary — say that to
whoever is reading it rather than presenting the accidental winner.
What moves with the birth time
Almost nothing does, and that is what makes the search possible. The ascendant and the
midheaven move 1° every four minutes, the houses follow them, the Moon covers 0.55° an hour,
and everything derived from the ascendant moves with it. A planet-to-planet aspect is the same
for the whole window, so a rule that looks at one contributes nothing and only dilutes what the
others found. Every rule here is angle-sensitive.
The rules
| Rule | What it looks for |
|---|---|
transit-to-angle |
A transiting body on an angle on the event date. The sharpest rule: a 1° orb pins the time to about eight minutes. |
house-placement |
A transiting body in a house the event type is about. Coarse — a house is 30° — but it keeps scoring when nothing lands on an angle. |
solar-arc-to-angle |
A solar arc direction reaching an angle, either way round. As sharp as a transit contact. |
progressed-moon |
The secondary-progressed Moon on an angle or in a matching house. A weak signal, weighted as one. |
stated-time |
The time you gave, as a normal prior with spread sigmaMinutes. Leave it on: without it a single lucky transit six hours away wins. |
profection |
Annual profections and zodiacal releasing. Declared but not yet available; it is reported as available: false rather than quietly scoring zero. |
The event taxonomy
A fixed list, not free text. A description interpreted by a model would make the same request
answer differently on two days, and reproducibility is what this endpoint has to offer. Your own
wording goes in description and is carried into the evidence lines untouched.
| Type | Subject | Houses (weight) |
|---|---|---|
marriage |
marriage or committed partnership | 7 (1), 5 (0.4), 1 (0.3) |
separation |
separation or divorce | 7 (1), 8 (0.5), 12 (0.3) |
child-born |
birth of a child | 5 (1), 4 (0.4), 11 (0.2) |
relocation |
move of home | 4 (1), 3 (0.4) |
emigration |
emigration or long stay abroad | 9 (1), 4 (0.6), 3 (0.3) |
career-change |
change of career or standing | 10 (1), 6 (0.5), 2 (0.3) |
job-loss |
loss of work | 6 (1), 10 (0.6), 12 (0.3) |
education |
start of a course of study | 9 (1), 3 (0.5) |
illness |
illness | 6 (1), 12 (0.6), 8 (0.3) |
surgery |
surgery | 8 (1), 6 (0.8), 12 (0.4) |
accident |
accident or injury | 6 (0.8), 8 (0.8), 1 (0.6) |
bereavement |
death of someone close | 8 (1), 4 (0.4), 12 (0.3) |
financial-gain |
windfall or substantial gain | 2 (1), 11 (0.5), 8 (0.4) |
financial-loss |
substantial financial loss | 2 (1), 8 (0.8), 12 (0.4) |
public-recognition |
public recognition | 10 (1), 11 (0.6), 1 (0.3) |
other |
unclassified | — |
Limits and what it costs
The window is at most ±720 minutes, the resolution at least 1 minute, the candidates at most
1441, and the events at most 25. Past any of
those the request is a 400 with the reason — never a silently truncated search.
This is the most expensive route on the API and it is priced accordingly:
cost = 5 + events + ceil(candidates / 60) capped at 60
An everyday question — ±2 hours at one minute, 8 events — costs 18. The largest possible one
costs 55. A request that fails costs nothing. The answer reports what it charged in
method.requestCost.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
A ranking of candidate birth times, with the contribution of each rule and how much the evidence discriminated
Chinese Zodiac Sign
Calculate the Chinese zodiac sign and element based on birth year.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate Chinese horoscope sign
Chinese Zodiac Forecast
Get Chinese zodiac forecast for a specific year with category breakdowns.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Calculate Chinese horoscope forecast
Render Chart (SVG)
Render an astrological chart as SVG image.
Required parameters:
- width, height: Chart dimensions
- dateTime: Natal date/time (YYYY-MM-DDTHH:mm)
- location.longitude, location.latitude, location.timezone: Natal location
Optional transit parameters (for bi-wheel chart):
- transit.dateTime: Transit date/time (YYYY-MM-DDTHH:mm)
- transit.timezone: Transit timezone
- transit.longitude, transit.latitude: Transit location (defaults to natal location)
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Chart (PNG)
Render an astrological chart as PNG image. Requires query parameters: width, height, dateTime, location.longitude, location.latitude, location.timezone
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Composite Chart (SVG)
Render a composite chart (midpoints of two natal charts) as SVG image.
Required parameters:
- width, height: Chart dimensions
- person1.dateTime: Person 1 date/time (YYYY-MM-DDTHH:mm)
- person1.timezone: Person 1 timezone
- person1.longitude, person1.latitude: Person 1 location
- person2.dateTime: Person 2 date/time (YYYY-MM-DDTHH:mm)
- person2.timezone: Person 2 timezone
- person2.longitude, person2.latitude: Person 2 location
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Composite chart rendered successfully
Render Composite Chart (PNG)
Render a composite chart (midpoints of two natal charts) as PNG image.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Composite chart rendered successfully
Render Natal Chart (SVG) - v2
Render a natal chart using the new Chart2 engine as SVG.
Required parameters:
- width, height: Chart dimensions
- dateTime: Birth date/time (YYYY-MM-DDTHH:mm)
- location.longitude, location.latitude, location.timezone: Birth location
Theme presets:
Use ?theme=<preset> to select a theme:
- default: Classic white background with colored elements
- classic: Traditional astrology chart look
- dark: Modern dark theme with vibrant colors
- minimal: Clean, less visual noise
- colorful: Vibrant planet colors
- nextgen: Modern design with curved aspect lines, glow effects, and gradients
- vintage: Old parchment/manuscript style with sepia tones
- neon: Cyberpunk style with bright neon colors on black
- pastel: Soft, calming pastel colors
- print: High contrast black/white optimized for printing
Optional theme overrides:
- theme.background: Background color
- theme.foreground: Text color
- theme.strokeOnly: Render stroke only (true/false)
- theme.symbolScale: Symbol scale factor
- theme.showDegrees: Show degree labels (true/false)
- theme.showHouseNumbers: Show house numbers (true/false)
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Natal Chart (PNG) - v2
Render a natal chart using the new Chart2 engine as PNG.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Transit Chart (SVG) - v2
Render a transit bi-wheel chart using the new Chart2 engine as SVG.
Required parameters:
- width, height: Chart dimensions
- dateTime: Natal date/time (YYYY-MM-DDTHH:mm)
- location.longitude, location.latitude, location.timezone: Natal location
- transit.dateTime: Transit date/time (YYYY-MM-DDTHH:mm)
Optional parameters:
- transit.timezone: Transit timezone (defaults to natal timezone)
- transit.longitude, transit.latitude: Transit location (defaults to natal location)
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Transit Chart (PNG) - v2
Render a transit bi-wheel chart using the new Chart2 engine as PNG.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Synastry Chart (SVG) - v2
Render a synastry comparison chart using the new Chart2 engine as SVG.
Required parameters:
- width, height: Chart dimensions
- person1.dateTime, person1.timezone: Person 1 birth date/time
- person1.longitude, person1.latitude: Person 1 birth location
- person2.dateTime, person2.timezone: Person 2 birth date/time
- person2.longitude, person2.latitude: Person 2 birth location
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Synastry Chart (PNG) - v2
Render a synastry comparison chart using the new Chart2 engine as PNG.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Composite Chart (SVG) - v2
Render a composite midpoint chart using the new Chart2 engine as SVG.
Required parameters:
- width, height: Chart dimensions
- person1.dateTime, person1.timezone: Person 1 birth date/time
- person1.longitude, person1.latitude: Person 1 birth location
- person2.dateTime, person2.timezone: Person 2 birth date/time
- person2.longitude, person2.latitude: Person 2 birth location
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Composite Chart (PNG) - v2
Render a composite midpoint chart using the new Chart2 engine as PNG.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Responses
Chart rendered successfully
Render Animated Transit Chart (SVG) - v2
Render an animated transit chart with CSS keyframe animations.
Required parameters:
- width, height: Chart dimensions
- dateTime: Natal date/time (YYYY-MM-DDTHH:mm)
- location.longitude, location.latitude, location.timezone: Natal location
- transit.dateTime: Start transit date/time
- target.dateTime: End transit date/time (animation target)
- animation.duration: Animation duration in milliseconds
Optional parameters:
- animation.easing: Easing function (linear, easeIn, easeOut, easeInOut, bounce)
- animation.loop: Loop animation (true/false)
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
"linear""easeIn""easeOut""easeInOut""bounce"Responses
Animated chart rendered successfully
Create Organization
Create a new organization with Stripe billing setup.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Create organization
List Members
Get a paginated list of organization members.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
List organization users
Add Member
Add or invite a new member to the organization.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Member toegevoegd/uitgenodigd
Remove Member
Update Member
Update an organization member's role.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
1Request Body
Responses
Member geüpdatet
Get Overage Setting
Get the current overage billing setting for the organization.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
Overage setting
Toggle Overage Billing
Enable or disable overage billing for the current organization.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Overage setting updated
Choose Language
Gold plan users choose their one extra language.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Language updated
Get Pinned API Version
Get the API compatibility date this organization is pinned to. A null pin means requests without an X-Api-Version header get the baseline version.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
Pinned API version
Pin API Version
Pin the organization to an API compatibility date, or send null to fall back to the baseline version.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Pinned API version updated
List Modules
Get all available modules with pricing information.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
List all available modules
Organization Modules
Get the list of modules the current organization has access to.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
List modules for current organization
Subscription Plans
Get all available subscription plans with included modules and pricing.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
List all subscription plans
Check Module Access
Check if the current organization has access to a specific module.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Check module access
List Available Modules
Get all available modules with pricing information. No authentication required.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
List of all available modules
List Subscription Plans
Get all available subscription plans with included modules and pricing. No authentication required.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
List of all subscription plans
Calculate Custom Price
Calculate the total price for a custom selection of modules. No authentication required.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
Calculated price information
Get Invitation Details
Look up a pending organization invitation by id. Used by the accept-invitation page to render the form before the invitee has signed up.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Invitation details
List API Keys
Get all API keys owned by the current user.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
List of API keys
Create API Key
Create a new API key with optional permission and module restrictions.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
API key created
Available Options
Get available permissions and feature permissions for configuring API keys.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
Available options
API Key Usage Statistics
Get aggregate usage statistics across all API keys for the current user.
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
Usage statistics
Get API Key
Get details of a specific API key.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
API key details
Delete API Key
Delete an API key and revoke it. The key disappears from the API immediately; tokens already issued for it stop working within a few minutes, once the revocation list has been refreshed.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
API key deleted
Update API Key
Update an API key's settings. The key is rotated: a new key with a new id is returned once, and the previous key is revoked.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
API key updated and regenerated
Get Daily Horoscopes
Retrieve daily horoscopes for all zodiac signs for a specific date.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
"^\\d{4}-\\d{2}-\\d{2}$"Responses
Daily horoscopes for all zodiac signs
Get Weekly Horoscope Report
Retrieve weekly horoscope report for a specific zodiac sign and week.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
"^\\d{4}$""^(0[1-9]|[1-4]\\d|5[0-3])$"Responses
Weekly horoscope report
Get Yearly Horoscope Report
Retrieve yearly horoscope report for a specific zodiac sign and year.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
"^\\d{4}$"Responses
Yearly horoscope report
Get Yearly Ascendant Horoscope Report
Retrieve yearly horoscope report for a specific ascendant sign and year.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
"^\\d{4}$"Responses
Yearly ascendant horoscope report
Full Numerology Profile
Calculate a complete numerology profile including Life Path, Expression, Soul Urge, Personality, Birthday numbers, Personal Cycles, and identify Master/Karmic numbers.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Complete numerology profile
Life Path Number
Calculate the Life Path Number from birth date. This is the most important number in numerology, representing your life's purpose.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Life Path number calculation
Expression Number
Calculate the Expression (Destiny) Number from full name. This number reveals your natural talents and abilities.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Expression number calculation
Soul Urge Number
Calculate the Soul Urge (Heart's Desire) Number from vowels in the name. This number reveals your inner motivations.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Soul Urge number calculation
Personality Number
Calculate the Personality Number from consonants in the name. This number reveals how others perceive you.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Personality number calculation
Birthday Number
Calculate the Birthday Number from the day of birth. This number represents a special talent you possess.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Birthday number calculation
Personal Cycles
Calculate Personal Year, Month, and Day numbers. These reveal the current energetic influences in your life.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Personal cycles calculation
Numerology Compatibility
Calculate compatibility between two people based on their Life Path numbers.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Compatibility calculation
Human Design
Human Design Chart
Calculate a complete Human Design bodygraph chart including Type, Strategy, Authority, Profile, Definition, gate activations, channels, and centers.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Complete Human Design chart
Render Bodygraph (SVG)
Render a Human Design bodygraph chart as SVG.
Required parameters:
- dateTime: Birth date/time (YYYY-MM-DDTHH:mm, local time)
- latitude, longitude: Birth location
- timezone: IANA timezone identifier
Theme presets:
Use ?theme=<preset> to select a theme: default, dark, classic, minimal
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Birth date and time in YYYY-MM-DDTHH:mm format (local time)
Birth latitude
-9090Birth longitude
-180180IANA timezone identifier (e.g. "Europe/Amsterdam")
1002000"576"1002000"480"Theme preset: default, dark, classic, minimal
Render Design/Personality planet columns (default true)
"true"Responses
Bodygraph SVG
Render Bodygraph (PNG)
Render a Human Design bodygraph chart as PNG.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Birth date and time in YYYY-MM-DDTHH:mm format (local time)
Birth latitude
-9090Birth longitude
-180180IANA timezone identifier (e.g. "Europe/Amsterdam")
1002000"576"1002000"480"Theme preset: default, dark, classic, minimal
Render Design/Personality planet columns (default true)
"true"Responses
Bodygraph PNG
Chatbot
Operations
List Chatbots
Create Chatbot
Create a new chatbot for the organization
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Created chatbot
List Available Plugins
List Available Plugins for Organization
List chatbot plugins available to the current organization based on their subscribed modules
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
List of available plugins
Get Monthly Chatbot Usage
Get Chatbot Usage
Get Chatbot
Delete Chatbot
Update Chatbot
Update an existing chatbot
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Updated chatbot
Get Chatbot Usage Statistics
Get usage statistics for a specific chatbot in the current month
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Usage statistics
List Chat Profiles
Create Chat Profile
Create a pre-configured chat profile with birth data
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Created profile
Delete Chat Profile
Chat with Chatbot
Send a message to a chatbot and receive a streaming response via SSE
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
SSE stream with chat response
Chat with Profile
Send a message using a pre-configured user profile
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
SSE stream with chat response
Chat with Birth Data
Send a message with inline birth data (no profile needed)
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
SSE stream with chat response
Get Conversation
Retrieve conversation history
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Conversation data
Delete Conversation
Delete a conversation and its history
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Conversation deleted
PDF Reports
Operations
List PDF Templates
List all PDF templates available to the current organization (org-specific + global). Pagination is opt-in: pass page[size] and/or page[number] (zero-based) to receive a slice with meta.page, meta.pageSize and links.next. Without them the full list is returned.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Templates per page (default 10, max 100). Enables pagination.
1100Zero-based page number (default 0). Enables pagination.
0Responses
List of PDF templates
Create PDF Template
Create a new PDF template for the organization. Global admins can pass isGlobal: true to create a global template shared by all organizations.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Created PDF template
List Global PDF Templates
List all global (shared) PDF templates
Authorizations
API key for authentication. Get your API key from the dashboard.
Responses
List of global PDF templates
Get PDF Template
Get a specific PDF template by ID
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
PDF template details
Delete PDF Template
Delete a PDF template. Global templates can only be deleted by global admins.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Template deleted
Update PDF Template
Update an existing PDF template. The report type is fixed after creation. Global templates can only be updated by global admins.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Updated PDF template
Duplicate PDF Template
Duplicate a template (global or own) to the organization
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Duplicated PDF template
Set Default PDF Template
Set a template as the default for its report type within the organization. Global admins can also set a global template as the global default.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Responses
Template set as default
Generate PDF Report
Generate a PDF report based on astrology calculations. transitDate (alias: targetDate) selects the date for transit, return and progression reports.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Generated PDF file
Preview PDF Template
Preview a PDF template as HTML with sample data. Pass either templateId for a saved template or draft for an unsaved one (exactly one of the two).
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
HTML preview
List Widgets
Create Widget
Create a new embeddable widget with auto-generated API key
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Created widget with API key
Get Widget Options
Get Widget
Delete Widget
Update Widget
Update an existing widget configuration
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Updated widget
Regenerate API Key
Widget API
Operations
Get Widget Configuration
Calculate Natal Chart
Calculate natal chart via embedded widget
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Natal chart data
Calculate Synastry Chart
Calculate synastry chart via embedded widget
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Synastry chart data
Calculate Transit Chart
Calculate transit chart via embedded widget
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Transit chart data
Calculate Composite Chart
Calculate composite chart via embedded widget
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Composite chart data
Get Moon Phase
Get moon phase information via embedded widget
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Moon phase data
Get Daily Horoscope
Get daily horoscope for a zodiac sign via embedded widget
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Daily horoscope data
Calculate Numerology
Calculate numerology profile via embedded widget
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Numerology data
Calculate Compatibility
Calculate numerology-based compatibility via embedded widget
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Compatibility data
Get Moon Calendar
Get moon phase data for a full month via embedded widget
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Moon calendar data
Chart as Sound
Render a birth chart as audio for an embedded player.
Answers with a signed audio URL and the time axis of the piece, not with bytes — the widget
puts the URL in an <audio src> and the browser fetches it without any header. That keeps
the embed to one counted request and keeps the mapping, which is the part worth protecting,
out of the page entirely.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
Signed audio URL and marker timeline
Search Places
Search for places by name via embedded widget. Returns coordinates and timezone.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Query Parameters
2100Responses
List of matching places
Get Widget Configuration
Widget Chat
Send a message via widget (SSE streaming response)
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
SSE stream with chat response
Widget Chat with User Profile
Chat using an external user ID (creates profile on first use)
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Path Parameters
Request Body
Responses
SSE stream with chat response
Search Places
Search for cities, towns, and places by name. Returns coordinates and location details for use with calculation endpoints.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
2100Responses
List of matching places with coordinates
Render Astrocartography Map (SVG)
Render an astrocartography world map showing planetary lines for a birth moment.
Each line shows where a planet is angular (conjunct an angle) at that moment:
- MC lines (solid vertical): Where the planet culminates (on the Midheaven)
- IC lines (dashed vertical): Where the planet is at the lowest point (Imum Coeli)
- ASC lines (solid curved): Where the planet is rising (on the Ascendant)
- DSC lines (dashed curved): Where the planet is setting (on the Descendant)
Required parameters:
- dateTime: Birth date/time (YYYY-MM-DDTHH:mm)
- location.longitude, location.latitude, location.timezone: Birth location
Optional parameters:
- width, height: Map dimensions (default: 1200x600)
- projection: Map projection (equirectangular, naturalEarth1, mercator)
- showLabels, showLegend, showGraticule: Toggle map features (true/false)
- backgroundColor, landColor, oceanColor, borderColor, graticuleColor: Custom colors (hex)
- lineWidth: Line thickness in pixels
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Birth date/time (YYYY-MM-DDTHH:mm)
Birth longitude in decimal degrees
Birth latitude in decimal degrees
IANA timezone identifier
Map width in pixels
"1200"Map height in pixels
"600"Map projection type
"equirectangular""naturalEarth1""mercator""equirectangular"Show planet line labels
"true"Show planet legend
"true"Show grid lines
"true"Background color (hex)
Land color (hex)
Ocean color (hex)
Country border color (hex)
Graticule grid line color (hex)
Line width in pixels
Responses
Astrocartography map rendered successfully
Render Astrocartography Map (PNG)
Render an astrocartography world map showing planetary lines for a birth moment.
Each line shows where a planet is angular (conjunct an angle) at that moment:
- MC lines (solid vertical): Where the planet culminates (on the Midheaven)
- IC lines (dashed vertical): Where the planet is at the lowest point (Imum Coeli)
- ASC lines (solid curved): Where the planet is rising (on the Ascendant)
- DSC lines (dashed curved): Where the planet is setting (on the Descendant)
Required parameters:
- dateTime: Birth date/time (YYYY-MM-DDTHH:mm)
- location.longitude, location.latitude, location.timezone: Birth location
Optional parameters:
- width, height: Map dimensions (default: 1200x600)
- projection: Map projection (equirectangular, naturalEarth1, mercator)
- showLabels, showLegend, showGraticule: Toggle map features (true/false)
- backgroundColor, landColor, oceanColor, borderColor, graticuleColor: Custom colors (hex)
- lineWidth: Line thickness in pixels
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Birth date/time (YYYY-MM-DDTHH:mm)
Birth longitude in decimal degrees
Birth latitude in decimal degrees
IANA timezone identifier
Map width in pixels
"1200"Map height in pixels
"600"Map projection type
"equirectangular""naturalEarth1""mercator""equirectangular"Show planet line labels
"true"Show planet legend
"true"Show grid lines
"true"Background color (hex)
Land color (hex)
Ocean color (hex)
Country border color (hex)
Graticule grid line color (hex)
Line width in pixels
Responses
Astrocartography map rendered successfully
Calculate Astrocartography Lines (JSON)
Calculate astrocartography line data without rendering.
Returns the raw line coordinates for each planet and angle type,
useful for custom rendering or integration with mapping libraries.
Required parameters:
- dateTime: Birth date/time (YYYY-MM-DDTHH:mm)
- location.longitude, location.latitude, location.timezone: Birth location
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
Birth date/time (YYYY-MM-DDTHH:mm)
Birth longitude in decimal degrees
Birth latitude in decimal degrees
IANA timezone identifier
Map width in pixels
"1200"Map height in pixels
"600"Map projection type
"equirectangular""naturalEarth1""mercator""equirectangular"Show planet line labels
"true"Show planet legend
"true"Show grid lines
"true"Background color (hex)
Land color (hex)
Ocean color (hex)
Country border color (hex)
Graticule grid line color (hex)
Line width in pixels
Responses
Astrocartography lines calculated successfully
Natal Chart as Sound (signed URL)
The same audio as the POST, addressable from an <audio src>.
The URL carries an HMAC over its path and query plus an expiry, so it needs no API key header
— which is the only way this works inside a widget, an email or a page the caller does not
control. Mint one with /api/sound/natal/timeline.
Authorizations
API key for authentication. Get your API key from the dashboard.
Parameters
Query Parameters
"^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}$"Responses
The chart, rendered
Natal Chart as Sound
A birth chart rendered as sound.
The chart is turned into a score by a deterministic procedure and synthesised server-side.
What comes back is audio, 45 seconds by default, walking the chart once
from the Ascendant.
It is deterministic. The same birth moment always produces the same file, and no model is
involved at any point.
profile picks how it is rendered: kepler (default) or aurora, a warmer version of
the same chart. length is full (default) or short, and skipSilence cuts the
passages where nothing sounds — the piece is then shorter than the length you asked for.
The sound is not a contract: a better mapping changes what this endpoint returns. The
X-Sound-Mapping response header carries the version that produced the bytes.
For a player that highlights the wheel in step with the audio, use /api/sound/natal/timeline,
which answers with a signed audio URL and the marker timeline in one call.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
The chart, rendered
Natal Sound: player payload
Everything a player needs in one call: a signed URL an <audio> element can load without headers, and the time axis of the piece.
The markers say when each point sounds and which aspects sound with it — enough to light up
a wheel in step with the audio, and deliberately not enough to reconstruct the mapping. No
frequencies, levels, timbres or ratios appear here.
One counted request, not two: the audio URL is signed, so fetching the bytes is free.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Signed audio URL and marker timeline
Transits as Sound
A period of transits over a birth chart, as one piece.
The natal chart is a chord held underneath; every contact a transiting body makes enters wide,
closes to a pure interval on the day it is exact, and opens again. A year becomes a couple of
minutes in which the tension arc of the year is the tension arc of the piece.
One calculation and one render, whatever the length of the period — not one per day. The piece
is capped at 300 seconds and costs a single request, the same as any
other calculation.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
The period, rendered
Legacy
Operations
Legacy Natal Chart
Accepts the old Bloom API request format and returns the natal chart in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Natal chart in legacy format
Legacy Synastry
Accepts the old Bloom API request format and returns the synastry aspects in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Synastry in legacy format
Legacy Composite Chart
Accepts the old Bloom API request format and returns the composite chart in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Composite chart in legacy format
Legacy Transits
Accepts the old Bloom API request format and returns the transits in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Transits in legacy format
Legacy Progressions
Accepts the old Bloom API request format and returns the progressions in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Progressions in legacy format
Legacy Solar Return
Accepts the old Bloom API request format and returns the solar return chart in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Solar return chart in legacy format
Legacy Lunar Return
Accepts the old Bloom API request format and returns the lunar return chart in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Lunar return chart in legacy format
Legacy Chinese Forecasts
Accepts the old Bloom API request format and returns the Chinese zodiac forecast in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Chinese forecast in legacy format
Legacy Compatibility
Accepts the old Bloom API request format and returns the compatibility analysis in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Compatibility analysis in legacy format
Legacy Planet in Sign
Accepts the old Bloom API request format and returns the planet-in-sign interpretation in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Planet-in-sign interpretation in legacy format
Legacy Sign to Sign
Accepts the old Bloom API request format and returns the sign-to-sign compatibility interpretation in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Sign-to-sign interpretation in legacy format
Legacy Weekly Reports
Accepts the old Bloom API request format and returns weekly horoscope reports in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Weekly reports in legacy format
Legacy Monthly Reports
Accepts the old Bloom API request format and returns monthly horoscope reports in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Monthly reports in legacy format
Legacy Yearly Reports
Accepts the old Bloom API request format and returns yearly horoscope reports in the legacy response format.
Authorizations
API key for authentication. Get your API key from the dashboard.
Request Body
Responses
Yearly reports in legacy format