Integrates Brex into the workflow. List and update expenses, upload and match receipts, view card and cash transactions, accounts, budgets, spend limits, vendors, transfers, and team data.
List expenses in the Brex account with optional filters for user, status, payment status, and purchase date range
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
userIds | string | いいえ | Comma-separated user IDs to filter expenses by owner |
statuses | string | いいえ | Comma-separated expense statuses to filter by: DRAFT, SUBMITTED, APPROVED, OUT_OF_POLICY, VOID, CANCELED, SPLIT, SETTLED |
paymentStatuses | string | いいえ | Comma-separated payment statuses to filter by: NOT_STARTED, PROCESSING, CANCELED, DECLINED, CLEARED, REFUNDING, REFUNDED, CASH_ADVANCE, CREDITED, AWAITING_PAYMENT, SCHEDULED |
purchasedAtStart | string | いいえ | Only include expenses purchased at or after this ISO 8601 timestamp |
purchasedAtEnd | string | いいえ | Only include expenses purchased at or before this ISO 8601 timestamp |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of expenses to return (max 100) |
| パラメータ | 型 | 説明 |
|---|
items | array | Expenses matching the filters |
↳ id | string | Unique expense ID |
↳ memo | string | Memo on the expense |
↳ status | string | Expense status (DRAFT, SUBMITTED, APPROVED, OUT_OF_POLICY, VOID, CANCELED, SPLIT, SETTLED) |
↳ payment_status | string | Payment status (NOT_STARTED, PROCESSING, CANCELED, DECLINED, CLEARED, REFUNDING, REFUNDED, CASH_ADVANCE, CREDITED, AWAITING_PAYMENT, SCHEDULED) |
↳ expense_type | string | Expense type (CARD, BILLPAY, REIMBURSEMENT, CLAWBACK, UNSET) |
↳ category | string | Expense category (e.g., RESTAURANTS, RECURRING_SOFTWARE_AND_SAAS, AIRLINE_EXPENSES) |
↳ merchant | json | Merchant details |
↳ raw_descriptor | string | Raw merchant descriptor |
↳ mcc | string | Merchant category code |
↳ country | string | Merchant country |
↳ user | json | User who made the expense |
↳ id | string | User ID |
↳ first_name | string | First name |
↳ last_name | string | Last name |
↳ budget | json | Budget the expense belongs to |
↳ id | string | Budget ID |
↳ name | string | Budget name |
↳ department | json | Department of the expense owner |
↳ id | string | Department ID |
↳ name | string | Department name |
↳ location | json | Location of the expense owner |
↳ id | string | Location ID |
↳ name | string | Location name |
↳ original_amount | json | Original transaction amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ billing_amount | json | Amount billed to the account |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ purchased_amount | json | Amount at the time of purchase |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ receipts | array | Receipts attached to the expense |
↳ id | string | Receipt ID |
↳ download_uris | array | Pre-signed receipt download URLs |
↳ purchased_at | string | Purchase timestamp (ISO 8601) |
↳ updated_at | string | Last update timestamp (ISO 8601) |
↳ dashboard_url | string | Link to the expense in the Brex dashboard |
nextCursor | string | Cursor for fetching the next page of results |
Get a single Brex expense by its ID, including merchant, user, and receipt details
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
expenseId | string | はい | ID of the expense to fetch |
| パラメータ | 型 | 説明 |
|---|
id | string | Unique expense ID |
memo | string | Memo on the expense |
status | string | Expense status (DRAFT, SUBMITTED, APPROVED, OUT_OF_POLICY, VOID, CANCELED, SPLIT, SETTLED) |
paymentStatus | string | Payment status (NOT_STARTED, PROCESSING, CANCELED, DECLINED, CLEARED, REFUNDING, REFUNDED, CASH_ADVANCE, CREDITED, AWAITING_PAYMENT, SCHEDULED) |
expenseType | string | Expense type (CARD, BILLPAY, REIMBURSEMENT, CLAWBACK, UNSET) |
category | string | Expense category (e.g., RESTAURANTS, RECURRING_SOFTWARE_AND_SAAS, AIRLINE_EXPENSES) |
merchantId | string | Merchant ID |
merchant | json | Merchant details (raw descriptor, MCC, country) |
↳ raw_descriptor | string | Raw merchant descriptor |
↳ mcc | string | Merchant category code |
↳ country | string | Merchant country |
budgetId | string | Budget ID |
budget | json | Budget the expense belongs to |
↳ id | string | Budget ID |
↳ name | string | Budget name |
departmentId | string | Department ID |
department | json | Department of the expense owner |
↳ id | string | Department ID |
↳ name | string | Department name |
locationId | string | Location ID |
location | json | Location of the expense owner |
↳ id | string | Location ID |
↳ name | string | Location name |
userId | string | ID of the user who made the expense |
user | json | User who made the expense |
↳ id | string | User ID |
↳ first_name | string | First name |
↳ last_name | string | Last name |
originalAmount | json | Original transaction amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
billingAmount | json | Amount billed to the account |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
purchasedAmount | json | Amount at the time of purchase |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
usdEquivalentAmount | json | USD equivalent amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
purchasedAt | string | Purchase timestamp (ISO 8601) |
updatedAt | string | Last update timestamp (ISO 8601) |
paymentPostedAt | string | Timestamp the payment was posted (ISO 8601) |
receipts | array | Receipts attached to the expense |
↳ id | string | Receipt ID |
↳ download_uris | array | Pre-signed receipt download URLs |
dashboardUrl | string | Link to the expense in the Brex dashboard |
Update the memo of a Brex card expense
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
expenseId | string | はい | ID of the card expense to update |
memo | string | はい | New memo for the expense |
| パラメータ | 型 | 説明 |
|---|
id | string | Unique expense ID |
memo | string | Updated memo on the expense |
status | string | Expense status (DRAFT, SUBMITTED, APPROVED, OUT_OF_POLICY, VOID, CANCELED, SPLIT, SETTLED) |
paymentStatus | string | Payment status (NOT_STARTED, PROCESSING, CANCELED, DECLINED, CLEARED, REFUNDING, REFUNDED, CASH_ADVANCE, CREDITED, AWAITING_PAYMENT, SCHEDULED) |
category | string | Expense category (e.g., RESTAURANTS, RECURRING_SOFTWARE_AND_SAAS, AIRLINE_EXPENSES) |
merchantId | string | Merchant ID |
budgetId | string | Budget ID |
originalAmount | json | Original transaction amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
billingAmount | json | Amount billed to the account |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
purchasedAt | string | Purchase timestamp (ISO 8601) |
updatedAt | string | Last update timestamp (ISO 8601) |
Upload a receipt file and attach it to a specific Brex card expense
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
expenseId | string | はい | ID of the card expense to attach the receipt to |
file | file | はい | Receipt file to upload (max 50 MB) |
receiptName | string | いいえ | Receipt file name including extension (defaults to the uploaded file name) |
| パラメータ | 型 | 説明 |
|---|
receiptId | string | Unique identifier of the receipt upload |
receiptName | string | Name the receipt was uploaded with |
expenseId | string | ID of the expense the receipt was attached to |
Upload a receipt file and let Brex automatically match it with existing expenses
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
file | file | はい | Receipt file to upload (max 50 MB) |
receiptName | string | いいえ | Receipt file name including extension (defaults to the uploaded file name) |
| パラメータ | 型 | 説明 |
|---|
receiptId | string | Unique identifier of the receipt match request |
receiptName | string | Name the receipt was uploaded with |
expenseId | string | Always null for receipt match (Brex matches the receipt asynchronously) |
List settled card transactions for all Brex card accounts
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
userIds | string | いいえ | Comma-separated user IDs to filter transactions by cardholder |
postedAtStart | string | いいえ | Only include transactions posted at or after this ISO 8601 timestamp |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of transactions to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Settled card transactions |
↳ id | string | Unique transaction ID |
↳ card_id | string | ID of the card used |
↳ description | string | Transaction description |
↳ amount | json | Transaction amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ initiated_at_date | string | Date the transaction was initiated |
↳ posted_at_date | string | Date the transaction was posted |
↳ type | string | Transaction type (PURCHASE, REFUND, CHARGEBACK, REWARDS_CREDIT, COLLECTION, BNPL_FEE) |
↳ merchant | json | Merchant details |
↳ raw_descriptor | string | Raw merchant descriptor |
↳ mcc | string | Merchant category code |
↳ country | string | Merchant country |
↳ expense_id | string | Associated expense ID |
nextCursor | string | Cursor for fetching the next page of results |
List transactions for a Brex cash account
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
accountId | string | はい | ID of the cash account to list transactions for |
postedAtStart | string | いいえ | Only include transactions posted at or after this ISO 8601 timestamp |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of transactions to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Cash account transactions |
↳ id | string | Unique transaction ID |
↳ description | string | Transaction description |
↳ amount | json | Transaction amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ initiated_at_date | string | Date the transaction was initiated |
↳ posted_at_date | string | Date the transaction was posted |
↳ type | string | Transaction type |
↳ transfer_id | string | Associated transfer ID |
nextCursor | string | Cursor for fetching the next page of results |
List all Brex card accounts with balances and limits
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
| パラメータ | 型 | 説明 |
|---|
accounts | array | Card accounts |
↳ id | string | Unique account ID |
↳ status | string | Account status |
↳ current_balance | json | Current balance |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ available_balance | json | Available balance |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ account_limit | json | Account limit |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ current_statement_period | json | Current statement period (start_date, end_date) |
List all Brex cash accounts with balances and account details
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of accounts to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Cash accounts |
↳ id | string | Unique account ID |
↳ name | string | Account name |
↳ status | string | Account status |
↳ current_balance | json | Current balance |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ available_balance | json | Available balance |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ account_number | string | Bank account number |
↳ routing_number | string | Bank routing number |
↳ primary | boolean | Whether this is the primary cash account |
nextCursor | string | Cursor for fetching the next page of results |
Get a Brex cash account by ID, or the primary cash account when no ID is provided
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
accountId | string | いいえ | ID of the cash account (defaults to the primary cash account) |
| パラメータ | 型 | 説明 |
|---|
id | string | Unique account ID |
name | string | Account name |
status | string | Account status |
currentBalance | json | Current balance |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
availableBalance | json | Available balance |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
accountNumber | string | Bank account number |
routingNumber | string | Bank routing number |
primary | boolean | Whether this is the primary cash account |
List finalized statements for the primary Brex card account
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of statements to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Finalized card account statements |
↳ id | string | Unique statement ID |
↳ start_balance | json | Balance at the start of the period |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ end_balance | json | Balance at the end of the period |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ period | json | Statement period (start_date, end_date) |
nextCursor | string | Cursor for fetching the next page of results |
List finalized statements for a Brex cash account
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
accountId | string | はい | ID of the cash account to list statements for |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of statements to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Finalized cash account statements |
↳ id | string | Unique statement ID |
↳ start_balance | json | Balance at the start of the period |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ end_balance | json | Balance at the end of the period |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ period | json | Statement period (start_date, end_date) |
nextCursor | string | Cursor for fetching the next page of results |
List users in the Brex account, optionally filtered by email
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
email | string | いいえ | Filter users by exact email address |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of users to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Users in the Brex account |
↳ id | string | Unique user ID |
↳ first_name | string | First name |
↳ last_name | string | Last name |
↳ email | string | Email address |
↳ status | string | User status (INVITED, ACTIVE, CLOSED, DISABLED, DELETED, PENDING_ACTIVATION, INACTIVE, ARCHIVED) |
↳ manager_id | string | ID of the manager |
↳ department_id | string | Department ID |
↳ location_id | string | Location ID |
↳ title_id | string | Title ID |
nextCursor | string | Cursor for fetching the next page of results |
Get a Brex user by their ID
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
userId | string | はい | ID of the user to fetch |
| パラメータ | 型 | 説明 |
|---|
id | string | Unique user ID |
firstName | string | First name |
lastName | string | Last name |
email | string | Email address |
status | string | User status (INVITED, ACTIVE, CLOSED, DISABLED, DELETED, PENDING_ACTIVATION, INACTIVE, ARCHIVED) |
managerId | string | ID of the manager |
departmentId | string | Department ID |
locationId | string | Location ID |
titleId | string | Title ID |
Get the Brex user associated with the API token
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
| パラメータ | 型 | 説明 |
|---|
id | string | Unique user ID |
firstName | string | First name |
lastName | string | Last name |
email | string | Email address |
status | string | User status (INVITED, ACTIVE, CLOSED, DISABLED, DELETED, PENDING_ACTIVATION, INACTIVE, ARCHIVED) |
managerId | string | ID of the manager |
departmentId | string | Department ID |
locationId | string | Location ID |
titleId | string | Title ID |
List departments in the Brex account, optionally filtered by name
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
name | string | いいえ | Filter departments by name |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of departments to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Departments in the Brex account |
↳ id | string | Unique department ID |
↳ name | string | Department name |
↳ description | string | Department description |
nextCursor | string | Cursor for fetching the next page of results |
List locations in the Brex account, optionally filtered by name
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
name | string | いいえ | Filter locations by name |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of locations to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Locations in the Brex account |
↳ id | string | Unique location ID |
↳ name | string | Location name |
↳ description | string | Location description |
nextCursor | string | Cursor for fetching the next page of results |
List job titles in the Brex account, optionally filtered by name
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
name | string | いいえ | Filter titles by name |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of titles to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Job titles in the Brex account |
↳ id | string | Unique title ID |
↳ name | string | Title name |
nextCursor | string | Cursor for fetching the next page of results |
List cards in the Brex account, optionally filtered by card owner
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
userId | string | いいえ | Filter cards by the ID of the card owner |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of cards to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Cards in the Brex account |
↳ id | string | Unique card ID |
↳ owner | json | Card owner (type, user_id) |
↳ status | string | Card status |
↳ last_four | string | Last four digits of the card number |
↳ card_name | string | Card name |
↳ card_type | string | Card type (VIRTUAL or PHYSICAL) |
↳ limit_type | string | Limit type (CARD or USER) |
↳ spend_controls | json | Spend controls on the card |
↳ billing_address | json | Billing address of the card |
↳ expiration_date | json | Card expiration date (month, year) |
↳ budget_id | string | Associated budget ID |
nextCursor | string | Cursor for fetching the next page of results |
Get the Brex company associated with the API token
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
| パラメータ | 型 | 説明 |
|---|
id | string | Unique company ID |
legalName | string | Legal name of the company |
mailingAddress | json | Company mailing address (line1, line2, city, state, country, postal_code) |
accountType | string | Brex account type (BREX_CLASSIC or BREX_EMPOWER) |
List budgets in the Brex account
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of budgets to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Budgets in the Brex account |
↳ budget_id | string | Unique budget ID |
↳ account_id | string | Account ID the budget belongs to |
↳ name | string | Budget name |
↳ description | string | Budget description |
↳ parent_budget_id | string | Parent budget ID |
↳ owner_user_ids | array | User IDs of the budget owners |
↳ period_recurrence_type | string | Budget period recurrence (WEEKLY, MONTHLY, QUARTERLY, YEARLY, ONE_TIME) |
↳ start_date | string | Budget start date |
↳ end_date | string | Budget end date |
↳ amount | json | Budget amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ spend_budget_status | string | Budget status |
↳ limit_type | string | Budget limit type |
nextCursor | string | Cursor for fetching the next page of results |
Get a Brex budget by its ID
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
budgetId | string | はい | ID of the budget to fetch |
| パラメータ | 型 | 説明 |
|---|
budgetId | string | Unique budget ID |
accountId | string | Account ID the budget belongs to |
name | string | Budget name |
description | string | Budget description |
parentBudgetId | string | Parent budget ID |
ownerUserIds | array | User IDs of the budget owners |
periodRecurrenceType | string | Budget period recurrence (WEEKLY, MONTHLY, QUARTERLY, YEARLY, ONE_TIME) |
startDate | string | Budget start date |
endDate | string | Budget end date |
amount | json | Budget amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
spendBudgetStatus | string | Budget status (ACTIVE, ARCHIVED, DELETED, EXPIRED) |
limitType | string | Budget limit type (HARD or SOFT) |
List spend limits in the Brex account, optionally filtered by member user
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
memberUserIds | string | いいえ | Comma-separated user IDs to filter spend limits by member |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of spend limits to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Spend limits in the Brex account |
↳ id | string | Unique spend limit ID |
↳ account_id | string | Account ID the spend limit belongs to |
↳ name | string | Spend limit name |
↳ description | string | Spend limit description |
↳ parent_budget_id | string | Parent budget ID |
↳ status | string | Spend limit status |
↳ period_recurrence_type | string | Period recurrence (PER_WEEK, PER_MONTH, PER_QUARTER, PER_YEAR, ONE_TIME) |
↳ spend_type | string | Spend type of the limit |
↳ owner_user_ids | array | User IDs of the spend limit owners |
↳ member_user_ids | array | User IDs of the spend limit members |
↳ current_period_balance | json | Spend and rollover amounts for the current period |
↳ start_date | string | Start date of the current period |
↳ end_date | string | End date of the current period |
↳ start_time | string | Start time of the current period (ISO 8601) |
↳ end_time | string | End time of the current period (ISO 8601) |
↳ amount_spent | json | Amount spent in the current period |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ rollover_amount | json | Amount rolled over from previous periods |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
nextCursor | string | Cursor for fetching the next page of results |
Get a Brex spend limit by its ID
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
spendLimitId | string | はい | ID of the spend limit to fetch |
| パラメータ | 型 | 説明 |
|---|
id | string | Unique spend limit ID |
accountId | string | Account ID the spend limit belongs to |
name | string | Spend limit name |
description | string | Spend limit description |
parentBudgetId | string | Parent budget ID |
status | string | Spend limit status (ACTIVE, EXPIRED, ARCHIVED, DELETED) |
periodRecurrenceType | string | Period recurrence (PER_WEEK, PER_MONTH, PER_QUARTER, PER_YEAR, ONE_TIME) |
spendType | string | Spend type of the limit |
startDate | string | Spend limit start date |
endDate | string | Spend limit end date |
ownerUserIds | array | User IDs of the spend limit owners |
memberUserIds | array | User IDs of the spend limit members |
currentPeriodBalance | json | Spend and rollover amounts for the current period |
↳ start_date | string | Start date of the current period |
↳ end_date | string | End date of the current period |
↳ start_time | string | Start time of the current period (ISO 8601) |
↳ end_time | string | End time of the current period (ISO 8601) |
↳ amount_spent | json | Amount spent in the current period |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ rollover_amount | json | Amount rolled over from previous periods |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
authorizationSettings | json | Authorization settings (base limit, authorization type, rollover refresh) |
List vendors in the Brex account, optionally filtered by name
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
name | string | いいえ | Filter vendors by name |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of vendors to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Vendors in the Brex account |
↳ id | string | Unique vendor ID |
↳ company_name | string | Vendor company name |
↳ email | string | Vendor email address |
↳ phone | string | Vendor phone number |
↳ payment_accounts | array | Payment accounts associated with the vendor |
nextCursor | string | Cursor for fetching the next page of results |
Get a Brex vendor by its ID
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
vendorId | string | はい | ID of the vendor to fetch |
| パラメータ | 型 | 説明 |
|---|
id | string | Unique vendor ID |
companyName | string | Vendor company name |
email | string | Vendor email address |
phone | string | Vendor phone number |
paymentAccounts | array | Payment accounts associated with the vendor |
List money transfers in the Brex account
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
cursor | string | いいえ | Pagination cursor from a previous response |
limit | string | いいえ | Number of transfers to return (default 100, max 1000) |
| パラメータ | 型 | 説明 |
|---|
items | array | Transfers in the Brex account |
↳ id | string | Unique transfer ID |
↳ counterparty | json | Transfer counterparty details |
↳ description | string | Transfer description |
↳ payment_type | string | Payment type (ACH, DOMESTIC_WIRE, CHEQUE, INTERNATIONAL_WIRE, BOOK_TRANSFER, STABLECOIN) |
↳ amount | json | Transfer amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
↳ process_date | string | Date the transfer processes |
↳ originating_account | json | Account the transfer originates from |
↳ status | string | Transfer status (PROCESSING, SCHEDULED, PENDING_APPROVAL, FAILED, PROCESSED) |
↳ cancellation_reason | string | Reason the transfer was canceled |
↳ estimated_delivery_date | string | Estimated delivery date |
↳ creator_user_id | string | ID of the user who created the transfer |
↳ created_at | string | Creation timestamp |
↳ display_name | string | Transfer display name |
↳ external_memo | string | External memo |
nextCursor | string | Cursor for fetching the next page of results |
Get a Brex money transfer by its ID
| パラメータ | 型 | 必須 | 説明 |
|---|
apiKey | string | はい | Brex user token (generated from Developer Settings in the Brex dashboard) |
transferId | string | はい | ID of the transfer to fetch |
| パラメータ | 型 | 説明 |
|---|
id | string | Unique transfer ID |
counterparty | json | Transfer counterparty details |
description | string | Transfer description |
paymentType | string | Payment type (ACH, DOMESTIC_WIRE, CHEQUE, INTERNATIONAL_WIRE, BOOK_TRANSFER, STABLECOIN) |
amount | json | Transfer amount |
↳ amount | number | Amount in the smallest unit of the currency (e.g., cents for USD) |
↳ currency | string | ISO 4217 currency code (e.g., USD) |
processDate | string | Date the transfer processes |
originatingAccount | json | Account the transfer originates from |
status | string | Transfer status (PROCESSING, SCHEDULED, PENDING_APPROVAL, FAILED, PROCESSED) |
cancellationReason | string | Reason the transfer was canceled |
estimatedDeliveryDate | string | Estimated delivery date |
creatorUserId | string | ID of the user who created the transfer |
createdAt | string | Creation timestamp |
displayName | string | Transfer display name |
externalMemo | string | External memo |