Human Design API reference

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"}'

{
  "type": "Manifestor",
  "typeLocalized": "Manifestador",
  "typeDescription": "An initiating, impactful aura built to start things and set them in motion. Informing others before acting clears resistance and brings peace.",
  "aura": "Closed and repelling. The field pushes outward and deflects influence, so a Manifestor is felt before anything is said, and others tend to brace against energy they cannot read.",
  "strategy": "Inform",
  "strategyLocalized": "Informar",
  "strategyDescription": "Inform everyone an action will affect, before taking it. This is not asking permission and not seeking approval: it removes the surprise that provokes resistance, which is what turns anger into peace.",
  "authority": "Emotional",
  "authorityLocalized": "Emocional",
  "authorityDescription": "Decisions are made across an emotional wave rather than inside a moment. The defined Solar Plexus moves on its own rhythm between hope and pain, so no single moment carries the truth: clarity is what remains once the wave has run its course and settled toward neutral. The trap is committing at the peak, where enthusiasm reads as certainty, or at the trough, where gloom reads as insight, and treating any pressure to answer now as a reason to skip the wait.",
  "signature": "Peace",
  "signatureLocalized": "Paz",
  "notSelf": "Anger",
  "notSelfLocalized": "Ira",
  "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": "Heretic over Investigator. A conscious projection field leads others to assume a solution is already at hand, and the unconscious first line quietly supplies the foundation that can actually answer. Reputation is both the currency and the risk: with real preparation the practical solution lands far beyond the personal, and without it the same projection curdles into blame.",
  "definition": "Split",
  "definitionLocalized": "Dividida",
  "definitionDescription": "The defined centers fall into two groups with no channel between them, so energy is consistent inside each group and does not cross the divide. The gap is bridged by the gates other people carry, which is why particular company can make thinking suddenly feel joined up, and why that company is easily mistaken for completion rather than recognized as a temporary bridge. What the configuration needs is time for the two areas to synthesize and awareness of who is bridging them, not a rushed decision taken while the halves are still speaking separately.",
  "sides": {
    "personality": "The conscious side, printed in black and calculated at the moment of birth.",
    "design": "The unconscious side, printed in red and calculated 88 degrees of solar arc before birth."
  },
  "designInstantUtc": "1972-03-14T00:55:56.900Z",
  "incarnationCross": {
    "gates": [
      51,
      57
    ],
    "angle": "Left Angle",
    "angleLocalized": "Ángulo Izquierdo",
    "angleCode": "LAX",
    "name": "Left Angle Cross of the Clarion",
    "description": "Shock delivered to whoever is ready for it. The reaction is often outrage, and underneath it is a change that was waiting for something to force it, which is why the shock needs a receiver."
  },
  "centers": [
    {
      "id": "sacral",
      "name": "Sacral",
      "nameLocalized": "Sacro",
      "defined": true,
      "motor": true,
      "awareness": false,
      "theme": "Sustainable life force and work energy. A reliable gut response that guides what to engage with.",
      "notSelfQuestion": "Is all this talking and doing an attempt to attract attention?",
      "biology": "The adrenal glands.",
      "gates": [
        5,
        14
      ]
    }
  ],
  "channels": [
    {
      "gateA": 20,
      "gateB": 34,
      "name": "Charisma",
      "nameLocalized": "Carisma",
      "circuit": "Individual",
      "circuitLocalized": "Individual",
      "centers": [
        "throat",
        "sacral"
      ],
      "description": "Sacral power is pushed straight to the Throat, so awareness in the present moment becomes action with almost no pause between them. The energy stays healthy only while it is busy with work it loves.",
      "circuitDescription": "Empowerment through mutation, carried by 15 channels. The knowing here cannot be explained or handed over, only lived, and it changes other people by exposure rather than instruction. It arrives as a pulse, never on demand."
    }
  ],
  "gates": [
    {
      "planet": "Sun",
      "planetLocalized": "Sol",
      "side": "personality",
      "gate": 51,
      "line": 5,
      "gateName": "Shock",
      "gateNameLocalized": "Choque",
      "gateDescription": "Willpower that shocks and competes. Sitting in the heart center, it moves first and startles, and that shock is what initiates others into a deeper connection with spirit.",
      "lineMeaning": "The group turns to this line when everything breaks. It reads the shape of the shock and rides it, and savoring the victory is what leaves it exposed to the next one.",
      "planetDescription": "The dominant activation. With the Earth it carries roughly 70 percent of the imprint on the chart. The Personality Sun gate is the conscious life theme, the Design Sun is the radiance the body broadcasts before a word is spoken.",
      "ichingHexagram": {
        "number": 51,
        "english": "The Arousing"
      }
    }
  ]
}

curl -X POST "https://roxyapi.com/api/v2/human-design/connection" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personA":{"date":"1990-07-15","time":"13:00:00","timezone":"America/New_York","latitude":0,"longitude":0,"nodeType":"true"},"personB":{"date":"1990-07-15","time":"13:00:00","timezone":"America/New_York","latitude":0,"longitude":0,"nodeType":"true"}}'

{
  "totalChannels": 14,
  "channels": [
    {
      "gateA": 34,
      "gateB": 20,
      "name": "Charisma",
      "nameLocalized": "Carisma",
      "circuit": "Individual",
      "circuitLocalized": "Individual",
      "centers": [
        "throat",
        "sacral"
      ],
      "dynamic": "Electromagnetic",
      "dynamicLocalized": "Electromagnético",
      "personAGates": [
        34
      ],
      "personBGates": [
        20
      ]
    }
  ],
  "centers": [
    {
      "id": "sacral",
      "name": "Sacral",
      "nameLocalized": "Sacro",
      "defined": true,
      "definedBy": [
        "A"
      ]
    }
  ],
  "combinedDefinition": "Single",
  "combinedDefinitionLocalized": "Simple",
  "summary": {
    "electromagnetic": 3,
    "dominance": 2,
    "compromise": 1,
    "companionship": 4
  }
}

curl -X POST "https://roxyapi.com/api/v2/human-design/penta" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"members":[{"date":"1990-07-15","time":"13:00:00","timezone":"America/New_York","latitude":0,"longitude":0,"nodeType":"true"},{"date":"1990-07-15","time":"13:00:00","timezone":"America/New_York","latitude":0,"longitude":0,"nodeType":"true"},{"date":"1990-07-15","time":"13:00:00","timezone":"America/New_York","latitude":0,"longitude":0,"nodeType":"true"}]}'

{
  "memberCount": 4,
  "channels": [
    {
      "gateA": 2,
      "gateB": 14,
      "name": "The Beat",
      "nameLocalized": "El Ritmo",
      "circuit": "Individual",
      "circuitLocalized": "Individual",
      "position": "lower",
      "isCore": true,
      "defined": true,
      "gateAHeldBy": [
        0,
        2
      ],
      "gateBHeldBy": [
        1
      ]
    }
  ],
  "gates": [
    {
      "gate": 15,
      "gateName": "Extremes",
      "gateNameLocalized": "Extremos",
      "filled": true,
      "heldBy": [
        0
      ]
    }
  ],
  "summary": {
    "definedChannels": 4,
    "filledGates": 9,
    "gapGates": [
      7,
      31
    ],
    "coreDefined": true
  }
}

curl -X POST "https://roxyapi.com/api/v2/human-design/transit" \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birthData":{"date":"1990-07-15","time":"13:00:00","timezone":"America/New_York","latitude":0,"longitude":0,"nodeType":"true"}}'

{
  "date": "2026-05-23",
  "time": "12:00:00",
  "timezone": 0,
  "activations": [
    {
      "body": "Sun",
      "bodyLocalized": "Sol",
      "gate": 51,
      "line": 3,
      "gateName": "Shock",
      "gateNameLocalized": "Choque",
      "ichingHexagram": {
        "number": 51,
        "english": "The Arousing"
      }
    }
  ],
  "completedChannels": [
    {
      "gateA": 34,
      "gateB": 20,
      "name": "Charisma",
      "nameLocalized": "Carisma",
      "circuit": "Individual",
      "circuitLocalized": "Individual",
      "centers": [
        "throat",
        "sacral"
      ],
      "kind": "personal",
      "kindLocalized": "personal",
      "natalGates": [
        34
      ],
      "transitGates": [
        20
      ]
    }
  ],
  "temporaryCenters": [
    {
      "id": "sacral",
      "name": "Sacral",
      "nameLocalized": "Sacro",
      "temporarilyDefined": true
    }
  ],
  "summary": "This transit completes 2 channels: 1 personal channel where the transit supplies the partner gate of a natal gate and 1 educational channel where the transit supplies both gates."
}

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

{
  "type": "Manifestor",
  "typeLocalized": "Manifestador",
  "typeDescription": "An initiating, impactful aura built to start things and set them in motion. Informing others before acting clears resistance and brings peace.",
  "aura": "Closed and repelling. The field pushes outward and deflects influence, so a Manifestor is felt before anything is said, and others tend to brace against energy they cannot read.",
  "strategy": "Inform",
  "strategyLocalized": "Informar",
  "strategyDescription": "Inform everyone an action will affect, before taking it. This is not asking permission and not seeking approval: it removes the surprise that provokes resistance, which is what turns anger into peace.",
  "authority": "Emotional",
  "authorityLocalized": "Emocional",
  "authorityDescription": "Decisions are made across an emotional wave rather than inside a moment. The defined Solar Plexus moves on its own rhythm between hope and pain, so no single moment carries the truth: clarity is what remains once the wave has run its course and settled toward neutral. The trap is committing at the peak, where enthusiasm reads as certainty, or at the trough, where gloom reads as insight, and treating any pressure to answer now as a reason to skip the wait.",
  "signature": "Peace",
  "signatureLocalized": "Paz",
  "notSelf": "Anger",
  "notSelfLocalized": "Ira",
  "profile": "5/1"
}

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

{
  "personality": [
    {
      "planet": "Sun",
      "planetLocalized": "Sol",
      "side": "personality",
      "gate": 51,
      "line": 5,
      "gateName": "Shock",
      "gateNameLocalized": "Choque",
      "gateDescription": "Willpower that shocks and competes. Sitting in the heart center, it moves first and startles, and that shock is what initiates others into a deeper connection with spirit.",
      "lineMeaning": "The group turns to this line when everything breaks. It reads the shape of the shock and rides it, and savoring the victory is what leaves it exposed to the next one.",
      "planetDescription": "The dominant activation. With the Earth it carries roughly 70 percent of the imprint on the chart. The Personality Sun gate is the conscious life theme, the Design Sun is the radiance the body broadcasts before a word is spoken.",
      "ichingHexagram": {
        "number": 51,
        "english": "The Arousing"
      }
    }
  ],
  "design": [
    {
      "planet": "Sun",
      "planetLocalized": "Sol",
      "side": "personality",
      "gate": 51,
      "line": 5,
      "gateName": "Shock",
      "gateNameLocalized": "Choque",
      "gateDescription": "Willpower that shocks and competes. Sitting in the heart center, it moves first and startles, and that shock is what initiates others into a deeper connection with spirit.",
      "lineMeaning": "The group turns to this line when everything breaks. It reads the shape of the shock and rides it, and savoring the victory is what leaves it exposed to the next one.",
      "planetDescription": "The dominant activation. With the Earth it carries roughly 70 percent of the imprint on the chart. The Personality Sun gate is the conscious life theme, the Design Sun is the radiance the body broadcasts before a word is spoken.",
      "ichingHexagram": {
        "number": 51,
        "english": "The Arousing"
      }
    }
  ]
}

curl "https://roxyapi.com/api/v2/human-design/gates/34" \
  -H "X-API-Key: YOUR_KEY"

{
  "number": 34,
  "name": "Power",
  "nameLocalized": "Poder",
  "center": "sacral",
  "centerName": "Sacral",
  "centerNameLocalized": "Sacro",
  "ichingHexagram": {
    "number": 34,
    "english": "The Power of the Great"
  },
  "channelPartners": [
    {
      "gate": 20,
      "channel": "Charisma",
      "channelLocalized": "Carisma"
    }
  ]
}

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

{
  "channels": [
    {
      "gateA": 20,
      "gateB": 34,
      "name": "Charisma",
      "nameLocalized": "Carisma",
      "circuit": "Individual",
      "circuitLocalized": "Individual",
      "centers": [
        "throat",
        "sacral"
      ],
      "description": "Sacral power is pushed straight to the Throat, so awareness in the present moment becomes action with almost no pause between them. The energy stays healthy only while it is busy with work it loves.",
      "circuitDescription": "Empowerment through mutation, carried by 15 channels. The knowing here cannot be explained or handed over, only lived, and it changes other people by exposure rather than instruction. It arrives as a pulse, never on demand."
    }
  ],
  "total": 3,
  "definedCenters": [
    "throat",
    "sacral"
  ]
}

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

{
  "centers": [
    {
      "id": "sacral",
      "name": "Sacral",
      "nameLocalized": "Sacro",
      "defined": true,
      "motor": true,
      "awareness": false,
      "theme": "Sustainable life force and work energy. A reliable gut response that guides what to engage with.",
      "notSelfQuestion": "Is all this talking and doing an attempt to attract attention?",
      "biology": "The adrenal glands.",
      "gates": [
        5,
        14
      ]
    }
  ],
  "definedCount": 4
}

curl "https://roxyapi.com/api/v2/human-design/centers/sacral" \
  -H "X-API-Key: YOUR_KEY"

{
  "id": "sacral",
  "name": "Sacral",
  "nameLocalized": "Sacro",
  "motor": true,
  "awareness": false,
  "definedMeaning": "Sustainable life force and work energy. A reliable gut response that guides what to engage with.",
  "undefinedMeaning": "No consistent access to work energy. Learns when enough is enough rather than driving to exhaustion."
}

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

{
  "profile": "5/1",
  "personalityLine": 5,
  "designLine": 1,
  "personalityKeynote": "Heretic: a universalizing, practical force others project expectations onto.",
  "designKeynote": "Investigator: builds a secure foundation through study before acting."
}

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

{
  "arrows": [
    {
      "key": "determination",
      "name": "Determination",
      "nameLocalized": "Determinación",
      "layer": "Primary Health System",
      "layerLocalized": "Sistema de Salud Primario",
      "position": "Top left",
      "positionLocalized": "Superior izquierda",
      "activation": {
        "planet": "Sun",
        "planetLocalized": "Sol",
        "side": "design"
      },
      "color": 4,
      "tone": 1,
      "base": 4,
      "direction": "left",
      "colorLabel": "Touch",
      "colorLabelLocalized": "Tacto",
      "directionLabel": "Active",
      "directionLabelLocalized": "Activo",
      "description": "The top left arrow, fed by the design Sun and Earth. It describes how the body is built to take in and break down nourishment, sensation, and information, and it sets the cognitive potential that rests on that intake.",
      "layerDescription": "The body-side half of Variable, covering the Determination and Environment arrows. It addresses the form: the conditions under which the vehicle digests nourishment, and the place in which it meets least resistance.",
      "colorMeaning": "Touch. Intake governed by contact and physical circumstance. What the body handles, and the state of the space it eats in, decide whether nourishment is absorbed or refused.",
      "toneMeaning": "Security. The tonal architecture rests on a baseline of safety. What is sound, familiar, and survivable registers first, and everything built above it stands on that footing.",
      "directionMeaning": "Active. Intake is filtered on the way in. The body engages nourishment and information with focus and structure, and works best under specific, deliberate conditions rather than open-ended variety.",
      "baseName": "Progressive",
      "baseNameLocalized": "Progresivo",
      "cognition": {
        "label": "Smell",
        "labelLocalized": "Olfato",
        "description": "Smell. Immediate, pre-verbal recognition through the nose. The body reads safety and suitability in an instant, and does best taking in one source at a time rather than a crowded field."
      },
      "confident": true
    }
  ],
  "confident": true,
  "confidenceMarginDeg": 0.00274,
  "baseDescription": "The finest substructure layer: one of five facets of the Personality Crystal, and the entry point for the imprint Tone and Color build on. Fixed across incarnation, and finer than any civil birth time resolves, so it is informational only."
}