{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Accounts","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"accounts","__idx":0},"children":["Accounts"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Accounts API exposes the bank accounts your business holds on Rho - checking, savings, credit, treasury investment vehicles, and rewards accounts. Use it to read balances, classify activity by account type, and stitch Rho into the rest of your financial stack."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Stable contract"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Accounts API is part of the stable ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["v1"]}," contract: additive-only, with breaking changes reserved for a new API version. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/versioning"},"children":["Versioning and compatibility"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"account-types","__idx":1},"children":["Account types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every account on Rho has an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_type"]}," field that determines what it can hold and how it behaves."]},{"$$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":"Type"},"children":["Type"]},{"$$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":["checking"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Operating cash accounts used for everyday inflows and outflows."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["savings"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Higher-yield depository accounts segregated from operating cash."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["credit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Revolving credit lines backing corporate cards."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["investment"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Treasury sleeves invested in money-market funds or short-duration securities."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rewards"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Cash-back balances earned on card spend."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Account ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_type"]}," is immutable for the lifetime of an account."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-workflows","__idx":2},"children":["Common workflows"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"pulling-a-balance-snapshot","__idx":3},"children":["Pulling a balance snapshot"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A GET against ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/v1/accounts"]}," returns every account in scope for your API Access Token, each with a single ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["balance"]}," object. Balances are expressed in minor units (for example, cents for USD) alongside an ISO 4217 currency code, so treat amounts as integers rather than decimals. Alongside the balance, each account carries its type, a display name, and the masked account and routing numbers."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The list is paginated - use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sort_by"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["order"]}," to control ordering, and follow the cursor as described in ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/pagination"},"children":["Pagination"]}," to read through businesses with many accounts. Pair with ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/v1/transactions"},"children":["Transactions"]}," to reconcile activity against the balance."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"selecting-accounts-by-type","__idx":4},"children":["Selecting accounts by type"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Many integrations only care about a subset - for example, payouts only care about ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checking"]}," accounts. The list endpoint has no server-side type filter, so request a page of accounts and filter the returned ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["accounts"]}," array client-side by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_type"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl 'https://rhoapi.rho.co/api/v1/accounts?page_size=100' \\\n  -H \"Authorization: Bearer $RHO_API_TOKEN\"\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"joining-accounts-to-transactions","__idx":5},"children":["Joining accounts to transactions"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Every ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transaction"]}," already carries ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["account_type"]},", and the account's display name, so most reconciliation needs no extra calls. When you need live balance or masked account details, fetch the account once via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["/api/v1/accounts/{account_id}"]}," and cache the result for the duration of the job."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference","__idx":6},"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/accounts"},"children":["API Reference"]},"."]}]},"headings":[{"value":"Accounts","id":"accounts","depth":1},{"value":"Account types","id":"account-types","depth":2},{"value":"Common workflows","id":"common-workflows","depth":2},{"value":"Pulling a balance snapshot","id":"pulling-a-balance-snapshot","depth":3},{"value":"Selecting accounts by type","id":"selecting-accounts-by-type","depth":3},{"value":"Joining accounts to transactions","id":"joining-accounts-to-transactions","depth":3},{"value":"Reference","id":"reference","depth":2}],"frontmatter":{"seo":{"title":"Accounts"}},"lastModified":"2026-07-29T13:58:14.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/v1/accounts","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}