HD Chart API

Human Design · BG5 · One API

Charts, bodygraphs, career decks and readings for your practice.

Send a birth date, time and place. Get the full chart, a print-ready bodygraph, a BG5 Career Design deck and a written reading for every Success Code, all from one API.

Request accessSee the API
A BG5 bodygraph with Functions, Life Aspects and conscious and unconscious activations
A bodygraph in BG5 notation, straight from /api/chart/image.
26activations per chart: 13 planets, personality and design
2notations for bodygraphs: Human Design and BG5
16BG5 Success Codes in a full reading
~4 minfor a full reading, from birth data to Markdown

Features

Everything from the birth moment to the client’s deck

Built for Human Design and BG5 practitioners, coaches and the developers who build tools for them.

Complete chart calculation

Swiss Ephemeris precision for any birth moment, from a place name or a UTC time.

  • Type, strategy, authority and profile
  • Defined centres, active channels and definition
  • Incarnation cross and the four variables
  • All 13 planets × personality and design, with gate, line and fixing

Bodygraph images

Print-quality PNG bodygraphs, ready for a slide, a report or your own app.

  • Human Design or BG5 notation (Functions, Life Aspects, Conscious/Unconscious)
  • Channels drawn as definition pipes, hanging gates shown
  • Planet columns with exaltation and detriment marks
  • Transit overlay on the natal chart

Places and time zones

Send "Bergen, Norway" and a local time. The API finds the coordinates and the historical time-zone rules for that date, summer time included.

  • Geocoding of birth places worldwide
  • Historical offsets, not today’s
  • UTC birth moment returned with every chart

Transits and composites

Compare a chart with the sky on any date, or two people with each other.

  • Transit activations and the channels they complete
  • Composite chart of two people
  • Same output shape as a natal chart

BG5 Career Design decks

A client-ready PowerPoint deck built from the chart and your own licensed BG5 toolkit templates.

  • Overview: the right template of ten, by Career Type and gender
  • Full Career Design Analysis: 111 slides
  • Functions, Shadows, Public Role and Life Work slides chosen by the chart
  • Client name, date and bodygraph filled in

Expanded readings

A written reading for every Success Code, grounded in a curated corpus of course material, delivered as clean Markdown.

  • All 16 Success Codes, or the Overview’s first six
  • A “going deeper” section per code from the Human Design corpus
  • Norwegian or English
  • Token use and cost reported per reading

Expanded readings

A reading that knows the material

Each reading is written from the client’s own chart facts and the passages of the course material that speak to them. The BG5 corpus covers the Success Codes, the 64 traits and 6 qualities, the nine Functions and the five Career Types. A second pass through the Human Design corpus adds a section that goes deeper for every code.

How it works

  1. The chart is calculated and mapped to the facts behind each Success Code.
  2. The matching passages are retrieved from the corpora.
  3. Claude writes the reading in parts, five codes at a time, in Norwegian or English.
  4. You get Markdown with the design table, all planetary activations and one section per code.

Read it beautifully

Testers read their readings one key at a time, in the colours of the BG5 decks, with the bodygraph on the cover and a button to the next Success Code.

  • #1Career Type
  • #2Personal Interaction Style
  • #3Decision-Making Strategy
  • #4Key Indicators
  • #5Assimilation
  • #6Environmental Style
  • #7–8Business Skills & Attributes
  • #9Large Business Roles
  • #10Defined Functions
  • #11Shadows & Distractions
  • #12Public Role
  • #13Life Work
  • #14General Thematics
  • #15Strengths & Contributions
  • #16Traits & Qualities

The API

Plain JSON in, chart out

Every endpoint takes a small JSON body and answers with JSON, a PNG or a PowerPoint file. Readings run as background jobs you poll until they are done. The endpoint address and your key come with your access.

POST /api/chartChart from a local birth time and place
POST /api/chart/utcChart from a UTC moment, no geocoding
POST /api/chart/imageBodygraph PNG, HD or BG5 notation, optional transit
POST /api/chart/transitNatal chart against a transit date
POST /api/chart/compositeComposite of two people
POST /api/bg5/deckBG5 Career Design deck (.pptx), Overview or Full
POST /api/readingsExpanded reading as a background job, Markdown when done
# A chart from a local birth time and place
curl -X POST $HD_API/api/chart \
  -H "X-Api-Key: $HD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birthDate":"1985-05-24T00:00","birthPlace":"Oslo, Norway"}'

# The answer, shortened
{
  "utcBirthDate": "1985-05-23T22:00:00Z",
  "location": { "timeZoneId": "Europe/Oslo" },
  "chart": {
    "type": "ManifestingGenerator",
    "authority": "Sacral",
    "profile": "3/5",
    "activeChannels": ["2-14", "10-20", …],
    "personalityActivation": [
      { "planet": "Sun", "gate": "20", "line": 3 }, …
    ]
  }
}
The same chart as a bodygraph in Human Design notation
The same chart in Human Design notation.

Early access

Try it on your own charts

We are inviting a small group of practitioners to test the readings before the API opens. Tell us a little about yourself and we will send you an invitation.

Human Design is a trademark of Jovian Archive Media, Inc. BG5 is a trademark of the BG5 Business Institute. HD Chart API is an independent service and is not affiliated with or endorsed by either. Deck generation uses BG5 toolkit templates that the practitioner is licensed to use; no template content is shown on this site.