{"service":"Human Design API Server","version":"4.0.0","auth":"Bearer token required","rateLimit":{"enabled":true,"maxConcurrent":100,"queueCapacity":12000,"maxQueueWait":"120s","note":"Requests exceeding concurrent limit are queued. Queue wait time returned in X-Queue-Wait-Ms header."},"features":{"staticDatabase":"Major cities worldwide","googleMapsIntegration":"Disabled (offline-only)","asteroids":"Chiron, Ceres, Pallas, Juno, Vesta","chartAngles":"AC, MC, IC, DC","compositeCharts":"Relationship analysis with electromagnetic, compromise, dominance, companionship channels","transits":"Universal planetary transit positions over date ranges","sageKnowledge":"AI-mediated answers from the THD knowledge base","routeMetadata":"Public, legacy, and internal route status is tracked in ENDPOINT_METADATA"},"endpoints":{"/api/chart":{"category":"human_design","products":["advanced_chart"],"notes":"data.extras deprecates on 2026-06-01"},"/api/astrology":{"category":"astrology","products":["advanced_chart"]},"/api/bazi":{"category":"bazi","products":["basic_chart","advanced_chart"]},"/api/composite":{"category":"human_design","products":["advanced_chart"]},"/api/transits/moon":{"category":"transits","products":["advanced_chart"]},"/api/transits/all":{"category":"transits","products":["advanced_chart"]},"/api/transits/periods":{"category":"transits","products":["advanced_chart"]},"/api/transits/chart":{"category":"transits","products":["advanced_chart"]},"/api/retrogrades":{"category":"transits","products":["advanced_chart"]},"/api/eclipses":{"category":"transits","products":["advanced_chart"]},"/api/returns":{"category":"returns","products":["advanced_chart"]},"/api/multi-chart":{"category":"human_design","products":["advanced_chart"]},"/api/sage":{"category":"knowledge_ai","products":["sage_api"]}},"legacyEndpoints":{"/api/v1/data":{"category":"human_design","products":["basic_chart","advanced_chart"],"replacement":"/api/chart"},"/api/v1/data-tooltip":{"category":"human_design","products":["basic_chart","advanced_chart"],"replacement":"/api/chart?include=tooltips"},"/api/human-design":{"category":"human_design","products":["basic_chart","advanced_chart"],"replacement":"/api/chart"},"/api/v1/composite":{"category":"human_design","products":["advanced_chart"],"replacement":"/api/composite"},"/api/v1/composite-tooltip":{"category":"human_design","products":["advanced_chart"],"replacement":"/api/composite?include=tooltips"},"/api/v2/data":{"category":"human_design","products":["advanced_chart"],"replacement":"/api/chart","notes":"data.extras deprecates on 2026-06-01"},"/api/v2/data-tooltip":{"category":"human_design","products":["advanced_chart"],"replacement":"/api/chart?include=tooltips","notes":"data.extras deprecates on 2026-06-01"},"/api/v1/astrology":{"category":"astrology","products":["advanced_chart"],"replacement":"/api/astrology"},"/api/v1/astrology-tooltip":{"category":"astrology","products":["advanced_chart"],"replacement":"/api/astrology?include=tooltips"},"/api/v1/saju":{"category":"bazi","products":["basic_chart","advanced_chart"],"replacement":"/api/bazi"},"/api/v1/saju/chart.svg":{"category":"bazi","products":["basic_chart","advanced_chart"]},"/api/sage/query":{"category":"knowledge_ai","products":["sage_api"],"replacement":"/api/sage"},"/api/transit/moon-range":{"category":"transits","products":["advanced_chart"],"replacement":"/api/transits/moon"},"/api/transit-range":{"category":"transits","products":["advanced_chart"],"replacement":"/api/transits/all"},"/api/transit-periods":{"category":"transits","products":["advanced_chart"],"replacement":"/api/transits/periods"},"/api/retrograde-periods":{"category":"transits","products":["advanced_chart"],"replacement":"/api/retrogrades"},"/api/v2/transit-chart":{"category":"transits","products":["advanced_chart"],"replacement":"/api/transits/chart"}},"deprecations":{"chartExtras":{"code":"chart_extras_deprecation","field":"data.extras","message":"data.extras on Human Design chart responses is deprecated and scheduled for removal on 2026-06-01. Use /api/astrology for Chiron, asteroids, Lilith, Part of Fortune, angles, houses, and other astrology-specific points.","removalDate":"2026-06-01","replacementEndpoint":"/api/astrology"}},"internal":{"v3":"True Inner Authority routes remain available only to legacy API_KEY internal systems and are not part of the public developer API."},"transitEndpoints":{"moonRange":{"method":"GET","path":"/api/transit/moon-range","params":"startDate, endDate (required), granularity (optional: daily|hourly)","example":"/api/transit/moon-range?startDate=2024-01-01&endDate=2024-01-07&granularity=daily"},"allPlanets":{"method":"GET","path":"/api/transit-range","params":"startDate, endDate (required), granularity (optional: daily|hourly)","example":"/api/transit-range?startDate=2024-01-01&endDate=2024-01-07","planets":["Sun","Earth","Moon","Mercury","Venus","Mars","Jupiter","Saturn","Uranus","Neptune","Pluto","Rahu","Ketu"]},"fullTransitChart":{"method":"GET","path":"/api/v2/transit-chart","params":"startDate, endDate (required), granularity (optional: daily|hourly, default: hourly)","example":"/api/v2/transit-chart?startDate=2024-01-01&endDate=2024-01-02&granularity=hourly","returns":"Full HD charts with Type, Authority, Channels, Centers, PHS, Variables","note":"Computes complete Human Design interpretation at each timestamp. No birth location required."},"sage":{"method":"POST (GET also supported)","path":"/api/sage/query","body":"{\"query\": \"What is Gate 1 in Human Design?\"}","getParams":"q (required query string)","example":"POST /api/sage/query with {\"query\": \"Gate 1\"} OR GET /api/sage/query?q=Gate%201","returns":"AI-generated answer with sources and domain classification","unitsConsumed":5,"note":"Requires SAGE API subscription (sage_api product). Returns AI-mediated answers using the knowledge base as context. Each query consumes 5 units."}},"documentation":"https://github.com/sphinxcode/humandesignmcp"}