Human Design API
Ship a Human Design bodygraph your users can trust. This week.
Start building in seconds.
npm install @roxyapi/sdkimport { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.humanDesign.get(/* ... */)pip install roxy-sdkfrom roxy_sdk import create_roxy
roxy = create_roxy("your-api-key")
result = roxy.human_design.get(...) # async: await roxy.human_design.get_async(...)composer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->humanDesign->get(/* ... */);curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/human-design/claude mcp add --transport http \
roxy-human-design https://roxyapi.com/mcp/human-design \
--header "X-API-Key: YOUR_KEY"AI agents auto-discover all 10 endpoints as callable tools. Zero configuration.
Want to ship faster? Clone a free starter app and go from zero to production in 30 minutes.
Building with Cursor, Claude Code, or Bolt? Use our AI prompts to generate a complete app in minutes.
{
"type": "Generator",
"strategy": "Wait to respond",
"authority": "Emotional",
"signature": "Satisfaction",
"notSelf": "Frustration",
"profile": "1/4",
"definition": "Triple Split",
"incarnationCross": {
"gates": [
36,
6,
11,
12
],
"angle": "Right Angle",
"angleCode": "RAX",
"name": "RAX Cross (36/6/11/12)"
},
"centers": [
{
"id": "ajna",
"name": "Ajna",
"defined": true,
"motor": false,
"awareness": true,
"theme": "A fixed way of processing and conceptualizing. Mental certainty and a consistent thinking style.",
"gates": [
11,
17,
24
]
}
],
"channels": [
{
"gateA": 11,
"gateB": 56,
"name": "Curiosity",
"circuit": "Collective",
"centers": [
"ajna",
"throat"
]
}
],
"gates": [
{
"planet": "Sun",
"side": "personality",
"gate": 36,
"line": 1,
"gateName": "Crisis",
"ichingHexagram": {
"number": 36,
"english": "Darkening of the Light"
}
}
]
}Structured JSON with documented fields. Not hallucinated text. See all 10 endpoints
Works with your stack
Generate the full Human Design bodygraph from a birth moment: type, strategy, inner authority, profile, definition, incarnation cross, the nine centers, defined channels, and all 26 gate activations. Planetary positions verified against NASA JPL Horizons, the Design side solved on the exact 88 degree solar arc. One key, remote MCP, typed SDKs, 10 endpoints.
Key Features
Everything you need from our Human Design API, built for production:
Full bodygraph in one call: energy type, strategy, inner authority, signature, not-self theme, profile, definition, and incarnation cross from a single birth date, time, and timezone
All five energy types derived from the graph: Manifestor, Generator, Manifesting Generator, Projector, and Reflector, with strategy and signature for each
Seven inner authorities resolved in strict priority: Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, and Lunar
The 26 gate activations split into 13 conscious Personality and 13 unconscious Design, each enriched with its gate keynote and matching I-Ching hexagram
The nine centers reported as defined or open with motor and awareness flags, theme text, and the active gates that sit in each
The 36 channels with circuit family, returning only the defined channels that wire the bodygraph together
Profile from the two Sun lines with line keynotes, plus definition computed from connected components among defined centers
Static gate and center lookups for reference UIs, with the Design moment solved on the 88 degree solar arc rather than approximated as 88 calendar days
Transit overlay that maps the current planetary positions onto a natal bodygraph and reports the channels the transit temporarily completes, split into personal and educational, with the centers they define
All 10 Endpoints
Click any endpoint to view detailed documentation, parameters, and response examples.
Generate full Human Design bodygraph - Type, authority, profile, centers, channels, gates
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.
Calculate Human Design connection chart - Two-person composite bodygraph compatibility
Calculate a Human Design connection chart by overlaying two bodygraphs. For each of the 36 channels the dynamic between the two people is classified as electromagnetic, dominance, compromise, or companionship, the four mechanics of how two designs meet. Also returns the nine centers as defined or open in the combined bodygraph with which person defines each, the combined definition, and a count of each dynamic. Built for relationship, dating, and coaching tools.
Generate 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.
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.
Calculate the 26 Human Design gate activations
Calculate the 26 gate activations for a birth moment, split into the 13 conscious Personality activations at birth and the 13 unconscious Design activations 88 degrees of solar arc earlier. Each activation reports the planet, gate, line, gate keynote, and the matching I-Ching hexagram. Built for activation columns and detailed chart views.
Look up a Human Design gate by number
Look up the static reference data for a Human Design gate by its number from 1 to 64: the gate keynote name, the center it sits in, the matching I-Ching hexagram, and the gates that form a channel with it. A pure reference endpoint with no birth data required.
Calculate the defined Human Design channels
Calculate the defined channels for a birth moment. A channel is defined when both of its gates are activated, and it wires together the two centers it connects. Returns each defined channel with its gates, name, circuit family, and connected centers, plus the full set of centers those channels define. Built for bodygraph rendering and definition analysis.
Calculate the nine Human Design centers
Calculate the state of all nine Human Design centers for a birth moment: whether each is defined or open, whether it is a motor or an awareness center, its theme, and the active gates it holds. The data layer behind a rendered bodygraph where defined centers are colored and open centers are white.
Look up a Human Design center by id
Look up the static reference data for one of the nine Human Design centers by its id: the display name, whether it is a motor or awareness center, and what it means both defined and undefined. A pure reference endpoint with no birth data required.
Calculate 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.
What You Can Build with Human Design API
Real-world applications and use cases for integrating Human Design API into your projects:
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
What developers are saying
Dhani M.
Indie App Developer
Shipped an astrology app over a long weekend. Birth charts, nakshatras, KP cusps, significators. I verified the Lahiri ayanamsha values independently and they line up with my reference. One API key for all of it.
Tom H.
Senior Developer
The OpenAPI spec is the most complete I have seen in this space. Generated a type-safe TypeScript client from it in seconds. Every field has descriptions and examples. Production-grade documentation.
Chris W.
Backend Engineer
Response times consistently under 50ms for numerology and tarot endpoints. The API returns structured JSON with every field documented. Integrated it into our platform in an afternoon.
Getting started with Human Design API.
From zero to production in 3 steps. No signup required for testing.
3 Steps to Ship
| 1Install the SDK | npm i @roxyapi/sdk |
| 2Get your API key | View Plans |
| 3Make your first call | View Docs |
Agent-Ready Infrastructure
MCPRemote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12 spiritual domains under one key.
- Remote MCP server — 10 tools auto-discovered by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
- llms.txt — AI-native discovery surface for ChatGPT, Perplexity, and Gemini citation
- AGENTS.md — 2026 execution playbook for Cursor, Codex, Windsurf, Aider, Claude Code, Gemini CLI. Bundled in the SDK.
Start using Human Design API today.
Ship a Human Design bodygraph your users can trust. This week.
All 12 domains included with every plan. 10+ endpoints, MCP server, SDK, and starters.
Plans from $39/mo — thats $3.25 per domain. No credit card required for testing.
View Pricing & Get API Key