{"uid":"cap_2iZTU5jJ-NBDryAVrk0P8","slug":"gauge-drug-shortage-region-edddd03a","name":"gauge/drug-shortage-region","description":"[3-LEG] Drug shortage chain, one therapeutic class (?entity=oncology): leading new-shortage incidence from openFDA new listings, which leads the burden peak -> current current active shortages in the class -> realized resolution rate (confirmation gate). A chain, not one reading: confidence = how many legs are lit, in order. Sources: openFDA. Descriptive only, never a forecast or advice. No data -> 422 no_charge, not billed. $0.25 per call.","url":"https://api.truthbear.co/gauge/drug-shortage-region","method":"GET","headers":{},"bodySchema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["entity"],"properties":{"entity":{"type":"string","examples":["anesthesia","oncology","psychiatry-cns","analgesia-opioid","anti-infective","cardiovascular"],"description":"required - monitored object id, paired with signal_id; free list at GET /gauge/catalog?signal_id=<signal_id> -> signals[0].entities[]","x-accepted-values":{"all":"https://api.truthbear.co/schemas/gauge-drug-shortage-region.input.json","shown":6,"total":18}}},"additionalProperties":false}}},"output":{"type":"object","required":["type"],"properties":{"type":{"const":"json"},"example":{}}}}},"responseSchema":{"type":"json","example":{"legs":{"onset":{"band":"surging","source_ref":"https://api.fda.gov/drug/shortages.json","record_hash":"sha256:c1ca2eec2f8f1898a48deca396ed9f5e24005dc4de019180094c79a7ff32988d"},"burden":{"band":"severe","source_ref":"https://api.fda.gov/drug/shortages.json","record_hash":"sha256:95c901069fbd9db272dce74457eaca702df546c8d3e35433a07af662c9aa8bd3"},"entrenchment":{"band":"entrenched","source_ref":"https://api.fda.gov/drug/shortages.json","record_hash":"sha256:be5b2a361a74d8980e135977cba95fad95779b87273fa92966aa76b9dc22ea2a"}},"name":"Anesthesia / Anesthetics","grade":"screening-level, not decision-grade","scope":{"full":"https://api.truthbear.co/scope/v1","verifiability":"unknown","monitoring_not_forecast":true,"intelligence_not_command":true},"entity":"anesthesia","nature":"This API supplies data organisation and trend description only. It is not a recommendation to act; the decision is yours. Purely descriptive - no judgement, no prediction. Official source plus record_hash; verify with the free /gauge/verify.","provenance":{"freshness":"fresh","age_hours_now":23,"freshness_basis":"cadence=default; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kceWH8WDkhuSQqn-03hru","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a 3-leg sequential chain gauging drug shortage pressure for a specified therapeutic class, from new shortage incidence through active burden to resolution rate.","exampleAgentPrompt":"Can you pull the drug shortage chain for oncology — I want to see the new shortage incidence, current active shortages, and how well they're resolving right now?","exampleUseCases":[{"title":"Monitoring oncology drug supply stress","prompt":"What's the current drug shortage situation for oncology? I need to see whether new shortages are rising, how many are active right now, and what the resolution rate looks like."},{"title":"Anti-infective shortage trend for hospital planning","prompt":"Can you check the anti-infective drug shortage chain for me? I want to know if new listings from the FDA are increasing and whether the resolution rate is keeping up."},{"title":"Anesthesia shortage burden assessment","prompt":"Pull the 3-leg shortage gauge for anesthesia drugs — I want to understand the leading incidence signal, the current active burden, and the confirmation gate on resolution."}],"resultDescription":"A sequential 3-leg chain result: Leg 1 is new-shortage incidence (leading indicator from openFDA new listings), Leg 2 is current active shortages in the therapeutic class, and Leg 3 is the realized resolution rate (confirmation gate). A confidence score reflects how many legs are lit in order. Returns descriptive data only — no forecast or advice. Returns 422 no_charge if no data is available (not billed).","failureModes":["422 no_charge returned when no data is available for the requested entity — call is not billed","Invalid or unsupported entity value causes request rejection — use GET /gauge/catalog?signal_id=<signal_id> to retrieve valid entity list","Missing required 'entity' query parameter causes request failure","openFDA data source unavailability may reduce number of lit legs and lower confidence score"],"whenToPreferThis":"Choose this endpoint when you need a structured, multi-leg sequential signal about drug shortage pressure for a specific therapeutic class, sourced directly from openFDA. It is best for monitoring and awareness use cases — not for forecasting or clinical decision-making. Prefer this over raw FDA lookups when you want a pre-aggregated chain from leading incidence through active burden to resolution, with a built-in confidence indicator. Supported therapeutic classes include oncology, anesthesia, psychiatry-cns, analgesia-opioid, anti-infective, and cardiovascular (18 total).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:45:41.424Z","isFirstParty":false}