{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Business"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"business","__idx":0},"children":["Business"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Beta"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Business API is in Beta. Additive changes are normal, and breaking changes"," ","may be made with notice while the resource incorporates customer feedback. See"," ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/versioning"},"children":["Versioning and compatibility"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This endpoint returns the profile of the business connected to your API Access"," ","Token. It requires the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["businesses:read"]}," scope."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"your-business-profile","__idx":1},"children":["Your business profile"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/business"]}," returns the legal identity of the business the calling"," ","token is connected to. The business is resolved from the token, so you don't"," ","pass an identifier - a useful first call after minting a token, to confirm"," ","which business you're working with before touching accounts or transactions."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl \"https://rhoapi.rho.co/api/v1/business\" \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"id\": \"9e1a3d62-3f39-46f2-a8cb-1d4a1a4d5b60\",\n  \"legal_name\": \"Acme Technologies Inc\",\n  \"dba\": \"Acme\",\n  \"tin\": \"*****6789\"\n}\n","lang":"json"},"children":[]},{"$$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":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Stable identifier for the connected business."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["legal_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Registered legal entity name. Always present."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dba"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Doing business as / trade name."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tin"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EIN, masked to the last 4 digits."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A value Rho does not hold for an optional field is omitted from the response."," ","For the business's accounts and activity, follow up with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/accounts"},"children":["Accounts"]}," ","or ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/transactions"},"children":["Transactions"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference","__idx":2},"children":["Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full endpoint catalogue - paths, parameters, response shapes, and required scopes - lives in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/api/v1/openapi/business"},"children":["API Reference"]},"."]}]},"headings":[{"value":"Business","id":"business","depth":1},{"value":"Your business profile","id":"your-business-profile","depth":2},{"value":"Reference","id":"reference","depth":2}],"frontmatter":{"seo":{"title":"Business"}},"lastModified":"2026-10-23T10:00:23.880Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v1/business","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}