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 Versioning and compatibility.
This endpoint returns the profile of the business connected to your API Access Token. It requires the businesses:read scope.
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.
curl "https://rhoapi.rho.co/api/v1/business" \
-H "Authorization: Bearer $RHO_API_TOKEN"{
"id": "9e1a3d62-3f39-46f2-a8cb-1d4a1a4d5b60",
"legal_name": "Acme Technologies Inc",
"dba": "Acme",
"tin": "*****6789"
}| Field | Description |
|---|---|
id | Stable identifier for the connected business. |
legal_name | Registered legal entity name. Always present. |
dba | Doing business as / trade name. |
tin | EIN, masked to the last 4 digits. |
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 Accounts or Transactions.
Full endpoint catalogue - paths, parameters, response shapes, and required scopes - lives in the API Reference.