Human Design API

Ship a Human Design bodygraph your users can trust. This week.

BodygraphTypeConnectionProfileTransit …and so much more

<50mslatency
99.95%+uptime

Start building in seconds.

Want to try without writing code? Try this domain live in API playground →

Terminal
npm install @roxyapi/sdk
import { createRoxy } from '@roxyapi/sdk'

const roxy = createRoxy(process.env.ROXY_API_KEY!)
const { data } = await roxy.humanDesign.get(/* ... */)
SDK docs

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": "Projector",
  "typeDescription": "A focused, penetrating aura that reads and guides others. Recognition and a genuine invitation are the keys to being seen and succeeding.",
  "strategy": "Wait for the invitation",
  "strategyDescription": "Wait to be recognized and genuinely invited into the things that matter: relationships, career, and major commitments. Guidance offered without an invitation is not absorbed, and that wasted insight is what sours into bitterness.",
  "authority": "Emotional",
  "authorityDescription": "Decisions are made across an emotional wave rather than inside a moment. The defined Solar Plexus moves on its own rhythm between hope and pain, so no single moment carries the truth: clarity is what remains once the wave has run its course and settled toward neutral. The trap is committing at the peak, where enthusiasm reads as certainty, or at the trough, where gloom reads as insight, and treating any pressure to answer now as a reason to skip the wait.",
  "profile": "3/5",
  "profileDescription": "Martyr over Heretic. Conscious experimentation learns by collision, discovering what fails, and the unconscious fifth line turns that hard-won knowledge into practical solutions others project onto in advance. The competence is real, the expectations attached to it usually are not, so this role is trusted while it delivers and blamed the moment a projection breaks.",
  "definition": "Split",
  "definitionDescription": "The defined centers fall into two groups with no channel between them, so energy is consistent inside each group and does not cross the divide. The gap is bridged by the gates other people carry, which is why particular company can make thinking suddenly feel joined up, and why that company is easily mistaken for completion rather than recognized as a temporary bridge. What the configuration needs is time for the two areas to synthesize and awareness of who is bridging them, not a rushed decision taken while the halves are still speaking separately.",
  "incarnationCross": {
    "gates": [
      62,
      61,
      42,
      32
    ],
    "angle": "Right Angle",
    "angleCode": "RAX",
    "name": "Right Angle Cross of Maya 2",
    "description": "A memory for small facts and a compulsion to share them. The detail is a real contribution to work that depends on precision, and a burden to a listener who did not ask for it."
  },
  "aura": "Focused and absorbing. The field penetrates deeply into one other person at a time and takes in how they work, which is why the attention feels intense and why recognition arrives unevenly.",
  "signature": "Success",
  "notSelf": "Bitterness",
  "centers": [
    {
      "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.",
      "notSelfQuestion": "Is all this talking and doing an attempt to attract attention? The open Throat fills the silence and stays busy to be noticed, rather than waiting to be recognized and asked.",
      "biology": "The thyroid and parathyroid glands. Thyroid hormones set the metabolic rate and the parathyroids regulate calcium, and in the bodygraph this pair governs the timing of speech and action.",
      "gates": [
        12,
        31,
        62
      ]
    }
  ],
  "channels": [
    {
      "gateA": 7,
      "gateB": 31,
      "name": "The Alpha",
      "circuit": "Collective",
      "centers": [
        "g",
        "throat"
      ],
      "description": "Direction held in the G Center reaches the Throat as the voice of leadership. The authority is granted rather than taken, so the guidance only works once the group has chosen to be led.",
      "circuitDescription": "Sharing for the species, carried by 14 channels. Pattern and experience are worked into something transmissible: the logical half tests patterns and projects them forward, the abstract half harvests wisdom from experience already lived."
    }
  ],
  "gates": [
    {
      "planet": "Sun",
      "side": "personality",
      "gate": 62,
      "line": 3,
      "gateName": "Detail",
      "gateDescription": "The throat gate that names things. It sorts facts, labels, and details into practical language, giving the opinions of gate 17 something concrete to stand on.",
      "lineMeaning": "Facts stated, corrected, and stated again. Every detail that turned out wrong sharpens the next one, and boredom with the small thing is what causes the miss.",
      "planetDescription": "The dominant activation. With the Earth it carries roughly 70 percent of the imprint on the chart. The Personality Sun gate is the conscious life theme, the Design Sun is the radiance the body broadcasts before a word is spoken.",
      "ichingHexagram": {
        "number": 62,
        "english": "Preponderance of the Small"
      }
    }
  ]
}

Structured JSON with documented fields. Not hallucinated text. See all endpoints

Drop-in UI components & widgets

Render Human Design API responses without building charts yourself. Install the npm package and drop these into Next.js, React, Vue, Svelte, Angular, or plain HTML, or embed the very same component on Squarespace, Wix, or WordPress by pasting one snippet, with no backend and no build step. They belong to one library that covers the entire spiritual stack rather than astrology alone, MIT licensed and included in every plan at no extra cost, never a separate product and never an upsell. The Human Design API calculations, the interface that renders them, and the Remote MCP your agent calls, all behind one key, end to end.

MIT licensedFramework agnosticThemeable via CSS variablesnpm or CDN
Show all Human Design UI components
ElementRenders
<roxy-bodygraph>Nine-center chart with defined and open centers, active channels, and gates, plus the type, strategy, authority, profile, and definition readings, the channels by circuit, the centers, and every activation with its gate and line meaning
<roxy-hd-type-card>Type, strategy, authority, and profile tiles with the aura, signature, and not-self themes, plus the reading behind each label and the profile line keynotes
<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, color, tone, and base, plus a reading per arrow grouped by layer and the cognition
<roxy-reference-card>Symbol, name, description, keyword chips, and an attribute grid for any glossary lookup

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 covered by 6,991 automated tests per deploy, 1,527 of them gold-standard tests locked to named external references such as NASA JPL Horizons, 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

True (osculating) lunar node by default, matching professional Human Design software, computed EXACTLY from the Moon instantaneous orbital plane rather than from a truncated perturbation series, which is what keeps a node inside the correct gate on a boundary chart where the two approaches disagree by more than half a line. An optional nodeType parameter switches to the mean node when matching another calculator

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 12 Endpoints

Every one is live in the public OpenAPI spec and callable as an MCP tool. Click any endpoint to view detailed documentation, parameters, and response examples.

Generate full Human Design bodygraph - Type, authority, profile, centers, channels, gatesGenerate 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.Try it
Calculate Human Design connection chart - Two-person composite bodygraph compatibilityCalculate 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.Try it
Calculate Human Design Penta - Small-group BG5 operating system for three to five peopleCalculate 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.Try it
Generate Human Design transit overlay - Current planetary activations on a natal bodygraphGenerate 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.Try it
Calculate Human Design type, authority and profileCalculate 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.Try it
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 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.Try it
Calculate Human Design Variables - The four arrows and Color, Tone, Base substructureCalculate 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.Try it

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.

The receipts are public: the testing methodology, the open MIT benchmark, the transparency report, and the live API playground. 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.

3 Steps to Ship

1Install the SDKnpm i @roxyapi/sdk
2Get your API keyView Plans
3Make your first callView Docs

Agent-Ready Infrastructure

MCP

Remote MCP, llms.txt, and AGENTS.md. The full agent-readiness stack for 12+ domains under one key.

  • Remote MCP server — every endpoint auto-discovered as a tool by Claude, ChatGPT, Cursor over Streamable HTTP. No Docker.
  • Token-optimized responses — opt-in compact mode returns the same data with each field name sent once, cutting the tokens your agent reads per call by roughly 40 to 52 percent. Lossless, and one call still counts as one request.
  • 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.

From your AI agent to a verified Human Design answer.

Your AI agentyour model, your voice
Remote MCPauto-discovered, no local setupToken-optimized
Roxy Ephemeris6,991 tests, 1527 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.

Audit it yourself: every Human Design endpoint runs live in the API playground

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. Nodes use the true (osculating) node that professional Human Design software uses, and it is computed exactly from the Moon instantaneous orbital plane rather than approximated by a perturbation series, so a node close to a gate boundary lands on the correct side of it; if you are matching a mean-node calculator, pass nodeType set to mean.

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, starting at $2.70 per domain on annual billing. No credit card required for testing.

View Pricing & Get API Key