{"uid":"cap_PMCJAZIsrv4zydK95-dD1","slug":"albi-grade-calculator-johnson-2015-0f8c3c94","name":"ALBI Grade Calculator (Johnson 2015)","description":"Johnson 2015 albumin-bilirubin (ALBI) grade from total bilirubin and albumin. xb = 0.66*log10(bilirubin umol/L) + albumin_g_l*(-0.085). Grade 1 if xb <= -2.60, grade 2 if xb <= -1.39, else 3. Returns albi_score (4 decimals) and albi_grade. Not a listing protocol, Child-Pugh, survival estimate, mALBI, PALBI, or EZ-ALBI.","url":"https://api.magentlab.com/api/calc/albi","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":[],"properties":{"albumin_g_l":{"type":"number","description":"Albumin in g/L (10-60). Provide this or albumin_g_dl, not both. Johnson 2015 uses g/L."},"albumin_g_dl":{"type":"number","description":"Albumin in g/dL (1-6). Converted as g/L = g/dL × 10. Provide this or albumin_g_l, not both."},"bilirubin_mg_dl":{"type":"number","description":"Total bilirubin in mg/dL (0.1-40). Converted as µmol/L = mg/dL × 17.1. Provide this or bilirubin_umol_l, not both."},"bilirubin_umol_l":{"type":"number","description":"Total bilirubin in µmol/L (2-684). Provide this or bilirubin_mg_dl, not both. Johnson 2015 uses µmol/L in log10."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"path":"/api/calc/albi","count":2,"items":[{"formula":"albi","citation":{"id":"johnson-2015","doi":"10.1200/JCO.2014.57.9151","pmid":"25512453","title":"Assessment of liver function in patients with hepatocellular carcinoma: a new evidence-based approach-the ALBI grade","source":"J Clin Oncol. 2015;33(6):550-558","authors":"Johnson PJ, Berhane S, Kagebayashi C, et al."},"albi_grade":1,"albi_score":-2.74,"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.","albumin_g_l":40,"bilirubin_umol_l":10,"formula_expression":"albi_score = (log10(bilirubin_umol_l) * 0.66) + (albumin_g_l * -0.085)"},{"formula":"albi","citation":{"id":"johnson-2015","doi":"10.1200/JCO.2014.57.9151","pmid":"25512453","title":"Assessment of liver function in patients with hepatocellular carcinoma: a new evidence-based approach-the ALBI grade","source":"J Clin Oncol. 2015;33(6):550-558","authors":"Johnson PJ, Berhane S, Kagebayashi C, et al."},"albi_grade":1,"albi_score":-2.74,"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.","albumin_g_l":40,"bilirubin_umol_l":10,"formula_expression":"albi_score = (log10(bilirubin_umol_l) * 0.66) + (albumin_g_l * -0.085)"}]}},"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_u-e0v0On3cIenpN49K-lu","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 albumin-bilirubin (ALBI) score and grade (1–3) from serum total bilirubin and albumin using the Johnson 2015 formula.","exampleAgentPrompt":"Calculate the ALBI score and grade for a patient with albumin 38 g/L and total bilirubin 25 µmol/L using the Johnson 2015 formula.","exampleUseCases":[{"title":"HCC treatment eligibility screening","prompt":"My patient has albumin 32 g/L and total bilirubin 42 µmol/L — what is their ALBI score and grade for hepatocellular carcinoma assessment?"},{"title":"Converting US lab units to ALBI grade","prompt":"I have bilirubin 1.8 mg/dL and albumin 3.9 g/dL from an American lab report — can you calculate the ALBI grade for me?"},{"title":"Liver function reserve before locoregional therapy","prompt":"Before planning TACE for this patient, I need their ALBI grade — albumin is 28 g/L and bilirubin is 68 µmol/L."}],"resultDescription":"Returns a JSON object with `albi_score` (numeric, rounded to 4 decimal places) and `albi_grade` (integer 1, 2, or 3), where grade 1 indicates best preserved liver function (xb ≤ −2.60), grade 2 moderate impairment (xb ≤ −1.39), and grade 3 severe impairment.","failureModes":["Missing both albumin parameters returns an error","Missing both bilirubin parameters returns an error","Providing both albumin_g_l and albumin_g_dl simultaneously is rejected","Providing both bilirubin_umol_l and bilirubin_mg_dl simultaneously is rejected","Out-of-range values (e.g. albumin outside 10–60 g/L) may return validation errors","Payment failure (402) if x402 USDC payment header is missing or insufficient"],"whenToPreferThis":"Use this endpoint when you need the exact Johnson 2015 ALBI grade (1, 2, or 3) for hepatocellular carcinoma or liver disease assessment and have serum albumin and total bilirubin values available. Prefer this over Child-Pugh when a simpler, objective two-variable score is needed. Do not use for mALBI, PALBI, EZ-ALBI, Child-Pugh, or survival estimation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:53:03.454Z","isFirstParty":false}