v1

latestOpenAPI 3.1.02026-07-263644911022.4 KB

LoanApplications

Create loan application

Creates a pending approval loan application from an already-previewed schedule snapshot.

post/api/v1/loan-applications

Request body

borrowerIdstring required

Borrower identifier.

expectedDisbursementDatestring required

Expected disbursement date (RFC3339).

loanProductVersionIdstring required

Loan product version identifier (UUID).

previewScheduleSnapshotIdstring required

Preview schedule snapshot identifier (UUID).

requestedInstallmentsinteger required

Number of installments.

requestedInterestRatestring required

Requested monthly interest rate as a decimal string, scale 8 (e.g. "0.00000100").

requestedPrincipalAmountstring required

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

Example request

{
  "expectedDisbursementDate": "2026-06-14T12:00:00Z",
  "loanProductVersionId": "550e8400-e29b-41d4-a716-446655440000",
  "previewScheduleSnapshotId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "requestedInstallments": 24,
  "requestedInterestRate": "0.00000100",
  "requestedPrincipalAmount": "50000.00"
}

Response

Created

assignedOfficerIdstring required

Authenticated officer who created the application (request subject).

borrowerIdstring required

Borrower identifier.

expectedDisbursementDatestring required

Expected disbursement date (RFC3339, UTC).

idstring required

Loan application identifier (UUID).

loanProductVersionIdstring required

Loan product version this application was created against (UUID).

previewJurisdictionCodestring required

ISO-2 jurisdiction code resolved at preview time.

previewProfileVersionstring required

Jurisdiction profile version resolved at preview time.

previewScheduleSnapshotIdstring required

Preview schedule snapshot this application was created from (UUID).

requestedInstallmentsinteger required

Number of installments requested.

requestedInterestRatestring required

Requested monthly interest rate as a decimal string, scale 8 (e.g. "0.00000100").

requestedPrincipalAmountstring required

Requested principal amount as a decimal string, minor-unit precision scale 2 (e.g. "50000.00").

statusstring required

Lifecycle status: one of pending_approval, approved, rejected, withdrawn, disbursed.

Example response

{
  "approvalDecision": {
    "approvedAmount": "48000.00",
    "decisionAt": "2026-06-14T12:00:00Z",
    "id": "9f1c2d3e-4b5a-6789-abcd-ef0123456789"
  },
  "disbursementEvent": {
    "disbursedAt": "2026-06-14T12:00:00Z",
    "grossRequestedAmount": "50000.00",
    "id": "c3d4e5f6-a7b8-4901-acde-f01234567890",
    "loanAccountId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
    "netDeliveredAmount": "49500.00",
    "profileVersion": "1.0.0"
  },
  "expectedDisbursementDate": "2026-06-14T12:00:00Z",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "loanProductVersionId": "550e8400-e29b-41d4-a716-446655440000",
  "previewJurisdictionCode": "BR",
  "previewProfileVersion": "1.0.0",
  "previewScheduleSnapshotId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
  "rejectionDecision": {
    "decisionAt": "2026-06-14T12:00:00Z",
    "id": "b2c3d4e5-f6a7-4890-9bcd-ef0123456789"
  },
  "requestedInstallments": 24,
  "requestedInterestRate": "0.00000100",
  "requestedPrincipalAmount": "50000.00",
  "status": "pending_approval",
  "withdrawalDecision": {
    "decisionAt": "2026-06-14T12:00:00Z",
    "id": "b2c3d4e5-f6a7-4890-9bcd-ef0123456789"
  }
}