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.
- 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