Introduction

The Praemium Application Programming Interface (API) enables your organisation to access account, investment, investor or model information from our systems securely and on demand. This can be used in a batch or real-time nature depending on your needs and data lifecycle.

This site provides you with full details of each of the endpoints in the API, including parameters, validation tips, and what to expect in our response.

If you are interested in using our API please contact your relationship manager or support team. They can answer any queries you may have and ensure all our compliance and contractual requirements are met. If you are not currently a customer, please register your interest with our sales team by visiting your local contact page https://www.praemium.com/

After your request to use our API has been approved, you're ready to start developing, please contact our Client Services team to obtain credentials that allows access to our test environment. Once your application is fully developed, you can request credentials for the Production environment. We have a number of different endpoints available, below is a summary of the endpoint availability based on our products, roles and regions:

	Read	Read/Create	Enterprise
Account	✔	✔	✔
Performance	✔	✔	✔
Tax	✔	✔	✔
Transactions	✔	✔	✔
Income	✔	✔	✔
Expenses	✔	✔	✔
Reports and Files	✔	✔	✔
Single Sign On (SSO)	✔	✔	✔
Product Information (PDS)		✔	✔
User Management		✔	✔
Linking Users		✔	✔
Draft Applications		✔	✔
Bulk and Bespoke Routes			✔

If there are any endpoints that you require and we have not listed, please contact for further information. Alternatively our Upload Centre and automatic file/data exchange (via SFTP or other supported protocols) is available for the bulk collection of data or management of users, accounts or settings.

	Investment Manager specific API functionality
Investment Models	✔
Investment Model management	✔

Investment or Model Managers can access and manage their models within the system via a specialised set of APIs. This includes the setting or updating of investment selection, accessing model FUM, Performance and other information.

Versioning

Specifying a Version

The API is versioned so that we can continually release new features and improvements without affecting existing implementations.

To specify the API version, simply add the HTTP header x-pps-api-version to each request as shown below:

x-pps-api-version: v1

Documentation related to previous versions can be found here.

Product Subscription

Product subscription key is required for accessing corresponding endpoints and should be added to your request as below:

x-pps-subscription-key: d3e30ecd1ab345...

Please log into our developer portal to subscribe to a product and generate corresponding product subscription key.

Authorisation

In order to access the Premium API, you will need to be granted a OAuth 2.0 client to authenticate and authorise your application.

Applications that try to access the API without a valid access token will receive a 403 (Forbidden) response.

To make calls to the API, get access token via our token endpoint and add access token as the Authorization header value in each HTTP request.

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...

POST Access Token

Definition: https://api.onpraemium.com/api/token

This endpoint returns access token that can be used to access public API endpoints.

Header Examples

Content-Type: application/x-www-form-urlencoded

Header Parameters

Parameter	Type	Description
Content-Typerequired	string	Must be application/x-www-form-urlencoded

Request Parameter - Body Examples

client_id=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX&client_secret=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Request Parameter - Body

Parameter	Type	Description
Client_idrequired	string	OAuth 2.0 client ID provided by Praemium.
Client_secretrequired	string	OAuth 2.0 client secret provided by Praemium.

Response Examples

# 200 - OK
{
    "token_type": "Bearer",
    "expires_in": 3599,
    "ext_expires_in": 3599,
    "access_token": "eyJ0eXAiOiJKV1QiLCJhbGc..."
}

Response Parameters

Parameter	Type	Description
token_type	string	Token type is always Bearer.
expires_in	integer	After how many seconds an access token will expire.
ext_expires_in	integer	Extended lifetime of access token if value of this field is greater than value of expires_in.
access_token	string	Access token that can be used to access public API endpoints.

PDS

GET PDS

Definition: https://api.onpraemium.com/api/pds

This endpoint returns the PDS details for the service.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Response Examples

# 200 - OK (AU response)
[
  {
    "Id": "AU1",
    "Name": "Praemium Managed Accounts",
    "MaxNoOfBankAccounts": 5,
    "IsSuperSma": false,
    "Status": "Active",
    "Region": "Australia",
    "Models": [
      {
        "Id": "AU2710",
        "Name": "CKI HOLDINGS ORD",
        "Style": "",
        "Code": "1038.HKG"
      }
    ],
    "Fees": [
      {
        "Type": "Establishment",
        "Class": "Adviser",
        "Name": "Establishment Fee",
        "DollarOverwriteSettings": {
          "MinAmount": 0.0,
          "MaxAmount": 90909.0909,
          "MinAmountWithTax": 0.0,
          "MaxAmountWithTax": 100000.0
        },
        "DefaultValue": 0.0,
        "DefaultValueWithTax": 0.0,
        "DefaultType": "Dollar"
      }
      {
        "Id": "AU32",
        "Type": "FeeTable",
        "Class": "NonAdviser",
        "Name": "SMA Administration Fee",
        "Tiers": [
          {
            "ValueAppliedFrom": 0.0,
            "FeePercent": 0.336364,
            "FeePercentWithTax": 0.37
          },
          {
            "ValueAppliedFrom": 250001.0,
            "FeePercent": 0.272727,
            "FeePercentWithTax": 0.3
          },
          {
            "ValueAppliedFrom": 500001.0,
            "FeePercent": 0.181818,
            "FeePercentWithTax": 0.2
          },
          {
            "ValueAppliedFrom": 1000001.0,
            "FeePercent": 1E-10,
            "FeePercentWithTax": 0.0
          }
        ],
        "DefaultValue": 0.336364,
        "DefaultValueWithTax": 0.37,
        "DefaultType": "Percent",
        "IndexationSettings": {
          "Type": "Both",
          "TypeAllowed": "Both",
          "Value": 0.0,
          "ValueMax": 0.0
        }
      }
    ],
    "BankAccountUsages": [
      {
        "Usage": "SMAFEE",
        "Description": "Fee offset",
        "IsMandatory": false,
        "HelpText": "If no bank account is selected, fees will be deducted from your cash holding."
      }
    ],
    "TaxOptions": [
      {
        "Code": "WTFN",
        "Description": "Resident with TFN"
      }
    ]
  }
]

# 200 - OK (UK response)
[
  {
    "Id": "UK87",
    "Name": "Westminster - US GBP",
    "MaxNoOfBankAccounts": 0,
    "DisableCustomisations": false,
    "IsSuperSma": false,
    "ServiceId": "UK1000000112",
    "ServiceName": "PIL  DPS GBP",
    "Region": "International",
    "Models": [
      {
        "Id": "UK1000001282",
        "Name": "LGT Vestra US Ethical",
        "Style": "MAM",
        "Code": "LGT Vestra Ethical",
        "ManagerName": "Model Manager Firm 5192",
        "FeeOverride": {
          "Value": 0.0,
          "IsTiered": false
        }
      }
    ],
    "Fees": [
      {
        "Id": "UK1",
        "Type": "Establishment",
        "Class": "Adviser",
        "Name": "Initial Investment",
        "DollarOverwriteSettings": {
          "MinAmount": 0.0,
          "MaxAmount": 0.5,
          "MinAmountWithTax": 0.0,
          "MaxAmountWithTax": 0.5
        },
        "PercentOverwriteSettings": {
          "MinAmount": 0.0,
          "MaxAmount": 0.5,
          "MinAmountWithTax": 0.0,
          "MaxAmountWithTax": 0.5
        },
        "DefaultValue": 0.0,
        "DefaultValueWithTax": 0.0,
        "DefaultType": "Percent"
      }
    ],
    "BankAccountUsages": [
      {
        "Usage": "CASHCON",
        "Description": "Initial Contribution",
        "IsMandatory": false,
        "HelpText": "This is bank account we will user for your initial payment."
      }
    ],
    "TaxOptions": [
      {
        "Code": "Standard Income Bracket",
        "Description": "The standard income bracket for most investors."
      }
    ],
    "CurrencyCode": "GBP",
    "AvailableAccountTypes": [
      11,
      10,
      13,
      28,
      0,
      12,
      18,
      15,
      19,
      14,
      17,
      26,
      16
    ],
    "Products": [
      {
        "Id": "UK1",
        "IsSingleBankAccount": false,
        "ProductProviderName": "Talbot & Muir",
        "ProductName": "TM SIPP",
        "TaxWrapperId": 9,
        "AvailableModelCodes": [
          "LGT Vestra Ethical",
          "LGT VUSHRGBP",
          "LGT VUSISA",
          "LGT VUSLRGBP",
          "LGT VUSMRGBP",
          "Managed Account Cash GBP",
          "WavertonUSBalPortGBP",
          "WavertonUSCauPortGBP",
          "WavertonUSGroPortGBP",
          "WavertonUSISA"
        ],
        "DisableAdviserFeesUk": false,
        "DisableAdviserFeesInternational": false
      }
    ]
  }
]

Response Parameters

Parameter	Type	Description
Id	string	ID of the PDS.
Name	string	Name of the PDS.
MaxNoOfBankAccounts	integer	Maximum number of bank accounts allowed by the PDS.
IsSuperSma	boolean	If the PDS is specific to SuperSMA.
Status	string	Status of the PDS, active = 1, closed = 2.
ServiceId	string	Service ID.
ServiceName	string	Service Name.
Region	integer	Australia, UnitedKingdom or International.
CurrencyCode	string	Currency code for the PDS.
Fees	array	Fees associated to the PDS.
Fees.Id	string	ID of fee.
Fees.Type	enum	FeeTable = 0, Contribution = 1, Establishment = 2, Termination = 3, Withdrawal = 4, Ongoing = 5.
Fees.Class	enum	Adviser = 1, NonAdviser = 2.
Fees.Name	string	Name of fee.
Fees.Tiers	array	Tiers of fee.
Fees.Tiers.ValueAppliedFrom	double	The value is applied from.
Fees.Tiers.FeePercent	double	Fee percent.
Fees.Tiers.FeePercentWithTax	double	Fee percent with tax.
Fees.DollarOverwriteSettings	object	Dollar overwrite settings.
Fees.DollarOverwriteSettings.MinAmount	double	Fee overwrite minimum amount.
Fees.DollarOverwriteSettings.MaxAmount	double	Fee overwrite maximum amount.
Fees.DollarOverwriteSettings.MinAmountWithTax	double	Fee overwrite minimum amount with tax.
Fees.DollarOverwriteSettings.MaxAmountWithTax	double	Fee overwrite maximum amount with tax.
Fees.PercentOverwriteSettings	object	Percent overwrite settings.
Fees.PercentOverwriteSettings.MinAmount	double	Fee overwrite minimum amount.
Fees.PercentOverwriteSettings.MaxAmount	double	Fee overwrite maximum amount.
Fees.PercentOverwriteSettings.MinAmountWithTax	double	Fee overwrite minimum amount with tax.
Fees.PercentOverwriteSettings.MaxAmountWithTax	double	Fee overwrite maximum amount with tax.
Fees.DefaultValue	double	Default value of overwrite.
Fees.DefaultValueWithTax	double	Default value of overwrite with tax.
Fees.DefaultType	enum	Dollar = 1, Percent = 2.
Fees.IndexationSettings	object	Indexation settings.
Fees.IndexationSettings.Type	enum	None = 0, Both = 0, Cpi = 1, Custom = 2.
Fees.IndexationSettings.TypeAllowed	enum	None = 0, Both = 0, Cpi = 1, Custom = 2.
Fees.IndexationSettings.Value	double	Fee indexation value.
Fees.IndexationSettings.ValueMax	double	Fee indexation maximum value.
BankAccountUsages	array	This allows you to define a regular cash addition or withdrawal from the SMA or SuperSMA.
BankAccountUsages.Usage	string	This allows you to define a regular cash addition or withdrawal from the account.
BankAccountUsages.Description	string	This will advise the bank account usage.
BankAccountUsages.IsMandatory	boolean	If the bank account is mandatory, true or false.
BankAccountUsages.HelpText	string	Help text with regards to the bank account.
TaxOptions	array	Tax options for the PDS.
TaxOptions.Code	string	Tax Option code.
TaxOptions.Description	string	Tax option description.
Models	array	List of available models.
Models.Id	string	ModelId as returned by the Models endpoint.
Models.Name	string	Model name.
Models.Style	string	Model style.
Models.Code	string	Model code.
Models.ManagerName	string	Model Manager name.
Models.FeeOverride	object	Fee override.
Models.FeeOverride.Name	string	Name of the fee override.
Models.FeeOverride.Id	string	Fee override ID.
Models.FeeOverride.Value	double	Fee override value.
Models.FeeOverride.IsTiered	boolean	If the fee override is tiered.
Models.FeeOverride.Tiers	array	The fee override tier if applicable.
Models.FeeOverride.Tiers.From	double	Value from which the fee tier is applicable.
Models.FeeOverride.Tiers.Percentage	double	Fee percentage.
AvailableAccountTypes	array	Standard = 0, OffshoreBond = 10, Sipp = 11, Qrops = 12, RtsRats = 13, Pra = 14, Isa = 15, Gia = 16, Pera = 17, PersonalPension = 18, GroupSipp = 19, Jisa = 26, OnshoreBond = 27, OffshoreBondPersonalised = 28.
Products	array	Products for the PDS.
Products.Id	string	Product ID.
Products.IsSingleBankAccount	boolean	Is a single bank account, true or false.
Products.ProductProviderName	string	Product provider name.
Products.ProductName	string	Product name.
Products.TaxWrapperId	integer	Tax wrapper ID. CgtChargeable = 1, TaxExempt = 2, Isa = 4, OffshoreBond = 5, OnshoreBond = 6, PersonalPension = 7, RtsRats = 8, Sipp = 9, GroupSipp = 10, Ssas = 11, S32 = 12, TrustNotUkTaxable = 13, CompanyNotUkTaxable = 14, Qnups = 15, Qrops = 16, Efurbs = 17, Ebt = 18, Jisa = 20, OffshoreBondPersonalised = 21.
Products.AvailableModelCodes	array	List of available model codes.
Products.DisableAdviserFeesUk	boolean	Disable adviser fees UK.
Products.DisableAdviserFeesInternational	boolean	Disable adviser fees International.

Applications

POST Individual Applicant & Individual Account - AU

Definition: https://api.onpraemium.com/api/application

This endpoint creates a individual applicant and account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 0,
      "IndividualDetails": {
        "Title": "Mr",
        "FirstName": "John",
        "LastName": "Smith",
        "Email": "j.smith@example.com",
        "Phone": "012489235",
        "PhoneOther": "012489235",
        "Gender": 1,
        "HomeAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "MailingAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "Identifications": [
          {
            "Type": 0,
            "Value": "123456789"
          },
          {
            "MissingReason": 1,
            "MissingReasonText": "test"
          }
        ],
        "IsPoliticallyExposedPerson": true,
        "PepDetails": "Senior politician"
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Miss Jane Smith",
      "RegisteredName": "Miss Jane Smith",
      "ShortName": "Jane",
      "AccountType": 14,
      "PdsId": "AU5",
      "Fees": [
        {
          "Id": "AU21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "AU0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "Bsb": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith",
          "Usages": [
            "Income",
            "CashContribution"
          ]
        }
      ],
      "Exclusions": [
        {
          "Code": "AU0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestment": {
        "Cash": 132.12,
        "Shares": 321.32,
        "Method": 0
      }
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Individual = 0.
Applicants.IndividualDetails	object	Used for Individual applicants.
Applicants.IndividualDetails.Title	string	Title: Mr, Mrs, Ms, Miss, Doctor, Lady, Prof and Sir.
Applicants.IndividualDetails.FirstName	string	First name of individual.
Applicants.IndividualDetails.LastName	string	Last name of individual.
Applicants.IndividualDetails.DateOfBirth	date-time	Date of birth of the individual.
Applicants.IndividualDetails.Email	string	Email address of the individual.
Applicants.IndividualDetails.Phone	string	Primary contact number of the individual.
Applicants.IndividualDetails.PhoneOther	string	Other phone of the individual.
Applicants.IndividualDetails.Genderrequired	enum	Male = 1, Female = 2.
Applicants.IndividualDetails.UserName	string	User Name of individual applicant.
Applicants.IndividualDetails.UserId	string	User ID of individual applicant.
Applicants.IndividualDetails.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.IndividualDetails.PepDetails	string	If applicant is politically exposed, details must be supplied.
Applicants.IndividualDetails.TaxResidenceCountryCode	string	Tax residence country code.
Applicants.IndividualDetails.CitizenshipCountryCode	string	Citizenship country code.
Applicants.IndividualDetails.Identifications	array	Array of TFN / ABN.
Applicants.IndividualDetails.Identifications.Type	enum	Tfn = 0, Tin = 2.
Applicants.IndividualDetails.Identifications.Value	string	Identification value of applicant.
Applicants.IndividualDetails.Identifications.MissingReason	enum	CountryDoesntIssue = 1, DontNeedOne = 2, Other = 99.
Applicants.IndividualDetails.Identifications.MissingReasonText	string	Reason identification of applicant is missing.
Applicants.IndividualDetails.HomeAddress	object	Home address of individual applicant.
Applicants.IndividualDetails.HomeAddress.Street	string	Address line 1.
Applicants.IndividualDetails.HomeAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.HomeAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.HomeAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.HomeAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.HomeAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.HomeAddress.IsRegistered	boolean	Whether address is registered.
Applicants.IndividualDetails.MailingAddress	object	Mailing address of individual applicant.
Applicants.IndividualDetails.MailingAddress.Street	string	Address line 1.
Applicants.IndividualDetails.MailingAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.MailingAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	Individual = 14.
Accounts.PdsId	string	PDS ID of account.
Accounts.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Models	array	Account models.
Accounts.Models.Code	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.Bsb	string	Bank account BSB.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Usages	array	This allows you to define a regular cash addition or withdrawal from the SMA or SuperSMA.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Code	string	Security code of the security.
Accounts.Exclusions.Security.Exchange	string	Exchange code of the security.
Accounts.InitialInvestment	object	Initial investment of account.
Accounts.InitialInvestment.Cash	double	Select if the initial investment will include cash.
Accounts.InitialInvestment.Shares	double	Select if the initial investment will include shares.
Accounts.InitialInvestment.Methodrequired	enum	BPay = 0, DirectDebit = 1.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Corporate Applicant & Company Account - AU

Definition: https://api.onpraemium.com/api/application

This endpoint creates a corporate applicant and account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 1,
      "CorporateDetails": {
        "Name": "Smith & Smith",
        "BusinessAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "ContactIsSignatory": false,
        "Contact": {
          "Title": "Mr",
          "FirstName": "John",
          "LastName": "Smith",
          "Phone": "012489235",
          "Email": "j.smith@example.com"
        },
        "Signatories": [
          {
            "Title": "Mr",
            "FirstName": "John",
            "LastName": "Smith",
            "Email": "j.smith@example.com",
            "Capacity": 0,
            "IsPoliticallyExposedPerson": false
          }
        ],
        "Identifications": [
          {
            "Type": 1,
            "Value": "123456789"
          }
        ]
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Test company",
      "RegisteredName": "Test company",
      "ShortName": "TC",
      "AccountType": 13,
      "PdsId": "AU5",
      "Fees": [
        {
          "Id": "AU21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "AU0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "Bsb": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith",
          "Usages": [
            "Income",
            "CashContribution"
          ]
        }
      ],
      "Exclusions": [
        {
          "Code": "AU0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestment": {
        "Cash": 132.12,
        "Shares": 321.32,
        "Method": 0
      }
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Corporate = 1.
Applicants.CorporateDetails	object	Used for Corporate applicants.
Applicants.CorporateDetails.Name	string	Name of the corporate applicant.
Applicants.CorporateDetails.TradingName	string	Trading name of the corporate applicant.
Applicants.CorporateDetails.Identifications	array	Array of TFN / ABN
Applicants.CorporateDetails.Identifications.Type	enum	Tfn = 0, Abn = 1.
Applicants.CorporateDetails.Identifications.Value	string	Identification value of applicant.
Applicants.CorporateDetails.BusinessAddress	object	Business address.
Applicants.CorporateDetails.BusinessAddress.Street	string	Address line 1.
Applicants.CorporateDetails.BusinessAddress.Line2	string	Address line 2.
Applicants.CorporateDetails.BusinessAddress.Line3	string	Address line 3.
Applicants.CorporateDetails.BusinessAddress.Postcode	string	Postcode of address.
Applicants.CorporateDetails.BusinessAddress.Suburb	string	Suburb of address.
Applicants.CorporateDetails.BusinessAddress.CountryCode	string	Country code of address.
Applicants.CorporateDetails.BusinessAddress.IsRegistered	boolean	Whether address is registered.
Applicants.CorporateDetails.MailingAddress	object	Mailing address.
Applicants.CorporateDetails.MailingAddress.Street	string	Address line 1.
Applicants.CorporateDetails.MailingAddress.Line2	string	Address line 2.
Applicants.CorporateDetails.MailingAddress.Line3	string	Address line 3.
Applicants.CorporateDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.CorporateDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.CorporateDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.CorporateDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Applicants.CorporateDetails.ContactIsSignatory	boolean	Whether the contact is a signatory on the account.
Applicants.CorporateDetails.Contact	object	Primary contact.
Applicants.CorporateDetails.Contact.Title	string	Title of contact.
Applicants.CorporateDetails.Contact.FirstName	string	First name of contact.
Applicants.CorporateDetails.Contact.LastName	string	Last name of contact.
Applicants.CorporateDetails.Contact.Email	string	Email of contact.
Applicants.CorporateDetails.Contact.Phone	string	Phone Number of contact.
Applicants.CorporateDetails.Signatories	array	Corporate signatories.
Applicants.CorporateDetails.Signatories.Title	string	Title of signatory.
Applicants.CorporateDetails.Signatories.FirstName	string	First name of signatory.
Applicants.CorporateDetails.Signatories.LastName	string	Last name of signatory.
Applicants.CorporateDetails.Signatories.DateOfBirth	date-time	Date of birth of signatory.
Applicants.CorporateDetails.Signatories.Email	string	Email address of signatory.
Applicants.CorporateDetails.Signatories.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.CorporateDetails.Signatories.PepDetails	string	If applicant is politically exposed, details must be supplied.
Applicants.CorporateDetails.Signatories.Capacity	enum	Director = 0, SoleDirector = 1, CompanySecretary = 2.
Applicants.CorporateDetails.Signatories.TaxNumber	string	Tax number of signatory.
Applicants.CorporateDetails.Signatories.CountryOfBirth	string	Country of birth of signatory.
Applicants.CorporateDetails.Signatories.Address	object	Address of signatory.
Applicants.CorporateDetails.Signatories.Address.Street	string	Address line 1.
Applicants.CorporateDetails.Signatories.Address.Line2	string	Address line 2.
Applicants.CorporateDetails.Signatories.Address.Line3	string	Address line 3.
Applicants.CorporateDetails.Signatories.Address.Postcode	string	Postcode of address.
Applicants.CorporateDetails.Signatories.Address.Suburb	string	Suburb of address.
Applicants.CorporateDetails.Signatories.Address.CountryCode	string	Country code of address.
Applicants.CorporateDetails.Signatories.Address.IsRegistered	boolean	Whether address is registered.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	Company = 13.
Accounts.PdsId	string	PDS ID of account.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Models	array	Account models.
Accounts.Models.Code	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.Bsb	string	Bank account BSB.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Usages	array	This allows you to define a regular cash addition or withdrawal from the SMA or SuperSMA.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Code	string	Security code of the security.
Accounts.Exclusions.Security.Exchange	string	Exchange code of the security.
Accounts.InitialInvestment	object	Initial investment of account.
Accounts.InitialInvestment.Cash	double	Select if the initial investment will include cash.
Accounts.InitialInvestment.Shares	double	Select if the initial investment will include shares.
Accounts.InitialInvestment.Methodrequired	enum	BPay = 0, DirectDebit = 1.
Accounts.OwnerAdviserId	integer	Owner adviser ID to create the application under.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Individual Applicant & Trust Account - AU

Definition: https://api.onpraemium.com/api/application

This endpoint creates a individual applicant and a Trust account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 0,
      "IndividualDetails": {
        "Title": "Mr",
        "FirstName": "John",
        "LastName": "Smith",
        "Email": "j.smith@example.com",
        "Phone": "012489235",
        "PhoneOther": "012489235",
        "Gender": 1,
        "HomeAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "MailingAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "Identifications": [
          {
            "Type": 0,
            "Value": "123456789"
          },
          {
            "MissingReason": 1,
            "MissingReasonText": "test"
          }
        ],
        "IsPoliticallyExposedPerson": true,
        "PepDetails": "Senior politician"
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Miss Jane Smith",
      "RegisteredName": "Miss Jane Smith",
      "ShortName": "Jane",
      "AccountType": 14,
      "PdsId": "AU5",
      "Fees": [
        {
          "Id": "AU21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "AU0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "Bsb": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith",
          "Usages": [
            "Income",
            "CashContribution"
          ]
        }
      ],
      "Exclusions": [
        {
          "Code": "AU0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestment": {
        "Cash": 132.12,
        "Shares": 321.32,
        "Method": 0
      },
      "TrustOrFundDetails": {
        "Name": "Fund name",
        "Abn": "12345678",
        "Tfn": "12345678"
      },
      "TargetAllocation": {
        "Fees": [
          {
            "Code": "AB0101",
            "Percentage": 100
          }
        ],
        "Income": []
      }
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Individual = 0.
Applicants.IndividualDetails	object	Used for Individual applicants.
Applicants.IndividualDetails.Title	string	Title: Mr, Mrs, Ms, Miss, Doctor, Lady, Prof and Sir.
Applicants.IndividualDetails.FirstName	string	First name of individual.
Applicants.IndividualDetails.LastName	string	Last name of individual.
Applicants.IndividualDetails.DateOfBirth	date-time	Date of birth of the individual.
Applicants.IndividualDetails.Email	string	Email address of the individual.
Applicants.IndividualDetails.Phone	string	Primary contact number of the individual.
Applicants.IndividualDetails.PhoneOther	string	Other phone of the individual.
Applicants.IndividualDetails.Genderrequired	enum	Male = 1, Female = 2.
Applicants.IndividualDetails.UserName	string	User Name of individual applicant.
Applicants.IndividualDetails.UserId	string	User ID of individual applicant.
Applicants.IndividualDetails.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.IndividualDetails.PepDetails	string	If applicant is politically exposed, details must be supplied.
Applicants.IndividualDetails.TaxResidenceCountryCode	string	Tax residence country code.
Applicants.IndividualDetails.CitizenshipCountryCode	string	Citizenship country code.
Applicants.IndividualDetails.Identifications	array	Array of TFN / ABN.
Applicants.IndividualDetails.Identifications.Type	enum	Tfn = 0, Tin = 2.
Applicants.IndividualDetails.Identifications.Value	string	Identification value of applicant.
Applicants.IndividualDetails.Identifications.MissingReason	enum	CountryDoesntIssue = 1, DontNeedOne = 2, Other = 99.
Applicants.IndividualDetails.Identifications.MissingReasonText	string	Reason identification of applicant is missing.
Applicants.IndividualDetails.HomeAddress	object	Home address of individual applicant.
Applicants.IndividualDetails.HomeAddress.Street	string	Address line 1.
Applicants.IndividualDetails.HomeAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.HomeAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.HomeAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.HomeAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.HomeAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.HomeAddress.IsRegistered	boolean	Whether address is registered.
Applicants.IndividualDetails.MailingAddress	object	Mailing address of individual applicant.
Applicants.IndividualDetails.MailingAddress.Street	string	Address line 1.
Applicants.IndividualDetails.MailingAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.MailingAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	Trust = 15.
Accounts.PdsId	string	PDS ID of account.
Accounts.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Models	array	Account models.
Accounts.Models.Code	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.Bsb	string	Bank account BSB.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Usages	array	This allows you to define a regular cash addition or withdrawal from the SMA or SuperSMA.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Code	string	Security code of the security.
Accounts.Exclusions.Security.Exchange	string	Exchange code of the security.
Accounts.InitialInvestment	object	Initial investment of account.
Accounts.InitialInvestment.Cash	double	Select if the initial investment will include cash.
Accounts.InitialInvestment.Shares	double	Select if the initial investment will include shares.
Accounts.InitialInvestment.Methodrequired	enum	BPay = 0, DirectDebit = 1.
Accounts.TrustOrFundDetails	object	Trust or Fund details.
Accounts.TrustOrFundDetails.Name	string	Name of the Trust or Fund.
Accounts.TrustOrFundDetails.Abn	string	ABN of the Super Fund (rather than the corporate trustee) for corporate applicants.
Accounts.TrustOrFundDetails.Tfn	string	TFN for an individual trustee.
Accounts.TargetAllocation	object	Target allocation.
Accounts.TargetAllocation.Fees	array	Target allocation fees.
Accounts.TargetAllocation.Fees.Code	string	Target allocation fees code.
Accounts.TargetAllocation.Fees.Percentage	double	Target allocation fees percentage.
Accounts.TargetAllocation.Income	array	Target allocation income.
Accounts.TargetAllocation.Income.Code	string	Target allocation income code.
Accounts.TargetAllocation.Income.Percentage	double	Target allocation income percentage.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Corporate Applicant & Company Account - AU

Definition: https://api.onpraemium.com/api/application

This endpoint creates a corporate applicant and company account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 1,
      "CorporateDetails": {
        "Name": "Smith & Smith",
        "BusinessAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "ContactIsSignatory": false,
        "Contact": {
          "Title": "Mr",
          "FirstName": "John",
          "LastName": "Smith",
          "Phone": "012489235",
          "Email": "j.smith@example.com"
        },
        "Signatories": [
          {
            "Title": "Mr",
            "FirstName": "John",
            "LastName": "Smith",
            "Email": "j.smith@example.com",
            "Capacity": 0,
            "IsPoliticallyExposedPerson": false
          }
        ],
        "Identifications": [
          {
            "Type": 1,
            "Value": "123456789"
          }
        ]
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Test company",
      "RegisteredName": "Test company",
      "ShortName": "TC",
      "AccountType": 13,
      "PdsId": "AU5",
      "Fees": [
        {
          "Id": "AU21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "AU0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "Bsb": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith",
          "Usages": [
            "Income",
            "CashContribution"
          ]
        }
      ],
      "Exclusions": [
        {
          "Code": "AU0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestment": {
        "Cash": 132.12,
        "Shares": 321.32,
        "Method": 0
      },
      "TrustOrFundDetails": {
        "Name": "Fund name",
        "Abn": "12345678",
        "Tfn": "12345678"
      },
      "TargetAllocation": {
        "Fees": [
          {
            "Code": "AB0101",
            "Percentage": 100
          }
        ],
        "Income": []
      }
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Corporate = 1.
Applicants.CorporateDetails	object	Used for Corporate applicants.
Applicants.CorporateDetails.Name	string	Name of the corporate applicant.
Applicants.CorporateDetails.TradingName	string	Trading name of the corporate applicant.
Applicants.CorporateDetails.Identifications	array	Array of TFN / ABN
Applicants.CorporateDetails.Identifications.Type	enum	Tfn = 0, Abn = 1.
Applicants.CorporateDetails.Identifications.Value	string	Identification value of applicant.
Applicants.CorporateDetails.BusinessAddress	object	Business address.
Applicants.CorporateDetails.BusinessAddress.Street	string	Address line 1.
Applicants.CorporateDetails.BusinessAddress.Line2	string	Address line 2.
Applicants.CorporateDetails.BusinessAddress.Line3	string	Address line 3.
Applicants.CorporateDetails.BusinessAddress.Postcode	string	Postcode of address.
Applicants.CorporateDetails.BusinessAddress.Suburb	string	Suburb of address.
Applicants.CorporateDetails.BusinessAddress.CountryCode	string	Country code of address.
Applicants.CorporateDetails.BusinessAddress.IsRegistered	boolean	Whether address is registered.
Applicants.CorporateDetails.MailingAddress	object	Mailing address.
Applicants.CorporateDetails.MailingAddress.Street	string	Address line 1.
Applicants.CorporateDetails.MailingAddress.Line2	string	Address line 2.
Applicants.CorporateDetails.MailingAddress.Line3	string	Address line 3.
Applicants.CorporateDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.CorporateDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.CorporateDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.CorporateDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Applicants.CorporateDetails.ContactIsSignatory	boolean	Whether the contact is a signatory on the account.
Applicants.CorporateDetails.Contact	object	Primary contact.
Applicants.CorporateDetails.Contact.Title	string	Title of contact.
Applicants.CorporateDetails.Contact.FirstName	string	First name of contact.
Applicants.CorporateDetails.Contact.LastName	string	Last name of contact.
Applicants.CorporateDetails.Contact.Email	string	Email of contact.
Applicants.CorporateDetails.Contact.Phone	string	Phone Number of contact.
Applicants.CorporateDetails.Signatories	array	Corporate signatories.
Applicants.CorporateDetails.Signatories.Title	string	Title of signatory.
Applicants.CorporateDetails.Signatories.FirstName	string	First name of signatory.
Applicants.CorporateDetails.Signatories.LastName	string	Last name of signatory.
Applicants.CorporateDetails.Signatories.DateOfBirth	date-time	Date of birth of signatory.
Applicants.CorporateDetails.Signatories.Email	string	Email address of signatory.
Applicants.CorporateDetails.Signatories.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.CorporateDetails.Signatories.PepDetails	string	If applicant is politically exposed, details must be supplied.
Applicants.CorporateDetails.Signatories.Capacity	enum	Director = 0, SoleDirector = 1, CompanySecretary = 2.
Applicants.CorporateDetails.Signatories.TaxNumber	string	Tax number of signatory.
Applicants.CorporateDetails.Signatories.CountryOfBirth	string	Country of birth of signatory.
Applicants.CorporateDetails.Signatories.Address	object	Address of signatory.
Applicants.CorporateDetails.Signatories.Address.Street	string	Address line 1.
Applicants.CorporateDetails.Signatories.Address.Line2	string	Address line 2.
Applicants.CorporateDetails.Signatories.Address.Line3	string	Address line 3.
Applicants.CorporateDetails.Signatories.Address.Postcode	string	Postcode of address.
Applicants.CorporateDetails.Signatories.Address.Suburb	string	Suburb of address.
Applicants.CorporateDetails.Signatories.Address.CountryCode	string	Country code of address.
Applicants.CorporateDetails.Signatories.Address.IsRegistered	boolean	Whether address is registered.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	Trust = 15.
Accounts.PdsId	string	PDS ID of account.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Models	array	Account models.
Accounts.Models.Code	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.Bsb	string	Bank account BSB.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Usages	array	This allows you to define a regular cash addition or withdrawal from the SMA or SuperSMA.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Code	string	Security code of the security.
Accounts.Exclusions.Security.Exchange	string	Exchange code of the security.
Accounts.InitialInvestment	object	Initial investment of account.
Accounts.InitialInvestment.Cash	double	Select if the initial investment will include cash.
Accounts.InitialInvestment.Shares	double	Select if the initial investment will include shares.
Accounts.InitialInvestment.Methodrequired	enum	BPay = 0, DirectDebit = 1.
Accounts.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Accounts.TrustOrFundDetails	object	Trust or Fund details.
Accounts.TrustOrFundDetails.Name	string	Name of the Trust or Fund.
Accounts.TrustOrFundDetails.Abn	string	ABN of the Super Fund (rather than the corporate trustee) for corporate applicants.
Accounts.TrustOrFundDetails.Tfn	string	TFN for an individual trustee.
Accounts.TargetAllocation	object	Target allocation.
Accounts.TargetAllocation.Fees	array	Target allocation fees.
Accounts.TargetAllocation.Fees.Code	string	Target allocation fees code.
Accounts.TargetAllocation.Fees.Percentage	double	Target allocation fees percentage.
Accounts.TargetAllocation.Income	array	Target allocation income.
Accounts.TargetAllocation.Income.Code	string	Target allocation income code.
Accounts.TargetAllocation.Income.Percentage	double	Target allocation income percentage.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Individual Applicant & SuperSMA Accumulation Account - AU

Definition: https://api.onpraemium.com/api/application

This endpoint creates a individual applicant and a SuperSMA Accumulation account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 0,
      "IndividualDetails": {
        "Title": "Mr",
        "FirstName": "John",
        "LastName": "Smith",
        "Email": "j.smith@example.com",
        "Phone": "012489235",
        "PhoneOther": "012489235",
        "Gender": 1,
        "HomeAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "MailingAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "Identifications": [
          {
            "Type": 0,
            "Value": "123456789"
          },
          {
            "MissingReason": 1,
            "MissingReasonText": "test"
          }
        ],
        "IsPoliticallyExposedPerson": true,
        "PepDetails": "Senior politician"
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Miss Jane Smith",
      "RegisteredName": "Miss Jane Smith",
      "ShortName": "Jane",
      "AccountType": 16,
      "PdsId": "AU5",
      "Fees": [
        {
          "Id": "AU21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "AU0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "Bsb": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith",
          "Usages": [
            "Income",
            "CashContribution"
          ]
        }
      ],
      "Exclusions": [
        {
          "Code": "AU0002",
          "Exchange": "ASX"
        }
      ],
      "TargetAllocation": {
        "Fees": [
          {
            "Code": "AB0101",
            "Percentage": 100
          }
        ],
        "Income": []
      },
      "InitialInvestmentSuper": {
        "ContributionSources": [
          {
            "MemberNumber": "test member number",
            "SourceOfContribution": {
              "ProductName": "test product name",
              "Usi": "test usi"
            },
            "EntireBalance": true,
            "ExpectedAmount": 35234.43543
          }
        ],
        "Transfers": [
          {
            "AccountId": "AU123456",
            "TransferMethod": 1,
            "Amount": 35234.43543
          }
        ],
        "OtherContributions": [
          {
            "ContributionType": 21,
            "ExpectedAmount": 35234.43543
          }
        ]
      },
      "Beneficiaries": [
          {
            "FullName": "Mr. John Smith",
            "Relationship": 2,
            "DateOfBirth": "2000-01-01",
            "Proportion": 100.0,
            "Address": {
                "Street": "123 Test St",
                "Line2": "",
                "Line3": "",
                "Postcode": "3000",
                "Suburb": "Melbourne",
                "State": "VIC",
                "CountryCode": "AUS"
            },
          }
      ],
      "IsBindingNomination": false,
      "IsEmployerContributing": false
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Individual = 0.
Applicants.IndividualDetails	object	Used for Individual applicants.
Applicants.IndividualDetails.Title	string	Title: Mr, Mrs, Ms, Miss, Doctor, Lady, Prof and Sir.
Applicants.IndividualDetails.FirstName	string	First name of individual.
Applicants.IndividualDetails.LastName	string	Last name of individual.
Applicants.IndividualDetails.DateOfBirth	date-time	Date of birth of the individual.
Applicants.IndividualDetails.Email	string	Email address of the individual.
Applicants.IndividualDetails.Phone	string	Primary contact number of the individual.
Applicants.IndividualDetails.PhoneOther	string	Other phone of the individual.
Applicants.IndividualDetails.Genderrequired	enum	Male = 1, Female = 2.
Applicants.IndividualDetails.UserName	string	User Name of individual applicant.
Applicants.IndividualDetails.UserId	string	User ID of individual applicant.
Applicants.IndividualDetails.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.IndividualDetails.PepDetails	string	If applicant is politically exposed, details must be supplied.
Applicants.IndividualDetails.TaxResidenceCountryCode	string	Tax residence country code.
Applicants.IndividualDetails.CitizenshipCountryCode	string	Citizenship country code.
Applicants.IndividualDetails.Identifications	array	Array of TFN / ABN.
Applicants.IndividualDetails.Identifications.Type	enum	Tfn = 0, Tin = 2.
Applicants.IndividualDetails.Identifications.Value	string	Identification value of applicant.
Applicants.IndividualDetails.Identifications.MissingReason	enum	CountryDoesntIssue = 1, DontNeedOne = 2, Other = 99.
Applicants.IndividualDetails.Identifications.MissingReasonText	string	Reason identification of applicant is missing.
Applicants.IndividualDetails.HomeAddress	object	Home address of individual applicant.
Applicants.IndividualDetails.HomeAddress.Street	string	Address line 1.
Applicants.IndividualDetails.HomeAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.HomeAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.HomeAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.HomeAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.HomeAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.HomeAddress.IsRegistered	boolean	Whether address is registered.
Applicants.IndividualDetails.MailingAddress	object	Mailing address of individual applicant.
Applicants.IndividualDetails.MailingAddress.Street	string	Address line 1.
Applicants.IndividualDetails.MailingAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.MailingAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	SuperSmaAccumulation = 16.
Accounts.PdsId	string	PDS ID of account.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Models	array	Account models.
Accounts.Models.Coderequired	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.Bsb	string	Bank account BSB.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Usages	array	This allows you to define a regular cash addition or withdrawal from the SMA or SuperSMA.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Coderequired	string	Security code of the security.
Accounts.Exclusions.Security.Exchangerequired	string	Exchange code of the security.
Accounts.TargetAllocation	object	Target allocation.
Accounts.TargetAllocation.Fees	array	Target allocation fees.
Accounts.TargetAllocation.Fees.Code	string	Target allocation fees code.
Accounts.TargetAllocation.Fees.Percentage	double	Target allocation fees percentage.
Accounts.TargetAllocation.Income	array	Target allocation income.
Accounts.TargetAllocation.Income.Code	string	Target allocation income code.
Accounts.TargetAllocation.Income.Percentage	double	Target allocation income percentage.
Accounts.InitialInvestmentSuper	object	Initial investment for super.
Accounts.InitialInvestmentSuper.ContributionSources	array	Initial investment super contribution sources.
Accounts.InitialInvestmentSuper.ContributionSources.MemberNumber	string	Contribution sources member number.
Accounts.InitialInvestmentSuper.ContributionSources.SourceOfContribution	object	Source of contribution.
Accounts.InitialInvestmentSuper.ContributionSources.SourceOfContribution.ProductName	string	Source of contribution product name.
Accounts.InitialInvestmentSuper.ContributionSources.SourceOfContribution.Usi	string	Source of contribution USI.
Accounts.InitialInvestmentSuper.ContributionSources.EntireBalance	boolean	Entire balance.
Accounts.InitialInvestmentSuper.ContributionSources.ExpectedAmount	double	Expected amount.
Accounts.InitialInvestmentSuper.Transfers	array	Initial investment super transfers.
Accounts.InitialInvestmentSuper.Transfers.AccountId	string	Transfer account ID.
Accounts.InitialInvestmentSuper.Transfers.TransferMethod	enum	WholeAmountWithClose = 0, WholeAmountKeepOpen = 1, SpecifiedAmount = 2 - whether the source account will be kept open.
Accounts.InitialInvestmentSuper.Transfers.Amount	double	Transfer amount.
Accounts.InitialInvestmentSuper.OtherContributions	array	Other contributions.
Accounts.InitialInvestmentSuper.OtherContributions.ContributionType	enum	NonConcessional_Personal = 21, NonConcessional_Spouse = 22, NonConcessional_Child = 24, Downsizer = 43.
Accounts.InitialInvestmentSuper.OtherContributions.ExpectedAmount	double	Other contributions expected amount.
Accounts.InitialInvestmentSuper.AccumContribution	object	Accumulation contribution.
Accounts.InitialInvestmentSuper.AccumContribution.ContributionType	enum	NonConcessional_Personal = 21, NonConcessional_Spouse = 22.
Accounts.InitialInvestmentSuper.AccumContribution.ExpectedAmount	double	Accumulation contribution expected amount.
Accounts.Beneficiaries	array	Beneficiaries.
Accounts.Beneficiaries.Proportion	double	The portion of the benefit that should be paid to the beneficiary. These must add up to 100%.
Accounts.Beneficiaries.Address	object	Address of the beneficiary.
Accounts.Beneficiaries.Address.Streetrequired	string	Address street of the beneficiary.
Accounts.Beneficiaries.Address.Line2	string	Address Line 2 of the beneficiary.
Accounts.Beneficiaries.Address.Line3	string	Address Line 3 of the beneficiary.
Accounts.Beneficiaries.Address.Postcode	string	Postcode of the beneficiary.
Accounts.Beneficiaries.Address.Suburb	string	Suburb of the beneficiary.
Accounts.Beneficiaries.Address.CountryCode	string	Country code of the beneficiary.
Accounts.Beneficiaries.Address.IsRegistered	boolean	Address is registered.
Accounts.Beneficiaries.FullName	string	Full name of beneficiary.
Accounts.Beneficiaries.Relationship	enum	Spouse = 1, Child = 2, Other = 3, PersonalLegalRepresentative = 8.
Accounts.Beneficiaries.DateOfBirth	date-time	Date of birth of beneficiary.
Accounts.IsBindingNomination	boolean	If nomination is binding.
Accounts.IsEmployerContributing	boolean	If employer is contributing.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Individual Applicant & SuperSMA Account-Based-Pensions Account - AU

Definition: https://api.onpraemium.com/api/application

This endpoint creates a individual applicant and a SuperSMA Pension account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 0,
      "IndividualDetails": {
        "Title": "Mr",
        "FirstName": "John",
        "LastName": "Smith",
        "Email": "j.smith@example.com",
        "Phone": "012489235",
        "PhoneOther": "012489235",
        "Gender": 1,
        "HomeAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "MailingAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "Identifications": [
          {
            "Type": 0,
            "Value": "123456789"
          },
          {
            "MissingReason": 1,
            "MissingReasonText": "test"
          }
        ],
        "IsPoliticallyExposedPerson": true,
        "PepDetails": "Senior politician"
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Miss Jane Smith",
      "RegisteredName": "Miss Jane Smith",
      "ShortName": "Jane",
      "AccountType": 16,
      "PdsId": "AU5",
      "Fees": [
        {
          "Id": "AU21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "AU0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "Bsb": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith",
          "Usages": [
            "Income",
            "CashContribution"
          ]
        }
      ],
      "Exclusions": [
        {
          "Code": "AU0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestmentSuper": {
        "ContributionSources": [
          {
            "MemberNumber": "test member number",
            "SourceOfContribution": {
              "ProductName": "test product name",
              "Usi": "test usi"
            },
            "EntireBalance": true,
            "ExpectedAmount": 35234.43543
          }
        ],
        "Transfers": [
          {
            "AccountId": "AU123456",
            "TransferMethod": 1,
            "Amount": 35234.43543
          }
        ],
        "OtherContributions": [
          {
            "ContributionType": 21,
            "ExpectedAmount": 35234.43543
          }
        ]
      },
      "PensionPayment": {
        "Type": 0,
        "Amount": 100.0,
        "CommencementDate": "2021-01",
        "Frequency": 0
      },
      "TargetAllocation": {
        "Fees": [
          {
            "Code": "AB0101",
            "Percentage": 100
          }
        ],
        "Income": [],
        "Payments": []
      },
      "ReversionaryBeneficiary": {
        "FullName": "Mr. John Smith",
        "Sex": 1,
        "Relationship": 2,
        "DateOfBirth": "2000-01-01"
      },
      "Beneficiaries": [],
      "IsBindingNomination": false
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Individual = 0.
Applicants.IndividualDetails	object	Used for Individual applicants.
Applicants.IndividualDetails.Title	string	Title: Mr, Mrs, Ms, Miss, Doctor, Lady, Prof and Sir.
Applicants.IndividualDetails.FirstName	string	First name of individual.
Applicants.IndividualDetails.LastName	string	Last name of individual.
Applicants.IndividualDetails.DateOfBirth	date-time	Date of birth of the individual.
Applicants.IndividualDetails.Email	string	Email address of the individual.
Applicants.IndividualDetails.Phone	string	Primary contact number of the individual.
Applicants.IndividualDetails.PhoneOther	string	Other phone of the individual.
Applicants.IndividualDetails.Genderrequired	enum	Male = 1, Female = 2.
Applicants.IndividualDetails.UserName	string	User Name of individual applicant.
Applicants.IndividualDetails.UserId	string	User ID of individual applicant.
Applicants.IndividualDetails.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.IndividualDetails.PepDetails	string	If applicant is politically exposed, details must be supplied.
Applicants.IndividualDetails.TaxResidenceCountryCode	string	Tax residence country code.
Applicants.IndividualDetails.CitizenshipCountryCode	string	Citizenship country code.
Applicants.IndividualDetails.Identifications	array	Array of TFN / ABN.
Applicants.IndividualDetails.Identifications.Type	enum	Tfn = 0, Tin = 2.
Applicants.IndividualDetails.Identifications.Value	string	Identification value of applicant.
Applicants.IndividualDetails.Identifications.MissingReason	enum	CountryDoesntIssue = 1, DontNeedOne = 2, Other = 99.
Applicants.IndividualDetails.Identifications.MissingReasonText	string	Reason identification of applicant is missing.
Applicants.IndividualDetails.HomeAddress	object	Home address of individual applicant.
Applicants.IndividualDetails.HomeAddress.Street	string	Address line 1.
Applicants.IndividualDetails.HomeAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.HomeAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.HomeAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.HomeAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.HomeAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.HomeAddress.IsRegistered	boolean	Whether address is registered.
Applicants.IndividualDetails.MailingAddress	object	Mailing address of individual applicant.
Applicants.IndividualDetails.MailingAddress.Street	string	Address line 1.
Applicants.IndividualDetails.MailingAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.MailingAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	SuperSmaPensionAbp = 17.
Accounts.PdsId	string	PDS ID of account.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Models	array	Account models.
Accounts.Models.Coderequired	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.Bsb	string	Bank account BSB.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Usages	array	This allows you to define a regular cash addition or withdrawal from the SMA or SuperSMA.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Coderequired	string	Security code of the security.
Accounts.Exclusions.Security.Exchangerequired	string	Exchange code of the security.
Accounts.TargetAllocation	object	Target allocation.
Accounts.TargetAllocation.Fees	array	Target allocation fees.
Accounts.TargetAllocation.Fees.Code	string	Target allocation fees code.
Accounts.TargetAllocation.Fees.Percentage	double	Target allocation fees percentage.
Accounts.TargetAllocation.Income	array	Target allocation income.
Accounts.TargetAllocation.Income.Code	string	Target allocation income code.
Accounts.TargetAllocation.Income.Percentage	double	Target allocation income percentage.
Accounts.TargetAllocation.Payments	array	Target allocation payment.
Accounts.TargetAllocation.Payments.Code	string	Target allocation payment code.
Accounts.TargetAllocation.Payments.Percentage	double	Target allocation payment percentage.
Accounts.PensionPayment	object	Pension Payment.
Accounts.PensionPayment.Type	enum	Specified = 0, Minimum = 1.
Accounts.PensionPayment.Amount	double	Pension payment amount.
Accounts.PensionPayment.Frequency	enum	Monthly = 0, Quarterly = 1, SemiAnnually = 2, Annually = 3.
Accounts.PensionPayment.CommencementDate	date-time	Pension payment commencement date.
Accounts.InitialInvestmentSuper	object	Initial investment for super.
Accounts.InitialInvestmentSuper.ContributionSources	array	Initial investment super contribution sources.
Accounts.InitialInvestmentSuper.ContributionSources.MemberNumber	string	Contribution sources member number.
Accounts.InitialInvestmentSuper.ContributionSources.SourceOfContribution	object	Source of contribution.
Accounts.InitialInvestmentSuper.ContributionSources.SourceOfContribution.ProductName	string	Source of contribution product name.
Accounts.InitialInvestmentSuper.ContributionSources.SourceOfContribution.Usi	string	Source of contribution USI.
Accounts.InitialInvestmentSuper.ContributionSources.EntireBalance	boolean	Entire balance.
Accounts.InitialInvestmentSuper.ContributionSources.ExpectedAmount	double	Expected amount.
Accounts.InitialInvestmentSuper.Transfers	array	Initial investment super transfers.
Accounts.InitialInvestmentSuper.Transfers.AccountId	string	Transfer account ID.
Accounts.InitialInvestmentSuper.Transfers.TransferMethod	enum	WholeAmountWithClose = 0, WholeAmountKeepOpen = 1, SpecifiedAmount = 2 - whether the source account will be kept open.
Accounts.InitialInvestmentSuper.Transfers.Amount	double	Transfer amount.
Accounts.InitialInvestmentSuper.OtherContributions	array	Other contributions.
Accounts.InitialInvestmentSuper.OtherContributions.ContributionType	enum	NonConcessional_Personal = 21, NonConcessional_Spouse = 22, NonConcessional_Child = 24, Downsizer = 43.
Accounts.InitialInvestmentSuper.OtherContributions.ExpectedAmount	double	Other contributions expected amount.
Accounts.ReversionaryBeneficiary	object	Reversionary beneficiary.
Accounts.ReversionaryBeneficiary.Sex	enum	Male = 1, Female = 2.
Accounts.ReversionaryBeneficiary.FullName	string	Full name of beneficiary.
Accounts.ReversionaryBeneficiary.Relationship	enum	Spouse = 1, Child = 2, Other = 3.
Accounts.ReversionaryBeneficiary.DateOfBirth	date-time	Date of birth of beneficiary.
Accounts.Beneficiaries	array	Beneficiaries.
Accounts.Beneficiaries.Proportion	double	The portion of the benefit that should be paid to the beneficiary. These must add up to 100%.
Accounts.Beneficiaries.Address	object	Address of the beneficiary.
Accounts.Beneficiaries.Address.Streetrequired	string	Address street of the beneficiary.
Accounts.Beneficiaries.Address.Line2	string	Address Line 2 of the beneficiary.
Accounts.Beneficiaries.Address.Line3	string	Address Line 3 of the beneficiary.
Accounts.Beneficiaries.Address.Postcode	string	Postcode of the beneficiary.
Accounts.Beneficiaries.Address.Suburb	string	Suburb of the beneficiary.
Accounts.Beneficiaries.Address.CountryCode	string	Country code of the beneficiary.
Accounts.Beneficiaries.Address.IsRegistered	boolean	Address is registered.
Accounts.Beneficiaries.FullName	string	Full name of beneficiary.
Accounts.Beneficiaries.Relationship	enum	Spouse = 1, Child = 2, Other = 3, PersonalLegalRepresentative = 8.
Accounts.Beneficiaries.DateOfBirth	date-time	Date of birth of beneficiary.
Accounts.IsBindingNomination	boolean	If nomination is binding.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Individual Applicant & SuperSMA Transition-To-Retirement Account - AU

Definition: https://api.onpraemium.com/api/application

This endpoint creates a individual applicant and a SuperSMA Transition to Retirement account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 0,
      "IndividualDetails": {
        "Title": "Mr",
        "FirstName": "John",
        "LastName": "Smith",
        "Email": "j.smith@example.com",
        "Phone": "012489235",
        "PhoneOther": "012489235",
        "Gender": 1,
        "HomeAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "MailingAddress": {
          "Street": "123 Test St",
          "Postcode": "3000",
          "Suburb": "Melbourne",
          "State": "VIC",
          "CountryCode": "AUS"
        },
        "Identifications": [
          {
            "Type": 0,
            "Value": "123456789"
          },
          {
            "MissingReason": 1,
            "MissingReasonText": "test"
          }
        ],
        "IsPoliticallyExposedPerson": true,
        "PepDetails": "Senior politician"
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Miss Jane Smith",
      "RegisteredName": "Miss Jane Smith",
      "ShortName": "Jane",
      "AccountType": 16,
      "PdsId": "AU5",
      "Fees": [
        {
          "Id": "AU21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "AU0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "Bsb": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith",
          "Usages": [
            "Income",
            "CashContribution"
          ]
        }
      ],
      "Exclusions": [
        {
          "Code": "AU0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestmentSuper": {
        "ContributionSources": [
          {
            "MemberNumber": "test member number",
            "SourceOfContribution": {
              "ProductName": "test product name",
              "Usi": "test usi"
            },
            "EntireBalance": true,
            "ExpectedAmount": 35234.43543
          }
        ],
        "Transfers": [
          {
            "AccountId": "AU123456",
            "TransferMethod": 1,
            "Amount": 35234.43543
          }
        ],
        "OtherContributions": [
          {
            "ContributionType": 21,
            "ExpectedAmount": 35234.43543
          }
        ]
      },
      "PensionPayment": {
        "Type": 0,
        "Amount": 100.0,
        "CommencementDate": "2021-01",
        "Frequency": 0
      },
      "TargetAllocation": {
        "Fees": [
          {
            "Code": "AB0101",
            "Percentage": 100
          }
        ],
        "Income": [],
        "Payments": []
      },
      "ReversionaryBeneficiary": {
        "FullName": "Mr. John Smith",
        "Sex": 1,
        "Relationship": 2,
        "DateOfBirth": "2000-01-01"
      },
      "Beneficiaries": [],
      "IsBindingNomination": false
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Individual = 0.
Applicants.IndividualDetails	object	Used for Individual applicants.
Applicants.IndividualDetails.Title	string	Title: Mr, Mrs, Ms, Miss, Doctor, Lady, Prof and Sir.
Applicants.IndividualDetails.FirstName	string	First name of individual.
Applicants.IndividualDetails.LastName	string	Last name of individual.
Applicants.IndividualDetails.DateOfBirth	date-time	Date of birth of the individual.
Applicants.IndividualDetails.Email	string	Email address of the individual.
Applicants.IndividualDetails.Phone	string	Primary contact number of the individual.
Applicants.IndividualDetails.PhoneOther	string	Other phone of the individual.
Applicants.IndividualDetails.Genderrequired	enum	Male = 1, Female = 2.
Applicants.IndividualDetails.UserName	string	User Name of individual applicant.
Applicants.IndividualDetails.UserId	string	User ID of individual applicant.
Applicants.IndividualDetails.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.IndividualDetails.PepDetails	string	If applicant is politically exposed, details must be supplied.
Applicants.IndividualDetails.TaxResidenceCountryCode	string	Tax residence country code.
Applicants.IndividualDetails.CitizenshipCountryCode	string	Citizenship country code.
Applicants.IndividualDetails.Identifications	array	Array of TFN / ABN.
Applicants.IndividualDetails.Identifications.Type	enum	Tfn = 0, Tin = 2.
Applicants.IndividualDetails.Identifications.Value	string	Identification value of applicant.
Applicants.IndividualDetails.Identifications.MissingReason	enum	CountryDoesntIssue = 1, DontNeedOne = 2, Other = 99.
Applicants.IndividualDetails.Identifications.MissingReasonText	string	Reason identification of applicant is missing.
Applicants.IndividualDetails.HomeAddress	object	Home address of individual applicant.
Applicants.IndividualDetails.HomeAddress.Street	string	Address line 1.
Applicants.IndividualDetails.HomeAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.HomeAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.HomeAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.HomeAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.HomeAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.HomeAddress.IsRegistered	boolean	Whether address is registered.
Applicants.IndividualDetails.MailingAddress	object	Mailing address of individual applicant.
Applicants.IndividualDetails.MailingAddress.Street	string	Address line 1.
Applicants.IndividualDetails.MailingAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.MailingAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	SuperSmaPensionTtr = 18.
Accounts.PdsId	string	PDS ID of account.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Models	array	Account models.
Accounts.Models.Coderequired	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.Bsb	string	Bank account BSB.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Usages	array	This allows you to define a regular cash addition or withdrawal from the SMA or SuperSMA.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Coderequired	string	Security code of the security.
Accounts.Exclusions.Security.Exchangerequired	string	Exchange code of the security.
Accounts.TargetAllocation	object	Target allocation.
Accounts.TargetAllocation.Fees	array	Target allocation fees.
Accounts.TargetAllocation.Fees.Code	string	Target allocation fees code.
Accounts.TargetAllocation.Fees.Percentage	double	Target allocation fees percentage.
Accounts.TargetAllocation.Income	array	Target allocation income.
Accounts.TargetAllocation.Income.Code	string	Target allocation income code.
Accounts.TargetAllocation.Income.Percentage	double	Target allocation income percentage.
Accounts.TargetAllocation.Payments	array	Target allocation payment.
Accounts.TargetAllocation.Payments.Code	string	Target allocation payment code.
Accounts.TargetAllocation.Payments.Percentage	double	Target allocation payment percentage.
Accounts.PensionPayment	object	Pension Payment.
Accounts.PensionPayment.Type	enum	Specified = 0, Minimum = 1.
Accounts.PensionPayment.Amount	double	Pension payment amount.
Accounts.PensionPayment.Frequency	enum	Monthly = 0, Quarterly = 1, SemiAnnually = 2, Annually = 3.
Accounts.PensionPayment.CommencementDate	date-time	Pension payment commencement date.
Accounts.InitialInvestmentSuper	object	Initial investment for super.
Accounts.InitialInvestmentSuper.ContributionSources	array	Initial investment super contribution sources.
Accounts.InitialInvestmentSuper.ContributionSources.MemberNumber	string	Contribution sources member number.
Accounts.InitialInvestmentSuper.ContributionSources.SourceOfContribution	object	Source of contribution.
Accounts.InitialInvestmentSuper.ContributionSources.SourceOfContribution.ProductName	string	Source of contribution product name.
Accounts.InitialInvestmentSuper.ContributionSources.SourceOfContribution.Usi	string	Source of contribution USI.
Accounts.InitialInvestmentSuper.ContributionSources.EntireBalance	boolean	Entire balance.
Accounts.InitialInvestmentSuper.ContributionSources.ExpectedAmount	double	Expected amount.
Accounts.InitialInvestmentSuper.Transfers	array	Initial investment super transfers.
Accounts.InitialInvestmentSuper.Transfers.AccountId	string	Transfer account ID.
Accounts.InitialInvestmentSuper.Transfers.TransferMethod	enum	WholeAmountWithClose = 0, WholeAmountKeepOpen = 1, SpecifiedAmount = 2 - whether the source account will be kept open.
Accounts.InitialInvestmentSuper.Transfers.Amount	double	Transfer amount.
Accounts.InitialInvestmentSuper.OtherContributions	array	Other contributions.
Accounts.InitialInvestmentSuper.OtherContributions.ContributionType	enum	NonConcessional_Personal = 21, NonConcessional_Spouse = 22, NonConcessional_Child = 24, Downsizer = 43.
Accounts.InitialInvestmentSuper.OtherContributions.ExpectedAmount	double	Other contributions expected amount.
Accounts.ReversionaryBeneficiary	object	Reversionary beneficiary.
Accounts.ReversionaryBeneficiary.Sex	enum	Male = 1, Female = 2.
Accounts.ReversionaryBeneficiary.FullName	string	Full name of beneficiary.
Accounts.ReversionaryBeneficiary.Relationship	enum	Spouse = 1, Child = 2, Other = 3.
Accounts.ReversionaryBeneficiary.DateOfBirth	date-time	Date of birth of beneficiary.
Accounts.Beneficiaries	array	Beneficiaries.
Accounts.Beneficiaries.Proportion	double	The portion of the benefit that should be paid to the beneficiary. These must add up to 100%.
Accounts.Beneficiaries.Address	object	Address of the beneficiary.
Accounts.Beneficiaries.Address.Streetrequired	string	Address street of the beneficiary.
Accounts.Beneficiaries.Address.Line2	string	Address Line 2 of the beneficiary.
Accounts.Beneficiaries.Address.Line3	string	Address Line 3 of the beneficiary.
Accounts.Beneficiaries.Address.Postcode	string	Postcode of the beneficiary.
Accounts.Beneficiaries.Address.Suburb	string	Suburb of the beneficiary.
Accounts.Beneficiaries.Address.CountryCode	string	Country code of the beneficiary.
Accounts.Beneficiaries.Address.IsRegistered	boolean	Address is registered.
Accounts.Beneficiaries.FullName	string	Full name of beneficiary.
Accounts.Beneficiaries.Relationship	enum	Spouse = 1, Child = 2, Other = 3, PersonalLegalRepresentative = 8.
Accounts.Beneficiaries.DateOfBirth	date-time	Date of birth of beneficiary.
Accounts.IsBindingNomination	boolean	If nomination is binding.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Individual Applicant & GIA Account - UK

Definition: https://api.onpraemium.com/api/application

This endpoint creates a individual applicant and GIA account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 0,
      "IndividualDetails": {
        "Title": "Mr",
        "FirstName": "John",
        "LastName": "Smith",
        "Email": "j.smith@example.com",
        "Phone": "012489235",
        "PhoneOther": "012489235",
        "Gender": 1,
        "BirthCountryCode": "AUS",
        "DualNationality": false,
        "UsPerson": true,
        "Profession": "Software engineer",
        "SourceOfWealth": "Secret source",
        "TaxResidences": [
          {
            "CountryCode": "CAN",
            "From": "2020-10-01",
            "To": "2020-10-01",
            "Identification": "ui9089",
            "NoDocument": false
          }
        ],
        "HomeAddress": {
          "Addressee": "Yoki individual",
          "Street": "123 Test St",
          "Postcode": "BR5 4HL",
          "Suburb": "Orpington",
          "State": "KENT",
          "CountryCode": "UK"
        },
        "MailingAddress": {
          "Addressee": "Yoki individual",
          "Street": "123 Test St",
          "Postcode": "BR5 4HL",
          "Suburb": "Orpington",
          "State": "KENT",
          "CountryCode": "UK"
        },
        "NationalIdentifier": {
          "CountryOfNationality": "USA",
          "IdentifierType": 0,
          "IdentifierCode": "",
          "NoNationalIdentifier": true
        },
        "ReceiveCommunicationByPost": true,
        "IsPoliticallyExposedPerson": true
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Miss Jane Smith",
      "RegisteredName": "Miss Jane Smith",
      "ShortName": "Jane",
      "AccountType": 1,
      "PdsId": "UK5",
      "SourceOfFunds": "Loan",
      "AdviserReference": "123123",
      "OngoingFeeAmount": 2.5,
      "ReinvestIncome": false,
      "ProductId": "UK96",
      "ProductProviderReference": "Praemium International Limited",
      "RegularContribution": {
        "Amount": 150.5,
        "Method": 3,
        "Frequency": 0
      },
      "RegularWithdrawal": {
        "Amount": 120,
        "Method": 2,
        "Frequency": 0
      },
      "Region": 2,
      "CurrencyCode": "GBP",
      "Fees": [
        {
          "Id": "UK21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "UK0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "SortCode": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith"
        }
      ],
      "Exclusions": [
        {
          "Code": "UK0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestment": {
        "Cash": 132.12,
        "Shares": 321.32,
        "Method": 0
      },
      "IllustrationData": {
        "CostsAndCharges": [
          {
            "Type": 0,
            "Amount": 123.123
          },
          {
            "Type": 1,
            "Amount": 321.123
          },
          {
            "Type": 2,
            "Amount": 123.123
          }
        ]
      },
      "InSpecieCashStockTransfers": [
        {
          "TransferType": 0,
          "CedingPartyId": "UK29821",
          "CedingAccountNumber": "123456",
          "InSpecieCashStockTransferDetails": [
            {
              "SecurityIsin": "UK000000ROC4",
              "Quantity": 123.123,
              "BookCost": 3242.32432
            }
          ]
        }
      ],
      "IsTradeFreezeOn": true,
      "TradeFreezeReason": 4,
      "TradeFreezeNote": "just freeze it"
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Individual = 0.
Applicants.IndividualDetails	object	Used for Individual applicants.
Applicants.IndividualDetails.CitizenshipCountryCode	string	Citizenship country code.
Applicants.IndividualDetails.BirthCountryCode	string	Birth country code.
Applicants.IndividualDetails.HomeAddress	object	Home address of individual applicant.
Applicants.IndividualDetails.HomeAddress.Addressee	string	Addressee.
Applicants.IndividualDetails.HomeAddress.Street	string	Address line 1.
Applicants.IndividualDetails.HomeAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.HomeAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.HomeAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.HomeAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.HomeAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.HomeAddress.IsRegistered	boolean	Whether address is registered.
Applicants.IndividualDetails.MailingAddress	object	Mailing address of individual applicant.
Applicants.IndividualDetails.MailingAddress.Addressee	string	Addressee.
Applicants.IndividualDetails.MailingAddress.Street	string	Address line 1.
Applicants.IndividualDetails.MailingAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.MailingAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Applicants.IndividualDetails.Genderrequired	enum	Male = 1, Female = 2.
Applicants.IndividualDetails.UserName	string	User Name of individual applicant.
Applicants.IndividualDetails.UserId	string	User ID of individual applicant.
Applicants.IndividualDetails.TaxResidences	array	Applicant's tax residence.
Applicants.IndividualDetails.TaxResidences.CountryCode	string	Tax residence country code.
Applicants.IndividualDetails.TaxResidences.From	date-time	From date that applicant held tax residence in that country.
Applicants.IndividualDetails.TaxResidences.To	date-time	To date that applicant held tax residence in that country.
Applicants.IndividualDetails.TaxResidences.Identification	string	Tax residence identification.
Applicants.IndividualDetails.TaxResidences.NoDocument	boolean	If the applicant does not hold a identification document.
Applicants.IndividualDetails.UsPerson	boolean	Select if applicant is from the US.
Applicants.IndividualDetails.SourceOfWealth	string	Provide the applicant's source of wealth.
Applicants.IndividualDetails.Profession	string	Provide the applicant's profession.
Applicants.IndividualDetails.Title	string	Title: Mr, Mrs, Ms, Miss, Doctor, Lady, Prof and Sir.
Applicants.IndividualDetails.FirstName	string	First name of individual.
Applicants.IndividualDetails.LastName	string	Last name of individual.
Applicants.IndividualDetails.DateOfBirth	date-time	Date of birth of the individual.
Applicants.IndividualDetails.Email	string	Email address of the individual.
Applicants.IndividualDetails.Phone	string	Primary contact number of the individual.
Applicants.IndividualDetails.PhoneOther	string	Other phone of the individual.
Applicants.IndividualDetails.NationalIdentifier	object	Individual's national identifier.
Applicants.IndividualDetails.NationalIdentifier.CountryOfNationality	string	Applicant's country of national identifier.
Applicants.IndividualDetails.NationalIdentifier.IdentifierType	enum	NoDocument = 0, NationalId = 1, Passport = 2, TaxNumber = 3, LEI = 4.
Applicants.IndividualDetails.NationalIdentifier.IdentifierCode	string	Applicant's national identifier code.
Applicants.IndividualDetails.ReceiveCommunicationByPost	boolean	If you would like to opt out of electronic communications.
Applicants.IndividualDetails.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	Gia = 1.
Accounts.PdsId	string	PDS ID of account.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Fees.Type	string	Fee type.
Accounts.Models	array	Account models.
Accounts.Models.Code	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.SortCode	string	Bank account sort code.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Bic	string	Bank identifier code (BIC) of your banking institution.
Accounts.BankAccounts.Iban	string	International bank account number (IBAN) of your banking institution.
Accounts.BankAccounts.RoutingNumber	string	Routing number of banking institution.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Code	string	Security code of the security.
Accounts.Exclusions.Security.Exchange	string	Exchange code of the security.
Accounts.InitialInvestment	object	Initial investment of account.
Accounts.InitialInvestment.Cash	double	Select if the initial investment will include cash.
Accounts.InitialInvestment.Shares	double	Select if the initial investment will include shares.
Accounts.InitialInvestment.Methodrequired	enum	ElectronicTransfer = 2, Cheque = 3.
Accounts.SourceOfFunds	string	Contribution source.
Accounts.OngoingFeeAmount	double	Ongoing fee amount.
Accounts.ReinvestIncome	boolean	Reinvest income.
Accounts.ProductId	string	Product ID.
Accounts.ProductProviderReference	string	Product provider reference.
Accounts.RegularContribution	object	Regular cash contributions to the account.
Accounts.RegularWithdrawal	object	Regular cash withdrawals from the account.
Accounts.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Accounts.Region	enum	Australia, UnitedKingdom or International.
Accounts.CurrencyCode	string	The currency code of the account.
Accounts.AdviserReference	string	Adviser reference..
Accounts.InSpecieCashStockTransfers	array	In specie cash stock transfers.
Accounts.InSpecieCashStockTransfers.TransferTyperequired	enum	StockAndCash = 0, CashOnly = 1.
Accounts.InSpecieCashStockTransfers.CedingPartyId	string	Ceding party ID.
Accounts.InSpecieCashStockTransfers.CedingAccountNumber	string	Ceding account number.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails	array	In specie cash stock transfer details.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.SecurityIsinrequired	string	Security ISIN of stock transfer.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.Quantity	double	Quantity of stock transfer.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.BookCost	double	Book cost of stock transfer.
Accounts.InSpecieCashStockTransfers.CashTransferAmount	double	Cash transfer amount.
Accounts.InSpecieCashStockTransfers.AmountUsedThisYear	double	Amount used this year.
Accounts.InSpecieCashStockTransfers.FeeAmount	double	Fee amount.
Accounts.InSpecieCashStockTransfers.FeePercent	double	Fee percent.
Accounts.IsTradeFreezeOn	boolean	If a trade freeze is on.
Accounts.TradeFreezeReason	enum	TransferIn = 0, TransferOut = 1, Incident = 2, Deceased = 3, RemovalOfAdviser = 4, AdviserInstructed = 5, Bespoke = 6.
Accounts.TradeFreezeNote	string	Trade freeze note.
Accounts.IllustrationData	object	Illustration data.
Accounts.IllustrationData.CostsAndCharges	array	Cost and charges.
Accounts.IllustrationData.CostsAndCharges.Type	enum	OneOffCharges = 0, OngoingCharges = 1, TransactionCharges = 2, IncidentalCharges = 3, ThirdPartyPayment = 4.
Accounts.IllustrationData.CostsAndCharges.Amount	double	Amount of cost and charge.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Corporate Applicant & GIA Account - UK

Definition: https://api.onpraemium.com/api/application

This endpoint creates a corporate applicant and GIA account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 1,
      "CorporateDetails": {
        "Name": "Test company",
        "TradingName": "Test company",
        "CompanyType": 1,
        "BusinessAddress": {
          "Addressee": "Test company",
          "Street": "Street A",
          "Postcode": "518000",
          "Suburb": "Kingston",
          "CountryCode": "CHN",
          "IsRegistered": true
        },
        "MailingAddress": {
          "Addressee": "Test company",
          "Street": "test street",
          "Line2": null,
          "Line3": null,
          "Postcode": "2050",
          "Suburb": "dd",
          "CountryCode": "GBR",
          "IsRegistered": false
        },
        "Contact": {
          "Title": "Ms",
          "FirstName": "Test",
          "LastName": "individual",
          "FullName": null,
          "DateOfBirth": "2002-10-15",
          "Email": "111@test.com",
          "Phone": "88900",
          "PhoneOther": null,
          "NationalIdentifier": null,
          "ReceiveCommunicationByPost": true,
          "IsPoliticallyExposedPerson": false
        },
        "Signatories": [
          {
            "Capacity": 0,
            "Address": {
              "Addressee": "111 222",
              "Street": "Home",
              "Line2": null,
              "Line3": null,
              "Postcode": "u090",
              "Suburb": "Kingston",
              "CountryCode": "HKG",
              "IsRegistered": false
            },
            "TaxNumber": "ji000",
            "CountryOfBirth": "",
            "Title": "Miss",
            "FirstName": "111",
            "LastName": "222",
            "FullName": null,
            "DateOfBirth": "1998-12-01",
            "Email": "test@praemium.com",
            "Phone": "12345678",
            "NationalIdentifier": {
              "CountryOfNationality": "",
              "IdentifierType": 0,
              "IdentifierCode": "",
              "NoNationalIdentifier": true
            },
            "ReceiveCommunicationByPost": false,
            "IsPoliticallyExposedPerson": false
          },
          {
            "Capacity": 0,
            "Address": {
              "Addressee": "Test individual",
              "Street": "Test street",
              "Line2": null,
              "Line3": null,
              "Postcode": "518000",
              "Suburb": "SZ",
              "CountryCode": "CHN",
              "IsRegistered": false
            },
            "TaxNumber": "ui9089",
            "CountryOfBirth": "JPN",
            "Title": "Ms.",
            "FirstName": "Test",
            "LastName": "individual",
            "FullName": null,
            "DateOfBirth": "2002-10-15",
            "Email": "111@test.com",
            "Phone": "34313",
            "PhoneOther": "88900",
            "NationalIdentifier": {
              "CountryOfNationality": "USA",
              "IdentifierType": 0,
              "IdentifierCode": "",
              "NoNationalIdentifier": true
            },
            "ReceiveCommunicationByPost": true,
            "IsPoliticallyExposedPerson": true
          }
        ],
        "CompanyRegistrationNumber": "689",
        "TaxId": "6i87899",
        "Lei": "689",
        "CountryOfIncorporation": "AND",
        "DateOfIncorporation": "2020-10-07",
        "NatureOfActivities": "activity",
        "BearerSharesAreInIssue": false,
        "NameOfRegulator": "test regulator",
        "RegulatorReferenceNumber": "12345678",
        "ContactIsDirectorOrSignificantShareholder": false
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Miss Jane Smith",
      "RegisteredName": "Miss Jane Smith",
      "ShortName": "Jane",
      "AccountType": 1,
      "PdsId": "UK5",
      "SourceOfFunds": "Loan",
      "AdviserReference": "123123",
      "OngoingFeeAmount": 2.5,
      "ReinvestIncome": false,
      "ProductId": "UK96",
      "ProductProviderReference": "Praemium International Limited",
      "RegularContribution": {
        "Amount": 150.5,
        "Method": 3,
        "Frequency": 0
      },
      "RegularWithdrawal": {
        "Amount": 120,
        "Method": 2,
        "Frequency": 0
      },
      "Region": 2,
      "CurrencyCode": "GBP",
      "Fees": [
        {
          "Id": "UK21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "UK0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "SortCode": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith"
        }
      ],
      "Exclusions": [
        {
          "Code": "UK0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestment": {
        "Cash": 132.12,
        "Shares": 321.32,
        "Method": 0
      },
      "IllustrationData": {
        "CostsAndCharges": [
          {
            "Type": 0,
            "Amount": 123.123
          },
          {
            "Type": 1,
            "Amount": 321.123
          },
          {
            "Type": 2,
            "Amount": 123.123
          }
        ]
      },
      "InSpecieCashStockTransfers": [
        {
          "TransferType": 0,
          "CedingPartyId": "UK29821",
          "CedingAccountNumber": "123456",
          "InSpecieCashStockTransferDetails": [
            {
              "SecurityIsin": "UK000000ROC4",
              "Quantity": 123.123,
              "BookCost": 3242.32432
            }
          ]
        }
      ],
      "IsTradeFreezeOn": true,
      "TradeFreezeReason": 4,
      "TradeFreezeNote": "just freeze it"
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Corporate = 1.
Applicants.CorporateDetails	object	Used for Corporate applicants.
Applicants.CorporateDetails.Name	string	Name of the corporate applicant.
Applicants.CorporateDetails.TradingName	string	Trading name of the corporate applicant.
Applicants.CorporateDetails.CompanyType	enum	Plc = 0, Ltd = 1, Llp = 2, Partnership = 3.
Applicants.CorporateDetails.BusinessAddress	object	Business address.
Applicants.CorporateDetails.BusinessAddress.Addressee	string	Addressee.
Applicants.CorporateDetails.BusinessAddress.Street	string	Address line 1.
Applicants.CorporateDetails.BusinessAddress.Line2	string	Address line 2.
Applicants.CorporateDetails.BusinessAddress.Line3	string	Address line 3.
Applicants.CorporateDetails.BusinessAddress.Postcode	string	Postcode of address.
Applicants.CorporateDetails.BusinessAddress.Suburb	string	Suburb of address.
Applicants.CorporateDetails.BusinessAddress.CountryCode	string	Country code of address.
Applicants.CorporateDetails.BusinessAddress.IsRegistered	boolean	Whether address is registered.
Applicants.CorporateDetails.MailingAddress	object	Mailing address.
Applicants.CorporateDetails.MailingAddress.Addressee	string	Addressee.
Applicants.CorporateDetails.MailingAddress.Street	string	Address line 1.
Applicants.CorporateDetails.MailingAddress.Line2	string	Address line 2.
Applicants.CorporateDetails.MailingAddress.Line3	string	Address line 3.
Applicants.CorporateDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.CorporateDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.CorporateDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.CorporateDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Applicants.CorporateDetails.ContactIsDirectorOrSignificantShareholder	boolean	Whether the contact is a director or significant shareholder on the account.
Applicants.CorporateDetails.Contact	object	Primary contact.
Applicants.CorporateDetails.Contact.Title	string	Title of contact.
Applicants.CorporateDetails.Contact.FirstName	string	First name of contact.
Applicants.CorporateDetails.Contact.LastName	string	Last name of contact.
Applicants.CorporateDetails.Contact.DateOfBirth	date-time	Date of birth of contact.
Applicants.CorporateDetails.Contact.Email	string	Email of contact.
Applicants.CorporateDetails.Contact.Phone	string	Phone Number of contact.
Applicants.CorporateDetails.Contact.PhoneOther	string	Secondary contact number of contact.
Applicants.CorporateDetails.Contact.NationalIdentifier	object	National identifier.
Applicants.CorporateDetails.Contact.NationalIdentifier.CountryOfNationality	string	Applicant's country of national identifier.
Applicants.CorporateDetails.Contact.NationalIdentifier.IdentifierType	enum	NoDocument = 0, NationalId = 1, Passport = 2, TaxNumber = 3, LEI = 4.
Applicants.CorporateDetails.Contact.NationalIdentifier.IdentifierCode	string	Applicant's national identifier code.
Applicants.CorporateDetails.Contact.ReceiveCommunicationByPost	boolean	If you would like to opt out of electronic communications.
Applicants.CorporateDetails.Contact.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.CorporateDetails.Signatories	array	Corporate signatories.
Applicants.CorporateDetails.Signatories.Capacity	enum	Director = 0, SignificantShareholder = 6.
Applicants.CorporateDetails.Signatories.TaxNumber	string	Tax number of signatory.
Applicants.CorporateDetails.Signatories.CountryOfBirth	string	Country of birth of signatory.
Applicants.CorporateDetails.Signatories.Address	object	Address of signatory.
Applicants.CorporateDetails.Signatories.Address.Addressee	string	Addressee.
Applicants.CorporateDetails.Signatories.Address.Street	string	Address line 1.
Applicants.CorporateDetails.Signatories.Address.Line2	string	Address line 2.
Applicants.CorporateDetails.Signatories.Address.Line3	string	Address line 3.
Applicants.CorporateDetails.Signatories.Address.Postcode	string	Postcode of address.
Applicants.CorporateDetails.Signatories.Address.Suburb	string	Suburb of address.
Applicants.CorporateDetails.Signatories.Address.CountryCode	string	Country code of address.
Applicants.CorporateDetails.Signatories.Address.IsRegistered	boolean	Whether address is registered.
Applicants.CorporateDetails.Signatories.Title	string	Title of signatory.
Applicants.CorporateDetails.Signatories.FirstName	string	First name of signatory.
Applicants.CorporateDetails.Signatories.LastName	string	Last name of signatory.
Applicants.CorporateDetails.Signatories.DateOfBirth	date-time	Date of birth of signatory.
Applicants.CorporateDetails.Signatories.Email	string	Email address of signatory.
Applicants.CorporateDetails.Signatories.Phone	string	Phone number of signatory.
Applicants.CorporateDetails.Signatories.PhoneOther	string	Secondary contact number of signatory.
Applicants.CorporateDetails.Signatories.NationalIdentifier	object	Signatory's national identifier.
Applicants.CorporateDetails.Signatories.NationalIdentifier.CountryOfNationality	string	Applicant's country of national identifier.
Applicants.CorporateDetails.Signatories.NationalIdentifier.IdentifierType	enum	NoDocument = 0, NationalId = 1, Passport = 2, TaxNumber = 3, LEI = 4.
Applicants.CorporateDetails.Signatories.NationalIdentifier.IdentifierCode	string	Applicant's national identifier code.
Applicants.CorporateDetails.Signatories.ReceiveCommunicationByPost	boolean	If you would like to opt out of electronic communications.
Applicants.CorporateDetails.Signatories.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.CorporateDetails.CompanyRegistrationNumber	string	Register number of the company.
Applicants.CorporateDetails.TaxId	string	Tax identity of the company.
Applicants.CorporateDetails.Lei	string	LEI of the Company.
Applicants.CorporateDetails.CountryOfIncorporation	string	Country of incorporation of the company.
Applicants.CorporateDetails.DateOfIncorporation	date-time	Date of incorporation of the company.
Applicants.CorporateDetails.NatureOfActivities	string	Nature of activities that the company performs.
Applicants.CorporateDetails.BearerSharesAreInIssue	boolean	Bearer shares are in issue
Applicants.CorporateDetails.NameOfRegulator	string	Name of regulator.
Applicants.CorporateDetails.RegulatorReferenceNumber	string	Regulator reference number.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	Gia = 1.
Accounts.PdsId	string	PDS ID of account.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Fees.Type	string	Fee type.
Accounts.Models	array	Account models.
Accounts.Models.Code	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.SortCode	string	Bank account sort code.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Bic	string	Bank identifier code (BIC) of your banking institution.
Accounts.BankAccounts.Iban	string	International bank account number (IBAN) of your banking institution.
Accounts.BankAccounts.RoutingNumber	string	Routing number of banking institution.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Code	string	Security code of the security.
Accounts.Exclusions.Security.Exchange	string	Exchange code of the security.
Accounts.InitialInvestment	object	Initial investment of account.
Accounts.InitialInvestment.Cash	double	Select if the initial investment will include cash.
Accounts.InitialInvestment.Shares	double	Select if the initial investment will include shares.
Accounts.InitialInvestment.Methodrequired	enum	ElectronicTransfer = 2, Cheque = 3.
Accounts.SourceOfFunds	string	Contribution source.
Accounts.OngoingFeeAmount	double	Ongoing fee amount.
Accounts.ReinvestIncome	boolean	Reinvest income.
Accounts.ProductId	string	Product ID.
Accounts.ProductProviderReference	string	Product provider reference.
Accounts.RegularContribution	object	Regular cash contributions to the account.
Accounts.RegularWithdrawal	object	Regular cash withdrawals from the account.
Accounts.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Accounts.Region	enum	Australia, UnitedKingdom or International.
Accounts.CurrencyCode	string	The currency code of the account.
Accounts.AdviserReference	string	Adviser reference..
Accounts.InSpecieCashStockTransfers	array	In specie cash stock transfers.
Accounts.InSpecieCashStockTransfers.TransferTyperequired	enum	StockAndCash = 0, CashOnly = 1.
Accounts.InSpecieCashStockTransfers.CedingPartyId	string	Ceding party ID.
Accounts.InSpecieCashStockTransfers.CedingAccountNumber	string	Ceding account number.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails	array	In specie cash stock transfer details.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.SecurityIsinrequired	string	Security ISIN of stock transfer.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.Quantity	double	Quantity of stock transfer.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.BookCost	double	Book cost of stock transfer.
Accounts.InSpecieCashStockTransfers.CashTransferAmount	double	Cash transfer amount.
Accounts.InSpecieCashStockTransfers.AmountUsedThisYear	double	Amount used this year.
Accounts.InSpecieCashStockTransfers.FeeAmount	double	Fee amount.
Accounts.InSpecieCashStockTransfers.FeePercent	double	Fee percent.
Accounts.IsTradeFreezeOn	boolean	If a trade freeze is on.
Accounts.TradeFreezeReason	enum	TransferIn = 0, TransferOut = 1, Incident = 2, Deceased = 3, RemovalOfAdviser = 4, AdviserInstructed = 5, Bespoke = 6.
Accounts.TradeFreezeNote	string	Trade freeze note.
Accounts.IllustrationData	object	Illustration data.
Accounts.IllustrationData.CostsAndCharges	array	Cost and charges.
Accounts.IllustrationData.CostsAndCharges.Type	enum	OneOffCharges = 0, OngoingCharges = 1, TransactionCharges = 2, IncidentalCharges = 3, ThirdPartyPayment = 4.
Accounts.IllustrationData.CostsAndCharges.Amount	double	Amount of cost and charge.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Trust Applicant & GIA Account - UK

Definition: https://api.onpraemium.com/api/application

This endpoint creates a Trust applicant and GIA account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 2,
      "TrustDetails": {
        "TrustName": "Test company",
        "NatureOfTrust": 1,
        "Lei": "123456",
        "DateOfEstablishment": "2020-01-01",
        "TaxDomicile": "some place",
        "Address": {
          "Addressee": "Test company",
          "Street": "Street A",
          "Postcode": "518000",
          "Suburb": "Kingston",
          "CountryCode": "CHN",
          "IsRegistered": true
        },
        "Signatories": [
          {
            "Capacity": 4,
            "Address": {
              "Addressee": "111 222",
              "Street": "Home",
              "Line2": null,
              "Line3": null,
              "Postcode": "u090",
              "Suburb": "Kingston",
              "CountryCode": "HKG",
              "IsRegistered": false
            },
            "TaxNumber": "ji000",
            "CountryOfBirth": "",
            "Title": "Miss",
            "FirstName": "111",
            "LastName": "222",
            "FullName": null,
            "DateOfBirth": "1998-12-01",
            "Email": "test@praemium.com",
            "Phone": "12345678",
            "NationalIdentifier": {
              "CountryOfNationality": "",
              "IdentifierType": 0,
              "IdentifierCode": "",
              "NoNationalIdentifier": true
            },
            "ReceiveCommunicationByPost": false,
            "IsPoliticallyExposedPerson": false
          }
        ],
        "CorporateTrustees": [
          {
            "Name": "Test company",
            "TradingName": "Test company",
            "CompanyType": 1,
            "BusinessAddress": {
              "Addressee": "Test company",
              "Street": "Street A",
              "Postcode": "518000",
              "Suburb": "Kingston",
              "CountryCode": "CHN",
              "IsRegistered": true
            },
            "MailingAddress": {
              "Addressee": "Test company",
              "Street": "Street A",
              "Postcode": "518000",
              "Suburb": "Kingston",
              "CountryCode": "CHN",
              "IsRegistered": true
            },
            "CompanyRegistrationNumber": "689",
            "TaxId": "6i87899",
            "Lei": "123456",
            "NameOfRegulator": "test regulator",
            "RegulatorReferenceNumber": "12345678",
            "Director": {
              "Address": {
                "Addressee": "111 222",
                "Street": "Home",
                "Line2": null,
                "Line3": null,
                "Postcode": "u090",
                "Suburb": "Kingston",
                "CountryCode": "HKG",
                "IsRegistered": false
              },
              "TaxNumber": "ji000",
              "CountryOfBirth": "",
              "Title": "Miss",
              "FirstName": "111",
              "LastName": "222",
              "FullName": null,
              "DateOfBirth": "1998-12-01",
              "Email": "test@praemium.com",
              "Phone": "12345678",
              "NationalIdentifier": {
                "CountryOfNationality": "",
                "IdentifierType": 0,
                "IdentifierCode": "",
                "NoNationalIdentifier": true
              },
              "ReceiveCommunicationByPost": false,
              "IsPoliticallyExposedPerson": true
            }
          }
        ]        
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Miss Jane Smith",
      "RegisteredName": "Miss Jane Smith",
      "ShortName": "Jane",
      "AccountType": 1,
      "PdsId": "UK5",
      "SourceOfFunds": "Loan",
      "AdviserReference": "123123",
      "OngoingFeeAmount": 2.5,
      "ReinvestIncome": false,
      "ProductId": "UK96",
      "ProductProviderReference": "Praemium International Limited",
      "RegularContribution": {
        "Amount": 150.5,
        "Method": 3,
        "Frequency": 0
      },
      "RegularWithdrawal": {
        "Amount": 120,
        "Method": 2,
        "Frequency": 0
      },
      "Region": 2,
      "CurrencyCode": "GBP",
      "Fees": [
        {
          "Id": "UK21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "UK0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "SortCode": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith"
        }
      ],
      "Exclusions": [
        {
          "Code": "UK0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestment": {
        "Cash": 132.12,
        "Shares": 321.32,
        "Method": 0
      },
      "IllustrationData": {
        "CostsAndCharges": [
          {
            "Type": 0,
            "Amount": 123.123
          },
          {
            "Type": 1,
            "Amount": 321.123
          },
          {
            "Type": 2,
            "Amount": 123.123
          }
        ]
      },
      "InSpecieCashStockTransfers": [
        {
          "TransferType": 0,
          "CedingPartyId": "UK29821",
          "CedingAccountNumber": "123456",
          "InSpecieCashStockTransferDetails": [
            {
              "SecurityIsin": "UK000000ROC4",
              "Quantity": 123.123,
              "BookCost": 3242.32432
            }
          ]
        }
      ],
      "IsTradeFreezeOn": true,
      "TradeFreezeReason": 4,
      "TradeFreezeNote": "just freeze it"
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Trust = 2.
Applicants.TrustDetails	object	Used for Trust applicants.
Applicants.TrustDetails.TrustName	string	Name of the trust.
Applicants.TrustDetails.NatureOfTrust	enum	Nature of the trust. Bare = 0, Charitable = 1, Will = 2, Interest in possession = 3, Discretionary = 4, Accumulation = 5, Settlor interested = 6, Granted = 7, Single Person Pension = 8, Multiple Member Personal Pension = 9, Single Member SSAS = 10, Multiple Member SSAS = 11, Loan = 12.
Applicants.TrustDetails.Lei	string	LEI of trust.
Applicants.TrustDetails.DateOfEstablishment	date-time	Date trust was established.
Applicants.TrustDetails.TaxDomicile	string	Tax domicile of trust.
Applicants.TrustDetails.BeneficiariesHaveVestedRights	boolean	If beneficiaries have vested rights.
Applicants.TrustDetails.Address	object	Address of Trust.
Applicants.TrustDetails.Address.Addressee	string	Addressee.
Applicants.TrustDetails.Address.Street	string	Address line 1.
Applicants.TrustDetails.Address.Line2	string	Address line 2.
Applicants.TrustDetails.Address.Line3	string	Address line 3.
Applicants.TrustDetails.Address.Postcode	string	Postcode of address.
Applicants.TrustDetails.Address.Suburb	string	Suburb of address.
Applicants.TrustDetails.Address.CountryCode	string	Country code of address.
Applicants.TrustDetails.Address.IsRegistered	boolean	Whether address is registered.
Applicants.TrustDetails.Signatories	array	Signatories of the trust.
Applicants.TrustDetails.Signatories.Capacity	enum	Trustee = 4, Beneficiary = 7.
Applicants.TrustDetails.Signatories.TaxNumber	string	Tax number of signatory.
Applicants.TrustDetails.Signatories.CountryOfBirth	string	Country of birth of signatory.
Applicants.TrustDetails.Signatories.Address	object	Address of signatory.
Applicants.TrustDetails.Signatories.Address.Addressee	string	Addressee.
Applicants.TrustDetails.Signatories.Address.Street	string	Address line 1.
Applicants.TrustDetails.Signatories.Address.Line2	string	Address line 2.
Applicants.TrustDetails.Signatories.Address.Line3	string	Address line 3.
Applicants.TrustDetails.Signatories.Address.Postcode	string	Postcode of address.
Applicants.TrustDetails.Signatories.Address.Suburb	string	Suburb of address.
Applicants.TrustDetails.Signatories.Address.CountryCode	string	Country code of address.
Applicants.TrustDetails.Signatories.Address.IsRegistered	boolean	Whether address is registered.
Applicants.TrustDetails.Signatories.Title	string	Title of signatory.
Applicants.TrustDetails.Signatories.FirstName	string	First name of signatory.
Applicants.TrustDetails.Signatories.LastName	string	Last name of signatory.
Applicants.TrustDetails.Signatories.DateOfBirth	date-time	Date of birth of signatory.
Applicants.TrustDetails.Signatories.Email	string	Email address of signatory.
Applicants.TrustDetails.Signatories.Phone	string	Phone number of signatory.
Applicants.TrustDetails.Signatories.PhoneOther	string	Secondary contact number of signatory.
Applicants.TrustDetails.Signatories.NationalIdentifier	object	Signatory's national identifier.
Applicants.TrustDetails.Signatories.NationalIdentifier.CountryOfNationality	string	Applicant's country of national identifier.
Applicants.TrustDetails.Signatories.NationalIdentifier.IdentifierType	enum	NoDocument = 0, NationalId = 1, Passport = 2, TaxNumber = 3, LEI = 4.
Applicants.TrustDetails.Signatories.NationalIdentifier.IdentifierCode	string	Applicant's national identifier code.
Applicants.TrustDetails.Signatories.ReceiveCommunicationByPost	boolean	If you would like to opt out of electronic communications.
Applicants.TrustDetails.Signatories.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Applicants.TrustDetails.CorporateTrustees	array	Corporate trustees of the trust.
Applicants.TrustDetails.CorporateTrustees.Name	string	Name of the corporate applicant.
Applicants.TrustDetails.CorporateTrustees.TradingName	string	Trading name of the corporate applicant.
Applicants.TrustDetails.CorporateTrustees.CompanyType	enum	Plc = 0, Ltd = 1, Llp = 2, Partnership = 3.
Applicants.TrustDetails.CorporateTrustees.BusinessAddress	object	Business address.
Applicants.TrustDetails.CorporateTrustees.BusinessAddress.Addressee	string	Addressee.
Applicants.TrustDetails.CorporateTrustees.BusinessAddress.Street	string	Address line 1.
Applicants.TrustDetails.CorporateTrustees.BusinessAddress.Line2	string	Address line 2.
Applicants.TrustDetails.CorporateTrustees.BusinessAddress.Line3	string	Address line 3.
Applicants.TrustDetails.CorporateTrustees.BusinessAddress.Postcode	string	Postcode of address.
Applicants.TrustDetails.CorporateTrustees.BusinessAddress.Suburb	string	Suburb of address.
Applicants.TrustDetails.CorporateTrustees.BusinessAddress.CountryCode	string	Country code of address.
Applicants.TrustDetails.CorporateTrustees.BusinessAddress.IsRegistered	boolean	Whether address is registered.
Applicants.TrustDetails.CorporateTrustees.MailingAddress	object	Mailing address.
Applicants.TrustDetails.CorporateTrustees.MailingAddress.Addressee	string	Addressee.
Applicants.TrustDetails.CorporateTrustees.MailingAddress.Street	string	Address line 1.
Applicants.TrustDetails.CorporateTrustees.MailingAddress.Line2	string	Address line 2.
Applicants.TrustDetails.CorporateTrustees.MailingAddress.Line3	string	Address line 3.
Applicants.TrustDetails.CorporateTrustees.MailingAddress.Postcode	string	Postcode of address.
Applicants.TrustDetails.CorporateTrustees.MailingAddress.Suburb	string	Suburb of address.
Applicants.TrustDetails.CorporateTrustees.MailingAddress.CountryCode	string	Country code of address.
Applicants.TrustDetails.CorporateTrustees.MailingAddress.IsRegistered	boolean	Whether address is registered.
Applicants.TrustDetails.CorporateTrustees.CompanyRegistrationNumber	string	Register number of the company.
Applicants.TrustDetails.CorporateTrustees.TaxId	string	Tax identity of the company.
Applicants.TrustDetails.CorporateTrustees.Lei	string	LEI of the Company.
Applicants.TrustDetails.CorporateTrustees.NameOfRegulator	string	Name of regulator.
Applicants.TrustDetails.CorporateTrustees.RegulatorReferenceNumber	string	Regulator reference number.
Applicants.TrustDetails.CorporateTrustees.Director	object	Director of the corporate trustee.
Applicants.TrustDetails.CorporateTrustees.Director.Title	string	Title of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.FirstNamerequired	string	First name of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.LastNamerequired	string	Last name of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.DateOfBirth	date-time	Date of birth of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.Email	string	Email address of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.Phone	string	Phone number of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.PhoneOther	string	Secondary contact number of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.Capacity	enum
Applicants.TrustDetails.CorporateTrustees.Director.TaxNumber	string	Tax number of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.CountryOfBirth	string	Country of birth of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.Address	object	Address of signatory.
Applicants.TrustDetails.CorporateTrustees.Director.Address.Addressee	string	Addressee.
Applicants.TrustDetails.CorporateTrustees.Director.Address.Streetrequired	string	Address line 1.
Applicants.TrustDetails.CorporateTrustees.Director.Address.Line2	string	Address line 2.
Applicants.TrustDetails.CorporateTrustees.Director.Address.Line3	string	Address line 3.
Applicants.TrustDetails.CorporateTrustees.Director.Address.Postcode	string	Postcode of address.
Applicants.TrustDetails.CorporateTrustees.Director.Address.Suburb	string	Suburb of address.
Applicants.TrustDetails.CorporateTrustees.Director.Address.CountryCode	string	Country code of address.
Applicants.TrustDetails.CorporateTrustees.Director.Address.IsRegistered	boolean	Whether address is registered.
Applicants.TrustDetails.CorporateTrustees.Director.NationalIdentifier	object	Signatory's national identifier.
Applicants.TrustDetails.CorporateTrustees.Director.NationalIdentifier.CountryOfNationality	string	Applicant's country of national identifier.
Applicants.TrustDetails.CorporateTrustees.Director.NationalIdentifier.IdentifierType	enum	NoDocument = 0, NationalId = 1, Passport = 2, TaxNumber = 3, LEI = 4.
Applicants.TrustDetails.CorporateTrustees.Director.NationalIdentifier.IdentifierCode	string	Applicant's national identifier code.
Applicants.TrustDetails.CorporateTrustees.Director.ReceiveCommunicationByPost	boolean	If you would like to opt out of electronic communications.
Applicants.TrustDetails.CorporateTrustees.Director.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	Gia = 1.
Accounts.PdsId	string	PDS ID of account.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Fees.Type	string	Fee type.
Accounts.Models	array	Account models.
Accounts.Models.Code	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.SortCode	string	Bank account sort code.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Bic	string	Bank identifier code (BIC) of your banking institution.
Accounts.BankAccounts.Iban	string	International bank account number (IBAN) of your banking institution.
Accounts.BankAccounts.RoutingNumber	string	Routing number of banking institution.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Code	string	Security code of the security.
Accounts.Exclusions.Security.Exchange	string	Exchange code of the security.
Accounts.InitialInvestment	object	Initial investment of account.
Accounts.InitialInvestment.Cash	double	Select if the initial investment will include cash.
Accounts.InitialInvestment.Shares	double	Select if the initial investment will include shares.
Accounts.InitialInvestment.Methodrequired	enum	ElectronicTransfer = 2, Cheque = 3.
Accounts.SourceOfFunds	string	Contribution source.
Accounts.OngoingFeeAmount	double	Ongoing fee amount.
Accounts.ReinvestIncome	boolean	Reinvest income.
Accounts.ProductId	string	Product ID.
Accounts.ProductProviderReference	string	Product provider reference.
Accounts.RegularContribution	object	Regular cash contributions to the account.
Accounts.RegularWithdrawal	object	Regular cash withdrawals from the account.
Accounts.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Accounts.Region	enum	Australia, UnitedKingdom or International.
Accounts.CurrencyCode	string	The currency code of the account.
Accounts.AdviserReference	string	Adviser reference..
Accounts.InSpecieCashStockTransfers	array	In specie cash stock transfers.
Accounts.InSpecieCashStockTransfers.TransferTyperequired	enum	StockAndCash = 0, CashOnly = 1.
Accounts.InSpecieCashStockTransfers.CedingPartyId	string	Ceding party ID.
Accounts.InSpecieCashStockTransfers.CedingAccountNumber	string	Ceding account number.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails	array	In specie cash stock transfer details.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.SecurityIsinrequired	string	Security ISIN of stock transfer.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.Quantity	double	Quantity of stock transfer.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.BookCost	double	Book cost of stock transfer.
Accounts.InSpecieCashStockTransfers.CashTransferAmount	double	Cash transfer amount.
Accounts.InSpecieCashStockTransfers.AmountUsedThisYear	double	Amount used this year.
Accounts.InSpecieCashStockTransfers.FeeAmount	double	Fee amount.
Accounts.InSpecieCashStockTransfers.FeePercent	double	Fee percent.
Accounts.IsTradeFreezeOn	boolean	If a trade freeze is on.
Accounts.TradeFreezeReason	enum	TransferIn = 0, TransferOut = 1, Incident = 2, Deceased = 3, RemovalOfAdviser = 4, AdviserInstructed = 5, Bespoke = 6.
Accounts.TradeFreezeNote	string	Trade freeze note.
Accounts.IllustrationData	object	Illustration data.
Accounts.IllustrationData.CostsAndCharges	array	Cost and charges.
Accounts.IllustrationData.CostsAndCharges.Type	enum	OneOffCharges = 0, OngoingCharges = 1, TransactionCharges = 2, IncidentalCharges = 3, ThirdPartyPayment = 4.
Accounts.IllustrationData.CostsAndCharges.Amount	double	Amount of cost and charge.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

POST Individual Applicant & ISA Account - UK

Definition: https://api.onpraemium.com/api/application

This endpoint creates a individual applicant and ISA account in the system.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AdviserId": 123456,
  "Applicants": [
    {
      "ApplicantType": 0,
      "IndividualDetails": {
        "Title": "Mr",
        "FirstName": "John",
        "LastName": "Smith",
        "Email": "j.smith@example.com",
        "Phone": "012489235",
        "PhoneOther": "012489235",
        "Gender": 1,
        "BirthCountryCode": "AUS",
        "DualNationality": false,
        "UsPerson": true,
        "Profession": "Software engineer",
        "SourceOfWealth": "Secret source",
        "TaxResidences": [
          {
            "CountryCode": "CAN",
            "From": "2020-10-01",
            "To": "2020-10-01",
            "Identification": "ui9089",
            "NoDocument": false
          }
        ],
        "HomeAddress": {
          "Addressee": "Yoki individual",
          "Street": "123 Test St",
          "Postcode": "BR5 4HL",
          "Suburb": "Orpington",
          "State": "KENT",
          "CountryCode": "UK"
        },
        "MailingAddress": {
          "Addressee": "Yoki individual",
          "Street": "123 Test St",
          "Postcode": "BR5 4HL",
          "Suburb": "Orpington",
          "State": "KENT",
          "CountryCode": "UK"
        },
        "NationalIdentifier": {
          "CountryOfNationality": "USA",
          "IdentifierType": 0,
          "IdentifierCode": "",
          "NoNationalIdentifier": true
        },
        "ReceiveCommunicationByPost": true,
        "IsPoliticallyExposedPerson": true
      }
    }
  ],
  "Accounts": [
    {
      "Name": "Miss Jane Smith",
      "RegisteredName": "Miss Jane Smith",
      "ShortName": "Jane",
      "AccountType": 1,
      "PdsId": "UK5",
      "SourceOfFunds": "Loan",
      "AdviserReference": "123123",
      "OngoingFeeAmount": 2.5,
      "ReinvestIncome": false,
      "ProductId": "UK96",
      "ProductProviderReference": "Praemium International Limited",
      "RegularContribution": {
        "Amount": 150.5,
        "Method": 3,
        "Frequency": 0
      },
      "RegularWithdrawal": {
        "Amount": 120,
        "Method": 2,
        "Frequency": 0
      },
      "Region": 2,
      "CurrencyCode": "GBP",
      "Fees": [
        {
          "Id": "UK21871",
          "Rate": 0,
          "Unit": "Dollar"
        }
      ],
      "Models": [
        {
          "Code": "UK0001",
          "Proportion": 50
        },
        {
          "Code": "IN0001",
          "Proportion": 50
        }
      ],
      "BankAccounts": [
        {
          "SortCode": "12012",
          "AccountNumber": "6555555567",
          "AccountName": "Jane Smith"
        }
      ],
      "Exclusions": [
        {
          "Code": "UK0002",
          "Exchange": "ASX"
        }
      ],
      "InitialInvestment": {
        "Cash": 132.12,
        "Shares": 321.32,
        "Method": 0
      },
      "IllustrationData": {
        "CostsAndCharges": [
          {
            "Type": 0,
            "Amount": 123.123
          },
          {
            "Type": 1,
            "Amount": 321.123
          },
          {
            "Type": 2,
            "Amount": 123.123
          }
        ]
      },
      "InSpecieCashStockTransfers": [
        {
          "TransferType": 0,
          "CedingPartyId": "UK29821",
          "CedingAccountNumber": "123456",
          "InSpecieCashStockTransferDetails": [
            {
              "SecurityIsin": "UK000000ROC4",
              "Quantity": 123.123,
              "BookCost": 3242.32432
            }
          ]
        }
      ],
      "IsTradeFreezeOn": true,
      "TradeFreezeReason": 4,
      "TradeFreezeNote": "just freeze it"
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AdviserIdrequired	integer	Adviser ID to create the application under.
OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicantsrequired	array	Objects containing the applicant data. There must be at least one applicant for the request to succeed. The array of objects may contain a mix of Individual and Corporate applicants.
Applicants.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Applicants.ApplicantType	enum	Individual = 0.
Applicants.IndividualDetails	object	Used for Individual applicants.
Applicants.IndividualDetails.CitizenshipCountryCode	string	Citizenship country code.
Applicants.IndividualDetails.BirthCountryCode	string	Birth country code.
Applicants.IndividualDetails.HomeAddress	object	Home address of individual applicant.
Applicants.IndividualDetails.HomeAddress.Addressee	string	Addressee.
Applicants.IndividualDetails.HomeAddress.Street	string	Address line 1.
Applicants.IndividualDetails.HomeAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.HomeAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.HomeAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.HomeAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.HomeAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.HomeAddress.IsRegistered	boolean	Whether address is registered.
Applicants.IndividualDetails.MailingAddress	object	Mailing address of individual applicant.
Applicants.IndividualDetails.MailingAddress.Addressee	string	Addressee.
Applicants.IndividualDetails.MailingAddress.Street	string	Address line 1.
Applicants.IndividualDetails.MailingAddress.Line2	string	Address line 2.
Applicants.IndividualDetails.MailingAddress.Line3	string	Address line 3.
Applicants.IndividualDetails.MailingAddress.Postcode	string	Postcode of address.
Applicants.IndividualDetails.MailingAddress.Suburb	string	Suburb of address.
Applicants.IndividualDetails.MailingAddress.CountryCode	string	Country code of address.
Applicants.IndividualDetails.MailingAddress.IsRegistered	boolean	Whether address is registered.
Applicants.IndividualDetails.Genderrequired	enum	Male = 1, Female = 2.
Applicants.IndividualDetails.UserName	string	User Name of individual applicant.
Applicants.IndividualDetails.UserId	string	User ID of individual applicant.
Applicants.IndividualDetails.TaxResidences	array	Applicant's tax residence.
Applicants.IndividualDetails.TaxResidences.CountryCode	string	Tax residence country code.
Applicants.IndividualDetails.TaxResidences.From	date-time	From date that applicant held tax residence in that country.
Applicants.IndividualDetails.TaxResidences.To	date-time	To date that applicant held tax residence in that country.
Applicants.IndividualDetails.TaxResidences.Identification	string	Tax residence identification.
Applicants.IndividualDetails.TaxResidences.NoDocument	boolean	If the applicant does not hold a identification document.
Applicants.IndividualDetails.UsPerson	boolean	Select if applicant is from the US.
Applicants.IndividualDetails.SourceOfWealth	string	Provide the applicant's source of wealth.
Applicants.IndividualDetails.Profession	string	Provide the applicant's profession.
Applicants.IndividualDetails.Title	string	Title: Mr, Mrs, Ms, Miss, Doctor, Lady, Prof and Sir.
Applicants.IndividualDetails.FirstName	string	First name of individual.
Applicants.IndividualDetails.LastName	string	Last name of individual.
Applicants.IndividualDetails.DateOfBirth	date-time	Date of birth of the individual.
Applicants.IndividualDetails.Email	string	Email address of the individual.
Applicants.IndividualDetails.Phone	string	Primary contact number of the individual.
Applicants.IndividualDetails.PhoneOther	string	Other phone of the individual.
Applicants.IndividualDetails.NationalIdentifier	object	Individual's national identifier.
Applicants.IndividualDetails.NationalIdentifier.CountryOfNationality	string	Applicant's country of national identifier.
Applicants.IndividualDetails.NationalIdentifier.IdentifierType	enum	NoDocument = 0, NationalId = 1, Passport = 2, TaxNumber = 3, LEI = 4.
Applicants.IndividualDetails.NationalIdentifier.IdentifierCode	string	Applicant's national identifier code.
Applicants.IndividualDetails.ReceiveCommunicationByPost	boolean	If you would like to opt out of electronic communications.
Applicants.IndividualDetails.IsPoliticallyExposedPerson	boolean	Whether applicant is politically exposed.
Accounts	array	Array of accounts to be opened with the application. Must be linked to an included applicant.
Accounts.Name	string	Account name.
Accounts.RegisteredName	string	Account registered name.
Accounts.ShortName	string	Account short name.
Accounts.AccountTyperequired	enum	Isa = 0.
Accounts.PdsId	string	PDS ID of account.
Accounts.Fees	array	Account fees.
Accounts.Fees.Id	string	Fee ID.
Accounts.Fees.Rate	double	Fee rate.
Accounts.Fees.Unit	string	Fee unit, dollars or percentage.
Accounts.Fees.Type	string	Fee type.
Accounts.Models	array	Account models.
Accounts.Models.Code	string	Model code.
Accounts.Models.Proportion	double	Proportion of model.
Accounts.BankAccounts	array	Bank accounts.
Accounts.BankAccounts.SortCode	string	Bank account sort code.
Accounts.BankAccounts.AccountNumber	string	Bank account number.
Accounts.BankAccounts.AccountName	string	Bank account name.
Accounts.BankAccounts.Bic	string	Bank identifier code (BIC) of your banking institution.
Accounts.BankAccounts.Iban	string	International bank account number (IBAN) of your banking institution.
Accounts.BankAccounts.RoutingNumber	string	Routing number of banking institution.
Accounts.Exclusions	array	Account exclusions.
Accounts.Exclusions.Security	object	Security code of the exclusion.
Accounts.Exclusions.Security.Code	string	Security code of the security.
Accounts.Exclusions.Security.Exchange	string	Exchange code of the security.
Accounts.InitialInvestment	object	Initial investment of account.
Accounts.InitialInvestment.Cash	double	Select if the initial investment will include cash.
Accounts.InitialInvestment.Shares	double	Select if the initial investment will include shares.
Accounts.InitialInvestment.Methodrequired	enum	ElectronicTransfer = 2, Cheque = 3.
Accounts.SourceOfFunds	string	Contribution source.
Accounts.OngoingFeeAmount	double	Ongoing fee amount.
Accounts.ReinvestIncome	boolean	Reinvest income.
Accounts.ProductId	string	Product ID.
Accounts.ProductProviderReference	string	Product provider reference.
Accounts.RegularContribution	object	Regular cash contributions to the account.
Accounts.RegularWithdrawal	object	Regular cash withdrawals from the account.
Accounts.OwnerAdviserId	integer	Owner adviser ID to create the application under.
Accounts.Region	enum	Australia, UnitedKingdom or International.
Accounts.CurrencyCode	string	The currency code of the account.
Accounts.AdviserReference	string	Adviser reference..
Accounts.InSpecieCashStockTransfers	array	In specie cash stock transfers.
Accounts.InSpecieCashStockTransfers.TransferTyperequired	enum	StockAndCash = 0, CashOnly = 1.
Accounts.InSpecieCashStockTransfers.CedingPartyId	string	Ceding party ID.
Accounts.InSpecieCashStockTransfers.CedingAccountNumber	string	Ceding account number.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails	array	In specie cash stock transfer details.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.SecurityIsinrequired	string	Security ISIN of stock transfer.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.Quantity	double	Quantity of stock transfer.
Accounts.InSpecieCashStockTransfers.InSpecieCashStockTransferDetails.BookCost	double	Book cost of stock transfer.
Accounts.InSpecieCashStockTransfers.CashTransferAmount	double	Cash transfer amount.
Accounts.InSpecieCashStockTransfers.AmountUsedThisYear	double	Amount used this year.
Accounts.InSpecieCashStockTransfers.FeeAmount	double	Fee amount.
Accounts.InSpecieCashStockTransfers.FeePercent	double	Fee percent.
Accounts.IsTradeFreezeOn	boolean	If a trade freeze is on.
Accounts.TradeFreezeReason	enum	TransferIn = 0, TransferOut = 1, Incident = 2, Deceased = 3, RemovalOfAdviser = 4, AdviserInstructed = 5, Bespoke = 6.
Accounts.TradeFreezeNote	string	Trade freeze note.
Accounts.IllustrationData	object	Illustration data.
Accounts.IllustrationData.CostsAndCharges	array	Cost and charges.
Accounts.IllustrationData.CostsAndCharges.Type	enum	OneOffCharges = 0, OngoingCharges = 1, TransactionCharges = 2, IncidentalCharges = 3, ThirdPartyPayment = 4.
Accounts.IllustrationData.CostsAndCharges.Amount	double	Amount of cost and charge.

Response Examples

# 200 - OK
{
  "ApplicationId": "c1bdac67-39a0-4835-8168-e99f44f01iu7"
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.

GET Application Status

Definition: https://api.onpraemium.com/api/application/{ApplicationId}/status

This endpoint returns the status of the application. This can be used to check which state an application is in, and the awaiting action.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameters - Path Examples

ApplicationId: XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

Request Parameters - Path

Parameter	Type	Description
ApplicationIdrequired	string	Unique application ID to be used as an application reference.

Response Examples

# 200 - OK
{
  "ApplicationId": "83225a21-1e9e-9ty1-b35a-6f1091c7a434",
  "Status": "Submitted",
  "AccountsStatus": [
    {
      "AccountCode": "SMA00400000",
      "Status": "ClosureRequested"
    }
  ]
}

Response Parameters

Parameter	Type	Description
ApplicationId	string	Unique application ID to be used as an application reference.
Status	string	Draft / Submitted.
AccountsStatus	array	Account status.
AccountsStatus.AccountCode	string	Account code.
AccountsStatus.Status	enum	Draft = 0, AwaitingSignature = 1, AwaitingApproval = 2, AwaitingFund = 3, Funded = 4, Trading = 5, ClosureRequested = 6, Closed = 7, Deleted = 8.

Accounts

GET Accounts

Definition: https://api.onpraemium.com/api/accounts

This endpoint returns a list of accounts.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

# Search by string
Search: *01
Page: 1
Size: 100

# Search by account IDs
AccountIds: AU1
AccountIds: AU2
AccountIds: AU3

Request Parameter - Query

Parameter	Type	Description
Search	string	Account search string. This parameter accepts wildcards (*).
AccountIds	array	An array of account IDs. If AccountIds are provided, all other parameters will be ignored.
Page	integer	Page number to return. Default to 1.
Size	integer	Page size to return. Default to 100 accounts per page.

Response Examples

# 200 - OK
[
  {
    "Id": "AU251995",
    "Code": "240153Cons",
    "Name": "Test account 1",
    "ValuationDate": "2020-12-24T00:00:00+11:00",
    "ConsolidationType": 84,
    "AccountType": 0,
    "EntityType": 4,
    "IsSma": false,
    "Status": 0,
    "RecalcType": 2,
    "RecalcStatus": 0
  },
  {
    "Id": "AU252176",
    "Code": "WalshCons",
    "Name": "Test account 2",
    "ValuationDate": "2019-07-11T00:00:00+11:00",
    "ConsolidationType": 84,
    "AccountType": 0,
    "EntityType": 4,
    "IsSma": false,
    "Status": 0,
    "RecalcType": 1,
    "RecalcStatus": 1
  }
  {
    "Id": "AU275166",
    "Code": "SMA00275165_EXT",
    "Name": "Test account 3",
    "ValuationDate": "2018-07-30T00:00:00+11:00",
    "ConsolidationType": 78,
    "AccountType": 0,
    "EntityType": 4,
    "IsSma": true,
    "Status": 0,
    "RecalcType": 1,
    "RecalcStatus": 0
  }
]

Response Parameters

Parameter	Type	Description
Data	array
Data.Id	string	Account ID.
Data.Code	string	Account code.
Data.Name	string	Account name.
Data.ValuationDate	date-time	Account valuation date or asat date.
Data.ConsolidationType	enum	None = 78, Portfolio = 80, Transaction = 84, FeeGroup = 85, ShareTrader = 86, SuperFund = 87.
Data.AccountType	enum	Standard = 0, Sma = 1, Smsf = 3, SuperSmaAccumulation = 4, SuperSmaPension = 5.
Data.EntityType	enum	Individual = 0, Trust = 1, Corporate = 2, Partnership = 3, Superfund = 4, Joint = 5.
Data.IsSma	boolean	Whether the account is SMA.
Data.Status	enum	Active = 0, Draft = 1, Closed = 2, Deleted = 3.
Data.RecalcType	enum	None = 0, Manual = 1, Auto = 2.
Data.RecalcStatus	enum	OK = 0, Error = 1.
Metadata	object
Metadata.TotalCount	integer	Total number of results found.
Metadata.TotalPages	integer	Total pages of results.

GET Child Accounts

Definition: https://api.onpraemium.com/api/childaccounts

This endpoint returns child accounts for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.

Response Examples

# 200 - OK
[
  {
    "Id": "AU251995"
  },
  {
    "Id": "AU252176"
  }
  {
    "Id": "AU275166"
  }
]

Response Parameters

Parameter	Type	Description
Id	string	Child account ID.

GET Recalc Status

Definition: https://api.onpraemium.com/api/recalc/status

This endpoint returns recalc status for the service.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Response Examples

# 200 - OK
{
  "RecalcAsAtDate": "2021-03-03T00:00:00+11:00"
}

Response Parameters

Parameter	Type	Description
RecalcAsAtDate	date-time	Recalc date.

App Form

GET App Form

Definition: https://api.onpraemium.com/api/appform

This endpoint returns a PDF version of the application form for the specified account. This is a confirmation to the client of the details of their account. The PDF is returned directly as the response.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
Recipient: 0
FormType: 0

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
Recipient	enum	Adviser = 0, Investor = 1 (UK only)
FormType	enum	Digital = 0, Paper = 1 (UK only)

Response Examples

# 200 - OK
Complete data stream of the file content.

Account Model Weightings

GET Account Model Weightings

Definition: https://api.onpraemium.com/api/accountmodelweightings

This endpoint returns the account model weightings for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.

Response Examples

# 200 - OK
[
  {
    "ModelCode": "MACAUD",
    "Percent": 100.0
  }
]

Response Parameters

Parameter	Type	Description
ModelCode	string	Model code.
Percentage	double	Model percentage.

PUT Account Model Weightings

Definition: https://api.onpraemium.com/api/accountmodelweightings

This endpoint allows you to modify the account model weightings for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AccountId": "AU400000",
  "AccountModelWeightings": [
    {
      "ModelCode": "MACAUD",
      "Percent": 100
    }    
  ]
}

Request Parameter - Body

Parameter	Type	Description
AccountIdrequired	string	Account ID.
RebalanceTyperequired	enum	Floating = 0, Fixed = 1.
AccountModelWeightingsrequired	array	Account Model Weightings.
AccountModelWeightings.ModelCode	string	Model code.
AccountModelWeightings.Percentage	double	Model percentage.

Response Examples

# 204 - NoContent

Definition: https://api.onpraemium.com/api/ssologin

This endpoint is to authenticate a user's access to the Praemium API. It returns a URL that contains a one-time security token. By accessing this URL, an authenticated user will be logged in without having to specify the user's credentials again.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "UserId": 1234,
  "Application": 0
}

Request Parameter - Body

Parameter	Type	Description
Applicationrequired	enum	The ID of the application the user will be sent to once logged in. Platform = 0, InvestorPortal = 1, AdviserPortal = 2, ApplicationPortal = 3.
UserIdrequired	integer	The ID of the user to log in. Either UserId or Username is required.

Response Examples

# 200 - OK
{
  "SsoUrl": "https://login.onpraemium.com/useraccount/sso?token=XXXXXX-XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX-XXXXXXXXXXXXXXXXXX"
}

Response Parameters

Parameter	Type	Description
SsoUrl	string	SSO URL.

Users

GET User

Definition: https://api.onpraemium.com/api/user/{username}

This endpoint returns the user links for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameters - Path Examples

UserName: john_smith

Request Parameters - Path

Parameter	Type	Description
UserNamerequired	string	User name.

Response Examples

# 200 - OK
{
  "UserId": 123456
}

Response Parameters

Parameter	Type	Description
UserId	integer	User ID.

Ceding Parties

GET Ceding Parties

Definition: https://api.onpraemium.com/api/cedingparties

This endpoint returns the ceding parties details for the service.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountType: 15
Search: ROC

Request Parameter - Query

Parameter	Type	Description
AccountType	enum	Isa = 15, Gia = 16.
Searchrequired	string	Search for Ceding party.

Response Examples

# 200 - OK (UK response)
[
  {
    "CedingPartyId": "UK1",
    "CedingPartyName": "Test Ceding Party",
    "AcceptsElectronicTransfer": true
  }
]

Response Parameters

Parameter	Type	Description
CedingPartyId	string	Ceding party ID.
CedingPartyName	string	Ceding party name.
AcceptsElectronicTransfer	boolean	Ceding party accepts electronic transfers.

Securities

GET Securities

Definition: https://api.onpraemium.com/api/securities

This endpoint returns the securties details for the service.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

# Search by string
Search: BHP
PdsId: AU123

# Search by security IDs
SecurityIds: AU1
SecurityIds: AU2
SecurityIds: AU3

# Search by security codes
SecurityCodes: BHP.ASX
SecurityCodes: PPS.ASX

Request Parameter - Query

Parameter	Type	Description
Search	string	Search term based on security code or security description.
PdsIdrequired	string	PDS ID. (AU only)
SecurityIds	array	A list of security IDs to search. If SecurityIds are provided, Search and SecurityCodes will be ignored.
SecurityCodes	array	A list of security codes to search. If SecurityCodes are provided, Search and SecurityIds will be ignored.

Response Examples

# 200 - OK (AU response)
[
  {
    "Id": "AU94",
    "Code": "BHP",
    "Description": "BHP GROUP LIMITED FPO",
    "Isin": "AU000000BHP4",
    "Exchange": "ASX",
    "Currency": "AUD",
    "IsAllowedByApl": true
  }
]

# 200 - OK (UK response)
[
  {
    "Id": "UK1000000993",
    "Code": "ROC",
    "Description": "ROC OIL CO LTD NPV",
    "Isin": "AU000000ROC4",
    "Exchange": "LON",
    "Currency": "GBP"
  }
]

Response Parameters

Parameter	Type	Description
Id	string	Security ID.
Code	string	Security code.
Description	string	Description.
Isin	string	ISIN of security.
Exchange	string	Exchange of security.
Currency	string	Currency of security.
IsAllowedByApl	boolean	Is the security allowed by the Approved Product List.

SecurityExclusions

GET Security Exclusions

Definition: https://api.onpraemium.com/api/securityexclusions

This endpoint returns security exclusions for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.

Response Examples

# 200 - OK
[
  {
    "CreatedDate": "2019-12-09T15:20:00.237+11:00",
    "Security": {
      "Code": "WPL",
      "Exchange": "ASX"
    }
  },
  {
    "CreatedDate": "2020-01-10T10:13:54.67+11:00",
    "Security": {
      "Code": "S32",
      "Exchange": "ASX"
    }
  }
]

Response Parameters

Parameter	Type	Description
CreatedDate	date-time	Date security exclusion was created.
Security	object	Security name.
Security.Code	string	Security code.
Security.Exchange	string	Security exchange.

PUT Security Exclusions

Definition: https://api.onpraemium.com/api/securityexclusions

This endpoint allows you to replace security exclusions for the account. If a blank array of SecurityExclusions is sent as a body parameter, all exclusions will be removed.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AccountId": "AU400000",
  "SecurityExclusions": [
      {
          "SecurityId": "AU1"
      },
      {
          "SecurityId": "AU2"
      }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AccountIdrequired	string	Account ID.
SecurityExclusions	array	Security exclusion.
SecurityExclusions.SecurityIdrequired	string	Security ID.

Response Examples

# 204 - NoContent

POST Security Exclusions

Definition: https://api.onpraemium.com/api/securityexclusions

This endpoint allows you to add security exclusions for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AccountId": "AU400000",
  "SecurityExclusions": [
      {
          "SecurityId": "AU1"
      },
      {
          "SecurityId": "AU2"
      }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AccountIdrequired	string	Account ID.
SecurityExclusions	array	Security exclusion.
SecurityExclusions.SecurityIdrequired	string	Security ID.

Response Examples

# 204 - NoContent

DELETE Security Exclusions

Definition: https://api.onpraemium.com/api/securityexclusions

This endpoint allows you to delete security exclusions for the account. If SecurityId is provided, the single exclusion will be removed. If SecurityId is not provided, all exclusions will be removed.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
SecurityId: AU1

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
SecurityId	string	Security ID.

Response Examples

# 204 - NoContent

SecuritySubstitutions

GET Security Substitutions

Definition: https://api.onpraemium.com/api/securitysubstitutions

This endpoint returns security substitutions for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.

Response Examples

# 200 - OK
[
  {
    "CreatedDate": "2021-02-16T16:17:07.61+11:00",
    "FromSecurity": {
      "Code": "SEK",
      "Exchange": "ASX"
    },
    "ToSecurity": {
      "Code": "JBH",
      "Exchange": "ASX"
    }
  },
  {
    "CreatedDate": "2021-02-16T16:17:09.307+11:00",
    "FromSecurity": {
      "Code": "CBA",
      "Exchange": "ASX"
    },
    "ToSecurity": {
      "Code": "NAB",
      "Exchange": "ASX"
    }
  }
]

Response Parameters

Parameter	Type	Description
CreatedDate	date-time	Date security substitution was created.
FromSecurity	object	From security.
FromSecurity.Code	string	Security code.
FromSecurity.Exchange	string	Security exchange.
ToSecurity	object	To security.
ToSecurity.Code	string	Security code.
ToSecurity.Exchange	string	Security exchange.

PUT Security Substitutions

Definition: https://api.onpraemium.com/api/securitysubstitutions

This endpoint allows you to replace security substitutions for the account.If a blank array of SecuritySubstitutions is sent as a body parameter, all substitutions will be removed.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AccountId": "AU400000",
  "SecuritySubstitutions": [
      {
          "FromSecurityId": "AU1",
          "ToSecurityId": "AU2"
      }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AccountIdrequired	string	Account ID.
SecuritySubstitutions	array	Security substitution.
SecuritySubstitutions.FromSecurityIdrequired	string	From security ID.
SecuritySubstitutions.ToSecurityIdrequired	string	To security ID.

Response Examples

# 204 - NoContent

POST Security Substitutions

Definition: https://api.onpraemium.com/api/securitysubstitutions

This endpoint allows you to add security substitutions for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AccountId": "AU400000",
  "SecuritySubstitutions": [
      {
          "FromSecurityId": "AU1",
          "ToSecurityId": "AU2"
      }
  ]
}

Request Parameter - Body

Parameter	Type	Description
AccountIdrequired	string	Account ID.
SecuritySubstitutions	array	Security substitution.
SecuritySubstitutions.FromSecurityIdrequired	string	From security ID.
SecuritySubstitutions.ToSecurityIdrequired	string	To security ID.

Response Examples

# 204 - NoContent

DELETE Security Substitutions

Definition: https://api.onpraemium.com/api/securitysubstitutions

This endpoint allows you to delete security substitutions for the account. If FromSecurityId and ToSecurityId are provided, the single substitution will be removed. If FromSecurityId and ToSecurityId are not provided, all substitutions will be removed.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromSecurityId: AU1
ToSecurityId: AU2

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromSecurityId	string	Security ID to substitute from.
ToSecurityId	string	Security ID to substitute to.

Response Examples

# 204 - NoContent

MinimumTradeSize

GET Minimum Trade Size

Definition: https://api.onpraemium.com/api/minimumtradesize

This endpoint returns minimum trade size for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.

Response Examples

# 200 - OK
{
  "Amount": 10.0,
  "Percentage": 20.5128,
  "Units": 2.0
}

Response Parameters

Parameter	Type	Description
Amount	double	Rebalance tolerance amount. Prevents trades of a value less than this figure.
Percentage	double	Rebalance tolerance percentage. Prevents trades unless they exceed this figure as a percentage of the portfolio’s value. For example, if this is set to 5, only trades that exceed five percent of the portfolio’s total value are performed.
Units	double	Rebalance tolernace number of units. Prevents trades of a quantity less than this figure.

PATCH Minimum Trade Size

Definition: https://api.onpraemium.com/api/minimumtradesize

This endpoint allows you to update minimum trade size for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "AccountId": "AU400000",
  "Amount": 10.0,
  "Percentage": 20.5128,
  "Units": 2.0
}

Request Parameter - Body

Parameter	Type	Description
AccountIdrequired	string	Account ID.
Amountrequired	double	Minimum trade size amount. Prevents trades of a value less than this figure.
Percentagerequired	double	Minimum trade size percentage. Prevents trades unless they exceed this figure as a percentage of the portfolio’s value. For example, if this is set to 5, only trades that exceed five percent of the portfolio’s total value are performed.
Unitsrequired	double	Minimum trade size number of units. Prevents trades of a quantity less than this figure.

Response Examples

# 204 - NoContent

Valuation

GET Asset Class Summary

Definition: https://api.onpraemium.com/api/assetclasssummary

This endpoint returns asset class summary for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
IncludeLoans: true
ValuationDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
IncludeLoans	boolean	Whether loans should be included.
ValuationDaterequired	date-time	Date used to display the data.

Response Examples

# 200 - OK
{
  "Valuation": {
    "TotalCost": 105741.30,
    "TotalValue": 115489.95,
    "NetValue": 115489.95,
    "TotalGainOrLoss": 9748.65
  },
  "AssetClasses": [
    {
      "AssetClassDescription": "Domestic Shares",
      "Value": 103780.00,
      "PercentTotalValue": 89.8600,
      "PercentNetValue": 89.8600,
      "MinTargetAllocation": 0.0,
      "MaxTargetAllocation": 0.0,
      "MidPointTargetAllocation": 0.0,
      "Variance": 0.8986
    },
    {
      "AssetClassDescription": "Domestic Fixed Interest",
      "Value": 53849.52,
      "PercentTotalValue": 46.6300,
      "PercentNetValue": 46.6300,
      "MinTargetAllocation": 0.0,
      "MaxTargetAllocation": 0.0,
      "MidPointTargetAllocation": 0.0,
      "Variance": 0.4663
    },
    {
      "AssetClassDescription": "Cash & Equivalents",
      "Value": -42139.57,
      "PercentTotalValue": -36.4900,
      "PercentNetValue": -36.4900,
      "MinTargetAllocation": 0.0,
      "MaxTargetAllocation": 0.0,
      "MidPointTargetAllocation": 0.0,
      "Variance": -0.3649
    }
  ],
  "ReceivablesAndPayables": [
    {
      "Description": "Income declared but not paid",
      "TotalAmount": 20.93,
      "IncludedInNetValue": true
    },
    {
      "Description": "Unsettled transactions",
      "TotalAmount": -50326.38,
      "IncludedInNetValue": true
    }
  ]
}

Response Parameters

Parameter	Type	Description
Valuation	object
Valuation.TotalCost	double	The total account cost based on the cost base of unrealised holdings. (Account currency)
Valuation.TotalValue	double	The total account value based on the quantity and price of unrealised holdings. (Account currency)
Valuation.NetValue	double	The total account value inclusive of receivables and payables. (Account currency)
Valuation.TotalGainOrLoss	double	Total Gain/Loss is the nominal difference between the total value and the total cost. (Account currency)
AssetClasses	array
AssetClasses.AssetClassDescription	string	A description of the asset class.
AssetClasses.Value	double	The total value of the account holdings within the asset class. (Account currency)
AssetClasses.PercentTotalValue	double	The percentage ratio of the value of this asset class to the total account value.
AssetClasses.PercentNetValue	double	The percentage ratio of the value of this asset class to the net account value.
AssetClasses.MinTargetAllocation	double	The minimum asset class allocation target for this asset class entered for the account.
AssetClasses.MaxTargetAllocation	double	The maximum asset class allocation target for this asset class entered for the account.
AssetClasses.MidPointTargetAllocation	double	The middle value of the minimum and maximum target allocation for the asset class.
AssetClasses.Variance	double	The variance of the asset class’s value outside of the target allocation range.
ReceivablesAndPayables	array
ReceivablesAndPayables.Description	string	Description of the receivable / payable holding.
ReceivablesAndPayables.TotalAmount	double	Amount of the receivable / payable. (Account currency)
ReceivablesAndPayables.IncludedInNetValue	boolean	Whether included in the account's net value.

GET Holdings By Model

Definition: https://api.onpraemium.com/api/holdingsbymodel

This endpoint returns holdings by model for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
[
  {
    "Date": "2021-01-28T00:00:00+11:00",
    "TotalValue": 0.00,
    "HoldingsByModel": [
      {
        "ModelCode": "IV0008",
        "ModelDescription": "Intelligent Investor Equity Income",
        "ModelPercentage": 1.000000,
        "Holdings": [
          {
            "Asset": "AUDDIVSNOTPAID",
            "Value": 184.91,
            "Quantity": 184.91
          }
        ]
      }
    ],
    "HoldingsNotInModel": [
      {
        "Asset": "AUDCASH",
        "ExchangeCode": "UNL",
        "Value": 1.85,
        "Quantity": 1.85
      }
    ]
  },
  {
    "Date": "2021-01-29T00:00:00+11:00",
    "TotalValue": 74020.56,
    "HoldingsByModel": [
      {
        "ModelCode": "IV0008",
        "ModelDescription": "Intelligent Investor Equity Income",
        "ModelPercentage": 0.981300,
        "Holdings": [
          {
            "Asset": "AUDCASH",
            "ExchangeCode": "UNL",
            "Value": 810.98,
            "Quantity": 810.98
          },
          {
            "Asset": "INIF",
            "ExchangeCode": "ASX",
            "Value": 71826.54,
            "Quantity": 28846.00
          }
        ]
      },
      {
        "ModelCode": "MACAUD",
        "ModelDescription": "Managed Account Cash AUD",
        "ModelPercentage": 0.008700,
        "Holdings": [
          {
            "Asset": "AUDCASH",
            "ExchangeCode": "UNL",
            "Value": 642.83,
            "Quantity": 642.83
          }
        ]
      }
    ],
    "HoldingsNotInModel": [
      {
        "Asset": "AUDCASH",
        "ExchangeCode": "UNL",
        "Value": 740.21,
        "Quantity": 740.21
      }
    ]
  }
]

Response Parameters

Parameter	Type	Description
Date	date-time	The date that these holdings relate to.
TotalValue	double	The total value of the account on the date. (Account currency)
HoldingsByModel	array	Holdings that are held by the account due to its model subscriptions.
HoldingsByModel.ModelCode	string	Model code.
HoldingsByModel.ModelPercentage	double	Percentage of the model.
HoldingsByModel.Holdings	array	Contains the holdings attributable to the model on the date.
HoldingsByModel.Holdings.Security	object
HoldingsByModel.Holdings.Security.Code	string	Security code.
HoldingsByModel.Holdings.Security.Exchange	string	Security exchange.
HoldingsByModel.Holdings.Value	double	The value that is attributable to this model on the date. (Account currency)
HoldingsByModel.Holdings.Quantity	double	The quantity that is attributable to this model on the date. Please note that this may not be a whole number of shares because we blend holdings within our system in order to give a better investment outcome..
HoldingsNotInModel	array	Hikdubgs that are not attributable to a model on the date. This can be due to holding locks or other customisations. The value and quantity of the HoldingsNotInModel relate to the values that are not attributable to any subscribed model.
HoldingsNotInModel.Security	object
HoldingsNotInModel.Security.Code	string	Security code.
HoldingsNotInModel.Security.Exchange	string	Security exchange.
HoldingsNotInModel.Value	double	The value that is attributable to this model on the date. (Account currency)
HoldingsNotInModel.Quantity	double	The quantity that is attributable to this model on the date. Please note that this may not be a whole number of shares because we blend holdings within our system in order to give a better investment outcome..

GET Bulk Valuation

Definition: https://api.onpraemium.com/api/bulkvaluation

This endpoint returns bulk valuation for the accounts.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountIds: AU1
AccountIds: AU2
AccountIds: AU3
ValuationDate: 2021-02-23T00:00:00Z
ClassificationType: 1

Request Parameter - Query

Parameter	Type	Description
ValuationDaterequired	date-time	Date used to display the data.
ClassificationTyperequired	enum	AssetClassLookThrough = 1, AssetClassPrimaryClass = 2, MarketType = 3.

Response Examples

# 200 - OK
[
  {
    "AccountId": "AU112916",
    "Valuation": {
      "ValuationDate": "2021-02-18T11:00:00+11:00",
      "TotalCost": 16647.42,
      "TotalValue": 20250.58,
      "NetValue": 20250.58,
      "TotalGainOrLoss": 3603.16,
      "EstimatedIncome": 427.05,
      "Yield": 2.1100
    },
    "Holdings": [
      {
        "Security": {
          "AssetClassDescription": "Cash & Equivalents",
          "AssetClassCode": "ASX",
          "TypeDescription": "ASX Listed",
          "GicsDescription": "SECTOR NOT CLASSIFIED",
          "Code": "AAA"
        },
        "Quantity": 17.0000,
        "UnitCost": 50.2132,
        "Cost": 853.62,
        "UnitValue": 50.07,
        "UnitPriceDate": "2021-02-18T00:00:00+11:00",
        "Value": 851.19,
        "PercentTotalValue": 4.200,
        "GainOrLoss": -2.43,
        "PercentTotalGainOrLoss": -0.28,
        "EstimatedIncome": 5.76,
        "Yield": 0.6800,
        "ValueInSecurityCurrency": 851.19,
        "CostBaseUnknown": false,
        "TaxCredits": 0.0000,
        "EstimatedFrankingCredits": 0.000000,
        "EstimatedGrossYield": 0.6800
      },
      {
        "Security": {
          "AssetClassDescription": "International Shares",
          "AssetClassCode": "ASX",
          "TypeDescription": "ASX Listed",
          "GicsDescription": "SECTOR NOT CLASSIFIED",
          "Code": "IAA"
        },
        "Quantity": 3.0000,
        "UnitCost": 75.8367,
        "Cost": 227.51,
        "UnitValue": 131.75,
        "UnitPriceDate": "2021-02-18T00:00:00+11:00",
        "Value": 395.25,
        "PercentTotalValue": 1.9500,
        "GainOrLoss": 167.74,
        "PercentTotalGainOrLoss": 73.73,
        "EstimatedIncome": 3.44,
        "Yield": 0.8700,
        "ValueInSecurityCurrency": 395.25,
        "CostBaseUnknown": false,
        "TaxCredits": 0.0000,
        "EstimatedFrankingCredits": 0.000000,
        "EstimatedGrossYield": 0.8700
      }
    ],
    "ReceivablesAndPayables": [
      {
        "Code": "LOAN_1",
        "Description": "Loans",
        "TypeDescription": "Loans",
        "Amount": 18881.01,
        "IncludedInNetValue": 1
      },
      {
        "Code": "AUDDIVSNOTPAID",
        "Description": "Income declared but not paid",
        "TypeDescription": "",
        "Amount": 18881.01,
        "IncludedInNetValue": 1
      }
    ],
    "Subscriptions": {
      {
        "Models": [
          {
            "ModelCode": "AU00",
            "Weighting": 50.1234
          },
          {
            "ModelCode": "AU000",
            "Weighting": 47.8766
          }
        ],
        "CashHub": {
          "AUD": 2
        }
      }
    }
  }
]

Response Parameters

Parameter	Type	Description
AccountId	string	Account ID.
Valuation	object
Valuation.ValuationDate	date-time	Date used to display the data.
Valuation.TotalCost	double	The total account cost based on the cost base of unrealised holdings. (Account currency)
Valuation.TotalValue	double	The total account value based on the quantity and price of unrealised holdings. (Account currency)
Valuation.NetValue	double	The total account value inclusive of receivables and payables. (Account currency)
Valuation.TotalGainOrLoss	double	(Account currency)
Valuation.EstimatedIncome	double	Indicative field calculated based on the income of each asset generated over the past twelve months. (Account currency)
Valuation.Yield	double	The estimated income as a percentage of the market value of the account.
Holdings	array
Holdings.Security	object
Holdings.Security.AssetClassDescription	string	A description of the security’s asset class.
Holdings.Security.AssetClassCode	string	The asset class code of the security’s asset class.
Holdings.Security.AssetClassCategory	string	The asset class category of the security’s asset class.
Holdings.Security.TypeDescription	string	The asset type of the security’s asset class.
Holdings.Security.GicsDescription	string	The global industry classification of the security.
Holdings.Security.Code	string	Security code of the security.
Holdings.Security.Exchange	string	Exchange code of the security.
Holdings.Quantity	double	The number of securities held by the account at the recalculation date.
Holdings.UnitCost	double	Average unit cost of the holding. This is the actual cost divided by the quantity. (Account currency)
Holdings.Cost	double	Actual cost is based on the cost base of unrealised holdings. (Account currency)
Holdings.UnitValue	double	The last price of the holding available at the recalculation date. (Account currency)
Holdings.UnitPriceDate	date-time	The date of the unit price. (Account currency)
Holdings.Value	double	Value is calculated based on the unit price multiplied by the quantity. (Account currency)
Holdings.PercentTotalValue	double	The percentage ratio of the value relative to the total account value.
Holdings.GainOrLoss	double	(Account currency)
Holdings.PercentTotalGainOrLoss	double	The gain or loss expressed as a percentage over the adjusted cost base.
Holdings.EstimatedIncome	double	Indicative field calculated based on the income of each asset generated over the past twelve months. (Account currency)
Holdings.Yield	double	The estimated income as a percentage of the market value of the account.
Holdings.ValueInSecurityCurrency	double	The value based on the quantity and local price of unrealised holdings.
Holdings.CostBaseUnknown	boolean	Whether cost base is unknown.
Holdings.TaxCredits	double	The tax credits available on the current holdings of the security. (Account currency)
Holdings.EstimatedFrankingCredits	double	Amount expected to be received in franking credits. (Account currency)
Holdings.EstimatedGrossYield	double	Estimated gross yield is based on the sum of the estimated income and franking credits as a percentage of the holding's market value.
ReceivablesAndPayables	array
ReceivablesAndPayables.Code	string	The asset code of the receivable / payable.
ReceivablesAndPayables.Description	string	A description of the receivable / payable.
ReceivablesAndPayables.TypeDescription	string	Type of the receivable / payable.
ReceivablesAndPayables.Amount	double	The total value of the receivable/payable. (Account currency)
ReceivablesAndPayables.IncludedInNetValue	boolean	Whether included in the account's net value.
Subscriptions	object
Subscriptions.Models	array
Subscriptions.Models.ModelCode	string	Model code.
Subscriptions.Models.Weighting	double	Account’s model weighting at the valuation date.
Subscriptions.CashHub	object
Subscriptions.CashHub.AUD	double	Cash model weighting at the valuation date.

Performance

GET Performance

Definition: https://api.onpraemium.com/api/performance

This endpoint returns performance for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z
IncludeCash: true
IncludeLoans: true
IncludeExcludedSecurities: false
IncludeTaxCredits: true
DisplayReturns: 0
MultiplePeriods: 2
CalculationMethod: 1

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.
IncludeCash	boolean	Whether cash should be included.
IncludeLoans	boolean	Whether loans should be included.
IncludeExcludedSecurities	boolean	Whether or not to include any security that has been excluded from performance.
IncludeTaxCredits	boolean	Whether or not to include tax credits.
DisplayReturns	enum	BeforeExpenses = 0, AfterExpenses = 1, Both = 2.
MultiplePeriods	integer	0 - For the period only 4 - 1 mth, 3 mths, the period 9 - 1 mth, 3 mths, 6 mths, 1 yr, Since inception 11 - 1 mth, 3 mths, 6 mths, 1 yr, 2 yrs, 3 yrs, 4 yrs, 5 yrs, Since inception 16 - 1 mth, 3 mths, 6 mths, 1 yr, 3 yrs, 5 yrs, 10 yrs, Since inception 1 - 1 mth, 3 mths, 1 yr, the period 24 - 1 mth, 3 mths, 1 yr, 3 yrs, 5 yrs, the period 15 - 3 mths, 6 mths, 1 yr, 2 yrs, 3 yrs 17 - 3 mths, 6 mths, 1 yr, 3 yrs, 5 yrs 14 - 3 mths, 6 mths, 1 yr, 2 yrs, Since inception 13 - 3 mths, 1 yr, 2 yrs, 5 yrs, Since Inception 21 - 3 mths, 1 yr, 2 yrs, 3 yrs, Since inception 22 - 3 mths, 1 yr, 2 yr, 3 yrs, 5 yrs 18 - 3 mths, 1 yr, 3 yrs, 5 yrs, 7 yrs 2 - 3 mths, 1 yr, 3 yrs, the period 8 - 3 mths, 1 yr, 3 yrs, 5 yrs, Since inception 10 - 1 yr, 2 yrs, 3 yrs, 4 yrs, 5 yrs 19 - 1 yr, 3 yrs, 5 yrs, 7 yrs, 10 yrs 3 - 1 yr, 3 yrs, 5 yrs, the period 23 - 1 yr, 5 yrs, 10 yrs, Since inception 7 - Qtr to date, Fin yr to date, 1 yr, Since inception 5 - Qtr to date, Fin yr to date, 3 yrs, 5 yrs 6 - Qtr to date, Fin yr to date, 3 yrs, Since inception 20 - The period, Qtr to date, Fin yr to date, Since inception -1 - Account default
CalculationMethod	enum	ApproximateReturns = 0, TimeWeightedReturn = 1.

Response Examples

# 200 - OK
{
  "HoldingsExcluded": false,
  "BeginningMarketValue": 3536974.69,
  "EndingMarketValue": 3970907.88,
  "NetCapitalMovement": 7576.55,
  "NetInternalTransfers": 0.00,
  "CashExpenses": 0.00,
  "UnallocatedAmount": -1413.01,
  "DollarReturn": {
    "CapitalAppreciation": 357558.15,
    "TotalIncome": 71555.92,
    "TaxCredits": 4799.91,
    "ForexMovements": -775.54,
    "GrossDollarReturn": 433138.44,
    "TotalExpenses": 0.00,
    "NetDollarReturn": 433138.44
  },
  "PercentReturns": [
    {
      "PeriodDescription": "1 mth",
      "GrossPercentReturn": 1.71,
      "NetPercentReturn": 0.00
    },
    {
      "PeriodDescription": "3 mths",
      "GrossPercentReturn": 5.29,
      "NetPercentReturn": 0.00
    },
    {
      "PeriodDescription": "1 yr",
      "GrossPercentReturn": 12.05,
      "NetPercentReturn": 0.00
    },
    {
      "PeriodDescription": "Since 01/07/2020",
      "GrossPercentReturn": 12.43,
      "NetPercentReturn": 0.00
    }
  ]
}

Response Parameters

Parameter	Type	Description
HoldingsExcluded	boolean	The number of individual securities excluded from account performance calculations.
BeginningMarketValue	double	The beginning market value of the account on the From Date. (Account currency)
EndingMarketValue	double	The ending market value of the account on the To Date. (Account currency)
NetCapitalMovement	double	The net additions and withdrawals that flowed into and out of the account within the performance period. The transactions that make up this net amount when including cash are available from the Additions and withdrawals report. (Account currency)
NetInternalTransfers	double	Internal transfers between cash books that are not to be treated as a client addition or withdrawal. (Account currency)
CashExpenses	double	Expenses incurred by the account within the period, to be paid from either a account cash book or external bank account. (Account currency)
UnallocatedAmount	double	An unallocated amount will show if the sum of the above does not equal the Movement in value amount - that is, there is a component of the difference between the starting and ending market value that has not been explained. This will usually be because the cash side of a transaction or income event cannot be found. (Account currency)
DollarReturn	object
DollarReturn.CapitalAppreciation	double	Realised and unrealised gains / losses of the account. (Account currency)
DollarReturn.TotalIncome	double	The total income of the account received within the performance period. Income and tax credits are included in performance calculations when they are first acknowledged in the account. That is, when they are first declared according to the ex-date. (Account currency)
DollarReturn.TaxCredits	double	The total tax credits of the account received within the performance period. (Account currency)
DollarReturn.ForexMovements	double	The gain/loss of the account attributable to foreign exchange movements. (Account currency)
DollarReturn.GrossDollarReturn	double	The sum of all dollar return fields excluding expenses. (Account currency)
DollarReturn.TotalExpenses	double	The total expenses recorded against the account within the period. The Trading Activity > Income & Expenses > Expense Details page provides the ability to view these expenses. (Account currency)
DollarReturn.NetDollarReturn	double	The sum of all dollar return fields. (Account currency)
PercentReturns	array
PercentReturns.PeriodDescription	string	A description of the period the returns are calculated for.
PercentReturns.GrossPercentReturn	double	The performance percentage return excluding expenses.
PercentReturns.NetPercentReturn	double	The performance percentage return including expenses.

GET Investment Movement Performance

Definition: https://api.onpraemium.com/api/investmentmovementperformance

This endpoint returns investment movement performance for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z
IncludeTaxCredits: true
CalculationMethod: 1

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.
IncludeTaxCredits	boolean	Whether or not to include tax credits.
CalculationMethod	enum	ApproximateReturns = 0, TimeWeightedReturn = 1.

Response Examples

# 200 - OK
{
  "Investments": [
    {
      "PercentTotalReturn": 21.51,
      "TotalReturn": 50178.57,
      "TaxCredits": 6428.57,
      "TotalIncome": 15000.00,
      "IncomeNotYetPaid": 0.00,
      "IncomeCash": 15000.00,
      "IncomeDrp": 0.00,
      "EndMarketValue": 292500.00,
      "PercentCapitalReturn": 14.62,
      "GainOrLoss": 28750.00,
      "Sales": 0.00,
      "Purchases": 0.00,
      "BeginningMarketValue": 263750.00,
      "IncludedInPerformance": false,
      "Security": {
        "Code": "PIC",
        "Exchange": "ASX"
      },
      "NetOtherAmount": 0.00,
      "PercentIncomeReturn": 6.89
    },
    {
      "PercentTotalReturn": 36.30,
      "TotalReturn": 13233.95,
      "TaxCredits": 861.45,
      "TotalIncome": 2010.05,
      "IncomeNotYetPaid": 0.00,
      "IncomeCash": 2010.05,
      "IncomeDrp": 0.00,
      "EndMarketValue": 45262.50,
      "PercentCapitalReturn": 30.23,
      "GainOrLoss": 10362.45,
      "Sales": 0.00,
      "Purchases": 0.00,
      "BeginningMarketValue": 34900.05,
      "IncludedInPerformance": false,
      "Security": {
        "Code": "RIO",
        "Exchange": "ASX"
      },
      "NetOtherAmount": 0.00,
      "PercentIncomeReturn": 6.07
    }
  ],
  "CashAndEquivalents": [
    {
      "ForexMovements": 0.00,
      "Withdrawals": -40940.00,
      "Deposits": 70320.07,
      "Expenses": -7885.41,
      "InternalTransfers": 0.00,
      "InterestReceipts": 565.10,
      "Income": 600410.76,
      "Other": 0.00,
      "Purchases": -818359.09,
      "OpeningBalance": 367402.13,
      "IncludedInPerformance": 1,
      "Security": {
        "Code": "+CASH_AUST_TEST"
      },
      "Sales": 93060.23,
      "ClosingBalance": 264573.79
    },
    {
      "ForexMovements": -927.52,
      "Withdrawals": -774.04,
      "Deposits": 68.94,
      "Expenses": 0.00,
      "InternalTransfers": 0.00,
      "InterestReceipts": 0.00,
      "Income": 5160.29,
      "Other": 0.00,
      "Purchases": -1979.94,
      "OpeningBalance": 5183.01,
      "IncludedInPerformance": 1,
      "Security": {
        "Code": "+CASH_INTL_TEST_USD"
      },
      "Sales": 0.00,
      "ClosingBalance": 6730.74
    }
  ]
}

Response Parameters

Parameter	Type	Description
Investments	array
Investments.PercentTotalReturn	double	Total return for the period in percentage terms.
Investments.TotalReturn	double	Total dollar return for the period. (Account currency)
Investments.TaxCredits	double	Tax credit amount receivable within the period.(Account currency)
Investments.TotalIncome	double	Total income within the period. (Account currency)
Investments.IncomeNotYetPaid	double	Income declared but not yet paid at the ToDate. (Account currency)
Investments.IncomeCash	double	Income that was paid to cash. (Account currency)
Investments.IncomeDrp	double	Income that was reinvested as part of a DRP. (Account currency)
Investments.EndMarketValue	double	Market value of the security at the ToDate. (Account currency)
Investments.PercentCapitalReturn	double	Return for the period attributable to capital returns.
Investments.GainOrLoss	double	Dollar gain / loss in the response period. (Account currency)
Investments.Sales	double	Sum of sales within the period. (Account currency)
Investments.Purchases	double	Sum of purchases within the period. (Account currency)
Investments.BeginningMarketValue	double	Market value of the security at the FromDate. (Account currency)
Investments.IncludedInPerformance	boolean	Whether the security is included in performance calculations. (Account currency)
Investments.Security	object
Investments.Security.Code	string	Security code.
Investments.Security.Exchange	string	Security exchange.
Investments.NetOtherAmount	double	Other net amount within the period. (Account currency)
Investments.PercentIncomeReturn	double	Return for the period attributable to income returns.
CashAndEquivalents	array
CashAndEquivalents.ForexMovements	double	Movement for the period. (Account currency)
CashAndEquivalents.Withdrawals	double	Withdrawal amount that the security received in the period. (Account currency)
CashAndEquivalents.Deposits	double	Deposit amount that the security received in the period. (Account currency)
CashAndEquivalents.Expenses	double	Expenses charged against the security within the period. (Account currency)
CashAndEquivalents.InternalTransfers	double	Transfer amount for the period. (Account currency)
CashAndEquivalents.InterestReceipts	double	Interest amount that the security received in the period. (Account currency)
CashAndEquivalents.Income	double	Income amount that the security received in the period. (Account currency)
CashAndEquivalents.Other	double	Other amount that the security received in the period. (Account currency)
CashAndEquivalents.Purchases	double	Total security purchases within the period. (Account currency)
CashAndEquivalents.OpeningBalance	double	Opening balance of the security at the FromDate. (Account currency)
CashAndEquivalents.IncludedInPerformance	integer	Whether the security is included in performance calculations.
CashAndEquivalents.Security	object
CashAndEquivalents.Security.Code	string	Security code.
CashAndEquivalents.Security.Exchange	string	Security exchange.
CashAndEquivalents.Sales	double	Total security sales within the period. (Account currency)
CashAndEquivalents.ClosingBalance	double	Closing balance of the security at the ToDate. (Account currency)

GET Daily Returns

Definition: https://api.onpraemium.com/api/dailyreturns

This endpoint returns daily returns for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z
IncludeCash: true
IncludeExcludedSecurities: false
IncludeTaxCredits: true
DisplayReturns: 0
CalculationMethod: 1

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.
IncludeCash	boolean	Whether cash should be included.
IncludeExcludedSecurities	boolean	Whether or not to include any security that has been excluded from performance.
IncludeTaxCredits	boolean	Whether or not to include tax credits.
DisplayReturns	enum	BeforeExpenses = 0, AfterExpenses = 1, Both = 2.
CalculationMethod	enum	ApproximateReturns = 0, TimeWeightedReturn = 1.

Response Examples

# 200 - OK
[
  {
    "Date": "2020-02-19T00:00:00+11:00",
    "BeginningMarketValue": 3557278.91,
    "EndingMarketValue": 3564165.60,
    "NetContribution": 3500.44,
    "NetInternalTransfers": 0.00,
    "TotalExpenses": 0.00,
    "TaxCredits": 0.00,
    "PercentageReturn": 0.00,
    "NetPercentReturn": 0.00,
    "CumulativePercentageReturn": 0.19,
    "CumulativeNetPercentReturn": 0.00
  },
  {
    "Date": "2020-02-20T00:00:00+11:00",
    "BeginningMarketValue": 3564165.60,
    "EndingMarketValue": 3568076.47,
    "NetContribution": 0.00,
    "NetInternalTransfers": 0.00,
    "TotalExpenses": 0.00,
    "TaxCredits": 0.00,
    "PercentageReturn": 0.00,
    "NetPercentReturn": 0.00,
    "CumulativePercentageReturn": 0.30,
    "CumulativeNetPercentReturn": 0.00
  }
]

Response Parameters

Parameter	Type	Description
Date	date-time	The date of the return.
BeginningMarketValue	double	The beginning market value of the account on the Date. (Account currency)
EndingMarketValue	double	The ending market value of the account on the Date. (Account currency)
NetContribution	double	The net additions and withdrawals that flowed into and out of the account within the performance period. The transactions that make up this net amount when including cash are available from the Additions and withdrawals report. (Account currency)
NetInternalTransfers	double	Internal transfers between cash books that are not to be treated as a client addition or withdrawal. (Account currency)
TotalExpenses	double	The total expenses recorded against the account within the period. The Trading Activity > Income & Expenses > Expense Details page provides the ability to view these expenses. (Account currency)
TaxCredits	double	The total tax credits of the account received within the performance period. (Account currency)
PercentageReturn	double	The performance percentage return
NetPercentReturn	double	The performance percentage return inclusive of expenses.
CumulativePercentageReturn	double	The cumulative percentage return of the account from the From Date to the DailyReturns Date.
CumulativeNetPercentReturn	double	The cumulative net percentage return of the account from the From Date to the DailyReturns Date.

GET Benchmarks

Definition: https://api.onpraemium.com/api/benchmarks

This endpoint returns benchmarks for the service.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Response Examples

# 200 - OK
[
  {
    "Id": "AU329",
    "Code": "ABSRETURN",
    "Name": "Targeted Absolute Return"
  },
  {
    "Id": "AU363",
    "Code": "COMPOSITE",
    "Name": "Composite based on portfolio strategy"
  },
  {
    "Id": "AU247",
    "Code": "ABSINDEX",
    "Name": "ABS Australian CPI "
  },
  {
    "Id": "AU745",
    "Code": "HEALTHINDEX",
    "Name": "ABS CPI HEALTH INDEX"
  }
]

Response Parameters

Parameter	Type	Description
Id	string	Praemium ID of the benchmark.
Code	string	Benchmark code.
Name	string	Benchmark description.

GET Benchmark Performance

Definition: https://api.onpraemium.com/api/benchmarkperformance

This endpoint returns benchmark performance for the benchmark.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

BenchmarkId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z
MultiplePeriods: 1

Request Parameter - Query

Parameter	Type	Description
BenchmarkIdrequired	string	Praemium ID of the Benchmark as returned in the benchmark endpoint.
MultiplePeriods	integer	0 - For the period only 4 - 1 mth, 3 mths, the period 9 - 1 mth, 3 mths, 6 mths, 1 yr, Since inception 11 - 1 mth, 3 mths, 6 mths, 1 yr, 2 yrs, 3 yrs, 4 yrs, 5 yrs, Since inception 16 - 1 mth, 3 mths, 6 mths, 1 yr, 3 yrs, 5 yrs, 10 yrs, Since inception 1 - 1 mth, 3 mths, 1 yr, the period 24 - 1 mth, 3 mths, 1 yr, 3 yrs, 5 yrs, the period 15 - 3 mths, 6 mths, 1 yr, 2 yrs, 3 yrs 17 - 3 mths, 6 mths, 1 yr, 3 yrs, 5 yrs 14 - 3 mths, 6 mths, 1 yr, 2 yrs, Since inception 13 - 3 mths, 1 yr, 2 yrs, 5 yrs, Since Inception 21 - 3 mths, 1 yr, 2 yrs, 3 yrs, Since inception 22 - 3 mths, 1 yr, 2 yr, 3 yrs, 5 yrs 18 - 3 mths, 1 yr, 3 yrs, 5 yrs, 7 yrs 2 - 3 mths, 1 yr, 3 yrs, the period 8 - 3 mths, 1 yr, 3 yrs, 5 yrs, Since inception 10 - 1 yr, 2 yrs, 3 yrs, 4 yrs, 5 yrs 19 - 1 yr, 3 yrs, 5 yrs, 7 yrs, 10 yrs 3 - 1 yr, 3 yrs, 5 yrs, the period 23 - 1 yr, 5 yrs, 10 yrs, Since inception 7 - Qtr to date, Fin yr to date, 1 yr, Since inception 5 - Qtr to date, Fin yr to date, 3 yrs, 5 yrs 6 - Qtr to date, Fin yr to date, 3 yrs, Since inception 20 - The period, Qtr to date, Fin yr to date, Since inception -1 - Account default
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
[
  {
    "PeriodDescription": "1 mth",
    "PercentageReturn": 0.0915
  },
  {
    "PeriodDescription": "3 mths",
    "PercentageReturn": 0.1663
  },
  {
    "PeriodDescription": "1 yr p.a.",
    "PercentageReturn": 1.6120
  },
  {
    "PeriodDescription": "Since 19/02/2020 p.a.",
    "PercentageReturn": 1.6120
  }
]

Response Parameters

Parameter	Type	Description
PeriodDescription	string	The period the returns are calculated for.
PercentageReturn	double	The percentage return of the benchmark for the period.

GET Holdings Excluded

Definition: https://api.onpraemium.com/api/holdingsexcluded

This endpoint returns holdings excluded for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
[
  {
    "Security": {
      "Code": "APT",
      "Exchange": "ASX"
    },
    "FromDate": "2020-01-01T00:00:00+11:00",
    "ToDate": "2020-12-31T00:00:00+11:00"
  }
]

Response Parameters

Parameter	Type	Description
Security	object
Security.Code	string	Security code.
Security.Exchange	string	Security exchange.
FromDate	date-time	The start date the holding is excluded from performance calculations for the account.
ToDate	date-time	The end date the holding is excluded from performance calculations for the account.

GET Asset Class Performance

Definition: https://api.onpraemium.com/api/assetclassperformance

This endpoint returns asset class performance for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
IncludeCash: false
IncludeLoans: true
IncludeTaxCredits: true
IncludeForeignTaxPaid: false
IncludeExcludedSecurities: true
CalculationMethod: 1
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
IncludeCash	boolean	Whether cash should be included.
IncludeLoans	boolean	Whether loans should be included.
IncludeTaxCredits	boolean	Whether or not to include tax credits.
IncludeForeignTaxPaid	boolean	Whether or not to include foreign tax paid.
IncludeExcludedSecurities	boolean	Whether or not to include any security that has been excluded from performance.
CalculationMethod	enum	ApproximateReturns = 0, TimeWeightedReturn = 1.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
[
  {
    "AssetClassDescription": "Domestic Shares",
    "Benchmark": "",
    "StartValue": 99140.0,
    "EndValue": 94900.0,
    "TotalReturn": -4240.0,
    "TotalReturnPercent": 0.00,
    "BenchmarkReturnPercent": 0.00
  },
  {
    "AssetClassDescription": "Domestic Fixed Interest",
    "Benchmark": "",
    "StartValue": 53678.0,
    "EndValue": 53817.0,
    "TotalReturn": 140.0,
    "TotalReturnPercent": 0.00,
    "BenchmarkReturnPercent": 0.00
  }
]

Response Parameters

Parameter	Type	Description
AssetClassDescription	string	Asset class description.
Benchmark	string	Asset class benchmark.
StartValue	double	Market Value of the asset class at the FromDate. (Account currency)
EndValue	double	Market Value of the asset class at the ToDate. (Account currency)
TotalReturn	double	Total dollar return for the period. (Account currency)
TotalReturnPercent	double	Total return for the period as a percentage.
BenchmarkReturnPercent	double	Total return for the benchmark as a percentage.

Tax

GET Realised CGT

Definition: https://api.onpraemium.com/api/realisedcgt

This endpoint returns realised CGT for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.

Response Examples

# 200 - OK
{
  "CgtAssetDisposals": [
    {
      "CgtGain": 182.04,
      "OtherGain": 182.04,
      "OptimalCgtCalculationMethod": "Other",
      "GrossGain": 182.04,
      "SaleProceeds": 4144.74,
      "TaxFreeAmount": 0.0,
      "ActualCost": 3962.70,
      "Quantity": 111.00,
      "SaleDate": "2020-08-03T00:00:00+10:00",
      "PurchaseDate": "2019-11-01T00:00:00+11:00",
      "TaxDate": "2019-11-01T00:00:00+11:00",
      "Security": {
        "Code": "BHP",
        "Exchange": "ASX"
      },
      "AdjustedCost": 3962.70
    },
    {
      "OptimalCgtCalculationMethod": "Other",
      "GrossGain": 0.00,
      "SaleProceeds": 73.10,
      "CgtLoss": -4.04,
      "TaxFreeAmount": 0.0,
      "ActualCost": 77.14,
      "Quantity": 2.00,
      "SaleDate": "2020-09-11T00:00:00+10:00",
      "PurchaseDate": "2020-08-24T00:00:00+10:00",
      "TaxDate": "2020-08-24T00:00:00+10:00",
      "Security": {
        "Code": "BHP",
        "Exchange": "ASX"
      },
      "AdjustedCost": 77.14
    }
  ],
  "TaxFreeAndTaxDeferredAmounts": [
    {
      "Security": {
        "Code": "OPS0002AU",
        "Exchange": ""
      },
      "TaxDate": "2019-11-11T00:00:00+11:00",
      "PurchaseDate": "2019-11-11T00:00:00+11:00",
      "SaleDate": "2020-07-13T00:00:00+10:00",
      "Quantity": 66.0,
      "ActualCost": 219.57,
      "TaxDeferredAmount": 0.0,
      "TaxFreeAmount": 0.0,
      "AdjustedCost": 219.48
    },
    {
      "Security": {
        "Code": "OPS0002AU",
        "Exchange": ""
      },
      "TaxDate": "2019-11-11T00:00:00+11:00",
      "PurchaseDate": "2019-11-11T00:00:00+11:00",
      "SaleDate": "2020-07-16T00:00:00+10:00",
      "Quantity": 134.0,
      "ActualCost": 445.79,
      "TaxDeferredAmount": 0.0,
      "TaxFreeAmount": 0.0,
      "AdjustedCost": 445.60
    }
  ]
  "TrustCgtDistributions": [      
    {
      "Security": {
        "Code": "OPS0002AU",
        "Exchange": ""
      },
      "TaxDate": "2019-11-11T00:00:00+11:00",
      "GrossGain": 66.0,
      "DiscountedGain": 219.57,
      "IndexedGain": 0.0,
      "OtherGain": 0.0,
      "CgtGainLoss": 219.48,
      "PreCgtGainLoss": 219.48
    }
  ]
}

Response Parameters

Parameter	Type	Description
CgtAssetDisposals	array
CgtAssetDisposals.CgtGain	double	Calculated based on what is optimal for the disposal method selected. (Account currency)
CgtAssetDisposals.OtherGain	double	Equal to the gross gain if applicable. Applies if the asset was purchased within the last 12 months relative to the as at date requested for this section. (Account currency)
CgtAssetDisposals.IndexedGain	double	Shows the gain between the indexed cost and the market value, if applicable. (Account currency)
CgtAssetDisposals.DiscountedGain	double	The net of the gross gain and discount applied based on amounts that have had the discount rate applied. If the account is for a company, then the discounted rate applied will be zero. For an individual the discount rate applied is 50%. (Account currency)
CgtAssetDisposals.OptimalCgtCalculationMethod	string	The disposal method selected to calculate CGT gains.
CgtAssetDisposals.GrossGain	double	Equal to the market value minus the adjusted cost. Shows the gain before any discounting or indexing is applied. (Account currency)
CgtAssetDisposals.SaleProceeds	double	The amount the parcel was sold for. (Account currency)
CgtAssetDisposals.IndexedCost	double	If the security was acquired prior to 30/09/1999 and was held for more than one year, the cost base is increased by applying an indexation factor based on increase in CPI. (Account currency)
CgtAssetDisposals.CgtLoss	double	Applicable if there is a loss on a tax parcel and the purchase date is post 19 September 1985. (Account currency)
CgtAssetDisposals.TaxFreeAmount	double	Amount within the parcel that is tax free. (Account currency)
CgtAssetDisposals.ActualCost	double	The amount the parcel was purchased for less any GST refundable amount. (Account currency)
CgtAssetDisposals.Quantity	double	The number of units or shares disposed.
CgtAssetDisposals.SaleDate	date-time	The disposal date.
CgtAssetDisposals.PurchaseDate	date-time	Typically, this is the same as the Tax date unless a corporate action has occurred, such as a takeover, where CGT rollover relief applies.
CgtAssetDisposals.TaxDate	date-time	The date of the original purchase of the parcels, as used for tax purposes.
CgtAssetDisposals.Security	object
CgtAssetDisposals.Security.Code	string	Security code.
CgtAssetDisposals.Security.Exchange	string	Security exchange.
CgtAssetDisposals.AdjustedCost	double	The actual cost adjusted for any corporate actions, such as tax deferred distributions, or subsequent transactions. (Account currency)
CgtAssetDisposals.PreCgtGainLoss	double	Gain if Pre-CGT calculation method is selected. (Account currency)
TaxFreeAndTaxDeferredAmounts	array
TaxFreeAndTaxDeferredAmounts.Security	object
TaxFreeAndTaxDeferredAmounts.Security.Code	string	Security code.
TaxFreeAndTaxDeferredAmounts.Security.Exchange	string	Security exchange.
TaxFreeAndTaxDeferredAmounts.TaxDate	date-time	The date of the original purchase of the parcels, as used for tax purposes.
TaxFreeAndTaxDeferredAmounts.PurchaseDate	date-time	Typically, this is the same as the Tax date unless a corporate action has occurred, such as a takeover, where CGT rollover relief applies.
TaxFreeAndTaxDeferredAmounts.SaleDate	date-time	The disposal date.
TaxFreeAndTaxDeferredAmounts.Quantity	double	The number of units or shares disposed.
TaxFreeAndTaxDeferredAmounts.ActualCost	double	The amount the parcel was purchased for less any GST refundable amount. (Account currency)
TaxFreeAndTaxDeferredAmounts.TaxDeferredAmount	double	Amount within the parcel that is tax deferred. (Account currency)
TaxFreeAndTaxDeferredAmounts.TaxFreeAmount	double	Amount within the parcel that is tax free. (Account currency)
TaxFreeAndTaxDeferredAmounts.AdjustedCost	double	The actual cost adjusted for any corporate actions, such as tax deferred distributions, or subsequent transactions. (Account currency)
TrustCgtDistributions	array
TrustCgtDistributions.Security	object
TrustCgtDistributions.Security.Code	string	Security code.
TrustCgtDistributions.Security.Exchange	string	Security exchange.
TrustCgtDistributions.TaxDate	date-time	The date of the original purchase of the parcels, as used for tax purposes.
TrustCgtDistributions.GrossGain	double	Equal to the Market value minus the Adjusted cost. Shows the gain before any discounting or indexing is applied. (Account currency)
TrustCgtDistributions.DiscountedGain	double	The net of the gross gain and discount applied based on amounts that have had the discount rate applied. If the account is for a company, then the discounted rate applied will be zero. For an individual the discount rate applied is 50%. (Account currency)
TrustCgtDistributions.IndexedGain	double	Shows the gain between the indexed cost and the market value, if applicable. (Account currency)
TrustCgtDistributions.OtherGain	double	Equal to the gross gain if applicable. Applies if the asset was purchased within the last 12 months relative to the as at date requested for this section. (Account currency)
TrustCgtDistributions.CgtGainLoss	double	The CGT gain is calculated based on what is optimal for the disposal method selected. In some cases the indexed gain is used to optimise the use of losses. The CGT gain calculated from a less than optimal method is shown in italics for information purposes only and is excluded from the totals for the account. NA is shown if a calculation method is not applicable. (Account currency)
TrustCgtDistributions.PreCgtGainLoss	double	Gain if Pre-CGT calculation method is selected. (Account currency)

GET Realised CGT Summary

Definition: https://api.onpraemium.com/api/realisedcgtsummary

This endpoint returns realised CGT summary for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.

Response Examples

# 200 - OK
{
  "LossesCarriedForward": 0.0,
  "LossesCurrentYear": -32119.23,
  "CgtDisposalsDiscounted": 28724.5,
  "CgtDisposalsIndexed": 0.0,
  "CgtDisposalsOther": 32552.85,
  "CgtDistributionsDiscounted": 0.0,
  "CgtDistributionsIndexed": 0.0,
  "CgtDistributionsOther": 0.0,
  "LossesAppliedDiscounted": 0.0,
  "LossesAppliedIndexed": 0.0,
  "LossesAppliedOther": -32119.23,
  "DiscountApplied": -14362.25,
  "NetCapitalGainLoss": 14795.87,
  "NetCapitalGainLossDiscounted": 14362.25,
  "NetCapitalGainLossIndexed": 0.0,
  "NetCapitalGainLossOther": 433.62
}

Response Parameters

Parameter	Type	Description
LossesCarriedForward	double	Any losses from the prior years that have been carried forward. (Account currency)
LossesCurrentYear	double	The total amount of losses incurred from asset disposals during the tax year. (Account currency)
CgtDisposalsDiscounted	double	Disposal amounts that have had the discount rate applied. (Account currency)
CgtDisposalsIndexed	double	Shows the gain between the indexed cost and the disposal value, if applicable. (Account currency)
CgtDisposalsOther	double	Applies if the asset was disposed within 12 months of acquisition. (Account currency)
CgtDistributionsDiscounted	double	Distribution amounts that have had the discount rate applied. (Account currency)
CgtDistributionsIndexed	double	Shows the gain between the indexed cost and the disposal value, if applicable. (Account currency)
CgtDistributionsOther	double	Applies if the asset was disposed within 12 months of acquisition. (Account currency)
LossesAppliedDiscounted	double	Losses attributable against discounted gains. (Account currency)
LossesAppliedIndexed	double	Losses attributable against indexed gains. (Account currency)
LossesAppliedOther	double	Losses attributable against other gains. (Account currency)
DiscountApplied	double	The amount of discount allowable. (Account currency)
NetCapitalGainLoss	double	The account's net capital gain (or loss) for the tax year. (Account currency)
NetCapitalGainLossDiscounted	double	The account's net capital gain (or loss) related to discounting. (Account currency)
NetCapitalGainLossIndexed	double	The account's net capital gain (or loss) related to indexing. (Account currency)
NetCapitalGainLossOther	double	The account's net capital gain (or loss) not relating to discounting or indexing. (Account currency)

GET Unrealised CGT

Definition: https://api.onpraemium.com/api/unrealisedcgt

This endpoint returns unrealised CGT for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
Page: 1
Size: 100

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
Page	integer	Page number to return. Default to 1.
Size	integer	Page size to return.

Response Examples

# 200 - OK
{
  "Data": [
    {
      "CgtGain": 11.78,
      "DiscountedGain": 11.78,
      "OptimalCgtCalculationMethod": "Discounted",
      "GrossGain": 23.56,
      "MarketValue": 105.50,
      "AdjustedCost": 81.94,
      "TaxFreeAmount": 0.00,
      "TaxDeferredAmount": 0.00,
      "ActualCost": 81.94,
      "CostBaseUnknown": false,
      "Quantity": 1.0000,
      "PurchaseDate": "2020-03-02T00:00:00+11:00",
      "TaxDate": "2020-03-02T00:00:00+11:00",
      "Security": {
        "Code": "6981",
        "Exchange": "TYO"
      }
    },
    {
      "CgtGain": 185.71,
      "DiscountedGain": 185.71,
      "OptimalCgtCalculationMethod": "Discounted",
      "GrossGain": 371.41,
      "MarketValue": 1688.07,
      "AdjustedCost": 1316.66,
      "TaxFreeAmount": 0.00,
      "TaxDeferredAmount": 0.00,
      "ActualCost": 1316.66,
      "CostBaseUnknown": false,
      "Quantity": 16.0000,
      "PurchaseDate": "2020-03-04T00:00:00+11:00",
      "TaxDate": "2020-03-04T00:00:00+11:00",
      "Security": {
        "Code": "6981",
        "Exchange": "TYO"
      }
    }
  ],
  "Metadata": {
    "TotalCount": 14,
    "TotalPages": 7
  }
}

Response Parameters

Parameter	Type	Description
Data	array
Data.CgtGain	double	Calculated based on what is optimal for the disposal method selected. (Account currency)
Data.OtherGain	double	Equal to the gross gain if applicable. Applies if the asset was purchased within the last 12 months relative to the as at date requested for this section. (Account currency)
Data.IndexedGain	double	Shows the gain between the indexed cost and the market value, if applicable. (Account currency)
Data.DiscountedGain	double	The net of the gross gain and discount applied based on amounts that have had the discount rate applied. If the account is for a company, then the discounted rate applied will be zero. For an individual the discount rate applied is 50%. (Account currency)
Data.OptimalCgtCalculationMethod	string	The disposal method selected to calculate CGT gains.
Data.GrossGain	double	Equal to the market value minus the adjusted cost. Shows the gain before any discounting or indexing is applied. (Account currency)
Data.MarketValue	double	The amount the parcel is worth using the current market price. (Account currency)
Data.IndexedCost	double	If the security was acquired prior to 30/09/1999 and was held for more than one year, the cost base is increased by applying an indexation factor based on increase in CPI. (Account currency)
Data.AdjustedCost	double	The actual cost adjusted for any corporate actions, such as tax deferred distributions, or subsequent transactions. (Account currency)
Data.TaxFreeAmount	double	Amount within the parcel that is tax free. (Account currency)
Data.TaxDeferredAmount	double	Amount within the parcel that is tax deferred. (Account currency)
Data.ActualCost	double	The amount the parcel was purchased for less any GST refundable amount. (Account currency)
Data.CostBaseUnknown	boolean	Whether cost base is unknown.
Data.Quantity	double	The number of units or shares held for each tax parcel.
Data.PurchaseDate	date-time	Typically, this is the same as the Tax date unless a corporate action has occurred, such as a takeover, where CGT rollover relief applies.
Data.TaxDate	date-time	The date of the original purchase of the parcels, as used for tax purposes.
Data.Security	object
Data.Security.Code	string	Security code.
Data.Security.Exchange	string	Security exchange.
Data.CgtLoss	double	Applicable if there is a loss on a tax parcel and the purchase date is post 19 September 1985. (Account currency)
Data.CgtExemptGainLoss	double	The gross gain or loss on tax parcels with that are CGT exempt, including those with a purchase date before the CGT legislation applied. (Account currency)
Metadata	object	Metadata including pagination.
Metadata.TotalCount	integer	Total number of results found.
Metadata.TotalPages	integer	Total pages of results.

GET Unrealised CGT Summary

Definition: https://api.onpraemium.com/api/unrealisedcgtsummary

This endpoint returns unrealised CGT summary for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.

Response Examples

# 200 - OK
{
  "CostBaseUnknown": false,
  "ActualCost": 974774.09,
  "AdjustedCost": 974182.83,
  "MarketValue": 1182975.30,
  "GrossGain": 220253.94,
  "DiscountedGain": 54878.41,
  "OtherGain": 110497.70,
  "CgtGain": 165376.11,
  "CgtLoss": -11461.47
}

Response Parameters

Parameter	Type	Description
CostBaseUnknown	boolean	Whether cost base is unknown.
ActualCost	double	The amount the parcel was purchased for less any GST refundable amount. (Account currency)
AdjustedCost	double	The actual cost adjusted for any corporate actions, such as tax deferred distributions, or subsequent transactions. (Account currency)
MarketValue	double	Market Value of the security at the ValuationDate. (Account currency)
GrossGain	double	Equal to the market value minus the adjusted cost. Shows the gain before any discounting or indexing is applied. (Account currency)
DiscountedGain	double	The net of the gross gain and discount applied based on amounts that have had the discount rate applied. If the account is for a company, then the discounted rate applied will be zero. For an individual the discount rate applied is 50%. (Account currency)
IndexedGain	double	Shows the gain between the indexed cost and the market value, if applicable. (Account currency)
OtherGain	double	Equal to the gross gain if applicable. Applies if the asset was purchased within the last 12 months relative to the as at date requested for this section. (Account currency)
CgtGain	double	Calculated based on what is optimal for the disposal method selected. (Account currency)
CgtLoss	double	Applicable if there is a loss on a tax parcel and the purchase date is post 19 September 1985. (Account currency)
CgtExemptGainLoss	double	The gross gain or loss on tax parcels with that are CGT exempt, including those with a purchase date before the CGT legislation applied. (Account currency)

TradingActivity

GET Transactions

Definition: https://api.onpraemium.com/api/transactions

This endpoint returns transactions for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z
BuysAndSellsOnly: true
ShowUnconfirmed: true
OrderBy: 1
Order: 0
Page: 1
Size: 100

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.
BuysAndSellsOnly	boolean	Whether to includes only Buy, Close position, Sell, Short Sell, Write Opt. to Open, Write Opt. to Close, Buy Opt. to open, Buy Opt. to close.
ShowUnconfirmed	boolean	Whether to show unconfirmed transactions.
Page	integer	Page number to return. Default to 1.
Size	integer	Page size to return.
OrderBy	enum	TransactionDate = 0, Security = 1.
Order	enum	Asc = 0, Desc = 1.

Response Examples

# 200 - OK
{
  "Data": [
    {
      "DeemedAmount": 0.0,
      "CostBaseUnknown": false,
      "BuyBack": false,
      "AveragePriceInTradedCurrency": 4.2419,
      "AmountInTradedCurrency": 25052.81,
      "TradedCurrency": "AUD",
      "SettlementDate": "2020-12-16T00:00:00+00:00",
      "AveragePriceInSettlementCurrency": 4.2419,
      "AmountInSettlementCurrency": 25052.81,
      "SettlementCurrency": "AUD",
      "Broker": "Testing Securities Australia",
      "GstClaimable": 0.0,
      "BrokerageGst": 17.399999618530273,
      "BrokerageIncludingGst": 174.02999877929688,
      "TransactionId": "AU1636235781",
      "Security": {
        "Code": "AZJ",
        "Exchange": "ASX"
      },
      "TransactionDate": "2020-12-14T00:00:00+11:00",
      "Quantity": 5906,
      "NetAmount": 25052.81,
      "Unconfirmed": false,
      "AveragePrice": 4.2419,
      "DisposalMethod": "",
      "Narration": "c/n 104729665",
      "TransactionTypeDescription": "Buy"
    },
    {
      "DeemedAmount": 0.0,
      "CostBaseUnknown": false,
      "BuyBack": false,
      "AveragePriceInTradedCurrency": 1.9884,
      "AmountInTradedCurrency": 179262.97,
      "TradedCurrency": "AUD",
      "SettlementDate": "2020-08-10T00:00:00+00:00",
      "AveragePriceInSettlementCurrency": 1.9884,
      "AmountInSettlementCurrency": 179262.97,
      "SettlementCurrency": "AUD",
      "Broker": "",
      "GstClaimable": 0.0,
      "BrokerageGst": 0.0,
      "BrokerageIncludingGst": 0.0,
      "TransactionId": "AU1607913507",
      "Security": {
        "Code": "ETL0374AU",
        "Exchange": ""
      },
      "TransactionDate": "2020-07-31T00:00:00+10:00",
      "Quantity": 0,
      "NetAmount": 179262.97,
      "Unconfirmed": false,
      "AveragePrice": 1.9884,
      "DisposalMethod": "",
      "Narration": "Off Market Transfer from Family Trust",
      "TransactionTypeDescription": "Buy"
    }
  ],
  "Metadata": {
    "TotalCount": 4,
    "TotalPages": 2
  }
}

Response Parameters

Parameter	Type	Description
Data	array
Data.DeemedAmount	double	The buyback capital value applied for CGT purposes. (Account currency)
Data.CostBaseUnknown	boolean	Whether cost base is unknown.
Data.BuyBack	boolean	If the transaction is classified as a buyback.
Data.AveragePriceInTradedCurrency	double	TradedCurrencyAmount divided by quantity.
Data.AmountInTradedCurrency	double	Displays the amount traded in an international currency.
Data.TradedCurrency	string	For International Investments. Displays the currency in which the asset was traded.
Data.SettlementDate	date-time	The date on which the transaction settled.
Data.AveragePriceInSettlementCurrency	double	AmountInSettlementCurrency divided by quantity.
Data.AmountInSettlementCurrency	double	Displays the amount settled in an international currency.
Data.SettlementCurrency	string	Displays the currency in which the trade was settled.
Data.Broker	string	The name of the broker against the transaction.
Data.GstClaimable	double	The total of any GST amount that is payable. (Account currency)
Data.BrokerageGst	double	The GST amount of any brokerage for the transaction. (Account currency)
Data.BrokerageIncludingGst	double	The total of any brokerage for the transaction including GST. (Account currency)
Data.TransactionId	string	The unique identifier of the transaction.
Data.Security	object
Data.Security.Code	string	Security code.
Data.Security.Exchange	string	Security exchange.
Data.TransactionDate	date-time	The date on which the transaction occurred.
Data.Quantity	integer	The number of units or shares disposed.
Data.NetAmount	double	This value should be adjusted (increased for a buy, decreased for a sell) for any brokerage, GST or other charges paid to transact. (Account currency)
Data.Unconfirmed	boolean	Whether the transaction has not been confirmed.
Data.AveragePrice	double	Net amount divided by quantity. (Account currency)
Data.DisposalMethod	string	Tax method used on the security disposal.
Data.Narration	string	Displays any notes that have added to the transaction.
Data.TransactionTypeDescription	string	A categorised type of the transaction.
Metadata	object	Metadata including pagination.
Metadata.TotalCount	integer	Total number of results found.
Metadata.TotalPages	integer	Total pages of results.

GET Cash Transactions

Definition: https://api.onpraemium.com/api/cashtransactions

This endpoint returns cash transactions for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z
IncludePendingUnsettled: true
Page: 1
Size: 100

Request Parameter - Query

Parameter	Type	Description
IncludePendingUnsettled	boolean	Whether to include pending unsettled cash transactions.
Page	integer	Page number to return. Default to 1.
Size	integer	Page size to return.
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
{
  "Data": [
    {
      "Summary": {
        "CashBookCode": "+CASH_AUST_TEST",
        "CashBookDescription": "Testing 1 - Cash Management Account",
        "Currency": "AUD",
        "OpeningBalance": 790491.23,
        "Deposits": 103301.29,
        "Withdrawals": -629218.73,
        "ClosingBalance": 264573.79,
        "ClosingBalanceInAccountCurrency": 264573.79
      },
      "Transactions": [
        {
          "TransactionId": "AU0",
          "TransactionDate": "2020-07-01T10:00:00+10:00",
          "Currency": "AUD",
          "TransactionTypeDescription": "Opening Balance",
          "Narration": "",
          "Deposit": 0.00,
          "Withdrawal": 0.00,
          "ValueInAccountCurrency": 0.00,
          "Balance": 790491.23
        },
        {
          "TransactionId": "AU1290146936",
          "TransactionDate": "2020-07-02T00:00:00+10:00",
          "Currency": "AUD",
          "TransactionTypeDescription": "Rebate",
          "Narration": "REBATE OF ADVISER COMMISSION",
          "Deposit": 150.69,
          "Withdrawal": 0.00,
          "ValueInAccountCurrency": 150.69,
          "Balance": 790641.92
        }
      ]
    },
    {
      "Summary": {
        "CashBookCode": "+CASH_INTL_TEST_USD",
        "CashBookDescription": "Testing 2 - LLC US Dollar Cash Account",
        "Currency": "USD",
        "OpeningBalance": 4051.84,
        "Deposits": 2918.56,
        "Withdrawals": -1949.78,
        "ClosingBalance": 5020.62,
        "ClosingBalanceInAccountCurrency": 6474.04
      },
      "Transactions": [
        {
          "TransactionId": "AU0",
          "TransactionDate": "2020-07-01T10:00:00+10:00",
          "Currency": "USD",
          "TransactionTypeDescription": "Opening Balance",
          "Narration": "",
          "Deposit": 0.00,
          "Withdrawal": 0.00,
          "ValueInAccountCurrency": 0.00,
          "Balance": 4051.84
        }
      ]
    }
  ],
  "Metadata": {
    "TotalCount": 2,
    "TotalPages": 1
  }
}

Response Parameters

Parameter	Type	Description
Data	array
Data.Summary	object
Data.Summary.CashBookCode	string	The code of the cashbook.
Data.Summary.CashBookDescription	string	A description of the cashbook.
Data.Summary.Currency	string	Denominated currency of the cashbook transactions.
Data.Summary.OpeningBalance	double	Cashbook balance at the FromDate in the denominated currency.
Data.Summary.Deposits	double	Sum of all credit type transactions for the cashbook in the denominated currency.
Data.Summary.Withdrawals	double	Sum of all debit type transactions for the cashbook in the denominated currency.
Data.Summary.ClosingBalance	double	Cashbook balance at the ToDate in the denominated currency.
Data.Summary.ClosingBalanceInAccountCurrency	double	ClosingBalance of the cashbook. (Account currency)
Data.Transactions	array
Data.Transactions.TransactionId	string	The unique identifier of the transaction.
Data.Transactions.TransactionDate	date-time	The date on which the transaction occurred.
Data.Transactions.Currency	string	Denominated currency of the transaction.
Data.Transactions.TransactionTypeDescription	string	A categorised type of the transaction.
Data.Transactions.Narration	string	Displays any notes that have added to the transaction.
Data.Transactions.Deposit	double	The amount in the denominated currency if this transaction is a credit type.
Data.Transactions.Withdrawal	double	The amount in the denominated currency if this transaction is a debit type.
Data.Transactions.ValueInAccountCurrency	double	Value of the transaction. (Account currency)
Data.Transactions.Balance	double	The balance in the denominated currency of the cash book after the transaction has been credited or debited.
Metadata	object	Metadata including pagination.
Metadata.TotalCount	integer	Total number of results found.
Metadata.TotalPages	integer	Total pages of results.

GET Unsettled Transactions

Definition: https://api.onpraemium.com/api/unsettledtransactions

This endpoint returns unsettled transactions for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z
Page: 1
Size: 100

Request Parameter - Query

Parameter	Type	Description
Page	integer	Page number to return. Default to 1.
Size	integer	Page size to return.
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
[
  {
    "Security": {
      "Code": "AHQ",
      "Exchange": "ASX"
    },
    "TransactionDate": "2021-03-12T00:00:00+11:00",
    "TransactionTypeDescription": "Sell",
    "Quantity": -250000.0,
    "NetAmount": 20689.04,
    "AveragePrice": 0.0828,
    "Brokerage": 124.9600,
    "Gst": 12.5,
    "DisposalMethod": "Minimise",
    "Narration": "c/n 110582987",
    "TradedCurrency": "AUD",
    "AmountInTradedCurrency": 20689.04,
    "AveragePriceInTradedCurrency": 0.0828,
    "SettlementDate": "2021-03-16T00:00:00+11:00",
    "ContractNoteReference": "110582987",
    "OtherCharges": 0.0000,
    "OtherChargesGst": 0.0000
  },
  {
    "Security": {
      "Code": "+EFGE",
      "Exchange": ""
    },
    "TransactionDate": "2020-07-01T00:00:00+10:00",
    "TransactionTypeDescription": "Sell",
    "Quantity": -3345.0,
    "NetAmount": 16725.0,
    "AveragePrice": 5.0,
    "Brokerage": 0.0,
    "Gst": 0.0,
    "DisposalMethod": "Minimise",
    "Narration": "",
    "TradedCurrency": "AUD",
    "AmountInTradedCurrency": 16725.0,
    "AveragePriceInTradedCurrency": 5.0,
    "SettlementDate": "2021-05-01T00:00:00+10:00",
    "ContractNoteReference": "",
    "OtherCharges": 0.0000,
    "OtherChargesGst": 0.0000
  }
]

Response Parameters

Parameter	Type	Description
Security	object
Security.Code	string	Security code.
Security.Exchange	string	Security exchange.
TransactionDate	date-time	The date on which the transaction occurred.
TransactionTypeDescription	string	Transaction type description.
Quantity	double	The number of units or shares disposed.
NetAmount	double	This value should be adjusted (increased for a buy, decreased for a sell) for any brokerage, GST or other charges paid to transact. (Account currency)
AveragePrice	double	Net amount divided by quantity. (Account currency)
Brokerage	double	Total of any brokerage for the transaction. (Account currency)
Gst	double	GST amount of any brokerage for the transaction. (Account currency)
DisposalMethod	string	Tax method used on the security disposal.
Narration	string	Displays any notes that have added to the transaction.
TradedCurrency	string	For International Investments. Displays the currency in which the asset was traded.
AmountInTradedCurrency	double	Displays the amount traded in an international currency.
AveragePriceInTradedCurrency	double	TradedCurrencyAmount divided by quantity.
SettlementDate	date-time	The date on which the transaction settled.
ContractNoteReference	string	Unique contract note reference number.
OtherCharges	double	Total of any other charges (eg. international transaction processing fees) for the transaction. (Account currency)
OtherChargesGst	double	GST amount of any other charges for the transaction. (Account currency)

GET Dividend Reinvestment Details

Definition: https://api.onpraemium.com/api/dividendreinvestmentdetails

This endpoint returns dividend reinvestment details for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.

Response Examples

# 200 - OK
[
  {
    "Security": {
      "Code": "PLA0002AU",
      "Exchange": "FND"
    },
    "DrpType": 0,
    "FromDate": "1900-01-01T00:00:00+11:00",
    "ToDate": "2050-01-01T00:00:00+11:00",
    "MaxSharesParticipating": -1.0,
    "PercentSharesParticipating": 0.0,
    "ExcludeFromDrp": false
  },
  {
    "Security": {
      "Code": "PER0439AU",
      "Exchange": "FND"
    },
    "DrpType": 0,
    "FromDate": "1900-01-01T00:00:00+11:00",
    "ToDate": "2012-07-01T00:00:00+10:00",
    "MaxSharesParticipating": 39108.0,
    "PercentSharesParticipating": 0.0,
    "ExcludeFromDrp": false
  }
]

Response Parameters

Parameter	Type	Description
Data	array
Data.Security	object
Data.Security.Code	string	Security code.
Data.Security.Exchange	string	Security exchange.
Data.DrpType	enum	Either DRP (Dividend Reinvestment Plan) or BSP (Bonus Share Plan).
Data.FromDate	date-time	The date that the DRP is active from.
Data.ToDate	date-time	The date that the DRP is active to.
Data.MaxSharesParticipating	double	The number of shares held that are requested to participate in the reinvestment plan.
Data.PercentSharesParticipating	double	The percentage of the DRP to take as shares. Note that this cannot be used in conjunction with MaxSharesParticipating.
Data.ExcludeFromDrp	boolean	Whether the security is excluded from the account-wide reinvestment plan.
Metadata	object	Metadata including pagination.
Metadata.TotalCount	integer	Total number of results found.
Metadata.TotalPages	integer	Total pages of results.

Income

GET Income Schedules

Definition: https://api.onpraemium.com/api/incomeschedules

This endpoint returns income schedules for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
[
  {
    "CashAmount": 58.40,
    "TrustOtherExpenses": 0.00,
    "ForeignIncomeTaxOffsetsTotal": 0.00,
    "TaxWithheld": 0.00,
    "IncomeTotal": 58.40,
    "NonAssessableTotal": 0.00,
    "TrustCGTDistributionsTotal": 0.00,
    "ForeignIncomeTotal": 0.00,
    "Drp": 0.00,
    "TrustOtherAust": 0.00,
    "FrankedTotal": 58.40,
    "UnfrankedTotal": 0.00,
    "Interest": 0.00,
    "TaxDate": "2020-12-18T00:00:00+11:00",
    "AssetDescription": "ARISTOCRAT LEISURE LIMITED FPO",
    "IncomeTypeDescription": "Dividends",
    "IncomeId": "AU72394073",
    "FrankingCreditsTotal": 25.03,
    "AccruedAmount": 0.00
  },
  {
    "CashAmount": 653.45,
    "TrustOtherExpenses": 0.00,
    "ForeignIncomeTaxOffsetsTotal": 0.00,
    "TaxWithheld": 0.00,
    "IncomeTotal": 653.45,
    "NonAssessableTotal": 0.00,
    "TrustCGTDistributionsTotal": 0.00,
    "ForeignIncomeTotal": 0.00,
    "Drp": 0.00,
    "TrustOtherAust": 0.00,
    "FrankedTotal": 653.45,
    "UnfrankedTotal": 0.00,
    "Interest": 0.00,
    "TaxDate": "2020-09-22T00:00:00+10:00",
    "AssetDescription": "BHP GROUP LIMITED FPO",
    "IncomeTypeDescription": "Dividends",
    "IncomeId": "AU2962862",
    "FrankingCreditsTotal": 280.05,
    "AccruedAmount": 0.00
  }
]

Response Parameters

Parameter	Type	Description
CashAmount	double	Amount received via cash. (Account currency)
TrustOtherExpenses	double	Other expenses related to the income record. (Account currency)
ForeignIncomeTaxOffsetsTotal	double	Foreign income tax offsets. (Account currency)
TaxWithheld	double	Total tax withheld on the income record. (Account currency)
IncomeTotal	double	Total value of the income record. (Account currency)
NonAssessableTotal	double	Total amount that is non assessable for tax purposes. (Account currency)
TrustCgtDistributionsTotal	double	Amount received due to distributed capital gains. (Account currency)
ForeignIncomeTotal	double	Amount received from non-Australian sources. (Account currency)
Drp	double	Amount received via dividend reinvestment. (Account currency)
AustralianTrustOther	double	Australian sourced income component that is not classified as one of the other types. (Account currency)
FrankedTotal	double	Amount received that was franked. (Account currency)
UnfrankedTotal	double	Amount received that was unfranked. (Account currency)
Interest	double	Interest amount. (Account currency)
TaxDate	date-time	Tax date of the income record.
Security	object
Security.Code	string	Security code.
Security.Exchange	string	Security exchange.
IncomeTypeDescription	string	Type of income received.
IncomeId	string	Praemium income ID.
FrankingCreditsTotal	double	Imputation credits. (Account currency)
AccruedAmount	double	Income amount that is accrued. (Account currency)

GET Income And Tax Credit

Definition: https://api.onpraemium.com/api/incomeandtaxcredit

This endpoint returns income and tax credit for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
[
  {
    "TaxWithheld": 0.0,
    "Receivable": 0.0,
    "CashAmount": 28.74,
    "Drp": 0.0,
    "IncomeTotal": 28.74,
    "Currency": "AUD",
    "PaymentDate": "2021-01-29T00:00:00+11:00",
    "ExecutionDate": "2021-01-29T00:00:00+11:00",
    "Security": {
      "Code": "+CASH_AUST_TEST",
      "Exchange": ""
    },
    "IncomeTypeDescription": "Interest from cash",
    "IncomeSource": "Australian",
    "IncomeId": "AU88295538",
    "ForeignTaxPay": 0.0,
    "FrankingCredit": 0.0
  },
  {
    "TaxWithheld": 0.0,
    "Receivable": 0.0,
    "CashAmount": 58.5,
    "Drp": 0.0,
    "IncomeTotal": 58.5,
    "Currency": "AUD",
    "PaymentDate": "2020-12-31T00:00:00+11:00",
    "ExecutionDate": "2020-12-31T00:00:00+11:00",
    "Security": {
      "Code": "+CASH_AUST_TEST",
      "Exchange": ""
    },
    "IncomeTypeDescription": "Interest from cash",
    "IncomeSource": "Australian",
    "IncomeId": "AU76249491",
    "ForeignTaxPay": 0.0,
    "FrankingCredit": 0.0
  }
]

Response Parameters

Parameter	Type	Description
TaxWithheld	double	Total tax withheld on the income record. (Account currency)
Receivable	double	Amount of income yet to be received. (Account currency)
CashAmount	double	Amount received via cash. (Account currency)
Drp	double	Amount received via dividend reinvestment. (Account currency)
IncomeTotal	double	Total value of the income record. (Account currency)
PaymentDate	date-time	Payment date of the income record.
ExecutionDate	date-time	Execution date of the income record.
Security	object
Security.Code	string	Security code.
Security.Exchange	string	Security exchange.
IncomeTypeDescription	string	Type of income received.
IncomeSource	string	Whether the income was Australian or foreign based.
IncomeId	string	Praemium income ID.
ForeignTaxPay	double	Amount of foreign tax of the income record. (Account currency)
FrankingCredit	double	Franking credit amount attributable to the income. (Account currency)

Expense

GET Expenses

Definition: https://api.onpraemium.com/api/expenses

This endpoint returns expenses for the account.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

AccountId: AU400000
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
AccountIdrequired	string	Account ID.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
[
  {
    "ExpenseId": "AU306918771",
    "EffectiveDate": "2020-07-08T00:00:00+10:00",
    "TaxDate": "2020-07-08T00:00:00+10:00",
    "PaymentDate": "2020-07-08T00:00:00+10:00",
    "ExpenseIncludingGst": 2802.23,
    "ExpenseExcludingGst": 2547.48,
    "GstRefundableAmount": 0.0,
    "DeductibleAmount": 2802.23,
    "NonDeductibleAmount": 0.00,
    "ExpenseNarration": "Testing: SMA Model Fee April - June 20",
    "ExpenseTypeGroupDescription": "Investment expenses",
    "ExpenseTypeDescription": "Portfolio management fees"
  },
  {
    "ExpenseId": "AU306918772",
    "EffectiveDate": "2020-07-08T00:00:00+10:00",
    "TaxDate": "2020-07-08T00:00:00+10:00",
    "PaymentDate": "2020-07-08T00:00:00+10:00",
    "ExpenseIncludingGst": 127.96,
    "ExpenseExcludingGst": 116.33,
    "GstRefundableAmount": 0.0,
    "DeductibleAmount": 127.96,
    "NonDeductibleAmount": 0.00,
    "ExpenseNarration": "Testing: Ongoing Adviser Fee April- June 20",
    "ExpenseTypeGroupDescription": "Investment expenses",
    "ExpenseTypeDescription": "Portfolio management fees"
  }
]

Response Parameters

Parameter	Type	Description
ExpenseId	string	Praemium expense id.
EffectiveDate	date-time	Date the expense was deemed to have been incurred.
TaxDate	date-time	Date used for tax action reporting purposes.
PaymentDate	date-time	Date the expense was paid.
ExpenseIncludingGst	double	Amount paid including GST. (Account currency)
ExpenseExcludingGst	double	Amount paid excluding GST. (Account currency)
GstRefundableAmount	double	Refundable amount of GST the account is eligible to claim for the expense. (Account currency)
DeductibleAmount	double	Portion of the expense that can be claimed as a tax deduction. (Account currency)
NonDeductibleAmount	double	Portion of the expense that cannot be claimed as a tax deduction. (Account currency)
ExpenseNarration	string	Notes attached to the expense.
ExpenseTypeGroupDescription	string	Expenses categorised as Admin / Investment / Member / Non-investment.
ExpenseTypeDescription	string	Description of the expense type. Please visit the “Expense Types” pages in Help Centre for a full list.

Report

GET Report Events

Definition: https://api.onpraemium.com/api/reportevents

This endpoint returns report events for the service.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Response Examples

# 200 - OK
[
  {
    "Id": "AU6306",
    "EventName": "Feb_Inv_PAS_PA_Statements",
    "CreatedDate": "2021-03-26T04:44:14.95+11:00",
    "UpdatedDate": "2021-03-26T04:47:52.45+11:00"
  },
  {
    "Id": "AU6219",
    "EventName": "Jan21_Inv_PAS_PA_Statements",
    "CreatedDate": "2021-02-25T04:49:44.587+11:00",
    "UpdatedDate": "2021-03-01T05:57:50.547+11:00"
  }
]

Response Parameters

Parameter	Type	Description
Id	string	ID of the reporting event.
EventName	string	Name of the reporting event.
CreatedDate	date-time	Date the record was created.
UpdatedDate	date-time	Date the record was updated.

GET Report Event Published Files

Definition: https://api.onpraemium.com/api/reporteventpublishedfiles

This endpoint returns published files for the report event.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

EventId: AU1234

Request Parameter - Query

Parameter	Type	Description
EventIdrequired	string	EventId as returned by the report event endpoint.

Response Examples

# 200 - OK
[
  {
    "FileId": "7F4D7FC6A5E347898DDF8839B382DDC1",
    "AccountId": "AU382060",
    "FileName": "Test Consol February 2021 Report.pdf",
    "GeneratedDate": "2021-03-17T09:46:44.043+11:00",
    "PublishedDate": "2021-03-17T10:16:32.403+11:00"
  },
  {
    "FileId": "B628DD43338B464FB29799B9F99EBE07",
    "AccountId": "AU216967",
    "FileName": "February 2021 Report.pdf",
    "GeneratedDate": "2021-03-17T09:46:44.043+11:00",
    "PublishedDate": "2021-03-17T10:16:17.153+11:00"
  }
]

Response Parameters

Parameter	Type	Description
FileId	string	Unique ID of the generated file.
AccountId	string	Account ID.
FileName	string	Generated file name of the report.
GeneratedDate	date-time	Date the file was generated.
PublishedDate	date-time	Date the file was published.

GET Report File

Definition: https://api.onpraemium.com/api/reportfile

This endpoint downloads report file.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

FileId: AC2295B5F56D4342A8D057F3DD25C711

Request Parameter - Query

Parameter	Type	Description
FileIdrequired	string	FileID as returned in the report event published file endpoint.

Response Examples

# 200 - OK
Complete data stream of the file content.

Model Manager

GET Models

Definition: https://api.onpraemium.com/api/models

This endpoint returns models for the model provider.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Response Examples

# 200 - OK
[
  {
    "Id": "AU529",
    "Code": "TE0001",
    "Description": "Test Diversified Income",
    "Status": 0,
    "FactSheetUrl": "http://www.praemium.com.au/factsheet/TE0001.pdf",
    "ProviderName": "TestProvider",
    "UpdatedDate": "2020-10-14T11:33:16.937+11:00",
    "LastTransactionDate": "2020-06-30T00:00:00+10:00"
  },
  {
    "Id": "AU530",
    "Code": "TE0002",
    "Description": "InvestSMART Conservative",
    "Status": 0,
    "FactSheetUrl": "http://www.praemium.com.au/factsheet/TE0002.pdf",
    "ProviderName": "TestProvider",
    "UpdatedDate": "2020-08-19T15:46:48.55+10:00",
    "LastTransactionDate": "2020-06-30T00:00:00+10:00"
  }
]

Response Parameters

Parameter	Type	Description
Id	string	Praemium unique model Identifier.
Code	string	Model code.
Description	string	A description of the model.
Status	enum	Open = 0, Closing = 1, Closed = 2.
FactSheetUrl	string	Fact sheet URL.
ProviderName	string	Model provider name.
UpdatedDate	date-time	Model status update. Note that this date refers to an update of the model description, not the model weights.
LastTransactionDate	date-time	Model weights update date.

GET Model Approximate FUM

Definition: https://api.onpraemium.com/api/modelapproximatefum

This endpoint returns approximate FUM for the model.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

ModelId: AU1234
ValuationDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
ModelIdrequired	string	ModelId as returned by the model endpoint.
ValuationDaterequired	date-time	Date used to display the data.

Response Examples

# 200 - OK
{
  "NumberOfAccountsLinked": 2,
  "TotalTargetFum": 63569.37,
  "TotalApproximateFum": 62957.98,
  "ApproximateFumForAccounts": [
    {
      "AccountId": "AU316168",
      "TotalValue": 230996.36,
      "ModelWeight": 18.87,
      "TargetFum": 43600.29,
      "ApproximateFum": 43200.27
    },
    {
      "AccountId": "AU328554",
      "TotalValue": 20144.78,
      "ModelWeight": 99.13,
      "TargetFum": 19969.08,
      "ApproximateFum": 19757.71
    }
  ]
}

Response Parameters

Parameter	Type	Description
NumberOfAccountsLinked	integer	Number of accounts linked to the model.
TotalTargetFum	double	Target FUM for all accounts. (AUD)
TotalApproximateFum	double	Approximate FUM for all accounts. (AUD)
ApproximateFumForAccounts	array
ApproximateFumForAccounts.AccountId	string	Account ID.
ApproximateFumForAccounts.TotalValue	double	Total market value of the account. (AUD)
ApproximateFumForAccounts.ModelWeight	double	Account weight in the requested model.
ApproximateFumForAccounts.TargetFum	double	Target FUM of the account. (AUD)
ApproximateFumForAccounts.ApproximateFum	double	Approximate FUM of the account. (AUD)

GET Model Performance

Definition: https://api.onpraemium.com/api/modelperformance

This endpoint returns performance for the model.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

ModelId: AU1234
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
ModelIdrequired	string	ModelId as returned by the model endpoint.
FromDaterequired	date-time	The from date used when calculating data for the request.
ToDaterequired	date-time	The to date used when calculating data for the request.

Response Examples

# 200 - OK
{
  "DailyPercentageReturns": [
    {
      "Date": "2021-02-01T00:00:00+11:00",
      "PercentageReturn": 0.0581
      "CumulativePercentageReturn": 0.0581
    },
    {
      "Date": "2021-02-02T00:00:00+11:00",
      "PercentageReturn": 0.5749,
      "CumulativePercentageReturn": 0.5749
    },
    {
      "Date": "2021-02-03T00:00:00+11:00",
      "PercentageReturn": 0.5085,
      "CumulativePercentageReturn": 0.5085
    }
  ],
  "PercentageReturns": [
    {
      "PeriodDescription": "1 mth",
      "GrossPercentageReturn": -1.0963,
      "NetPercentageReturn": 0.0000,
      "Annualised": false
    },
    {
      "PeriodDescription": "3 mths",
      "GrossPercentageReturn": -1.8790,
      "NetPercentageReturn": 0.0000,
      "Annualised": false
    },
    {
      "PeriodDescription": "1 yr",
      "GrossPercentageReturn": 12.5027,
      "NetPercentageReturn": 0.0000,
      "Annualised": false
    },
    {
      "PeriodDescription": "Since 01/02/2021",
      "GrossPercentageReturn": -1.1234,
      "NetPercentageReturn": 0.0000,
      "Annualised": false
    }
  ]
}

Response Parameters

Parameter	Type	Description
DailyPercentageReturns	array
DailyPercentageReturns.Date	date-time	The date used to calculate performance data.
DailyPercentageReturns.PercentageReturn	double	The performance percentage return.
DailyPercentageReturns.CumulativePercentageReturn	double	Cumulative percentage return from the FromDate to Date.
PercentageReturns	array
PercentageReturns.PeriodDescription	string	A description of the period the returns are calculated for.
PercentageReturns.GrossPercentageReturn	double	The performance percentage return excluding expenses.
PercentageReturns.NetPercentageReturn	double	The performance percentage return including expenses.
PercentageReturns.Annualised	boolean	Whether the return is annualised.

GET Model Holdings

Definition: https://api.onpraemium.com/api/modelholdings

This endpoint returns holdings for the model.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

ModelId: AU1234
ValuationDate: 2021-02-23T00:00:00Z

Request Parameter - Query

Parameter	Type	Description
ModelIdrequired	string	ModelId as returned by the model endpoint.
ValuationDaterequired	date-time	Date used to display the data.

Response Examples

# 200 - OK
[
  {
    "Security": {
      "Code": "AAA",
      "Exchange": "ASX"
    },
    "TargetValuePercentage": 55.5806,
    "ActualValuePercentage": 55.5300
    "EstimatedYield": 5.84
  },
  {
    "Security": {
      "Code": "VGS",
      "Exchange": "ASX"
    },
    "TargetValuePercentage": 32.8733,
    "ActualValuePercentage": 32.5500,
    "EstimatedYield": 1.37
  },
  {
    "Security": {
      "Code": "AUDCASH",
      "Exchange": "CAS"
    },
    "TargetValuePercentage": 11.5461,
    "ActualValuePercentage": 11.9200,
    "EstimatedYield": 0.77
  }
]

Response Parameters

Parameter	Type	Description
Security	object
Security.Code	string	Security code.
Security.Exchange	string	Security exchange.
TargetValuePercentage	double	Target value in the model for the security.
ActualValuePercentage	double	Percentage that was implemented allowing for market movements and minimum cash. This is record in the model shadow account for the model.
EstimatedYield	double	Estimated yield of the security.

GET Model Weight Adjustment

Definition: https://api.onpraemium.com/api/modelweightadjustment

This endpoint returns weight adjustment for the model.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Query Examples

ModelId: AU1234

Request Parameter - Query

Parameter	Type	Description
ModelIdrequired	string	ModelId as returned by the model endpoint.

Response Examples

# 200 - OK
[
  {
    "Security": {
      "Isin": "",
      "Code": "AUDCASH",
      "Exchange": "UNL"
    },
    "Target": 0.9760
  },
  {
    "Security": {
      "Isin": "AU0000005902",
      "Code": "INIF",
      "Exchange": "ASX"
    },
    "Target": 99.0240
  }
]

Response Parameters

Parameter	Type	Description
Security	object
Security.Isin	string	International securities identification number of the security.
Security.Code	string	Security code of the security.
Security.Exchange	string	Exchange code of the security.
Target	double	The current percentage weight of the security in the model.

PUT Model Weight Adjustment

Definition: https://api.onpraemium.com/api/modelweightadjustment

This endpoint replace weight adjustment for the model.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1

Header Parameters

Parameter	Type	Description
Authorizationrequired	string	OAuth 2.0 access token.
x-pps-subscription-keyrequired	string	Product subscription key.
x-pps-api-versionrequired	string	API version of the endpoint.

Request Parameter - Body Examples

{
  "ModelId": "AU646",
  "ModelWeightAdjustments": [
    {
      "SecurityId": "AU111",
      "Target": 100.0000
    }
  ]
}

Request Parameter - Body

Parameter	Type	Description
ModelIdrequired	string	ModelId as returned by the model endpoint.
ModelWeightAdjustmentsrequired	array
ModelWeightAdjustments.SecurityIdrequired	string	Security ID.
ModelWeightAdjustments.Target	double	The target percentage weight of the security in the model.

Response Examples

# 204 - NoContent

Rate Limiting

The Praemium API limits requests made to each Praemium service.

The default is 1000 requests per minute, if you hit the limit the API will return HTTP code 429 (Too many requests). If you genuinely need to make more requests, please speak to our support team.

Response Codes

The Praemium API communicates errors through standard HTTP status codes paired. Generally the following pattern will apply:

400 - Bad Request

{
  "Message": "Unexpected character encountered while parsing value: d. Path 'AccountId', line 2, position 23."
}

Next Steps

To get started with the Praemium API, you need to first gain access.

If you are an existing customer, please connect contact with your local relationship manager or support team.

If you are new to Praemium, either as an Advice firm, investment manager or entrepreneur seeking to build a product atop of our platform – please get in touch via the contact page.

The process for gaining access is as follows:

1.) Contact your relationship manager or sales/support team, who will provide you a terms of use document

2.) On acceptance of the terms, a login will be created that allows you to access our Test API and more detailed documentation relevant to your type of subscription

3.) After your successful development and testing, you will be granted access to the Live environment