Human Design Api

Human Design API

Human Design API

Full Human Design bodygraph from a birth moment: energy type, strategy, inner authority, profile, definition, incarnation cross, the nine centers, defined channels, and all 26 gate activations. One key covers 18+ spiritual domains. MCP-first, verified against NASA JPL Horizons.

Get API Key Try Live Methodology MCP Server SDK

What is Human Design API

A Human Design bodygraph is the full chart of a person: planetary positions at the birth moment (the conscious Personality side) and 88 degrees of solar arc before birth (the unconscious Design side), mapped onto 64 gates, 36 channels, and nine centers. This repo ships working TypeScript, JavaScript, and Python samples against the RoxyAPI Human Design bodygraph endpoint. One POST 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. The single endpoint for a full chart in one call, built for Human Design apps, readings, and coaching tools. One subscription unlocks 18+ spiritual domains: Western astrology, Vedic astrology, Forecast, Human Design, Chinese astrology, Feng Shui, Mesoamerican astrology, Vastu, numerology, Kabbalah, tarot, biorhythm, Ayurveda, I Ching, crystals, dreams, angel numbers, and location. Every planetary position is computed by Roxy Ephemeris, verified against NASA JPL Horizons, and the Design side is solved on the exact 88 degree solar arc rather than approximated as 88 calendar days.

Why this API

Property	Value
Coverage	18+ spiritual domains in one subscription
Calculation	Roxy Ephemeris, verified against NASA JPL Horizons
MCP server	https://roxyapi.com/mcp/human-design (Streamable HTTP, no local setup)
SDKs	TypeScript on npm @roxyapi/sdk, Python on PyPI roxy-sdk, PHP on Packagist roxyapi/sdk, C# on NuGet RoxyApi.Sdk, Go github.com/RoxyAPI/sdk-go, WordPress plugin roxyapi
Pricing	One key, flat per call, from $39/mo
Licensing	Personal and commercial use, including closed source apps. No AGPL or GPL entanglement. Full terms
Last verified	2026-Q3

Quick start

1. Get a key at roxyapi.com/pricing
2. Pick a language below
3. Copy the snippet, run, ship

No location lookup, no setup: the bodygraph depends only on the birth date, time, and timezone. Latitude and longitude are optional and do not affect the chart.

cURL

curl -X POST https://roxyapi.com/api/v2/human-design/bodygraph \
  -H "X-API-Key: $ROXY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date": "1990-07-15",
    "time": "13:00:00",
    "timezone": "America/New_York"
  }'

Python

import os
from roxy_sdk import create_roxy

roxy = create_roxy(os.environ["ROXY_API_KEY"])

# Full bodygraph in one call. No coordinates needed.
result = roxy.human_design.generate_bodygraph(
    date="1990-07-15",
    time="13:00:00",
    timezone="America/New_York",
)

print("Type:", result["type"], "|", result["strategy"])
print("Authority:", result["authority"])
print("Profile:", result["profile"], "| Definition:", result["definition"])
print("Incarnation cross:", result["incarnationCross"]["name"])
for channel in result["channels"]:
    print("Channel", channel["gateA"], "-", channel["gateB"], channel["name"], f"({channel['circuit']})")

JavaScript (Node)

import { createRoxy } from '@roxyapi/sdk';

const roxy = createRoxy(process.env.ROXY_API_KEY);

// Full bodygraph in one call. No coordinates needed.
const { data, error } = await roxy.humanDesign.generateBodygraph({
  body: {
    date: '1990-07-15',
    time: '13:00:00',
    timezone: 'America/New_York',
  },
});

if (error) throw new Error(error.error);

console.log('Type:', data.type, '|', data.strategy);
console.log('Authority:', data.authority);
console.log('Profile:', data.profile, '| Definition:', data.definition);
console.log('Incarnation cross:', data.incarnationCross.name);
data.channels.forEach(ch =>
  console.log(`Channel ${ch.gateA}-${ch.gateB} ${ch.name} (${ch.circuit})`)
);

TypeScript

import { createRoxy } from '@roxyapi/sdk';

const roxy = createRoxy(process.env.ROXY_API_KEY!);

// Full bodygraph: type, authority, profile, centers, channels, gates in one call
const { data, error } = await roxy.humanDesign.generateBodygraph({
  body: {
    date: '1990-07-15',
    time: '13:00:00',
    timezone: 'America/New_York',
  },
});

if (error) throw new Error(error.error);

console.log('Type:', data.type, '|', data.strategy);
console.log('Authority:', data.authority);
console.log('Signature:', data.signature, '| Not-self:', data.notSelf);
console.log('Profile:', data.profile, '| Definition:', data.definition);
console.log('Incarnation cross:', data.incarnationCross.name);

const defined = data.centers.filter(c => c.defined).map(c => c.name);
console.log('Defined centers:', defined.join(', '));

data.channels.forEach(ch =>
  console.log(`Channel ${ch.gateA}-${ch.gateB} ${ch.name} (${ch.circuit})`)
);

const personality = data.gates.filter(g => g.side === 'personality');
personality.forEach(g =>
  console.log(`${g.planet}: gate ${g.gate}.${g.line} ${g.gateName}`)
);

Request schema

Field	Type	Required	Description
date	string	yes	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	yes	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	yes	Decimal hours from UTC (e.g. -5 for EST, 5.5 for IST) OR IANA name (e.g. "America/New_York", "Asia/Kolkata"). IANA strings resolve to the DST-correct offset for the birth date
latitude	number	no	Birth latitude in decimal degrees. Optional and does not affect the bodygraph, which depends only on ecliptic longitudes. Defaults to 0
longitude	number	no	Birth longitude in decimal degrees. Optional and does not affect the bodygraph. Defaults to 0

Response shape

{
  "type": "Projector",
  "strategy": "Wait for the invitation",
  "authority": "Emotional",
  "signature": "Success",
  "notSelf": "Bitterness",
  "profile": "3/5",
  "definition": "Split",
  "incarnationCross": {
    "gates": [62, 61, 42, 32],
    "angle": "Right Angle",
    "angleCode": "RAX",
    "name": "Right Angle Cross of Maya 2"
  },
  "centers": [
    {
      "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.",
      "gates": [30, 37]
    }
  ],
  "channels": [
    {
      "gateA": 7,
      "gateB": 31,
      "name": "The Alpha",
      "circuit": "Collective",
      "centers": ["g", "throat"]
    }
  ],
  "gates": [
    {
      "planet": "Sun",
      "side": "personality",
      "gate": 62,
      "line": 3,
      "gateName": "Detail",
      "ichingHexagram": { "number": 62, "english": "Preponderance of the Small" }
    }
  ]
}

Field	Type	Description
type	string	Human Design energy type. One of Manifestor, Generator, Manifesting Generator, Projector, Reflector
strategy	string	The aura strategy for engaging life correctly for this type
authority	string	Inner authority for decision making. One of Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, Lunar
signature	string	The signature feeling of living in alignment with the type
notSelf	string	The not-self theme, the recurring feeling that signals being out of alignment
profile	string	Profile in conscious/unconscious form from the Personality Sun line over the Design Sun line
definition	string	Definition type from the number of connected components among defined centers. One of None, Single, Split, Triple Split, Quadruple Split
incarnationCross	object	The incarnation cross built from the four cardinal gates and the profile angle
incarnationCross.gates	array	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
centers	array	All nine centers with their defined state and active gates. Each has id, name, defined, motor, awareness, theme, gates
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
channels	array	The defined channels where both gates are activated. Each has gateA, gateB, name, circuit (Individual, Collective, Tribal), and the two centers it connects
gates	array	All 26 activations, 13 Personality and 13 Design. Each has planet, side, gate (1-64), line (1-6), gateName, and the matching ichingHexagram
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[].ichingHexagram	object	Cross-reference to the I-Ching hexagram that shares this gate number, with number and english name

Common use cases

Use case	Endpoint flow
Human Design chart in a self-discovery app	POST to /human-design/bodygraph, render centers[] and channels[] as the bodygraph, headline type and strategy
Type and authority quiz feature	POST /human-design/type for the fast subset, or read type and authority from the full bodygraph
Dating or relationship compatibility product	POST /human-design/connection with two birth moments for channel dynamics between two charts
AI coaching assistant with decision guidance	Call the post_human_design_bodygraph MCP tool, then guide from authority and strategy
Daily guidance and re-engagement features	POST /human-design/transit to overlay current planetary activations on a natal bodygraph
Gate and center reference pages	GET /human-design/gates/{number} and /human-design/centers/{id}, no birth data required

Related endpoints in this domain

• POST /human-design/type (calculateType) - the fast lookup for type, strategy, authority, signature, not-self theme, and profile without the full bodygraph payload
• POST /human-design/connection (calculateConnection) - two-person connection chart with every channel classified as electromagnetic, dominance, compromise, or companionship
• POST /human-design/profile (calculateProfile) - the profile with the conscious and unconscious Sun lines and a keynote for each, for example 5/1 the Heretic Investigator

Use this in your AI agent

Connect Claude, GPT, Gemini, or Cursor to RoxyAPI through the remote MCP server. No Docker. No self hosting. The full MCP tool catalog for this domain is at https://roxyapi.com/mcp/human-design.

{
  "mcpServers": {
    "human-design": {
      "url": "https://roxyapi.com/mcp/human-design",
      "headers": { "X-API-Key": "$ROXY_API_KEY" }
    }
  }
}

See docs/mcp for Claude Desktop, Cursor, Windsurf, VS Code, and Claude Code setup.

For AI coding agents

This repo ships an AGENTS.md execution playbook. Cursor, Claude Code, Aider, Codex, Windsurf, RooCode, and Gemini CLI will pick it up automatically. Top level overview lives at roxyapi.com/AGENTS.md.

Resources

• Methodology and gold standard tests verified against NASA JPL Horizons
• Full API reference interactive Scalar UI
• TypeScript SDK on npm
• Python SDK on PyPI
• PHP SDK on Packagist
• C# SDK on NuGet
• Go SDK on pkg.go.dev
• WordPress plugin
• llms.txt full LLM citation index
• Top level AGENTS.md

Other RoxyAPI samples

Natal Chart API Synastry API Numerology API Tarot API Biorhythm API

License

MIT for this sample repo. See LICENSE.

Catalog licensing: Personal and commercial use, including closed source proprietary apps. No AGPL or GPL entanglement. RoxyAPI APIs and SDKs are safe to embed in commercial products. Full terms at roxyapi.com/policy/license.

Contact

• Site: roxyapi.com
• Status: roxyapi.com/api-reference