---
title: "Calculate Personal Transit Overlay"
method: POST
path: "/v2/transit-overlay"
tags: ["transit-v2"]
---

# Calculate Personal Transit Overlay

`POST /v2/transit-overlay`

## Request

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

Combines a natal chart with a transit chart using birth and transit datetimes.

## Request body

- V2TransitOverlayRequest
  - `birth_datetime` string, required: Birth datetime in ISO 8601 format
  - `transit_datetime` string, required: Transit datetime in ISO 8601 format

## Response `200`

Successful Response

- TransitOverlayResponse: Response for POST /v1/transit-overlay
  - `birth` TransitOverlayBirthSection, required: Birth (natal) section of a transit overlay.
    - `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
  - `transit` TransitOverlayTransitSection, required: Transit section of a transit overlay.
    - `datetime` string, required
    - `positions` object, required
    - `gate_and_line` object, required
    - `gates` integer[], required
    - `channels` string[], required
  - `overlay` TransitOverlayOverlaySection, required: Overlay (combined) section.
    - `gates` integer[], required
    - `channels` 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)