Documentation Forecasting & ReturnsGate calendar

Gate calendar

GET/gate-calendarRESTFrom Business

Get a monthly calendar of gate transits.

Build editorial calendars, daily prompts and transit products from scheduled Sun and planetary gate changes.

Authentication

Use Authorization: Bearer YOUR_API_KEY or X-Api-Key. Query-key authentication is deprecated compatibility behavior on supported REST routes and is rejected on Agent HTTP and MCP surfaces. Never put credentials in URLs, request bodies, or browser code.

Parameters

Name	In	Required	Description
`Idempotency-Key`	header	No	Strongly recommended stable 8–160 character key for consuming operations. Reuse it only when retrying the same request; without it, the API cannot deduplicate a lost-response retry. `hdai-example-19900515`
`X-Api-Key`	header	Yes	API key used by the authorization middleware. `YOUR_API_KEY`
`Year`	query	Yes	Calendar year. `2026`
`Month`	query	Yes	Calendar month from 1 to 12. `8`
`Timezone`	query	No	IANA timezone. `UTC`

Quota effect

A valid authorized execution uses exactly 1 calculation unit immediately before the calculation provider is reached. Invalid input, unresolved references, unsupported detail levels, and denied tiers use 0 units.

Errors

Expect 400 for invalid input, 401 for a missing or malformed key, 403 when the active plan does not include this operation, and 429 when the monthly allowance is exhausted.

Related operations

RequestcURL

curl "https://api.humandesign.ai/gate-calendar?Year=2026&Month=8&Timezone=UTC" \
  -H "Idempotency-Key: hdai-example-19900515" \
  -H "X-Api-Key: YOUR_API_KEY"

Verified response examplecURL

{
  "Year": 2026,
  "Month": 8,
  "MonthName": "August",
  "Timezone": "UTC",
  "Days": [
    {
      "Date": "2026-08-01",
      "DayOfMonth": 1,
      "DayOfWeek": "Saturday",
      "PlanetaryPositions": {
        "Sun": {
          "Gate": 33,
          "Line": 2,
          "Sign": "Leo",
          "IsRetrograde": false
        },
        "Earth": {
          "Gate": 19,
          "Line": 2,
          "Sign": "Aquarius",
          "IsRetrograde": false
        },
        "North Node": {
          "Gate": 30,
          "Line": 6,
          "Sign": "Aquarius",
          "IsRetrograde": true
        },
        "South Node": {
          "Gate": 29,
          "Line": 6,
          "Sign": "Leo",
          "IsRetrograde": true
        },
        "Moon": {
          "Gate": 63,
          "Line": 2,
          "Sign": "Pisces",
          "IsRetrograde": false
        },
        "Mercury": {
          "Gate": 53,
          "Line": 6,
          "Sign": "Cancer",
          "IsRetrograde": false
        },
        "Uranus": {
          "Gate": 20,
          "Line": 6,
          "Sign": "Gemini",
          "IsRetrograde": false
        },
        "Venus": {
          "Gate": 6,
          "Line": 3,
          "Sign": "Virgo",
          "IsRetrograde": false
        },
        "Mars": {
          "Gate": 12,
          "Line": 1,
          "Sign": "Gemini",
          "IsRetrograde": false
        },
        "Neptune": {
          "Gate": 17,
          "Line": 1,
          "Sign": "Aries",
          "IsRetrograde": true
        },
        "Saturn": {
          "Gate": 21,
          "Line": 6,
          "Sign": "Aries",
          "IsRetrograde": true
        },
        "Jupiter": {
          "Gate": 31,
          "Line": 6,
          "Sign": "Leo",
          "IsRetrograde": false
        }
      },
      "ActiveGates": [
        3,
        6
      ],
      "ActiveChannels": [
        "25-51",
        "30-41"
      ],
      "GateChanges": []
    },
    {
      "Date": "2026-08-02",
      "DayOfMonth": 2,
      "DayOfWeek": "Sunday",
      "PlanetaryPositions": {
        "Sun": {
          "Gate": 33,
          "Line": 3,
          "Sign": "Leo",
          "IsRetrograde": false
        },
        "Earth": {
          "Gate": 19,
          "Line": 3,
          "Sign": "Aquarius",
          "IsRetrograde": false
        },
        "North Node": {
          "Gate": 30,
          "Line": 6,
          "Sign": "Aquarius",
          "IsRetrograde": true
        },
        "South Node": {
          "Gate": 29,
          "Line": 6,
          "Sign": "Leo",
          "IsRetrograde": true
        },
        "Moon": {
          "Gate": 36,
          "Line": 3,
          "Sign": "Pisces",
          "IsRetrograde": false
        },
        "Mercury": {
          "Gate": 62,
          "Line": 1,
          "Sign": "Cancer",
          "IsRetrograde": false
        },
        "Uranus": {
          "Gate": 20,
          "Line": 6,
          "Sign": "Gemini",
          "IsRetrograde": false
        },
        "Venus": {
          "Gate": 6,
          "Line": 4,
          "Sign": "Virgo",
          "IsRetrograde": false
        },
        "Mars": {
          "Gate": 12,
          "Line": 2,
          "Sign": "Gemini",
          "IsRetrograde": false
        },
        "Neptune": {
          "Gate": 17,
          "Line": 1,
          "Sign": "Aries",
          "IsRetrograde": true
        },
        "Saturn": {
          "Gate": 21,
          "Line": 6,
          "Sign": "Aries",
          "IsRetrograde": true
        },
        "Jupiter": {
          "Gate": 31,
          "Line": 6,
          "Sign": "Leo",
          "IsRetrograde": false
        }
      },
      "ActiveGates": [
        3,
        6
      ],
      "ActiveChannels": [
        "17-62",
        "25-51"
      ],
      "GateChanges": [
        "Moon moves from Gate 63 to Gate 36",
        "Mercury moves from Gate 53 to Gate 62"
      ]
    }
  ],
  "Summary": {
    "TotalDays": 31,
    "MostActiveGates": [
      {
        "Gate": 17,
        "GateName": "Gate 17",
        "DaysActive": 31,
        "Center": "Ajna"
      },
      {
        "Gate": 20,
        "GateName": "Gate 20",
        "DaysActive": 31,
        "Center": "Throat"
      }
    ],
    "TotalGateChanges": 61,
    "SignificantDates": [
      "2026-08-06: Sun enters Gate 7",
      "2026-08-12: Sun enters Gate 4"
    ]
  }
}

Captured from the live API on 6 August 2026. 43/43 live checks passed. Secrets and account-specific usage are removed; large payloads show a truthful excerpt.

Free includes 100 calls every month.
Free members can use every operation labelled “From Free,” including the core Agent HTTP and MCP tools.