# HEADS-ED Pediatric Mental Health Triage Score (Cappelli 2012)

> HEADS-ED Pediatric Mental Health Triage Score (Cappelli 2012) is a paid API for AI agents from api.magentlab.com, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-14).

Computes the HEADS-ED total score (0–14) by summing seven caller-assigned 0–2 domain ratings for pediatric emergency mental health triage.

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/heads_ed
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/heads-ed-pediatric-mental-health-triage-score-cappelli-2012-7125ad16
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_gnCwetNq4BFgfF7ahfNMG

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 heads-ed-pediatric-mental-health-triage-score-cappelli-2012-7125ad16
```

Example prompt: 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.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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": "Call
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/heads-ed-pediatric-mental-health-triage-score-cappelli-2012-7125ad16/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.magentlab.com](https://www.zero.xyz/host/api.magentlab.com/llms.txt)