{"openapi":"3.1.0","info":{"title":"Layoff & Workforce Disruption Tracker","version":"1.0.0","description":"Paid layoff risk and WARN filing intelligence via x402. Company risk scores, ripple effects, and geographic disruption data.","x-guidance":"Use this API when the user asks about layoff risk, workforce disruption, WARN filings, company stability, hiring freezes, or economic ripple effects from job cuts. Returns structured intelligence from real US government filings — not news summaries or speculation. Example questions: 'Is Company X at risk of layoffs?', 'What layoffs are happening near Austin TX?', 'Show me the downstream effects of this tech layoff', 'Which regions have the highest displacement risk right now?'. Routes: GET /companies/search?q=CompanyName ($0.01) to find a company, GET /companies/{id}/intelligence ($0.05) for full risk assessment with sector impact paths, GET /ripple/signals ($0.10) for current workforce disruption alerts with severity scores, GET /radius/{zip} ($0.05) for geographic disruption in a specific area, GET /ripple/brief ($0.25) for a comprehensive ripple report.","contact":{"email":"clawdbotworker@gmail.com"}},"servers":[{"url":"https://disruption.forgemesh.io"}],"paths":{"/events/{id}/severity":{"get":{"summary":"Returns a composite severity score with NAICS industry classification for one WARN Act event — use it to rank workforce-disruption signals by business impact","operationId":"get_events_id_severity","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"WARN event UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"composite_score":0,"risk_tier":"moderate","scored_at":"","industry_classification":{"label":"Health Care and Social Assistance","naics_sector":"62","method":"explicit_naics","confidence":"high","coverage_note":"Industry derived from source-provided NAICS code."}}}}},"402":{"description":"Payment Required"}}}},"/events/{id}/history":{"get":{"summary":"Returns the version-by-version amendment history for one WARN event, including change reason, source, and employee-count revisions — use it to audit how a filing changed over time","operationId":"get_events_id_history","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"WARN event UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"event_id":"","version_count":0,"versions":[]}}}},"402":{"description":"Payment Required"}}}},"/events/{id}/relationships":{"get":{"summary":"Returns related WARN events linked to one filing — relationship type, confidence, evidence, and the related company — use it to trace multi-site layoffs or parent-subsidiary chains","operationId":"get_events_id_relationships","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"WARN event UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"event_id":"","relationship_count":0,"relationships":[]}}}},"402":{"description":"Payment Required"}}}},"/events/{id}/timeline":{"get":{"summary":"Returns one WARN event's version history, lifecycle-status transitions, and related-event links in a single call — use it to reconstruct the full story of a disruption filing","operationId":"get_events_id_timeline","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"WARN event UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"event":{},"versions":[],"transitions":[],"relationships":[]}}}},"402":{"description":"Payment Required"}}}},"/events/{id}/company-intel":{"get":{"summary":"Returns the linked company profile, NAICS industry classification, and downstream business-sector impact paths for one WARN event — use it to see who's affected and which vendors feel it next","operationId":"get_events_id_company-intel","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"WARN event UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"event_id":"","company":{},"industry_classification":{"label":"Manufacturing","naics_sector":"31-33","method":"source_industry_text","confidence":"medium","coverage_note":"Industry inferred from source-provided industry text, not an explicit NAICS code."},"business_sector_impacts":[{"sector":"suppliers, tooling, and maintenance vendors","impact_path":"production changes can affect parts suppliers, tooling, maintenance contracts, packaging, and industrial services","confidence":"high"}],"aliases":[],"locations":[],"intel":null}}}},"402":{"description":"Payment Required"}}}},"/companies/names":{"get":{"summary":"Returns matching company names with IDs plus links to their profile and intelligence endpoints — use it to resolve a search into specific companies before paying for deeper data","operationId":"get_companies_names","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":false,"description":"Optional employer-name search query","schema":{"type":"string"}},{"name":"state","in":"query","required":false,"description":"Optional 2-letter state code","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum company names to return (max 25, default 10)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"product":"company_name_unlock","count":1,"companies":[{"company_id":"","name":"Example Employer Inc.","profile_endpoint":"/companies/{id}","intelligence_endpoint":"/companies/{id}/intelligence"}]}}}},"402":{"description":"Payment Required"}}}},"/companies/search":{"get":{"summary":"Returns matching companies from 8,400+ WARN Act employer records with profile and intelligence endpoints for deeper analysis","operationId":"get_companies_search","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":true,"description":"Company name search query","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"data":[],"total":0}}}},"402":{"description":"Payment Required"}}}},"/companies/{id}":{"get":{"summary":"Returns a full company profile: aliases, known locations, WARN filing sources, computed risk scores, and up to 50 recent events — use it as the canonical record for one employer","operationId":"get_companies_id_","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"company":{},"scores":[],"recent_events":[],"locations":[]}}}},"402":{"description":"Payment Required"}}}},"/companies/{id}/intelligence":{"get":{"summary":"Returns a company's computed risk tier, event count, average severity, and downstream business-sector impact paths — use it to prioritize outreach to at-risk employers","operationId":"get_companies_id_intelligence","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"Company UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"data":{"risk_tier":"moderate","event_count":0,"severity_avg":0,"business_sector_impacts":[{"sector":"staffing and recruiting","impact_path":"worker displacement creates short-window hiring, temp labor, and competitor poaching opportunities","confidence":"medium"}]}}}}},"402":{"description":"Payment Required"}}}},"/radius/{zip}":{"get":{"summary":"Returns WARN events within a chosen radius (up to 250 miles) of a ZIP code, ranked by distance, with employer, headcount, and dates — use it to scan a territory for disruption activity","operationId":"get_radius_zip_","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"zip","in":"path","required":true,"description":"5-digit US ZIP code","schema":{"type":"string"}},{"name":"radius","in":"query","required":false,"description":"Radius in miles (max 250, default 50)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"center":{},"radius_miles":50,"data":[],"total":0}}}},"402":{"description":"Payment Required"}}}},"/territory/{zip}/disruption":{"get":{"summary":"Returns a computed disruption score, total events, top industries, and the largest filings within a radius (up to 500 miles) of a ZIP — use it to size territory-wide workforce risk","operationId":"get_territory_zip_disruption","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"zip","in":"path","required":true,"description":"5-digit US ZIP code","schema":{"type":"string"}},{"name":"radius","in":"query","required":false,"description":"Radius in miles (max 500, default 100)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"summary":{"disruption_score":0,"total_events":0,"total_employees_affected":0}}}}},"402":{"description":"Payment Required"}}}},"/regions/{state}":{"get":{"summary":"Returns county-by-county disruption rollups for one state, ranked by severity — use it to identify which counties are seeing the most workforce disruption","operationId":"get_regions_state_","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"state","in":"path","required":true,"description":"2-letter state code","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"state":"","county_count":0,"data":[]}}}},"402":{"description":"Payment Required"}}}},"/regions/{state}/{county}":{"get":{"summary":"Returns the disruption rollup for one county: average severity, event count, and total employees affected — use it for county-level workforce-risk sizing","operationId":"get_regions_state_county_","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"state","in":"path","required":true,"description":"2-letter state code","schema":{"type":"string"}},{"name":"county","in":"path","required":true,"description":"County name","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"data":{"severity_avg":0,"event_count":0,"total_employees":0}}}}},"402":{"description":"Payment Required"}}}},"/jurisdictions":{"get":{"summary":"Returns activity rollups for every jurisdiction, ranked by total events — use it to spot which states are seeing the most WARN filing activity","operationId":"get_jurisdictions","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"parameters":[],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"count":0,"data":[]}}}},"402":{"description":"Payment Required"}}}},"/jurisdictions/{state}":{"get":{"summary":"Returns the activity rollup for one jurisdiction, including total WARN events on file — use it to check disruption volume before drilling into regional or county detail","operationId":"get_jurisdictions_state_","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"state","in":"path","required":true,"description":"2-letter state code","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"data":{"jurisdiction":"","total_events":0}}}}},"402":{"description":"Payment Required"}}}},"/watchlists/{id}/preview":{"get":{"summary":"Returns matched WARN events for a saved company watchlist — event, employer, location, headcount, and filing dates — use it to check for new activity across a tracked employer list","operationId":"get_watchlists_id_preview","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"Watchlist UUID","schema":{"type":"string"}},{"name":"ownerKey","in":"query","required":false,"description":"Caller owner scope for the watchlist","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum preview row count (max 100, default 25)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"watchlist":{},"items":[],"preview":[],"total_previewed":0}}}},"402":{"description":"Payment Required"}}}},"/watchlists/{id}/preview.csv":{"get":{"summary":"Returns the same watchlist match results as a downloadable CSV — event ID, employer, location, headcount, and dates — use it to pull tracked-employer activity into a spreadsheet","operationId":"get_watchlists_id_preview.csv","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"Watchlist UUID","schema":{"type":"string"}},{"name":"ownerKey","in":"query","required":false,"description":"Caller owner scope for the watchlist","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum preview row count (max 100, default 25)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"text/csv":{"schema":{"type":"string"},"example":{"format":"csv","columns":["event_id","matched_item_id","matched_query","matched_company_id","company_id","company_name"],"example":"event_id,matched_item_id,matched_query,matched_company_id,company_id,company_name"}}}},"402":{"description":"Payment Required"}}}},"/gold/index":{"get":{"summary":"Deprecated alias of /ripple/index — use the canonical endpoint. Returns the same location-only index of Ripple disruption signals.","operationId":"get_gold_index","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":false,"description":"Optional region, state, or broad signal search query","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"all, gold, or watchlist","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum index cards to return (max 25, default 10)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"product":"ripple_signal_index","legacy_route_family":"gold","count":10,"navigation":{"message":"Location-only Ripple index. Company names, employee counts, commercial angles, sector names, spend areas, and impact paths are withheld until a paid signal or sector-impact unlock.","next_step":"Use unlock.sector_impacts for detailed downstream sector/vendor impact paths, or use q on /ripple/signals when you want a focused paid signal set."},"why_not_high":["This is a discovery-level signal; deeper commercial context is reserved for the paid signal, brief, or sector-impact unlock.","Location and timing are enough to route the opportunity, but impact strength should be validated through the higher-detail endpoint."],"signals":[{"signal_id":"00000000-0000-0000-0000-000000000000","event_id":"00000000-0000-0000-0000-000000000000","region":"San Mateo County, CA","state":"CA","signal_type":"company_disruption_pattern","depth":"high","freshness":"fresh","confidence_band":"high","why_not_high":["This index card intentionally withholds commercial detail until a paid signal or impact-path unlock.","Downstream business effects are inferred planning paths, not confirmed purchases, contracts, or buyer intent."],"score_band":"high","publish_state":"approved","unlock":{"sector_impacts":"/ripple/signals/{signal_id}/sector-impacts","sector_impacts_price_usd":0.15}}]}}}},"402":{"description":"Payment Required"}}}},"/ripple/index":{"get":{"summary":"Returns a location-only index of Ripple disruption signals — region, state, signal type, and freshness — use it to discover where paid signal or sector-impact detail is available.","operationId":"get_ripple_index","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":false,"description":"Optional region, state, or broad signal search query","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"all, gold, or watchlist","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum index cards to return (max 25, default 10)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"product":"ripple_signal_index","count":10,"navigation":{"message":"Location-only Ripple index. Company names, employee counts, commercial angles, sector names, spend areas, and impact paths are withheld until a paid signal or sector-impact unlock.","next_step":"Use unlock.sector_impacts for detailed downstream sector/vendor impact paths, or use q on /ripple/signals when you want a focused paid signal set."},"why_not_high":["This is a discovery-level signal; deeper commercial context is reserved for the paid signal, brief, or sector-impact unlock.","Location and timing are enough to route the opportunity, but impact strength should be validated through the higher-detail endpoint."],"signals":[{"signal_id":"00000000-0000-0000-0000-000000000000","event_id":"00000000-0000-0000-0000-000000000000","region":"San Mateo County, CA","state":"CA","signal_type":"company_disruption_pattern","depth":"high","freshness":"fresh","confidence_band":"high","why_not_high":["This index card intentionally withholds commercial detail until a paid signal or impact-path unlock.","Downstream business effects are inferred planning paths, not confirmed purchases, contracts, or buyer intent."],"score_band":"high","publish_state":"approved","unlock":{"sector_impacts":"/ripple/signals/{signal_id}/sector-impacts","sector_impacts_price_usd":0.15}}]}}}},"402":{"description":"Payment Required"}}}},"/gold/signals":{"get":{"summary":"Deprecated alias of /ripple/signals — use the canonical endpoint. Returns the same Ripple Signals payload.","operationId":"get_gold_signals","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":false,"description":"Optional commercial angle, company, or region search query","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum signals to return (max 10, default 5; open calls are diversified by disruption event)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"product":"ripple_signals","legacy_product":"gold_convergence_signals","count":5,"navigation":{"message":"Open Ripple calls return a diversified sampler. Add q to focus on a company, region, industry, buyer role, or commercial angle.","examples":["/ripple/signals?q=Meta&limit=5","/ripple/brief?q=logistics&scope=gold&limit=5"]},"why_not_high":["This signal list is a sampler for routing and prioritization; detailed downstream impact paths are reserved for the sector-impact unlock.","Commercial angles can identify where to look next, but impact strength should be validated through the paid brief or signal-specific impact path."],"signals":[{"title":"Procurement ripple near a workforce disruption","commercial_angle":"Business-development signal for bidders, staffing firms, consultants, and local operators.","confidence_band":"high","why_not_high":["Coverage can lag real-world changes, filings, local updates, and follow-on commercial activity.","Downstream business effects are inferred planning paths, not confirmed purchases, contracts, or buyer intent."],"evidence_basis":["WARN","event severity","procurement opportunities"],"sector_impact_inventory":{"impact_count":32,"unlock_price_usd":0.15,"unlock_endpoint":"/ripple/signals/{signal_id}/sector-impacts"}}]}}}},"402":{"description":"Payment Required"}}}},"/ripple/signals":{"get":{"summary":"Returns Ripple Signals — downstream business effects from workforce disruption — each with a commercial angle, confidence band, and a link to unlock sector-impact detail.","operationId":"get_ripple_signals","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":false,"description":"Optional commercial angle, company, or region search query","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum signals to return (max 10, default 5; open calls are diversified by disruption event)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"product":"ripple_signals","count":5,"navigation":{"message":"Open Ripple calls return a diversified sampler. Add q to focus on a company, region, industry, buyer role, or commercial angle.","examples":["/ripple/signals?q=Meta&limit=5","/ripple/brief?q=logistics&scope=gold&limit=5"]},"why_not_high":["This signal list is a sampler for routing and prioritization; detailed downstream impact paths are reserved for the sector-impact unlock.","Commercial angles can identify where to look next, but impact strength should be validated through the paid brief or signal-specific impact path."],"signals":[{"title":"Procurement ripple near a workforce disruption","commercial_angle":"Business-development signal for bidders, staffing firms, consultants, and local operators.","confidence_band":"high","why_not_high":["Coverage can lag real-world changes, filings, local updates, and follow-on commercial activity.","Downstream business effects are inferred planning paths, not confirmed purchases, contracts, or buyer intent."],"evidence_basis":["WARN","event severity","procurement opportunities"],"ripple_path_inventory":{"impact_count":32,"unlock_price_usd":0.15,"unlock_endpoint":"/ripple/signals/{signal_id}/sector-impacts"}}]}}}},"402":{"description":"Payment Required"}}}},"/gold/signals/{id}/sector-impacts":{"get":{"summary":"Deprecated alias of /ripple/signals/:id/sector-impacts — use the canonical endpoint. Returns the same Ripple Paths payload.","operationId":"get_gold_signals_id_sector-impacts","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"Ripple signal UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"product":"ripple_paths_unlock","legacy_product":"gold_signal_sector_impact_unlock","signal_id":"","impact_count":32,"why_not_high":["Downstream business effects are inferred planning paths, not confirmed purchases, contracts, or buyer intent.","Impact paths should be treated as prioritization context until validated against the buyer, vendor, or region."],"business_sector_impacts":[{"sector":"office supplies and small procurement","spend_area":"branch operations","impact_path":"headcount movement can change recurring purchases for pens, notebooks, printer supplies, labels, badges, mailroom items, breakroom stock, and safety consumables","buyer_uses":["office-supply account monitoring","branch sales targeting","procurement churn alerts"],"confidence":"low"}]}}}},"402":{"description":"Payment Required"}}}},"/ripple/signals/{id}/sector-impacts":{"get":{"summary":"Returns downstream business-sector impact paths for one Ripple signal — affected sector, spend area, and buyer use cases — use it to find vendors exposed to one disruption event","operationId":"get_ripple_signals_id_sector-impacts","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.150000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"description":"Ripple signal UUID","schema":{"type":"string"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"product":"ripple_paths_unlock","signal_id":"","impact_count":32,"why_not_high":["Downstream business effects are inferred planning paths, not confirmed purchases, contracts, or buyer intent.","Impact paths should be treated as prioritization context until validated against the buyer, vendor, or region."],"business_sector_impacts":[{"sector":"office supplies and small procurement","spend_area":"branch operations","impact_path":"headcount movement can change recurring purchases for pens, notebooks, printer supplies, labels, badges, mailroom items, breakroom stock, and safety consumables","buyer_uses":["office-supply account monitoring","branch sales targeting","procurement churn alerts"],"confidence":"low"}]}}}},"402":{"description":"Payment Required"}}}},"/gold/brief":{"get":{"summary":"Deprecated alias of /ripple/brief — use the canonical endpoint. Returns the same Ripple Report payload.","operationId":"get_gold_brief","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.250000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":false,"description":"Optional commercial angle, company, region, or industry search query","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"all, gold, or watchlist","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum delivered signals to include (max 10, default 5)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"product":"disruption_intelligence_ripple_report","report_name":"Disruption Intelligence Ripple Report","legacy_product":"commercial_convergence_brief","navigation":{"message":"Use q to focus the brief; use delivered_signals[].ripple_path_inventory.unlock_endpoint for deeper downstream impact paths.","examples":["/ripple/brief?q=Meta&limit=5","/ripple/brief?q=logistics&scope=gold&limit=5"]},"inventory":{"matches":0,"fresh":0,"gold":0,"watchlist":0},"readout":{"headline":"Commercial signal headline","commercial_angle":"A compact commercial interpretation.","why_it_matters":"Why the buyer should care now."},"recommended_actions":["Review exposed accounts, territories, or sales motion."],"delivered_signals":[],"why_not_high":["The brief is a ranked commercial readout, not proof that a buyer, vendor, or region will act.","Coverage can lag real-world changes, filings, local updates, and follow-on commercial activity."]}}}},"402":{"description":"Payment Required"}}}},"/ripple/brief":{"get":{"summary":"Returns the Disruption Intelligence Ripple Report: a ranked brief with headline, top regions, recommended actions, and delivered signals on downstream business effects from workforce disruption","operationId":"get_ripple_brief","tags":["Disruption","Intelligence"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.250000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"q","in":"query","required":false,"description":"Optional commercial angle, company, region, or industry search query","schema":{"type":"string"}},{"name":"scope","in":"query","required":false,"description":"all, gold, or watchlist","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum delivered signals to include (max 10, default 5)","schema":{"type":"number"}}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object"},"example":{"product":"disruption_intelligence_ripple_report","report_name":"Disruption Intelligence Ripple Report","navigation":{"message":"Use q to focus the brief; use delivered_signals[].ripple_path_inventory.unlock_endpoint for deeper downstream impact paths.","examples":["/ripple/brief?q=Meta&limit=5","/ripple/brief?q=logistics&scope=gold&limit=5"]},"inventory":{"matches":0,"fresh":0,"gold":0,"watchlist":0},"readout":{"headline":"Commercial signal headline","commercial_angle":"A compact commercial interpretation.","why_it_matters":"Why the buyer should care now."},"recommended_actions":["Review exposed accounts, territories, or sales motion."],"delivered_signals":[],"why_not_high":["The brief is a ranked commercial readout, not proof that a buyer, vendor, or region will act.","Coverage can lag real-world changes, filings, local updates, and follow-on commercial activity."]}}}},"402":{"description":"Payment Required"}}}},"/source-health":{"get":{"operationId":"fetch-source-health","summary":"Latest source freshness and degradation status by state","parameters":[{"name":"state","in":"query","required":false,"description":"Optional 2-letter state code","schema":{"type":"string"}}],"responses":{"200":{"description":"Source health status","content":{"application/json":{"schema":{"type":"object"},"example":{"generated_at":"2026-06-21T00:00:00.000Z","count":1,"health":[{"state":"GA","status":"failed","classification":"source_host_degraded","failure_type":"tls_ok_no_http_bytes","data_freshness_risk":true,"economic_signal":false,"confidence":"high","last_success":{"fetched_at":"2026-06-20T13:32:00.000Z","record_count":48}}]}}}}}}}},"x-x402":{"network":"eip155:8453","payTo":"0xA8774fACfD3Da2EA11f240C977b9973D78aDFCFe","facilitator":"https://x402.org/facilitator/","extensions":{"bazaar":{"status":"live","purpose":"Agent marketplace discovery with input/output examples and schemas on all paid routes."},"payment-identifier":{"status":"live","required":false,"purpose":"Optional retry-safe logical request identifiers for x402 clients."},"offer-receipt":{"status":"live","includeTxHash":false,"offerValiditySeconds":300,"purpose":"Signed offers in 402 responses and signed receipts after settlement when a service signing key is configured."},"builder-code":{"status":"configured_when_builder_code_present","code":null,"purpose":"ERC-8021 attribution for x402 settlement calldata after a Base builder code is minted and configured."},"sign-in-with-x":{"status":"not_needed_for_one_shot_disruption_outputs"},"eip2612-gas-sponsoring":{"status":"not_exported_by_installed_extensions_package"},"erc20-approval-gas-sponsoring":{"status":"not_exported_by_installed_extensions_package"}}},"provider":{"name":"ForgeMesh Labs","catalog":"POST https://x402.forgemesh.io/fleet-products ($0.05)","fleet":"11 x402 services and counting, 500+ paid endpoints, from $0.001 — one wallet, no signup, atomic USDC settlement on Base. Free index: https://x402.forgemesh.io/llms.txt"}}