Composite Chart

POST`/api/composite`Pro

Generate a relationship chart between two people. Returns individual charts plus a combined analysis with connection channel dynamics.

Legacy URL

Also available at /api/v1/composite — the legacy URL is still fully supported.

Request

The composite endpoint requires birth data for both people:

Parameters

Parameter	Type	Required	Description
`birthDate`	string	Yes	Person A's date of birth (YYYY-MM-DD)
`birthTime`	string	Yes	Person A's time of birth (HH:MM, 24-hour)
`birthLocation`	string	Yes	Person A's birth city (e.g. "New York, NY")
`latitude`	number	No	Person A's latitude override
`longitude`	number	No	Person A's longitude override
`birthDate1`	string	Yes	Person B's date of birth (YYYY-MM-DD)
`birthTime1`	string	Yes	Person B's time of birth (HH:MM, 24-hour)
`birthLocation1`	string	Yes	Person B's birth city (e.g. "London, UK")
`latitude1`	number	No	Person B's latitude override
`longitude1`	number	No	Person B's longitude override

thd-api

Response

Response200

{
"success": true,
"meta": {
  "version": "1.0.0",
  "timestamp": "2026-03-15T12:00:00.000Z",
  "endpoint": "v1-composite"
},
"data": {
  "personA": {
    "birthInfo": { "..." : "..." },
    "chart": { "type": "Generator", "..." : "..." },
    "centers": { "..." : "..." },
    "channels": [ "..." ],
    "personality": { "..." : "..." },
    "design": { "..." : "..." }
  },
  "personB": {
    "birthInfo": { "..." : "..." },
    "chart": { "type": "Projector", "..." : "..." },
    "centers": { "..." : "..." },
    "channels": [ "..." ],
    "personality": { "..." : "..." },
    "design": { "..." : "..." }
  },
  "Combined": {
    "DefinedCenters": ["Sacral", "Throat", "G", "Spleen"],
    "OpenCenters": ["Head", "Ajna", "Heart", "Root"],
    "Properties": {
      "Definition": { "Name": "Split", "Description": "..." },
      "ConnectionTheme": { "ThemeDescription": "..." },
      "RelationshipChannels": {
        "Companionship": { "List": [] },
        "Dominance": { "List": [{ "gates": "1-8", "name": "Inspiration" }] },
        "Compromise": { "List": [] },
        "Electromagnetic": { "List": [{ "gates": "34-57", "name": "Power" }] }
      }
    }
  }
}
}

Relationship channel types

Type	Description
Companionship	Both people have the complete channel — shared energy, easy rapport
Dominance	One person has the complete channel, the other has neither gate — one-directional flow
Compromise	One person has the complete channel, the other has at least one gate — partial overlap
Electromagnetic	Each person contributes one gate — magnetic attraction, strongest pull

Tooltip variant

POST /api/composite?include=tooltips — Returns the same structure with full educational descriptions in both individual charts and the combined analysis. Also available at the legacy URL /api/v1/composite-tooltip.