PortfolioLinkApi

GetRiskAbility

The following routes are available for this service:
All Verbs	/riskprofiles/calculate/riskability

**GetRiskAbility** Parameters:
Name	Parameter	Data Type	Required
Goal	query	GoalInfo	No
LumpSum	query	decimal	No
GetIncomeCashFlowRequest	query	GetIncomeCashFlowRequest	No
GetContributionCashFlowRequest	query	GetContributionCashFlowRequest	No
Currency	query	string	No
LiquidityNeeds	query	int	No
GoalTimeHorizon	query	int	No
RiskCapacity	query	int	No
Override	query	bool	No
OverrideMessage	query	string	No
OverrideRiskProfileId	query	int	No

**GoalInfo** Parameters:
Name	Parameter	Data Type	Required
GoalName	form	string	No
GoalDescription	form	string	No
Type	form	GoalTypeEnum	No
GoalHasTarget	form	bool	No
GoalTarget	form	decimal	No
GoalTargetAge	form	int	No
Currency	form	string	No
WrapperType	form	string	No

**GoalTypeEnum** Enum:
PostRetirement
PreRetirement
Emergency
Education
GeneralInvesting
Target
Wedding
House

**GetIncomeCashFlowRequest** Parameters:
Name	Parameter	Data Type	Required
KeyIndex	form	int	No
IncomeLabel	form	string	No
IncomeIncludeZeroIncomeYears	form	bool	No
Income	form	decimal	No
TaxRate	form	decimal	No
IncomeToLast	form	int	No
CurrentAge	form	int	No
IncomeGrowth	form	decimal	No
IncomeGrowthFrequency	form	decimal	No
PayoutFrequency	form	int	No
StartYear	form	int	No
HasAdhocCashFlow	form	bool	No
AdhocCashFlowAge1	form	int	No
AdhocCashFlow1	form	decimal	No
AdhocCashFlowAge2	form	int	No
AdhocCashFlow2	form	decimal	No
AdhocCashFlowAge3	form	int	No
AdhocCashFlow3	form	decimal	No
ApplySmile	form	bool	No

**GetContributionCashFlowRequest** Parameters:
Name	Parameter	Data Type	Required
KeyIndex	form	int	No
ContributionLabel	form	string	No
ApplyContribution	form	bool	No
Contribution	form	decimal	No
ContributionGrowth	form	decimal	No
ContributionGrowthFrequency	form	decimal	No
ContributionFrequency	form	int	No
ContributionStartYear	form	int	No
ContributionToLast	form	int	No

**GetRiskAbilityResponse** Parameters:
Name	Parameter	Data Type	Required
LiquidityNeeds	form	int	No
GoalTimeHorizon	form	int	No
RiskCapacity	form	int	No
TimeHorizonMessage	form	string	No
RiskCapacityMessage	form	string	No
LiquidityNeedsMessage	form	string	No
RiskProfile	form	string	No
RiskProfileId	form	int	No
GeneralMessage	form	string	No
Override	form	bool	No
OverrideMessage	form	string	No
OverrideRiskProfileId	form	int	No

To override the Content-type in your clients, use the HTTP Accept Header, append the .xml suffix or ?format=xml

HTTP + XML

The following are sample HTTP requests and responses. The placeholders shown need to be replaced with actual values.

POST /riskprofiles/calculate/riskability HTTP/1.1 
Host: api.portfoliolink.co.za 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<GetRiskAbility xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PortfolioLinkApi.ServiceModel">
  <Currency>String</Currency>
  <GetContributionCashFlowRequest>
    <ApplyContribution>false</ApplyContribution>
    <Contribution>0</Contribution>
    <ContributionFrequency>0</ContributionFrequency>
    <ContributionGrowth>0</ContributionGrowth>
    <ContributionGrowthFrequency>0</ContributionGrowthFrequency>
    <ContributionLabel>String</ContributionLabel>
    <ContributionStartYear>0</ContributionStartYear>
    <ContributionToLast>0</ContributionToLast>
    <KeyIndex>0</KeyIndex>
  </GetContributionCashFlowRequest>
  <GetIncomeCashFlowRequest>
    <AdhocCashFlow1>0</AdhocCashFlow1>
    <AdhocCashFlow2>0</AdhocCashFlow2>
    <AdhocCashFlow3>0</AdhocCashFlow3>
    <AdhocCashFlowAge1>0</AdhocCashFlowAge1>
    <AdhocCashFlowAge2>0</AdhocCashFlowAge2>
    <AdhocCashFlowAge3>0</AdhocCashFlowAge3>
    <ApplySmile>false</ApplySmile>
    <CurrentAge>0</CurrentAge>
    <HasAdhocCashFlow>false</HasAdhocCashFlow>
    <Income>0</Income>
    <IncomeGrowth>0</IncomeGrowth>
    <IncomeGrowthFrequency>0</IncomeGrowthFrequency>
    <IncomeIncludeZeroIncomeYears>false</IncomeIncludeZeroIncomeYears>
    <IncomeLabel>String</IncomeLabel>
    <IncomeToLast>0</IncomeToLast>
    <KeyIndex>0</KeyIndex>
    <PayoutFrequency>0</PayoutFrequency>
    <SmilePercentages xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:KeyValueOfintdecimal>
        <d3p1:Key>0</d3p1:Key>
        <d3p1:Value>0</d3p1:Value>
      </d3p1:KeyValueOfintdecimal>
    </SmilePercentages>
    <StartYear>0</StartYear>
    <TaxRate>0</TaxRate>
  </GetIncomeCashFlowRequest>
  <Goal xmlns:d2p1="http://schemas.datacontract.org/2004/07/PortfolioLinkApi.ServiceModel.Types">
    <d2p1:Currency>String</d2p1:Currency>
    <d2p1:GoalDescription>String</d2p1:GoalDescription>
    <d2p1:GoalHasTarget>false</d2p1:GoalHasTarget>
    <d2p1:GoalName>String</d2p1:GoalName>
    <d2p1:GoalTarget>0</d2p1:GoalTarget>
    <d2p1:GoalTargetAge>0</d2p1:GoalTargetAge>
    <d2p1:Type>PostRetirement</d2p1:Type>
    <d2p1:WrapperType>String</d2p1:WrapperType>
  </Goal>
  <GoalTimeHorizon>0</GoalTimeHorizon>
  <LiquidityNeeds>0</LiquidityNeeds>
  <LumpSum>0</LumpSum>
  <Override>false</Override>
  <OverrideMessage>String</OverrideMessage>
  <OverrideRiskProfileId>0</OverrideRiskProfileId>
  <RiskCapacity>0</RiskCapacity>
</GetRiskAbility>

HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetRiskAbilityResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PortfolioLinkApi.ServiceModel">
  <GeneralMessage>String</GeneralMessage>
  <GoalTimeHorizon>0</GoalTimeHorizon>
  <LiquidityNeeds>0</LiquidityNeeds>
  <LiquidityNeedsMessage>String</LiquidityNeedsMessage>
  <Override>false</Override>
  <OverrideMessage>String</OverrideMessage>
  <OverrideRiskProfileId>0</OverrideRiskProfileId>
  <RiskCapacity>0</RiskCapacity>
  <RiskCapacityMessage>String</RiskCapacityMessage>
  <RiskProfile>String</RiskProfile>
  <RiskProfileId>0</RiskProfileId>
  <TimeHorizonMessage>String</TimeHorizonMessage>
</GetRiskAbilityResponse>