Skip to main content
POST
Preview amortisation schedule

Authorizations

Authorization
string
header
required

JWT bearer token issued by the identity provider.

Body

application/json
annualInterestRate
string
required

Annual interest rate as a decimal string (e.g. "0.12000000").

Example:

"0.12000000"

dayCountConvention
string
required

Day count convention identifier.

Example:

"ACT/365"

jurisdictionCode
string
required

ISO-2 jurisdiction code.

Required string length: 2
Example:

"BR"

principalAmount
string
required

Principal amount as a decimal string (e.g. "50000.00").

Example:

"50000.00"

startDate
string
required

Schedule start date (RFC3339 or YYYY-MM-DD).

Example:

"2026-06-14T00:00:00Z"

termMonths
integer<int64>
required

Number of months.

Required range: 1 <= x <= 600
Example:

24

gracePeriodDays
integer<int64>

Grace period in days.

Required range: 0 <= x <= 365
Example:

30

Response

OK

calendarReference
string
required

Identifier of the business calendar used to resolve due dates.

dayCountConvention
string
required

Day count convention applied to interest accrual.

Example:

"ACT/365"

installments
object[] | null
required

Ordered amortisation schedule, one entry per installment.

jurisdictionCode
string
required

ISO-2 jurisdiction code resolved for this preview.

Example:

"BR"

profileVersion
string
required

Jurisdiction profile version used to compute the schedule.

Example:

"1.0.0"

totalInterest
string
required

Sum of interest across all installments as a decimal string, minor-unit precision scale 2 (e.g. "4321.00").

Example:

"4321.00"

totalPrincipal
string
required

Sum of principal across all installments as a decimal string, minor-unit precision scale 2 (e.g. "50000.00").

Example:

"50000.00"

effectiveCostPreview
object

Effective-cost breakdown; present only when the jurisdiction profile computes one.

jurisdictionExtensions
object

Per-jurisdiction overlay payload; present only when the profile emits one.