This changelog tracks changes to the Brex API and is updated periodically. Updates to the API are on a rolling basis and not on any defined schedule.
- MCP Server (Beta): Launched the Brex MCP server. Connect AI assistants like Claude, ChatGPT, Cursor, and Codex to your Brex account. Query expenses, look up users, check card statuses, and more through natural language. Supports OAuth and API key authentication.
- Expenses API: Added
booking_idfield to expense objects, providing the booking ID for trip expenses. - Expenses API: Added
spending_entityandpolicyas expand options on the List Expenses endpoints. - Onboarding API: Updated accepted EIN document types to include CP-575 fax sheet.
- Onboarding API: Added new endpoint
POST /v1/referrals/{id}/process_ein_documentfor processing delayed EIN documents after upload. - Fields API: Added
TRAVELfield type to field definitions. - Webhooks API: Added
ACCOUNTING_RECORD_READY_FOR_EXPORTwebhook event with schema and documentation. - Transactions API: Added
card_transaction_operation_reference_idfield to card transaction objects. - Team API: Updated secure endpoint URLs to new
api.brex.comhostnames.
- Expenses API: Reduced maximum limit parameter from 1000 to 100 for the List Expenses endpoints.
- Updated the API documentation look and feel.
- Added support for new API hostnames (api.brex.com); the former hostnames will continue to work for the forseeable future.
- Expenses API: Added
dashboard_urlfield to expense objects, providing a direct link to view expenses in the Brex dashboard.
- Accounting API (Alpha): Published the Accounting API reference so ERP partners or customers can discover and integrate with accounting data endpoints.
- Fields API (Beta): Field definition now exposes an optional
integration_idand a newERPfield type. This allows API caller to associate an ERP field with specific integration. - Webhooks API: Expanded WebhookEventType to include
ACCOUNTING_RECORD_READY_FOR_EXPORTevent type (Alpha).
- Cards API: Updated spend controls documentation with improved nullable property definitions.
- Fields API (alpha): Added official Fields API documentation with comprehensive endpoint specifications, including field creation, updates, and retrieval operations.
- Expenses API: Deprecated Card Expenses API endpoints in favor of consolidated Expenses API endpoints.
- Expenses API: Added documentation for new
payment_posted_at_startandpayment_posted_at_endfilters in the List expenses endpoints, allowing filtering expenses by when payments were posted.
- Expenses API: Updated documentation with latest field additions, including improved custom fields documentation.
- Expenses API: Published new endpoints and added
spending_entitydocumentation to provide better visibility into expense attribution.
- Budgets API: Updated spend limit creation to support
legal_entity_idanddepartment_idparameters, allowing expenses to be attributed to specific entities and departments. - Team API: Added new endpoint to get a legal entity by ID (
GET /v2/legal_entities/{id}). - Repository: Updated CODEOWNERS file to reflect team-specific ownership of different API sections.
- Team API: The Get card number endpoint response object now includes the cardholder name (
holder_name). - Expenses API: The List expenses endpoint request now allows for filtering on the
updated_attimestamp of expenses.
- Payments API: New endpoints introduced to create incoming transfers, list bank connections, manage transfers, and manage vendor information.
- Budgets API: Introduced new spend limit and budgets concepts as a new set of API endpoints (
v2). The old Spend Limits (v1) API is considered deprecated.
- Team API: The Get card endpoint response object now returns a (
has_been_transferred) boolean for a given card. - Team API: The Create card endpoint response object now accepts an expense policy ID (
policy_id) boolean for a given card. - Expenses API: The Expense object now returns an optional address (
has_been_transferred), a payment posted date and a trip ID if relevant to the expense.
- Webhooks: Updated IP whitelist.
- Transactions API: The List cash accounts endpoint response object now includes a
primaryboolean field indicating whether the cash account is the primary cash account for the Brex account. Every Brex user must have one primary cash account. - All APIs: Added a new header for tracing with a generic name
X-Brex-Trace-Id. Although the previous headerX-Datadog-Trace-Idis still in use as of now, we recommend to start usingX-Brex-Trace-Idas it is vendor-agnostic and will unlikely change overtime. - Payments API: Added
cancellation_reasoninto the Transfer response.
- Webhooks API: Added beta support for webhooks. View the webhooks guide for how to get started and the webhooks API reference for supported events and how to use them.
- Team API: Added a
monthly_availableobject to the responses for both theGETandSETmethods for user limits
- Payments API: Added the ability to do book transfers between Brex Cash accounts. See
counterparty->type->BOOK_TRANSFERin the request body for the Create Transfer endpoint
- Transactions API: Added endpoints to read cash transactions and read primary card transactions
- Payments API: Added the ability to filter vendors by
name(via encoded query param) for the lists vendors endpoint