For the complete documentation index, see llms.txt.

Heart Rate Zone Calculator API

health 1 credit / call v2026-04-22 visual chart data

Estimate heart-rate training zones using max-heart-rate or Karvonen formulas.

One POST adds Heart Rate Zone Calculator to your app, site, workflow, or agent — formula, validation, edge cases, and docs already handled.

prefer a UI? Open the Heart Rate Zone Calculator on miniwebtool.com →

Start free — get a key → 1,000 credits · no card · 30 seconds

Endpoint

POST · 1cr
POST https://api.miniwebtool.com/v1/tools/heart-rate-zone-calculator/run

Request body

Field Type Req.
age int
resting_heart_rate int
method
max_hr | karvonen
str
precision int

Cost & access

  • 1 credit per successful call — failed calls refund.
  • Starts on: Free.
  • Max payload: 65536 bytes.
  • Privacy mode: hash_only
  • Available on: free, starter, pro, business, scale

Response envelope

{
  "request_id": "01K...",
  "tool": "heart-rate-zone-calculator",
  "tool_version": "2026-04-22",
  "credits_used": 1,
  "result": { ... }
}

Try it

Stored only in this browser tab. Playground test key is prefilled and only works on this page. Get a live key →
max_hr | karvonen

Code examples

curl -X POST https://api.miniwebtool.com/v1/tools/heart-rate-zone-calculator/run \
  -H 'Authorization: Bearer mwt_live_YOUR_KEY' \
  -H 'Content-Type: application/json' \
  -d '{}'
import requests

resp = requests.post(
    'https://api.miniwebtool.com/v1/tools/heart-rate-zone-calculator/run',
    headers={'Authorization': 'Bearer mwt_live_YOUR_KEY'},
    json={},
)
resp.raise_for_status()
data = resp.json()
print(data)

result = data['result']
chart_data = result.get('chart_data', {})
balance_series = (
    chart_data.get('balance_over_time')
    or chart_data.get('minimum_payment_balance_over_time')
    or chart_data.get('series')
    or chart_data.get('points')
    or []
)
breakdown = (
    chart_data.get('payment_breakdown')
    or chart_data.get('monthly_payment_breakdown')
    or chart_data.get('total_cost_breakdown')
    or chart_data.get('breakdown')
    or chart_data.get('comparison')
    or []
)
strategy_series = chart_data.get('payment_strategy_comparison', [])
def chart_label(point):
    return point.get('label') or point.get('month') or point.get('year') or point.get('n') or point.get('x')
def chart_value(point):
    return point.get('value') or point.get('ending_balance') or point.get('y') or point.get('total_interest')
print('chart labels:', [chart_label(point) for point in balance_series])
print('chart values:', [chart_value(point) for point in balance_series])
print('breakdown:', breakdown)
print('strategy interest:', [(item['label'], item['total_interest']) for item in strategy_series])
const resp = await fetch(
  'https://api.miniwebtool.com/v1/tools/heart-rate-zone-calculator/run',
  {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer mwt_live_YOUR_KEY',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({}),
  }
);
const data = await resp.json();
console.log(data);

const result = data.result;
const chartData = result.chart_data ?? {};
const balanceSeries =
  chartData.balance_over_time ??
  chartData.minimum_payment_balance_over_time ??
  chartData.series ??
  chartData.points ??
  [];
const breakdown =
  chartData.payment_breakdown ??
  chartData.monthly_payment_breakdown ??
  chartData.total_cost_breakdown ??
  chartData.breakdown ??
  chartData.comparison ??
  [];

// Pass these arrays to Chart.js, Recharts, ECharts, etc.
const chartLabel = (item) =>
  item.label ?? item.month ?? item.year ?? item.n ?? item.x;
const chartValue = (item) =>
  item.value ?? item.ending_balance ?? item.y ?? item.total_interest;
const balanceChart = {
  labels: balanceSeries.map(chartLabel),
  values: balanceSeries.map(chartValue),
};
const breakdownChart = {
  labels: breakdown.map(chartLabel),
  values: breakdown.map(chartValue),
};
const strategySeries = chartData.payment_strategy_comparison ?? [];
const strategyChart = {
  labels: strategySeries.map((item) => item.label),
  values: strategySeries.map((item) => item.total_interest),
};
console.log({ balanceChart, breakdownChart, strategyChart });
<?php
$ch = curl_init('https://api.miniwebtool.com/v1/tools/heart-rate-zone-calculator/run');
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer mwt_live_YOUR_KEY',
        'Content-Type: application/json',
    ],
    CURLOPT_POSTFIELDS => json_encode([

]),
]);
$resp = curl_exec($ch);
curl_close($ch);
print_r(json_decode($resp, true));
require 'net/http'
require 'json'
require 'uri'

uri = URI('https://api.miniwebtool.com/v1/tools/heart-rate-zone-calculator/run')
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = (uri.scheme == 'https')

req = Net::HTTP::Post.new(uri)
req['Authorization'] = 'Bearer mwt_live_YOUR_KEY'
req['Content-Type'] = 'application/json'
req.body = {

}.to_json

resp = http.request(req)
puts JSON.parse(resp.body).inspect
package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "io"
  "net/http"
)

func main() {
  body, _ := json.Marshal(map[string]interface{}{
,
  })
  req, _ := http.NewRequest("POST", "https://api.miniwebtool.com/v1/tools/heart-rate-zone-calculator/run", bytes.NewReader(body))
  req.Header.Set("Authorization", "Bearer mwt_live_YOUR_KEY")
  req.Header.Set("Content-Type", "application/json")

  resp, err := http.DefaultClient.Do(req)
  if err != nil { panic(err) }
  defer resp.Body.Close()
  out, _ := io.ReadAll(resp.Body)
  fmt.Println(string(out))
}
import java.net.URI;
import java.net.http.*;

var client = HttpClient.newHttpClient();
var req = HttpRequest.newBuilder()
    .uri(URI.create("https://api.miniwebtool.com/v1/tools/heart-rate-zone-calculator/run"))
    .header("Authorization", "Bearer mwt_live_YOUR_KEY")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString("{}"))
    .build();

var resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
how-to call heart-rate-zone-calculator
  1. Get an API key
    Get an API key. Sign up free for a bearer token. 1,000 credits/month, no card.
  2. Assemble the JSON body
    Required fields: . See the Request body table above for the full schema.
  3. POST to https://api.miniwebtool.com/v1/tools/heart-rate-zone-calculator/run
    Headers: Authorization: Bearer <key> and Content-Type: application/json. Copy-paste snippets in 7 languages are under Code examples.
  4. Parse the response
    Envelope: {request_id, tool, tool_version, credits_used, result}. The typed output lives in result.
faq frequently asked
What does the Heart Rate Zone Calculator API do?+

Estimate heart-rate training zones using max-heart-rate or Karvonen formulas. Use it to add this utility without rebuilding formulas, validation, examples, and documentation.

How much does one call to Heart Rate Zone Calculator cost?+

1 credit per successful call. Failed calls (validation errors, 5xx) don't bill.

What parameters does the Heart Rate Zone Calculator API require?+

Required fields: (none). Full schema at /v1/openapi.json.

Is the Heart Rate Zone Calculator API deterministic?+

Yes — same input, same output, forever. Tool version 2026-04-22; output shape is stable within a major version.

Does the Heart Rate Zone Calculator API include visual chart data?+

Yes. Successful responses include `result.chart_data` with compact arrays for line or bar charts, so clients can render visuals with Chart.js, Recharts, ECharts, SVG, or canvas without requesting an image.

Can an AI agent call the Heart Rate Zone Calculator API?+

Yes. Connect to https://api.miniwebtool.com/v1/mcp over the Model Context Protocol. The agent discovers `heart-rate-zone-calculator` with its JSON Schema automatically, so the model can plan while MiniWebtool handles the exact tool result.

What format does the API return?+

JSON with a stable envelope: `{request_id, tool, tool_version, credits_used, result}`. Errors are RFC 7807 `application/problem+json`.

mcp use from an AI agent

Every endpoint on this site is also exposed via the Model Context Protocol at https://api.miniwebtool.com/v1/mcp. Claude, Cursor, and any MCP-capable agent can discover this tool (heart-rate-zone-calculator) and its JSON Schema automatically — no client codegen.

# List tools the agent can call
curl -s https://api.miniwebtool.com/v1/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' \
 | jq '.result.tools[] | select(.name=="heart-rate-zone-calculator")'
see-also related health tools