MAGENT

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.

LIVE $0.005 USDC GET /api/calc/asas_axial_spa

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

Title
The development of Assessment of SpondyloArthritis international Society classification criteria for axial spondyloarthritis (part II): validation and final selection
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
DOI
10.1136/ard.2009.108233

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

  1. Required: chronic_back_pain_ge_3_months true, age_at_onset_years 28
  2. mri_sacroiliitis true; radiographic_sacroiliitis false → sacroiliitis_on_imaging true
  3. inflammatory_back_pain true; remaining SpA features including hla_b27 false → spa_feature_count 1, other_spa_feature_count 1
  4. 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

  1. radiographic_sacroiliitis true; HLA-B27 is the sole SpA feature
  2. spa_feature_count 1; other_spa_feature_count 0 (HLA-B27 does not count as an other feature)
  3. 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

  1. No sacroiliitis on imaging
  2. hla_b27, inflammatory_back_pain, and arthritis true → spa_feature_count 3, other_spa_feature_count 2
  3. 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

  1. Entry met; all imaging and SpA flags false
  2. 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

  1. mri_sacroiliitis true; hla_b27 and inflammatory_back_pain true
  2. spa_feature_count 2; other_spa_feature_count 1 → clinical_arm false
  3. 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.

/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

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.

POST /api/calc/asas_axial_spa Max 25 unit_amount + extra_item_amount * (n - 1) extra $0.002 PREVIEW

  • 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"
    }
  ]
}

Open bulk paywall →

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.