{"ok":true,"data":{"openapi":"3.0.3","info":{"title":"StrideIQ.fit Public Partner & Developer API","version":"v1.0.0","description":"Official REST API for StrideIQ.fit and StrideIQ.us. Connect smartwatches, mobile apps, gym hardware, and partner platforms to StrideIQ's agentic athletic intelligence, live biomechanical telemetry, metabolic fasting stages, and cadence-adaptive audio.","contact":{"name":"ChanceTEK / StrideIQ Developer Support","url":"https://0.0.0.0:8080/support"}},"servers":[{"url":"https://0.0.0.0:8080/api/v1","description":"Production API Server (StrideIQ.fit / StrideIQ.us)"}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your StrideIQ Partner API Key (e.g. 'str_live_...')"},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT / Key","description":"Firebase Auth ID Token or API Key"}}},"security":[{"ApiKeyAuth":[]},{"BearerAuth":[]}],"paths":{"/health":{"get":{"summary":"Health Check & Supported Features","description":"Returns platform operational status, supported capabilities, and version info.","responses":{"200":{"description":"API is healthy and operational"}}}},"/activities":{"get":{"summary":"Query Athletic Activities","description":"Retrieve workout sessions for an athlete, filterable by mode, date, and limit.","parameters":[{"name":"mode","in":"query","schema":{"type":"string"},"description":"Filter by mode: run, walk, bike, hike, hiit, steps"},{"name":"limit","in":"query","schema":{"type":"integer","default":50},"description":"Max results to return"},{"name":"user_id","in":"query","schema":{"type":"string"},"description":"Target athlete ID (for authorized partner services)"}],"responses":{"200":{"description":"List of activities"},"401":{"description":"Unauthorized"}}},"post":{"summary":"Ingest Activity from External App/Wearable","description":"Sync runs, walks, rides, or workouts recorded in another application or wearable device into StrideIQ.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["type","distance","duration"],"properties":{"type":{"type":"string","example":"run"},"distance":{"type":"number","description":"Distance in miles","example":3.12},"duration":{"type":"number","description":"Duration in seconds","example":1540},"calories":{"type":"number","example":320},"steps":{"type":"integer","example":4850},"cadenceSpm":{"type":"integer","example":168},"heartRate":{"type":"integer","example":154},"title":{"type":"string","example":"Morning Lake Loop"},"notes":{"type":"string","example":"Synced from Smart Watch"},"mode":{"type":"string","example":"run"},"environment":{"type":"string","example":"outdoor"},"date":{"type":"string","format":"date-time"},"mileSplits":{"type":"array","items":{"type":"number"},"description":"Seconds for each mile split"},"path":{"type":"array","items":{"type":"array","items":{"type":"number"}},"description":"Array of [lat, lng] coordinates"},"idempotencyKey":{"type":"string","description":"Unique UUID to prevent duplicate syncs on network retries"}}}}}},"responses":{"201":{"description":"Activity created successfully"},"400":{"description":"Invalid payload"},"401":{"description":"Unauthorized"}}}},"/activities/{id}":{"get":{"summary":"Get Activity Details","description":"Retrieve comprehensive activity breakdown including splits, weather snapshot, and GPS telemetry.","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"},"description":"Activity document ID"}],"responses":{"200":{"description":"Activity data"},"404":{"description":"Activity not found"}}},"delete":{"summary":"Delete Activity","description":"Soft deletes an activity (moved to 30-day trash for safety).","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Activity moved to trash"}}}},"/metabolic/stage":{"get":{"summary":"Current Metabolic & Fasting Stage","description":"Calculates the physiological stage (Insulin Drop, Sugar Burning, Glycogen Depletion, Ketosis, Autophagy, Deep Growth) based on elapsed fasting hours or an active user fast.","parameters":[{"name":"elapsed_hours","in":"query","schema":{"type":"number","example":18.5},"description":"Hours elapsed since last meal"}],"responses":{"200":{"description":"Metabolic stage and biological breakdown"}}}},"/metabolic/fast":{"post":{"summary":"Start or Stop a Fasting Session","description":"Control fasting timers from connected smart kitchen devices, fridges, or health apps.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["action"],"properties":{"action":{"type":"string","enum":["start","stop"],"example":"start"},"goalHours":{"type":"number","example":18},"notes":{"type":"string","example":"Started via Partner App"}}}}}},"responses":{"200":{"description":"Fasting session updated"}}}},"/biometrics/summary":{"get":{"summary":"Daily Biometrics Summary","description":"Returns an athlete's daily steps, estimated blood pressure, and pulse metrics.","responses":{"200":{"description":"Biometric summary"}}}},"/biometrics/telemetry":{"post":{"summary":"Stream Live Workout Telemetry","description":"Ingest live heartbeats, step cadence, or pace from connected gym equipment or wearable footpods.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"cadenceSpm":{"type":"integer","example":172},"speedMph":{"type":"number","example":6.8},"heartRateBpm":{"type":"integer","example":158},"mode":{"type":"string","example":"run"}}}}}},"responses":{"200":{"description":"Telemetry received"}}}},"/coach/query":{"post":{"summary":"Query StrideIQ AI Performance Coach","description":"Send questions about running mechanics, pace strategy, recovery, or metabolic stages to StrideIQ's AI engine.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","example":"What is my optimal cadence for a 20-minute 5K?"},"persona":{"type":"string","enum":["onyx","titan","zen"],"default":"onyx"}}}}}},"responses":{"200":{"description":"AI coach response"}}}},"/audio/workout-mix":{"get":{"summary":"Generate Cadence-Matched Workout Mix","description":"Fetch a structured, BPM-aligned workout playlist from ChanceTEK One matching an athlete's requested cadence.","parameters":[{"name":"cadenceSpm","in":"query","schema":{"type":"integer","example":165},"description":"Target cadence in steps per minute"},{"name":"activity","in":"query","schema":{"type":"string","example":"running"}}],"responses":{"200":{"description":"Playlist tracks with BPM tags and streaming URLs"}}}}}},"meta":{"apiVersion":"v1","platform":"StrideIQ.fit","timestamp":"2026-11-19T09:24:19.359Z","documentationPortal":"https://0.0.0.0:8080/developer"}}