I Built the Only Human Design API — Here's How to Use It
Human Design is a personality and decision-making system used by millions worldwide — but there was no public API for it. So I built one.
After months of research into the Swiss Ephemeris engine and Human Design mechanics, I've released the first open public API for generating Human Design charts programmatically. Whether you're building a wellness app, a personality platform, or integrating HD analysis into your product, this API eliminates the need to reverse-engineer calculations or build your own engine from scratch.
What is Human Design?
Human Design combines astrology, I Ching, Kabbalah, and the chakra system into a unified framework for understanding personality and decision-making.
Here's the elevator pitch: You provide your birth date, time, and location. The system calculates your bodygraph — an energetic blueprint that reveals three core things:
- Type: How you interact with the world (Generator, Manifesting Generator, Manifesto, Projector, or Reflector)
- Strategy: Your decision-making approach (To Respond, To Initiate, To Inform, To Invite, or To Wait)
- Authority: Your inner compass — which part of yourself to trust (Sacral, Spleen, Solar Plexus, Heart, Throat, G-Center, or Head)
It's been adopted by coaches, therapists, organizational consultants, and increasingly by app developers who want to add personalized Human Design insights to their platforms.
Why I Built an API
Three reasons:
1. There was no public API. Existing HD tools were locked behind paywalls or closed-source platforms. No way to integrate HD calculations into custom apps.
2. The calculation engine is non-trivial. Human Design relies on precise astronomical calculations via the Swiss Ephemeris library — the same engine used by professional astrology software. Building this from scratch takes months and requires deep astronomical knowledge.
3. Developers needed a simple, fast, standard way to access HD data. A REST API with JSON responses, rate limiting, and tiered access would unlock use cases that weren't possible before.
So I built it with FastAPI (Python), powered by Swiss Ephemeris for astronomical accuracy, deployed on Kubernetes, and released with a free tier (100 credits/month) plus paid plans for production apps.
How It Works
The API is dead simple — REST endpoints returning JSON.
Base URL: https://api.humandesignhub.app/v1
Authentication: Pass your API key as the X-API-Key header.
Core Endpoints:
-
/simple-bodygraph— Generate a basic bodygraph (Type, Strategy, Authority, Profile) -
/full-bodygraph— Complete chart with gates, lines, channels, and circuits -
/transit— Calculate transits and planetary influences for a given date -
/composite— Analyze compatibility between two people -
/circuits— Explore the electromagnetic circuits and flow of energy
All responses are clean JSON, fully typed, and documented.
Quick Example: Python
Here's how to calculate someone's bodygraph in Python:
import requests
response = requests.post(
"https://api.humandesignhub.app/v1/simple-bodygraph",
headers={
"Content-Type": "application/json",
"X-API-Key": "your_api_key_here",
},
json={"datetime": "1990-01-01T12:34+09:00"},
)
data = response.json()
print(f"Type: {data['type']}") # Generator
print(f"Strategy: {data['strategy']}") # To Respond
print(f"Authority: {data['authority']}") # Sacral
print(f"Profile: {data['profile']}") # 3/5
print(f"Not-Self Theme: {data['not_self_theme']}") # Frustration
That's it. One API call, and you have the core HD data.
Quick Example: JavaScript
Using fetch:
const response = await fetch(
"https://api.humandesignhub.app/v1/simple-bodygraph",
{
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": "your_api_key_here",
},
body: JSON.stringify({
datetime: "1990-01-01T12:34+09:00",
}),
},
);
const data = await response.json();
console.log(`Type: ${data.type}`);
console.log(`Strategy: ${data.strategy}`);
console.log(`Authority: ${data.authority}`);
console.log(`Profile: ${data.profile}`);
The datetime should be ISO 8601 formatted with timezone info — the API handles the rest.
What You Can Build
This opens up a bunch of possibilities:
- Personality Quiz Apps — Answer questions, generate your chart, discover your type
- Compatibility Tools — Two birth charts → analyze your relationship dynamics
- Daily Transit Forecasts — Tell users how planetary transits affect them today
- Coaching Platforms — Auto-generate personalized reports for clients
- Mobile Apps — Integrate HD analysis into wellness or astrology apps
- Team Dynamics Platforms — Show how different types work together in organizations
If you're building anything in wellness, self-discovery, or astrology, this API probably saves you 3-6 months of development time.
Getting Started
- Sign up for a free API key: https://humandesignhub.app/developer
- Read the full API docs: https://humandesignhub.app/docs
- Explore code examples: https://github.com/k4771kim/human-design-api-examples
- Check the landing page: https://humandesignhub.app/human-design-api
The free tier gives you 100 credits/month (plenty for prototyping). Paid plans start at $29/month for production apps.
What's Next
The roadmap includes:
- Deeper circuit analysis and psychological profiles
- AI-powered chart interpretations
- Composite analysis for groups (penta analysis)
- WebSocket support for real-time transits
- SDKs for Node.js, Python, and Go
Final Thoughts
If you're building anything in the wellness, astrology, or self-discovery space, this API might save you months of building your own calculation engine.
Human Design is gaining real traction with mainstream audiences. Having a simple, reliable way to generate charts programmatically unlocks a whole new category of apps.
Questions? Feedback? Spotted a bug? Drop a comment below — I'm actively maintaining this and want to hear what you'd build with it.
Links:
Top comments (0)