Create
POST/scenarios/:scenarioId/persons/:personId/liabilities/secured-debts
Creates a new Secured Debt under the Household and for a person in the given scenario.
Request
Path Parameters
The scenario's id
The person's id
- application/json
Body
required
The amount of the liability.
The annual average interest rate of the liability.
The currency on which we hold that liability. Valid currency code ISO-4217 from the list of supported currencies.
Description of the resource.
The end date of the liability.
The id of the resource.
The name of the resource.
properties object
Properties of the resource.
Properties of the resource.
Possible values: [PRINCIPAL_AMORTIZATION, INTEREST_ONLY_WITH_BALLOON_PAYMENT]
The liability repayment type (any of PRINCIPAL_AMORTIZATION, INTEREST_ONLY_WITH_BALLOON_PAYMENT).
Read-only field containing the source of the data (eg. if it was imported from a 3rd party service).
The starting date of the liability.
Responses
- 201
- 404
- 500
Created
- application/json
- Schema
- Example (from schema)
Schema
The amount of the liability.
The annual average interest rate of the liability.
The currency on which we hold that liability. Valid currency code ISO-4217 from the list of supported currencies.
Description of the resource.
The end date of the liability.
The id of the resource.
The name of the resource.
properties object
Properties of the resource.
Properties of the resource.
Possible values: [PRINCIPAL_AMORTIZATION, INTEREST_ONLY_WITH_BALLOON_PAYMENT]
The liability repayment type (any of PRINCIPAL_AMORTIZATION, INTEREST_ONLY_WITH_BALLOON_PAYMENT).
Read-only field containing the source of the data (eg. if it was imported from a 3rd party service).
The starting date of the liability.
{
"amount": 70000,
"annualAverageInterestRate": 0.02,
"currency": "GBP",
"description": "My resource's description",
"endDate": "2036-01-01T00:00:00.000Z",
"id": "1",
"name": "My resource",
"properties": {
"property_1": "Value of property 1",
"property_2": "Value of property 2"
},
"repaymentType": "PRINCIPAL_AMORTIZATION",
"source": "Source of the resource",
"startDate": "2023-01-01T00:00:00.000Z"
}
Not Found
Internal Server Error