# Rho API

Programmatic access to Rho's banking, spend, and treasury primitives -
accounts, cards, payments, and the transaction ledger.

All endpoints take a bearer token in the `Authorization` header. See
the [Authentication](/docs/v1/auth) and [Pagination](/docs/v1/pagination)
guides to get started. Errors follow
[RFC 9457 problem details](https://www.rfc-editor.org/rfc/rfc9457.html);
timestamps are ISO 8601 UTC; monetary amounts are integers in the
smallest currency unit.

v1 is stable and additive-only: changes are backward compatible and
breaking changes require a new API version. See the
[versioning policy](/docs/v1/versioning).


Version: 1.0.0

## Servers

Production
```
https://rhoapi.rho.co/api/v1
```

Sandbox
```
https://rhoapi-sandbox.rho.co/api/v1
```

## Security

### AccessToken

Bearer token authorization. API Access Tokens are issued in the Rho
settings with a user-selected subset of scopes; send as
`Authorization: Bearer <token>`.

Type: oauth2


## Accounts

Accounts represent the balances a business holds with Rho - checking,
savings, credit, investment, and rewards. Endpoints in this group let
you list every account the authenticated business has access to and
fetch a single account's current balance, identifiers, and metadata.
All amounts are denominated in the account's currency and reflect the
latest posted activity.


### List accounts

 - [GET /accounts](https://docs.rho.co/api/v1/openapi/accounts/listaccounts.md): Returns a paginated list of accounts for the authenticated business

### Get account

 - [GET /accounts/{account_id}](https://docs.rho.co/api/v1/openapi/accounts/getaccount.md): Returns a single account by its identifier

## Transactions

Transactions cover the full money-movement lifecycle on a Rho
account - card spend, ACH credits and debits, wires, transfers,
refunds, and fees. Endpoints in this group return paginated activity
with rich filtering (by account, type, status, date range, search
text) and let you drill into a single transaction's posting state,
counterparty, and audit trail.


### List transactions

 - [GET /transactions](https://docs.rho.co/api/v1/openapi/transactions/listtransactions.md): Returns a paginated list of transactions

### Get transaction

 - [GET /transactions/{id}](https://docs.rho.co/api/v1/openapi/transactions/gettransaction.md): Returns a single transaction by its global identifier

### Get transaction file

 - [GET /transactions/{transaction_id}/files/{file_id}](https://docs.rho.co/api/v1/openapi/transactions/gettransactionfile.md): Returns file metadata and a fresh, short-lived signed download URL.

## Statements

Statements are the finalized, period-end documents Rho issues for a
business - spanning checking, savings, treasury, and credit. Each record
carries the period boundaries, a short-lived link to the PDF, and a
per-account breakdown of opening and closing balances and period totals;
account and treasury statements may cover multiple accounts, while credit
statements carry a single entry. Reconciliation partners can ingest every
account in one aggregated, paginated surface. Statement period boundaries
are calendar dates (not timestamps): statements are day-grained,
point-in-time documents with no sub-day precision.


### List statements

 - [GET /statements](https://docs.rho.co/api/v1/openapi/statements/liststatements.md): Returns a paginated list of finalized statements for the
authenticated business, newest close date first. Spans all statement
types and all accounts in one aggregated surface; narrow with the
account_id and statement_type filters.

### Get statement

 - [GET /statements/{id}](https://docs.rho.co/api/v1/openapi/statements/getstatement.md): Returns a single statement by its global identifier