Simulating CCB Loans

We provide an endpoint so you can simulate CCB Loans before creating the Loan itself.

To use it, you can make this API call:

POST /loans/simulate, with this payload as an example:

{
    "requested_amount": 2000,
    "interest_rate": 0.12, // 12,00% am
    "tac_amount": 0,
    "finance_fee": 0,
    "installments": 10,
    "tax_id":"12968050001",
    "first_installment_date": "2025-09-20",
    "disbursement_date": "2025-08-20"
}

And you'd receive this response:

{
	"total_processing_cost": 59.16,
	"iof_amount": 59.16,
	"interest_rate": 0.12,
	"tac_amount": 0.0,
	"total_amount_owed": 3648.72,
	"financed_amount": 2000.0,
	"requested_amount": 2000.0,
	"disbursement_amount": 2000.0,
	"num_periods": 10,
	"first_installment_date": "2025-09-20",
	"disbursement_date": "2025-08-20",
	"schedule": [
		{
			"payment": 364.89,
			"payment_date": "2025-09-20"
		},
		{
			"payment": 364.87,
			"payment_date": "2025-10-20"
		},
		{
			"payment": 364.87,
			"payment_date": "2025-11-20"
		},
		{
			"payment": 364.87,
			"payment_date": "2025-12-20"
		},
		{
			"payment": 364.87,
			"payment_date": "2026-01-20"
		},
		{
			"payment": 364.87,
			"payment_date": "2026-02-20"
		},
		{
			"payment": 364.87,
			"payment_date": "2026-03-20"
		},
		{
			"payment": 364.87,
			"payment_date": "2026-04-20"
		},
		{
			"payment": 364.87,
			"payment_date": "2026-05-20"
		},
		{
			"payment": 364.87,
			"payment_date": "2026-06-20"
		}
	],
	"schedule_type": "MONTHLY",
	"amortization_type": "PRICE",
	"interest_compounding_type": "COMPOUND",
	"last_payment_date": "2026-06-20"
}