---
title: "Get Loan Installment Statuses"
method: POST
path: "/1.0/getLoanInstallmentStatuses"
tags: ["Loan"]
---

# Get Loan Installment Statuses

`POST /1.0/getLoanInstallmentStatuses`

## Request

- Base URL: `lending-{corename}.{env}.gpsrv.com/lending/` (relative, and the document’s source URL is not known)
- URL: `lending-{corename}.{env}.gpsrv.com/lending/1.0/getLoanInstallmentStatuses`
- Auth: none declared

Use the Get Loan Installment Statuses endpoint to view individual installment status across all installments. This returns the details for each installment, including the status, payment due date, date paid, amount paid, and remaining balance.

For optional parameters, do not pass an empty string or null value.

## Request body `application/x-www-form-urlencoded`

- object
  - `apiLogin` string, required: Provider's web service username, as provided by Galileo for the requesting IP address. Pattern: Max 50 characters Example: `"AbC123-9999"`
  - `apiTransKey` string, required: Web service password, as provided by Galileo for the requesting IP address. Pattern: Max 15 characters Example: `"4sb62fh6w4h7w34g"`
  - `providerId` integer, required: Galileo-issued unique provider identifier. Pattern: Max 10 digits Example: `9999`
  - `transactionId` string, required: A provider-generated ID that is unique to each API call. A UUID is preferred. Do not reuse this identifier for multiple API calls. Pattern: Max 60 characters Example: `"984513-395483653-4483483478"`
  - `providerTransactionId` string: An optional provider-generated ID for the API request. Pattern: Max 60 characters Example: `"47823438032233777"`
  - `providerTimestamp` string: An optional provider-generated timestamp for the API request. Pattern: Max 60 characters Example: `"2017-05-01 13:01:01"`
  - `loanId` string, required: Unique identifier for the loan. Pattern: Max 30 characters Example: `"450825953"`.
  - `subProductId` string, required: Identifier for the loan subproduct. Pattern: Max 15 characters. Example: `"442824720"`.

## Response `200`

Success

- object
  - `status_code` integer, nullable, required: The response status code. May return a string for some statuses.
  - `status` string, nullable, required: The condition of a process or response
  - `processing_time` number, float, nullable, required: The time elapsed in processing the transaction
  - `echo` object, nullable, required: A structure that contains transaction ID information
    - `transaction_id` string, nullable, required: An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required: Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required: Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required: A system generated timestamp
  - `rtoken` string, nullable, required: A Galileo-generated ID used for tracking
  - `errors` string[]: A list of errors generated while the request was processed
  - `response_data` object, nullable, required: A structure for the response data. It can be empty but usually will contain information.
    - `installment_status_details` object[], required: Installment status details list
      - `installment_status` string, required: Status for the installment. Possible statuses are: `Scheduled`, `Paid`, `Paid Late`, `Unpaid`.
      - `installment_paid_date` string, date, required: Date the installment was completely paid
      - `amort_installment_number` integer, required: The number of the installment
      - `amort_payment_due_date` string, date, required: Date that the payment for this installment is due
      - `amort_payment_amount` number, required: Total amount owed for this installment, including the principal amount,interest and fees
      - `hist_payment_balance` number, required: Remaining balance of the installment. Returns '0.00' if an installment is paid.

---

[API](https://skmtc.dev/galileo-ft/apis/loan-api.md) - [All operations](https://skmtc.dev/galileo-ft/apis/loan-api/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/loan-api/revisions/64783a0f7d15?raw)