Update liability
This endpoint allows users to update a liability for a household.
Path parameters
-
The HouseholdGUID of the client.
-
The LiabilityGUID you want to update.
Body Required
-
ClientGUID must be in the household.
-
The following characters are not permitted: \:*"<>|
Maximum length is
50
. -
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
Dates should be provided in the format "Y-m-d", where "Y" represents the year, "m" represents the month and "d" represents the day. For example, "2023-07-24" represents 24th July, 2023.
-
JointOwnerClientGUID string(uuid) | null
JointOwnerClientGUID must be in the household.
-
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
StartEventGUID string(uuid) | null
This field is required if the value of StartBasis = 4.
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
StartAge integer | null
This field is required if the value of StartBasis = 2 or 7.
Minimum value is
0
, maximum value is130
. -
StartDate string | null
This field is required if the value of StartBasis = 3.
Dates should be provided in the format "Y-m-d", where "Y" represents the year, "m" represents the month and "d" represents the day. For example, "2023-07-24" represents 24th July, 2023.
-
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
EndEventGUID string(uuid) | null
This field is required if the value of EndBasis = 4. Event end must be after starting.
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
EndAge integer | null
This field is required if the value of EndBasis = 2 or 7. EndAge end must be after starting.
Minimum value is
0
, maximum value is130
. -
EndDate string | null
This field is required if the value of EndBasis = 3. EndDate end must be after starting.
Dates should be provided in the format "Y-m-d", where "Y" represents the year, "m" represents the month and "d" represents the day. For example, "2023-07-24" represents 24th July, 2023.
-
This value must be a positive number.
-
InterestRateChange integer | null
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
InterestRateChangeBasis integer | null
This field is required if the value of InterestRateChange = 1.
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
InterestRateChangeEventGUID string(uuid) | null
This field is required if the value of InterestRateChangeBasis = 4 and the value of InterestRateChange = 1.
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
InterestRateChangeAge integer | null
This field is required if the value of InterestRateChangeBasis = 2 or 7 and the value of InterestRateChange = 1. InterestRateChangeAge must be in the future
Minimum value is
0
, maximum value is130
. -
InterestRateChangeDate string | null
This field is required if the value of InterestRateChangeBasis = 3 and the value of InterestRateChange = 1. InterestRateChangeDate must be in the future
Dates should be provided in the format "Y-m-d", where "Y" represents the year, "m" represents the month and "d" represents the day. For example, "2023-07-24" represents 24th July, 2023.
-
NewInterestRate number(float) | null
This field is required if the value of InterestRateChange = 1. This value must be a positive number.
-
ClearLiabilityAtEnd integer | null
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
BackOfficeID string | null
Maximum length is
255
. -
BackOfficeSync integer | null
An integer representing the status of the back office sync:
- 1: Yes
- 2: No
- 3: Only update from back office
-
PolicyNumber string | null
Maximum length is
100
. -
ProviderCode string(uuid) | null
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
-
LinkedAssetGUID string(uuid) | null
To retrieve a comprehensive list of acceptable values and their corresponding formatted values, you may make a request to the designated endpoint: /api/v2/household/{HouseholdGUID}/liabilities/options
curl \
-X PUT https://api.fincalc.co.uk/api/v2/household/{HouseholdGUID}/liabilities/{LiabilityGUID} \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"ClientGUID":"3F0B1C88-6D80-4C17-BB3E-1D68E6D26405","LiabilityDescription":"API Test","LiabilityType":1,"Value":150000.1,"ValueDate":"2023-04-20","JointOwnerClientGUID":"3F0B1C88-6D80-4C17-BB3E-1D68E6D26405","StartBasis":4,"StartEventGUID":"F3AAED8D-3A5F-44B5-BC6D-9E8C7646C9D7","StartAge":42,"StartDate":"2023-05-04","EndBasis":3,"EndEventGUID":"F3AAED8D-3A5F-44B5-BC6D-9E8C7646C9D7","EndAge":65,"EndDate":"2069-02-01","InterestRate":5.5,"InterestRateChange":1,"InterestRateChangeBasis":4,"InterestRateChangeEventGUID":"3F0B1C88-6D80-4C17-BB3E-1D68E6D26405","InterestRateChangeAge":65,"InterestRateChangeDate":"2023-04-20","NewInterestRate":4.5,"ClearLiabilityAtEnd":1,"BackOfficeID":13573,"BackOfficeSync":1,"PolicyNumber":134300454,"ProviderCode":"8379dc94-3bcf-e011-87a9-b8ac6f1693a9","LinkedAssetGUID":"3F0B1C88-6D80-4C17-BB3E-1D68E6D26405"}'
{
"ClientGUID": "3F0B1C88-6D80-4C17-BB3E-1D68E6D26405",
"LiabilityDescription": "API Test",
"LiabilityType": 1,
"Value": 150000.1,
"ValueDate": "2023-04-20",
"JointOwnerClientGUID": "3F0B1C88-6D80-4C17-BB3E-1D68E6D26405",
"StartBasis": 4,
"StartEventGUID": "F3AAED8D-3A5F-44B5-BC6D-9E8C7646C9D7",
"StartAge": 42,
"StartDate": "2023-05-04",
"EndBasis": 3,
"EndEventGUID": "F3AAED8D-3A5F-44B5-BC6D-9E8C7646C9D7",
"EndAge": 65,
"EndDate": "2069-02-01",
"InterestRate": 5.5,
"InterestRateChange": 1,
"InterestRateChangeBasis": 4,
"InterestRateChangeEventGUID": "3F0B1C88-6D80-4C17-BB3E-1D68E6D26405",
"InterestRateChangeAge": 65,
"InterestRateChangeDate": "2023-04-20",
"NewInterestRate": 4.5,
"ClearLiabilityAtEnd": 1,
"BackOfficeID": 13573,
"BackOfficeSync": 1,
"PolicyNumber": 134300454,
"ProviderCode": "8379dc94-3bcf-e011-87a9-b8ac6f1693a9",
"LinkedAssetGUID": "3F0B1C88-6D80-4C17-BB3E-1D68E6D26405"
}
{
"success": true,
"data": {
"LiabilityGUID": "E4A4A332-C53C-4C33-8D5B-1B846C3D6D6D",
"ClientGUID": "3F0B1C88-6D80-4C17-BB3E-1D68E6D26405",
"LiabilityDescription": "API Test",
"LiabilityType": 1,
"Value": 150000.1,
"ValueDate": "2023-04-20",
"JointOwnerClientGUID": "3F0B1C88-6D80-4C17-BB3E-1D68E6D26405",
"StartBasis": 4,
"StartEventGUID": "F3AAED8D-3A5F-44B5-BC6D-9E8C7646C9D7",
"StartAge": 42,
"StartDate": "2023-05-04",
"EndBasis": 3,
"EndEventGUID": "F3AAED8D-3A5F-44B5-BC6D-9E8C7646C9D7",
"EndAge": 65,
"EndDate": "2069-02-01",
"InterestRate": 5.5,
"InterestRateChange": 1,
"InterestRateChangeBasis": 4,
"InterestRateChangeEventGUID": "3F0B1C88-6D80-4C17-BB3E-1D68E6D26405",
"InterestRateChangeAge": 65,
"InterestRateChangeDate": "2023-04-20",
"NewInterestRate": 4.5,
"ClearLiabilityAtEnd": 1,
"BackOfficeID": "F7FBB6B1-2D90-485C-AE89-9F9FA0426F1E",
"BackOfficeSync": 1,
"PolicyNumber": 134300454,
"ProviderCode": "8379dc94-3bcf-e011-87a9-b8ac6f1693a9",
"LinkedAssetGUID": "3F0B1C88-6D80-4C17-BB3E-1D68E6D26405",
"FormattedValues": {
"Value": "£150,000",
"EndBasis": "Event",
"ValueDate": "20/04/2023",
"StartBasis": "Current",
"EndEventGUID": "API's State Pension Age",
"InterestRate": "1%",
"LiabilityType": "Repayment Mortgage",
"LinkedAssetGUID": "Our House",
"InterestRateChange": "No",
"ClearLiabilityAtEnd": "Yes"
}
}
}
{
"success": false,
"message": "You do not have permission to edit the household."
}
{
"success": false,
"message": "Household not found."
}
{
"success": false,
"message": "Validation Error.",
"data": {
"ClientGUID": [
"The client guid field is required."
]
}
}
{
"success": false,
"message": "Failed to update liability in household"
}