Rho
App · 20 actions
Read business accounts, transactions, cards, statements, invoices, and expenses.
Actions
| Action | What it does |
|---|---|
| Get account | Retrieve account from Rho. |
| Get business | Retrieve business from Rho. |
| Get card | Retrieve card from Rho. |
| Get customer | Retrieve customer from Rho. |
| Get expense | Retrieve expense from Rho. |
| Get invoice | Retrieve invoice from Rho. |
| Get reimbursement | Retrieve reimbursement from Rho. |
| Get statement | Retrieve statement from Rho. |
| Get transaction | Retrieve transaction from Rho. |
| List accounts | Retrieve a page of accounts from Rho. |
| List bills | Retrieve a page of bills from Rho. |
| List cards | Retrieve a page of cards from Rho. |
| List credit programs | Retrieve a page of credit programs from Rho. |
| List customers | Retrieve a page of customers from Rho. |
| List expenses | Retrieve a page of expenses from Rho. |
| List invoices | Retrieve a page of invoices from Rho. |
| List reimbursements | Retrieve a page of reimbursements from Rho. |
| List statements | Retrieve a page of statements from Rho. |
| List transactions | Retrieve a page of transactions from Rho. |
| List users | Retrieve a page of users from Rho. |
Get account
Retrieve account from Rho.
Inputs
- Account
account_idtextRequired - Account id.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"account_name": "example",
"account_number_last_4": "example",
"account_type": "checking",
"balance": {
"amount": 1,
"currency": "example"
},
"id": "example",
"routing_number_last_4": "example"
}
}Get business
Retrieve business from Rho.
Inputs
None.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"dba": "example",
"id": "example",
"legal_name": "example",
"tin": "example"
}
}Get card
Retrieve card from Rho.
Inputs
- Card
card_idtextRequired - Stable global card identifier.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"allowed_categories": [],
"allowed_merchants": [],
"billing_address": {
"city": "example",
"country_code": "example",
"postal_code": "example",
"second_line": "example",
"street": "example",
"subdivision": "example"
},
"blocked_categories": [],
"blocked_merchants": [],
"cardholder": {
"first_name": "example",
"last_name": "example",
"user_id": "example"
},
"current_spend": {
"amount": 1,
"currency": "example"
},
"id": "example",
"last_4": "example",
"name": "example",
"pending_spend": {
"amount": 1,
"currency": "example"
},
"shipment": {
"delivered_at": "example",
"estimated_delivery_at": "example",
"status": "created",
"tracking_number": "example"
},
"shipping_address": {
"city": "example",
"country_code": "example",
"postal_code": "example",
"second_line": "example",
"street": "example",
"subdivision": "example"
},
"spend_period_end": "example",
"spend_period_start": "example",
"spending_limit": {
"amount": 1,
"currency": "example"
},
"spending_limit_type": "fixed",
"status": "printing",
"type": "physical",
"usage_ends_at": "example",
"usage_starts_at": "example"
}
}Get customer
Retrieve customer from Rho.
Inputs
- Customer
customer_idtextRequired - Stable global customer identifier.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"address": {
"address1": "example",
"address2": "example",
"city": "example",
"country": "example",
"state": "example",
"zip_code": "example"
},
"cc_emails": [],
"created_at": "example",
"deleted_at": "example",
"email": "example",
"id": "example",
"last_invoice_id": "example",
"legal_name": "example",
"note": "example",
"total_revenue": {
"amount": 1,
"currency": "example"
},
"updated_at": "example"
}
}Get expense
Retrieve expense from Rho.
Inputs
- Expense
expense_idtextRequired - Stable expense identifier returned in the `id` field.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"amount": {
"amount": 1,
"currency": "example"
},
"approval_status": "not_ready",
"attachments": [],
"attendee_user_ids": [],
"client": "example",
"created_at": "example",
"fields": [],
"id": "example",
"merchant_category": "example",
"merchant_name": "example",
"note": "example",
"policy": {
"missing_requirements": [],
"out_of_policy_status": "automatic_ok",
"requirements_status": "requirements_met"
},
"settlement_date": "example",
"source_details": {
"card_transaction": {
"card_id": "example",
"money_movement_id": "example",
"transaction_type": "capture"
}
},
"status_updated_at": "example",
"tags": [],
"transaction_date": "example",
"updated_at": "example",
"user_id": "example"
}
}Get invoice
Retrieve invoice from Rho.
Inputs
- Invoice
invoice_idtextRequired - Stable global invoice identifier.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"accounting_sync_status": "not_pushed",
"accounting_synced_at": "example",
"activities": [],
"created_at": "example",
"customer": {
"id": "example"
},
"date": "example",
"discount_rate": 1.0,
"due_date": "example",
"file_id": "example",
"id": "example",
"invoice_number": "example",
"line_items": [],
"note": "example",
"payments": [],
"status": "paid",
"tax_rate": 1.0,
"total": {
"amount": 1,
"currency": "example"
},
"updated_at": "example"
}
}Get reimbursement
Retrieve reimbursement from Rho.
Inputs
- Reimbursement
reimbursement_idtextRequired - Reimbursement id.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"amount": {
"amount": 1,
"currency": "example"
},
"approval_status": "not_ready",
"attachments": [],
"attendee_user_ids": [],
"client": "example",
"created_at": "example",
"fields": [],
"id": "example",
"merchant_category": "example",
"merchant_name": "example",
"note": "example",
"original_amount": {
"amount": 1,
"currency": "example"
},
"payment_status": "awaiting",
"transaction_date": "example",
"type": "out_of_pocket",
"user_id": "example"
}
}Get statement
Retrieve statement from Rho.
Inputs
- Statement
statement_idtextRequired - Id.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"accounts": [],
"available_at": "example",
"id": "example",
"pdf_url": "example",
"period_end": "example",
"period_start": "example",
"statement_type": "account"
}
}Get transaction
Retrieve transaction from Rho.
Inputs
- Transaction
transaction_idtextRequired - Id.
- Account
account_idtext - Account ID for the transaction.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"account_id": "example",
"account_name": "example",
"account_type": "checking",
"amount": {
"amount": 1,
"currency": "example"
},
"attachments": [],
"card_id": "example",
"card_name": "example",
"counterparty_logo_url": "example",
"counterparty_name": "example",
"id": "example",
"initiated_at": "example",
"lines": [],
"memo": "example",
"money_movement_id": "example",
"note": "example",
"posted_at": "example",
"status": "pending",
"tracking_number": "example",
"transaction_type": "card_credit",
"user_full_name": "example",
"user_id": "example"
}
}List accounts
Retrieve a page of accounts from Rho.
Inputs
- Sort by
sort_bytext - Sort field.One of:
account_name(Account name),balance. - Order
ordertext - Sort direction.One of:
asc,desc. - Page size
page_sizenumber - Number of accounts per page; max 100.From 1 to 100.
- Page token
page_tokentext - Opaque cursor returned as next_page_token in the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"accounts": [],
"page": {
"next_page_token": "example"
}
}
}List bills
Retrieve a page of bills from Rho.
Inputs
- Search
searchtext - Free-text search across payee name and email, creator name, invoice.
- Status
statuslist - Filter by one or more bill lifecycle statuses. Repeat the parameter.One or more of:
draft,missing_payment_details(Missing payment details),awaiting_approval(Awaiting approval),ready_for_payment(Ready for payment),scheduled,pending_payment(Pending payment),paid,failed_payment(Failed payment),archived,other. - Due date after
due_date_afterdate - Earliest bill due date to include, inclusive.
- Due date before
due_date_beforedate - Latest bill due date to include, inclusive.
- Created after
created_afterdate and time - Earliest bill creation time to include, inclusive.
- Created before
created_beforedate and time - Latest bill creation time to include, exclusive.
- Sort by
sort_bytext - Sort field. Defaults to created_at when omitted.One of:
created_at(Created at),due_date(Due date),amount. - Order
ordertext - Sort direction. Defaults to desc when omitted.One of:
asc,desc. - Page size
page_sizenumber - Number of bills per page. Defaults to 20.From 1 to 100.
- Page token
page_tokentext - Opaque cursor from page.next_page_token in the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"bills": [],
"page": {
"next_page_token": "example"
}
}
}List cards
Retrieve a page of cards from Rho.
Inputs
- Member ID
member_idlist - Filter by one or more cardholder user IDs.
- Type
typelist - Filter by one or more card types.One or more of:
physical,virtual. - Status
statuslist - Filter by one or more card lifecycle statuses.One or more of:
printing,shipped,out_for_delivery(Out for delivery),activate_card(Activate card),delivery_canceled(Delivery canceled),active,expiring,locked,canceled,suspended,expired. - Page size
page_sizenumber - Number of cards to return. Defaults to 20.From 1 to 100.
- Page token
page_tokentext - Opaque cursor from page.next_page_token in the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"cards": [],
"page": {
"next_page_token": "example"
}
}
}List credit programs
Retrieve a page of credit programs from Rho.
Inputs
None.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"credit_programs": []
}
}List customers
Retrieve a page of customers from Rho.
Inputs
- Search
searchtext - Case-insensitive substring match on legal_name and email.
- Include deleted
include_deletedtrue/false - When true, include deleted customers in the results.
- Sort by
sort_bytext - Sort field. Defaults to created_at when omitted.One of:
created_at(Created at). - Order
ordertext - Sort direction. Defaults to desc when omitted.One of:
asc,desc. - Page size
page_sizenumber - Number of customers per page. Defaults to 20.From 1 to 100.
- Page token
page_tokentext - Opaque cursor from page.next_page_token in the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"customers": [],
"page": {
"next_page_token": "example"
}
}
}List expenses
Retrieve a page of expenses from Rho.
Inputs
- Approval status
approval_statuslist - Filter by approval state. Repeat the key to pass several states.One or more of:
not_ready(Not ready),automatically_approved(Automatically approved),needs_approval(Needs approval),approved,rejected,archived. - Member ID
member_idlist - Filter by the expense owner. Repeat the key to pass several user IDs.
- Transaction date after
transaction_date_afterdate - Earliest spend date, inclusive, at midnight UTC.
- Transaction date before
transaction_date_beforedate - Latest spend date, exclusive, at midnight UTC.
- Created after
created_afterdate and time - Earliest creation timestamp, inclusive.
- Created before
created_beforedate and time - Latest creation timestamp, exclusive.
- Has attachments
has_attachmentstrue/false - True selects expenses with attachments; false selects those without.
- Sort by
sort_bytext - Field to sort on, followed by creation timestamp and ID as tie-breakers.One of:
created_at(Created at),transaction_date(Transaction date),amount. - Order
ordertext - Sort direction, also applied to tie-breakers.One of:
asc,desc. - Page size
page_sizenumber - Number of expenses per page. Defaults to 20.From 1 to 100.
- Page token
page_tokentext - Opaque cursor from the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"expenses": [],
"page": {
"next_page_token": "example"
}
}
}List invoices
Retrieve a page of invoices from Rho.
Inputs
- Status
statuslist - Filter by one or more invoice statuses.One or more of:
paid,unpaid,cancelled,overdue,confirm_payment(Confirm payment),pending_payout(Pending payout). - Customer
customer_idlist - Filter by one or more customers. Multiple values return invoices.
- Due date after
due_date_afterdate - Earliest invoice due date to include, inclusive.
- Due date before
due_date_beforedate - Latest invoice due date to include, inclusive.
- Date after
date_afterdate - Earliest invoice issue date to include, inclusive.
- Date before
date_beforedate - Latest invoice issue date to include, inclusive.
- Page size
page_sizenumber - Number of invoices per page. Defaults to 20.From 1 to 100.
- Page token
page_tokentext - Opaque cursor from page.next_page_token in the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"invoices": [],
"page": {
"next_page_token": "example"
}
}
}List reimbursements
Retrieve a page of reimbursements from Rho.
Inputs
- Member ID
member_idlist - Filter by the team member who submitted the reimbursement. Repeat the key to pass several.
- Approval status
approval_statuslist - Filter by where the request sits in the approval flow. Repeat the key to pass several.One or more of:
not_ready(Not ready),needs_approval(Needs approval),approved,automatically_approved(Automatically approved),rejected,archived. - Transaction date after
transaction_date_afterdate - Earliest UTC calendar date of the spend, inclusive.
- Transaction date before
transaction_date_beforedate - Latest UTC calendar date of the spend, exclusive.
- Created after
created_afterdate and time - Earliest creation timestamp, inclusive.
- Created before
created_beforedate and time - Latest creation timestamp, exclusive.
- Has attachments
has_attachmentstrue/false - True selects requests with attachments; false selects those without.
- Sort by
sort_bytext - Field to order by.One of:
created_at(Created at),transaction_date(Transaction date),amount. - Order
ordertext - Sort direction. Defaults to desc when omitted.One of:
asc,desc. - Page size
page_sizenumber - Number of reimbursements to return. Defaults to 20.From 1 to 100.
- Page token
page_tokentext - Opaque cursor from the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"page": {
"next_page_token": "example"
},
"reimbursements": []
}
}List statements
Retrieve a page of statements from Rho.
Inputs
- Account
account_idlist - Return complete statements that include at least one requested.
- Statement type
statement_typelist - Filter by statement type.One or more of:
account,credit,treasury. - Period end after
period_end_afterdate - Earliest statement close date, inclusive.
- Period end before
period_end_beforedate - Latest statement close date, exclusive.
- Period start after
period_start_afterdate - Earliest statement open date, inclusive.
- Period start before
period_start_beforedate - Latest statement open date, exclusive.
- Sort by
sort_bytext - Sort field.One of:
period_end(Period end),period_start(Period start). - Order
ordertext - Sort direction.One of:
asc,desc. - Page size
page_sizenumber - Number of statements per page; max 100.From 1 to 100.
- Page token
page_tokentext - Opaque cursor returned as next_page_token in the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"page": {
"next_page_token": "example"
},
"statements": []
}
}List transactions
Retrieve a page of transactions from Rho.
Inputs
- Account
account_idlist - Filter by one or more accounts.
- Account type
account_typelist - Filter by account type.One or more of:
checking,credit,investment,savings,rewards. - Transaction type
transaction_typelist - Filter by transaction type.One or more of:
card_credit(Card credit),card_debit(Card debit),card_refund(Card refund),credit_repayment(Credit repayment),credit_repayment_refund(Credit repayment refund),credit_cashback(Credit cashback),ach_credit(Ach credit),ach_debit(Ach debit),ach_return(Ach return),wire_in(Wire in), and 23 more. - Status
statuslist - Filter by transaction status.One or more of:
pending,settled,failed,awaiting_approval(Awaiting approval). - Member ID
member_idlist - Filter by initiating user.
- Card
card_idlist - Filter by one or more cards.
- Search
searchtext - Free-text search across counterparty name, memo, note.
- Initiated after
initiated_afterdate and time - Earliest initiated_at (inclusive).
- Initiated before
initiated_beforedate and time - Latest initiated_at (exclusive).
- Posted after
posted_afterdate and time - Earliest posted_at (inclusive). Excludes transactions without a posted_at, including pending transactions.
- Posted before
posted_beforedate and time - Latest posted_at (exclusive). Excludes transactions without a posted_at, including pending transactions.
- Min amount
min_amountnumber - Minimum amount in minor units; currency is implicit from the queried account.
- Max amount
max_amountnumber - Maximum amount in minor units; currency is implicit from the queried account.
- Sort by
sort_bytext - Sort field.One of:
initiated_at(Initiated at),posted_at(Posted at),amount. - Order
ordertext - Sort direction.One of:
asc,desc. - Page size
page_sizenumber - Number of transactions per page; max 100.From 1 to 100.
- Page token
page_tokentext - Opaque cursor returned as next_page_token in the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"page": {
"next_page_token": "example"
},
"transactions": []
}
}List users
Retrieve a page of users from Rho.
Inputs
- Membership status
membership_statustext - Filter by membership status. When omitted, users removed from your business are excluded.One of:
invited,active,removed. - Role name
role_nametext - Filter by role (group) name.
- Email
emailtext - Email.
- Sort by
sort_bytext - Field to sort by.One of:
created_at(Created at). - Order
ordertext - Sort direction.One of:
asc,desc. - Page size
page_sizenumber - Number of users per page; max 100.From 1 to 100.
- Page token
page_tokentext - Opaque cursor returned as next_page_token in the previous response.
Outputs
dataobject- The result returned by Rho.
Example output
{
"data": {
"page": {
"next_page_token": "example"
},
"users": []
}
}