---
title: "Simulate Match Score"
method: POST
path: "/api/match-score/simulate"
---

# Simulate Match Score

`POST /api/match-score/simulate`

## Request

- Base URL: `https://api.kojiru.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kojiru.com/api/match-score/simulate`
- Auth: none declared

Public simulator — no auth required. Uses input data only.

## Request body

- SimulateRequest
  - `loan_amount` number, required
  - `loan_purpose` string, required
  - `sector` string
  - `annual_income` number, nullable
  - `years_in_business` number, nullable
  - `has_collateral` boolean
  - `previous_loans_repaid` integer
  - `previous_defaults` integer

## Response `200`

Successful Response

- MatchScoreResponse
  - `match_score` number, required
  - `tier` string, required
  - `r_score` number, required
  - `y_score` number, required
  - `v_score` number, required
  - `s_score` number, required
  - `r_details` object, required
  - `y_details` object, required
  - `v_details` object, required
  - `s_details` object, required
  - `instant_match` boolean, required
  - `estimated_rate_range` object, required
  - `improvement_tips` string, nullable
  - `lender_matches` integer, required
  - `estimated_savings` object, required
  - `timestamp` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kojiru/apis/kojiru-api.md) · [All operations](https://skmtc.dev/kojiru/apis/kojiru-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kojiru/apis/kojiru-api/revisions/7974409f57cd?raw)