{"uid":"cap_Zp5Uy9671PguR_VRRYLWK","slug":"magent-ace-score-calculator-felitti-1998-7-item-dcaad625","name":"Magent ACE Score Calculator (Felitti 1998, 7-item)","description":"Felitti 1998 ACE Study: seven caller-assigned exposure categories (psychological abuse, physical abuse, sexual abuse, mother treated violently, household substance abuse, household mental illness, household incarceration), 1 point each, max 7. Returns ace_band 0, 1, 2, 3, or ge_4 (score ≥4). A category count, not a diagnosis, trauma inventory, or 10-item ACE-Q. magent does not interpret the items.","url":"https://api.magentlab.com/api/calc/ace","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":["psychological_abuse","physical_abuse","sexual_abuse","mother_treated_violently","household_substance_abuse","household_mental_illness","household_incarceration"],"properties":{"sexual_abuse":{"type":"boolean","description":"Caller-assigned Felitti 1998 ACE Study sexual-abuse category (an adult or person at least 5 years older touched or fondled the respondent in a sexual way, had the respondent touch their body in a sexual way, or attempted or completed oral, anal, or vaginal intercourse). true or false. magent does not interpret the item."},"physical_abuse":{"type":"boolean","description":"Caller-assigned Felitti 1998 ACE Study physical-abuse category (a parent or other adult in the household often or very often pushed, grabbed, slapped, or threw something at the respondent, or ever hit the respondent so hard that there were marks or injury). true or false. magent does not interpret the item."},"psychological_abuse":{"type":"boolean","description":"Caller-assigned Felitti 1998 ACE Study psychological-abuse category (a parent or other adult in the household often or very often swore at, insulted, or put the respondent down, or acted in a way that made the respondent afraid of being physically hurt). true or false. magent does not interpret the item."},"household_incarceration":{"type":"boolean","description":"Caller-assigned Felitti 1998 ACE Study criminal-behavior-in-household category (a household member went to prison). true or false. magent does not interpret the item."},"household_mental_illness":{"type":"boolean","description":"Caller-assigned Felitti 1998 ACE Study household mental-illness category (a household member was depressed or mentally ill, or a household member attempted suicide). true or false. magent does not interpret the item."},"mother_treated_violently":{"type":"boolean","description":"Caller-assigned Felitti 1998 ACE Study mother-treated-violently category (mother or stepmother was pushed, grabbed, slapped, had something thrown at her, kicked, bitten, hit with a fist or hard object, repeatedly hit, or threatened or hurt with a knife or gun). true or false. magent does not interpret the item."},"household_substance_abuse":{"type":"boolean","description":"Caller-assigned Felitti 1998 ACE Study household substance-abuse category (lived with anyone who was a problem drinker or alcoholic, or who used street drugs). true or false. magent does not interpret the item."}}}},"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_R6kGTkTf8Dqwfrm3jev-I","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 a 7-category Adverse Childhood Experiences (ACE) score band from caller-assigned boolean exposure flags based on the Felitti 1998 ACE Study, returning an ace_band of 0, 1, 2, 3, or ge_4.","exampleAgentPrompt":"Calculate the ACE score for a patient with psychological abuse and household substance abuse — no physical abuse, no sexual abuse, mother was not treated violently, no household mental illness, no household incarceration. What ace_band does that give?","exampleUseCases":[{"title":"Clinical chart ACE documentation","prompt":"I need the ACE band for a patient who experienced psychological abuse and had a household member with mental illness, but had no physical abuse, no sexual abuse, mother was not treated violently, no household substance abuse, and no household incarceration. What's the ace_band?"},{"title":"Population health research stratification","prompt":"For a research cohort entry, compute the Felitti 1998 ACE band for someone with physical abuse, sexual abuse, and household incarceration — all other categories are false. I need the ace_band for the record."},{"title":"Automated intake screening workflow","prompt":"Run the 7-item ACE score for a new intake: psychological abuse true, physical abuse false, sexual abuse false, mother treated violently true, household substance abuse true, household mental illness false, household incarceration false. What band does that come out to?"}],"resultDescription":"Returns an ace_band value of 0, 1, 2, 3, or ge_4 (representing a score of 4 or more), representing the sum of the seven caller-assigned Felitti 1998 ACE Study exposure categories. This is a category count only, not a diagnosis or clinical interpretation.","failureModes":["Missing any of the seven required boolean query parameters returns a validation error","Non-boolean values for exposure flags cause a schema error","Network or payment-related failures (x402 payment not fulfilled) block the response","Endpoint does not interpret or validate the clinical accuracy of caller-assigned flags — garbage-in, garbage-out"],"whenToPreferThis":"Choose this endpoint when you need a fast, arithmetic Felitti 1998 7-category ACE score band and you have already determined the boolean exposure values yourself. Prefer this over manual computation to ensure correct banding logic (especially the ge_4 threshold). Do not use this endpoint if you need the full 10-item ACE-Q, a clinical diagnosis, trauma interpretation, or any category not in the original 1998 Felitti set.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T01:21:16.721Z","isFirstParty":false}