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

# Calculate Transit Window

`POST /v2/transit-window`

## Request

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

Calculates transit charts and gate-line transition events across a rolling window.

## Request body

- V2TransitWindowRequest
  - `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

- TransitWindowResponse: Response for POST /v1/transit-window
  - `base_datetime` string, required
  - `window_days` integer, required
  - `range` TransitWindowRange, required: Time range of the transit window.
    - `start` string, required
    - `end` string, 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)
