API status

Introduction

Upvest provides branches feature that allow clients to tailor the services and user experiences based on specific geographical markets. By implementing location-based segmentation, our clients can provide more personalised and relevant experiences that resonate with users in different regions.

Introduction

In today’s dynamic business environment, companies must constantly adapt their services to meet the unique needs of their clients. Geographical diversity among user bases can significantly influence preferences, behaviours, and expectations.

Upvest provides branches that allow clients to tailor the services and user experiences based on specific geographical markets. By implementing location-based segmentation, our clients can provide more personalised and relevant experiences that resonate with users in different regions.

Tailored branches empower clients to address economic and market-specific variations, making their offerings more aligned with local demands and legal eligibility. The following factors may vary depending on the locations of the client's target countries:

RequirementExample
Instrument distributionInstruments available for investment by the French branch.
Language of user reportsSpanish reports in the Spain branch.
Language of key information documents (KIDs)The client provides KIDs and could assign the branch to control which KIDs are displayed for which user.
Regulatory reportingCountry-specific ex-ante reporting formats.
TaxesUS withholding tax differentiation, local end user tax reporting.

How do branches work?

Upvest introduces branches to enable our clients to easily customise the services and user experience they offer their users. Branches are assigned based on the geographic market to which the user is assigned.

If the clients require branches, they contact Upvest and together we work out how the branches should be structured according to their requirements. The branch assigned to the user will represent the geographical market the user is a part of, which could be a single country or multiple countries.

Branch IDs

Once you have decided on branches, get in touch with us - e.g. the Upvest Launch Manager - and together we will agree on how the branches should be structured to meet your requirements.

Upvest will then create these branches and provide the appropriate branch_ids for you to assign at user level.

This branch identifier is a stateful entity in the system to which configurations can be applied (e.g. based on country-specific requirements) that apply to the users to whom it is assigned. This allows us to provide you with geographic and other expansion-specific configurations.

Each branch configuration is assigned a unique ID so that it is clearly traceable and configurable.

The branch_id is an optional field and is therefore only created for clients who require it. If no branch is specified, then the client’s default settings will apply. Branch configurations override the client's default settings (‘local trumps global’).

Instruments information

The country of distribution is determined by the location of the branch and not by the end user's place of residence or nationality.

Upvest develops instrument trading authorisations per branch_id, this means that the distribution countries within instruments are disclosed. It also checks whether the country of distribution of an instrument matches the branch_id.

Instruments information

The country of distribution is determined by the location of the client/branch office and not by the end user's place of residence or nationality.

Upvest develops instrument trading authorisations per branch ID, this means that the distribution countries within instruments are disclosed. It also checks whether the country of distribution of an instrument matches the branch_id.

The Investment API provides the /instruments endpoint to enable clients to make informed decisions about the availability and suitability of instruments for their users.

Clients access detailed information on specific financial instruments, which includes data such as countries of distribution.

Scalability

The design of both, branch_id and /instrumentsendpoint allows for future extensions. The Branch ID configuration can accommodate new geographical regions and configurations, while the /instruments endpoint can include additional instrument attributes and more granular filtering options.

Upvest will continue to expand the configuration options for the branch_id, including

  • Adapting the language of the GTCs, KIDs and reports.

  • Adapting regulatory reporting requirements to the requirements of the respective country.

  • Adapting instrument authorisations at end user level.