get_expenses
Retrieve and filter expense data from Brex financial platform by status, type, or payment status to monitor and analyze company spending.
Instructions
LIST (single page): Expenses with optional filters. Returns complete expense objects. Example: {"limit":5,"status":"APPROVED","expand":["merchant"]}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| expand | No | Fields to expand (e.g., merchant, receipts) | |
| expense_type | No | Type of expenses to retrieve | |
| limit | No | Maximum number of expenses to return (default: 50) | |
| payment_status | No | Payment status filter for expenses | |
| status | No | Status filter for expenses |
Input Schema (JSON Schema)
{
"properties": {
"expand": {
"description": "Fields to expand (e.g., merchant, receipts)",
"items": {
"type": "string"
},
"type": "array"
},
"expense_type": {
"description": "Type of expenses to retrieve",
"enum": [
"CARD",
"BILLPAY",
"REIMBURSEMENT",
"CLAWBACK",
"UNSET"
],
"type": "string"
},
"limit": {
"description": "Maximum number of expenses to return (default: 50)",
"type": "number"
},
"payment_status": {
"description": "Payment status filter for expenses",
"enum": [
"NOT_STARTED",
"PROCESSING",
"CANCELED",
"DECLINED",
"CLEARED",
"REFUNDING",
"REFUNDED",
"CASH_ADVANCE",
"CREDITED",
"AWAITING_PAYMENT",
"SCHEDULED"
],
"type": "string"
},
"status": {
"description": "Status filter for expenses",
"enum": [
"DRAFT",
"SUBMITTED",
"APPROVED",
"OUT_OF_POLICY",
"VOID",
"CANCELED",
"SPLIT",
"SETTLED"
],
"type": "string"
}
},
"type": "object"
}