---
title: "Calculate Composite Compatibility Chart"
method: POST
path: "/v2/composite"
tags: ["composite-v2"]
---

# Calculate Composite Compatibility Chart

`POST /v2/composite`

## Request

- Base URL: `https://api.humandesignhub.app`
- URL: `https://api.humandesignhub.app/v2/composite`
- Auth: API key in header `X-API-KEY`

Calculates a two-person composite compatibility chart from birth datetimes. Chiron is retained in raw positions but does not activate Gates, Channels, Centers, or relationship channel classifications.

## Request body

- V2CompositeRequest
  - `a` V2CompositePersonRequest, required
    - `datetime` string, required: Birth datetime in ISO 8601 format with UTC offset
  - `b` V2CompositePersonRequest, required
    - `datetime` string, required: Birth datetime in ISO 8601 format with UTC offset
  - `verbose` boolean, nullable

## Response `200`

Successful Response

- CompositeResponse: Response for POST /v1/composite
  - `a` CompositePersonSection, required: One person's chart data in a composite.
    - `datetime` string, required
    - `positions` PersonalityDesignPositions, required: Personality and Design planetary longitude positions.
      - `personality` object, required
      - `design` object, required
    - `gate_and_line` PersonalityDesignGateAndLine, required: Personality and Design gate-and-line maps. Values are [gate, line] arrays (serialized from tuples).
      - `personality` object, required
      - `design` object, required
    - `gates` integer[], required
    - `channels` string[], required
    - `centers` string[], required
  - `b` CompositePersonSection, required: One person's chart data in a composite.
    - `datetime` string, required
    - `positions` PersonalityDesignPositions, required: Personality and Design planetary longitude positions.
      - `personality` object, required
      - `design` object, required
    - `gate_and_line` PersonalityDesignGateAndLine, required: Personality and Design gate-and-line maps. Values are [gate, line] arrays (serialized from tuples).
      - `personality` object, required
      - `design` object, required
    - `gates` integer[], required
    - `channels` string[], required
    - `centers` string[], required
  - `overlay` CompositeOverlaySection, required: Combined overlay data.
    - `gates` integer[], required
    - `channels` string[], required
    - `centers` string[], required
  - `composite` CompositeAnalysis, required: The composite analysis section.
    - `channels` CompositeChannels, required: Channel analysis categories in a composite.
      - `electromagnetic` string[], required
      - `companionship` string[], required
      - `compromise` CompositeCompromiseData, required: Compromise channels split by person.
        - `a` string[], required
        - `b` string[], required
      - `dominance` CompositeDominanceData, required: Dominance channels split by person.
        - `a` string[], required
        - `b` string[], required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/humandesignhub/apis/human-design-hub-pro-api.md) · [All operations](https://skmtc.dev/humandesignhub/apis/human-design-hub-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/humandesignhub/apis/human-design-hub-pro-api/revisions/c2681d2ac216?raw)