{"openapi":"3.0.3","info":{"title":"Pinellas County Family Court Intelligence API","version":"1.0.0","description":"Public-record intelligence for Pinellas County, Florida family court (6th Judicial Circuit). Provides court announcements, community discussions, appellate opinions, judge profiles, and attorney data. All data sourced from public records. Not legal advice.","contact":{"name":"DivorceGuide AI","url":"https://6thcircuitintelligence.ai"},"license":{"name":"Public data — sourced from court records and public platforms"}},"servers":[{"url":"https://6thcircuitintelligence.ai","description":"Production"}],"tags":[{"name":"court","description":"Official court data and announcements"},{"name":"community","description":"Public community discussions"},{"name":"judges","description":"Pinellas County judge profiles"},{"name":"attorneys","description":"Pinellas County family law attorneys"},{"name":"meta","description":"Site metadata and agent utilities"}],"paths":{"/api/court-announcements":{"get":{"tags":["court"],"summary":"Get Pinellas Clerk and 6th Circuit court announcements","description":"Fetches recent notices, closures, and administrative orders from the Pinellas County Clerk of Court and the 6th Judicial Circuit website. Cached for 1 hour.","operationId":"getCourtAnnouncements","responses":{"200":{"description":"Court announcements","content":{"application/json":{"schema":{"type":"object","properties":{"notices":{"type":"array","description":"List of court notices and announcements","items":{"type":"object","properties":{"title":{"type":"string","description":"Notice title or text"},"url":{"type":"string","format":"uri","description":"Source URL"},"source":{"type":"string","description":"Source name (Pinellas Clerk or 6th Circuit Court)"},"date":{"type":"string","format":"date-time","description":"When fetched"}}}},"fetchedAt":{"type":"string","format":"date-time"},"error":{"type":"string","nullable":true,"description":"\"unavailable\" if court sites are unreachable"}}},"example":{"notices":[{"title":"Court closed Monday January 20 — Martin Luther King Jr. Day","url":"https://www.mypinellasclerk.org/","source":"Pinellas Clerk","date":"2026-03-09T12:00:00.000Z"}],"fetchedAt":"2026-03-09T12:00:00.000Z","error":null}}}}}}},"/api/reddit-feed":{"get":{"tags":["community"],"summary":"Get Reddit posts about Pinellas County family law","description":"Aggregates recent public Reddit posts from r/StPetersburgFL, r/tampa, r/Divorce, r/florida, and r/legaladvice matching divorce and family court keywords. Public posts only. Cached for 2 hours.","operationId":"getRedditFeed","responses":{"200":{"description":"Reddit posts","content":{"application/json":{"schema":{"type":"object","properties":{"posts":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"subreddit":{"type":"string","description":"e.g. r/tampa"},"score":{"type":"number","description":"Reddit upvote score"},"created":{"type":"number","description":"Unix timestamp"},"permalink":{"type":"string","description":"Reddit permalink path"}}}},"fetchedAt":{"type":"string","format":"date-time"},"subreddits":{"type":"array","items":{"type":"string"},"description":"All subreddits scanned"}}}}}}}}},"/api/court-listener":{"get":{"tags":["court"],"summary":"Get recent Florida family law appellate opinions","description":"Fetches recent Florida family law and dissolution-of-marriage opinions from CourtListener (Florida jurisdiction). Cached for 24 hours. Requires COURTLISTENER_TOKEN env var for full API access (free registration at courtlistener.com).","operationId":"getCourtListenerOpinions","responses":{"200":{"description":"Appellate opinions","content":{"application/json":{"schema":{"type":"object","properties":{"opinions":{"type":"array","items":{"type":"object","properties":{"id":{"type":"number"},"absolute_url":{"type":"string","description":"Path — prepend https://www.courtlistener.com"},"cluster":{"type":"string","description":"Case name"},"date_created":{"type":"string","format":"date-time"}}}},"count":{"type":"number","description":"Total available opinions"},"fetchedAt":{"type":"string","format":"date-time"},"error":{"type":"string","description":"Error message if unavailable"}}}}}}}}},"/api/jaws-docket":{"get":{"tags":["court"],"summary":"Get JAWS docket tracking status","description":"Returns the status of live docket tracking for Pinellas County family court cases. Currently pending — 1,133 case IDs are being cross-referenced with the Pinellas Clerk database before live tracking activates.","operationId":"getJawsDocketStatus","responses":{"200":{"description":"Docket tracking status","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","enum":["pending","live"]},"pendingCaseIds":{"type":"number"},"message":{"type":"string"},"jawsUrl":{"type":"string","format":"uri"},"fetchedAt":{"type":"string","format":"date-time"}}}}}}}}},"/api/agent":{"get":{"tags":["meta"],"summary":"Agent-optimized data dump — judges, attorneys, sources, case intelligence","description":"Returns a complete structured snapshot of all site data optimized for LLM/agent consumption. Single call to get judge profiles, attorney directory summary, court sources, quick links, and case stage intelligence. Recommended entry point for agents.","operationId":"getAgentData","parameters":[{"name":"include","in":"query","description":"Comma-separated list of data sections to include (default: all). Options: judges, attorneys, sources, stages, links","schema":{"type":"string","example":"judges,sources"}}],"responses":{"200":{"description":"Complete agent-optimized data snapshot","content":{"application/json":{"schema":{"type":"object","properties":{"_agent_note":{"type":"string"},"jurisdiction":{"type":"object"},"judges":{"type":"array"},"case_stage_intelligence":{"type":"array"},"court_sources":{"type":"array"},"quick_links":{"type":"array"},"api_endpoints":{"type":"array"},"generated_at":{"type":"string","format":"date-time"}}}}}}}}},"/api/openapi":{"get":{"tags":["meta"],"summary":"OpenAPI 3.0 specification for this API","operationId":"getOpenApiSpec","responses":{"200":{"description":"OpenAPI spec (this document)","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}