get_expenses
Retrieve and filter company expenses from Brex with status, type, and amount criteria. View merchant details and budget information for expense analysis.
Instructions
Retrieve a paginated list of expenses with optional filters for status, type, and amount. Supports expansion of related objects like merchant and budget details. Returns expenses with automatic money annotation (cents, dollars, formatted).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expense_type | No | Type of expenses to retrieve (CARD, CASH, BILLPAY, REIMBURSEMENT, CLAWBACK, UNSET) | |
| status | No | Filter by expense approval status (DRAFT, SUBMITTED, APPROVED, OUT_OF_POLICY, VOID, CANCELED, SPLIT, SETTLED) | |
| payment_status | No | Filter by payment processing status (NOT_STARTED, PROCESSING, CANCELED, DECLINED, CLEARED, REFUNDING, REFUNDED, CASH_ADVANCE, CREDITED, AWAITING_PAYMENT, SCHEDULED) | |
| limit | No | Maximum number of expenses to return (default: 50, max: 100) | |
| expand | No | Related objects to include in response. Default: [] for minimal size |