---
title: "Update Loan Status"
method: POST
path: "/1.0/updateLoanStatus"
tags: ["Loan"]
---

# Update Loan Status

`POST /1.0/updateLoanStatus`

## 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/updateLoanStatus`
- Auth: none declared

Use the Update Loan Status to set a loan to charge-off status. In the future, this supports scenarios like bankruptcy.

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"`
  - `loanStatus` 'charge_off', required: Status of the loan.
  - `loanStatusReasonCode` integer, required: Code associated with the reason for charging off a loan. Possible values: * `1010` — Divorce * `1011` — Deceased * `1012` — Incarcerated * `1013` — Income Loss * `1014` — Medical * `1015` — Refuse to pay * `1016` — Unknown Pattern: 4-digit code. Example: `"1016"`.
  - `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.
    - `loan_status` 'charge_off', required: Status of the loan.
    - `loan_id` string, required: Galileo-generated identifier for the loan
    - `loan_balance` number, required: Total balance remaining on the loan. In case of charge off the loan balance will be $0.00.
    - `total_charge_off_amount` number, required: Total amount that was charged off on the loan, inclusive of fees and interest

---

[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)