Build a Human Design Calculator with Our API

What is a Human Design Calculator?

A Human Design calculator takes a person’s birth data — date, time, and place — and computes their unique bodygraph chart. This chart reveals their Type, Strategy, Authority, Profile, Centers, Gates, and Channels based on the exact positions of celestial bodies at the moment of birth.

The Human Design API handles all the complex astronomical calculations using the Swiss Ephemeris engine, so you can focus on building great user experiences.

How the API Calculates a Chart

The Human Design system uses two sets of planetary positions:

1. Personality (Conscious): Calculated from the exact birth moment
2. Design (Unconscious): Calculated from approximately 88 days before birth (when the Sun was 88° earlier in its orbit)

Both sets of planetary positions are mapped to the 64 hexagrams (Gates) of the I Ching, which correspond to specific positions on the bodygraph.

The API performs all of this automatically — you just provide the birth data.

Quick Start: Your First Chart Calculation

Using cURL

curl -X POST https://api.humandesignhub.app/v1/simple-bodygraph \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "birth_date": "1990-01-15",
    "birth_time": "14:30",
    "birth_place": "Seoul, South Korea"
  }'

Using JavaScript

const response = await fetch('https://api.humandesignhub.app/v1/simple-bodygraph', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    birth_date: '1990-01-15',
    birth_time: '14:30',
    birth_place: 'Seoul, South Korea',
  }),
});

const chart = await response.json();
console.log(`Type: ${chart.type}`);
console.log(`Strategy: ${chart.strategy}`);
console.log(`Authority: ${chart.authority}`);

Using Python

import requests

response = requests.post(
    'https://api.humandesignhub.app/v1/simple-bodygraph',
    headers={
        'Authorization': 'Bearer YOUR_API_KEY',
        'Content-Type': 'application/json',
    },
    json={
        'birth_date': '1990-01-15',
        'birth_time': '14:30',
        'birth_place': 'Seoul, South Korea',
    },
)

chart = response.json()
print(f"Type: {chart['type']}")
print(f"Strategy: {chart['strategy']}")
print(f"Authority: {chart['authority']}")

Understanding the Response

The API returns a structured JSON response containing:

Building a Full Calculator

For a production Human Design calculator, you’ll want to use the full /v1/bodygraph endpoint (available on Standard plan and above), which returns:

• All 9 Centers with defined/undefined status
• 64 Gates with activation data
• 36 Channels with connection info
• Planetary positions for both Personality and Design
• Profile lines and cross information

Visualization Options

The Human Design API also provides visualization components:

• Bodygraph Image API: Generate PNG images of bodygraphs via /v1/prompt/bodygraph-image (Standard+)
• 2D Bodygraph Component: Interactive SVG component via @hdhub/bodygraph-2d npm package (Standard+)
• 3D Bodygraph Component: WebGL visualization via @hdhub/bodygraph-3d npm package (Enterprise)

Pricing

Get your free API key →