REST API + React components

Add Human Design to Your App in 5 Minutes

The only Human Design API with ready-to-use React components. Ship chart features in hours, not months.

import { Bodygraph } from '@hdhub/bodygraph-2d'; async function MyChart() { const chart = await fetch( 'https://api.humandesignhub.app/v1/bodygraph', { method: 'POST', headers: { 'x-api-key': 'YOUR_API_KEY' }, body: JSON.stringify({ datetime: '1989-03-29T16:05:00+09:00' }) } ).then(r => r.json()); return <Bodygraph data={chart} />; }

import requests payload = {"datetime": "1989-03-29T16:05:00+09:00"} # JSON response result = requests.post( "https://api.humandesignhub.app/v1/bodygraph", headers={"x-api-key": "YOUR_API_KEY"}, json=payload, ).json()

{ "type": "Manifestor", "strategy": "Inform", "authority": "Emotional", "profile": "6/2", "centers": ["Ego", "G", "Root", ...] "channels": [{"name": "Inspiration", "gates": [1, 8]}, {"name": "Awakening", "gates": [10, 20]}, ...] }

Quick Start

Add Human Design to your app

Fetch a complete chart with one API call, then render it with our React component — or build your own UI from the JSON response.

REST API JSON Component Demo

Docs

Unique in the market

The only Human Design API with ready-to-use visualization components

Install our npm packages and render interactive bodygraph charts in your React app. No competitor offers this.

@hdhub/bodygraph-2d

Design the bodygraph your product actually wants

Adjust colors, overlays, and panel styling in one place, then see a bodygraph that fits your product before you ship.

It gives design and development one shared surface for faster approval and cleaner handoff.

Dark Light Custom

Real Bodygraph Lab preview in dark theme — Classic Dark

Real Bodygraph Lab preview in light theme — Studio Light

Real Bodygraph Lab preview in custom theme — Custom Preset

Open Bodygraph Lab Read the Guide

@hdhub/bodygraph-3d

3D Bodygraph

Live WebGL preview running in the page.

WebGL

@hdhub/gate-timeline

Timeline

Live gate transition timeline with real component output.

Interactive

Sun

2 Gate

5 Gate

8 Gate

11 Gate

14 Gate

17 Gate

20 Gate

Earth

9 Gate

12 Gate

15 Gate

18 Gate

21 Gate

27 Gate

Moon

19 Gate

22 Gate

25 Gate

28 Gate

31 Gate

34 Gate

37 Gate

NorthNode

23 Gate

26 Gate

29 Gate

32 Gate

35 Gate

38 Gate

41 Gate

44 Gate

SouthNode

30 Gate

36 Gate

42 Gate

45 Gate

48 Gate

Mercury

37 Gate

40 Gate

43 Gate

46 Gate

49 Gate

52 Gate

55 Gate

Venus

47 Gate

53 Gate

59 Gate

62 Gate

1 Gate

Mars

51 Gate

54 Gate

57 Gate

60 Gate

63 Gate

2 Gate

Jupiter

58 Gate

64 Gate

3 Gate

6 Gate

9 Gate

12 Gate

Saturn

1 Gate

4 Gate

7 Gate

10 Gate

13 Gate

19 Gate

Uranus

11 Gate

14 Gate

17 Gate

20 Gate

23 Gate

26 Gate

29 Gate

Neptune

15 Gate

18 Gate

21 Gate

24 Gate

27 Gate

30 Gate

33 Gate

36 Gate

Pluto

22 Gate

28 Gate

34 Gate

37 Gate

40 Gate

AI Agent Ready

Already using an AI agent?

We provide a plan-matched OpenAPI spec so your AI agent can start using the Human Design API in one prompt. Hand the integration off to AI.

Try it with the Free Plan first.

Get API key & prompt See Plans

⌘

Prompt Example Hand the spec URL and token to your agent

Build an interface that uses
https://humandesignhub.app/api/v1/openapi.json

token: hd_live_xxxxx

After it is done, explain what APIs
are available.

OpenAPI spec Reference the JSON that matches your plan

Key included Copy the prompt with your real API key

API explanation Agent explains which endpoints it can use

FAQ

Frequently Asked Questions

What is the Human Design API? +

The Human Design API is a REST API that calculates Human Design bodygraph charts from birth data. It performs high-precision astronomical calculations and returns chart components including Type, Strategy, Authority, Profile, Centers, Gates, and Channels.

How do I calculate a Human Design chart programmatically? +

Send a POST request to /v1/simple-bodygraph with datetime in ISO 8601 format in the JSON body. The API returns chart data including Type, Profile, Centers, Gates, and Channels. Get your free API key at humandesignhub.app/developer.

Is there a free Human Design API? +

Yes. The Human Design API offers a free tier with 100 API credits per month and 5 requests per minute. The free tier includes the Simple Bodygraph endpoint for basic chart calculations.

What is a bodygraph and how does the API generate one? +

A bodygraph is the visual representation of a Human Design chart, showing 9 Centers, 64 Gates, and 36 Channels. The API calculates planetary positions at birth, maps them to the I Ching hexagram system, and returns structured data you can use to render bodygraph visualizations.

Can I build a Human Design calculator with this API? +

Absolutely. The API handles all astronomical calculations — you provide birth data (date, time, place) and receive a complete chart. Use the free tier for prototyping, then upgrade for full bodygraph data, composite charts, and interactive visualization components.

What programming languages work with the Human Design API? +

Any language that can make HTTP requests works with the API. We provide examples in cURL, JavaScript, and Python. The API returns JSON, making it easy to integrate with React, Vue, Angular, Node.js, Django, Flask, or any other framework.

How accurate is the Human Design API? +

The API uses a professional-grade astronomical calculation pipeline. Planetary positions are calculated to arc-second precision, ensuring highly accurate bodygraph calculations for any birth data from 1900 to 2100.

What is Group Penta analysis? +

Group Penta is a Human Design framework for analyzing team dynamics for groups of up to 5 people. Our API is the only one in the market that offers a Group Penta endpoint, making it possible to build team-building, HR tech, and group coaching applications.

Can I use the npm components without the API? +

The npm packages (@hdhub/bodygraph-2d, @hdhub/bodygraph-3d, @hdhub/gate-timeline) require chart data from the API to render. They are visualization components that consume the JSON response from any bodygraph endpoint. You need an active API subscription with SDK access (Standard plan or above).

How does the Human Design API compare to alternatives? +

We offer the most comprehensive Human Design API — the lowest paid entry at $9.99/month, the only meaningful free tier (100 credits/month), the only provider with React npm components for bodygraph visualization, and the only one with a Group Penta endpoint.

Start building with Human Design data today

Start with 100 free credits.

Get Free API Key