---
title: "Get Loan Status"
method: POST
path: "/1.0/getLoanStatus"
tags: ["Loan"]
---

# Get Loan Status

`POST /1.0/getLoanStatus`

Use the Get Loan Status endpoint to get the most recent information on a loan.

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

## 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.
    - `loan_apr` number, required — Annual percentage rate for interest charged on the loan. Calculated from the interest defined by the subproduct, the length of the loan, the origination fee (if applicable) and other fees (if applicable).
    - `loan_creation_date` string, date, required — Date that the loan was created. This may be different from `loan_start_date`.
    - `interest_rate` number, required — Interest rate applied to the loan, as defined by the subproduct
    - `rate_type` 'fixed' | 'variable', required — Indicates whether the interest type is `FIXED` or `VARIABLE.
    - `installment_amount` number, required — Payment due at each installment. This is the same amount as `amort_payment_amount`.
    - `next_installment_amount` number, required — Payment due at the next installment. For example: * If an installment is unpaid and due tomorrow, this field is the amount due for tomorrow’s installment. * If an installment is partially paid and due tomorrow, this field is the remaining amount due. * If no payment is required until the next installment, this field is the next installment amount. Similar logic applies to `next_installment_due_date`.
    - `next_installment_due_date` string, date, required — Date that the next installment is due. For example: * If an installment is unpaid and due tomorrow, this field is the due date (tomorrow). * If an installment is paid and due tomorrow, this field is the date when the next installment is due. Similar logic applies to `next_installment_amount`. For a loan with a `Completed` or `Charged Off` account status, this field is empty.
    - `principal_balance` number, required — Current principal balance remaining on the loan
    - `total_principal_paid` number, required — Principal amount of the loan that is paid off.
    - `total_interest_paid` number, required — Interest amount of the loan that is paid off.
    - `total_fees_paid` number, required — Total amount paid toward fees, including the origination fee and late fees.
    - `total_accrued_interest` number, required — Total interest accrued on the loan, including interest that has been paid.
    - `loan_status` string, required — Status of the loan.
    - `payoff_amount` number, required — The total amount needed to pay off the remaining principal, accrued interest, and outstanding fees of a loan
    - `loan_closed_date` string, date, required — Date that the loan was closed, paid off, or charged off
    - `per_diem_interest_amount` number, required — Daily interest charged on the loan. This amount will update as installments are paid.
    - `number_payments_made` integer, required — Number of installment payments that the customer has made on the loan.
    - `number_payments_remaining` integer, required — Number of installment payments remaining on the loan.
    - `origination_fee` number, required — Fee charged at loan creation. Returns 0 if there is no origination fee.
    - `loan_payment_status` string, required — Overall status of payments made on the loan. See the list of values in the <a href="doc:reports-for-installment-loans#reports-for-installment-loans#loan-payment-status-and-loan-status-table" target="_blank">Loan Payment Status and Loan Status table</a> in the *Reports for Installment Loans* guide.
    - `projected_maturity_date` string, date, required — Total interest that the customer is projected to pay over the course of the loan
    - `loan_start_date` string, date, required — Start date for the loan. This may be different from `loan_creation_date`.

---

[API](https://skmtc.net/galileo-ft/apis/program-api.md) · [All operations](https://skmtc.net/galileo-ft/apis/program-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo-ft/program-api/revisions/bcd728f97a18/schema)