# Human Design Bodygraph API

> Human Design Bodygraph API. Generate a complete Human Design bodygraph from a birth date, time, and timezone. Returns the energy type, strategy, inner

- Capability page: https://roxyapi.com/apis/bodygraph-api
- Full domain: https://roxyapi.com/products/human-design-api
- OpenAPI spec: https://roxyapi.com/api/v2/human-design/openapi.json
- Remote MCP server: https://roxyapi.com/mcp/human-design

## Overview

Generate a complete Human Design bodygraph from a birth date, time, and timezone. Returns the energy type, strategy, inner authority, signature, not-self theme, profile, definition, incarnation cross, all nine centers with defined state and active gates, the defined channels, and all 26 planetary activations across the Personality and Design sides. The single endpoint for a full chart in one call, built for Human Design apps, readings, and coaching tools.

## Endpoints

- `POST /api/v2/human-design/bodygraph` Generate full Human Design bodygraph - Type, authority, profile, centers, channels, gates
- `POST /api/v2/human-design/type` Calculate Human Design type, authority and profile
- `POST /api/v2/human-design/profile` Calculate the Human Design profile and line keynotes
- `POST /api/v2/human-design/transit` Generate Human Design transit overlay - Current planetary activations on a natal bodygraph
- `POST /api/v2/human-design/variables` Calculate Human Design Variables - The four arrows and Color, Tone, Base substructure

## Example request

```bash
curl -X POST "https://roxyapi.com/api/v2/human-design/bodygraph" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date":"1990-07-15","time":"13:00:00","timezone":"America/New_York"}'
```

## Example response

```json
{
  "type": "Manifestor",
  "typeDescription": "An initiating, impactful aura built to start things and set them in motion. Informing others before acting removes resistance and brings peace.",
  "aura": "string",
  "strategy": "Inform",
  "strategyDescription": "string",
  "authority": "Emotional",
  "authorityDescription": "string",
  "signature": "Peace",
  "notSelf": "Anger",
  "profile": "5/1",
  "profileKeynotes": {
    "personalityLine": 5,
    "designLine": 1,
    "personality": "Heretic: a universalizing, practical force others project expectations onto.",
    "design": "Investigator: builds a secure foundation through study before acting."
  },
  "profileDescription": "string",
  "definition": "Split",
  "definitionDescription": "string",
  "sides": {},
  "incarnationCross": {
    "gates": [
      51,
      57,
      61,
      62
    ],
    "angle": "Left Angle",
    "angleCode": "LAX",
    "name": "Left Angle Cross of the Clarion"
  },
  "centers": [
    {
      "id": "sacral",
      "name": "Sacral",
      "defined": true,
      "motor": true,
      "awareness": false,
      "theme": "string",
      "notSelfQuestion": "Is all this talking and doing an attempt to attract attention?",
      "biology": "The adrenal glands.",
      "gates": [
        5,
        14,
        34
      ]
    }
  ],
  "channels": [
    {
      "gateA": 34,
      "gateB": 20,
      "name": "Charisma",
      "circuit": "Individual",
      "centers": [
        "throat",
        "sacral"
      ],
      "description": "string",
      "circuitDescription": "string"
    }
  ],
  "gates": [
    {
      "planet": "Sun",
      "side": "personality",
      "gate": 51,
      "line": 5,
      "gateName": "Shock",
      "gateDescription": "string",
      "lineMeaning": "string",
      "planetDescription": "string",
      "ichingHexagram": {
        "number": 51,
        "english": "The Arousing"
      }
    }
  ]
}
```

## Remote MCP

Every endpoint is a callable tool on the Remote MCP server at https://roxyapi.com/mcp/human-design over Streamable HTTP. Tool name for `POST /human-design/bodygraph`: `post_human_design_bodygraph`. `tools/list` is free; `tools/call` bills the same as REST.

## FAQ

### What does the Human Design Bodygraph API return?

Generate a complete Human Design bodygraph from a birth date, time, and timezone. Every response is structured JSON with documented fields, not free text, so you map it straight into your product.

### How do I authenticate with the Human Design Bodygraph API?

Pass your key in the X-API-Key header on every request. Keys are delivered instantly at checkout with no approval queue. Use a secret sk key server side, or mint a publishable pk key locked to your origins for browser and no-code use.

### Does the Human Design Bodygraph API support multiple languages?

Yes. Append the lang query parameter to any endpoint for responses in English, German, Spanish, French, Hindi, Portuguese, Russian and Turkish. The translated payload includes the full interpretation text, not just field labels.

### Do I need coordinates to call the Human Design Bodygraph API?

No. Call GET /location/search with a city name first, then pass latitude, longitude, and timezone from the first result into the request. Never ask users to type coordinates. Timezone accepts a decimal offset or an IANA name.

### Is the Human Design Bodygraph API available over Remote MCP for AI agents?

Yes. Every endpoint is exposed as a callable tool on the Remote MCP server at https://roxyapi.com/mcp/human-design over Streamable HTTP, so Claude, ChatGPT, Cursor, and any MCP client auto-discover it with no local setup or Docker.

### How is the Human Design Bodygraph API billed?

Flat pricing: 1 request equals 1 quota unit, REST and MCP identical, with no credit weighting or per-token markup. Every plan includes all 12 domains, so the Human Design Bodygraph API is included at no extra cost.

### What lang values does the Human Design Bodygraph API accept?

The lang parameter accepts en, tr, de, es, hi, pt, fr, ru. Case-insensitive where it is a path value.

## Full reference

Fetch the OpenAPI spec at https://roxyapi.com/api/v2/human-design/openapi.json. Master agent manifest at https://roxyapi.com/llms.txt.