{"openapi":"3.0.3","info":{"title":"PharmaPatent Expiry & FDA Orange Book Watcher API","version":"1.0.0","description":"Real-time pharmaceutical patent cliff monitor, FDA Orange Book & Purple Book regulatory exclusivity tracker, Paragraph IV generic litigation radar, and drug market loss-of-exclusivity intelligence for biotech investors, generic manufacturers, and healthcare analysts.","contact":{"name":"TopAI SaaS Studio Support","email":"top.ai.saas@gmail.com","url":"https://pharmapatent-expiry.topaisaas.workers.dev"},"license":{"name":"MIT","url":"https://opensource.org/licenses/MIT"}},"servers":[{"url":"https://pharmapatent-expiry.topaisaas.workers.dev","description":"Cloudflare Workers Global Edge (Primary Live)"},{"url":"https://pharmapatent-expiry-api.p.rapidapi.com","description":"RapidAPI Gateway"}],"paths":{"/v1/patents/search":{"get":{"summary":"Search Drug Patents & Exclusivities","description":"Search pharmaceutical drugs by brand name (e.g. Ozempic, Keytruda, Eliquis), active ingredient (e.g. Semaglutide, Apixaban), or indication. Returns active patent numbers, expiration dates, days until expiry, and annual revenue at risk.","parameters":[{"name":"q","in":"query","description":"Drug brand, molecule, or sponsor (e.g. 'semaglutide', 'pfizer', 'glp-1')","required":false,"schema":{"type":"string","example":"semaglutide"}},{"name":"therapeutic_class","in":"query","description":"Filter by therapeutic class (e.g. 'GLP-1', 'SGLT2', 'Anticoagulant', 'Oncology')","required":false,"schema":{"type":"string"}},{"name":"limit","in":"query","description":"Maximum number of records to return (1-50, default: 10)","required":false,"schema":{"type":"integer","default":10,"minimum":1,"maximum":50}}],"responses":{"200":{"description":"List of matching drugs and patent exclusivity statuses","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"count":{"type":"integer","example":1},"drugs":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"ozempic-semaglutide"},"brand_name":{"type":"string","example":"Ozempic / Wegovy"},"active_ingredient":{"type":"string","example":"Semaglutide"},"applicant_sponsor":{"type":"string","example":"Novo Nordisk"},"annual_global_sales_usd":{"type":"number","example":28400000000},"primary_patent_expiry":{"type":"string","example":"2026-12-05"},"days_until_patent_expiry":{"type":"integer","example":75},"is_patent_cliff_imminent":{"type":"boolean","example":true}}}}}}}}}}}},"/v1/patents/cliff-calendar":{"get":{"summary":"Get Patent Cliff Chronological Calendar","description":"Returns annual timeline of multi-billion dollar blockbusters losing patent exclusivity, including total annual market revenue exposed to generic competition.","parameters":[{"name":"start_year","in":"query","description":"Starting year (default: 2026)","required":false,"schema":{"type":"integer","default":2026}},{"name":"end_year","in":"query","description":"Ending year (default: 2030)","required":false,"schema":{"type":"integer","default":2030}}],"responses":{"200":{"description":"Patent cliff schedule grouped by year","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"period":{"type":"string","example":"2026 - 2030"},"total_revenue_exposed_usd":{"type":"number","example":89200000000},"calendar":{"type":"array","items":{"type":"object"}}}}}}}}}},"/v1/patents/paragraph-iv":{"get":{"summary":"Get Active Paragraph IV Patent Disputes","description":"Returns active Hatch-Waxman Paragraph IV patent challenge filings by generic drug manufacturers (ANDA filers) seeking 180-day market exclusivity.","responses":{"200":{"description":"Active Paragraph IV challenges","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"active_disputes_count":{"type":"integer","example":6},"disputes":{"type":"array","items":{"type":"object"}}}}}}}}}},"/v1/patents/{id}":{"get":{"summary":"Get Deep Patent Breakdown for a Drug","description":"Returns full patent suite (compound, formulation, device, method of use) and FDA regulatory exclusivities (NCE, ODE, Pediatric) for a specific drug.","parameters":[{"name":"id","in":"path","required":true,"description":"Drug ID, brand name, active molecule, or NDA number","schema":{"type":"string","example":"semaglutide"}}],"responses":{"200":{"description":"Drug detail and patent list","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true},"drug":{"type":"object"}}}}}},"404":{"description":"Drug not found in FDA database"}}}},"/v1/health":{"get":{"summary":"Service Healthcheck","description":"Returns operational status, uptime SLA, and version.","responses":{"200":{"description":"Service healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string","example":"ok"},"service":{"type":"string","example":"pharmapatent-expiry-api"},"timestamp":{"type":"string","example":"2026-09-20T22:00:00.000Z"}}}}}}}}}}}