Get active loans for a merchant

GET

/api/v1/marketplace/loans/active

Retrieve all active (disbursed) loans for a merchant, including repayment terms and outstanding balances.

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 ********************

Query Params

Responses

🟢200OK

application/json

Active loans retrieved

Bodyapplication/json

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location '/api/v1/marketplace/loans/active?merchant_id=your_merchant_id&merchant_id_type=undefined' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Success Example

{
    "merchant": {
        "opensylo_id": "merchant_uuid",
        "marketplace_id": "your_merchant_id",
        "name": "Yakoyo Foods Ltd"
    },
    "active_loans": [
        {
            "loan_id": "loan_uuid",
            "reference": "LOAN-2026-001",
            "lender": {
                "id": "lender_uuid",
                "name": "FinCo Lending"
            },
            "status": "DISBURSED",
            "disbursed_at": "2026-01-15T10:00:00.000Z",
            "due_date": "2026-04-15T00:00:00.000Z",
            "terms": {
                "principal_amount": 500000,
                "total_repayment": 525000,
                "currency": "NGN"
            },
            "repayment": {
                "deduction_percentage": 10,
                "minimum_deduction": 500,
                "total_repaid": 200000,
                "outstanding": 325000,
                "is_overdue": false,
                "days_overdue": 0
            },
            "deduction_active": true
        }
    ],
    "summary": {
        "total_active_loans": 1,
        "total_outstanding": 325000,
        "combined_deduction_percentage": 10
    },
    "timestamp": "2026-01-29T12:00:00.000Z"
}

Modified at 2026-04-08 17:24:40

Integration health check

Get loan status