Emergency · LIVE

NEDOCS

Compute the Weiss 2004 NEDOCS reduced five-variable score from caller-supplied ED patients, ED beds, boarding patients, hospital beds, respirators, longest admitted-patient hours, and last-called registration-to-bed hours, and return the published ≥100 overcrowding cutoff.

LIVE $0.005 USDC GET /api/calc/nedocs

Markdown: /docs/nedocs.md · Canonical: https://magentlab.com/docs/nedocs

Not a medical device. Not a diagnosis, dose, or listing recommendation.

What it computes

Compute the Weiss 2004 NEDOCS reduced five-variable score from caller-supplied ED patients, ED beds, boarding patients, hospital beds, respirators, longest admitted-patient hours, and last-called registration-to-bed hours, and return the published ≥100 overcrowding cutoff.

When to use

When an agent has the published snapshot counts and hours for an academic ED and needs the Weiss 2004 reduced-model NEDOCS score, not a diversion or ambulance-bypass order.

When not to use

• Not a medical device. Not a diversion or ambulance-bypass order.
• magent does not count beds, patients, respirators, or wait times. Caller supplies the published numeric inputs.
• Weiss 2004 reduced five-variable model for academic EDs. The paper omitted the patindex × reg_time interaction from the presented nomogram (about 1% extra variance).
• The linear combination can fall below 0 or above 200. The paper's interpretation scale is 0-200 with 100 as the overcrowding cutoff. magent does not clamp the score and does not invent 0-20/21-60 interval cuts.
• Pediatric-only EDs were not this model. Not a diagnosis of crowding-related harm.

Formula

nedocs_score = -20 + 85.8 * (ed_patients / ed_beds) + 600 * (boarding_patients / hospital_beds) + 13.4 * respirators + 0.93 * admit_time_hours + 5.64 * reg_time_hours

Citation

Title

Estimating the degree of emergency department overcrowding in academic medical centers: results of the National ED Overcrowding Study (NEDOCS)

Authors

Weiss SJ, Derlet R, Arndahl J, Ernst AA, Richards J, Fernandez-Frankelton M, Schwab R, Stair TO, Vicellio P, Levy D, Brautigan M, Johnson A, Nick TG

Source

Acad Emerg Med. 2004;11(1):38-50

DOI

10.1197/j.aem.2003.07.017

Worked example

Also searched as

• NEDOCS
• National ED Overcrowding Study
• ED overcrowding score
• emergency department overcrowding
• Weiss NEDOCS
• NEDOCS reduced model
• academic ED overcrowding

Try

Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.

/api/calc/nedocs?ed_patients=0&ed_beds=50&boarding_patients=0&hospital_beds=500&respirators=0&admit_time_hours=0&reg_time_hours=0

Full URL: https://api.magentlab.com/api/calc/nedocs?ed_patients=0&ed_beds=50&boarding_patients=0&hospital_beds=500&respirators=0&admit_time_hours=0&reg_time_hours=0

Call

Expect HTTP 402 until you retry with PAYMENT-SIGNATURE. Incomplete query params return HTTP 400 before any quote or charge.

curl -i -H "Accept: application/json" "https://api.magentlab.com/api/calc/nedocs?ed_patients=0&ed_beds=50&boarding_patients=0&hospital_beds=500&respirators=0&admit_time_hours=0&reg_time_hours=0"

Parameters

Bulk (POST)

POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement.

POST /api/calc/nedocs Max 25 unit_amount + extra_item_amount * (n - 1) extra $0.002 PREVIEW

• 1 to 25 items. Each item uses the same keys as the GET query parameters.
• POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows.
• The first invalid item fails the whole request (index in the 400 JSON). You are not charged.
• HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row.
• Catalog misses (empty matches, found=false) stay paid 200s inside that slot.
• x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items.

Example request (fixture)

{
  "items": [
    {
      "admit_time_hours": "0",
      "boarding_patients": "0",
      "ed_beds": "50",
      "ed_patients": "0",
      "hospital_beds": "500",
      "reg_time_hours": "0",
      "respirators": "0"
    },
    {
      "admit_time_hours": "0",
      "boarding_patients": "0",
      "ed_beds": "50",
      "ed_patients": "0",
      "hospital_beds": "500",
      "reg_time_hours": "0",
      "respirators": "0"
    }
  ]
}

Open bulk paywall →

Opens a two-item fixture on the API host. Unpaid browsers get the same MetaMask paywall as GET; Pay retries POST with those items.

Example 200 (fixture)

{
  "count": 2,
  "path": "/api/calc/nedocs",
  "items": [
    {
      "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
      "citation": {
        "authors": "Weiss SJ, Derlet R, Arndahl J, Ernst AA, Richards J, Fernandez-Frankelton M, Schwab R, Stair TO, Vicellio P, Levy D, Brautigan M, Johnson A, Nick TG",
        "doi": "10.1197/j.aem.2003.07.017",
        "id": "weiss-2004",
        "pmid": "14709427",
        "source": "Acad Emerg Med. 2004;11(1):38-50",
        "title": "Estimating the degree of emergency department overcrowding in academic medical centers: results of the National ED Overcrowding Study (NEDOCS)"
      },
      "formula": "nedocs",
      "formula_expression": "nedocs_score = -20 + 85.8 * (ed_patients / ed_beds) + 600 * (boarding_patients / hospital_beds) + 13.4 * respirators + 0.93 * admit_time_hours + 5.64 * reg_time_hours",
      "admit_index": 0.0,
      "admit_time_hours": 0.0,
      "boarding_patients": 0,
      "ed_beds": 50,
      "ed_patients": 0,
      "hospital_beds": 500,
      "nedocs_score": -20.0,
      "overcrowded": false,
      "patindex": 0.0,
      "reg_time_hours": 0.0,
      "respirators": 0
    },
    {
      "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
      "citation": {
        "authors": "Weiss SJ, Derlet R, Arndahl J, Ernst AA, Richards J, Fernandez-Frankelton M, Schwab R, Stair TO, Vicellio P, Levy D, Brautigan M, Johnson A, Nick TG",
        "doi": "10.1197/j.aem.2003.07.017",
        "id": "weiss-2004",
        "pmid": "14709427",
        "source": "Acad Emerg Med. 2004;11(1):38-50",
        "title": "Estimating the degree of emergency department overcrowding in academic medical centers: results of the National ED Overcrowding Study (NEDOCS)"
      },
      "formula": "nedocs",
      "formula_expression": "nedocs_score = -20 + 85.8 * (ed_patients / ed_beds) + 600 * (boarding_patients / hospital_beds) + 13.4 * respirators + 0.93 * admit_time_hours + 5.64 * reg_time_hours",
      "admit_index": 0.0,
      "admit_time_hours": 0.0,
      "boarding_patients": 0,
      "ed_beds": 50,
      "ed_patients": 0,
      "hospital_beds": 500,
      "nedocs_score": -20.0,
      "overcrowded": false,
      "patindex": 0.0,
      "reg_time_hours": 0.0,
      "respirators": 0
    }
  ]
}

Response

Example JSON

Machine form of the same example. Frozen fixture. Not a live lookup.

{
  "disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
  "citation": {
    "authors": "Weiss SJ, Derlet R, Arndahl J, Ernst AA, Richards J, Fernandez-Frankelton M, Schwab R, Stair TO, Vicellio P, Levy D, Brautigan M, Johnson A, Nick TG",
    "doi": "10.1197/j.aem.2003.07.017",
    "id": "weiss-2004",
    "pmid": "14709427",
    "source": "Acad Emerg Med. 2004;11(1):38-50",
    "title": "Estimating the degree of emergency department overcrowding in academic medical centers: results of the National ED Overcrowding Study (NEDOCS)"
  },
  "formula": "nedocs",
  "formula_expression": "nedocs_score = -20 + 85.8 * (ed_patients / ed_beds) + 600 * (boarding_patients / hospital_beds) + 13.4 * respirators + 0.93 * admit_time_hours + 5.64 * reg_time_hours",
  "admit_index": 0.0,
  "admit_time_hours": 0.0,
  "boarding_patients": 0,
  "ed_beds": 50,
  "ed_patients": 0,
  "hospital_beds": 500,
  "nedocs_score": -20.0,
  "overcrowded": false,
  "patindex": 0.0,
  "reg_time_hours": 0.0,
  "respirators": 0
}

Client errors (HTTP 400)

Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.

Related tools

• HOSPITAL — Sum the Donze 2013 HOSPITAL integer score (acronym table, max 13) from caller-assigned flags and prior-year admissions and return the derivation-study band (low / intermediate / high).
• LACE — Sum van Walraven 2010 Table 3 LACE points from length of stay, acute (emergent) admission, a caller-supplied Charlson integer, and ED visits in the previous 6 months.
• MEWS — Compute the Subbe 2001 modified Early Warning Score from systolic BP, heart rate, respiratory rate, temperature, and caller-assigned AVPU.

Payment

Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. Unpaid valid requests return HTTP 402 with a base64 PAYMENT-REQUIRED header. HTTP 503 is not a new quote: retry the same PAYMENT-SIGNATURE. Full handshake and shared payment errors: Payments. Stdio MCP: /docs/mcp.

Guarantees

• HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON.
• exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE.
• HTTP 402 is unpaid only. Do not sign a second authorization because of a 503.
• Execution is timeout-bounded and concurrency-capped.
• Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.