chatbot
clear chat
Skip to main content

Create

POST 

/scenarios/:scenarioId/persons/:personId/goals/invest-in-a-business

Creates a new Invest in a Business goal in the given scenario identified by {scenarioId} and Person identified by {personId}.

Request

Path Parameters

    scenarioId stringrequired

    The scenario's id

    personId stringrequired

    The person's id

Body

required
    currency stringrequired

    The currency in which the goal's value is specified. Valid currency code ISO-4217 from the list of supported currencies.

    description string

    Description of the resource.

    desiredAmount number

    The desired value of the goal.

    enabled boolean

    Toggle inclusion of the goal in the simulation.

    endDate date-time

    End date of the goal. Valid date string in simplified extended ISO-8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Will be respected only in conjuction with endsOn equals to USER_DEFINED.

    endsOn string

    Possible values: [USER_DEFINED, ON_RETIREMENT, ON_DEATH]

    Can be any of USER_DEFINED, ON_RETIREMENT, ON_DEATH.

    expectedDividendAmount numberrequired

    Expected dividend amount.

    expectedDividendGrowthRate string

    Possible values: [CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH]

    Can be either of CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH.

    expectedDividendSpreadOverGrowthRate double

    Possible values: <= 1

    Define the additional spread over the defined growthRate of the dividend income.

    expectedDividendStartDate date-timerequired

    Expected dividend start date.

    expectedDividendTaxable boolean

    Whether expected dividends are taxable or not.

    expectedExitAmount numberrequired

    Expected exit amount.

    expectedExitGrowthRate string

    Possible values: [CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH]

    Can be either of CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH.

    expectedExitSpreadOverGrowthRate double

    Possible values: <= 1

    0.0

    expectedExitTaxable boolean

    Whether expected exit is taxable or not.

    frequency stringrequired

    Possible values: [UNSPECIFIED, ONE_OFF, DAILY, WEEKLY, MONTHLY, QUARTERLY, SEMI_ANNUALLY, ANNUALLY]

    The frequency of the goal.

    frequencyMultiplier int32

    Possible values: >= 1

    The frequency multiplier.

    fundingSources object[]

    A list of funding sources.

  • Array [
  • oneOf
    description string
    id string
    name string
    amount number
    currency string
    growthRate string

    Possible values: [CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH]

    maximumAbsoluteSpreadAllowed double

    Possible values: <= 1

    spreadOverGrowthRate double

    Possible values: <= 1

  • ]
  • growthRate string

    Possible values: [CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH]

    Can be either of CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH.

    id string

    The id of the resource.

    maximumAbsoluteSpreadAllowed double

    Possible values: <= 1

    Maximum absolute spread added to growth rate allowed.

    minimumAmount numberrequired

    The minimum value of the goal.

    name string

    The name of the resource.

    priority int32required

    The priority of the goal (1 = lowest, 10 = highest).

    properties object

    Properties of the resource.

    property name* object

    Properties of the resource.

    recurringAmount numberrequired

    The recurring expense amount of the goal.

    recurringStartDate date-time

    Start date of the recurring expense.

    spreadOverGrowthRate double

    Possible values: <= 1

    Define the additional spread over the defined growthRate.

    startDate date-timerequired

    Start date of the goal. Valid date string in simplified extended ISO-8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Will be respected only in conjuction with startsOn equals to USER_DEFINED.

    startsOn string

    Possible values: [USER_DEFINED, ON_RETIREMENT, ON_DEATH]

    Can be any of USER_DEFINED, ON_RETIREMENT, ON_DEATH.

Responses

Created

Schema
    currency stringrequired

    The currency in which the goal's value is specified. Valid currency code ISO-4217 from the list of supported currencies.

    description string

    Description of the resource.

    desiredAmount number

    The desired value of the goal.

    enabled boolean

    Toggle inclusion of the goal in the simulation.

    endDate date-time

    End date of the goal. Valid date string in simplified extended ISO-8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Will be respected only in conjuction with endsOn equals to USER_DEFINED.

    endsOn string

    Possible values: [USER_DEFINED, ON_RETIREMENT, ON_DEATH]

    Can be any of USER_DEFINED, ON_RETIREMENT, ON_DEATH.

    expectedDividendAmount numberrequired

    Expected dividend amount.

    expectedDividendGrowthRate string

    Possible values: [CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH]

    Can be either of CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH.

    expectedDividendSpreadOverGrowthRate double

    Possible values: <= 1

    Define the additional spread over the defined growthRate of the dividend income.

    expectedDividendStartDate date-timerequired

    Expected dividend start date.

    expectedDividendTaxable boolean

    Whether expected dividends are taxable or not.

    expectedExitAmount numberrequired

    Expected exit amount.

    expectedExitGrowthRate string

    Possible values: [CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH]

    Can be either of CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH.

    expectedExitSpreadOverGrowthRate double

    Possible values: <= 1

    0.0

    expectedExitTaxable boolean

    Whether expected exit is taxable or not.

    frequency stringrequired

    Possible values: [UNSPECIFIED, ONE_OFF, DAILY, WEEKLY, MONTHLY, QUARTERLY, SEMI_ANNUALLY, ANNUALLY]

    The frequency of the goal.

    frequencyMultiplier int32

    Possible values: >= 1

    The frequency multiplier.

    fundingSources object[]

    A list of funding sources.

  • Array [
  • oneOf
    description string
    id string
    name string
    amount number
    currency string
    growthRate string

    Possible values: [CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH]

    maximumAbsoluteSpreadAllowed double

    Possible values: <= 1

    spreadOverGrowthRate double

    Possible values: <= 1

  • ]
  • growthRate string

    Possible values: [CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH]

    Can be either of CALCULATED, NONE, CPI, MEDIAN_WAGE_GROWTH, PROPERTY_GROWTH.

    id string

    The id of the resource.

    maximumAbsoluteSpreadAllowed double

    Possible values: <= 1

    Maximum absolute spread added to growth rate allowed.

    minimumAmount numberrequired

    The minimum value of the goal.

    name string

    The name of the resource.

    priority int32required

    The priority of the goal (1 = lowest, 10 = highest).

    properties object

    Properties of the resource.

    property name* object

    Properties of the resource.

    recurringAmount numberrequired

    The recurring expense amount of the goal.

    recurringStartDate date-time

    Start date of the recurring expense.

    spreadOverGrowthRate double

    Possible values: <= 1

    Define the additional spread over the defined growthRate.

    startDate date-timerequired

    Start date of the goal. Valid date string in simplified extended ISO-8601 format (YYYY-MM-DDTHH:mm:ss.sssZ). Will be respected only in conjuction with startsOn equals to USER_DEFINED.

    startsOn string

    Possible values: [USER_DEFINED, ON_RETIREMENT, ON_DEATH]

    Can be any of USER_DEFINED, ON_RETIREMENT, ON_DEATH.

Loading...