Loans · Calculation
Fixed payment
Estimate monthly principal and interest on a fixed-rate loan.
This HT Calc screen includes a Pro sample for visitors.
Catalog example · Example result · monthlyPayment: 8.3333333333 USD/month See output
$2,400 over 24 months at 0% · Example result · monthlyPayment: 100 USD/month See output
- Cost per success
- 1 calculation credit
- Production plans
- Standard, Business, Scale, Enterprise
Plan allowances - Free sandbox
- Available · see example
Integration example
Make a request
Use a free sandbox key scoped to fixed-payment. New developer? Create a workspace and register an application to issue your key.
Keep the key on your server. A successful call uses 1 calculation credit from the selected environment.
Choose the $2,400 example to check your integration. At 0% interest, $2,400 divided by 24 months gives $100 per month in principal and interest. Enter annual rates as percentage points, such as 6.5 for 6.5%.
Set HT_SANDBOX_KEY on your server. Save as example.mjs and run node example.mjs with Node.js 18 or later.
import { randomUUID } from "node:crypto";
const key = process.env.HT_SANDBOX_KEY;
if (!key) throw new Error("Set HT_SANDBOX_KEY on your server.");
const endpoint = "https://sandbox.hasstechapi.com/v2/calc/fixed-payment";
const input = {
"principal": 100,
"annualRate": 0,
"months": 12
};
const requestId = process.env.HT_REQUEST_ID || Date.now() + "." + randomUUID();
// Keep this ID to look up usage if the connection is interrupted.
console.error("Usage lookup ID:", requestId);
const response = await fetch(endpoint, {
method: "POST",
redirect: "error",
headers: {
"Authorization": "Bearer " + key,
"Content-Type": "application/json",
"Idempotency-Key": requestId
},
body: JSON.stringify(input)
});
if (!response.ok) {
const problem = await response.json().catch(() => null);
const code = problem?.error?.code || response.statusText;
const delay = response.headers.get("retry-after");
if (delay) console.error("Retry-After (seconds):", delay);
console.error("HTTP " + response.status + " " + code + ". Usage lookup ID: " + requestId);
if (Array.isArray(problem?.error?.details)) {
for (const issue of problem.error.details) console.error("Input issue:", JSON.stringify(issue));
}
process.exitCode = 1;
} else {
console.log(JSON.stringify(await response.json(), null, 2));
} cURL (shell)
(
set -eu
: "${HT_SANDBOX_KEY:?Set HT_SANDBOX_KEY on your server}"
request_id="${HT_REQUEST_ID:-}"
if [ -z "$request_id" ]; then
request_id=$(python3 -c 'import time, uuid; print(str(time.time_ns() // 1000000) + "." + str(uuid.uuid4()))')
fi
printf 'Usage lookup ID: %s\n' "$request_id" >&2
# On INVALID_INPUT, read error.details in the JSON response body.
curl --disable --silent --show-error --fail-with-body --include \
--request POST 'https://sandbox.hasstechapi.com/v2/calc/fixed-payment' \
--header "Authorization: Bearer $HT_SANDBOX_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $request_id" \
--data-binary @- <<'HT_INPUT'
{
"principal": 100,
"annualRate": 0,
"months": 12
}
HT_INPUT
) Production request
Set HT_PRODUCTION_KEY on your server. Save as example.mjs and run node example.mjs with Node.js 18 or later.
import { randomUUID } from "node:crypto";
const key = process.env.HT_PRODUCTION_KEY;
if (!key) throw new Error("Set HT_PRODUCTION_KEY on your server.");
const endpoint = "https://calc.hasstechapi.com/v2/calc/fixed-payment";
const input = {
"principal": 100,
"annualRate": 0,
"months": 12
};
const requestId = process.env.HT_REQUEST_ID || Date.now() + "." + randomUUID();
// Keep this ID to look up usage if the connection is interrupted.
console.error("Usage lookup ID:", requestId);
const response = await fetch(endpoint, {
method: "POST",
redirect: "error",
headers: {
"Authorization": "Bearer " + key,
"Content-Type": "application/json",
"Idempotency-Key": requestId
},
body: JSON.stringify(input)
});
if (!response.ok) {
const problem = await response.json().catch(() => null);
const code = problem?.error?.code || response.statusText;
const delay = response.headers.get("retry-after");
if (delay) console.error("Retry-After (seconds):", delay);
console.error("HTTP " + response.status + " " + code + ". Usage lookup ID: " + requestId);
if (Array.isArray(problem?.error?.details)) {
for (const issue of problem.error.details) console.error("Input issue:", JSON.stringify(issue));
}
process.exitCode = 1;
} else {
console.log(JSON.stringify(await response.json(), null, 2));
} cURL (shell)
(
set -eu
: "${HT_PRODUCTION_KEY:?Set HT_PRODUCTION_KEY on your server}"
request_id="${HT_REQUEST_ID:-}"
if [ -z "$request_id" ]; then
request_id=$(python3 -c 'import time, uuid; print(str(time.time_ns() // 1000000) + "." + str(uuid.uuid4()))')
fi
printf 'Usage lookup ID: %s\n' "$request_id" >&2
# On INVALID_INPUT, read error.details in the JSON response body.
curl --disable --silent --show-error --fail-with-body --include \
--request POST 'https://calc.hasstechapi.com/v2/calc/fixed-payment' \
--header "Authorization: Bearer $HT_PRODUCTION_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $request_id" \
--data-binary @- <<'HT_INPUT'
{
"principal": 100,
"annualRate": 0,
"months": 12
}
HT_INPUT
) Set HT_SANDBOX_KEY on your server. Save as example.mjs and run node example.mjs with Node.js 18 or later.
import { randomUUID } from "node:crypto";
const key = process.env.HT_SANDBOX_KEY;
if (!key) throw new Error("Set HT_SANDBOX_KEY on your server.");
const endpoint = "https://sandbox.hasstechapi.com/v2/calc/fixed-payment";
const input = {
"principal": 2400,
"annualRate": 0,
"months": 24
};
const requestId = process.env.HT_REQUEST_ID || Date.now() + "." + randomUUID();
// Keep this ID to look up usage if the connection is interrupted.
console.error("Usage lookup ID:", requestId);
const response = await fetch(endpoint, {
method: "POST",
redirect: "error",
headers: {
"Authorization": "Bearer " + key,
"Content-Type": "application/json",
"Idempotency-Key": requestId
},
body: JSON.stringify(input)
});
if (!response.ok) {
const problem = await response.json().catch(() => null);
const code = problem?.error?.code || response.statusText;
const delay = response.headers.get("retry-after");
if (delay) console.error("Retry-After (seconds):", delay);
console.error("HTTP " + response.status + " " + code + ". Usage lookup ID: " + requestId);
if (Array.isArray(problem?.error?.details)) {
for (const issue of problem.error.details) console.error("Input issue:", JSON.stringify(issue));
}
process.exitCode = 1;
} else {
console.log(JSON.stringify(await response.json(), null, 2));
} cURL (shell)
(
set -eu
: "${HT_SANDBOX_KEY:?Set HT_SANDBOX_KEY on your server}"
request_id="${HT_REQUEST_ID:-}"
if [ -z "$request_id" ]; then
request_id=$(python3 -c 'import time, uuid; print(str(time.time_ns() // 1000000) + "." + str(uuid.uuid4()))')
fi
printf 'Usage lookup ID: %s\n' "$request_id" >&2
# On INVALID_INPUT, read error.details in the JSON response body.
curl --disable --silent --show-error --fail-with-body --include \
--request POST 'https://sandbox.hasstechapi.com/v2/calc/fixed-payment' \
--header "Authorization: Bearer $HT_SANDBOX_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $request_id" \
--data-binary @- <<'HT_INPUT'
{
"principal": 2400,
"annualRate": 0,
"months": 24
}
HT_INPUT
) Production request
Set HT_PRODUCTION_KEY on your server. Save as example.mjs and run node example.mjs with Node.js 18 or later.
import { randomUUID } from "node:crypto";
const key = process.env.HT_PRODUCTION_KEY;
if (!key) throw new Error("Set HT_PRODUCTION_KEY on your server.");
const endpoint = "https://calc.hasstechapi.com/v2/calc/fixed-payment";
const input = {
"principal": 2400,
"annualRate": 0,
"months": 24
};
const requestId = process.env.HT_REQUEST_ID || Date.now() + "." + randomUUID();
// Keep this ID to look up usage if the connection is interrupted.
console.error("Usage lookup ID:", requestId);
const response = await fetch(endpoint, {
method: "POST",
redirect: "error",
headers: {
"Authorization": "Bearer " + key,
"Content-Type": "application/json",
"Idempotency-Key": requestId
},
body: JSON.stringify(input)
});
if (!response.ok) {
const problem = await response.json().catch(() => null);
const code = problem?.error?.code || response.statusText;
const delay = response.headers.get("retry-after");
if (delay) console.error("Retry-After (seconds):", delay);
console.error("HTTP " + response.status + " " + code + ". Usage lookup ID: " + requestId);
if (Array.isArray(problem?.error?.details)) {
for (const issue of problem.error.details) console.error("Input issue:", JSON.stringify(issue));
}
process.exitCode = 1;
} else {
console.log(JSON.stringify(await response.json(), null, 2));
} cURL (shell)
(
set -eu
: "${HT_PRODUCTION_KEY:?Set HT_PRODUCTION_KEY on your server}"
request_id="${HT_REQUEST_ID:-}"
if [ -z "$request_id" ]; then
request_id=$(python3 -c 'import time, uuid; print(str(time.time_ns() // 1000000) + "." + str(uuid.uuid4()))')
fi
printf 'Usage lookup ID: %s\n' "$request_id" >&2
# On INVALID_INPUT, read error.details in the JSON response body.
curl --disable --silent --show-error --fail-with-body --include \
--request POST 'https://calc.hasstechapi.com/v2/calc/fixed-payment' \
--header "Authorization: Bearer $HT_PRODUCTION_KEY" \
--header 'Content-Type: application/json' \
--header "Idempotency-Key: $request_id" \
--data-binary @- <<'HT_INPUT'
{
"principal": 2400,
"annualRate": 0,
"months": 24
}
HT_INPUT
) If your request fails
400 INVALID_INPUT-
Read
error.detailswhen present. Node prints each issue. cURL returns the JSON body. Eachpathpoints into your request. An empty path refers to the whole body.In the 24-month example,
"annualRate": "0"returnsinvalid_typeat["annualRate"]withexpected: "number". Use the JSON number"annualRate": 0. With"principal": 2400, the corrected result is $100 per month.A negative principal such as
-1also returnscharged: 0. Check the accepted inputs for required fields, units and ranges. Send the corrected JSON as a new request. 401or403- Check that the server has the bearer key for the endpoint’s environment and that the key includes
fixed-payment. 429- Read the service error code, check your allowance, and wait for the
Retry-Afterinterval when supplied before trying again. - Lost response,
409or503 - Open Request lookup, select the same environment and enter the printed usage lookup ID. A settled ID has already consumed credits. To retry the same calculation, set
HT_REQUEST_IDto the original ID and reuse the same inputs. A settled request does not return its result again. Unset the variable for a new request, which can consume credits.
The usage lookup ID is the Idempotency-Key your server sends. The response’s x-request-id identifies the HTTP exchange for support.
Output
Example result
These values come from running this operation on the example inputs.
Catalog example
monthlyPayment- 8.3333333333 USD/month
How to interpret this result
- Monthly nominal annual interest / 12; principal and interest only; no taxes or fees.
- Payment carries ten decimal places; schedule uses cent-level rounding.
Full example response (JSON)
{
"status": "available",
"result": {
"monthlyPayment": 8.3333333333
},
"formulaVersion": "fixed-payment-1.0.0",
"units": {
"monthlyPayment": "USD/month",
"annualRate": "percentage-points",
"months": "months"
},
"assumptions": [
"Monthly nominal annual interest / 12; principal and interest only; no taxes or fees.",
"Payment carries ten decimal places; schedule uses cent-level rounding."
],
"warnings": [],
"creditCost": 1
}$2,400 over 24 months at 0%
monthlyPayment- 100 USD/month
How to interpret this result
- Monthly nominal annual interest / 12; principal and interest only; no taxes or fees.
- Payment carries ten decimal places; schedule uses cent-level rounding.
Full example response (JSON)
{
"status": "available",
"result": {
"monthlyPayment": 100
},
"formulaVersion": "fixed-payment-1.0.0",
"units": {
"monthlyPayment": "USD/month",
"annualRate": "percentage-points",
"months": "months"
},
"assumptions": [
"Monthly nominal annual interest / 12; principal and interest only; no taxes or fees.",
"Payment carries ten decimal places; schedule uses cent-level rounding."
],
"warnings": [],
"creditCost": 1
}Request contract
Accepted inputs
Fields for this example. Expand the schema for all supported combinations and limits.
Catalog example
FieldType, units and limits
principalRequiredOriginal loan principal.
Min 0 · Max 1000000000 · Step 0.01annualRateRequiredNominal annual rate. Enter 6.5 for 6.5%.
Min 0 · Max 100 · Step 1e-9monthsRequiredNumber of whole months in the term.
Min 1 · Max 600Example request body (JSON)
{
"principal": 100,
"annualRate": 0,
"months": 12
} $2,400 over 24 months at 0%
FieldType, units and limits
principalRequiredOriginal loan principal.
Min 0 · Max 1000000000 · Step 0.01annualRateRequiredNominal annual rate. Enter 6.5 for 6.5%.
Min 0 · Max 100 · Step 1e-9monthsRequiredNumber of whole months in the term.
Min 1 · Max 600Example request body (JSON)
{
"principal": 2400,
"annualRate": 0,
"months": 24
} Full JSON schema
{
"type": "object",
"properties": {
"principal": {
"type": "number",
"description": "Original loan principal.",
"x-unit": "USD",
"minimum": 0,
"maximum": 1000000000,
"multipleOf": 0.01,
"x-core-refinement": true
},
"annualRate": {
"type": "number",
"description": "Nominal annual rate. Enter 6.5 for 6.5%.",
"x-unit": "percentage-points",
"minimum": 0,
"maximum": 100,
"multipleOf": 1e-9,
"x-core-refinement": true
},
"months": {
"type": "integer",
"description": "Number of whole months in the term.",
"x-unit": "months",
"minimum": 1,
"maximum": 600
}
},
"required": [
"principal",
"annualRate",
"months"
],
"additionalProperties": false
}Production endpoint: POST https://calc.hasstechapi.com/v2/calc/fixed-payment
Formula: fixed-payment-1.0.0