PortfolioLinkApi

<back to all web services

GetClientV2

Requires Authentication
The following routes are available for this service:
All Verbs/v2/clients/{Id}
GetClientV2 Parameters:
NameParameterData TypeRequiredDescription
IdpathintNo
GetClientV2Response Parameters:
NameParameterData TypeRequiredDescription
ResultformClientViewNo
ClientView Parameters:
NameParameterData TypeRequiredDescription
IdformintNo
UserIdformstringNo
PartnerIdformintNo
PrimaryEmailformstringNo
SecondaryEmailformstringNo
FirstNameformstringNo
MiddleNamesformstringNo
LastNameformstringNo
FullNameformstringNo
AliasformstringNo
PhoneformstringNo
MobileformstringNo
IdNumberformstringNo
StatusformstringNo
ClientTypeformstringNo
BirthdaySkformstringNo
BirthdayformDateTimeNo
CreatedAsAtformDateTimeNo
UpdatedAsAtformDateTimeNo
GoalsformList<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 /v2/clients/{Id} HTTP/1.1 
Host: api.portfoliolink.co.za 
Accept: text/jsv
Content-Type: text/jsv
Content-Length: length

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

{
	result: 
	{
		id: 0,
		userId: String,
		partnerId: 0,
		primaryEmail: String,
		secondaryEmail: String,
		firstName: String,
		middleNames: String,
		lastName: String,
		fullName: String,
		alias: String,
		phone: String,
		mobile: String,
		idNumber: String,
		status: String,
		clientType: String,
		birthdaySk: String,
		birthday: 0001-01-01,
		createdAsAt: 0001-01-01,
		updatedAsAt: 0001-01-01,
		goals: 
		[
			{
				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
					}
				}
			}
		]
	}
}