AI Spiritual Voice Assistant
Web App / Open Source30 minTalk to the stars. Real readings across every spiritual domain, spoken aloud.
VoiceAstrologyVedicTarotNumerologyHuman Design
Human Design API
Ship a Human Design bodygraph your users can trust. This week.
BodygraphTypeConnectionProfileTransit …and so much more
<50mslatency
99.9%uptime
Includedwith every plan(at no extra cost)
Start building in seconds.
Want to try without writing code? Try this domain live in API playground →
Terminal
npm install @roxyapi/sdkimport { createRoxy } from '@roxyapi/sdk'
const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.humanDesign.get(/* ... */)Terminal
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(...)Terminal
composer require roxyapi/sdkuse function RoxyAPI\Sdk\createRoxy;
$roxy = createRoxy(getenv('ROXY_API_KEY'));
$result = $roxy->humanDesign->get(/* ... */);Terminal
dotnet add package RoxyApi.Sdkusing RoxyApi;
var roxy = new RoxyClient(Environment.GetEnvironmentVariable("ROXY_API_KEY")!);
// await roxy.HumanDesign.<resource>.GetAsync() or .PostAsync(new() { ... })Terminal
go get github.com/RoxyAPI/sdk-goimport roxyapi "github.com/RoxyAPI/sdk-go"
roxy, _ := roxyapi.NewRoxy(os.Getenv("ROXY_API_KEY"))
// resp, err := roxy.HumanDesign.<Method>(context.Background(), nil)Terminal
curl -H "X-API-Key: YOUR_KEY" \
https://roxyapi.com/api/v2/human-design/Claude Code / Cursor
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 endpoints as callable tools. Zero configuration.
Want to ship faster? Clone a free template 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.
Building on WordPress? Install the RoxyAPI plugin and drop a shortcode, no code required.
POST /api/v2/human-design/bodygraph
{
"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": "head",
"name": "Head",
"defined": false,
"motor": false,
"awareness": false,
"theme": "Amplifies the questions and mental pressure of others. Learns not to act on every inspiration that arrives.",
"gates": []
},
{
"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
]
},
{
"id": "throat",
"name": "Throat",
"defined": true,
"motor": false,
"awareness": false,
"theme": "Consistent expression and the ability to manifest through speech and action when connected to a motor.",
"gates": [
8,
12,
31,
56
]
},
{
"id": "g",
"name": "G Center",
"defined": true,
"motor": false,
"awareness": false,
"theme": "A fixed sense of identity, direction, and love. A consistent orientation in life regardless of environment.",
"gates": [
10,
25,
46
]
},
{
"id": "heart",
"name": "Heart",
"defined": true,
"motor": true,
"awareness": false,
"theme": "Consistent willpower and ego drive. A reliable capacity to make and keep promises and to prove value.",
"gates": [
51
]
},
{
"id": "sacral",
"name": "Sacral",
"defined": true,
"motor": true,
"awareness": false,
"theme": "Sustainable life force and work energy. A reliable gut response that guides what to engage with.",
"gates": [
5,
14,
27,
59
]
},
{
"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": [
6,
30,
36
]
},
{
"id": "spleen",
"name": "Spleen",
"defined": false,
"motor": false,
"awareness": true,
"theme": "Heightened sensitivity to wellbeing and fear. Learns to trust intuition without clinging to what feels unsafe.",
"gates": []
},
{
"id": "root",
"name": "Root",
"defined": true,
"motor": true,
"awareness": false,
"theme": "A consistent way of handling pressure and stress. A steady drive to get things done and move forward.",
"gates": [
38,
41,
60
]
}
],
"channels": [
{
"gateA": 11,
"gateB": 56,
"name": "Curiosity",
"circuit": "Collective",
"centers": [
"ajna",
"throat"
]
},
{
"gateA": 25,
"gateB": 51,
"name": "Initiation",
"circuit": "Individual",
"centers": [
"g",
"heart"
]
},
{
"gateA": 59,
"gateB": 6,
"name": "Mating",
"circuit": "Tribal",
"centers": [
"sacral",
"solar-plexus"
]
},
{
"gateA": 41,
"gateB": 30,
"name": "Recognition",
"circuit": "Collective",
"centers": [
"root",
"solar-plexus"
]
}
],
"gates": [
{
"planet": "Sun",
"side": "personality",
"gate": 36,
"line": 1,
"gateName": "Crisis",
"ichingHexagram": {
"number": 36,
"english": "Darkening of the Light"
}
},
{
"planet": "Earth",
"side": "personality",
"gate": 6,
"line": 1,
"gateName": "Friction",
"ichingHexagram": {
"number": 6,
"english": "Conflict"
}
},
{
"planet": "Moon",
"side": "personality",
"gate": 5,
"line": 4,
"gateName": "Fixed Rhythms",
"ichingHexagram": {
"number": 5,
"english": "Waiting (Nourishment)"
}
},
{
"planet": "North Node",
"side": "personality",
"gate": 60,
"line": 6,
"gateName": "Acceptance",
"ichingHexagram": {
"number": 60,
"english": "Limitation"
}
},
{
"planet": "Sun",
"side": "design",
"gate": 11,
"line": 4,
"gateName": "Ideas",
"ichingHexagram": {
"number": 11,
"english": "Peace"
}
},
{
"planet": "Earth",
"side": "design",
"gate": 12,
"line": 4,
"gateName": "Caution",
"ichingHexagram": {
"number": 12,
"english": "Standstill (Stagnation)"
}
}
]
}Structured JSON with documented fields. Not hallucinated text. See all endpoints
Works with your stack
Claude CodeCursorAntigravityChatGPTWindsurfVS Code CopilotOpenAI AgentsGeminiLangChainCrewAIVercel AI SDK
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, plus two-person connection charts and small-group Penta analysis. Planetary positions verified against NASA JPL Horizons, the Design side solved on the exact 88 degree solar arc. One key, Remote MCP, typed SDKs.
Every Human Design calculation is verified against NASA JPL Horizons across 828 gold-standard tests, with a public MIT benchmark repo anyone can clone and re-run. See how we test.
Multi-language API responses
EnglishDeutschEspanolFrancaisHindiPortuguesRusskiyTurkce
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
Small-group Penta (BG5) analysis for three to five people: the six Penta channels as defined Strengths or gaps, the twelve Penta gates with who fills each, the upper leadership and lower generative roles, and the 2/14 material core
All Endpoints
Click any endpoint to view detailed documentation, parameters, and response examples.
Generate full Human Design bodygraph - Type, authority, profile, centers, channels, gatesGenerate 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 compatibilityCalculate 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.Calculate Human Design Penta - Small-group BG5 operating system for three to five peopleCalculate the Human Design Penta (BG5, Base Group 5) for a small group of three to five people. The Penta is a trans-auric form built from a fixed set of six channels running only between the Sacral, the G Center, and the Throat. It reports which of the twelve Penta gates are filled and by whom, which of the six channels are defined Strengths, the upper leadership channels versus the lower generative channels, the 2/14 material core, and the functional gaps where no member supplies a role. Built for team, family, and group analysis tools. Below three people no Penta forms and above five a second Penta emerges, so the group size must be three to five.Generate Human Design transit overlay - Current planetary activations on a natal bodygraphOverlay 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 profileCalculate 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 activationsCalculate 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 numberLook 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 channelsCalculate 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 centersCalculate 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 idLook 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 keynotesCalculate 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.Calculate Human Design Variables - The four arrows and Color, Tone, Base substructureCalculate the four Human Design Variable arrows for a birth moment: Determination and Environment on the design side, Perspective and Motivation on the personality side. Each arrow returns its Color, Tone, and Base numbers from the hexagram-line substructure, the left or right direction set by the Tone, and the sourced Color and direction labels. This is the advanced Rave Variables and Primary Health System layer beneath Type, Strategy, Authority, and Profile. Color, Tone, and Base shift with tiny differences in birth time, so each arrow carries a confidence flag that turns false near a Color or Tone boundary, and a precise birth time is essential. Built for Human Design apps offering PHS, diet, environment, and Rave Psychology readings.
Drop-in UI components
Render Human Design responses without building charts yourself. These open source, framework-agnostic web components take the typed API response and draw it, in React, Vue, Svelte, Angular, plain HTML, and WordPress.
MIT licensedFramework agnosticThemeable via CSS variablesjsDelivr CDN
| Element | Renders |
|---|---|
| <roxy-bodygraph> | Nine-center chart with defined and open centers, active channels, gates, and a type and authority summary |
| <roxy-hd-connection> | Electromagnetic, compromise, and dominance channels between two charts |
| <roxy-hd-penta> | Group penta channels split into upper and lower triangles |
| <roxy-hd-variables> | The four transformation arrows with direction and PHS labels |
| <roxy-reference-card> | Symbol, name, description, keyword chips, and an attribute grid for any glossary lookup |
Free Templates for Human Design
Clone. Edit. Ship. Free and open source by Team Roxy.
Browse all templates or use AI prompts to generate a custom app.
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
DM
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.
Email feedback
TH
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.
Email feedback
CW
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.
Email feedback
Do not take our word for it. Ask the agents.
Every page here is built so AI search engines can read and cite it, so go straight to the source. Let ChatGPT, Perplexity, or Claude search the web and tell you what they find about RoxyAPI accuracy, MCP, SDKs, and pricing.
Opens a live web search in a new tab.
Getting started with Human Design API.
From zero to production in 3 steps. No signup required for testing.
Your AI agentyour model, your voice
Remote MCPauto-discovered, no local setup
Roxy Ephemeris828 tests vs NASA JPL
Verified result12 domains, one flat rate
Your agent grounds every answer in verified calculations and replies in your own voice, so it never hallucinates a chart, date, or reading. No local setup, no AGPL, no hosted-AI markup.
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 — every endpoint auto-discovered as a tool 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.
Human Design API FAQ
How do I add a Human Design chart to my app?
Send a birth date, time, and timezone to the Human Design API and get the full bodygraph back in one response: energy type, strategy, inner authority, profile, definition, incarnation cross, the nine centers, the defined channels, and every gate activation. No location lookup, no setup. Drop in the typed SDKs for TypeScript, Python, or PHP, or point a client at our Remote MCP server, and you ship a chart your users can trust this week. One API key also unlocks the other eleven spiritual domains on the same flat plan.
How accurate is the bodygraph your Human Design API returns?
Every chart is built from precise planetary positions computed by Roxy Ephemeris and verified against NASA JPL Horizons, so type, authority, profile, and each gate activation reflect the real sky at the birth moment. The design side is solved on the exact 88 degree solar arc rather than approximated as 88 calendar days, which is where lesser tools drift on knife-edge charts. Birth time matters: a few minutes can change a gate, and we honor that precision instead of rounding it away.
How does the API determine energy type and authority?
Both come straight from the geometry of the chart, not from a guess. Type is read from which centers are defined and how they wire to the throat, returning Manifestor, Generator, Manifesting Generator, Projector, or Reflector with the matching strategy and signature. Inner authority is resolved by strict priority so the first defined source wins, covering Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, and Lunar. Activation happens the moment you check out, so you can call it the same minute you sign up.
Can I calculate Human Design compatibility between two people?
Yes. Send two birth moments and the Human Design API returns a connection chart that classifies every channel by its relationship dynamic, from electromagnetic attraction to dominance, compromise, and companionship, plus the centers each person defines for the other. This is the engine behind dating, relationship, and coaching features that go deeper than a sun-sign match. For teams and families, group analysis covers three to five people in a single call, and the same logic is available through our Remote MCP server with no local setup or Docker.
How do I get the Human Design profile, like the 5/1?
Ask the Human Design API for the profile and you get the full pairing, such as 5/1 or 6/2, with the conscious and unconscious lines and a keynote for each. The profile is derived from the real solar geometry at birth and the precise design point, so it holds up even on charts that sit close to a line boundary. The same profile arrives inside the full bodygraph response when you want it alongside the rest of the chart, so you never make two calls for one screen.
Can I overlay current transits or look up a single gate or center?
Yes. The Human Design API can overlay todays planetary positions onto any natal bodygraph and report the channels the transit temporarily completes, which powers daily guidance and re-engagement features that keep users coming back. For reference pages and long-tail content, you can pull a single gate or a single center with its meaning, no birth data required, and pair it with our drop-in UI components or render it yourself. The full catalog is also published in our llms.txt and AGENTS.md so coding agents can wire it up unattended.
Start using Human Design API today.
Ship a Human Design bodygraph your users can trust. This week.
All 12 domains included with every plan. Every endpoint, 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