---
title: "Rank competing loan offers by true cost of capital, not headline rate."
method: POST
path: "/api/v1/tools/compare_loan_offers"
tags: ["Calculators"]
---

# Rank competing loan offers by true cost of capital, not headline rate.

`POST /api/v1/tools/compare_loan_offers`

## Request

- Base URL: `https://relendi.com`
- URL: `https://relendi.com/api/v1/tools/compare_loan_offers`
- Auth: none declared

Rank competing loan offers by true cost of capital, not headline rate. Accounts for origination, exit and other fees over the actual term, and returns an effective rate, total cost and fee burden in basis points for each — so a 'cheaper' rate with heavy fees sorts correctly.

## Request body

- object
  - `offers` object[], required
    - `lenderName` string
    - `loanAmount` number, required
    - `interestRate` number, required: Annual rate, percent (8.25 = 8.25%)
    - `term` string, required: Loan term WITH its unit — '18 months' or '5 years'. A bare number is rejected: the underlying parser would read '30' as 30 months, understating a 30-year note's cost 12x.
    - `originationFee` number
    - `exitFee` number
    - `applicationFee` number

## Response `200`

The computed result.

- object
  - `tool` 'compare_loan_offers', required
  - `deterministic` boolean
  - `result` object, required: Result fields: ranked.lenderName, ranked.loanAmount, ranked.interestRate, ranked.term, ranked.effectiveRate, ranked.totalInterestCost, ranked.totalFeeCost, ranked.totalCost, ranked.costPerMonth, ranked.feeBurdenBps, cheapest, note.

## Other responses

- `400`: Error. Possible codes: invalid_input.
- `404`: Error. Possible codes: unknown_tool, not_found.
- `405`: Error. Possible codes: method_not_allowed.
- `429`: Error. Possible codes: rate_limited, quota_exhausted.
- `500`: Error. Possible codes: tool_error.
- `503`: Error. Possible codes: flag_off.

---

[API](https://skmtc.dev/relendi/apis/relendi-public-api.md) · [All operations](https://skmtc.dev/relendi/apis/relendi-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/relendi/apis/relendi-public-api/revisions/7e4b30838121?raw)