Human Design

Calculate a complete Human Design bodygraph chart including Type, Strategy, Authority, Profile, Definition, 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:

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"
    }
  }'

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();

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

{
  "data": {
    "type": "generator",
    "strategy": "to-respond",
    "authority": "sacral",
    "profile": {
      "conscious": 1,
      "unconscious": 3,
      "name": "1/3"
    },
    "definition": "single",
    "birthDate": "1990-06-15T14:30:00.000Z",
    "designDate": "1990-03-18T09:12:00.000Z",
    "personality": [
      {
        "planet": "sun",
        "gate": 25,
        "line": 1,
        "longitude": 84.12,
        "retrograde": false
      }
    ],
    "design": [
      {
        "planet": "sun",
        "gate": 46,
        "line": 4,
        "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
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
design	array	13 gate activations from the design (unconscious) chart
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

Field	Type	Description
planet	string	Celestial body (sun, earth, moon, north-node, south-node, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto)
gate	number	Gate number (1-64)
line	number	Line number (1-6)
longitude	number	Ecliptic longitude in degrees
retrograde	boolean	Whether the planet is retrograde

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.

SVG

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

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

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	360	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

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).