{"uid":"cap_WIEzz_7HVKO3X5yS-FEId","slug":"urine-protein-creatinine-ratio-calculator-ginsberg-1983-637c4f22","name":"Urine Protein/Creatinine Ratio Calculator (Ginsberg 1983)","description":"Urine protein/creatinine ratio (mg/mg) from spot urine protein and creatinine (Ginsberg 1983). Also returns estimated_g_day equal to the rounded ratio as a numeric estimate of 24-h protein. Bands: <0.2 within normal limits, >3.5 nephrotic-range. Not ACR. Not a 24-h collection. Deterministic published formula with citation; not a diagnosis.","url":"https://api.magentlab.com/api/calc/urine_pcr","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":["urine_protein_mg_dl"],"properties":{"urine_protein_mg_dl":{"type":"number","description":"Urine total protein in mg/dL (0.1-2000). Total protein, not albumin."},"urine_creatinine_mg_dl":{"type":"number","description":"Urine creatinine in mg/dL (1-500). Provide this or urine_creatinine_umol_l."},"urine_creatinine_umol_l":{"type":"number","description":"Urine creatinine in µmol/L (88-44210). Converted as mg/dL = µmol/L / 88.42."}}}},"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_YiqvxYNmBntkjhc3XN4kn","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":"Calculates the urine protein-to-creatinine ratio (PCR) in mg/mg from a spot urine sample, with clinical band interpretation and estimated 24-hour protein excretion.","exampleAgentPrompt":"My patient has a spot urine protein of 320 mg/dL and urine creatinine of 85 mg/dL — can you calculate their urine protein-to-creatinine ratio using the Ginsberg 1983 formula and tell me if it's in the nephrotic range?","exampleUseCases":[{"title":"Nephrotic range proteinuria screening","prompt":"I have a patient with a spot urine protein of 450 mg/dL and urine creatinine of 120 mg/dL — calculate their urine PCR and tell me whether they're in the nephrotic range (above 3.5)."},{"title":"Routine proteinuria monitoring in CKD","prompt":"My CKD patient's spot urine shows protein at 55 mg/dL and creatinine at 210 mg/dL. Can you compute the protein-to-creatinine ratio and let me know if it's within normal limits?"},{"title":"Estimating 24-hour protein from spot urine","prompt":"Rather than doing a full 24-hour urine collection, can you estimate my patient's daily protein excretion from a spot urine protein of 180 mg/dL and creatinine of 95 mg/dL using the Ginsberg formula?"}],"resultDescription":"Returns the urine protein-to-creatinine ratio (PCR) in mg/mg, the estimated 24-hour protein excretion in g/day (rounded ratio), and a clinical band label indicating whether the result is within normal limits (<0.2), elevated, or in the nephrotic range (>3.5), along with the Ginsberg 1983 citation.","failureModes":["Missing required urine_protein_mg_dl parameter returns an error","Out-of-range urine_protein_mg_dl (outside 0.1–2000 mg/dL) may be rejected or flagged","Out-of-range urine_creatinine_mg_dl (outside 1–500 mg/dL) may be rejected","Neither creatinine parameter provided causes calculation failure","Non-numeric inputs for concentration fields return validation errors","Payment not included or insufficient (x402) results in 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need a quick, evidence-based estimate of proteinuria severity from a spot urine sample without requiring a 24-hour collection. It is ideal for nephrotic range screening, CKD monitoring, and proteinuria triage. Choose this over ACR (albumin-to-creatinine ratio) endpoints when total protein (not albumin) measurements are available, and when you specifically need the Ginsberg 1983 PCR formula.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:46:14.458Z","isFirstParty":false}