{"uid":"cap_HmNIqYZN1w2sjHyL4yPDo","slug":"magent-c-diva-difficult-intravenous-access-score-bell-2023-9976beb9","name":"magent C-DIVA Difficult Intravenous Access Score (Bell 2023)","description":"Bell 2023 C-DIVA from four caller-assigned 0-2 domains (visual appearance, palpable sites, history of difficult access, clinical factors) using that paper's Figure 1 0/1/2 descriptors. magent sums only (max 8) and returns Figure 1 bands low (0-3), medium (4-5), or high (6-8). magent does not examine veins or insert a catheter. Not a vascular-access order, not a medical device.","url":"https://api.magentlab.com/api/calc/c_diva","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["visual_appearance","palpable_sites","history_of_difficult_access","clinical_factors"],"properties":{"palpable_sites":{"type":"integer","description":"Caller-assigned Bell 2023 Figure 1 palpable sites (integer 0-2): 0 many palpable veins; 1 few palpable veins; 2 no palpable veins. magent does not examine the patient."},"clinical_factors":{"type":"integer","description":"Caller-assigned Bell 2023 Figure 1 clinical factors (integer 0-2): 0 not applicable; 1 pediatric patients or urgent conditions (ESI 3-4); 2 comorbidities or emergency conditions (ESI 1-2). magent does not assign ESI or examine the patient."},"visual_appearance":{"type":"integer","description":"Caller-assigned Bell 2023 Figure 1 visual appearance (integer 0-2): 0 many visible veins; 1 few visible veins; 2 no visible veins. magent does not examine the patient."},"history_of_difficult_access":{"type":"integer","description":"Caller-assigned Bell 2023 Figure 1 history of difficult access (integer 0-2): 0 no difficulty; 1 reported difficulty or recent missed attempts; 2 history of major difficulty as evidenced by previous central lines or PICCs. magent does not take a history."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_MdlJVecVsMdDL2B-74bLS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes the Bell 2023 C-DIVA score from four caller-assigned domain scores and returns a risk band (low, medium, or high) for difficult intravenous access.","exampleAgentPrompt":"Calculate the C-DIVA score for a patient with few visible veins (visual appearance 1), no palpable veins (palpable sites 2), a history of reported difficulty with missed attempts (history of difficult access 1), and comorbidities requiring urgent care (clinical factors 2) — give me the total score and difficulty band.","exampleUseCases":[{"title":"ED triage IV access planning","prompt":"A patient just arrived in the ED with no visible veins, no palpable veins, a prior PICC line history, and active comorbidities with ESI 1 — run the Bell 2023 C-DIVA score with visual appearance 2, palpable sites 2, history of difficult access 2, and clinical factors 2, and tell me the risk band."},{"title":"Pediatric urgent care IV stratification","prompt":"I'm documenting a pediatric patient in urgent conditions: they have few visible veins (1), a few palpable veins (1), no reported history of difficult access (0), and they're a pediatric patient with an ESI 3 condition (clinical factors 1). What does the C-DIVA score come out to and is that low, medium, or high?"},{"title":"Pre-procedure IV difficulty documentation","prompt":"Before starting this procedure, I need the C-DIVA risk band: the nurse noted many visible veins (0), few palpable veins (1), the patient reported previous difficulty getting IVs started (1), and there are no relevant comorbidities or urgency (0). Please compute the Bell 2023 C-DIVA score."}],"resultDescription":"Returns the summed C-DIVA integer score (0–8) derived from the four input domain scores, along with the corresponding Bell 2023 Figure 1 difficulty band: low (0–3), medium (4–5), or high (6–8).","failureModes":["Missing required query parameters (visual_appearance, palpable_sites, history_of_difficult_access, clinical_factors) returns a validation error","Values outside the 0–2 integer range for any domain score return a schema validation error","Payment not provided or insufficient USDC via x402 protocol results in 402 Payment Required","Non-integer values for domain scores cause rejection"],"whenToPreferThis":"Use this endpoint when you need a fast, arithmetic Bell 2023 C-DIVA computation from pre-assigned domain scores and want a standardized low/medium/high band output. Prefer this over manual addition when building clinical documentation workflows, decision-support tools, or EHR integrations that require auditable, reproducible C-DIVA scoring. Note: this endpoint does not perform patient examination, vein visualization, or history-taking — all four domain scores must be supplied by the caller.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T07:06:33.166Z","isFirstParty":false}