# Rho

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

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/rho

## Actions

### Get account

Retrieve account from Rho.

**Inputs**

- Account (`account_id`, text, required): Account id.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "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**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "dba": "example",
    "id": "example",
    "legal_name": "example",
    "tin": "example"
  }
}
```

### Get card

Retrieve card from Rho.

**Inputs**

- Card (`card_id`, text, required): Stable global card identifier.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "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_id`, text, required): Stable global customer identifier.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "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_id`, text, required): Stable expense identifier returned in the `id` field.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "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_id`, text, required): Stable global invoice identifier.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "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_id`, text, required): Reimbursement id.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "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_id`, text, required): Id.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "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_id`, text, required): Id.
- Account (`account_id`, text): Account ID for the transaction.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "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_by`, text): Sort field. One of: `account_name` (Account name), `balance`.
- Order (`order`, text): Sort direction. One of: `asc`, `desc`.
- Page size (`page_size`, number): Number of accounts per page; max 100. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor returned as next_page_token in the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "accounts": [],
    "page": {
      "next_page_token": "example"
    }
  }
}
```

### List bills

Retrieve a page of bills from Rho.

**Inputs**

- Search (`search`, text): Free-text search across payee name and email, creator name, invoice.
- Status (`status`, list): 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_after`, date): Earliest bill due date to include, inclusive.
- Due date before (`due_date_before`, date): Latest bill due date to include, inclusive.
- Created after (`created_after`, date and time): Earliest bill creation time to include, inclusive.
- Created before (`created_before`, date and time): Latest bill creation time to include, exclusive.
- Sort by (`sort_by`, text): Sort field. Defaults to created_at when omitted. One of: `created_at` (Created at), `due_date` (Due date), `amount`.
- Order (`order`, text): Sort direction. Defaults to desc when omitted. One of: `asc`, `desc`.
- Page size (`page_size`, number): Number of bills per page. Defaults to 20. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor from page.next_page_token in the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "bills": [],
    "page": {
      "next_page_token": "example"
    }
  }
}
```

### List cards

Retrieve a page of cards from Rho.

**Inputs**

- Member ID (`member_id`, list): Filter by one or more cardholder user IDs.
- Type (`type`, list): Filter by one or more card types. One or more of: `physical`, `virtual`.
- Status (`status`, list): 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_size`, number): Number of cards to return. Defaults to 20. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor from page.next_page_token in the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "cards": [],
    "page": {
      "next_page_token": "example"
    }
  }
}
```

### List credit programs

Retrieve a page of credit programs from Rho.

**Inputs**: None.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "credit_programs": []
  }
}
```

### List customers

Retrieve a page of customers from Rho.

**Inputs**

- Search (`search`, text): Case-insensitive substring match on legal_name and email.
- Include deleted (`include_deleted`, true/false): When true, include deleted customers in the results.
- Sort by (`sort_by`, text): Sort field. Defaults to created_at when omitted. One of: `created_at` (Created at).
- Order (`order`, text): Sort direction. Defaults to desc when omitted. One of: `asc`, `desc`.
- Page size (`page_size`, number): Number of customers per page. Defaults to 20. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor from page.next_page_token in the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "customers": [],
    "page": {
      "next_page_token": "example"
    }
  }
}
```

### List expenses

Retrieve a page of expenses from Rho.

**Inputs**

- Approval status (`approval_status`, list): 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_id`, list): Filter by the expense owner. Repeat the key to pass several user IDs.
- Transaction date after (`transaction_date_after`, date): Earliest spend date, inclusive, at midnight UTC.
- Transaction date before (`transaction_date_before`, date): Latest spend date, exclusive, at midnight UTC.
- Created after (`created_after`, date and time): Earliest creation timestamp, inclusive.
- Created before (`created_before`, date and time): Latest creation timestamp, exclusive.
- Has attachments (`has_attachments`, true/false): True selects expenses with attachments; false selects those without.
- Sort by (`sort_by`, text): 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 (`order`, text): Sort direction, also applied to tie-breakers. One of: `asc`, `desc`.
- Page size (`page_size`, number): Number of expenses per page. Defaults to 20. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor from the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "expenses": [],
    "page": {
      "next_page_token": "example"
    }
  }
}
```

### List invoices

Retrieve a page of invoices from Rho.

**Inputs**

- Status (`status`, list): 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_id`, list): Filter by one or more customers. Multiple values return invoices.
- Due date after (`due_date_after`, date): Earliest invoice due date to include, inclusive.
- Due date before (`due_date_before`, date): Latest invoice due date to include, inclusive.
- Date after (`date_after`, date): Earliest invoice issue date to include, inclusive.
- Date before (`date_before`, date): Latest invoice issue date to include, inclusive.
- Page size (`page_size`, number): Number of invoices per page. Defaults to 20. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor from page.next_page_token in the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "invoices": [],
    "page": {
      "next_page_token": "example"
    }
  }
}
```

### List reimbursements

Retrieve a page of reimbursements from Rho.

**Inputs**

- Member ID (`member_id`, list): Filter by the team member who submitted the reimbursement. Repeat the key to pass several.
- Approval status (`approval_status`, list): 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_after`, date): Earliest UTC calendar date of the spend, inclusive.
- Transaction date before (`transaction_date_before`, date): Latest UTC calendar date of the spend, exclusive.
- Created after (`created_after`, date and time): Earliest creation timestamp, inclusive.
- Created before (`created_before`, date and time): Latest creation timestamp, exclusive.
- Has attachments (`has_attachments`, true/false): True selects requests with attachments; false selects those without.
- Sort by (`sort_by`, text): Field to order by. One of: `created_at` (Created at), `transaction_date` (Transaction date), `amount`.
- Order (`order`, text): Sort direction. Defaults to desc when omitted. One of: `asc`, `desc`.
- Page size (`page_size`, number): Number of reimbursements to return. Defaults to 20. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor from the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "page": {
      "next_page_token": "example"
    },
    "reimbursements": []
  }
}
```

### List statements

Retrieve a page of statements from Rho.

**Inputs**

- Account (`account_id`, list): Return complete statements that include at least one requested.
- Statement type (`statement_type`, list): Filter by statement type. One or more of: `account`, `credit`, `treasury`.
- Period end after (`period_end_after`, date): Earliest statement close date, inclusive.
- Period end before (`period_end_before`, date): Latest statement close date, exclusive.
- Period start after (`period_start_after`, date): Earliest statement open date, inclusive.
- Period start before (`period_start_before`, date): Latest statement open date, exclusive.
- Sort by (`sort_by`, text): Sort field. One of: `period_end` (Period end), `period_start` (Period start).
- Order (`order`, text): Sort direction. One of: `asc`, `desc`.
- Page size (`page_size`, number): Number of statements per page; max 100. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor returned as next_page_token in the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "page": {
      "next_page_token": "example"
    },
    "statements": []
  }
}
```

### List transactions

Retrieve a page of transactions from Rho.

**Inputs**

- Account (`account_id`, list): Filter by one or more accounts.
- Account type (`account_type`, list): Filter by account type. One or more of: `checking`, `credit`, `investment`, `savings`, `rewards`.
- Transaction type (`transaction_type`, list): 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 (`status`, list): Filter by transaction status. One or more of: `pending`, `settled`, `failed`, `awaiting_approval` (Awaiting approval).
- Member ID (`member_id`, list): Filter by initiating user.
- Card (`card_id`, list): Filter by one or more cards.
- Search (`search`, text): Free-text search across counterparty name, memo, note.
- Initiated after (`initiated_after`, date and time): Earliest initiated_at (inclusive).
- Initiated before (`initiated_before`, date and time): Latest initiated_at (exclusive).
- Posted after (`posted_after`, date and time): Earliest posted_at (inclusive). Excludes transactions without a posted_at, including pending transactions.
- Posted before (`posted_before`, date and time): Latest posted_at (exclusive). Excludes transactions without a posted_at, including pending transactions.
- Min amount (`min_amount`, number): Minimum amount in minor units; currency is implicit from the queried account.
- Max amount (`max_amount`, number): Maximum amount in minor units; currency is implicit from the queried account.
- Sort by (`sort_by`, text): Sort field. One of: `initiated_at` (Initiated at), `posted_at` (Posted at), `amount`.
- Order (`order`, text): Sort direction. One of: `asc`, `desc`.
- Page size (`page_size`, number): Number of transactions per page; max 100. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor returned as next_page_token in the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "page": {
      "next_page_token": "example"
    },
    "transactions": []
  }
}
```

### List users

Retrieve a page of users from Rho.

**Inputs**

- Membership status (`membership_status`, text): Filter by membership status. When omitted, users removed from your business are excluded. One of: `invited`, `active`, `removed`.
- Role name (`role_name`, text): Filter by role (group) name.
- Email (`email`, text): Email.
- Sort by (`sort_by`, text): Field to sort by. One of: `created_at` (Created at).
- Order (`order`, text): Sort direction. One of: `asc`, `desc`.
- Page size (`page_size`, number): Number of users per page; max 100. From 1 to 100.
- Page token (`page_token`, text): Opaque cursor returned as next_page_token in the previous response.

**Outputs**

- `data` (object): The result returned by Rho.

**Example output**

```json
{
  "data": {
    "page": {
      "next_page_token": "example"
    },
    "users": []
  }
}
```
