Human Design Chart API — Complete Developer Guide

Overview

The Human Design Chart API provides programmatic access to complete bodygraph calculations. Every chart is computed in real-time using the Swiss Ephemeris engine — the same astronomical library used by professional astrologers worldwide.

Chart Components

A Human Design chart (bodygraph) consists of several interconnected components:

Type

There are 5 Human Design types, each with a distinct energy pattern:

• Generator (~37% of population) — Sustained life force energy
• Manifesting Generator (~33%) — Multi-passionate, fast-moving energy
• Projector (~20%) — Guiding and managing energy
• Manifestor (~8%) — Initiating energy
• Reflector (~1%) — Reflective, lunar-cycle energy

Strategy

Each type has a unique decision-making strategy:

• Generators & Manifesting Generators: “To Respond”
• Projectors: “Wait for the Invitation”
• Manifestors: “To Inform”
• Reflectors: “Wait a Lunar Cycle”

Authority

The inner authority determines how a person makes correct decisions. Types include Emotional, Sacral, Splenic, Ego, Self-Projected, Mental, and Lunar.

Centers

The bodygraph has 9 Centers (energy hubs), each representing a different aspect of human experience:

• Head, Ajna, Throat, G/Self, Heart/Ego, Sacral, Solar Plexus, Spleen, Root

Gates and Channels

64 Gates (derived from the I Ching hexagrams) connect through 36 Channels between Centers. When a channel is fully activated, it creates a “definition” that shapes the person’s consistent energy.

API Endpoints

Simple Bodygraph (Free Tier)

POST /v1/simple-bodygraph

Returns: Type, Strategy, Authority, Profile, Definition

Full Bodygraph (Standard+)

POST /v1/bodygraph

Returns: Complete chart with all 9 Centers, 64 Gates, 36 Channels, planetary data

Circuit Analysis (Basic+)

POST /v1/circuits

Returns: Individual, Collective, and Tribal circuit activations

Authentication

All API requests require a Bearer token:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.humandesignhub.app/v1/simple-bodygraph

Get your free API key at the Developer Dashboard.

Rate Limits & Credits

Each endpoint has a different credit cost — see the pricing page for details.

Start building with the Human Design API →