# TruthBear Drug Shortage Detail – 3-Leg Chain

> TruthBear Drug Shortage Detail – 3-Leg Chain is a paid API for AI agents from api.truthbear.co, paid per call via x402, $0.25/call, status unknown (last checked 2026-09-14).

Runs a sequential three-leg supply-chain analysis for a single drug, connecting labeler availability narrowing to FDA shortage status per NDC to confirmed affected presentations.

## Facts

- Endpoint: GET https://api.truthbear.co/gauge/drug-detail-region
- Price: $0.25/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/truthbear-drug-shortage-detail-3-leg-chain-3aa1844c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rFB69skvMYXMD93iAEHa3

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability truthbear-drug-shortage-detail-3-leg-chain-3aa1844c
```

Example prompt: Can you run the full 3-leg drug shortage chain for carboplatin — I want to see how many labelers are still active versus listed, whether the FDA has flagged any NDCs as in shortage, and which specific presentations are confirmed affected?

## When to prefer this

Use this endpoint when you need a structured, multi-signal confirmation of drug shortage status that goes beyond a simple FDA lookup — specifically when you want to correlate labeler supply narrowing with official NDC shortage listings and presentation-level confirmation in a single chained call. Prefer it over raw openFDA queries when you need a confidence-gated, sequential analysis rather than a single data point.

## Known failure modes

- 422 no_charge returned when no data exists for the given entity — not billed
- Invalid or unrecognized entity name returns an error or empty result
- openFDA upstream outage may reduce the number of legs that can be populated, lowering confidence score
- Querying a drug not in the monitored catalog returns no meaningful chain data

## How this service works

[3-LEG] Per-drug shortage chain, one drug (?entity=carboplatin): leading supply narrowing - available labelers against total listed -> current current FDA shortage status per NDC -> realized affected presentations (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.

## Output

A JSON object with up to three sequentially gated legs: (1) active labelers vs. total listed labelers indicating supply narrowing; (2) current FDA shortage status per NDC; (3) confirmed affected drug presentations. The confidence field indicates how many legs returned data (0–3). Returns HTTP 422 with no charge if no data is available.

## Request schema (JSON Schema)

```json
{
 "$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": [
        "carboplatin",
        "cisplatin",
        "oxaliplatin",
        "methotrexate",
        "fluorouracil",
        "epinephrine"
       ],
       "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-detail-region.input.json",
        "shown": 6,
        "total": 24
       }
      }
     },
     "additionalProperties": false
    }
   }
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "const": "json"
    },
    "example": {}
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "legs": {
   "status": {
    "band": "severe-shortage",
    "source_ref": "https://api.fda.gov/drug/shortages.json",
    "record_hash": "sha256:7db4e125643bd8fe08f2dd8086ca0133592e23c224d50817b858ae6dc0eeebd7"
   },
   "supply_narrowing": {
    "band": "adequate",
    "source_ref": "https://api.fda.gov/drug/shortages.json",
    "record_hash": "sha256:173777a0a9ab8b9afc1328ba9576df77579943a81bb69ff357ff34b005e44761"
   },
   "alternative_supply": {
    "band": "multi-source-available",
    "source_ref": "https://api.fda.gov/drug/ndc.json + https://rxnav.nlm.nih.gov/ + https://api.fda.gov/drug/shortages.json",
    "record_hash": "sha256:a87b108234b4838311c621c05cc64421dc61b210f4a2f397b059e9b6313de9d1"
   },
   "alternatives_status": {
    "band": "alternatives-ok",
    "source_ref": "https://rxnav.nlm.nih.gov/ + https://api.fda.gov/drug/shortages.json",
    "record_hash": "sha256:ca47c731d7f76e830c7a28a54ff412fc05eb5d603dbaa5ab673902d32eaead17"
   }
  },
  "name": "Carboplatin",
  "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": "carboplatin",
  "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": 5.4,
   "freshness_basis": "cadence=default; fresh<=24h; recent<=192h; dead_source>1440h; age_basis=request-time(now minus observed_at)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/truthbear-drug-shortage-detail-3-leg-chain-3aa1844c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.truthbear.co](https://www.zero.xyz/host/api.truthbear.co/llms.txt)
