🌍 Astrocartography API, 🔷 Human Design API and ✋ Palmistry API are now live. Ship them in your app today.

Core Bodygraph

Builds a person's core Human Design bodygraph from their birth data. Returns Type, Strategy, Authority, Profile, Definition, Incarnation Cross, Signature, Not-Self Theme, all 9 centers (defined/open per layer), 36 channels (active/inactive), 64 gates (active/inactive), and planetary activations split into design and personality layers. Uses two sky snapshots — the birth moment (personality) and ~88 solar degrees before birth (design) — to compute the full chart mechanics.
POSThttps://json.astrologyapi.com/v1/human-design

Authentication

x-astrologyapi-keystringrequired

API access token used to authenticate requests. Send your access token in this custom header.

Accept-Languagestring

Preferred language for the response content. Supported: English - en.

Body parameters

namestring

Name of the person. Optional.

genderstring

Gender of the person.

daynumberrequired

Day of birth (1-31).

monthnumberrequired

Month of birth (1-12).

yearnumberrequired

Year of birth.

hournumberrequired

Hour of birth (0-23).

minnumberrequired

Minute of birth (0-59).

latnumberrequired

Birth latitude (-90 to 90).

lonnumberrequired

Birth longitude (-180 to 180).

tzonenumberrequired

Timezone offset from UTC in hours.

Submit birth details using: name, gender, day, month, year, hour, min, lat, lon, tzone.
Next →
Chart Data
curl --location 'https://json.astrologyapi.com/v1/human-design' \
  --header 'Content-Type: application/json' \
  --header 'x-astrologyapi-key: <YOUR_ACCESS_TOKEN>' \
  --data '{
    "name": "Ajeet",
    "gender": "male",
    "day": "15",
    "month": "8",
    "year": "1990",
    "hour": "10",
    "min": "30",
    "lat": "39.9526",
    "lon": "-75.1652",
    "tzone": "-5"
}'
Try it

Runs with sample data — no API key needed

{
  "design_datetime_utc": "1990-05-15T15:43:11.999Z",
  "natal": {
    "authority": {
      "code": "EMOTIONAL",
      "label": "Emotional"
    },
    "definition": {
      "code": "TRIPLE_SPLIT",
      "label": "Triple Split Definition"
    },
    "incarnation_cross": {
      "angle_code": "JUXTAPOSITION",
      "angle_label": "Juxtaposition Cross of",
      "code": "CROSS_4_49_8_14",
      "label": "Juxtaposition Cross of Cross (4/49 | 8/14)",
      "name": "Cross",
      "gates": {
        "design_earth": 14,
        "design_sun": 8,
        "personality_earth": 49,
        "personality_sun": 4
      }
    },
    "not_self_theme": {
      "code": "ANGER",
      "label": "Anger"
    },
    "profile": {
      "code": "4/1",
      "design_line": 1,
      "personality_line": 4
    },
    "signature": {
      "code": "PEACE",
      "label": "Peace"
    },
    "strategy": {
      "code": "INFORM",
      "label": "Inform"
    },
    "type": {
      "code": "MANIFESTOR",
      "label": "Manifestor"
    }
  },
  "planetary_activations": {
    "design": [
      {
        "degree": 54.545546,
        "hd_position": "8.1.1.2.4",
        "planet_id": 1,
        "planet_name": "Sun"
      },
      {
        "degree": 234.545546,
        "hd_position": "14.1.1.2.4",
        "planet_id": 2,
        "planet_name": "Earth"
      },
      {
        "degree": 299.079615,
        "hd_position": "60.3.6.2.5",
        "planet_id": 3,
        "planet_name": "Moon"
      },
      {
        "degree": 310.254745,
        "hd_position": "19.3.5.5.5",
        "planet_id": 4,
        "planet_name": "North Node"
      },
      {
        "degree": 130.254745,
        "hd_position": "33.3.5.5.5",
        "planet_id": 5,
        "planet_name": "South Node"
      },
      {
        "degree": 37.994718,
        "hd_position": "24.1.3.3.1",
        "planet_id": 6,
        "planet_name": "Mercury"
      },
      {
        "degree": 12.995119,
        "hd_position": "21.4.5.3.2",
        "planet_id": 7,
        "planet_name": "Venus"
      },
      {
        "degree": 348.448958,
        "hd_position": "22.2.4.2.4",
        "planet_id": 8,
        "planet_name": "Mars"
      },
      {
        "degree": 99.571084,
        "hd_position": "39.1.1.3.4",
        "planet_id": 9,
        "planet_name": "Jupiter"
      },
      {
        "degree": 295.246772,
        "hd_position": "61.5.5.5.4",
        "planet_id": 10,
        "planet_name": "Saturn"
      },
      {
        "degree": 279.180061,
        "hd_position": "58.6.4.6.4",
        "planet_id": 11,
        "planet_name": "Uranus"
      },
      {
        "degree": 284.350595,
        "hd_position": "38.6.2.1.2",
        "planet_id": 12,
        "planet_name": "Neptune"
      },
      {
        "degree": 226.163098,
        "hd_position": "1.4.1.4.5",
        "planet_id": 13,
        "planet_name": "Pluto"
      }
    ],
    "personality": [
      {
        "degree": 142.545547,
        "hd_position": "4.4.6.3.5",
        "planet_id": 1,
        "planet_name": "Sun"
      },
      {
        "degree": 322.545547,
        "hd_position": "49.4.6.3.5",
        "planet_id": 2,
        "planet_name": "Earth"
      },
      {
        "degree": 78.899292,
        "hd_position": "45.3.1.1.5",
        "planet_id": 3,
        "planet_name": "Moon"
      },
      {
        "degree": 307.240473,
        "hd_position": "41.6.4.4.2",
        "planet_id": 4,
        "planet_name": "North Node"
      },
      {
        "degree": 127.240473,
        "hd_position": "31.6.4.4.2",
        "planet_id": 5,
        "planet_name": "South Node"
      },
      {
        "degree": 169.51045,
        "hd_position": "47.3.5.1.3",
        "planet_id": 6,
        "planet_name": "Mercury"
      },
      {
        "degree": 122.107016,
        "hd_position": "31.1.1.5.1",
        "planet_id": 7,
        "planet_name": "Venus"
      },
      {
        "degree": 51.469063,
        "hd_position": "23.3.5.4.4",
        "planet_id": 8,
        "planet_name": "Mars"
      },
      {
        "degree": 119.430656,
        "hd_position": "56.4.2.4.2",
        "planet_id": 9,
        "planet_name": "Jupiter"
      },
      {
        "degree": 289.853471,
        "hd_position": "54.6.1.2.3",
        "planet_id": 10,
        "planet_name": "Saturn"
      },
      {
        "degree": 275.967776,
        "hd_position": "58.3.2.3.2",
        "planet_id": 11,
        "planet_name": "Uranus"
      },
      {
        "degree": 282.190562,
        "hd_position": "38.3.6.2.2",
        "planet_id": 12,
        "planet_name": "Neptune"
      },
      {
        "degree": 225.089392,
        "hd_position": "1.2.6.5.4",
        "planet_id": 13,
        "planet_name": "Pluto"
      }
    ]
  },
  "centers": [
    {
      "design": "defined",
      "id": "head",
      "name": "Head",
      "natal": "defined",
      "personality": "open"
    },
    {
      "design": "defined",
      "id": "ajna",
      "name": "Ajna",
      "natal": "defined",
      "personality": "open"
    },
    {
      "design": "defined",
      "id": "throat",
      "name": "Throat",
      "natal": "defined",
      "personality": "open"
    },
    {
      "design": "defined",
      "id": "g_center",
      "name": "G Center",
      "natal": "defined",
      "personality": "open"
    },
    {
      "design": "open",
      "id": "heart",
      "name": "Heart",
      "natal": "defined",
      "personality": "open"
    },
    {
      "design": "open",
      "id": "spleen",
      "name": "Spleen",
      "natal": "open",
      "personality": "open"
    },
    {
      "design": "open",
      "id": "solar_plexus",
      "name": "Solar Plexus",
      "natal": "defined",
      "personality": "open"
    },
    {
      "design": "open",
      "id": "sacral",
      "name": "Sacral",
      "natal": "open",
      "personality": "open"
    },
    {
      "design": "open",
      "id": "root",
      "name": "Root",
      "natal": "defined",
      "personality": "open"
    }
  ],
  "channels": [
    {
      "design": "inactive",
      "id": "64-47",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": "61-24",
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "63-4",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "17-62",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "43-23",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "11-56",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "16-48",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "20-10",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "20-34",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "20-57",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "31-7",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": "8-1",
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "33-13",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "35-36",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "12-22",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "45-21",
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "5-15",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "14-2",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "29-46",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "42-53",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "3-60",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "9-52",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "27-50",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "59-6",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "34-10",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "34-57",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "57-10",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "32-54",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "28-38",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "18-58",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "44-26",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "40-37",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "49-19",
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "39-55",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "41-30",
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": "51-25",
      "natal": "inactive",
      "personality": "inactive"
    }
  ],
  "gates": [
    {
      "design": "active",
      "id": 1,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 2,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 3,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 4,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 5,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 6,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 7,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 8,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 9,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 10,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 11,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 12,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 13,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 14,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 15,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 16,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 17,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 18,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 19,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 20,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 21,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 22,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 23,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "active",
      "id": 24,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 25,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 26,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 27,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 28,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 29,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 30,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 31,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 32,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 33,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 34,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 35,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 36,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 37,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 38,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "active",
      "id": 39,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 40,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 41,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 42,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 43,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 44,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 45,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 46,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 47,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 48,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 49,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 50,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 51,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 52,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 53,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 54,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 55,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 56,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 57,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 58,
      "natal": "active",
      "personality": "active"
    },
    {
      "design": "inactive",
      "id": 59,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 60,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "active",
      "id": 61,
      "natal": "active",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 62,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 63,
      "natal": "inactive",
      "personality": "inactive"
    },
    {
      "design": "inactive",
      "id": 64,
      "natal": "inactive",
      "personality": "inactive"
    }
  ]
}