Generate a complete bodygraph

POST

bodygraphs

curl --request POST \
  --url https://api.humandesignapi.nl/v1/bodygraphs \
  --header 'Content-Type: application/json' \
  --header 'HD-Api-Key: <api-key>' \
  --header 'HD-Geocode-Key: <api-key>' \
  --data '
{
  "birthdate": "01-Jan-1990",
  "birthtime": "14:30",
  "location": "Haarlem, The Netherlands"
}
'

import requests

url = "https://api.humandesignapi.nl/v1/bodygraphs"

payload = {
    "birthdate": "01-Jan-1990",
    "birthtime": "14:30",
    "location": "Haarlem, The Netherlands"
}
headers = {
    "HD-Api-Key": "<api-key>",
    "HD-Geocode-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'HD-Api-Key': '<api-key>',
    'HD-Geocode-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    birthdate: '01-Jan-1990',
    birthtime: '14:30',
    location: 'Haarlem, The Netherlands'
  })
};

fetch('https://api.humandesignapi.nl/v1/bodygraphs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.humandesignapi.nl/v1/bodygraphs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'birthdate' => '01-Jan-1990',
    'birthtime' => '14:30',
    'location' => 'Haarlem, The Netherlands'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "HD-Api-Key: <api-key>",
    "HD-Geocode-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.humandesignapi.nl/v1/bodygraphs"

	payload := strings.NewReader("{\n  \"birthdate\": \"01-Jan-1990\",\n  \"birthtime\": \"14:30\",\n  \"location\": \"Haarlem, The Netherlands\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("HD-Api-Key", "<api-key>")
	req.Header.Add("HD-Geocode-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.humandesignapi.nl/v1/bodygraphs")
  .header("HD-Api-Key", "<api-key>")
  .header("HD-Geocode-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"birthdate\": \"01-Jan-1990\",\n  \"birthtime\": \"14:30\",\n  \"location\": \"Haarlem, The Netherlands\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.humandesignapi.nl/v1/bodygraphs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["HD-Api-Key"] = '<api-key>'
request["HD-Geocode-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"birthdate\": \"01-Jan-1990\",\n  \"birthtime\": \"14:30\",\n  \"location\": \"Haarlem, The Netherlands\"\n}"

response = http.request(request)
puts response.read_body

{
  "type": "Generator",
  "profile": "6/2",
  "channels_short": [
    "20-34",
    "10-57"
  ],
  "centers": [
    "G",
    "Sacral",
    "Spleen",
    "Throat"
  ],
  "strategy": "To Respond",
  "authority": "Sacral",
  "incarnation_cross": "Right Angle Cross of Tension (39/38 | 51/57)",
  "definition": "Split Definition",
  "signature": "Satisfaction",
  "not_self_theme": "Frustration",
  "cognition": "Smell",
  "determination": "Calm Appetite",
  "variables": "PLL DRL",
  "motivation": "Hope",
  "transference": "Guilt",
  "perspective": "Survival",
  "distraction": "Power",
  "environment": "Selective Caves",
  "circuitries": "Individual, Tribal",
  "channels_long": [
    "The Channel of Charisma (20-34)",
    "The Channel of the Brainwave (57-10)"
  ],
  "gates": [
    "20",
    "34",
    "10",
    "57"
  ],
  "activations": {
    "design": {
      "sun": "20.1",
      "earth": "34.1",
      "north_node": "10.3",
      "south_node": "15.3",
      "moon": "57.4",
      "mercury": "48.2",
      "venus": "18.5",
      "mars": "28.1",
      "jupiter": "32.6",
      "saturn": "50.3",
      "uranus": "44.2",
      "neptune": "26.4",
      "pluto": "54.1"
    },
    "personality": {
      "sun": "10.3",
      "earth": "15.3",
      "north_node": "57.4",
      "south_node": "51.4",
      "moon": "20.1",
      "mercury": "34.6",
      "venus": "5.2",
      "mars": "14.3",
      "jupiter": "46.1",
      "saturn": "29.5",
      "uranus": "2.4",
      "neptune": "23.6",
      "pluto": "43.2"
    }
  }
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

Authorizations

HD-Api-Key

string

header

required

Human Design API key

HD-Geocode-Key

string

header

required

Google Geocoding API key

Body

application/json

birthdate

string

required

Date of birth in a valid format

Example:

"01-Jan-1990"

birthtime

string

required

Time of birth in HH:MM format

Example:

"14:30"

location

string

required

Location of birth (city, country)

Minimum string length: 4

Example:

"Haarlem, The Netherlands"

Response

Successful bodygraph generation

type

string

Human Design type: Generator, Manifesting Generator, Projector, Manifestor, or Reflector

Example:

"Generator"

profile

string

Profile line combination (e.g. 6/2)

Example:

"6/2"

channels_short

string[]

Active channel connections as gate pairs

Example:

["20-34", "10-57"]

centers

string[]

Defined (active) energy centers

Example:

["G", "Sacral", "Spleen", "Throat"]

strategy

string

Decision-making strategy based on type

Example:

"To Respond"

authority

string

Inner authority for decision-making

Example:

"Sacral"

incarnation_cross

string

Incarnation cross with gate numbers

Example:

"Right Angle Cross of Tension (39/38 | 51/57)"

definition

string

How defined centers connect: Single, Split, Triple Split, Quad Split, or No Definition

Example:

"Split Definition"

signature

string

Emotional signature when living correctly

Example:

"Satisfaction"

not_self_theme

string

Emotional indicator of misalignment

Example:

"Frustration"

cognition

string

Cognitive processing style

Example:

"Smell"

determination

string

Dietary determination for wellbeing

Example:

"Calm Appetite"

variables

string

Variable configuration (arrow directions)

Example:

"PLL DRL"

motivation

string

Underlying motivation theme

Example:

"Hope"

transference

string

Not-self motivation pattern

Example:

"Guilt"

perspective

string

Perspective awareness theme

Example:

"Survival"

distraction

string

Not-self perspective pattern

Example:

"Power"

environment

string

Optimal physical environment

Example:

"Selective Caves"

circuitries

string

Active circuitry types (comma-separated)

Example:

"Individual, Tribal"

channels_long

string[]

Full channel names with gate numbers

Example:

[
  "The Channel of Charisma (20-34)",
  "The Channel of the Brainwave (57-10)"
]

gates

string[]

All activated gate numbers

Example:

["20", "34", "10", "57"]

activations

object

Planetary gate/line activations for both sides

Show child attributes

Generate a simplified bodygraphGenerates a simplified Human Design chart with type, profile, gates, channels, and centers.

Generate a complete bodygraph

curl --request POST \
  --url https://api.humandesignapi.nl/v1/bodygraphs \
  --header 'Content-Type: application/json' \
  --header 'HD-Api-Key: <api-key>' \
  --header 'HD-Geocode-Key: <api-key>' \
  --data '
{
  "birthdate": "01-Jan-1990",
  "birthtime": "14:30",
  "location": "Haarlem, The Netherlands"
}
'

import requests

url = "https://api.humandesignapi.nl/v1/bodygraphs"

payload = {
    "birthdate": "01-Jan-1990",
    "birthtime": "14:30",
    "location": "Haarlem, The Netherlands"
}
headers = {
    "HD-Api-Key": "<api-key>",
    "HD-Geocode-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'HD-Api-Key': '<api-key>',
    'HD-Geocode-Key': '<api-key>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    birthdate: '01-Jan-1990',
    birthtime: '14:30',
    location: 'Haarlem, The Netherlands'
  })
};

fetch('https://api.humandesignapi.nl/v1/bodygraphs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.humandesignapi.nl/v1/bodygraphs",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'birthdate' => '01-Jan-1990',
    'birthtime' => '14:30',
    'location' => 'Haarlem, The Netherlands'
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "HD-Api-Key: <api-key>",
    "HD-Geocode-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.humandesignapi.nl/v1/bodygraphs"

	payload := strings.NewReader("{\n  \"birthdate\": \"01-Jan-1990\",\n  \"birthtime\": \"14:30\",\n  \"location\": \"Haarlem, The Netherlands\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("HD-Api-Key", "<api-key>")
	req.Header.Add("HD-Geocode-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.humandesignapi.nl/v1/bodygraphs")
  .header("HD-Api-Key", "<api-key>")
  .header("HD-Geocode-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"birthdate\": \"01-Jan-1990\",\n  \"birthtime\": \"14:30\",\n  \"location\": \"Haarlem, The Netherlands\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.humandesignapi.nl/v1/bodygraphs")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["HD-Api-Key"] = '<api-key>'
request["HD-Geocode-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"birthdate\": \"01-Jan-1990\",\n  \"birthtime\": \"14:30\",\n  \"location\": \"Haarlem, The Netherlands\"\n}"

response = http.request(request)
puts response.read_body

{
  "type": "Generator",
  "profile": "6/2",
  "channels_short": [
    "20-34",
    "10-57"
  ],
  "centers": [
    "G",
    "Sacral",
    "Spleen",
    "Throat"
  ],
  "strategy": "To Respond",
  "authority": "Sacral",
  "incarnation_cross": "Right Angle Cross of Tension (39/38 | 51/57)",
  "definition": "Split Definition",
  "signature": "Satisfaction",
  "not_self_theme": "Frustration",
  "cognition": "Smell",
  "determination": "Calm Appetite",
  "variables": "PLL DRL",
  "motivation": "Hope",
  "transference": "Guilt",
  "perspective": "Survival",
  "distraction": "Power",
  "environment": "Selective Caves",
  "circuitries": "Individual, Tribal",
  "channels_long": [
    "The Channel of Charisma (20-34)",
    "The Channel of the Brainwave (57-10)"
  ],
  "gates": [
    "20",
    "34",
    "10",
    "57"
  ],
  "activations": {
    "design": {
      "sun": "20.1",
      "earth": "34.1",
      "north_node": "10.3",
      "south_node": "15.3",
      "moon": "57.4",
      "mercury": "48.2",
      "venus": "18.5",
      "mars": "28.1",
      "jupiter": "32.6",
      "saturn": "50.3",
      "uranus": "44.2",
      "neptune": "26.4",
      "pluto": "54.1"
    },
    "personality": {
      "sun": "10.3",
      "earth": "15.3",
      "north_node": "57.4",
      "south_node": "51.4",
      "moon": "20.1",
      "mercury": "34.6",
      "venus": "5.2",
      "mars": "14.3",
      "jupiter": "46.1",
      "saturn": "29.5",
      "uranus": "2.4",
      "neptune": "23.6",
      "pluto": "43.2"
    }
  }
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

{
  "timestamp": "2023-11-07T05:31:56Z",
  "success": false,
  "message": "<string>",
  "errorCode": "<string>",
  "type": "",
  "data": null
}

v2 Endpoints (Recommended)

v1 Endpoints (Legacy)

Reference

Generate a complete bodygraph

Authorizations

Body

Response