{"uid":"cap_gnCwetNq4BFgfF7ahfNMG","slug":"heads-ed-pediatric-mental-health-triage-score-cappelli-2012-7125ad16","name":"HEADS-ED Pediatric Mental Health Triage Score (Cappelli 2012)","description":"Cappelli 2012 HEADS-ED from seven caller-assigned 0-2 domains (Home, Education, Activities/peers, Drugs/alcohol, Suicidality, Emotions/behavior, Discharge resources). 0 no action needed, 1 needs action but not immediately, 2 needs immediate action. magent sums only (max 14) and does not interview a child. No labeled high-risk band. Not a medical device or psychiatric admission order.","url":"https://api.magentlab.com/api/calc/heads_ed","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":["home","education","activities","drugs","suicidality","emotions","discharge_resources"],"properties":{"home":{"type":"integer","description":"Caller-assigned Cappelli 2012 Home (integer 0-2): 0 no action needed (supportive); 1 needs action but not immediately (conflicts); 2 needs immediate action (chaotic/dysfunctional). magent does not interview a child."},"drugs":{"type":"integer","description":"Caller-assigned Cappelli 2012 Drugs/alcohol (integer 0-2): 0 no action needed (none or infrequent); 1 needs action but not immediately (occasional); 2 needs immediate action (frequent/daily). magent does not interview a child."},"emotions":{"type":"integer","description":"Caller-assigned Cappelli 2012 Emotions/behavior (integer 0-2): 0 no action needed (mildly anxious/sad/acting out); 1 needs action but not immediately (moderately anxious/sad/acting out); 2 needs immediate action (significantly distressed/unable to function/out of control). magent does not interview a child."},"education":{"type":"integer","description":"Caller-assigned Cappelli 2012 Education (integer 0-2): 0 no action needed (on track); 1 needs action but not immediately (grades dropping or absenteeism); 2 needs immediate action (failing/not attending). magent does not interview a child."},"activities":{"type":"integer","description":"Caller-assigned Cappelli 2012 Activities/peers (integer 0-2): 0 no action needed (no change); 1 needs action but not immediately (reduction in activities/increased peer conflicts); 2 needs immediate action (increasingly to fully withdrawn/significant peer conflicts). magent does not interview a child."},"suicidality":{"type":"integer","description":"Caller-assigned Cappelli 2012 Suicidality (integer 0-2): 0 no action needed (no thoughts); 1 needs action but not immediately (ideation); 2 needs immediate action (plan or gesture). magent does not interview a child."},"discharge_resources":{"type":"integer","description":"Caller-assigned Cappelli 2012 Discharge resources (integer 0-2): 0 no action needed (ongoing/well connected); 1 needs action but not immediately (some/not meeting needs); 2 needs immediate action (none/on waitlist). magent does not interview a child."}}}},"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_GOZrv8mZhg_zDXFKZ8tqQ","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 HEADS-ED total score (0–14) by summing seven caller-assigned 0–2 domain ratings for pediatric emergency mental health triage.","exampleAgentPrompt":"Calculate the HEADS-ED score for a pediatric patient where home is 1, education is 2, activities/peers is 1, drugs/alcohol is 0, suicidality is 2, emotions/behavior is 1, and discharge resources is 1.","exampleUseCases":[{"title":"Pediatric ED mental health triage","prompt":"I'm seeing a 14-year-old in the ED — home situation is somewhat conflicted so I'd rate it 1, education is failing so 2, activities are fully withdrawn so 2, no drug use so 0, suicidality is concerning and needs immediate action so 2, emotions are moderately distressed so 1, and discharge resources look limited so 1. Can you calculate the HEADS-ED score?"},{"title":"Tracking repeated ED visits over time","prompt":"This child came in last month with HEADS-ED ratings of home 0, education 1, activities 0, drugs 0, suicidality 1, emotions 1, discharge 0, and today the ratings are home 1, education 1, activities 1, drugs 0, suicidality 2, emotions 2, discharge 1. Calculate both HEADS-ED scores so I can compare the change."},{"title":"Automated triage scoring in clinical workflow","prompt":"Our ED intake system has collected the following HEADS-ED domain ratings for a patient: home 2, education 2, activities 2, drugs 1, suicidality 2, emotions 2, discharge resources 2. Please compute the total HEADS-ED score so we can document it in the chart."}],"resultDescription":"Returns the HEADS-ED total score as an integer between 0 and 14, representing the sum of the seven caller-assigned domain ratings (each 0–2). Higher scores indicate more domains flagged as needing action. No risk band labeling is applied — interpretation is left to the clinician.","failureModes":["Missing one or more of the seven required query parameters returns a validation error","Non-integer or out-of-range values (outside 0–2) for any domain cause a bad request error","Network or server errors may return 5xx responses","Payment failure via x402 protocol results in a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need a fast, reproducible computation of the Cappelli 2012 HEADS-ED total score from pre-assigned domain ratings in a pediatric emergency mental health context. Prefer it over manual summation to avoid arithmetic errors and to integrate scoring into automated clinical workflows. Note: this endpoint does not conduct the patient interview, assign domain ratings, or provide risk-band interpretation — those are the clinician's responsibility.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:52:17.878Z","isFirstParty":false}