# magent HITS Intimate Partner Violence Screener

> magent HITS Intimate Partner Violence Screener 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 Sherin 1998 HITS score (sum 4–20) from four caller-assigned integer items and returns a screen-positive flag when score ≥10

## Facts

- Endpoint: GET https://api.magentlab.com/api/calc/hits
- 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/magent-hits-intimate-partner-violence-screener-d94df9c7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fP2Jcyp8CPLB8CKhSJ9Ye

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 magent-hits-intimate-partner-violence-screener-d94df9c7
```

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

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## 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": [
      "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"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/magent-hits-intimate-partner-violence-screener-d94df9c7/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)