Get loan status

GET

/api/v1/marketplace/loans/{loanId}/status

Retrieve the current status of a specific loan, including repayment progress and collection priority.

Required scope: repayment.report

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Path Params

Responses

🟢200

application/json

Loan status retrieved

Body

🟠401

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.opensylo.com/api/v1/marketplace/loans/loan_uuid/status' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success

{
    "loan_id": "loan_uuid",
    "reference": "LOAN-2026-001",
    "status": "DISBURSED",
    "deduction_required": true,
    "merchant": {
        "opensylo_id": "merchant_uuid",
        "marketplace_id": "your_merchant_id"
    },
    "repayment": {
        "deduction_percentage": 10,
        "minimum_deduction": 500,
        "total_due": 525000,
        "total_repaid": 200000,
        "outstanding": 325000,
        "currency": "NGN"
    },
    "due_date": "2026-04-15T00:00:00.000Z",
    "is_overdue": false,
    "days_overdue": 0,
    "collection_priority": "normal",
    "timestamp": "2026-01-29T12:00:00.000Z"
}

Modified at 2026-01-29 23:19:05

Get active loans for a merchant

Validate deduction amounts