Update liability

PUT /api/v2/household/{HouseholdGUID}/liabilities/{LiabilityGUID}

This endpoint allows users to update a liability for a household.

Path parameters

application/json

Body Required

  • ClientGUID string(uuid) Required

    ClientGUID must be in the household.

  • LiabilityDescription string Required

    The following characters are not permitted: \:*"<>|

    Maximum length is 50.

  • LiabilityType integer Required

    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

  • Value number(float) Required
  • ValueDate string(date) Required

    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.

  • StartBasis integer Required

    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 is 130.

  • 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.

  • EndBasis integer Required

    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 is 130.

  • 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.

  • InterestRate number(float) Required

    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

  • 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

  • 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 is 130.

  • 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

Responses

PUT /api/v2/household/{HouseholdGUID}/liabilities/{LiabilityGUID}
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"}'
Request examples
{
  "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"
}
Response examples (200)
{
  "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"
    }
  }
}
Response examples (403)
{
  "success": false,
  "message": "You do not have permission to edit the household."
}
Response examples (404)
{
  "success": false,
  "message": "Household not found."
}
Response examples (422)
{
  "success": false,
  "message": "Validation Error.",
  "data": {
    "ClientGUID": [
      "The client guid field is required."
    ]
  }
}
Response examples (500)
{
  "success": false,
  "message": "Failed to update liability in household"
}