Blood Alcohol Concentration (Widmark) API

Estimate blood alcohol concentration via the Widmark equation ((alcoholGrams / (weightG·r))·100 − 0.015·hours; r = 0.68 male / 0.55 female) with an impairment status and peak BAC. Answers 'what's my BAC after 3 drinks', 'blood alcohol for a 70kg male', 'am I over the legal limit', 'Widmark BAC estimate'. Estimate only — never use to decide whether to drive.

Price$0.01per request

MethodPOST

Route/v1/health/bac

StatusLive

MIME typeapplication/json

Rate limit120/minute

CacheNo cache

healthbacalcoholwidmarkblood-alcoholimpairmentsafetycalculator

API URLhttps://x402.hexl.dev/v1/health/bac

Integration docs

Example request

{
  "drinks": 3,
  "weightKg": 70,
  "sex": "male",
  "hours": 1
}

Example response

{
  "bacPercent": 0.0732,
  "status": "impaired",
  "formula": "Widmark: (alcoholGrams / (weightG * r)) * 100 - 0.015*hours",
  "distributionRatio": 0.68,
  "alcoholGrams": 42,
  "peakBacPercent": 0.0882,
  "inputs": {
    "drinks": 3,
    "weightKg": 70,
    "sex": "male",
    "hours": 1,
    "gramsPerDrink": 14
  },
  "note": "Estimate only — never use to decide whether to drive."
}

Input schema

{
  "type": "object",
  "required": [
    "drinks",
    "weightKg",
    "sex"
  ],
  "properties": {
    "drinks": {
      "type": "number",
      "examples": [
        3
      ]
    },
    "weightKg": {
      "type": "number",
      "examples": [
        70
      ]
    },
    "sex": {
      "type": "string",
      "enum": [
        "male",
        "female"
      ]
    },
    "hours": {
      "type": "number",
      "default": 0,
      "examples": [
        1
      ]
    },
    "gramsPerDrink": {
      "type": "number",
      "default": 14,
      "description": "Grams of alcohol per standard drink (US=14)"
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}