{
 "name": "Tonelva open data",
 "description": "The two blood pressure classification tables as machine-readable data, the free browser calculators that run on them, the reference corpus, and what the app does. Keyless, CORS-open, CC BY 4.0 with attribution.",
 "version": "v1",
 "documentation": "https://tonelva.com/api/",
 "openapi": "https://tonelva.com/api/v1/openapi.json",
 "publisher": {
  "name": "Tonelva",
  "legal_name": "Vast Flow, LLP",
  "url": "https://tonelva.com/",
  "documentation": "https://tonelva.com/api/",
  "contact": "support@tonelva.com",
  "about": "https://tonelva.com/about/",
  "note": "Tonelva publishes reference material and free calculators, and builds a blood pressure diary app. It is not a clinical body and sets no thresholds of its own: every category here is quoted from a published guideline and cited to the society that issued it."
 },
 "licence": {
  "id": "CC-BY-4.0",
  "name": "Creative Commons Attribution 4.0 International",
  "url": "https://creativecommons.org/licenses/by/4.0/",
  "attribution": "Tonelva (https://tonelva.com)",
  "covers": "The compilation: the machine-readable encoding of the two classification tables, the derived formulas, the tool catalogue and every field of this API. Use it commercially, modify it, redistribute it; credit Tonelva with a link.",
  "does_not_cover": "The guidelines themselves. The thresholds are quoted from the documents cited on each table; the societies that published them hold their own rights in those documents."
 },
 "upstream_sources": [
  {
   "id": "aha-2017",
   "name": "2017 ACC/AHA Guideline for the Prevention, Detection, Evaluation, and Management of High Blood Pressure in Adults",
   "publisher": "American College of Cardiology / American Heart Association",
   "doi": "10.1161/HYP.0000000000000065",
   "url": "https://doi.org/10.1161/HYP.0000000000000065",
   "asOf": "2017-11-13"
  },
  {
   "id": "esc-esh-2018",
   "name": "2018 ESC/ESH Guidelines for the management of arterial hypertension",
   "publisher": "European Society of Cardiology / European Society of Hypertension",
   "doi": "10.1093/eurheartj/ehy339",
   "url": "https://doi.org/10.1093/eurheartj/ehy339",
   "citation": "European Heart Journal 39(33), 3021–3104, 25 August 2018.",
   "asOf": "2018-08-25",
   "superseded_in_part_by": "2024 ESC Guidelines for the management of elevated blood pressure and hypertension"
  },
  {
   "id": "home-monitoring-protocol",
   "name": "Home blood pressure monitoring protocol: seven consecutive mornings and evenings, duplicate readings, first day discarded",
   "publisher": "Common to the ACC/AHA, ESC/ESH and ESH home-monitoring guidance",
   "url": "https://tonelva.com/vitals/home-blood-pressure-monitoring/",
   "asOf": "2018-08-25"
  }
 ],
 "scope_limits": {
  "no_diagnosis": "A category is a label for one measurement, not a diagnosis. Hypertension is diagnosed from repeated readings, usually taken away from a clinic, interpreted by a doctor.",
  "no_treatment": "Nothing here recommends, starts, stops or adjusts medication, and no target figure here is a personal target. Targets are set by the clinician managing that person's care.",
  "no_measurement": "Tonelva records readings from a cuff. Neither the app nor a phone measures blood pressure, and any product claiming to do so from a camera or a fingertip is not measuring it either.",
  "emergency": "A reading above 180 systolic or 120 diastolic together with chest pain, breathlessness, weakness, vision change or confusion is emergency care, not a diary entry.",
  "two_frameworks": "Every classification returns BOTH the 2017 ACC/AHA and the 2018 ESC/ESH category. Reporting one without the other is how a reader ends up with two reputable sources that contradict each other and no way to reconcile them."
 },
 "not_published": [
  {
   "what": "The competitor app snapshot behind /compare/ — ratings, prices, release dates and store descriptions.",
   "why": "That metadata comes from the Apple App Store and is Apple's to license, not ours, and the descriptions are each publisher's own marketing. Republishing either keyless and CC BY would relicense content we do not own and distribute our competitors' copy at our cost.",
   "instead": "https://tonelva.com/compare/"
  },
  {
   "what": "Any blood pressure reading entered by anyone, in the app or in a calculator on this site.",
   "why": "There is nothing to publish. The calculators run entirely in the browser and transmit nothing; the app keeps its diary on the device. No reading reaches a server that could publish it, and publishing one is not something a user agreed to.",
   "instead": "https://tonelva.com/privacy/"
  },
  {
   "what": "Population statistics on blood pressure — prevalence, distribution by age, outcome rates.",
   "why": "Tonelva measures nothing and holds no cohort. Quoting such figures from a dataset we did not build would put our name on numbers we cannot stand behind.",
   "instead": "https://www.who.int/data/gho"
  }
 ],
 "authentication": "none",
 "rate_limit": "none",
 "cors": "*",
 "datasets": [
  {
   "id": "reference-tables",
   "url": "https://tonelva.com/api/v1/reference-tables.json",
   "title": "Blood pressure classification tables",
   "rows": 13,
   "about": "The 2017 ACC/AHA and 2018 ESC/ESH bands, the MAP and pulse-pressure formulas, and the seven-day averaging protocol. The thing to cite."
  },
  {
   "id": "tools",
   "url": "https://tonelva.com/api/v1/tools.json",
   "title": "Free browser calculators",
   "rows": 5,
   "about": "What each tool takes and returns, and which of them the MCP server can run."
  },
  {
   "id": "guides",
   "url": "https://tonelva.com/api/v1/guides.json",
   "title": "Reference articles",
   "rows": 20,
   "about": "The corpus with the question each article answers and its markdown twin."
  },
  {
   "id": "tonelva",
   "url": "https://tonelva.com/api/v1/tonelva.json",
   "title": "What Tonelva does",
   "rows": null,
   "about": "The app and the free tools, with a not_included block the same length as the capability list."
  },
  {
   "id": "status",
   "url": "https://tonelva.com/api/v1/status.json",
   "title": "Build status and row counts",
   "rows": 1,
   "about": "When each dataset was last rebuilt, and the date of each guideline it encodes."
  }
 ],
 "other_surfaces": {
  "markdown_twins": "Append index.md to any page URL, or send Accept: text/markdown.",
  "llms_txt": "https://tonelva.com/llms.txt",
  "llms_full_txt": "https://tonelva.com/llms-full.txt",
  "mcp": "https://tonelva.com/mcp",
  "a2a": "https://tonelva.com/a2a",
  "engine": "https://tonelva.com/js/engine.js",
  "engine_note": "The one ES module the browser calculators, these endpoints and the MCP tools all compute with."
 }
}