Pending Repayments

Retrieves a paginated list of pending repayments for a user across all their loans.

GET /api/v1/services/user/pending-repayments/{user-id}

cURL GET

[https://finlend.fincode.software/api/v1/services/user/pending-repayments/{user-id}](https://finlend.fincode.software/api/v1/services/user/pending-repayments/{user-id})

200

{
  "status": "<string>",
  "data": [
    {
      "loanApplicationId": "<string>",
      "installmentNumber": 123,
      "dueDate": "<string>",
      "amountDue": 123,
      "principalAmount": 123,
      "interestAmount": 123,
      "status": "<string>",
      "daysOverdue": 123
    }
  ]
}

Fetches all pending repayments that the user needs to make, including due dates and amounts for each installment.

cURL GET

[https://finlend.fincode.software/api/v1/services/user/pending-repayments/{user-id}](https://finlend.fincode.software/api/v1/services/user/pending-repayments/{user-id})

Request Headers

X-Auth-Token · string · required

The JWT Access Token obtained from the /login or /refresh-token endpoint.

x-idempotency-key · string · required

Unique idempotency key for the request to prevent duplicate processing.

x-fapi-auth-date · string · required

The date and time at which the request was initiated (ISO 8601 format).

x-fapi-customer-ip-address · string · required

The IP address of the customer making the request.

x-fapi-interaction-id · string · required

Unique identifier for the interaction/session.

Path Parameters

user-id · string · required

The unique identifier (UUID) of the user whose pending repayments to retrieve.

Query Parameters

page · number · default: "1"

Page number for pagination (starts from 1).

size · number · default: "10"

Number of items per page (maximum recommended: 50).

Response

Returns a list of pending repayments with details.

status · string · default: "SUCCESS"

Overall status of the API request.

data · array

Array of pending repayment objects.

Show data array item

loanApplicationId · string

Unique identifier for the loan application.

installmentNumber · number

Sequential number of the installment.

dueDate · string

Date when this repayment is due.

amountDue · number

Amount that needs to be repaid.

principalAmount · number

Principal portion of the repayment.

interestAmount · number

Interest portion of the repayment.

status · string

Status of the repayment (e.g., PENDING, OVERDUE).

daysOverdue · number

Number of days the repayment is overdue (if applicable).

Code Examples

cURL

curl --location 'https://finlend.fincode.software/api/v1/services/user/pending-repayments/123e4567-e89b-12d3-a456-426614174000?page=1&size=10' \
--header 'X-Auth-Token: YOUR_JWT_ACCESS_TOKEN' \
--header 'x-idempotency-key: unique-key-12345' \
--header 'x-fapi-auth-date: 2024-01-15T10:30:00Z' \
--header 'x-fapi-customer-ip-address: 192.168.1.1' \
--header 'x-fapi-interaction-id: interaction-12345'