The First Professional Human Design API

The BodyGraph calculation involves two moments: (1) Personality side - planetary positions at exact birth time, (2) Design side - planetary positions ~88 days before birth (when Sun is 88° behind natal position).

Our API uses Swiss Ephemeris (NASA JPL DE431 data) for sub-arcminute precision.

Each planet activates a specific Gate (1-64) based on its zodiacal position.

These Gates connect to Centers, forming Channels when both ends are activated.

The result: your unique energetic blueprint including Type (how you exchange energy), Strategy (how to make decisions), Authority (your decision-making center), and Profile (your life role).

Human Design defines 5 energy Types: (1) Manifestors (~9%) - defined Throat connected to Motor center, not Sacral.

Strategy: Inform before acting.

(2) Generators (~37%) - defined Sacral center.

Strategy: Wait to respond.

(3) Manifesting Generators (~33%) - defined Sacral AND Throat-Motor connection.

Strategy: Wait to respond, then inform.

(4) Projectors (~20%) - no Sacral, no Throat-Motor connection.

Strategy: Wait for invitation.

(5) Reflectors (~1%) - all 9 Centers undefined.

Strategy: Wait lunar cycle.

Our API instantly determines Type with the /type endpoint in ~100ms.

How we compare to competitors: (1) humandesignapi.com: $25-200/mo subscription, basic BodyGraph, compatibility feature, no transits, no AI, English only.

(2) humandesignapi.nl: €229-269 one-time (going subscription 2026), Gates/Channels/Centers, Variables only in Advanced plan, no transits, no AI, English only.

(3) totalhumandesign.com: $180-220 one-time, unlimited calls, includes astrology house placements, no transits, no AI, English only.

Our advantages: Free tier (50/month), <300ms response (vs unknown), transit overlays (exclusive), AI interpretations (GPT-5+Claude), 100+ Astrology endpoints, 13+ languages, 99.97% uptime SLA, full SDKs.

Pro Plus at $21/mo, or Ultra at $37/mo for 11,000 BodyGraphs (55,000 credits ÷ 5 credits each).

Integration is straightforward: (1) Get API key from dashboard (instant, no approval), (2) POST birth data to /human-design/bodygraph endpoint, (3) Receive JSON with complete BodyGraph in <300ms.

Quick endpoints available: /type for Type-only (~100ms), /design-date for Design moment calculation.

SDKs available for JavaScript, Python, PHP, Ruby.

Example use cases: astrology apps adding HD features, dating apps using compatibility, wellness platforms showing daily transits, coaching tools with full BodyGraph analysis.

Our compatibility API analyzes two BodyGraphs for relationship dynamics.

It calculates: electromagnetic connections (where your definitions attract), compromise channels (potential friction points), dominance patterns (who leads in which areas), and composite definition (combined energy flow).

Returns compatibility scores for emotional, mental, and physical connection.

Perfect for dating apps seeking deeper matching than sun signs, coaching platforms analyzing team dynamics, or relationship counseling tools.

Response includes interpretations explaining each connection type.

Transits show how current planetary positions temporarily activate your BodyGraph.

Our /transits endpoint overlays today's gates on your natal chart, showing: which centers are temporarily defined, new channels forming, and how your Type might shift.

Includes 24-hour forecast showing upcoming activations.

Use cases: daily guidance features, tracking specific gates (like Gate 51 for shock/initiation), building transit calendars.

Transit overlays combined with natal charts create personalized daily readings - a key feature for wellness and self-discovery apps.

Our API renders complete Bodygraph charts server-side as publication-quality SVGs.

The output includes all 9 Centers (color-coded when defined), 64 Gate positions with labels, 36 Channel connections as styled paths, and an optional body silhouette overlay.

Side panels display Personality (conscious) and Design (unconscious) planetary positions with gate.line details and exaltation/detriment markers.

Choose Classic (light, #F5F0EB background) or Dark (#1A1A2E background) theme.

Customize with 5 font presets (EB Garamond, Inter, Roboto, etc.), custom hex colors for any element, scale from 0.5x to 4x for retina displays, and toggle gates, silhouette, variables, and type info.

Export as SVG for interactive web embedding (with CSS hover effects on gates), or convert server-side to PNG, PDF, or WebP for reports and social sharing.

Transit overlays add dashed green lines showing current planetary activations alongside the natal chart.

While Bodygraph.com offers a solid Human Design API with basic chart data and inline SVG generation, our API provides significantly more depth.

Key differences: (1) Transit analysis - we offer full transit overlay calculations and SVG rendering, they don't have it.

(2) Hanging gates - we identify activated gates without their channel partner, showing potential connections.

(3) Circuit analysis - we break down activations by Individual/Collective/Tribal/Integration circuits with sub-circuit detail.

(4) Definition bridges - for Split types, we identify bridging channels that connect separated center groups.

(5) Channel activation source - we track conscious/unconscious/mixed for each channel.

(6) SVG customization - we offer dedicated endpoints with themes, custom fonts, colors, scale, and raster export.

(7) Multi-language - 10+ languages vs English only.

(8) Compatibility SVG - dedicated connection chart with color-coded overlays.

(9) Glossary endpoints - 3 GET endpoints for reference data.

Plus our full astrology platform with 100+ endpoints.