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

# Calculate Personal Transit Overlay Window

`POST /v2/transit-overlay-window`

## Request

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

Combines a natal chart with transit positions across a rolling window.

## Request body

- V2TransitOverlayWindowRequest
  - `birth_datetime` string, required: Birth datetime in ISO 8601 format
  - `base_datetime` string, required: Base transit datetime in ISO 8601 format
  - `window_days` integer, nullable: Window size in days around the base datetime

## Response `200`

Successful Response

- TransitOverlayWindowResponse: Response for POST /v1/transit-overlay-window
  - `birth_datetime` string, required
  - `base_datetime` string, required
  - `window_days` integer, required
  - `range` TransitWindowRange, required: Time range of the transit window.
    - `start` string, required
    - `end` string, required
  - `birth_gates` integer[], required
  - `birth_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
  - `base_transit` TransitResponse, required: Response for POST /v1/transit
    - `datetime` string, required
    - `jd` number, required
    - `positions` object, required
    - `gate_and_line` object, required
    - `gates` integer[], required
    - `channels` string[], required
    - `centers` string[], required
  - `events_by_body` object, 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)