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 .jsv suffix or ?format=jsv

HTTP + JSV

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: text/jsv
Content-Type: text/jsv
Content-Length: length

{
	clientId: 0
}
HTTP/1.1 200 OK
Content-Type: text/jsv
Content-Length: length

{
	result: 
	[
		{
			userId: String,
			portfolioId: 0,
			clientId: 0,
			clientFullName: String,
			clientIdNumber: String,
			clientPrimaryEmail: String,
			clientMobile: String,
			clientGoalId: 0,
			clientGoalResultsId: 0,
			goalName: String,
			portfolioName: String,
			status: String,
			inputLifeExpectancyAge: 0,
			inputCurrentSavingsDate: String,
			inputCurrentSavings: 0,
			inputExpectedInflationRate: 0,
			inputWithdrawalAmount: 0,
			inputWithdrawalGrowthRate: 0,
			cashReserve: 0,
			additionalSaProperty: 0,
			results: {},
			partnerSettings: 
			{
				id: 0,
				name: String,
				partnerId: 0,
				partnerLogoUrl: String,
				partnerBackgroundType: String,
				partnerBackgroundUrl: String,
				expectedInflationRate: 0,
				withdrawalIncomeGrowthRate: 0,
				hellosignapikey: String,
				enableCashReserve: False,
				enableProperty: False,
				partnerDefaultSettings: 
				{
					settingsId: 0,
					partnerId: 0,
					partnerName: String,
					aaType: String,
					themeId: 0,
					initialFee: 0,
					advisorFee: 0,
					platformFee: 0,
					moreLikelyZScore: 0,
					lessLikelyZScore: 0,
					showLowestProjectedOutcome: False,
					isFundAlphaEqualToFees: False,
					showAdvisoryFees: False,
					showCashflowTable: False,
					xAxisLabel: String,
					appearanceSettings: 
					{
						appearanceSchema: 
						{
							fontColor: String,
							axisColor: String,
							axisGridColor: String,
							graphColor: String,
							graphColorOpacity: 0,
							graphColorRange2: String,
							graphColorOpacity2: 0,
							averageLineColor: String,
							barColor1: String,
							barColor2: String,
							logoHeight: String,
							logoUrl: String,
							logoBackground: String,
							topBarBackground: String,
							topBarFontColor: String,
							h2Color: String,
							linkColor: String,
							proposalBackgroundUrl: String,
							proposalBackgroundUrl2: String,
							proposalBackgroundUrl3: String,
							proposalBackgroundUrl4: String
						},
						projectedComponentName: String,
						showMedianOutcome: False,
						medianLineColor: String,
						bottomScenarioLineColor: String,
						showLowestProjectedOutcome: False
					}
				},
				partnerContactDetails: 
				{
					website: String,
					email: String,
					telephone: String,
					fax: String,
					addressLine1: String,
					addressLine2: String,
					addressLine3: String,
					addressLine4: String
				}
			}
		}
	]
}