Human Design

Calculate a complete Human Design bodygraph chart including Type, Strategy, Authority, Profile, Definition, Signature, Not-Self Theme, Incarnation Cross, the five PHS Variables, gate activations, channels, and center status.

Human Design combines astrology, I Ching, Kabbalah, and the chakra system. It uses two planetary calculations — the Personality (conscious, at birth time) and the Design (unconscious, 88° solar arc before birth) — to derive 26 gate activations that form the bodygraph.

Required Module

All Human Design endpoints require the module:human-design module to be enabled for your organization.

Chart Calculation

Calculate a complete Human Design chart:

bash

curl -X POST "https://api.astroapi.cloud/api/human-design/chart" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "dateTime": "1990-06-15T14:30",
    "location": {
      "latitude": 52.37,
      "longitude": 4.89,
      "timezone": "Europe/Amsterdam"
    }
  }'

javascript

const response = await fetch("https://api.astroapi.cloud/api/human-design/chart", {
    method: "POST",
    headers: {
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    body: JSON.stringify({
        dateTime: "1990-06-15T14:30",
        location: {
            latitude: 52.37,
            longitude: 4.89,
            timezone: "Europe/Amsterdam"
        }
    })
});
const data = await response.json();

python

import requests

response = requests.post(
    "https://api.astroapi.cloud/api/human-design/chart",
    headers={
        "X-Api-Key": "your-api-key",
        "Content-Type": "application/json"
    },
    json={
        "dateTime": "1990-06-15T14:30",
        "location": {
            "latitude": 52.37,
            "longitude": 4.89,
            "timezone": "Europe/Amsterdam"
        }
    }
)
data = response.json()

Parameters

Parameter	Type	Required	Description
`dateTime`	string	Yes	Birth date and time in `YYYY-MM-DDTHH:mm` format (local time)
`location`	object	Yes	Birth location
`location.latitude`	number	Yes	Latitude in decimal degrees (-90 to 90)
`location.longitude`	number	Yes	Longitude in decimal degrees (-180 to 180)
`location.timezone`	string	Yes	IANA timezone identifier (e.g. `"Europe/Amsterdam"`)

Response

json

{
  "data": {
    "type": "generator",
    "strategy": "to-respond",
    "authority": "sacral",
    "profile": {
      "conscious": 1,
      "unconscious": 3,
      "name": "1/3"
    },
    "definition": "single",
    "signature": "satisfaction",
    "notSelfTheme": "frustration",
    "incarnationCross": {
      "angle": "left-angle",
      "name": "Alignment",
      "fullName": "Left Angle Cross of Alignment",
      "gates": {
        "personalitySun": 27,
        "personalityEarth": 28,
        "designSun": 19,
        "designEarth": 33
      },
      "notation": "27/28 | 19/33"
    },
    "variables": {
      "digestion": { "value": "High", "key": "high", "category": "Sound", "color": 5, "tone": 2, "orientation": "left" },
      "environment": { "value": "Mountains", "key": "mountains", "color": 4, "tone": 3, "orientation": "left" },
      "motivation": { "value": "Need", "key": "need", "color": 4, "tone": 1, "orientation": "left" },
      "perspective": { "value": "Survival", "key": "survival", "color": 1, "tone": 5, "orientation": "right" },
      "designSense": { "value": "Taste", "key": "taste", "color": 5, "tone": 2, "orientation": "left" }
    },
    "birthDate": "1990-06-15T14:30:00.000Z",
    "designDate": "1990-03-18T09:12:00.000Z",
    "personality": [
      {
        "planet": "sun",
        "gate": 25,
        "line": 1,
        "color": 3,
        "tone": 4,
        "base": 2,
        "longitude": 84.12,
        "retrograde": false
      }
    ],
    "design": [
      {
        "planet": "sun",
        "gate": 46,
        "line": 4,
        "color": 2,
        "tone": 6,
        "base": 1,
        "longitude": 356.12,
        "retrograde": false
      }
    ],
    "centers": {
      "sacral": { "status": "defined", "gates": [14, 29] },
      "head": { "status": "open", "gates": [] },
      "throat": { "status": "undefined", "gates": [8] }
    },
    "definedChannels": [
      {
        "gate1": 2,
        "gate2": 14,
        "center1": "identity",
        "center2": "sacral",
        "name": "The Beat",
        "personality": true,
        "design": false
      }
    ],
    "activatedGates": [1, 2, 8, 14, 25, 29, 46]
  }
}

Response Fields

Top-level

Field	Type	Description
`type`	string	One of: `generator`, `manifesting-generator`, `manifestor`, `projector`, `reflector`
`strategy`	string	One of: `to-respond`, `to-respond-and-inform`, `to-inform`, `to-wait-for-invitation`, `to-wait-for-lunar-cycle`
`authority`	string	One of: `emotional`, `sacral`, `splenic`, `ego-projected`, `ego-manifested`, `self-projected`, `mental`, `lunar`
`profile`	object	Conscious line, unconscious line, and combined name (e.g. `"1/3"`)
`definition`	string	One of: `none`, `single`, `split`, `triple-split`, `quadruple-split`
`signature`	string	Feeling when living correctly. One of: `satisfaction`, `peace`, `success`, `surprise`
`notSelfTheme`	string	Signal of resistance. One of: `frustration`, `anger`, `bitterness`, `disappointment`
`incarnationCross`	object	Life purpose cross (angle, theme name, four gates) — see below
`variables`	object	The five PHS variables (Digestion, Design Sense, Motivation, Perspective, Environment) — see below
`birthDate`	string	ISO 8601 birth date used for personality calculation
`designDate`	string	ISO 8601 design date (88° solar arc before birth)
`personality`	array	13 gate activations from the personality (conscious) chart, ordered Sun, Earth, North Node, South Node, Moon, …
`design`	array	13 gate activations from the design (unconscious) chart, same ordering
`centers`	object	Status of all 9 centers (head, ajna, throat, identity, heart, sacral, solar-plexus, spleen, root)
`definedChannels`	array	Channels where both gates are activated
`activatedGates`	array	Sorted list of all activated gate numbers

Gate Activation

Activations are ordered top-to-bottom the way they appear on a bodygraph: Sun, Earth, North Node, South Node, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto (Earth directly under the Sun).

Field	Type	Description
`planet`	string	Celestial body (sun, earth, north-node, south-node, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto)
`gate`	number	Gate number (1-64)
`line`	number	Line number (1-6)
`color`	number	Color — 1-6 subdivision of the line (drives the Variables)
`tone`	number	Tone — 1-6 subdivision of the color
`base`	number	Base — 1-6 subdivision of the tone
`longitude`	number	Ecliptic longitude in degrees
`retrograde`	boolean	Whether the planet is retrograde

Incarnation Cross

Field	Type	Description
`angle`	string	`right-angle`, `left-angle`, or `juxtaposition` (derived from the profile)
`name`	string	Theme name, e.g. `"Alignment"`
`fullName`	string	Full display name, e.g. `"Left Angle Cross of Alignment"`
`gates`	object	`personalitySun`, `personalityEarth`, `designSun`, `designEarth`
`notation`	string	Gate notation, e.g. `"27/28

Variables (PHS)

Each variable is read from the exact color/tone of a specific activation.

Variable	Source	Basis	Example values
`digestion`	Design Sun	color (category) + tone (High/Low via arrow)	Appetite, Taste, Thirst, Touch, Sound, Light
`designSense`	Design Sun	tone	Smell, Taste, Outer Vision, Inner Vision, Feeling, Touch
`motivation`	Personality Sun	color	Fear, Hope, Desire, Need, Guilt, Innocence
`perspective`	Personality Node	color	Survival, Possibility, Power, Wanting, Probability, Personal
`environment`	Design Node	color	Caves, Markets, Kitchens, Mountains, Valleys, Shores

Each variable object contains value, key, color, tone, orientation (left for tones 1-3, right for tones 4-6), and — for digestion — a category.

Center

Field	Type	Description
`status`	string	`defined` (connected via channel), `undefined` (has gates but no channels), `open` (no gates)
`gates`	array	Gate numbers activated in this center

Bodygraph Image

Render the bodygraph as an SVG or PNG image. By default the image includes the Design planet column on the left and the Personality planet column on the right (each planet's gate.line, with Earth directly under the Sun), matching a standard Human Design chart. Pass showPlanets=false to render just the graph.

SVG

bash

curl "https://api.astroapi.cloud/api/human-design/chart.svg?dateTime=1990-06-15T14:30&latitude=52.37&longitude=4.89&timezone=Europe/Amsterdam" \
  -H "X-Api-Key: your-api-key" \
  -o bodygraph.svg

javascript

const response = await fetch(
    "https://api.astroapi.cloud/api/human-design/chart.svg?" +
    "dateTime=1990-06-15T14:30&latitude=52.37&longitude=4.89&timezone=Europe/Amsterdam",
    { headers: { "X-Api-Key": "your-api-key" } }
);
const svg = await response.text();

PNG

bash

curl "https://api.astroapi.cloud/api/human-design/chart.png?dateTime=1990-06-15T14:30&latitude=52.37&longitude=4.89&timezone=Europe/Amsterdam" \
  -H "X-Api-Key: your-api-key" \
  -o bodygraph.png

Bodygraph Parameters

Parameter	Type	Required	Default	Description
`dateTime`	string	Yes	—	Birth date/time in `YYYY-MM-DDTHH:mm` format (local time)
`latitude`	number	Yes	—	Birth latitude (-90 to 90)
`longitude`	number	Yes	—	Birth longitude (-180 to 180)
`timezone`	string	Yes	—	IANA timezone identifier (e.g. `"Europe/Amsterdam"`)
`width`	number	No	576	Image width in pixels (100-2000)
`height`	number	No	480	Image height in pixels (100-2000)
`theme`	string	No	`default`	Theme preset: `default`, `dark`, `classic`, `minimal`
`showPlanets`	boolean	No	`true`	Render the Design (left) and Personality (right) planet columns beside the graph. Set `false` for just the bodygraph (uses a 360-wide canvas).

Theme Presets

Preset	Background	Defined Centers	Personality	Design
`default`	White	Yellow	Black	Red
`dark`	Dark blue	Dark yellow	Light gray	Bright red
`classic`	Parchment	Gold	Dark gray	Dark red
`minimal`	White	Light gray	Gray	Muted red

The bodygraph shows 9 centers (Head, Ajna, Throat, G/Identity, Heart, Sacral, Spleen, Solar Plexus, Root) connected by 36 channels. Defined centers are filled with color, undefined centers are empty. Active channels are drawn in the personality color (black), design color (red), or striped (both).

Concepts

Personality vs Design

Personality (conscious): Calculated at the exact birth time. Represents traits you are aware of.
Design (unconscious): Calculated at the moment the Sun was 88° earlier in the zodiac (approximately 88 days before birth). Represents unconscious traits.

Type

Your Type is determined by which centers are defined:

Generator: Sacral center defined, no motor-to-throat connection
Manifesting Generator: Sacral defined with motor-to-throat connection
Manifestor: Sacral not defined, motor-to-throat connection exists
Projector: Sacral not defined, no motor-to-throat connection
Reflector: No defined centers at all

Authority

Authority follows a strict hierarchy based on which centers are defined, determining how you should make decisions.

Profile

Derived from the line numbers of the conscious Sun (personality) and unconscious Sun (design). There are 12 possible profiles (1/3, 1/4, 2/4, 2/5, 3/5, 3/6, 4/6, 4/1, 5/1, 5/2, 6/2, 6/3).

Signature & Not-Self Theme

Two feelings that signal whether you are living in alignment with your design. The Signature is the feeling when decisions are made correctly (Generators/Manifesting Generators → Satisfaction, Manifestors → Peace, Projectors → Success, Reflectors → Surprise). The Not-Self Theme is the signal of resistance (Generators/Manifesting Generators → Frustration, Manifestors → Anger, Projectors → Bitterness, Reflectors → Disappointment).

Incarnation Cross

Your life purpose, formed by four gates: the Personality Sun & Earth (conscious) and the Design Sun & Earth (unconscious). The angle — Right Angle (personal destiny), Left Angle (transpersonal karma) or Juxtaposition (fixed fate) — is derived from your profile. Each (Personality Sun gate, angle) pair maps to one of 192 named crosses.

Variables (PHS)

The Primary Health System describes how you are designed to eat, think and orient. The five variables are each read from the exact color or tone of a specific activation: Digestion (Design Sun color + tone), Design Sense / Cognition (Design Sun tone), Motivation (Personality Sun color), Perspective (Personality Node color) and Environment (Design Node color). The tone additionally sets a left/right arrow orientation (tones 1-3 = left, 4-6 = right).

Human Design ​

Chart Calculation ​

Parameters ​

Response ​

Response Fields ​

Top-level ​

Gate Activation ​

Incarnation Cross ​

Variables (PHS) ​

Center ​

Bodygraph Image ​

SVG ​

PNG ​

Bodygraph Parameters ​

Theme Presets ​

Concepts ​

Personality vs Design ​

Type ​

Authority ​

Profile ​

Signature & Not-Self Theme ​

Incarnation Cross ​

Variables (PHS) ​

Human Design

Chart Calculation

Parameters

Response

Response Fields

Top-level

Gate Activation

Incarnation Cross

Variables (PHS)

Center

Bodygraph Image

SVG

PNG

Bodygraph Parameters

Theme Presets

Concepts

Personality vs Design

Type

Authority

Profile

Signature & Not-Self Theme

Incarnation Cross

Variables (PHS)