What is Human Design?
Human Design is a synthesis system that creates a unique energetic blueprint for every person based on their birth data. It draws from four ancient traditions — the I Ching (64 hexagrams), the Kabbalah Tree of Life, Hindu-Brahmin Chakra system, and Western astrology — combined with modern quantum physics and genetics. The result is a precise map of how an individual is designed to interact with the world.
Developed in 1987 by Ra Uru Hu, Human Design has grown into a widely-used personal development framework. For developers, it represents a rich data domain: every person’s chart contains dozens of discrete, calculable data points that can power coaching apps, compatibility tools, transit trackers, and more.
The 5 Human Design Types
Type is the most fundamental output of a Human Design chart. The API returns this as a type string in every bodygraph response. There are five Types, each with distinct energy mechanics:
Generator (approx. 37% of population)
Generators have a defined Sacral Center — the body’s primary life-force motor. They are designed to respond to life rather than initiate, using a gut-level yes/no response. The API returns "type": "Generator" when the Sacral is defined and there is no direct motor-to-Throat connection that would create a Manifesting Generator.
Manifesting Generator (approx. 33% of population)
A sub-type of Generator with an additional motor-to-Throat connection. Manifesting Generators can move fast and multi-task, combining the Sacral response with the ability to initiate. The API returns "type": "Manifesting Generator".
Projector (approx. 21% of population)
Projectors have no defined Sacral Center and are non-energy types. They are designed to guide and direct others, and work best when invited into major life decisions. The API returns "type": "Projector".
Manifestor (approx. 9% of population)
Manifestors have a motor (Heart, Solar Plexus, Root, or Sacral) connected directly to the Throat Center, but no defined Sacral. They are the only type designed to initiate action independently. The API returns "type": "Manifestor".
Reflector (approx. 1% of population)
Reflectors have no defined Centers at all — they are completely open and reflect the energy of their environment. They require a full lunar cycle (28 days) to make major decisions. The API returns "type": "Reflector".
Core Components of the Human Design System
Centers
The Bodygraph contains 9 energy Centers, each governing specific biological and psychological functions. Centers can be defined (consistent, reliable energy) or undefined (open, conditioned by others). The API returns a defined_centers array listing all active centers.
For a full breakdown, see the Centers Reference.
Gates
Gates are the 64 activations derived from the I Ching hexagrams. Each Gate sits within a Center and has 6 Lines that add further nuance. Gates are activated by planetary positions at birth (Personality) and 88 solar degrees before birth (Design). The API returns the full gate list with line, color, and tone data.
Channels
A Channel forms when both Gates at either end of a connection are activated. Defined Channels create consistent energy flows between Centers and are central to determining Type and Authority. The API returns a channels array in the bodygraph response.
Profile
The Profile is a two-number combination (e.g., 3/5, 1/4, 6/2) derived from the Lines of the Sun and Earth activations in Personality and Design. There are 12 possible Profiles. See the Profile Reference for the complete breakdown.
Authority
Authority is the decision-making intelligence the chart recommends. It is determined by which Centers are defined and in what sequence. Common authorities include Sacral, Emotional (Solar Plexus), Splenic, Ego, G Center, Mental, and Lunar. The API returns this as authority in the response.
How Human Design Charts Are Calculated
The calculation process involves precise astronomical data:
- Birth moment positions: The positions of the Sun, Moon, Mercury, Venus, Mars, Jupiter, Saturn, Uranus, Neptune, Pluto, North Node, and South Node are calculated at the exact birth date, time, and timezone.
- Design positions: The same 13 celestial bodies are calculated for the moment when the Sun was exactly 88° earlier in its orbit — approximately 88 days before birth.
- Gate mapping: Each planetary position is mapped to one of the 64 Gates using the Human Design wheel, which assigns specific degree ranges of the ecliptic to each Gate.
- Center activation: Centers become defined when both Gates of one or more Channels within that Center are activated.
- Type determination: Type is determined by center definitions, specifically whether the Sacral is defined and whether motors are connected to the Throat.
The Human Design API handles this entire calculation pipeline with high-precision chart calculations, returning results in milliseconds.
Why Developers Should Care
Human Design data is inherently structured and programmable. Each chart produces a deterministic, reproducible set of data points that are ideal for:
- Personalized coaching apps: Deliver custom content based on Type, Authority, and Profile
- Compatibility tools: Compare two or more charts using the Composite API
- Transit tracking: Show how current planetary positions activate a user’s gates
- Group analysis: Use the Group Penta endpoint to analyze team dynamics
- AI-powered interpretation: Feed chart data into LLM prompts for narrative readings
How the API Works
The Human Design API exposes a REST interface. Every chart calculation starts with a POST to /v1/bodygraph:
const response = await fetch('https://api.humandesignhub.app/v1/bodygraph', {
method: 'POST',
headers: {
'X-API-KEY': 'YOUR_API_KEY',
'Content-Type': 'application/json',
},
body: JSON.stringify({
datetime: '1990-01-15T14:30:00+09:00',
verbose: true,
}),
});
const chart = await response.json();
// chart.type => "Generator"
// chart.authority => "Sacral Authority"
// chart.profile => "3/5"
// chart.defined_centers => ["Sacral", "Throat", "G", ...]
// chart.channels => [{ id: "34-57", name: "Power" }, ...]The verbose: true flag returns the full planetary position data and gate details. Without it, the response is a compact summary suitable for display.
Getting Started
- Get a free API key — no credit card required, 100 free credits/month
- Read the API Documentation for full endpoint reference
- Follow the Build a Calculator guide for a step-by-step implementation