PortfolioLinkApi

<back to all web services

GetClientGoals

Requires Authentication
The following routes are available for this service:
All Verbs/client/goals
GetClientGoals Parameters:
NameParameterData TypeRequiredDescription
ClientIdqueryintNo
GetClientGoalsResponse Parameters:
NameParameterData TypeRequiredDescription
ResultformList<ClientGoalsView>No
ClientGoalsView Parameters:
NameParameterData TypeRequiredDescription
UserIdformstringNo
PortfolioIdformintNo
ClientIdformintNo
ClientFullNameformstringNo
ClientIdNumberformstringNo
ClientPrimaryEmailformstringNo
ClientMobileformstringNo
ClientGoalIdformintNo
ClientGoalResultsIdformintNo
GoalNameformstringNo
PortfolioNameformstringNo
StatusformstringNo
InputLifeExpectancyAgeformintNo
InputCurrentSavingsDateformstringNo
InputCurrentSavingsformdoubleNo
InputExpectedInflationRateformdoubleNo
InputWithdrawalAmountformdoubleNo
InputWithdrawalGrowthRateformdoubleNo
CashReserveformdoubleNo
AdditionalSaPropertyformdoubleNo
ResultsformObjectNo
PartnerSettingsformPartnerSettingsNo
PartnerSettings Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
NameformstringNo
PartnerIdformintNo
PartnerLogoUrlformstringNo
PartnerBackgroundTypeformstringNo
PartnerBackgroundUrlformstringNo
ExpectedInflationRateformdecimalNo
WithdrawalIncomeGrowthRateformdecimalNo
HellosignapikeyformstringNo
EnableCashReserveformboolNo
EnablePropertyformboolNo
PartnerDefaultSettingsformPartnerDefaultSettingsNo
PartnerContactDetailsformPartnerContactDetailsNo
PartnerDefaultSettings Parameters:
NameParameterData TypeRequiredDescription
SettingsIdformintNo
PartnerIdformintNo
PartnerNameformstringNo
AaTypeformstringNo
ThemeIdformintNo
InitialFeeformdecimalNo
AdvisorFeeformdecimalNo
PlatformFeeformdecimalNo
MoreLikelyZScoreformdecimalNo
LessLikelyZScoreformdecimalNo
ShowLowestProjectedOutcomeformboolNo
IsFundAlphaEqualToFeesformboolNo
ShowAdvisoryFeesformboolNo
ShowCashflowTableformboolNo
XAxisLabelformstringNo
AppearanceSettingsformAppearanceSettingsNo
AppearanceSettings Parameters:
NameParameterData TypeRequiredDescription
AppearanceSchemaformAppearanceSchemaNo
ProjectedComponentNameformstringNo
ShowMedianOutcomeformboolNo
MedianLineColorformstringNo
BottomScenarioLineColorformstringNo
ShowLowestProjectedOutcomeformboolNo
AppearanceSchema Parameters:
NameParameterData TypeRequiredDescription
FontColorformstringNo
AxisColorformstringNo
AxisGridColorformstringNo
GraphColorformstringNo
GraphColorOpacityformdoubleNo
GraphColorRange2formstringNo
GraphColorOpacity2formdoubleNo
AverageLineColorformstringNo
BarColor1formstringNo
BarColor2formstringNo
LogoHeightformstringNo
LogoUrlformstringNo
LogoBackgroundformstringNo
TopBarBackgroundformstringNo
TopBarFontColorformstringNo
H2ColorformstringNo
LinkColorformstringNo
ProposalBackgroundUrlformstringNo
ProposalBackgroundUrl2formstringNo
ProposalBackgroundUrl3formstringNo
ProposalBackgroundUrl4formstringNo
PartnerContactDetails Parameters:
NameParameterData TypeRequiredDescription
WebsiteformstringNo
EmailformstringNo
TelephoneformstringNo
FaxformstringNo
AddressLine1formstringNo
AddressLine2formstringNo
AddressLine3formstringNo
AddressLine4formstringNo

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 /client/goals HTTP/1.1 
Host: api.portfoliolink.co.za 
Accept: application/xml
Content-Type: application/xml
Content-Length: length

<GetClientGoals xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PortfolioLinkApi.ServiceModel">
  <ClientId>0</ClientId>
</GetClientGoals>
HTTP/1.1 200 OK
Content-Type: application/xml
Content-Length: length

<GetClientGoalsResponse xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/PortfolioLinkApi.ServiceModel">
  <Result xmlns:d2p1="http://schemas.datacontract.org/2004/07/SharedTypes">
    <d2p1:ClientGoalsView>
      <d2p1:AdditionalSaProperty>0</d2p1:AdditionalSaProperty>
      <d2p1:CashReserve>0</d2p1:CashReserve>
      <d2p1:ClientFullName>String</d2p1:ClientFullName>
      <d2p1:ClientGoalId>0</d2p1:ClientGoalId>
      <d2p1:ClientGoalResultsId>0</d2p1:ClientGoalResultsId>
      <d2p1:ClientId>0</d2p1:ClientId>
      <d2p1:ClientIdNumber>String</d2p1:ClientIdNumber>
      <d2p1:ClientMobile>String</d2p1:ClientMobile>
      <d2p1:ClientPrimaryEmail>String</d2p1:ClientPrimaryEmail>
      <d2p1:GoalName>String</d2p1:GoalName>
      <d2p1:InputCurrentSavings>0</d2p1:InputCurrentSavings>
      <d2p1:InputCurrentSavingsDate>String</d2p1:InputCurrentSavingsDate>
      <d2p1:InputExpectedInflationRate>0</d2p1:InputExpectedInflationRate>
      <d2p1:InputLifeExpectancyAge>0</d2p1:InputLifeExpectancyAge>
      <d2p1:InputWithdrawalAmount>0</d2p1:InputWithdrawalAmount>
      <d2p1:InputWithdrawalGrowthRate>0</d2p1:InputWithdrawalGrowthRate>
      <d2p1:PartnerSettings>
        <d2p1:EnableCashReserve>false</d2p1:EnableCashReserve>
        <d2p1:EnableProperty>false</d2p1:EnableProperty>
        <d2p1:ExpectedInflationRate>0</d2p1:ExpectedInflationRate>
        <d2p1:Hellosignapikey>String</d2p1:Hellosignapikey>
        <d2p1:Id>0</d2p1:Id>
        <d2p1:Name>String</d2p1:Name>
        <d2p1:PartnerBackgroundType>String</d2p1:PartnerBackgroundType>
        <d2p1:PartnerBackgroundUrl>String</d2p1:PartnerBackgroundUrl>
        <d2p1:PartnerContactDetails>
          <d2p1:AddressLine1>String</d2p1:AddressLine1>
          <d2p1:AddressLine2>String</d2p1:AddressLine2>
          <d2p1:AddressLine3>String</d2p1:AddressLine3>
          <d2p1:AddressLine4>String</d2p1:AddressLine4>
          <d2p1:Email>String</d2p1:Email>
          <d2p1:Fax>String</d2p1:Fax>
          <d2p1:Telephone>String</d2p1:Telephone>
          <d2p1:Website>String</d2p1:Website>
        </d2p1:PartnerContactDetails>
        <d2p1:PartnerDefaultSettings>
          <d2p1:AaType>String</d2p1:AaType>
          <d2p1:AdvisorFee>0</d2p1:AdvisorFee>
          <d2p1:AppearanceSettings>
            <d2p1:AppearanceSchema>
              <d2p1:AverageLineColor>String</d2p1:AverageLineColor>
              <d2p1:AxisColor>String</d2p1:AxisColor>
              <d2p1:AxisGridColor>String</d2p1:AxisGridColor>
              <d2p1:BarColor1>String</d2p1:BarColor1>
              <d2p1:BarColor2>String</d2p1:BarColor2>
              <d2p1:FontColor>String</d2p1:FontColor>
              <d2p1:GraphColor>String</d2p1:GraphColor>
              <d2p1:GraphColorOpacity>0</d2p1:GraphColorOpacity>
              <d2p1:GraphColorOpacity2>0</d2p1:GraphColorOpacity2>
              <d2p1:GraphColorRange2>String</d2p1:GraphColorRange2>
              <d2p1:H2Color>String</d2p1:H2Color>
              <d2p1:LinkColor>String</d2p1:LinkColor>
              <d2p1:LogoBackground>String</d2p1:LogoBackground>
              <d2p1:LogoHeight>String</d2p1:LogoHeight>
              <d2p1:LogoUrl>String</d2p1:LogoUrl>
              <d2p1:ProposalBackgroundUrl>String</d2p1:ProposalBackgroundUrl>
              <d2p1:ProposalBackgroundUrl2>String</d2p1:ProposalBackgroundUrl2>
              <d2p1:ProposalBackgroundUrl3>String</d2p1:ProposalBackgroundUrl3>
              <d2p1:ProposalBackgroundUrl4>String</d2p1:ProposalBackgroundUrl4>
              <d2p1:TopBarBackground>String</d2p1:TopBarBackground>
              <d2p1:TopBarFontColor>String</d2p1:TopBarFontColor>
            </d2p1:AppearanceSchema>
            <d2p1:BottomScenarioLineColor>String</d2p1:BottomScenarioLineColor>
            <d2p1:MedianLineColor>String</d2p1:MedianLineColor>
            <d2p1:ProjectedComponentName>String</d2p1:ProjectedComponentName>
            <d2p1:ShowLowestProjectedOutcome>false</d2p1:ShowLowestProjectedOutcome>
            <d2p1:ShowMedianOutcome>false</d2p1:ShowMedianOutcome>
          </d2p1:AppearanceSettings>
          <d2p1:InitialFee>0</d2p1:InitialFee>
          <d2p1:IsFundAlphaEqualToFees>false</d2p1:IsFundAlphaEqualToFees>
          <d2p1:LessLikelyZScore>0</d2p1:LessLikelyZScore>
          <d2p1:MoreLikelyZScore>0</d2p1:MoreLikelyZScore>
          <d2p1:PartnerId>0</d2p1:PartnerId>
          <d2p1:PartnerName>String</d2p1:PartnerName>
          <d2p1:PlatformFee>0</d2p1:PlatformFee>
          <d2p1:SettingsId>0</d2p1:SettingsId>
          <d2p1:ShowAdvisoryFees>false</d2p1:ShowAdvisoryFees>
          <d2p1:ShowCashflowTable>false</d2p1:ShowCashflowTable>
          <d2p1:ShowLowestProjectedOutcome>false</d2p1:ShowLowestProjectedOutcome>
          <d2p1:ThemeId>0</d2p1:ThemeId>
          <d2p1:XAxisLabel>String</d2p1:XAxisLabel>
        </d2p1:PartnerDefaultSettings>
        <d2p1:PartnerId>0</d2p1:PartnerId>
        <d2p1:PartnerLogoUrl>String</d2p1:PartnerLogoUrl>
        <d2p1:WithdrawalIncomeGrowthRate>0</d2p1:WithdrawalIncomeGrowthRate>
      </d2p1:PartnerSettings>
      <d2p1:PortfolioId>0</d2p1:PortfolioId>
      <d2p1:PortfolioName>String</d2p1:PortfolioName>
      <d2p1:Results />
      <d2p1:Status>String</d2p1:Status>
      <d2p1:UserId>String</d2p1:UserId>
    </d2p1:ClientGoalsView>
  </Result>
</GetClientGoalsResponse>