{"uid":"cap_YbYBq4xr5genuYWFqo9CL","slug":"carrier-dimensional-dim-weight-carton-rightsizing-calculator-8d66700f","name":"Carrier Dimensional (DIM) Weight & Carton Rightsizing Calculator","description":"Deterministic parcel dimensional weight vs actual billable weight calculator. Pass ?length_in=14&width_in=10&height_in=6&actual_lb=3.2&divisor=139. Compares UPS/FedEx (139 divisor) and USPS Ground Advantage (166 divisor >1 cu ft), cubic size, length+girth oversize risk, and billable weight saved by trimming carton height by 1 inch.","url":"https://x402-niche-briefs.fly.dev/v1/dimensional-weight-calc?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["length_in","width_in","height_in","actual_lb"],"properties":{"divisor":{"type":"string","description":"Carrier DIM divisor (default 139 for UPS/FedEx, 166 for USPS)"},"width_in":{"type":"string","description":"Carton width in inches"},"actual_lb":{"type":"string","description":"Actual scale weight in pounds"},"height_in":{"type":"string","description":"Carton height in inches"},"length_in":{"type":"string","description":"Carton length in inches"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["as_of","inputs","geometry","weight_comparison","rightsizing_opportunity"],"properties":{"as_of":{"type":"string"},"inputs":{"type":"object","required":["length_in","width_in","height_in","actual_lb","divisor"],"properties":{"divisor":{"type":"number"},"width_in":{"type":"number"},"actual_lb":{"type":"number"},"height_in":{"type":"number"},"length_in":{"type":"number"}}},"geometry":{"type":"object","required":["cubic_inches","cubic_feet","length_plus_girth_in","exceeds_one_cubic_foot","oversize_surcharge_risk"],"properties":{"cubic_feet":{"type":"number"},"cubic_inches":{"type":"number"},"length_plus_girth_in":{"type":"number"},"exceeds_one_cubic_foot":{"type":"boolean"},"oversize_surcharge_risk":{"type":"boolean"}}},"weight_comparison":{"type":"object","required":["actual_weight_lb","actual_rounded_lb","dim_weight_exact_lb","dim_weight_rounded_lb","billable_weight_lb","billed_by","usps_ground_advantage_billable_lb"],"properties":{"billed_by":{"type":"string"},"actual_weight_lb":{"type":"number"},"actual_rounded_lb":{"type":"number"},"billable_weight_lb":{"type":"number"},"dim_weight_exact_lb":{"type":"number"},"dim_weight_rounded_lb":{"type":"number"},"usps_ground_advantage_billable_lb":{"type":"number"}}},"rightsizing_opportunity":{"type":"object","required":["one_inch_height_reduction_billable_lb","billable_lb_saved_by_trimming_1_inch_height","recommendation"],"properties":{"recommendation":{"type":"string"},"one_inch_height_reduction_billable_lb":{"type":"number"},"billable_lb_saved_by_trimming_1_inch_height":{"type":"number"}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hFscCsv9cKsCTRhxXrJfn","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates dimensional weight vs actual billable weight for UPS/FedEx and USPS Ground Advantage, and identifies carton rightsizing savings opportunities.","exampleAgentPrompt":"What's the billable weight for a 14x10x6 inch carton that actually weighs 3.2 lbs — show me whether UPS/FedEx (divisor 139) or USPS Ground Advantage would bill by DIM or actual weight, and tell me how much I'd save by trimming the carton height by 1 inch.","exampleUseCases":[{"title":"Carrier selection for heavy small box","prompt":"I have a box that's 12 inches long, 8 inches wide, 5 inches tall, and actually weighs 4.5 lbs — can you calculate the DIM weight and tell me whether UPS/FedEx or USPS Ground Advantage would give me a lower billable weight?"},{"title":"Oversize surcharge risk check","prompt":"My carton is 18 x 14 x 12 inches and weighs 6 lbs — does it risk an oversize surcharge, and what's the DIM weight using the standard 139 divisor?"},{"title":"Carton rightsizing to cut shipping costs","prompt":"We ship a box that's 16x12x8 inches at 2.8 lbs actual weight — how much billable weight would we save by trimming the height by 1 inch, and does it change whether we're billed by DIM or actual weight on UPS?"}],"resultDescription":"Returns a JSON object with: input echo, geometry data (cubic inches, cubic feet, length+girth, oversize risk flag), weight comparison (actual weight, DIM weight, billable weight, which weight is billed, USPS Ground Advantage billable weight), and a rightsizing opportunity showing how much billable weight is saved by reducing carton height by 1 inch.","failureModes":["Missing required query parameters (length_in, width_in, height_in, actual_lb) returns an error","Non-numeric string values for dimension or weight fields cause parse errors","Very large carton dimensions may flag oversize risk but do not block computation","Custom divisor values outside normal carrier ranges (139, 166) are accepted but may produce unexpected comparisons"],"whenToPreferThis":"Use this endpoint when you need a fast, deterministic, carrier-agnostic DIM weight calculation without calling a carrier API or building the math yourself. Ideal for e-commerce agents optimizing packaging decisions, comparing UPS/FedEx vs USPS Ground Advantage costs, or flagging oversize surcharge risk before shipment. Prefer this over carrier APIs when you don't need a live rate quote but need quick billable weight math and rightsizing guidance.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T19:07:05.145Z","isFirstParty":false,"canonicalSlug":"carrier-dimensional-dim-weight-carton-rightsizing-calculator-8d66700f"}