Human Design Bodygraph API
Type, authority, profile, centers, channels, gates
Included with every plan (at no extra cost)
Generate a complete Human Design bodygraph from a birth date, time, and timezone. Returns the energy type, strategy, inner authority, signature, not-self theme, profile, definition, incarnation cross, all nine centers with defined state and active gates, the defined channels, and all 26 planetary activations across the Personality and Design sides. The single endpoint for a full chart in one call, built for Human Design apps, readings, and coaching tools.
Location first, chart second
The Human Design Bodygraph API needs latitude, longitude, and timezone. Never ask users to type coordinates. Resolve a city with the Location endpoint first, then feed the result into the request. Timezone accepts a decimal offset or an IANA name.
1 Resolve the location
curl "https://roxyapi.com/api/v2/location/search?q=New York" \
-H "X-API-Key: YOUR_KEY"
# -> cities[0]: { latitude, longitude, timezone: "America/New_York" }2 Call the Human Design Bodygraph endpoint
# feed latitude, longitude and timezone from step 1
POST https://roxyapi.com/api/v2/human-design/bodygraphRequest
POST /api/v2/human-design/bodygraph
Parameters
| Parameter | Type | Description |
|---|---|---|
| langquery | string enum | Response language (BCP 47). Supported: en, tr, de, es, hi, pt, fr, ru, zh-Hans, zh-Hant. Defaults to en. Coverage varies by domain, and a field with no translation in the requested language returns English. Default en. |
Request body
| Field | Type | Description |
|---|---|---|
| date* | string (date) | Birth date in YYYY-MM-DD format. The anchor for both the Personality activations at birth and the Design activations 88 degrees of solar arc earlier. |
| time* | string (time) | Birth time in 24-hour HH:MM:SS format. Precision matters: the profile lines and gate boundaries shift with the exact minute of birth. |
| timezone* | number or string | IANA name (e.g. "America/New_York", "Europe/London", "UTC"), decimal hours (e.g. -5 for EST, 1 for CET), or a fixed UTC offset (e.g. "-05:00", "+01:00"). Prefer the IANA name: it is resolved to the offset in force at the birth date and time, historical daylight-saving rules included, while a fixed offset or decimal is taken literally and will be wrong if it does not match the daylight-saving state at that moment. On a transition day a time in the repeated hour is read as its first occurrence and a time in the skipped hour is moved forward past the gap. Invalid timezones return 400 with a validation error. |
| latitude | number | Birth latitude in decimal degrees. Optional and does not affect the bodygraph, which depends only on ecliptic longitudes. Defaults to 0. |
| longitude | number | Birth longitude in decimal degrees. Optional and does not affect the bodygraph. Defaults to 0. |
| nodeType | string enum | Lunar node convention. "mean" is the smoothed average node, which always moves retrograde; "true" is the osculating node, which tracks the real perturbed node, oscillates up to about 1.5 degrees either side of the mean on a 173-day cycle, and can briefly turn direct. Neither is more correct and they almost always fall in the same sign. Applies to the North and South Node activations. True is what professional Human Design software uses (HumanDesign.ai, Total Human Design) and is the value RoxyAPI verifies against, so leave it unset for a standard chart. It matters only when a node sits on a gate boundary, where the choice moves a node gate. Because a gate can be half of a channel, that can change the completed channels and, with them, whether a center reads defined or open, plus the definition, authority, profile or type. A chart where only one center disagrees is the usual shape, since the type and profile often survive unchanged. If another calculator disagrees on any of those, it is almost certainly using the mean node: pass "mean" to match it. Defaults to "true". |
Example request
{
"date": "1990-07-15",
"time": "13:00:00",
"timezone": "America/New_York",
"latitude": 0,
"longitude": 0,
"nodeType": "true"
}Response
Structured JSON with documented fields, covered by 13,405 automated tests per deploy, 3,620 of them gold-standard tests verified against NASA JPL Horizons. Not hallucinated text.
{
"type": "Projector",
"typeDescription": "A focused, penetrating aura that reads and guides others. Recognition and a genuine invitation are the keys to being seen and succeeding.",
"aura": "Focused and absorbing. The field penetrates deeply into one other person at a time and takes in how they work, which is why the attention feels intense and why recognition arrives unevenly.",
"strategy": "Wait for the invitation",
"strategyDescription": "Wait to be recognized and genuinely invited into the things that matter: relationships, career, and major commitments. Guidance offered without an invitation is not absorbed, and that wasted insight is what sours into bitterness.",
"authority": "Emotional",
"authorityDescription": "Decisions are made across an emotional wave rather than inside a moment. The defined Solar Plexus moves on its own rhythm between hope and pain, so no single moment carries the truth: clarity is what remains once the wave has run its course and settled toward neutral. The trap is committing at the peak, where enthusiasm reads as certainty, or at the trough, where gloom reads as insight, and treating any pressure to answer now as a reason to skip the wait.",
"signature": "Success",
"notSelf": "Bitterness",
"profile": "3/5",
"profileKeynotes": {
"personalityLine": 3,
"designLine": 5,
"personality": "Martyr: learns through trial and error, discovering what does not work.",
"design": "Heretic: a universalizing, practical force others project expectations onto."
},
"profileDescription": "Martyr over Heretic. Conscious experimentation learns by collision, discovering what fails, and the unconscious fifth line turns that hard-won knowledge into practical solutions others project onto in advance. The competence is real, the expectations attached to it usually are not, so this role is trusted while it delivers and blamed the moment a projection breaks.",
"definition": "Split",
"definitionDescription": "The defined centers fall into two groups with no channel between them, so energy is consistent inside each group and does not cross the divide. The gap is bridged by the gates other people carry, which is why particular company can make thinking suddenly feel joined up, and why that company is easily mistaken for completion rather than recognized as a temporary bridge. What the configuration needs is time for the two areas to synthesize and awareness of who is bridging them, not a rushed decision taken while the halves are still speaking separately.",
"sides": {
"personality": "The conscious side, printed in black and calculated at the moment of birth. These activations are the mind and the sense of self: what the person recognizes as their own and can describe to someone else.",
"design": "The unconscious side, printed in red and calculated 88 degrees of solar arc before birth, roughly three months earlier. These activations run the body and are visible to other people long before the mind admits them."
},
"designInstantUtc": "1990-04-15T04:21:27.761Z",
"incarnationCross": {
"gates": [
62,
61,
42,
32
],
"angle": "Right Angle",
"angleCode": "RAX",
"name": "Right Angle Cross of Maya 2",
"description": "A memory for small facts and a compulsion to share them. The detail is a real contribution to work that depends on precision, and a burden to a listener who did not ask for it."
},
"centers": [
{
"id": "head",
"name": "Head",
"defined": false,
"motor": false,
"awareness": false,
"theme": "Amplifies the questions and mental pressure of others. Learns not to act on every inspiration that arrives.",
"notSelfQuestion": "Is this question worth answering, and is it even mine? The open Head amplifies the mental pressure of others and spends itself resolving questions that do not matter to it.",
"biology": "The pineal gland. Its melatonin secretion governs the sleep and wake cycle, and in the bodygraph this gland is the source of the pressure to think.",
"gates": [
61
]
},
{
"id": "ajna",
"name": "Ajna",
"defined": false,
"motor": false,
"awareness": true,
"theme": "Open mindedness and flexible thinking. Wisdom comes from holding many viewpoints without fixing on one belief.",
"notSelfQuestion": "Is this certainty real, or is it a fixed opinion held in order to feel safe? The open Ajna pretends to be sure and defends beliefs it does not actually hold.",
"biology": "The pituitary gland, anterior and posterior. This master endocrine gland directs the other glands, and in the bodygraph it carries conceptual processing and mental awareness.",
"gates": []
},
{
"id": "throat",
"name": "Throat",
"defined": true,
"motor": false,
"awareness": false,
"theme": "Consistent expression and the ability to manifest through speech and action when connected to a motor.",
"notSelfQuestion": "Is all this talking and doing an attempt to attract attention? The open Throat fills the silence and stays busy to be noticed, rather than waiting to be recognized and asked.",
"biology": "The thyroid and parathyroid glands. Thyroid hormones set the metabolic rate and the parathyroids regulate calcium, and in the bodygraph this pair governs the timing of speech and action.",
"gates": [
12,
31,
62
]
},
{
"id": "g",
"name": "G Center",
"defined": true,
"motor": false,
"awareness": false,
"theme": "A fixed sense of identity, direction, and love. A consistent orientation in life regardless of environment.",
"notSelfQuestion": "Are love and a direction being hunted from the outside? The open G borrows an identity from whoever is present and mistakes the searching itself for a destination.",
"biology": "The liver and the blood. The liver processes nutrients and regulates what the blood carries, and in the bodygraph it holds identity, direction, and love.",
"gates": [
1,
2,
7,
13
]
},
{
"id": "heart",
"name": "Heart",
"defined": false,
"motor": true,
"awareness": false,
"theme": "Inconsistent willpower. Learns there is nothing to prove and avoids overcommitting to win approval.",
"notSelfQuestion": "Is there something to prove here? The open Heart overcommits and makes promises that inconsistent willpower cannot keep, then reads the broken promise as proof of low worth.",
"biology": "The heart, stomach, gallbladder, and thymus gland. This cluster drives circulation, digestion, and immune maturation, and in the bodygraph it fuels willpower and the pursuit of value.",
"gates": [
26
]
},
{
"id": "sacral",
"name": "Sacral",
"defined": false,
"motor": true,
"awareness": false,
"theme": "No consistent access to work energy. Learns when enough is enough rather than driving to exhaustion.",
"notSelfQuestion": "Is enough ever enough? The open Sacral amplifies life force that is not its own and keeps working past its limit until exhaustion finally forces the stop.",
"biology": "The ovaries and the testes. These gonads produce the sex hormones behind fertility and vitality, and in the bodygraph they supply the life force that powers work.",
"gates": [
27,
42
]
},
{
"id": "solar-plexus",
"name": "Solar Plexus",
"defined": true,
"motor": true,
"awareness": true,
"theme": "An emotional wave that moves through highs and lows over time. Clarity arrives through the wave, never in the moment.",
"notSelfQuestion": "Is the truth being avoided in order to keep the peace? The open Solar Plexus absorbs and magnifies the emotion in the room, then dodges confrontation to make the discomfort stop.",
"biology": "The kidneys, the pancreas, and the nervous system. These regulate fluid balance, blood sugar, and nerve signaling, and in the bodygraph they carry the chemistry of the emotional wave.",
"gates": [
30,
37
]
},
{
"id": "spleen",
"name": "Spleen",
"defined": false,
"motor": false,
"awareness": true,
"theme": "Heightened sensitivity to wellbeing and fear. Learns to trust intuition without clinging to what feels unsafe.",
"notSelfQuestion": "Is something unhealthy being held on to out of fear? The open Spleen clings to people, work, and habits well past their time, because letting go registers as a threat to survival.",
"biology": "The spleen, the lymphatic system, and immune function. They filter the blood and mount the immune response, and in the bodygraph this is the oldest awareness, tracking health, timing, and survival.",
"gates": [
32
]
},
{
"id": "root",
"name": "Root",
"defined": true,
"motor": true,
"awareness": false,
"theme": "A consistent way of handling pressure and stress. A steady drive to get things done and move forward.",
"notSelfQuestion": "Is this hurry an attempt to be free of pressure? The open Root rushes to finish in order to escape a pressure it amplified from others, and the relief it is chasing never arrives.",
"biology": "The adrenal glands. They secrete adrenaline and cortisol to drive the stress response, and in the bodygraph they supply the pressure and the fuel to get things moving.",
"gates": [
38,
41,
52,
58
]
}
],
"channels": [
{
"gateA": 7,
"gateB": 31,
"name": "The Alpha",
"circuit": "Collective",
"centers": [
"g",
"throat"
],
"description": "Direction held in the G Center reaches the Throat as the voice of leadership. The authority is granted rather than taken, so the guidance only works once the group has chosen to be led.",
"circuitDescription": "Sharing for the species, carried by 14 channels. Pattern and experience are worked into something transmissible: the logical half tests patterns and projects them forward, the abstract half harvests wisdom from experience already lived."
},
{
"gateA": 41,
"gateB": 30,
"name": "Recognition",
"circuit": "Collective",
"centers": [
"root",
"solar-plexus"
],
"description": "Root contraction concentrates desire in the Solar Plexus. Fantasy about an experience not yet had provides the fuel that starts the whole collective cycle of experience.",
"circuitDescription": "Sharing for the species, carried by 14 channels. Pattern and experience are worked into something transmissible: the logical half tests patterns and projects them forward, the abstract half harvests wisdom from experience already lived."
}
],
"gates": [
{
"planet": "Sun",
"side": "personality",
"gate": 62,
"line": 3,
"gateName": "Detail",
"gateDescription": "The throat gate that names things. It sorts facts, labels, and details into practical language, giving the opinions of gate 17 something concrete to stand on.",
"lineMeaning": "Facts stated, corrected, and stated again. Every detail that turned out wrong sharpens the next one, and boredom with the small thing is what causes the miss.",
"planetDescription": "The dominant activation. With the Earth it carries roughly 70 percent of the imprint on the chart. The Personality Sun gate is the conscious life theme, the Design Sun is the radiance the body broadcasts before a word is spoken.",
"ichingHexagram": {
"number": 62,
"english": "Preponderance of the Small"
}
},
{
"planet": "Earth",
"side": "personality",
"gate": 61,
"line": 3,
"gateName": "Mystery",
"gateDescription": "Head pressure to know the unknowable. Inspiration arrives as a why with no answer attached, and the design is to sit with the question rather than solve it.",
"lineMeaning": "The unknowable is approached again and again, and most approaches fail. What is learned is that inner truth cannot be carried alone and cannot be argued into anyone.",
"planetDescription": "Always the wheel-opposite of the Sun, so it is derived rather than observed. It grounds whatever the Sun expresses, and the two Suns plus the two Earths fix the four gates of the incarnation cross.",
"ichingHexagram": {
"number": 61,
"english": "Inner Truth"
}
},
{
"planet": "Moon",
"side": "personality",
"gate": 42,
"line": 6,
"gateName": "Growth",
"gateDescription": "Sacral energy for carrying a cycle through to completion. Endings are the difficult part, and cycles left unfinished are where this gate leaks its power.",
"lineMeaning": "Wisdom that has seen enough cycles through to guide other people across theirs. Withholding what those completions taught is the one way this gate wastes them.",
"planetDescription": "The fastest body on the wheel, crossing it in about 28 days. It carries drive and the ongoing motion of the form, and it sets the timing for Lunar authority, which needs a full cycle before clarity arrives.",
"ichingHexagram": {
"number": 42,
"english": "Increase"
}
},
{
"planet": "North Node",
"side": "personality",
"gate": 41,
"line": 6,
"gateName": "Contraction",
"gateDescription": "Root pressure that starts the experiential cycle. Energy contracts into a hunger for a feeling not yet had, which is the fantasy gate 30 then sets out to pursue.",
"lineMeaning": "Wisdom in which the feeling pursued to its end spills over to everyone nearby. Guarding that breakthrough as a private advantage is the one thing that keeps it from carrying.",
"planetDescription": "Geometry rather than personality. It marks the direction life turns toward in the second half, after the midlife transition, and on the Design side it names the environment in which the form is seen correctly.",
"ichingHexagram": {
"number": 41,
"english": "Decrease"
}
},
{
"planet": "South Node",
"side": "personality",
"gate": 31,
"line": 6,
"gateName": "Leading",
"gateDescription": "The voice that says I lead. Democratic by nature, so the leadership is real only when the group recognizes it, and only when it carries the direction of gate 7 behind it.",
"lineMeaning": "Influence is carried by the life rather than the argument. Intellectual comment changes nothing, so the example becomes the teaching and dogma is the one thing to avoid.",
"planetDescription": "The familiar geometry of the first half of life, the ground the person operates from before the midlife turn. On the Design side it names the environment the body already knows and returns to by default.",
"ichingHexagram": {
"number": 31,
"english": "Influence (Wooing)"
}
},
{
"planet": "Mercury",
"side": "personality",
"gate": 31,
"line": 6,
"gateName": "Leading",
"gateDescription": "The voice that says I lead. Democratic by nature, so the leadership is real only when the group recognizes it, and only when it carries the direction of gate 7 behind it.",
"lineMeaning": "Influence is carried by the life rather than the argument. Intellectual comment changes nothing, so the example becomes the teaching and dogma is the one thing to avoid.",
"planetDescription": "The communication imprint. The Personality Mercury gate is the message the person is here to deliver, the Design Mercury gate is how that expression actually sounds to everyone else.",
"ichingHexagram": {
"number": 31,
"english": "Influence (Wooing)"
}
},
{
"planet": "Venus",
"side": "personality",
"gate": 12,
"line": 3,
"gateName": "Caution",
"gateDescription": "The throat gate of moody, articulate expression. Standing between the emotional wave and the voice, it can speak with rare artistry when the mood is right and does better staying silent when it is not.",
"lineMeaning": "The voice finds itself by admitting what is inadequate in it, and the honesty is genuinely purging. Left to run, the same process turns into self-recrimination that nothing can talk down.",
"planetDescription": "Values and the moral floor under behavior. Personality Venus is what is consciously held dear, Design Venus is the standard the body applies without ever being consulted.",
"ichingHexagram": {
"number": 12,
"english": "Standstill (Stagnation)"
}
},
{
"planet": "Mars",
"side": "personality",
"gate": 27,
"line": 1,
"gateName": "Caring",
"gateDescription": "Sacral energy for nourishing and protecting others. It is tribal, aimed at family and group rather than at humanity, and without limits it turns into overextension.",
"lineMeaning": "Care begins with the body that provides it. Putting the needs of others first without a foundation of self nourishment is the fastest route to being taken for granted.",
"planetDescription": "Immature energy: raw drive that has not yet learned its own timing. It shows where action gets forced before it is ripe, and it only matures when strategy and authority are running the decision.",
"ichingHexagram": {
"number": 27,
"english": "The Corners of the Mouth (Providing Nourishment)"
}
},
{
"planet": "Jupiter",
"side": "personality",
"gate": 62,
"line": 2,
"gateName": "Detail",
"gateDescription": "The throat gate that names things. It sorts facts, labels, and details into practical language, giving the opinions of gate 17 something concrete to stand on.",
"lineMeaning": "A natural gift for the exact word. The naming costs nothing when it is asked for, and being bound to inherited terminology is what makes this line restless.",
"planetDescription": "Expansion, and the law that rewards living correctly. Personality Jupiter marks where growth and abundance gather, Design Jupiter marks the protection the form receives while it stays aligned.",
"ichingHexagram": {
"number": 62,
"english": "Preponderance of the Small"
}
},
{
"planet": "Saturn",
"side": "personality",
"gate": 61,
"line": 2,
"gateName": "Mystery",
"gateDescription": "Head pressure to know the unknowable. Inspiration arrives as a why with no answer attached, and the design is to sit with the question rather than solve it.",
"lineMeaning": "Inspiration that arrives unbidden and lands whole. The brilliance is genuine when it is drawn out, and it sours the moment it starts working for recognition.",
"planetDescription": "Discipline through restriction, the corrective imprint. It is where consequences arrive when the design is not honored, and its returns near ages 29 and 58 are when that account gets settled.",
"ichingHexagram": {
"number": 61,
"english": "Inner Truth"
}
},
{
"planet": "Uranus",
"side": "personality",
"gate": 58,
"line": 4,
"gateName": "Vitality",
"gateDescription": "Root energy pushing for joy and improvement. The zest for life is the fuel behind correction, and when it is blocked the vitality sours into bitterness.",
"lineMeaning": "Vitality aimed at what the network wants corrected. It can pick the single influence worth backing, and it drains itself trying to back all of them at once.",
"planetDescription": "The unusual and the abrupt. It carries individuality and unexpected change, and its opposition near age 40 is the midlife pressure to live as oneself instead of as the conditioning.",
"ichingHexagram": {
"number": 58,
"english": "The Joyous, Lake"
}
},
{
"planet": "Neptune",
"side": "personality",
"gate": 38,
"line": 4,
"gateName": "The Fighter",
"gateDescription": "Root pressure to fight for what has meaning. The struggle itself is the design, but it only builds wisdom when the cause is genuinely worth it, otherwise it becomes opposition for its own sake.",
"lineMeaning": "The fight strengthened by knowing exactly who in the circle can be trusted with it. Aggression that skips the investigation destroys the very trust the struggle depends on.",
"planetDescription": "The veil. It carries spiritual perception and the capacity for illusion in equal measure, so whatever it activates is rarely seen plainly, by the person or by anyone watching.",
"ichingHexagram": {
"number": 38,
"english": "Opposition"
}
},
{
"planet": "Pluto",
"side": "personality",
"gate": 1,
"line": 2,
"gateName": "Self Expression",
"gateDescription": "Creative individuality looking for form. Sitting in the G center, it supplies the raw originality that gate 8 carries to the throat, where it becomes a contribution others can see.",
"lineMeaning": "A natural creative beauty that others notice and reach for. The work stays true while it follows its own values, and it distorts when ambition or appetite is loaded onto it.",
"planetDescription": "Truth through transformation. It exposes what was hidden and forces the psychological change that follows, working generationally and slowly rather than personally and quickly.",
"ichingHexagram": {
"number": 1,
"english": "The Creative"
}
},
{
"planet": "Sun",
"side": "design",
"gate": 42,
"line": 5,
"gateName": "Growth",
"gateDescription": "Sacral energy for carrying a cycle through to completion. Endings are the difficult part, and cycles left unfinished are where this gate leaks its power.",
"lineMeaning": "Others come to rely on the growth this gate produces, and influence follows the completion rather than being pursued. Turned entirely inward it becomes growth nobody else can reach.",
"planetDescription": "The dominant activation. With the Earth it carries roughly 70 percent of the imprint on the chart. The Personality Sun gate is the conscious life theme, the Design Sun is the radiance the body broadcasts before a word is spoken.",
"ichingHexagram": {
"number": 42,
"english": "Increase"
}
},
{
"planet": "Earth",
"side": "design",
"gate": 32,
"line": 5,
"gateName": "Continuity",
"gateDescription": "Instinctive judgment of what holds lasting value and what will fail. The fear of failure is the engine, which makes this gate conservative about which transformations deserve support.",
"lineMeaning": "Stability is expected here and the need for security is projected onto it. Impatience with the pace of change makes it inventive, and sometimes it forces what should have ripened.",
"planetDescription": "Always the wheel-opposite of the Sun, so it is derived rather than observed. It grounds whatever the Sun expresses, and the two Suns plus the two Earths fix the four gates of the incarnation cross.",
"ichingHexagram": {
"number": 32,
"english": "Duration"
}
},
{
"planet": "Moon",
"side": "design",
"gate": 26,
"line": 4,
"gateName": "The Egoist",
"gateDescription": "Willpower used to sell, persuade, and transmit. It compresses memory and experience into a pitch, and the integrity of this gate rests entirely on whether that pitch is true.",
"lineMeaning": "The persuasive gift moves almost anything through the network. That is exactly why what is being sold has to be honorable, since the same skill sells the worthless.",
"planetDescription": "The fastest body on the wheel, crossing it in about 28 days. It carries drive and the ongoing motion of the form, and it sets the timing for Lunar authority, which needs a full cycle before clarity arrives.",
"ichingHexagram": {
"number": 26,
"english": "The Taming Power of the Great"
}
},
{
"planet": "North Node",
"side": "design",
"gate": 13,
"line": 1,
"gateName": "The Listener",
"gateDescription": "The receiver of the secrets and stories of others. Sitting in the G center, it gathers the past of the collective and passes it to gate 33 to be retold as wisdom.",
"lineMeaning": "People confide here because the listening carries affection rather than judgment. The foundation is genuine openness, and it draws in far more of the past than was ever asked for.",
"planetDescription": "Geometry rather than personality. It marks the direction life turns toward in the second half, after the midlife transition, and on the Design side it names the environment in which the form is seen correctly.",
"ichingHexagram": {
"number": 13,
"english": "Fellowship with Men"
}
},
{
"planet": "South Node",
"side": "design",
"gate": 7,
"line": 1,
"gateName": "The Role of the Self",
"gateDescription": "Direction offered in service of leadership. Sitting in the G center, it holds the way forward that the voice of gate 31 speaks, and it works best beside the leader rather than in front.",
"lineMeaning": "The foundation of leadership is a firm hand and a settled rule, which steadies a group that cannot steady itself. It curdles into an intellect convinced that only it can possibly know best.",
"planetDescription": "The familiar geometry of the first half of life, the ground the person operates from before the midlife turn. On the Design side it names the environment the body already knows and returns to by default.",
"ichingHexagram": {
"number": 7,
"english": "The Army"
}
},
{
"planet": "Mercury",
"side": "design",
"gate": 2,
"line": 2,
"gateName": "The Direction of the Self",
"gateDescription": "The receptive keeper of direction. Sitting in the G center, it knows where life should go but holds no fuel for the journey, so it draws on the sacral power of gate 14 to move.",
"lineMeaning": "A natural alignment with the right direction that cannot be explained from inside and is obvious from outside. It curdles when the praise is believed and the knowing is claimed as an achievement.",
"planetDescription": "The communication imprint. The Personality Mercury gate is the message the person is here to deliver, the Design Mercury gate is how that expression actually sounds to everyone else.",
"ichingHexagram": {
"number": 2,
"english": "The Receptive"
}
},
{
"planet": "Venus",
"side": "design",
"gate": 37,
"line": 4,
"gateName": "Friendship",
"gateDescription": "The emotional warmth that holds a family or a community together. Bargains, roles, and loyalty are its currency, and it needs the will of gate 40 to keep those bargains honest.",
"lineMeaning": "Influence in the family earned by conduct rather than title. The network follows the example set here, unless deference to tradition blinds it to who is genuinely leading.",
"planetDescription": "Values and the moral floor under behavior. Personality Venus is what is consciously held dear, Design Venus is the standard the body applies without ever being consulted.",
"ichingHexagram": {
"number": 37,
"english": "The Family (The Clan)"
}
},
{
"planet": "Mars",
"side": "design",
"gate": 30,
"line": 2,
"gateName": "Feelings",
"gateDescription": "The emotional fire of desire and expectation. Sitting in the solar plexus, it burns to have the experience it imagines, and the experience rarely arrives shaped like the fantasy.",
"lineMeaning": "The middle of the wave is found naturally. Extremes of feeling are moderated without being suppressed, and expression stays measured while the fire underneath keeps burning.",
"planetDescription": "Immature energy: raw drive that has not yet learned its own timing. It shows where action gets forced before it is ripe, and it only matures when strategy and authority are running the decision.",
"ichingHexagram": {
"number": 30,
"english": "The Clinging, Fire"
}
},
{
"planet": "Jupiter",
"side": "design",
"gate": 52,
"line": 1,
"gateName": "Stillness",
"gateDescription": "Root pressure to be still. The inaction is not laziness. It is the stillness that turns the focus of gate 9 into sustained concentration.",
"lineMeaning": "Stillness is grounded by understanding why it is needed. Root pressure is held rather than discharged, and the pause is what turns raw focus into something that can be sustained.",
"planetDescription": "Expansion, and the law that rewards living correctly. Personality Jupiter marks where growth and abundance gather, Design Jupiter marks the protection the form receives while it stays aligned.",
"ichingHexagram": {
"number": 52,
"english": "Keeping Still, Mountain"
}
},
{
"planet": "Saturn",
"side": "design",
"gate": 61,
"line": 5,
"gateName": "Mystery",
"gateDescription": "Head pressure to know the unknowable. Inspiration arrives as a why with no answer attached, and the design is to sit with the question rather than solve it.",
"lineMeaning": "Others project revelation onto this line. Its inspiration can reach a generation, and demanding that the insight be accepted turns a wisdom figure into a preacher.",
"planetDescription": "Discipline through restriction, the corrective imprint. It is where consequences arrive when the design is not honored, and its returns near ages 29 and 58 are when that account gets settled.",
"ichingHexagram": {
"number": 61,
"english": "Inner Truth"
}
},
{
"planet": "Uranus",
"side": "design",
"gate": 38,
"line": 1,
"gateName": "The Fighter",
"gateDescription": "Root pressure to fight for what has meaning. The struggle itself is the design, but it only builds wisdom when the cause is genuinely worth it, otherwise it becomes opposition for its own sake.",
"lineMeaning": "Foundation: knowing which fight is worth the adrenaline before entering it. Struggle chosen by instinct builds meaning, and struggle entered as a reflex simply burns the energy.",
"planetDescription": "The unusual and the abrupt. It carries individuality and unexpected change, and its opposition near age 40 is the midlife pressure to live as oneself instead of as the conditioning.",
"ichingHexagram": {
"number": 38,
"english": "Opposition"
}
},
{
"planet": "Neptune",
"side": "design",
"gate": 38,
"line": 6,
"gateName": "The Fighter",
"gateDescription": "Root pressure to fight for what has meaning. The struggle itself is the design, but it only builds wisdom when the cause is genuinely worth it, otherwise it becomes opposition for its own sake.",
"lineMeaning": "Wisdom that much of the opposition was never real, only a misunderstanding held in place by both sides. What resolves it is dropping the certainty that the error belonged to the other.",
"planetDescription": "The veil. It carries spiritual perception and the capacity for illusion in equal measure, so whatever it activates is rarely seen plainly, by the person or by anyone watching.",
"ichingHexagram": {
"number": 38,
"english": "Opposition"
}
},
{
"planet": "Pluto",
"side": "design",
"gate": 1,
"line": 4,
"gateName": "Self Expression",
"gateDescription": "Creative individuality looking for form. Sitting in the G center, it supplies the raw originality that gate 8 carries to the throat, where it becomes a contribution others can see.",
"lineMeaning": "Creativity that needs solitude to mature, since influence dilutes it. Gate 8 offers the outlet, but the work has to be finished away from the audience before it is carried there.",
"planetDescription": "Truth through transformation. It exposes what was hidden and forces the psychological change that follows, working generationally and slowly rather than personally and quickly.",
"ichingHexagram": {
"number": 1,
"english": "The Creative"
}
}
]
}Response fields
| Field | Type | Description |
|---|---|---|
| type* | string | Human Design energy type. One of Manifestor, Generator, Manifesting Generator, Projector, Reflector. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use typeLocalized for anything a reader sees. |
| typeLocalized | string | Energy type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| typeDescription* | string | What the aura of this type does and how it is designed to engage life. The grounding text for the type label, so a consuming agent does not have to supply the meaning itself. |
| aura* | string | The aura mechanic of the type: how the energy field itself operates, for example open and enveloping, or closed and repelling. |
| strategy* | string | The aura strategy for engaging life correctly for this type. Always English, whatever the lang parameter says. Use strategyLocalized for anything a reader sees. |
| strategyLocalized | string | Strategy name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| strategyDescription* | string | How to actually apply the strategy. The strategy field alone is a bare label such as Respond or Inform; this is the operating instruction behind it. |
| authority* | string | Inner authority for decision making. One of Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, Lunar. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use authorityLocalized for anything a reader sees. |
| authorityLocalized | string | Inner authority name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| authorityDescription* | string | How the decision is made, the timing it requires, and the characteristic trap. Inner authority is the most actionable output of a Human Design chart, so this is the field to lean on when grounding a reading. |
| signature* | string | The signature feeling of living in alignment with the type. Always English, whatever the lang parameter says. Use signatureLocalized for anything a reader sees. |
| signatureLocalized | string | Signature theme name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| notSelf* | string | The not-self theme, the recurring feeling that signals being out of alignment. Always English, whatever the lang parameter says. Use notSelfLocalized for anything a reader sees. |
| notSelfLocalized | string | Not-self theme name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
Show all fieldsShow fewer fields
| Field | Type | Description |
|---|---|---|
| profile* | string | Profile in conscious/unconscious form from the Personality Sun line over the Design Sun line. |
| profileKeynotes* | object | The two line keynotes the profile is built from, conscious over unconscious, so the profile is readable without a separate lookup. |
| profileKeynotes.personalityLine* | number | Line number 1 to 6 of the conscious Personality Sun, the first digit of the profile. |
| profileKeynotes.designLine* | number | Line number 1 to 6 of the unconscious Design Sun, the second digit of the profile. |
| profileKeynotes.personality* | string | Keynote of the conscious Personality line. The half of the life role the person is aware of and can speak to. |
| profileKeynotes.design* | string | Keynote of the unconscious Design line. The half of the life role others see operating in the body, which the person does not directly experience. |
| profileDescription* | string | Meaning of the combined profile. A profile is not the sum of its two lines: 6/2 has its own meaning that neither the line 6 nor the line 2 keynote carries alone. |
| definition* | string | Definition type from the number of connected components among defined centers. One of None, Single, Split, Triple Split, Quadruple Split. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use definitionLocalized for anything a reader sees. |
| definitionLocalized | string | Definition type name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| definitionDescription* | string | How energy flows through the defined centers in this configuration, and what the configuration needs. For a split, this is where the bridging gates of other people matter. |
| sides* | object | What the two chart sides are: personality is the conscious mind side, design is the unconscious body side computed 88 degrees of solar arc before birth. Returned once at the top level rather than repeated across all 26 activations. |
| designInstantUtc* | string | The Design moment as an ISO 8601 UTC instant: the exact time the Sun stood 88 degrees of solar arc before its natal longitude, and the instant every Design activation was computed at. Compare it with the Design date a reference tool prints to validate the chart on the moment itself. |
| incarnationCross* | object | The incarnation cross built from the four cardinal gates and the profile angle. |
| incarnationCross.gates* | array of number | The four cardinal gates of the cross: Personality Sun, Personality Earth, Design Sun, Design Earth. |
| incarnationCross.angle* | string | Cross angle. One of Right Angle, Juxtaposition, Left Angle. Always English, whatever the lang parameter says. Use angleLocalized for anything a reader sees. |
| incarnationCross.angleLocalized | string | Cross angle name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| incarnationCross.angleCode* | string | Short code for the angle. One of RAX, JXT, LAX. |
| incarnationCross.name* | string | Canonical published name of the incarnation cross, determined by the Personality Sun gate and the angle. All 192 crosses (64 Personality Sun gates times three angles) carry their published name, numbered variants included, so this is never a composed placeholder. Always begins with the angle followed by Cross of. Always English, whatever the lang parameter says. |
| incarnationCross.description | string | The life theme of the cross, synthesized from its four gates and the orientation the angle gives them. The same Sun gate under a different angle is a genuinely different theme: Right Angle is personal destiny, Left Angle is worked out through other people, Juxtaposition is a fixed fate. |
| centers* | array of object | All nine centers with their defined state and active gates. |
| centers[].id* | string | Center identifier. One of head, ajna, throat, g, heart, sacral, solar-plexus, spleen, root. |
| centers[].name* | string | Display name of the center. Always English, whatever the lang parameter says, so it stays safe to compare against in code. Use nameLocalized for anything a reader sees. |
| centers[].nameLocalized | string | Center name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| centers[].defined* | boolean | Whether the center is defined. A defined center is a consistent source of energy or awareness; an undefined center is open and conditioned by others. |
| centers[].motor* | boolean | Whether this is a motor center (energy source). The four motors are Heart, Sacral, Solar Plexus, and Root. |
| centers[].awareness* | boolean | Whether this is an awareness center. The three awareness centers are Ajna, Solar Plexus, and Spleen. |
| centers[].theme* | string | Theme text describing the center in its current defined or undefined state. |
| centers[].notSelfQuestion* | string | The conditioning trap of this center when it is open. Returned on every center so a consumer can surface it the moment `defined` is false, which is where the not-self operates. |
| centers[].biology* | string | The gland, organ, or system this center corresponds to in the body. |
| centers[].gates* | array of number | Active gate numbers that sit in this center. |
| channels* | array of object | The defined channels where both gates are activated. |
| channels[].gateA* | number | First gate of the channel. |
| channels[].gateB* | number | Second gate of the channel. |
| channels[].name* | string | Name of the defined channel. Always English, whatever the lang parameter says. Use nameLocalized for anything a reader sees. |
| channels[].nameLocalized | string | Channel name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| channels[].circuit* | string | Circuit family of the channel. One of Individual, Collective, Tribal. Always English, whatever the lang parameter says. Use circuitLocalized for anything a reader sees. |
| channels[].circuitLocalized | string | Circuit family name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| channels[].centers* | array of string | The two centers this channel connects and defines. |
| channels[].description* | string | What this channel wires between its two centers and the nature of the energy it carries. |
| channels[].circuitDescription* | string | What the circuit family of this channel governs. |
| gates* | array of object | All 26 activations, 13 Personality and 13 Design. |
| gates[].planet* | string | Activating body. One of Sun, Earth, Moon, North Node, South Node, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto. Always English, whatever the lang parameter says, so it stays safe to compare against in code and to key a glyph table on. Use planetLocalized for anything a reader sees. |
| gates[].planetLocalized | string | Activating body name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| gates[].side* | string | Chart side. personality is the conscious birth-moment activation, design is the unconscious activation 88 degrees of solar arc before birth. |
| gates[].gate* | number | Human Design gate number from 1 to 64 that this activation falls in. |
| gates[].line* | number | Line number from 1 to 6 within the gate, setting the line keynote and the profile. |
| gates[].gateName* | string | Human Design keynote name of the gate, describing its bodygraph function. Always English, whatever the lang parameter says. Use gateNameLocalized for anything a reader sees. |
| gates[].gateNameLocalized | string | Gate keynote name in the requested language, for display only. Present only when lang is set to a language other than English, since in English it would repeat its canonical partner field exactly. Never compare against this value, compare against the canonical field beside it. |
| gates[].gateDescription* | string | Bodygraph function of the gate: what it does in the center it sits in and the channel it forms. This is NOT the meaning of the I-Ching hexagram that shares its number. They share a number, not a definition. |
| gates[].lineMeaning* | string | Meaning of this gate at this specific line, one of 384. The finest interpretive layer in the chart and the one that makes a reading specific rather than generic. This is not the six abstract line archetypes: gate 41 line 3 carries its own meaning that neither the gate keynote nor the line-3 archetype holds alone. |
| gates[].planetDescription* | string | What this planetary activation contributes in Human Design specifically, which is not its meaning in western astrology. |
| gates[].ichingHexagram* | object | Cross-reference to the I-Ching hexagram that shares this gate number. |
| gates[].ichingHexagram.number* | number | I-Ching hexagram number, identical to the gate number it corresponds to. |
| gates[].ichingHexagram.english* | string | English name of the corresponding I-Ching hexagram. |
Supported options
lang
nodeType
Call it in your language.
Every snippet is generated from the live OpenAPI spec, so method names, parameters, and fields always match production.
import { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.humanDesign.generateBodygraph({ body: { date: '1990-07-15', time: '13:00:00', timezone: 'America/New_York' } })Install: npm install @roxyapi/sdk
from roxy_sdk import create_roxy
roxy = create_roxy("YOUR_API_KEY")
result = roxy.human_design.generate_bodygraph(date='1990-07-15', time='13:00:00', timezone='America/New_York')Install: pip install roxy-sdk
use function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->humanDesign->generateBodygraph(date: '1990-07-15', time: '13:00:00', timezone: 'America/New_York');Install: composer require roxyapi/sdk
using RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
var result = await roxy.HumanDesign.Bodygraph.PostAsync(new() { /* request fields above */ });Install: dotnet add package RoxyApi.Sdk
import roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
resp, _ := roxy.HumanDesign.GenerateBodygraph(ctx, nil, roxyapi.GenerateBodygraphJSONRequestBody{ /* request fields above */ })Install: go get github.com/RoxyAPI/sdk-go
curl -X POST "https://roxyapi.com/api/v2/human-design/bodygraph" \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1990-07-15","time":"13:00:00","timezone":"America/New_York"}'Prefer to try before you write code? Run this Human Design endpoint live in the API playground and inspect a real production response.
More Human Design Bodygraph endpoints
The Human Design Bodygraph API bundles these related endpoints under one key.
Calculate Human Design type, authority and profile
Calculate the core Human Design identity from a birth moment: the energy type, the aura strategy, the inner authority, the signature and not-self themes, and the profile. The fast lookup for type-and-authority features without the full bodygraph payload. Verified against NASA JPL Horizons positions.
Try it liveCalculate the Human Design profile and line keynotes
Calculate the Human Design profile for a birth moment: the conscious Personality Sun line over the unconscious Design Sun line, with the keynote for each. The profile is the geometry of the life role, for example 5/1 the Heretic Investigator. Verified against NASA JPL Horizons positions.
Try it liveGenerate Human Design transit overlay - Current planetary activations on a natal bodygraph
Overlay the current or any given planetary positions on a natal Human Design bodygraph to see which channels the transit temporarily completes. Returns the 13 transiting body activations with gate and line, the channels the transit completes beyond the natal definition split into personal channels where the transit supplies the partner gate of a natal gate and educational channels where the transit supplies both gates, the natally open centers those channels temporarily define, and a short factual summary. A transit is a single moment, so there is no Design side. When date and time are omitted the overlay is computed for now in UTC. Built for daily Human Design apps, transit widgets, and notification tools.
Try it liveCalculate Human Design Variables - The four arrows and Color, Tone, Base substructure
Calculate the four Human Design Variable arrows for a birth moment: Determination and Environment on the design side, Perspective and Motivation on the personality side. Each arrow returns its Color, Tone, and Base numbers from the hexagram-line substructure, the left or right direction set by the Tone, and the sourced Color and direction labels. This is the advanced Rave Variables and Primary Health System layer beneath Type, Strategy, Authority, and Profile. Color, Tone, and Base shift with tiny differences in birth time, so each arrow carries a confidence flag that turns false near a Color or Tone boundary, and a precise birth time is essential. Built for Human Design apps offering PHS, diet, environment, and Rave Psychology readings.
Try it liveRemote MCP for AI agents
Every Human Design endpoint is a callable tool on the Remote MCP server over Streamable HTTP. No local setup, no Docker. Claude, ChatGPT, Cursor, and any MCP client auto-discover the tools and ground their answers in verified data.
claude mcp add --transport http \
roxy-human-design https://roxyapi.com/mcp/human-design \
--header "X-API-Key: YOUR_KEY"Tool name for POST /human-design/bodygraph: post_human_design_bodygraph. Full MCP setup guide
What you can build
Spiritual and self-discovery apps: full bodygraph generation, type and authority readings, and profile insights for personal growth journeys
Dating and relationship platforms: type, authority, and profile compatibility context derived from two birth charts
AI chatbots and coaching assistants: bodygraph data via remote MCP tool calls for Human Design conversations and decision-making guidance
Practitioner and reading tools: activation columns, defined channels, and center analysis for professional Human Design charts
Wellness and mindfulness platforms: strategy and authority prompts that help users make aligned decisions
Content and editorial platforms: gate and center reference lookups for explainer pages and structured Human Design libraries
Drop-in UI components and no-code widgets.
Render Human Design Bodygraph API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Human Design Bodygraph API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.
HD type card widget snippet
HD variables widget snippet
The complete UI libraryExplore Roxy UIShow all Human Design Bodygraph UI componentsShow fewer Human Design Bodygraph UI components
| Element | Renders |
|---|---|
| <roxy-bodygraph> | Nine-center chart with defined and open centers, active channels, and gates, plus the type, strategy, authority, profile, and definition readings, the channels by circuit, the centers, and every activation with its gate and line meaning |
| <roxy-hd-type-card> | Type, strategy, authority, and profile tiles with the aura, signature, and not-self themes, plus the reading behind each label and the profile line keynotes |
| <roxy-hd-variables> | The four transformation arrows with direction, color, tone, and base, plus a reading per arrow grouped by layer and the cognition |
Related capabilities
Human Design Bodygraph API FAQ
What does the Human Design Bodygraph API return?
Generate a complete Human Design bodygraph from a birth date, time, and timezone. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.
How do I authenticate with the Human Design Bodygraph API?
Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.
Does the Human Design Bodygraph API support multiple languages?
Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.
Do I need coordinates to call the Human Design Bodygraph API?
No. Call GET /location/search with a city name first, then pass latitude, longitude, and timezone from the first result into the request. Never ask users to type coordinates. Timezone accepts a decimal offset or an IANA name.
Is the Human Design Bodygraph API available over Remote MCP for AI agents?
Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/human-design over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.
How is the Human Design Bodygraph API billed?
Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 18 domains, so the Human Design Bodygraph API is included at no extra cost.
What nodeType values does the Human Design Bodygraph API accept?
The nodeType parameter accepts mean, true. Case-insensitive where it is a path value.
Start using Human Design Bodygraph API today.
A Human Design bodygraph, type and authority from a Design moment solved on the true 88 degree solar arc and printed with the chart.
All 18 domains included with every plan. Every endpoint, MCP server, SDK, and templates.
Plans from $39/mo, starting at $1.80 per domain on annual billing. No credit card required for testing.
View Pricing & Get API Key

