{"uid":"cap_Mgo0Ajz004hThMJA_tRk4","slug":"abbey-pain-scale-calculator-abbey-2004-1e580e40","name":"Abbey Pain Scale Calculator (Abbey 2004)","description":"Abbey 2004 observational pain scale from six caller-assigned 0-3 items (vocalization, facial_expression, change_in_body_language, behavioural_change, physiological_change, physical_changes) using that paper's absent/mild/moderate/severe descriptors. magent sums only (max 18) and returns Abbey 2004 bands: 0-2 none, 3-7 mild, 8-13 moderate, 14+ severe. magent does not observe the patient. Not a pain diagnosis or analgesic order. Not PAINAD.","url":"https://api.magentlab.com/api/calc/abbey","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":["vocalization","facial_expression","change_in_body_language","behavioural_change","physiological_change","physical_changes"],"properties":{"vocalization":{"type":"integer","description":"Caller-assigned Abbey 2004 vocalization (integer 0-3): 0 absent; 1 mild; 2 moderate; 3 severe. Paper examples: whimpering, groaning, crying. magent does not observe the patient."},"physical_changes":{"type":"integer","description":"Caller-assigned Abbey 2004 physical changes (integer 0-3): 0 absent; 1 mild; 2 moderate; 3 severe. Paper examples: skin tears, pressure areas, arthritis, contractures, previous injuries. magent does not observe the patient."},"facial_expression":{"type":"integer","description":"Caller-assigned Abbey 2004 facial expression (integer 0-3): 0 absent; 1 mild; 2 moderate; 3 severe. Paper examples: looking tense, frowning, grimacing, looking frightened. magent does not observe the patient."},"behavioural_change":{"type":"integer","description":"Caller-assigned Abbey 2004 behavioural change (integer 0-3): 0 absent; 1 mild; 2 moderate; 3 severe. Paper examples: increased confusion, refusing to eat, alteration in usual patterns. magent does not observe the patient."},"physiological_change":{"type":"integer","description":"Caller-assigned Abbey 2004 physiological change (integer 0-3): 0 absent; 1 mild; 2 moderate; 3 severe. Paper examples: temperature, pulse or blood pressure outside normal limits, perspiring, flushing or pallor. magent does not observe the patient."},"change_in_body_language":{"type":"integer","description":"Caller-assigned Abbey 2004 change in body language (integer 0-3): 0 absent; 1 mild; 2 moderate; 3 severe. Paper examples: fidgeting, rocking, guarding part of body, withdrawn. magent does not observe 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_4qCcBUYxB7pc6mBZAWXX6","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 Abbey 2004 pain scale total score and severity band from six caller-assigned 0–3 item ratings for non-verbal patients","exampleAgentPrompt":"Score this patient's Abbey 2004 pain scale: vocalization 2, facial expression 3, change in body language 1, behavioural change 2, physiological change 1, physical changes 2 — what's the total score and pain band?","exampleUseCases":[{"title":"Aged care pain triage for non-verbal resident","prompt":"I'm assessing a non-verbal dementia resident. They're whimpering quietly (vocalization 1), grimacing (facial expression 2), guarding their hip (body language change 2), refusing meals today (behavioural change 1), pulse slightly elevated (physiological change 1), and they have an existing pressure area (physical changes 2). Can you run the Abbey pain scale and tell me their score and severity band?"},{"title":"Palliative care handover documentation","prompt":"For the handover notes, I need the Abbey 2004 score for our patient: vocalization 0, facial expression 1, body language change 0, behavioural change 1, physiological change 2, physical changes 3. What's the total and which severity band does that fall into?"},{"title":"Automated pain monitoring in clinical workflow","prompt":"My care workflow needs to check pain level for a resident using the Abbey scale — vocalization rated 3, facial expression 2, change in body language 3, behavioural change 2, physiological change 2, physical changes 1. Calculate the Abbey total and tell me if that's mild, moderate, or severe."}],"resultDescription":"Returns the integer sum of the six Abbey 2004 items (range 0–18) and the corresponding severity band label: 'none' (0–2), 'mild' (3–7), 'moderate' (8–13), or 'severe' (14–18). Does not perform patient observation or issue clinical diagnoses.","failureModes":["Missing any of the six required query parameters returns an error","Any item value outside integer range 0–3 is rejected","Non-integer (e.g. decimal or string) inputs cause validation failure","Confusing this with PAINAD or other pain scales may yield clinically inappropriate results — this endpoint uses strictly Abbey 2004 criteria"],"whenToPreferThis":"Use this endpoint when you need to compute and classify a formal Abbey 2004 pain score for a patient who cannot self-report (e.g. advanced dementia, post-operative unconscious, cognitively impaired elderly), and the caller has already made the six Abbey item observations. Prefer this over PAINAD or other scales when your clinical protocol specifically requires Abbey 2004 scoring and severity banding.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:56:57.795Z","isFirstParty":false}