Skip to main content
PUT
/
api
/
v1
/
services
/
user
/
update-application
/
{loan-application-id}
[https://finlend.fincode.software/api/v1/services/user/update-application/{loan-application-id}?status=true](https://finlend.fincode.software/api/v1/services/user/update-application/{loan-application-id}?status=true)

{
  "status": "<string>",
  "data": {
    "applicationId": "<string>",
    "loanProductId": "<string>",
    "userName": "<string>",
    "productName": "<string>",
    "currencyCode": "<string>",
    "employmentStatus": "<string>",
    "loanApplicationcreatedDate": "<string>",
    "userId": "<string>",
    "durationCounterUnitEnum": "<string>",
    "requestedLoanAmount": 123,
    "loanStatus": "<string>",
    "monthlyIncome": 123,
    "dateOfBirth": "<string>",
    "loanDuration": 123
  }
}
Customers can use this endpoint to respond to a loan offer. If the offer is accepted, the application status changes to ACCEPTED. If withdrawn, the status changes to WITHDRAWN.
This endpoint can only be used when the loan application status is OFFER_SENT. Attempting to use it with any other status will result in an error.
[https://finlend.fincode.software/api/v1/services/user/update-application/{loan-application-id}?status=true](https://finlend.fincode.software/api/v1/services/user/update-application/{loan-application-id}?status=true)

​
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

​
loan-application-id
string
required
The unique identifier (UUID) of the loan application to update.

​
Query Parameters

​
status
boolean
required
  • true: Accept the loan offer (status changes to ACCEPTED)
  • false: Withdraw from the loan offer (status changes to WITHDRAWN)

​
Response

Returns the updated loan application details.
​
status
string
default:"SUCCESS"
Overall status of the API request.
​
data
object
Updated loan application details.

​
Code Examples

curl --location --request PUT 'https://finlend.fincode.software/api/v1/services/user/update-application/123e4567-e89b-12d3-a456-426614174000?status=true' \
--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'