Rho

App · 20 actions

Read business accounts, transactions, cards, statements, invoices, and expenses.

Actions

ActionWhat it does
Get accountRetrieve account from Rho.
Get businessRetrieve business from Rho.
Get cardRetrieve card from Rho.
Get customerRetrieve customer from Rho.
Get expenseRetrieve expense from Rho.
Get invoiceRetrieve invoice from Rho.
Get reimbursementRetrieve reimbursement from Rho.
Get statementRetrieve statement from Rho.
Get transactionRetrieve transaction from Rho.
List accountsRetrieve a page of accounts from Rho.
List billsRetrieve a page of bills from Rho.
List cardsRetrieve a page of cards from Rho.
List credit programsRetrieve a page of credit programs from Rho.
List customersRetrieve a page of customers from Rho.
List expensesRetrieve a page of expenses from Rho.
List invoicesRetrieve a page of invoices from Rho.
List reimbursementsRetrieve a page of reimbursements from Rho.
List statementsRetrieve a page of statements from Rho.
List transactionsRetrieve a page of transactions from Rho.
List usersRetrieve a page of users from Rho.

Get account

Retrieve account from Rho.

Inputs

Accountaccount_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

Cardcard_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

Customercustomer_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

Expenseexpense_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

Invoiceinvoice_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

Reimbursementreimbursement_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

Statementstatement_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

Transactiontransaction_idtextRequired
Id.
Accountaccount_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 bysort_bytext
Sort field.One of: account_name (Account name), balance.
Orderordertext
Sort direction.One of: asc, desc.
Page sizepage_sizenumber
Number of accounts per page; max 100.From 1 to 100.
Page tokenpage_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

Searchsearchtext
Free-text search across payee name and email, creator name, invoice.
Statusstatuslist
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 afterdue_date_afterdate
Earliest bill due date to include, inclusive.
Due date beforedue_date_beforedate
Latest bill due date to include, inclusive.
Created aftercreated_afterdate and time
Earliest bill creation time to include, inclusive.
Created beforecreated_beforedate and time
Latest bill creation time to include, exclusive.
Sort bysort_bytext
Sort field. Defaults to created_at when omitted.One of: created_at (Created at), due_date (Due date), amount.
Orderordertext
Sort direction. Defaults to desc when omitted.One of: asc, desc.
Page sizepage_sizenumber
Number of bills per page. Defaults to 20.From 1 to 100.
Page tokenpage_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 IDmember_idlist
Filter by one or more cardholder user IDs.
Typetypelist
Filter by one or more card types.One or more of: physical, virtual.
Statusstatuslist
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 sizepage_sizenumber
Number of cards to return. Defaults to 20.From 1 to 100.
Page tokenpage_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

Searchsearchtext
Case-insensitive substring match on legal_name and email.
Include deletedinclude_deletedtrue/false
When true, include deleted customers in the results.
Sort bysort_bytext
Sort field. Defaults to created_at when omitted.One of: created_at (Created at).
Orderordertext
Sort direction. Defaults to desc when omitted.One of: asc, desc.
Page sizepage_sizenumber
Number of customers per page. Defaults to 20.From 1 to 100.
Page tokenpage_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 statusapproval_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 IDmember_idlist
Filter by the expense owner. Repeat the key to pass several user IDs.
Transaction date aftertransaction_date_afterdate
Earliest spend date, inclusive, at midnight UTC.
Transaction date beforetransaction_date_beforedate
Latest spend date, exclusive, at midnight UTC.
Created aftercreated_afterdate and time
Earliest creation timestamp, inclusive.
Created beforecreated_beforedate and time
Latest creation timestamp, exclusive.
Has attachmentshas_attachmentstrue/false
True selects expenses with attachments; false selects those without.
Sort bysort_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.
Orderordertext
Sort direction, also applied to tie-breakers.One of: asc, desc.
Page sizepage_sizenumber
Number of expenses per page. Defaults to 20.From 1 to 100.
Page tokenpage_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

Statusstatuslist
Filter by one or more invoice statuses.One or more of: paid, unpaid, cancelled, overdue, confirm_payment (Confirm payment), pending_payout (Pending payout).
Customercustomer_idlist
Filter by one or more customers. Multiple values return invoices.
Due date afterdue_date_afterdate
Earliest invoice due date to include, inclusive.
Due date beforedue_date_beforedate
Latest invoice due date to include, inclusive.
Date afterdate_afterdate
Earliest invoice issue date to include, inclusive.
Date beforedate_beforedate
Latest invoice issue date to include, inclusive.
Page sizepage_sizenumber
Number of invoices per page. Defaults to 20.From 1 to 100.
Page tokenpage_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 IDmember_idlist
Filter by the team member who submitted the reimbursement. Repeat the key to pass several.
Approval statusapproval_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 aftertransaction_date_afterdate
Earliest UTC calendar date of the spend, inclusive.
Transaction date beforetransaction_date_beforedate
Latest UTC calendar date of the spend, exclusive.
Created aftercreated_afterdate and time
Earliest creation timestamp, inclusive.
Created beforecreated_beforedate and time
Latest creation timestamp, exclusive.
Has attachmentshas_attachmentstrue/false
True selects requests with attachments; false selects those without.
Sort bysort_bytext
Field to order by.One of: created_at (Created at), transaction_date (Transaction date), amount.
Orderordertext
Sort direction. Defaults to desc when omitted.One of: asc, desc.
Page sizepage_sizenumber
Number of reimbursements to return. Defaults to 20.From 1 to 100.
Page tokenpage_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

Accountaccount_idlist
Return complete statements that include at least one requested.
Statement typestatement_typelist
Filter by statement type.One or more of: account, credit, treasury.
Period end afterperiod_end_afterdate
Earliest statement close date, inclusive.
Period end beforeperiod_end_beforedate
Latest statement close date, exclusive.
Period start afterperiod_start_afterdate
Earliest statement open date, inclusive.
Period start beforeperiod_start_beforedate
Latest statement open date, exclusive.
Sort bysort_bytext
Sort field.One of: period_end (Period end), period_start (Period start).
Orderordertext
Sort direction.One of: asc, desc.
Page sizepage_sizenumber
Number of statements per page; max 100.From 1 to 100.
Page tokenpage_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

Accountaccount_idlist
Filter by one or more accounts.
Account typeaccount_typelist
Filter by account type.One or more of: checking, credit, investment, savings, rewards.
Transaction typetransaction_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.
Statusstatuslist
Filter by transaction status.One or more of: pending, settled, failed, awaiting_approval (Awaiting approval).
Member IDmember_idlist
Filter by initiating user.
Cardcard_idlist
Filter by one or more cards.
Searchsearchtext
Free-text search across counterparty name, memo, note.
Initiated afterinitiated_afterdate and time
Earliest initiated_at (inclusive).
Initiated beforeinitiated_beforedate and time
Latest initiated_at (exclusive).
Posted afterposted_afterdate and time
Earliest posted_at (inclusive). Excludes transactions without a posted_at, including pending transactions.
Posted beforeposted_beforedate and time
Latest posted_at (exclusive). Excludes transactions without a posted_at, including pending transactions.
Min amountmin_amountnumber
Minimum amount in minor units; currency is implicit from the queried account.
Max amountmax_amountnumber
Maximum amount in minor units; currency is implicit from the queried account.
Sort bysort_bytext
Sort field.One of: initiated_at (Initiated at), posted_at (Posted at), amount.
Orderordertext
Sort direction.One of: asc, desc.
Page sizepage_sizenumber
Number of transactions per page; max 100.From 1 to 100.
Page tokenpage_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 statusmembership_statustext
Filter by membership status. When omitted, users removed from your business are excluded.One of: invited, active, removed.
Role namerole_nametext
Filter by role (group) name.
Emailemailtext
Email.
Sort bysort_bytext
Field to sort by.One of: created_at (Created at).
Orderordertext
Sort direction.One of: asc, desc.
Page sizepage_sizenumber
Number of users per page; max 100.From 1 to 100.
Page tokenpage_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": []
  }
}

On this page