Getting started
Make your first THD API call in under 5 minutes.
Prerequisites
- An API key from Studio
- Node.js 18+ or Python 3.10+
Authenticate
All requests require a Bearer token. Generate a key at /keys.
Authorization: Bearer $THD_API_KEYFirst API call — bodygraph
Use one of the following to generate a Human Design bodygraph:
curl -X POST "https://api.totalhumandesign.com/pi/v1/chart/bodygraph" \
-H "Authorization: Bearer $THD_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Jane Doe","birthDate":"1990-06-15","birthTime":"14:30","birthPlace":"New York, NY"}'const response = await fetch("https://api.totalhumandesign.com/pi/v1/chart/bodygraph", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.THD_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
name: "Jane Doe",
birthDate: "1990-06-15",
birthTime: "14:30",
birthPlace: "New York, NY",
}),
})
const data = await response.json()
console.log(data)Response
A successful call returns a chart object with type, authority, profile, gates, channels, and centers.
{
"success": true,
"data": {
"type": "Generator",
"authority": "Sacral",
"profile": "2/4",
"definition": "Single",
"incarnationCross": "Right Angle Cross of the Sphinx",
"centers": {},
"channels": [],
"gates": []
}
}See Core Concepts for field definitions.