---
title: "Eligible repayment plans per loan"
method: POST
path: "/v1/plan-eligibility"
tags: ["Finology.PublicApi"]
---

# Eligible repayment plans per loan

`POST /v1/plan-eligibility`

## Request

- Base URL: `https://api.finology.tech` (the document declares no server; this is the origin it was published from)
- URL: `https://api.finology.tech/v1/plan-eligibility`
- Auth: API key in header `X-Api-Key`

Returns the eligible repayment plan types for each supplied loan, using the same eligibility logic the planner's plan picker uses. Every plan returned is a planType /v1/projection and /v1/comparison accept. Calc-only.

## Request body

- EligibilityRequest
  - `loans` LoanRequest[], required
    - `loanType` string, required
    - `principalBalance` number, double, required
    - `interestBalance` number, double
    - `interestRate` number, double, required
    - `disbursedAmount` number, double
    - `idrMonthsInRepayment` integer
    - `pslfCount` integer

## Response `200`

OK

- EligibilityResult
  - `loans` LoanEligibility[], nullable
    - `loanType` string, nullable
    - `balance` number, double
    - `eligiblePlanTypes` string[], nullable
  - `provenance` EngineProvenance
    - `computedBy` string, nullable
    - `engine` string, nullable
    - `parityVerified` boolean
    - `computedAtUtc` string, date-time
    - `ruleVersion` string, nullable
    - `citations` RuleCitation[], nullable
      - `id` string, nullable
      - `label` string, nullable
      - `authority` string, nullable
      - `url` string, nullable
      - `effectiveDate` string, nullable
      - `lastVerified` string, nullable
    - `knownOmissions` RuleOmissionNote[], nullable
      - `id` string, nullable
      - `label` string, nullable
      - `detail` string, nullable
      - `authority` string, nullable
      - `url` string, nullable
      - `effectiveDate` string, nullable
      - `expiresDate` string, nullable
      - `lastVerified` string, nullable
    - `answerId` string, uuid, nullable
    - `verifyUrl` string, nullable

## Other responses

- `400`: Bad Request

---

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