{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","img"]},"type":"markdown"},"seo":{"title":"Business accounts overview","description":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API.","siteUrl":"https://docs.upvest.co/","image":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png","keywords":"documentation, api","lang":"en-US","meta":[{"name":"description","content":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API."},{"name":"image","content":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png"},{"name":"twitter:card","content":"summary_large_image"},{"name":"twitter:title","content":"Welcome to the Upvest API Documentation"},{"name":"twitter:image","content":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png"},{"name":"twitter:description","content":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API."},{"name":"og:url","content":"https://docs.upvest.co/"},{"name":"og:title","content":"Welcome to the Upvest API Documentation"},{"name":"og:description","content":"Welcome to the Upvest API documentation. Here you will find all the information you need to integrate with our API."},{"name":"og:image","content":"/assets/upvest-logo-card.ee25ccc59849324b0b73151a5c972c87639419556344db0b6dcf518151cb4c3c.925ff8b2.png"}]},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"business-accounts-overview","__idx":0},"children":["Business accounts overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Business accounts enable clients to onboard businesses including both corporate entities and sole traders who wish to trade in their business capacity."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"supported-entities","__idx":1},"children":["Supported entities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upvest supports business accounts for the following types of entities:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Corporate entities of different legal types including private limited companies, partnerships, and trusts."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Sole traders and freelancers who trade in their capacity as a business."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Business accounts are only available for sole traders and freelancers when trading with business funds. If trading with private funds, they should be onboarded as regular end users."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each type of entity has a slightly different onboarding procedure that is described in the following sections."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you are a financial institution looking to leverage the Upvest infrastructure, please ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://upvest.co/contact"},"children":["reach out to us"]}," to learn more."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-begin","__idx":2},"children":["Before you begin"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before starting, we want to explain the following terms and phrases related to business accounts."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Key Terms"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Key Terms"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business Entity"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["A corporate entity or sole trader registered via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/businesses"]}," endpoint. Identified throughout the API by its ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_id"]},", which replaces the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]}," used in personal account flows."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Legal Entity Identifier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The unique identifier that identifies distinct legal entities participating in global financial transactions. This is required for MiFID II reporting."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["User Identifier"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The national identifier for individual users."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"our-solution-for-business-accounts","__idx":3},"children":["Our solution for business accounts"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/business_account_entities.fe280033acd79273ec9477580e4c476b8b4565fcded0d24281fdc55452ab65ca.dae188b9.png","framed":false,"withLightbox":true},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Upvest makes it easy for you to offer business accounts to your end users. We provide the following endpoints to help provide all required functionality to support configuring and managing business accounts:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Functionality"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Functionality"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Related Endpoint"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Related Endpoint"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Ability to create and onboard a business entity"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The  ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/businesses"]}," endpoint allows you to create a new business entity, and retrieve business entities."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Ability to change and existing business entity"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The  ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["/businesses/{business_id}/data_change_requests"]}," endpoint allows you to change business data like the email addresses"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Monitor the business creation  and business checks processes"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business events webhook"]}," allows you to monitor the business onboarding, and data change processes. The Business checks events webhook provides updates during the business check process."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"entity-mapping","__idx":4},"children":["Entity mapping"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For personal accounts, all functionality maps to the individual user. Business accounts map  the following areas directly to the business entity."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In all the below API entities, the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["business_id"]}," is used instead of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]},"."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Acceptance of Terms and conditions / Privacy Agreement"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Accounts and account groups"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Direct debits"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Withdrawals"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Cash balance"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["(FTR) Cash transactions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reference bank account"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Direct debit mandate"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Reports"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Orders"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Liquidations"]}]}]},"headings":[{"value":"Business accounts overview","id":"business-accounts-overview","depth":1},{"value":"Supported entities","id":"supported-entities","depth":2},{"value":"Before you begin","id":"before-you-begin","depth":2},{"value":"Our solution for business accounts","id":"our-solution-for-business-accounts","depth":2},{"value":"Entity mapping","id":"entity-mapping","depth":3}],"frontmatter":{"seo":{"title":"Business accounts overview"}},"lastModified":"2026-04-23T14:49:21.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/products/byol/guides/accounts/businesses_overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}