{"uid":"cap_MBPapiSROflqHHjpM64yI","slug":"behavioral-pain-scale-bps-calculator-payen-2001-8d1276d5","name":"Behavioral Pain Scale (BPS) Calculator — Payen 2001","description":"Payen 2001 Behavioral Pain Scale from three caller-assigned 1-4 items (facial_expression, upper_limbs, ventilator_compliance) using that paper's Table 1 descriptors. magent sums only (range 3-12) and does not observe the patient. No later pain-present cutoffs. Not a pain diagnosis or analgesic order. Not CPOT (CPOT items are 0-2).","url":"https://api.magentlab.com/api/calc/bps","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":["facial_expression","upper_limbs","ventilator_compliance"],"properties":{"upper_limbs":{"type":"integer","description":"Caller-assigned Payen 2001 BPS upper limbs (integer 1-4): 1 no movement; 2 partially bent; 3 fully bent with finger flexion; 4 permanently retracted. magent does not observe the patient."},"facial_expression":{"type":"integer","description":"Caller-assigned Payen 2001 BPS facial expression (integer 1-4): 1 relaxed; 2 partially tightened (e.g. brow lowering); 3 fully tightened (e.g. eyelid closing); 4 grimacing. magent does not observe the patient."},"ventilator_compliance":{"type":"integer","description":"Caller-assigned Payen 2001 BPS compliance with ventilation (integer 1-4): 1 tolerating movement; 2 coughing but tolerating ventilation most of the time; 3 fighting ventilator; 4 unable to control ventilation. 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_rO4GlUThCI4tGpaFotqAf","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 Payen 2001 Behavioral Pain Scale (BPS) score by summing three caller-supplied integer items (facial expression, upper limbs, ventilator compliance), each rated 1–4, yielding a total of 3–12.","exampleAgentPrompt":"Calculate the Payen 2001 BPS score for my ICU patient: facial expression is partially tightened (score 2), upper limbs are partially bent (score 2), and ventilator compliance is coughing but tolerating most of the time (score 2).","exampleUseCases":[{"title":"ICU pain monitoring during sedation","prompt":"My mechanically ventilated patient has a grimacing face (score 4), upper limbs fully bent with finger flexion (score 3), and is fighting the ventilator (score 3) — what is the Behavioral Pain Scale total?"},{"title":"Routine BPS documentation in nursing workflow","prompt":"I need to log the BPS score for a sedated patient: facial expression relaxed (1), upper limbs no movement (1), and tolerating ventilator movement (1). Can you calculate the Payen BPS sum?"},{"title":"Clinical decision support audit for pain scores","prompt":"Double-check my BPS arithmetic: facial expression fully tightened (3), upper limbs partially bent (2), ventilator compliance tolerating movement (1) — what should the total come out to?"}],"resultDescription":"Returns the summed Behavioral Pain Scale total score as an integer between 3 and 12, derived strictly from the three caller-provided subscores using Payen 2001 Table 1 definitions. No pain diagnosis, cutoff interpretation, or analgesic recommendation is included.","failureModes":["Integer values outside 1–4 range for any item will cause a validation error","Missing any of the three required query parameters returns an error","Non-integer (float or string) inputs for subscores will be rejected","Score interpretation (e.g. pain-present cutoff) is not provided — callers must apply their own clinical thresholds"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic arithmetic computation of the Payen 2001 BPS score from pre-assessed subscores and want to avoid manual summation errors in an automated ICU documentation or clinical decision-support pipeline. Prefer this over CPOT calculators (which use 0–2 subscores) or any endpoint that claims to observe or diagnose the patient directly.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:50:51.446Z","isFirstParty":false}