Birth Time Rectification API V1 Launch: Automated Chart Correction

What shipped

Until now, rectification was a manual, hour-intensive process that only experienced astrologers could do, and it cost clients $200-500 per chart. Our V1 endpoint takes a candidate birth date, an approximate birth time window, and a list of dated life events, and returns a scored set of candidate birth times with confidence levels.

What's in V1

• 18 distinct evaluators that score candidate times against the supplied life events
• 3 timing techniques working in parallel: secondary progressions, solar arc directions, transit hits to natal points
• Schmidt sect doctrine baked into the scoring weights (benefic/malefic determination changes by sect)
• Configurable time windows from one minute up to a full birth day
• 0-100 confidence score for each candidate time
• Sub-second scoring on default windows; full-day rectification under three seconds

Why it matters

Birth time is the single biggest source of error in any chart calculation. A wrong birth time by 4 minutes shifts the Ascendant by roughly 1 degree, which changes house cusps, which changes every house-based interpretation in the chart. Astrocartography lines move, transits to angles shift, time-lord periods recalculate. If you ship an astrology app and your users only know their birthday, you have a chart that is wrong in ways that compound.

Until V1 of this API, the only fix was to send the user to a human astrologer for a manual rectification — a friction point most apps cannot tolerate. Now you can build an in-app rectification flow that asks the user for three or four major life events (marriage, child birth, career change, major move, parent death) and returns a refined birth time inside one user session.

How to integrate

Three steps:

1const result = await fetch('https://api.astrology-api.io/v1/rectification', {
2  method: 'POST',
3  headers: { 'Authorization': `Bearer ${process.env.ASTROLOGY_API_KEY}` },
4  body: JSON.stringify({
5    birthDate: '1990-04-15',
6    timeWindowStart: '00:00',
7    timeWindowEnd: '23:59',
8    birthLat: 40.7128,
9    birthLon: -74.0060,
10    events: [
11      { date: '2018-06-10', type: 'marriage' },
12      { date: '2021-03-22', type: 'child-birth' },
13      { date: '2023-11-04', type: 'career-change' },
14    ],
15  }),
16}).then(r => r.json());
17
18// result.candidates is sorted by confidence score descending
19// result.candidates[0] is your best-guess birth time

Where to learn more

• Product page: /p/rectification-api
• Technical guide: How Birth Time Rectification Works: A Technical Guide for Developers
• Interactive demo and OpenAPI reference: /demo

Pricing

The Rectification endpoint is included on the Professional tier ($37/mo) and above. Free and Starter tier users can call it up to their general monthly request limit; it counts as a single API request regardless of the time window size.

What's next

V2 will add user-supplied event-weight overrides, optional dual-house-system scoring, and a streaming endpoint that returns intermediate candidates as the search progresses. Target ship: late 2026.