Emergency · LIVE
ASAS axial SpA classification criteria
ASAS axial SpA
Apply the 2009 ASAS classification criteria for axial spondyloarthritis (Rudwaleit set 3a / figure 2): require chronic back pain ≥3 months with age at onset <45, then return whether the imaging arm (sacroiliitis plus ≥1 SpA feature) or the clinical arm (HLA-B27 plus ≥2 other SpA features) classifies axial SpA. Not a diagnosis.
Markdown: /docs/asas-axial-spa.md · Canonical: https://magentlab.com/docs/asas-axial-spa
Not a medical device. Not a diagnosis, dose, or listing recommendation.
What it computes
Apply the 2009 ASAS classification criteria for axial spondyloarthritis (Rudwaleit set 3a / figure 2): require chronic back pain ≥3 months with age at onset <45, then return whether the imaging arm (sacroiliitis plus ≥1 SpA feature) or the clinical arm (HLA-B27 plus ≥2 other SpA features) classifies axial SpA. Not a diagnosis.
When to use
When an agent already has caller-assigned Rudwaleit 2009 entry, imaging, and SpA feature flags and needs the published axial SpA classification result for research, not a diagnosis, not peripheral ASAS 2011, and not modified New York AS-only.
When not to use
- Not a medical device and not a diagnosis of axial spondyloarthritis or ankylosing spondylitis. Classification criteria for research.
- Entry (chronic_back_pain_ge_3_months true and age_at_onset_years 1–44) must be met or the request is HTTP 400 and is not returned as classified=false.
- MRI and radiographic sacroiliitis are caller-assigned. MRI means active (acute) inflammation highly suggestive of SpA-associated sacroiliitis. Radiographic means definite sacroiliitis according to modified New York (bilateral grade ≥2 or unilateral grade 3–4). magent does not read films.
- This tool is ASAS 2009 axial SpA classification (set 3a) only. It is not the 2011 peripheral ASAS criteria and not modified New York AS-only classification.
- HLA-B27 is obligatory in the clinical arm and does not count toward the two other SpA features. magent does not assay HLA-B27 or CRP.
Formula
ASAS 2009 axial SpA classification (Rudwaleit set 3a / fig 2 + table 5): required chronic_back_pain_ge_3_months true and age_at_onset_years 1–44 (age at onset <45). sacroiliitis_on_imaging = mri_sacroiliitis or radiographic_sacroiliitis. spa_feature_count = count of 11 SpA features (inflammatory_back_pain, arthritis, enthesitis_heel, uveitis, dactylitis, psoriasis, ibd, nsaid_good_response, family_history_spa, hla_b27, elevated_crp). other_spa_feature_count = spa_feature_count minus 1 if hla_b27 else spa_feature_count. imaging_arm iff sacroiliitis_on_imaging and spa_feature_count ≥1. clinical_arm iff hla_b27 and other_spa_feature_count ≥2. classified iff imaging_arm or clinical_arm. Not a diagnosis. Not peripheral ASAS 2011. Not modified New York AS-only
Citation
- Authors
- Rudwaleit M, van der Heijde D, Landewé R, Listing J, Akkoc N, Brandt J, Braun J, Chou CT, Collantes-Estevez E, Dougados M, Huang F, Gu J, Khan MA, Kirazli Y, Maksymowych WP, Mielants H, Sørensen IJ, Ozgocmen S, Roussou E, Valle-Oñate R, Weber U, Wei J, Sieper J
- Source
- Ann Rheum Dis. 2009;68(6):777-783
Worked example
MRI sacroiliitis plus inflammatory back pain, imaging arm
Given:
age_at_onset_years=28arthritis=falsechronic_back_pain_ge_3_months=truedactylitis=falseelevated_crp=falseenthesitis_heel=falsefamily_history_spa=falsehla_b27=falseibd=falseinflammatory_back_pain=truemri_sacroiliitis=truensaid_good_response=falsepsoriasis=falseradiographic_sacroiliitis=falseuveitis=false
- Required: chronic_back_pain_ge_3_months true, age_at_onset_years 28
- mri_sacroiliitis true; radiographic_sacroiliitis false → sacroiliitis_on_imaging true
- inflammatory_back_pain true; remaining SpA features including hla_b27 false → spa_feature_count 1, other_spa_feature_count 1
- imaging_arm true (sacroiliitis and ≥1 feature); clinical_arm false; classified true
Radiographic sacroiliitis plus HLA-B27, imaging arm
Given:
age_at_onset_years=28arthritis=falsechronic_back_pain_ge_3_months=truedactylitis=falseelevated_crp=falseenthesitis_heel=falsefamily_history_spa=falsehla_b27=trueibd=falseinflammatory_back_pain=falsemri_sacroiliitis=falsensaid_good_response=falsepsoriasis=falseradiographic_sacroiliitis=trueuveitis=false
- radiographic_sacroiliitis true; HLA-B27 is the sole SpA feature
- spa_feature_count 1; other_spa_feature_count 0 (HLA-B27 does not count as an other feature)
- imaging_arm true; clinical_arm false (need ≥2 other features); classified true
HLA-B27 plus two other features, clinical arm
Given:
age_at_onset_years=28arthritis=truechronic_back_pain_ge_3_months=truedactylitis=falseelevated_crp=falseenthesitis_heel=falsefamily_history_spa=falsehla_b27=trueibd=falseinflammatory_back_pain=truemri_sacroiliitis=falsensaid_good_response=falsepsoriasis=falseradiographic_sacroiliitis=falseuveitis=false
- No sacroiliitis on imaging
- hla_b27, inflammatory_back_pain, and arthritis true → spa_feature_count 3, other_spa_feature_count 2
- clinical_arm true; imaging_arm false; classified true
Entry met, no imaging, no SpA features, not classified
Given:
age_at_onset_years=28arthritis=falsechronic_back_pain_ge_3_months=truedactylitis=falseelevated_crp=falseenthesitis_heel=falsefamily_history_spa=falsehla_b27=falseibd=falseinflammatory_back_pain=falsemri_sacroiliitis=falsensaid_good_response=falsepsoriasis=falseradiographic_sacroiliitis=falseuveitis=false
- Entry met; all imaging and SpA flags false
- spa_feature_count 0; imaging_arm false; clinical_arm false; classified false
Imaging arm classifies when clinical arm is negative
Given:
age_at_onset_years=28arthritis=falsechronic_back_pain_ge_3_months=truedactylitis=falseelevated_crp=falseenthesitis_heel=falsefamily_history_spa=falsehla_b27=trueibd=falseinflammatory_back_pain=truemri_sacroiliitis=truensaid_good_response=falsepsoriasis=falseradiographic_sacroiliitis=falseuveitis=false
- mri_sacroiliitis true; hla_b27 and inflammatory_back_pain true
- spa_feature_count 2; other_spa_feature_count 1 → clinical_arm false
- imaging_arm true; classified true
Also searched as
- ASAS axial spondyloarthritis
- ASAS 2009 classification criteria
- Rudwaleit axial SpA
- axial spondyloarthritis classification
- HLA-B27 sacroiliitis criteria
- ASAS axSpA
- inflammatory back pain SpA classification
- not modified New York AS
Try
Opens the live endpoint. Unpaid browser requests show the paywall; agents should send Accept: application/json.
Full URL: https://api.magentlab.com/api/calc/asas_axial_spa?chronic_back_pain_ge_3_months=true&age_at_onset_years=28&mri_sacroiliitis=true&radiographic_sacroiliitis=false&inflammatory_back_pain=true&arthritis=false&enthesitis_heel=false&uveitis=false&dactylitis=false&psoriasis=false&ibd=false&nsaid_good_response=false&family_history_spa=false&hla_b27=false&elevated_crp=false
Call
Expect HTTP 402 until you retry with PAYMENT-SIGNATURE. Incomplete query params
return HTTP 400 before any quote or charge.
curl -i -H "Accept: application/json" "https://api.magentlab.com/api/calc/asas_axial_spa?chronic_back_pain_ge_3_months=true&age_at_onset_years=28&mri_sacroiliitis=true&radiographic_sacroiliitis=false&inflammatory_back_pain=true&arthritis=false&enthesitis_heel=false&uveitis=false&dactylitis=false&psoriasis=false&ibd=false&nsaid_good_response=false&family_history_spa=false&hla_b27=false&elevated_crp=false"
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
chronic_back_pain_ge_3_months |
boolean | required | Must be true. Rudwaleit 2009 entry: chronic back pain ≥3 months. false is invalid and is not returned as classified=false. magent does not take a history. |
age_at_onset_years |
integer | required | Age at onset of back pain in years, integer 1–44 (Rudwaleit 2009 entry: age at onset <45). 0 and ≥45 are invalid and are not classified. magent does not date the patient. |
mri_sacroiliitis |
boolean | required | Active (acute) inflammation on MRI highly suggestive of SpA-associated sacroiliitis, as assigned by the caller (Rudwaleit 2009). Combined with radiographic_sacroiliitis by OR for sacroiliitis_on_imaging. true or false. magent does not read MRI. |
radiographic_sacroiliitis |
boolean | required | Definite radiographic sacroiliitis according to modified New York criteria (bilateral grade ≥2 or unilateral grade 3–4), as assigned by the caller (Rudwaleit 2009). true or false. magent does not read radiographs. |
inflammatory_back_pain |
boolean | required | Inflammatory back pain as assigned by the caller (Rudwaleit 2009 fig 2 / table 5). true or false. magent does not take a history or apply a nested IBP questionnaire. |
arthritis |
boolean | required | Past or present synovitis diagnosed by a physician, as assigned by the caller (Rudwaleit 2009). true or false. magent does not examine joints. |
enthesitis_heel |
boolean | required | Past or present spontaneous pain or tenderness at the insertion of the Achilles tendon or plantar fascia at the calcaneus, as assigned by the caller (Rudwaleit 2009). Heel enthesitis only. true or false. magent does not examine entheses. |
uveitis |
boolean | required | Past or present uveitis confirmed by an ophthalmologist, as assigned by the caller (Rudwaleit 2009). true or false. magent does not examine the eye. |
dactylitis |
boolean | required | Past or present dactylitis diagnosed by a physician, as assigned by the caller (Rudwaleit 2009). true or false. magent does not examine digits. |
psoriasis |
boolean | required | Past or present psoriasis diagnosed by a physician, as assigned by the caller (Rudwaleit 2009). true or false. magent does not examine skin. |
ibd |
boolean | required | Past or present Crohn's disease or ulcerative colitis diagnosed by a physician, as assigned by the caller (Rudwaleit 2009). true or false. magent does not diagnose IBD. |
nsaid_good_response |
boolean | required | Good response to NSAIDs as assigned by the caller (Rudwaleit 2009): 24–48 h after a full dose of NSAID the back pain is not present anymore or is much better. true or false. magent does not prescribe NSAIDs. |
family_history_spa |
boolean | required | Family history of SpA as assigned by the caller (Rudwaleit 2009): first-degree or second-degree relatives with ankylosing spondylitis, psoriasis, acute uveitis, reactive arthritis, or IBD. true or false. magent does not take a pedigree. |
hla_b27 |
boolean | required | HLA-B27 positive as assigned by the caller (Rudwaleit 2009). Obligatory for the clinical arm; does not count toward the two other SpA features. Counts toward spa_feature_count and the imaging arm. true or false. magent does not assay HLA-B27. |
elevated_crp |
boolean | required | CRP above the upper limit of normal in the presence of back pain after exclusion of other causes, as assigned by the caller (Rudwaleit 2009). true or false. magent does not assay CRP. |
Bulk (POST)
POST the same path with a JSON items array. The first item is the GET unit; each additional item is $0.002. Invalid items return HTTP 400 before settlement.
- 1 to 25 items. Each item uses the same keys as the GET query parameters.
- POST of 1 item costs the same as GET. Lists longer than 25: chunk into multiple POSTs. Extra items still execute; do not pad dummy rows.
- The first invalid item fails the whole request (index in the 400 JSON). You are not charged.
- HTTP 200 is {count, path, items}. Each items[i] is the GET 200 body for that row.
- Catalog misses (empty matches, found=false) stay paid 200s inside that slot.
- x402 resource URL is this path plus n and body_sha256. Browsers that prefer text/html get the same paywall as GET; Pay retries POST with the same items.
Example request (fixture)
{
"items": [
{
"age_at_onset_years": "28",
"arthritis": "false",
"chronic_back_pain_ge_3_months": "true",
"dactylitis": "false",
"elevated_crp": "false",
"enthesitis_heel": "false",
"family_history_spa": "false",
"hla_b27": "false",
"ibd": "false",
"inflammatory_back_pain": "true",
"mri_sacroiliitis": "true",
"nsaid_good_response": "false",
"psoriasis": "false",
"radiographic_sacroiliitis": "false",
"uveitis": "false"
},
{
"age_at_onset_years": "28",
"arthritis": "false",
"chronic_back_pain_ge_3_months": "true",
"dactylitis": "false",
"elevated_crp": "false",
"enthesitis_heel": "false",
"family_history_spa": "false",
"hla_b27": "false",
"ibd": "false",
"inflammatory_back_pain": "true",
"mri_sacroiliitis": "true",
"nsaid_good_response": "false",
"psoriasis": "false",
"radiographic_sacroiliitis": "false",
"uveitis": "false"
}
]
}
Opens a two-item fixture on the API host. Unpaid browsers get the same MetaMask paywall as GET; Pay retries POST with those items.
Example 200 (fixture)
{
"count": 2,
"path": "/api/calc/asas_axial_spa",
"items": [
{
"disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
"citation": {
"authors": "Rudwaleit M, van der Heijde D, Landewé R, Listing J, Akkoc N, Brandt J, Braun J, Chou CT, Collantes-Estevez E, Dougados M, Huang F, Gu J, Khan MA, Kirazli Y, Maksymowych WP, Mielants H, Sørensen IJ, Ozgocmen S, Roussou E, Valle-Oñate R, Weber U, Wei J, Sieper J",
"doi": "10.1136/ard.2009.108233",
"id": "rudwaleit-2009",
"pmid": "19297345",
"source": "Ann Rheum Dis. 2009;68(6):777-783",
"title": "The development of Assessment of SpondyloArthritis international Society classification criteria for axial spondyloarthritis (part II): validation and final selection"
},
"formula": "asas_axial_spa",
"formula_expression": "ASAS 2009 axial SpA classification (Rudwaleit set 3a / fig 2 + table 5): required chronic_back_pain_ge_3_months true and age_at_onset_years 1–44 (age at onset <45). sacroiliitis_on_imaging = mri_sacroiliitis or radiographic_sacroiliitis. spa_feature_count = count of 11 SpA features (inflammatory_back_pain, arthritis, enthesitis_heel, uveitis, dactylitis, psoriasis, ibd, nsaid_good_response, family_history_spa, hla_b27, elevated_crp). other_spa_feature_count = spa_feature_count minus 1 if hla_b27 else spa_feature_count. imaging_arm iff sacroiliitis_on_imaging and spa_feature_count ≥1. clinical_arm iff hla_b27 and other_spa_feature_count ≥2. classified iff imaging_arm or clinical_arm. Not a diagnosis. Not peripheral ASAS 2011. Not modified New York AS-only",
"classified": true,
"clinical_arm": false,
"imaging_arm": true,
"other_spa_feature_count": 1,
"sacroiliitis_on_imaging": true,
"spa_feature_count": 1
},
{
"disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
"citation": {
"authors": "Rudwaleit M, van der Heijde D, Landewé R, Listing J, Akkoc N, Brandt J, Braun J, Chou CT, Collantes-Estevez E, Dougados M, Huang F, Gu J, Khan MA, Kirazli Y, Maksymowych WP, Mielants H, Sørensen IJ, Ozgocmen S, Roussou E, Valle-Oñate R, Weber U, Wei J, Sieper J",
"doi": "10.1136/ard.2009.108233",
"id": "rudwaleit-2009",
"pmid": "19297345",
"source": "Ann Rheum Dis. 2009;68(6):777-783",
"title": "The development of Assessment of SpondyloArthritis international Society classification criteria for axial spondyloarthritis (part II): validation and final selection"
},
"formula": "asas_axial_spa",
"formula_expression": "ASAS 2009 axial SpA classification (Rudwaleit set 3a / fig 2 + table 5): required chronic_back_pain_ge_3_months true and age_at_onset_years 1–44 (age at onset <45). sacroiliitis_on_imaging = mri_sacroiliitis or radiographic_sacroiliitis. spa_feature_count = count of 11 SpA features (inflammatory_back_pain, arthritis, enthesitis_heel, uveitis, dactylitis, psoriasis, ibd, nsaid_good_response, family_history_spa, hla_b27, elevated_crp). other_spa_feature_count = spa_feature_count minus 1 if hla_b27 else spa_feature_count. imaging_arm iff sacroiliitis_on_imaging and spa_feature_count ≥1. clinical_arm iff hla_b27 and other_spa_feature_count ≥2. classified iff imaging_arm or clinical_arm. Not a diagnosis. Not peripheral ASAS 2011. Not modified New York AS-only",
"classified": true,
"clinical_arm": false,
"imaging_arm": true,
"other_spa_feature_count": 1,
"sacroiliitis_on_imaging": true,
"spa_feature_count": 1
}
]
}
Response
| Field | Type | Description |
|---|---|---|
formula |
string | asas_axial_spa |
formula_expression |
string | Rudwaleit 2009 ASAS axial SpA classification expression (set 3a / fig 2) |
classified |
boolean | true iff imaging_arm or clinical_arm. Classification criteria for research, not a diagnosis of axial SpA. Not peripheral ASAS 2011. Not modified New York AS-only. |
imaging_arm |
boolean | true iff sacroiliitis_on_imaging and spa_feature_count ≥1 (Rudwaleit 2009 fig 2) |
clinical_arm |
boolean | true iff hla_b27 and other_spa_feature_count ≥2 (Rudwaleit 2009 fig 2). HLA-B27 does not count toward the two other features. |
spa_feature_count |
integer | Count of the 11 SpA features that are true, including HLA-B27 when true. |
other_spa_feature_count |
integer | spa_feature_count minus 1 when hla_b27 is true, else spa_feature_count. Used for the clinical arm. |
sacroiliitis_on_imaging |
boolean | true iff mri_sacroiliitis or radiographic_sacroiliitis |
citation |
object | Rudwaleit 2009 Ann Rheum Dis citation |
disclaimer |
string | Not-a-device notice |
Example JSON
Machine form of the same example. Frozen fixture. Not a live lookup.
{
"disclaimer": "Not a medical device. Deterministic published-formula or published-code output for autonomous agents. A licensed clinician remains responsible for patient care and billing submissions.",
"citation": {
"authors": "Rudwaleit M, van der Heijde D, Landewé R, Listing J, Akkoc N, Brandt J, Braun J, Chou CT, Collantes-Estevez E, Dougados M, Huang F, Gu J, Khan MA, Kirazli Y, Maksymowych WP, Mielants H, Sørensen IJ, Ozgocmen S, Roussou E, Valle-Oñate R, Weber U, Wei J, Sieper J",
"doi": "10.1136/ard.2009.108233",
"id": "rudwaleit-2009",
"pmid": "19297345",
"source": "Ann Rheum Dis. 2009;68(6):777-783",
"title": "The development of Assessment of SpondyloArthritis international Society classification criteria for axial spondyloarthritis (part II): validation and final selection"
},
"formula": "asas_axial_spa",
"formula_expression": "ASAS 2009 axial SpA classification (Rudwaleit set 3a / fig 2 + table 5): required chronic_back_pain_ge_3_months true and age_at_onset_years 1–44 (age at onset <45). sacroiliitis_on_imaging = mri_sacroiliitis or radiographic_sacroiliitis. spa_feature_count = count of 11 SpA features (inflammatory_back_pain, arthritis, enthesitis_heel, uveitis, dactylitis, psoriasis, ibd, nsaid_good_response, family_history_spa, hla_b27, elevated_crp). other_spa_feature_count = spa_feature_count minus 1 if hla_b27 else spa_feature_count. imaging_arm iff sacroiliitis_on_imaging and spa_feature_count ≥1. clinical_arm iff hla_b27 and other_spa_feature_count ≥2. classified iff imaging_arm or clinical_arm. Not a diagnosis. Not peripheral ASAS 2011. Not modified New York AS-only",
"classified": true,
"clinical_arm": false,
"imaging_arm": true,
"other_spa_feature_count": 1,
"sacroiliitis_on_imaging": true,
"spa_feature_count": 1
}
Client errors (HTTP 400)
Invalid params return 400 without charge. Shared HTTP 402 and 503 meanings: Payments.
| HTTP | Code | When |
|---|---|---|
| 400 | invalid_asas |
chronic_back_pain_ge_3_months must be true and age_at_onset_years an integer from 1 to 44 (Rudwaleit 2009 ASAS axial SpA entry: back pain ≥3 months, age at onset <45). Returned before settlement; you are not charged. |
| 400 | invalid_flag |
boolean clinical flags must be true or false Returned before settlement; you are not charged. |
| 400 | invalid_items |
POST body must be a JSON object with only an items array Returned before settlement; you are not charged. |
| 400 | invalid_item_count |
items must be an array of 1 to 25 objects Returned before settlement; you are not charged. |
| 400 | invalid_item |
each items entry must be a JSON object Returned before settlement; you are not charged. |
Related tools
- ACR/EULAR gout — Apply the 2015 ACR/EULAR gout classification criteria (Neogi Table 2): require the entry episode, classify immediately if MSU crystals are present, otherwise return the Step 3 score (max 23) and whether score ≥8 classifies gout. Not a gout diagnosis.
- ACR/EULAR PMR — Apply the 2012 EULAR/ACR polymyalgia rheumatica classification criteria (Dasgupta Table 4): require age ≥50, bilateral shoulder aching, and abnormal CRP and/or ESR, then return the clinical score with or without optional ultrasound and whether the published cut point classifies PMR. Not a PMR diagnosis.
- ACR/EULAR Sjögren — Apply the 2016 ACR/EULAR classification criteria for primary Sjögren's syndrome (Shiboski Table 3): require published inclusion and no exclusion, then return the five-item weighted score and whether the ≥4 cut point classifies primary Sjögren's syndrome. Not a diagnosis.
Payment
Unpaid requests return HTTP 402 even if query parameters or POST items are missing or invalid, so CDP and agents can index the path. After a PAYMENT-SIGNATURE, invalid params return HTTP 400 JSON before settlement. magent does not charge. Fix the params, then request a new 402 quote for that complete URL. Catalog misses (empty matches, found=false) are valid paid 200s. Unpaid valid requests return HTTP 402 with a base64
PAYMENT-REQUIRED
header. HTTP 503 is not a new quote: retry the same PAYMENT-SIGNATURE. Full handshake
and shared payment errors: Payments.
Stdio MCP: /docs/mcp.
Guarantees
- HTTP 402 is unpaid, including a missing query. After PAYMENT-SIGNATURE, invalid parameters return HTTP 400 before settlement. You are not charged. HTTP 402 never includes the tool JSON.
- exact: settlement finishes before the tool (paymentFlow upfront). batch-settlement: verify/deposit before the tool; chargedCumulativeAmount commits after HTTP 2xx. Uncertain or failed settlement fails closed (HTTP 503). Retry the same PAYMENT-SIGNATURE.
- HTTP 402 is unpaid only. Do not sign a second authorization because of a 503.
- Execution is timeout-bounded and concurrency-capped.
- Calculator inputs are stored encrypted for allowlisted operators (Magent Console). They are not in public logs, SSH lookups, catalog, or rollups. Request logs store path without query.