get_all_card_expenses
Retrieve paginated corporate card expense records from Brex with filtering options for status, date ranges, amounts, and merchant names to manage financial tracking and reporting.
Instructions
LIST: Paginated card expenses (no expense_type needed). Returns complete card expense objects. Example: {"page_size":5,"max_items":5,"window_days":7,"min_amount":100}
Input Schema
Name | Required | Description | Default |
---|---|---|---|
end_date | No | Filter card expenses created on or before this date (ISO format) | |
expand | No | Fields to expand (e.g., merchant, receipts) | |
max_amount | No | Client-side maximum purchased_amount.amount filter | |
max_items | No | Maximum total number of items to retrieve across all pages | |
merchant_name | No | Filter card expenses by merchant name (partial match) | |
min_amount | No | Client-side minimum purchased_amount.amount filter | |
page_size | No | Number of items per page (default: 50, max: 100) | |
payment_status | No | Filter card expenses by payment status | |
start_date | No | Filter card expenses created on or after this date (ISO format) | |
status | No | Filter card expenses by status | |
window_days | No | Optional batching window in days to split large date ranges |
Input Schema (JSON Schema)
{
"properties": {
"end_date": {
"description": "Filter card expenses created on or before this date (ISO format)",
"type": "string"
},
"expand": {
"description": "Fields to expand (e.g., merchant, receipts)",
"items": {
"type": "string"
},
"type": "array"
},
"max_amount": {
"description": "Client-side maximum purchased_amount.amount filter",
"type": "number"
},
"max_items": {
"description": "Maximum total number of items to retrieve across all pages",
"type": "number"
},
"merchant_name": {
"description": "Filter card expenses by merchant name (partial match)",
"type": "string"
},
"min_amount": {
"description": "Client-side minimum purchased_amount.amount filter",
"type": "number"
},
"page_size": {
"description": "Number of items per page (default: 50, max: 100)",
"type": "number"
},
"payment_status": {
"description": "Filter card expenses by payment status",
"items": {
"enum": [
"NOT_STARTED",
"PROCESSING",
"CANCELED",
"DECLINED",
"CLEARED",
"REFUNDING",
"REFUNDED",
"CASH_ADVANCE",
"CREDITED",
"AWAITING_PAYMENT",
"SCHEDULED"
],
"type": "string"
},
"type": "array"
},
"start_date": {
"description": "Filter card expenses created on or after this date (ISO format)",
"type": "string"
},
"status": {
"description": "Filter card expenses by status",
"items": {
"enum": [
"DRAFT",
"SUBMITTED",
"APPROVED",
"OUT_OF_POLICY",
"VOID",
"CANCELED",
"SPLIT",
"SETTLED"
],
"type": "string"
},
"type": "array"
},
"window_days": {
"description": "Optional batching window in days to split large date ranges",
"type": "number"
}
},
"type": "object"
}