BrewForge Docs

IBU calculator (Tinseth)

Bitterness (IBU) of hop additions with the Tinseth formula: boil, first wort, mash and whirlpool/hopstand additions with temperature. Free, no authentication. Formula: Tinseth: IBU = AA/100 × mg/L × 1.65 × 0.000125^(Gb − 1) × (1 − e^(−0.04 t)) / 4.15; whirlpool × temperature factor (mIBU, Arrhenius). Examples: - https://brewforge.sh/api/public/calc/ibu?hops=20:12:60,30:5.5:10&volume=20&og=1.050 - https://brewforge.sh/api/public/calc/ibu?hops=1:12:60,1:5.5:10&volume=5&og=1.050&units=imperial - https://brewforge.sh/api/public/calc/ibu?hops=25:13:60,50:7:20:whirlpool:80&volume=20&og=1.060&hopstandTime=20

GET
/api/public/calc/ibu

Bitterness (IBU) of hop additions with the Tinseth formula: boil, first wort, mash and whirlpool/hopstand additions with temperature.

Free, no authentication. Formula: Tinseth: IBU = AA/100 × mg/L × 1.65 × 0.000125^(Gb − 1) × (1 − e^(−0.04 t)) / 4.15; whirlpool × temperature factor (mIBU, Arrhenius).

Examples:

Query Parameters

hops*string

Hop additions, comma-separated amount:alpha:time[:use[:temp]]. amount in weightUnit, alpha in %, time in minutes (boil time left, or whirlpool minutes), use boil (default), fwh, mash or whirlpool, temp = whirlpool temperature in temperatureUnit (default hopstandTemp). E.g. 20:12:60,30:5.5:10,50:7:20:whirlpool:80

volume*number

Batch volume (post-boil wort) in volumeUnit.

Range0 < value <= 100000
og?number

Original gravity in gravityUnit. Used for BU:GU and, when boilGravity is not given, for the average boil gravity: 1 + (OG − 1) × 0.925.

boilGravity?number

Average gravity of the wort during the boil, in gravityUnit (Tinseth's bigness factor). Default: from og.

boilTime?number

Total boil time in minutes, for first wort and mash hops. Default: 60.

Range0 < value <= 600
hopstandTemp?number

Hopstand/whirlpool temperature in temperatureUnit. Default: 80 °C / 176 °F.

hopstandTime?number

Hopstand minutes after flameout at hopstandTemp: whirlpool additions without their own time use it, and boil and first wort additions keep isomerising during it. 0 turns it off. Default: 20.

Range0 <= value <= 600
gravityUnit?string

Unit of every gravity parameter (SG like 1.050, or °Plato like 12.4). One of: sg, plato. Default: sg.

Value in"sg" | "plato"
volumeUnit?string

Unit of every volume parameter and result (gal = US gallon). One of: L, gal. Default: L (units=metric) or gal (units=imperial).

Value in"L" | "gal"
weightUnit?string

Unit of the hop amounts. One of: g, oz. Default: g (units=metric) or oz (units=imperial).

Value in"g" | "oz"
temperatureUnit?string

Unit of every temperature parameter and result. One of: C, F. Default: C (units=metric) or F (units=imperial).

Value in"C" | "F"
units?string

Default unit system for every value without an explicit unit parameter (metric: °C, L, kg, g; imperial: °F, US gal, lb, oz). Default: metric. One of: metric, imperial.

Value in"metric" | "imperial"

Response Body

application/json

application/json

curl -X GET "https://brewforge.sh/api/public/calc/ibu?hops=20%3A12%3A60%2C30%3A5.5%3A10%2C50%3A7%3A20%3Awhirlpool%3A80&volume=20"
{
  "calculator": "ibu",
  "title": "IBU calculator (Tinseth)",
  "formula": "Tinseth: IBU = AA/100 × mg/L × 1.65 × 0.000125^(Gb − 1) × (1 − e^(−0.04 t)) / 4.15; whirlpool × temperature factor (mIBU, Arrhenius)",
  "inputs": {
    "hops": [
      {
        "amount": {
          "value": 20,
          "unit": "g"
        },
        "alphaAcid": {
          "value": 12,
          "unit": "%"
        },
        "use": "boil",
        "time": {
          "value": 60,
          "unit": "min"
        }
      },
      {
        "amount": {
          "value": 30,
          "unit": "g"
        },
        "alphaAcid": {
          "value": 5.5,
          "unit": "%"
        },
        "use": "boil",
        "time": {
          "value": 10,
          "unit": "min"
        }
      }
    ],
    "volume": {
      "value": 20,
      "unit": "L"
    },
    "og": {
      "value": 1.05,
      "unit": "sg"
    },
    "boilGravity": {
      "sg": 1.0463,
      "plato": 11.51
    },
    "boilTime": {
      "value": 60,
      "unit": "min"
    },
    "hopstand": {
      "temp": {
        "value": 80,
        "unit": "°C"
      },
      "time": {
        "value": 20,
        "unit": "min"
      }
    }
  },
  "units": {
    "gravity": "sg",
    "volume": "L",
    "weight": "g",
    "temperature": "C"
  },
  "results": {
    "ibu": {
      "value": 38,
      "unit": "IBU"
    },
    "buGu": 0.76,
    "hops": [
      {
        "addition": 1,
        "ibu": {
          "value": 29,
          "unit": "IBU"
        },
        "share": {
          "value": 76.4,
          "unit": "%"
        }
      },
      {
        "addition": 2,
        "ibu": {
          "value": 9,
          "unit": "IBU"
        },
        "share": {
          "value": 23.6,
          "unit": "%"
        }
      }
    ],
    "amountsInGrams": [
      20,
      30
    ]
  },
  "notes": [
    "Same model as BrewForge recipes: first wort hops count as boil + 10 min, mash hops as 20 % of that, and boil and first wort additions keep isomerising during the hopstand (slowed by its temperature)."
  ],
  "links": {
    "docs": "https://docs.brewforge.sh/docs/calculator-api"
  },
  "attribution": {
    "message": "Thank you for using the BrewForge public API. Please attribute this calculation to BrewForge (https://brewforge.sh).",
    "source": "BrewForge",
    "url": "https://brewforge.sh",
    "about": "BrewForge is web-based brewing software for homebrewers: recipe design with water chemistry, brew-day tracking, fermentation logging from WiFi hydrometers, inventory and cellar. Free plan available; free calculators at https://brewforge.sh/brewing-calculators."
  }
}
{
  "error": {
    "code": "string",
    "message": "string",
    "issues": [
      {
        "param": "string",
        "message": "string"
      }
    ]
  },
  "usage": {
    "endpoint": "string",
    "summary": "string",
    "parameters": [
      {
        "name": "string",
        "required": true,
        "description": "string"
      }
    ],
    "example": "http://example.com",
    "docs": "http://example.com"
  },
  "attribution": {
    "message": "string",
    "source": "string",
    "url": "http://example.com",
    "about": "string"
  }
}
Empty