{"uid":"cap_fP2Jcyp8CPLB8CKhSJ9Ye","slug":"magent-hits-intimate-partner-violence-screener-d94df9c7","name":"magent HITS Intimate Partner Violence Screener","description":"Sherin 1998 HITS from four caller-assigned integers 1-5 (hurt, insult, threaten, scream; never=1 to frequently=5). magent does not interview the patient or interpret the items. Sum 4-20. Screen-positive when score ≥10. Deterministic published score with citation; not a diagnosis of intimate partner violence and not a medical device.","url":"https://api.magentlab.com/api/calc/hits","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":["hurt","insult","threaten","scream"],"properties":{"hurt":{"type":"integer","description":"Caller-assigned Sherin 1998 HITS Hurt item (integer 1-5; never=1 to frequently=5): how often the partner physically hurt the patient. magent does not interview the patient."},"insult":{"type":"integer","description":"Caller-assigned Sherin 1998 HITS Insult item (integer 1-5; never=1 to frequently=5): how often the partner insulted or talked down to the patient. magent does not interview the patient."},"scream":{"type":"integer","description":"Caller-assigned Sherin 1998 HITS Scream item (integer 1-5; never=1 to frequently=5): how often the partner screamed or cursed at the patient. magent does not interview the patient."},"threaten":{"type":"integer","description":"Caller-assigned Sherin 1998 HITS Threaten item (integer 1-5; never=1 to frequently=5): how often the partner threatened the patient with harm. magent does not interview the patient."}}}},"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_8LCW2zmlky5yQMSoMy3sY","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 Sherin 1998 HITS score (sum 4–20) from four caller-assigned integer items and returns a screen-positive flag when score ≥10","exampleAgentPrompt":"Calculate the HITS intimate partner violence score for a patient whose partner physically hurts them sometimes (3), insults them fairly often (4), threatens them rarely (2), and screams at them sometimes (3) — is the screen positive?","exampleUseCases":[{"title":"EHR-integrated IPV screening workflow","prompt":"I have a patient where the clinician recorded HITS item responses: hurt=2, insult=3, threaten=1, scream=2 — compute the HITS score and tell me whether it crosses the screen-positive threshold of 10."},{"title":"Research data batch scoring","prompt":"For a study participant with HITS responses hurt=5, insult=4, threaten=4, scream=5, what is the total Sherin 1998 HITS score and is this a positive screen?"},{"title":"Clinical training case demonstration","prompt":"Walk me through the HITS score for a training scenario where the partner never physically hurts (1), sometimes insults (3), never threatens (1), and frequently screams (5) at the patient — what's the total and is it screen-positive?"}],"resultDescription":"Returns the numeric HITS total score (integer 4–20), a screen-positive boolean or flag (positive when ≥10), and a citation to Sherin 1998 for provenance. The endpoint performs deterministic arithmetic only and does not diagnose intimate partner violence.","failureModes":["Missing any of the four required query parameters (hurt, insult, threaten, scream) returns a 400 or validation error","Any item value outside the integer range 1–5 may return a validation error or unexpected result","Non-integer values for any item will fail schema validation","Score output should not be interpreted as a clinical diagnosis — misuse risk if caller conflates screen-positive with confirmed IPV"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, published HITS (Sherin 1998) score computation with a citeable reference, rather than building your own arithmetic. Prefer it over generic scoring libraries when you need the exact published threshold (≥10 = screen-positive) and need the result to be reproducible and auditable. Use it in clinical decision-support agents, EHR integrations, or research pipelines where the HITS tool has been chosen as the IPV screening instrument.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T13:09:36.179Z","isFirstParty":false}