NAV Navbar

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 based on our products, roles and regions.

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 or Model Managers can access and manage their models via a specialised set of APIs. This includes the setting or updating of investment selection, accessing model FUM, Performance and other information.

Next Steps

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

If you are an existing customer, please 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 on top of our platform – please get in touch via the contact page for Australia or International.

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

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 authorise your application.

Applications that try to access the API without a valid access token will receive a 401 (Unauthorized) 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.


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.

Response Codes

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

Examples

# 401 - Unauthorized
content-type: application/json

{
  "Message": "Access token is missing or invalid."
}
Response code Description
200 OK
202 Accepted
204 No Content
400 Bad Request
401 Unauthorized
403 Forbidden
404 Not Found
405 Method Not Allowed
422 Unprocessable Entity
429 Too Many Requests
500 Internal Server Error

Rate Limiting

Examples

# 429 - Too Many Requests
content-type: application/json
retry-after: 36

{
  "Message": "Rate limit is exceeded. Try again in 36 seconds."
}

The Praemium API limits requests made to each Praemium service.

The default is 500 requests per minute. If you hit the limit, the API will return HTTP code 429 (Too many requests) with a header "retry-after" (containing the number of seconds until a request can be made again). If you genuinely need to make more requests, please speak to our support team.

SAML

Set up Identity Provider

Identity Provider (IdP) has to be set up before you can use the SAML SSO. To set up IdP, you will need to provide the following:

Destination applications

To determine a destination application that users will be landing, you will need to add "Application" attribute/value into your SAML Assertion/Token. The followings are the supported values:

If no "Application" attribute/value is provided, users will SSO into Platform & Reporting by default.

POST SAML Login

Definition: https://saml.onpraemium.com/login

This endpoint returns a SAML token for login to Praemium platform.

Header Examples

Content-Type: application/x-www-form-urlencoded
Header Parameters
Parameter Type Description
Content-Typerequired string Content type needs to be application/x-www-form-urlencoded.

Body Parameter Examples

SAMLResponse={base64 encoded string of your SAML token}
Body Parameters
Parameter Type Description
SAMLResponse string The value of the SAMLResponse parameter is the base64 encoding of an SAML token.

Response Examples

# 302 - Redirect
"https://login.onpraemium.com/useraccount/sso?token=******"

SSO

POST SSO Login

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 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.


Applications

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 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 (INTL response)
[
  {
    "Id": "UK87",
    "Name": "Adviser Firm A",
    "MaxNoOfBankAccounts": 0,
    "DisableCustomisations": false,
    "IsSuperSma": false,
    "ServiceId": "UK1000000112",
    "ServiceName": "PIL  DPS GBP",
    "Region": "International",
    "Models": [
      {
        "Id": "UK1000001282",
        "Name": "Test US Ethical",
        "Style": "MAM",
        "Code": "Test Ethical",
        "ManagerName": "Model Manager Firm 5192",
        "FeeOverride": {
          "Value": 0.0,
          "IsTiered": false
        },
        "TaxWrappers": [
          3,
          4,
          8,
          9
        ]
      },
      {
        "Id": "UK1000002828",
        "Name": "Equity Income Fund A USD",
        "Style": "SAM",
        "Code": "E3AG6S7",
        "ManagerName": "MNG",
        "FeeOverride": {
          "Value": 0.0,
          "IsTiered": false
        },
        "TaxWrappers": [
          1,
          2,
          6,
          4,
          13
        ]
        "SingleAssetModelIsin": "IE10G3QG6S78",
        "SingleAssetModelCurrencyCode": "USD"
      }
    ],
    "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": "Test Provider",
        "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.
Models.TaxWrappers array Unspecified = 0, CgtChargeable = 1, TaxExempt = 2, Unknown = 3, 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, InternationalPensionsAndSavingsScheme = 19, Jisa = 20, OffshoreBondPersonalised = 21.
Models.SingleAssetModelIsin string ISIN of security. (Single asset model only) (INTL only)
Models.SingleAssetModelCurrencyCode string Currency code of security. (Single asset model only) (INTL only)
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.


GET INTL Ceding Parties

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

This endpoint returns the ceding party 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 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 (INTL 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.


GET AU Super Funds

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

This endpoint returns all super funds.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string Access token.
x-pps-subscription-keyrequired string Product subscription key.
x-pps-api-versionrequired string API version of the endpoint.

Response Examples

# 200 - OK
[
  {
    "Usi": "75703857864088",
    "Spin": "MAI23984325",
    "FundName": " Praemium SMA Superannuation Fund",
    "ProductName": " Praemium Super SMA Accumulation Account"
  },
  {
    "Usi": " 75703857864089",
    "FundName": " Praemium SMA Superannuation Fund",
    "ProductName": " Praemium SMA Superannuation Fund - Pension Account"
  }
]
Response Parameters
Parameter Type Description
Usi string Unique superannuation identifier (USI) is used in SuperStream to identify an APRA fund and/or its superannuation product which an employee (member) is contributing to.
Spin string Superannuation product identifier number.
FundName string Name of the superannuation fund.
ProductName string Product name of the superannuation fund.


POST AU Individual Applicant & Individual Account

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

This endpoint creates an individual applicant and an individual 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 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 AU Corporate Applicant & Company Account

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

This endpoint creates a corporate applicant and a 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 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 AU Individual Applicant & Trust Account

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

This endpoint creates an 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 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": 15,
      "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 AU Corporate Applicant & Trust Account

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

This endpoint creates a corporate 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 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": 15,
      "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 AU Individual Applicant & SuperSMA Accumulation Account

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

This endpoint creates an 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 AU Individual Applicant & SuperSMA Account-Based-Pensions Account

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

This endpoint creates an individual applicant and a SuperSMA account-based-pensions (ABP) 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 AU Individual Applicant & SuperSMA Transition-To-Retirement Account

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

This endpoint creates an individual applicant and a SuperSMA transition-to-retirement (TTR) 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 INTL Individual Applicant & General Investment Account

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

This endpoint creates an individual applicant and a general investment account (GIA) 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 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 INTL Corporate Applicant & General Investment Account

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

This endpoint creates a corporate applicant and a general investment account (GIA) 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 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 INTL Trust Applicant & General Investment Account

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

This endpoint creates a trust applicant and a general investment account (GIA) 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 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 INTL Individual Applicant & Individual Savings Account

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

This endpoint creates an individual applicant and an individual savings account (ISA) 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 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 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 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 (INTL only)
FormType enum Digital = 0, Paper = 1 (INTL only)

Response Examples

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


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 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.


Users

GET User

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

This endpoint returns user ID by username.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string Access token.
x-pps-subscription-keyrequired string Product subscription key.
x-pps-api-versionrequired string API version of the endpoint.

Request Parameter - Query Examples

Username: john_smith
Request Parameter - Query
Parameter Type Description
Usernamerequired string User name.

Response Examples

# 200 - OK
{
  "UserId": 123456
}
Response Parameters
Parameter Type Description
UserId integer User ID.


POST User

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

This endpoint allows creating investor.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string Access token.
x-pps-subscription-keyrequired string Product subscription key.
x-pps-api-versionrequired string API version of the endpoint.

Request Parameter - Body Examples

{
  "Name": {
    "FirstName": "Stephen",
    "LastName": "Tom",
    "Title": ""
  },
  "Addresses": [
    {
      "Line1": "Unit 1",
      "Line2": "123 Test Street",
      "Line3": "",
      "Country": "AUS",
      "Postcode": "3000",
      "SuburbOrCounty": "Melbourne",
      "TownOrCityOrState": "VIC",
      "Type": 0
    }
  ],
  "AdviserId": 76681,
  "DateOfBirth": "1980-11-01T00:00:00.0000000+10:00",
  "Email": "aefdsg@praemium.com",
  "Gender": 1,
  "GenerateGetStartedToken": true,
  "JobTitle": "Developer",
  "Location": "Melbourne",
  "Phone": "0400000000",
  "PhoneOther": "0498765432",
  "Team": "Team AB"
}
Request Parameter - Body
Parameter Type Description
Namerequired object The user's name.
Name.Title enum The user's title. Miss = 0, Mr = 1, Mrs = 2, Ms = 3, Dr = 4, Prof = 5, or null.
Name.FirstNamerequired string The user's first name.
Name.LastNamerequired string The user's last name.
Gender enum Male = 1, Female = 2, or null.
Emailrequired string The user's email address.
DateOfBirth date-time For security purposes if we need to identify the user over the phone.
MothersMaidenName string For security purposes if we need to identify the user over the phone.
Addressesrequired array Contains details of the user's address.
Addresses.Typerequired enum Home = 0, Office = 1, Mailing = 2.
Addresses.Line1required string Address detail line 1.
Addresses.Line2 string Address detail line 2 (if applicable).
Addresses.Line3 string Address detail line 3 (if applicable).
Addresses.SuburbOrCountyrequired string Suburb or county details.
Addresses.TownOrCityOrStaterequired string State or town or city details.
Addresses.Postcoderequired string Postcode.
Addresses.Countryrequired string Country code. For example, AUS = Australia.
Phonerequired string The user's phone number.
PhoneOther string An alternative phone number for the investor.
JobTitle string The user's job title.
AdviserIdrequired integer The adviser ID for this user's adviser.
GenerateGetStartedTokenrequired boolean Whether to generate an SSO token for this user to get started.

Response Examples

# 200 - OK
{
  "Id": 9108602,
  "GetStartedToken": "https://login.onpraemium.com/useraccount/changepassword?token=9108602-ED6205A469E04029B724EA9A11BDE37F-637141711208895228"
}
Response Parameters
Parameter Type Description
Id integer User ID.
GetStartedToken string An SSO token for this user to get started.


PATCH User Accounts

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

This endpoint allows linking user to accounts.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string 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": 9091234,
  "AccountIds": ["AU400000", "AU400001"],
  "UserRole": 4,
  "Access": 2
}
Request Parameter - Body
Parameter Type Description
UserIdrequired integer User ID.
AccountIdsrequired array An array of account IDs.
UserRole enum Accountant = 0, Custodian = 1, FinancialPlanner = 2, InvestmentAdviser = 3, Other = 4, Owner = 5. Default to 4.
Access enum Full = 0, Read = 1, Update = 2. Default to 1.

Response Examples

# 204 - NoContent


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 Access token.
x-pps-subscription-keyrequired string Product subscription key.
x-pps-api-versionrequired string API version of the endpoint.

Request Parameter - Query Examples

# Return all
Page: 1
Size: 100

# 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.

Response Examples

# 200 - OK
{
  "Data": [
    {
      "Id": "AU251995",
      "Code": "240153Cons",
      "Name": "Test account 1",
      "ConsolidationType": 84,
      "AccountType": 0,
      "EntityType": 4,
      "IsSma": false,
      "Status": 0,
      "RecalcType": 2,
      "RecalcStatus": 0,
      "ValuationDate": "2021-04-23T00:00:00+10:00",
      "FirstTransactionDate": "2001-08-07T00:00:00+10:00",
      "CreatedDate": "1980-01-01T00:00:00+11:00",
      "LastRecalcDate": "2021-04-27T14:45:10.943+10:00",
      "RecalcRequired": false,
      "MarketValue": 1566857.15,
      "OwnerUserName": "AAA",
      "Product": "Platinum",
      "BenchmarkId1": "AU9",
      "Benchmark1": "S&P/ASX 200 Accumulation Index",
      "BenchmarkMargin1": 4.000000,
      "BenchmarkId2": "AU8",
      "Benchmark2": "S&P/ASX 200",
      "BenchmarkMargin2": 0.000000
    },
    {
      "Id": "AU252176",
      "Code": "WalshCons",
      "Name": "Test account 2",
      "ConsolidationType": 84,
      "AccountType": 0,
      "EntityType": 4,
      "IsSma": false,
      "Status": 0,
      "RecalcType": 1,
      "RecalcStatus": 1,
      "ValuationDate": "2021-04-23T00:00:00+10:00",
      "FirstTransactionDate": "1983-12-31T00:00:00+11:00",
      "CreatedDate": "1980-01-01T00:00:00+11:00",
      "LastRecalcDate": "2021-04-23T20:15:19.03+10:00",
      "RecalcRequired": false,
      "MarketValue": 16881784.98,
      "OwnerUserName": "ABC",
      "Product": "SMSF"
    }
    {
      "Id": "AU275166",
      "Code": "SMA00275165_EXT",
      "Name": "Test account 3",
      "ConsolidationType": 78,
      "AccountType": 0,
      "EntityType": 4,
      "IsSma": true,
      "Status": 0,
      "RecalcType": 1,
      "RecalcStatus": 0,
      "ValuationDate": "2021-04-23T00:00:00+10:00",
      "FirstTransactionDate": "2003-06-30T00:00:00+10:00",
      "CreatedDate": "1980-01-01T00:00:00+11:00",
      "LastRecalcDate": "2021-04-23T20:06:38.53+10:00",
      "RecalcRequired": false,
      "MarketValue": 989833.01,
      "OwnerUserName": "TEST",
      "Product": "DISPUTES",
      "BenchmarkId1": "AU8",
      "Benchmark1": "S&P/ASX 200",
      "BenchmarkMargin1": 0.000000
    }
  ],
  "Metadata": {
    "TotalCount": 58,
    "TotalPages": 20
  }
}
Response Parameters
Parameter Type Description
Data array
Data.Id string Account ID.
Data.Code string Account code.
Data.Name string Account name.
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.
Data.ValuationDate date-time Account valuation date or asat date.
Data.FirstTransactionDate date-time The first transaction date of the account.
Data.CreatedDate date-time The created date of the account.
Data.LastRecalcDate date-time The run-date of the latest account recalculation.
Data.RecalcRequired boolean Whether this account requires recalculation to accurately calculate all values.
Data.MarketValue double The Valuation of the account on the valuation date.
Data.OwnerUserName string The account owner's username.
Data.Product string The description of the account product.
Data.BenchmarkId1 string The unique ID of the account's benchmark 1.
Data.Benchmark1 string The name of the account’s benchmark 1.
Data.BenchmarkMargin1 double The margin (% p.a.) of the account’s benchmark 1.
Data.BenchmarkId2 string The unique ID of the account's benchmark 2.
Data.Benchmark2 string The name of the account’s benchmark 2.
Data.BenchmarkMargin2 double The margin (% p.a.) of the account’s benchmark 2.
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 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 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.


Holdings

GET Holdings

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

This endpoint returns holdings 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 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
AccountIdsrequired array An array of account IDs.
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,
      "MarketValueGainOrLoss": 3603.16,
      "ExchangeRateGainOrLoss": 0.00,
      "EstimatedIncome": 427.05,
      "Yield": 2.1100
    },
    "Holdings": [
      {
        "Security": {
          "AssetClassDescription": "Cash & Equivalents",
          "AssetClassCode": "ASX",
          "TypeDescription": "ASX Listed",
          "GicsDescription": "SECTOR NOT CLASSIFIED",
          "Code": "AAA",
          "Exchange": "ASX"
        },
        "Quantity": 17.0000,
        "UnitCost": 50.2132,
        "Cost": 853.62,
        "UnitValue": 50.0547,
        "UnitPriceDate": "2021-02-18T00:00:00+11:00",
        "Value": 851.19,
        "PercentTotalValue": 4.200,
        "GainOrLoss": -2.43,
        "MarketValueGainOrLoss": 0.00,
        "ExchangeRateGainOrLoss": -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",
          "Exchange": "ASX"
        },
        "Quantity": 3.0000,
        "UnitCost": 75.8367,
        "Cost": 227.51,
        "UnitValue": 131.7235,
        "UnitPriceDate": "2021-02-18T00:00:00+11:00",
        "Value": 395.25,
        "PercentTotalValue": 1.9500,
        "GainOrLoss": 167.74,
        "MarketValueGainOrLoss": 167.74,
        "ExchangeRateGainOrLoss": 0.00,
        "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.MarketValueGainOrLoss double MarketValueGainOrLoss as a result of the market price (MV) movement of the security. (Account currency)
Valuation.ExchangeRateGainOrLoss double ExchangeRateGainOrLoss as a result of the movement of the exchange rate (FX). (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.MarketValueGainOrLoss double MarketValueGainOrLoss as a result of the market price (MV) movement of the security. (Account currency)
Holdings.ExchangeRateGainOrLoss double ExchangeRateGainOrLoss as a result of the movement of the exchange rate (FX). (Account currency)
Holdings.PercentTotalGainOrLoss double The total gain or loss (TG) 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.


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 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. Default to false.
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 Per Model

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

This endpoint returns holdings per 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 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,
    "HoldingsInModel": [
      {
        "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,
    "HoldingsInModel": [
      {
        "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)
HoldingsInModel array Holdings that are held by the account due to its model subscriptions.
HoldingsInModel.ModelCode string Model code.
HoldingsInModel.ModelPercentage double Percentage of the model.
HoldingsInModel.Holdings array Contains the holdings attributable to the model on the date.
HoldingsInModel.Holdings.Security object
HoldingsInModel.Holdings.Security.Code string Security code.
HoldingsInModel.Holdings.Security.Exchange string Security exchange.
HoldingsInModel.Holdings.Value double The value that is attributable to this model on the date. (Account currency)
HoldingsInModel.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 Holdings 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..


Transactions

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 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. Default to false.
ShowUnconfirmed boolean Whether to show unconfirmed transactions. Default to false.
Page integer Page number to return. Default to 1.
Size integer Page size to return. Default to 100.
OrderBy enum TransactionDate = 0, Security = 1. Default to 0.
Order enum Asc = 0, Desc = 1. Default to 1.

Response Examples

# 200 - OK
{
  "Data": [
    {
      "ContractNoteReference": "104729665",
      "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"
    },
    {
      "ContractNoteReference": "",
      "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.ContractNoteReference string Unique contract note reference number.
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 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. Default to false.
Page integer Page number to return. Default to 1.
Size integer Page size to return. Default to 100.
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 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. Default to 100.
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)


Income

GET Income Detail

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

This endpoint returns income detail 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 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)


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 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 Bulk Income Schedules

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

This endpoint returns income schedules for all specified accounts.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string 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: "AU400000"
AccountIds: "AU400001"
FromDate: 2021-01-23T00:00:00Z
ToDate: 2021-02-23T00:00:00Z
Request Parameter - Query
Parameter Type Description
AccountIdsrequired array An array of account IDs.
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
[
  {
    "AccountId": "AU400000",
    "IncomeSchedules": [
      {
        "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
        }
    ]
  },
  {
    "AccountId": "AU400001",
    "IncomeSchedules": [
      {
        "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
AccountId string Account ID.
IncomeSchedules array
IncomeSchedules.CashAmount double Amount received via cash. (Account currency)
IncomeSchedules.TrustOtherExpenses double Other expenses related to the income record. (Account currency)
IncomeSchedules.ForeignIncomeTaxOffsetsTotal double Foreign income tax offsets. (Account currency)
IncomeSchedules.TaxWithheld double Total tax withheld on the income record. (Account currency)
IncomeSchedules.IncomeTotal double Total value of the income record. (Account currency)
IncomeSchedules.NonAssessableTotal double Total amount that is non assessable for tax purposes. (Account currency)
IncomeSchedules.TrustCgtDistributionsTotal double Amount received due to distributed capital gains. (Account currency)
IncomeSchedules.ForeignIncomeTotal double Amount received from non-Australian sources. (Account currency)
IncomeSchedules.Drp double Amount received via dividend reinvestment. (Account currency)
IncomeSchedules.AustralianTrustOther double Australian sourced income component that is not classified as one of the other types. (Account currency)
IncomeSchedules.FrankedTotal double Amount received that was franked. (Account currency)
IncomeSchedules.UnfrankedTotal double Amount received that was unfranked. (Account currency)
IncomeSchedules.Interest double Interest amount. (Account currency)
IncomeSchedules.TaxDate date-time Tax date of the income record.
IncomeSchedules.Security object
IncomeSchedules.Security.Code string Security code.
IncomeSchedules.Security.Exchange string Security exchange.
IncomeSchedules.IncomeTypeDescription string Type of income received.
IncomeSchedules.IncomeId string Praemium income ID.
IncomeSchedules.FrankingCreditsTotal double Imputation credits. (Account currency)
IncomeSchedules.AccruedAmount double Income amount that is accrued. (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 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
Security object
Security.Code string Security code.
Security.Exchange string Security exchange.
DrpType enum Either DRP (Dividend Reinvestment Plan) or BSP (Bonus Share Plan).
FromDate date-time The date that the DRP is active from.
ToDate date-time The date that the DRP is active to.
MaxSharesParticipating double The number of shares held that are requested to participate in the reinvestment plan.
PercentSharesParticipating double The percentage of the DRP to take as shares. Note that this cannot be used in conjunction with MaxSharesParticipating.
ExcludeFromDrp boolean Whether the security is excluded from the account-wide reinvestment plan.


Expenses

GET Expense Detail

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

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 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.


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 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 Realised CGT Detail

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

This endpoint returns realised CGT Detail 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 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 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 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)


GET Unrealised CGT Detail

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

This endpoint returns unrealised CGT detail 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 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. Default to 100.

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.


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 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. Default to false.
IncludeLoans boolean Whether loans should be included. Default to false.
IncludeExcludedSecurities boolean Whether or not to include any security that has been excluded from performance. Default to false.
IncludeTaxCredits boolean Whether or not to include tax credits. Default to false.
DisplayReturns enum BeforeExpenses = 0, AfterExpenses = 1, Both = 2. Default to 2.
MultiplePeriods integer The periods to return. Default to -1.
  • 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. Default to 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 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. Default to false.
CalculationMethod enum ApproximateReturns = 0, TimeWeightedReturn = 1. Default to 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 boolean 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 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. Default to false.
IncludeExcludedSecurities boolean Whether or not to include any security that has been excluded from performance. Default to false.
IncludeTaxCredits boolean Whether or not to include tax credits. Default to false.
DisplayReturns enum BeforeExpenses = 0, AfterExpenses = 1, Both = 2. Default to 2.
CalculationMethod enum ApproximateReturns = 0, TimeWeightedReturn = 1. Default to 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 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 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.
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. Default to false.
IncludeLoans boolean Whether loans should be included. Default to false.
IncludeTaxCredits boolean Whether or not to include tax credits. Default to false.
IncludeForeignTaxPaid boolean Whether or not to include foreign tax paid. Default to false.
IncludeExcludedSecurities boolean Whether or not to include any security that has been excluded from performance. Default to false.
CalculationMethod enum ApproximateReturns = 0, TimeWeightedReturn = 1. Default to 1.

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.


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 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 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 The periods to return. Default to -1.
  • 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 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.


Files

GET Publisher Events

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

This endpoint returns publisher 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 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 publisher event.
EventName string Name of the publisher event.
CreatedDate date-time Date the record was created.
UpdatedDate date-time Date the record was updated.


GET Publisher Event Detail

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

This endpoint returns publisher event detail for the publisher event.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string 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 file.
GeneratedDate date-time Date the file was generated.
PublishedDate date-time Date the file was published.


GET File

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

This endpoint downloads file.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string 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 publisher event detail endpoint.

Response Examples

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


Trading SMA

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 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 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


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 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 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": "AU2"
      },
      {
          "SecurityId": "AU3"
      }
  ]
}
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 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": "AU2"
      },
      {
          "SecurityId": "AU3"
      }
  ]
}
Request Parameter - Body
Parameter Type Description
AccountIdrequired string Account ID.
SecurityExclusionsrequired 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 Access token.
x-pps-subscription-keyrequired string Product subscription key.
x-pps-api-versionrequired string API version of the endpoint.

Request Parameter - Query Examples

# Delete single security exclusion
AccountId: AU400000
SecurityId: AU1

# Delete security exclusions
AccountId: AU400000
Request Parameter - Query
Parameter Type Description
AccountIdrequired string Account ID.
SecurityId string Security ID.

Response Examples

# 204 - NoContent


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 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 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": "AU2",
          "ToSecurityId": "AU3"
      }
  ]
}
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 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": "AU2",
          "ToSecurityId": "AU3"
      }
  ]
}
Request Parameter - Body
Parameter Type Description
AccountIdrequired string Account ID.
SecuritySubstitutionsrequired 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 Access token.
x-pps-subscription-keyrequired string Product subscription key.
x-pps-api-versionrequired string API version of the endpoint.

Request Parameter - Query Examples

 # Delete single security substitution
AccountId: AU400000
FromSecurityId: AU2
ToSecurityId: AU3

 # Delete all security substitutions
AccountId: AU400000
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


GET Security Customisations

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

This endpoint returns security exclusions and 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 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
{
  "SecurityExclusions": [
    {
      "CreatedDate": "2019-12-09T15:20:00.237+11:00",
      "Security": {
        "Code": "CBA",
        "Exchange": "ASX"
      }
    },
    {
      "CreatedDate": "2020-01-10T10:13:54.67+11:00",
      "Security": {
        "Code": "VAN0019AU",
        "Exchange": "FND"
      }
    }
  ],
  "SecuritySubstitutions": [
    {
      "CreatedDate": "2021-02-16T16:17:07.61+11:00",
      "FromSecurity": {
        "Code": "RIO",
        "Exchange": "ASX"
      },
      "ToSecurity": {
        "Code": "CBA",
        "Exchange": "ASX"
      }
    }
  ]
}
Response Parameters
Parameter Type Description
SecurityExclusions array
SecurityExclusions.CreatedDate date-time Date security exclusion was created.
SecurityExclusions.Security object Security name.
SecurityExclusions.Security.Code string Security code.
SecurityExclusions.Security.Exchange string Security exchange.
SecuritySubstitutions array
SecuritySubstitutions.CreatedDate date-time Date security substitution was created.
SecuritySubstitutions.FromSecurity object From security.
SecuritySubstitutions.FromSecurity.Code string Security code.
SecuritySubstitutions.FromSecurity.Exchange string Security exchange.
SecuritySubstitutions.ToSecurity object To security.
SecuritySubstitutions.ToSecurity.Code string Security code.
SecuritySubstitutions.ToSecurity.Exchange string Security exchange.


PUT Security Customisations

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

This endpoint allows you to replace security customisations for the account. If a blank array of SecurityExclusions and/or SecuritySubstitutions is sent as a body parameter, all exclusions and/or 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 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": "AU1"
    }
  ]
  "SecuritySubstitutions": [
    {
      "FromSecurityId": "AU2",
      "ToSecurityId": "AU3"
    }
  ]
}
Request Parameter - Body
Parameter Type Description
AccountIdrequired string
SecurityExclusionsrequired array
SecurityExclusions.SecurityIdrequired string Security ID.
SecuritySubstitutionsrequired array
SecuritySubstitutions.FromSecurityIdrequired string From security ID.
SecuritySubstitutions.ToSecurityIdrequired string To security ID.

Response Examples

# 200 - OK
{
  "SecurityExclusions": [
    {
      "CreatedDate": "2019-12-09T15:20:00.237+11:00",
      "Security": {
        "Code": "CBA",
        "Exchange": "ASX"
      }
    },
    {
      "CreatedDate": "2020-01-10T10:13:54.67+11:00",
      "Security": {
        "Code": "VAN0019AU",
        "Exchange": "FND"
      }
    }
  ],
  "SecuritySubstitutions": [
    {
      "CreatedDate": "2021-02-16T16:17:07.61+11:00",
      "FromSecurity": {
        "Code": "RIO",
        "Exchange": "ASX"
      },
      "ToSecurity": {
        "Code": "CBA",
        "Exchange": "ASX"
      }
    }
  ]
}
Response Parameters
Parameter Type Description
SecurityExclusions array
SecurityExclusions.CreatedDate date-time Date security exclusion was created.
SecurityExclusions.Security object Security name.
SecurityExclusions.Security.Code string Security code.
SecurityExclusions.Security.Exchange string Security exchange.
SecuritySubstitutions array
SecuritySubstitutions.CreatedDate date-time Date security substitution was created.
SecuritySubstitutions.FromSecurity object From security.
SecuritySubstitutions.FromSecurity.Code string Security code.
SecuritySubstitutions.FromSecurity.Exchange string Security exchange.
SecuritySubstitutions.ToSecurity object To security.
SecuritySubstitutions.ToSecurity.Code string Security code.
SecuritySubstitutions.ToSecurity.Exchange string Security exchange.


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 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 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


GET All ESG Categories

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

This endpoint returns all categories for environmental, social, and corporate governance (ESG).

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string 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": "weapons",
    "Name": "Controversial weapons"
  },
  {
    "Id": "animalsNonPharma",
    "Name": "Animal testing (non-pharmaceutical)"
  }
]
Response Parameters
Parameter Type Description
Id string ESG category ID.
Name string ESG category name.


GET Account ESG Categories

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

This endpoint returns ESG categories 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 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
[
  "weapons",
  "animalsNonPharma"
]


POST Account ESG Categories

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

This endpoint allows you to add ESG categories 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 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",
  "CategoryIds": [
    "weapons",
    "animalsNonPharma"
  ]
}
Request Parameter - Body
Parameter Type Description
AccountIdrequired string Account ID.
CategoryIdsrequired array An array of ESG category IDs.

Response Examples

# 204 - NoContent


PUT Account ESG Categories

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

This endpoint allows you to replace ESG categories for the account. If a blank array of CategoryIds is sent as a body parameter, all account ESG categories 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 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",
  "CategoryIds": [
    "weapons",
    "animalsNonPharma"
  ]
}
Request Parameter - Body
Parameter Type Description
AccountIdrequired string Account ID.
CategoryIds array An array of ESG category IDs.

Response Examples

# 204 - NoContent


DELETE Account ESG Categories

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

This endpoint allows you to delete ESG categories for the account. If CategoryId is provided, the single ESG category will be removed. If CategoryId is not provided, all account ESG categories 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 Access token.
x-pps-subscription-keyrequired string Product subscription key.
x-pps-api-versionrequired string API version of the endpoint.

Request Parameter - Query Examples

# Delete single ESG category
AccountId: AU400000
CategoryId: animalsNonPharma

# Delete all ESG categories
AccountId: AU400000
Request Parameter - Query
Parameter Type Description
AccountIdrequired string Account ID.
CategoryId string The category ID as returned by the all ESG categories endpoint.

Response Examples

# 204 - NoContent


Payments

GET AU BPAY

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

This endpoint returns BPAY reference numbers 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 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
Request Parameter - Query
Parameter Type Description
AccountIdsrequired array An array of account IDs.

Response Examples

# 200 - OK
[
  {
    "AccountId": "AU400000",
    "ReferenceNumber": "4000001"
  }
  {
    "AccountId": "AU400001",
    "ReferenceNumber": "4000005"
  }
]
Response Parameters
Parameter Type Description
AccountId string Account ID.
ReferenceNumber string BPAY reference number.


GET Cashflow Instructions

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

This endpoint returns cashflow instructions 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 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": "AU243904",
    "CashflowInstructionType": 5,
    "FrequencyType": 0,
    "StartDate": "2021-05-05T00:00:00+10:00",
    "EndDate": "2200-01-01T00:00:00+11:00",
    "Value": 0.00,
    "Allocations": [
      {
        "ModelCode": "MACAUD",
        "Sequence": 1,
        "Percentage": 100.000000
      }
    ]
  },
  {
    "Id": "AU253714",
    "CashflowInstructionType": 3,
    "FrequencyType": 0,
    "StartDate": "2021-05-12T00:00:00+10:00",
    "EndDate": "2021-05-12T00:00:00+10:00",
    "Value": 16.32,
    "Allocations": [
      {
        "ModelCode": "AB0001",
        "Sequence": 1,
        "Percentage": 100.000000
      }
    ]
  },
  {
    "Id": "AU253778",
    "CashflowInstructionType": 2,
    "FrequencyType": 2,
    "StartDate": "2021-06-24T00:00:00+10:00",
    "EndDate": "2021-09-24T00:00:00+10:00",
    "Value": 16.32,
    "Allocations": [
      {
        "ModelCode": "AB0001",
        "Sequence": 1,
        "Percentage": 50.000000
      },
      {
        "ModelCode": "ProRata",
        "Sequence": 2,
        "Percentage": 50.000000
      }
    ]
  }
]
Response Parameters
Parameter Type Description
Id string Cashflow instruction ID.
CashflowInstructionType enum Regular contribution = 1, Regular withdrawal = 2, One-off direct debit = 3, One-off withdrawal = 4, Income reinvestment = 5, Expenses = 6, Pension payment = 7 (Only allowed for SuperSMA pension accounts), All contributions and rollovers = 8 (Only allowed for SuperSMA accumulation accounts), Other withdrawals = 9, Term deposit maturity = 10, Term deposit order = 11, Superfund withdrawals and rollovers = 16 (Only allowed for SuperSMA accumulation and pension accounts), Insurance premiums = 17 (Only allowed for SuperSMA accumulation and pension accounts).
FrequencyType enum Adhoc =0, Monthly = 1, Quarterly = 2, SixMonthly = 3, Annually = 4, Daily = 5, Weekly = 6.
StartDate date-time Start date of the cashflow instruction.
EndDate date-time End date of the cashflow instruction.
Value double Value of the cashflow instruction.
Allocations array Cashflow instruction details.
Allocations.ModelCode string Model code. (Model code ProRata means pro rata across existing models)
Allocations.Sequence integer Sequence to apply. (Starting from 1 as highest priority, then 2, 3 ...)
Allocations.Percentage double Model percentage. (Only applicable for regular contribution, income reinvestment, one-off direct debit)


POST One-off Cashflow Instructions

Definition: https://api.onpraemium.com/api/cashflowinstructions/oneoff

This endpoint allows you to add one-off cashflow instruction 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 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",
  "CashflowInstructionType": 3,
  "Amount": 16.32,
  "Allocations": [
    {
      "ModelCode": "AB0001",
      "Sequence": 1,
      "Percentage": 50.1
    },
    {
      "ModelCode": "MACAUD",
      "Sequence": 1,
      "Percentage": 49.9
    }
  ]
}
Request Parameter - Body
Parameter Type Description
CashflowInstructionTyperequired enum OneOffDirectDebit = 3, OneOffWithdrawal = 4.
Amount double Amount of the one-off cashflow instruction to apply.
AccountIdrequired string Account ID.
Allocationsrequired array Cashflow instruction details.
Allocations.ModelCoderequired string Model code. (Model code ProRata means pro rata across existing models)
Allocations.Sequence integer Sequence to apply. (Starting from 1 as highest priority, then 2, 3 ...)
Allocations.Percentage double Model percentage. (Only applicable for regular contribution, income reinvestment, one-off direct debit)

Response Examples

# 204 - NoContent


DELETE One-off Cashflow Instructions

Definition: https://api.onpraemium.com/api/cashflowinstructions/oneoff

This endpoint allows you to delete one-off cashflow instruction for the account. (Only allowed for one-off direct debit)

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string 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
CashflowInstructionId: AU1
CashflowInstructionType: 3
Request Parameter - Query
Parameter Type Description
AccountIdrequired string Account ID.
CashflowInstructionIdrequired string Cashflow instruction ID returned by GET cashflow instructions endpoint
CashflowInstructionTyperequired OneOffDirectDebit = 3.

Response Examples

# 204 - NoContent


PUT Regular Cashflow Instructions

Definition: https://api.onpraemium.com/api/cashflowinstructions/regular

This endpoint allows you to update regular cashflow instruction 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 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": 16.32,
  "CashflowInstructionType": 2,
  "FrequencyType": 1,
  "Allocations": [
    {
      "Percentage": 50,
      "Sequence": 1,
      "ModelCode": "AB0005"
    },
    {
      "Percentage": 50,
      "Sequence": 2,
      "ModelCode": "ProRata",
    }
  ],
  "StartDate": "2021-06-24T00:00:00+10:00",
  "EndDate": "2021-09-24T00:00:00+10:00",
  "FrequencyType": 2
}
Request Parameter - Body
Parameter Type Description
CashflowInstructionTyperequired enum Regular contribution = 1, Regular withdrawal = 2, Income reinvestment = 5, Expenses = 6, All contributions and rollovers = 8 (only allowed for SuperSMA accumulation accounts), Other withdrawals = 9, Superfund withdrawals and rollovers = 16 (Only allowed for SuperSMA accumulation and pension accounts), Insurance premiums = 17 (Only allowed for SuperSMA accumulation and pension accounts).
FrequencyTyperequired enum Monthly = 1, Quarterly = 2, SixMonthly = 3, Annually = 4.
StartDate date-time Start date of the cashflow instruction. (Only applicable for regular withdrawal)
EndDate date-time End date of the cashflow instruction. (Only applicable for regular withdrawal)
Amount double Amount of the cashflow instruction to apply. (Only applicable for regular contribution and regular withdrawal)
AccountIdrequired string Account ID.
Allocationsrequired array Cashflow instruction details.
Allocations.ModelCoderequired string Model code. (Model code ProRata means pro rata across existing models)
Allocations.Sequence integer Sequence to apply. (Starting from 1 as highest priority, then 2, 3 ...)
Allocations.Percentage double Model percentage. (Only applicable for regular contribution, income reinvestment, one-off direct debit)

Response Examples

# 204 - NoContent


DELETE Regular Cashflow Instructions

Definition: https://api.onpraemium.com/api/cashflowinstructions/regular

This endpoint allows you to delete regular cashflow instruction for the account. (Only allowed for regular contribution and regular withdrawal)

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string 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
CashflowInstructionType: 1
Request Parameter - Query
Parameter Type Description
AccountIdrequired string Account ID.
CashflowInstructionTyperequired RegularContribution = 1, RegularWithdrawal = 2.

Response Examples

# 204 - NoContent


Investments

GET Securities

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

This endpoint returns the security details for the service. If using search term, only top 10 results will be returned.

Header Examples

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImt...
x-pps-subscription-key: d3e30ecd1ab345...
x-pps-api-version: v1
Header Parameters
Parameter Type Description
Authorizationrequired string 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. If Search is provided, SecurityIds and SecurityCodes will be ignored.
PdsId 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 (INTL 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. (Only returned when PdsId is supplied) (AU only)


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 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 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 The model ID 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 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 The model ID 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 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 The model ID 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 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 The model ID 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 can schedule 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 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 The model ID 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

# 202 - Accepted