Human Design API
This endpoint computes the Human Design bodygraph from a single birth event. It combines the natal Personality chart with the Design chart — taken roughly 88° of solar arc before birth, about three months earlier — and derives the mechanical elements of the bodygraph: Type, Strategy, Authority, Profile, Centers, Channels, Gates and the Incarnation Cross.
Human Design API
The endpoint resolves the birth moment and location into two ephemeris snapshots — the Personality chart at the moment of birth and the Design chart at the point roughly 88 degrees of solar arc earlier — then reads the planetary placements of both to assemble the bodygraph. From that pairing it determines the energetic Type, the Strategy that follows from it, the not-self theme, the decision-making Authority, the Profile, the pattern of defined versus undefined Centers, the active Channels and Gates, and the Incarnation Cross. The response returns type, strategy, notSelfTheme, authority, profile, definition and cross. Everything is computed from the raw planetary mechanics rather than copied from any descriptive corpus, so what you receive is the structural skeleton of the chart — the labels and the wiring — ready to map onto your own interpretive content.
POST/v1/human-design
curl -X POST https://api.astroway.info/v1/human-design \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52
}'{
"ok": true,
"data": {
"type": "Generator",
"strategy": "To Respond",
"notSelfTheme": "Frustration",
"authority": "Sacral",
"profile": "3/5",
"definition": "Single",
"cross": "Right Angle Cross of …"
}
}Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
When to use it
Reach for this whenever you need the mechanical foundation of a Human Design reading and want to supply the prose yourself. Compute the bodygraph once for a given birth event, persist the returned type, authority, profile and definition, and drive the rest of your product — content lookups, graphics, compatibility logic — from those stored fields rather than recomputing on every view. It is the right starting point before any deeper Human Design feature, because every downstream element references the same defined-centre and channel topology this endpoint resolves. Treat its output as durable per user: it never changes for a fixed birth event, so cache it indefinitely.
Notes
The Human Design System was synthesised by Ra Uru Hu in 1987. This endpoint computes only the mechanics from the ephemeris — Type, Centers, Channels, Gates and the rest — and deliberately does not reproduce any of the copyrighted descriptive text associated with the system; pair the structural output with your own interpretive copy. The Design chart's ~88° solar-arc offset means it falls about three months before birth, not a fixed calendar interval.
Try the Bodygraph API
Grab a key and make your first call in under a minute.