Sign in

v1

latestOpenAPI 3.0.02026-08-0661948.3 KB
Accounting Records

Get accounting record by ID

Retrieve a single accounting record by its unique identifier

get/v3/accounting/records/{record_id}

Path parameters

record_idstring required

Query parameters

single_entryboolean

Toggles the response format between single-entry and double-entry bookkeeping. Set to true to filter out offsetting ledger entries and return only the core cash-flow or economic-impact line items. Defaults to false.

Response

Accounting record retrieved successfully

idstring required

Unique identifier for the accounting record

type'CARD_EXPENSE_POST' | 'CARD_EXPENSE_REPAYMENT' | 'REIMBURSEMENT_EXPENSE_REPAYMENT' | 'REIMBURSEMENT_EXPENSE_APPROVAL' | 'REIMBURSEMENT_EXPENSE_MONEY_MOVEMENT_PAYOUT' | 'REIMBURSEMENT_EXPENSE_MONEY_MOVEMENT_PAYIN' | 'REIMBURSEMENT_EXPENSE_POST' | 'CARD_PAYMENT' | 'REWARD_REDEMPTION' | 'REIMBURSEMENT_EXPENSE_MONEY_MOVEMENT_REFUND' | 'CARD_EXPENSE_REFUND' | 'CARD_PAYMENT_REFUND' | 'REIMBURSEMENT_EXPENSE_MONEY_MOVEMENT_PAYOUT_REVERSAL' | 'INVOICE' | 'INVOICE_PAYMENT' | 'BILL_EXPENSE' | 'BILL_EXPENSE_PAYMENT' | 'BILL_EXPENSE_CARD_PAYMENT' | 'BILL_MONEY_MOVEMENT_PAYIN' required

Types of accounting records representing different financial transactions:

Card-related transactions:

  • CARD_EXPENSE_POST: Records when a card expense is posted and settled

  • CARD_EXPENSE_REFUND: Records when a merchant issues a refund for a card transaction

  • CARD_EXPENSE_REPAYMENT: Records when an employee repays money to the company for a card expense

  • CARD_PAYMENT: Records payments from customer to Brex for card balances

  • CARD_PAYMENT_REFUND: Records refunds from Brex to customer for overpayments

  • REWARD_REDEMPTION: Records when a reward is redeemed

Bill-related transactions:

  • BILL_EXPENSE: Records when a bill expense is created

  • BILL_EXPENSE_PAYMENT: Records when a bill is paid through ACH/wire transfer

  • BILL_EXPENSE_CARD_PAYMENT: Records when a bill is paid using a Brex card

Reimbursement-related transactions:

  • REIMBURSEMENT_EXPENSE_APPROVAL: Records approval of reimbursement (accrual basis)

  • REIMBURSEMENT_EXPENSE_POST: Records when reimbursement is fulfilled (cash basis)

  • REIMBURSEMENT_EXPENSE_REPAYMENT: Records repayment of a reimbursement expense

  • REIMBURSEMENT_EXPENSE_MONEY_MOVEMENT_PAYOUT: Records payout to employee/third party

  • REIMBURSEMENT_EXPENSE_MONEY_MOVEMENT_PAYOUT_REVERSAL: Records reversal of payout

  • REIMBURSEMENT_EXPENSE_MONEY_MOVEMENT_PAYIN: Records payment from customer to Brex

  • REIMBURSEMENT_EXPENSE_MONEY_MOVEMENT_REFUND: Records refund to customer's bank

review_status'PREPARE' | 'REVIEW' | 'READY_FOR_EXPORT' | 'EXPORTED' required

Current review status of the record in the accounting review lifecycle: PREPARE → REVIEW → READY_FOR_EXPORT → EXPORTED.

source_idstring nullable

Source transaction ID

source_type'CARD' | 'REIMBURSEMENT' | 'BILL' required

Source type

erp_posting_datestring date-time required

ERP impact date in UTC timezone

updated_atstring date-time required

Last update timestamp in UTC timezone

versionnumber required

Version number

memostring nullable

Memo/description

posted_atstring date-time required

Source posted date in UTC timezone

due_atstring date-time nullable

Source due at in UTC timezone. For bills only

invoice_numberstring nullable

Invoice number. For bills only

Example response

{
  "id": "accr_abc123",
  "amount": {
    "amount": 100,
    "currency": "USD"
  },
  "original_amount": {
    "amount": 100,
    "currency": "USD"
  },
  "user": {
    "id": "VXNlcjpjdXVzZXJfMTIzNA==",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com",
    "role": "CARD_ADMIN",
    "status": "ACTIVE",
    "manager_id": "VXNlcjpjdXVzZXJfMTIzNA==",
    "department_id": "VXNlcjpjdXVzZXJfMTIzNA==",
    "department_name": "Engineering",
    "location_id": "VXNlcjpjdXVzZXJfMTIzNA==",
    "location_name": "San Francisco",
    "title_id": "VGl0bGU6dGl0bGVfMTIzNA==",
    "title_name": "Software Engineer",
    "manager_first_name": "Jane",
    "manager_last_name": "Smith",
    "manager_title_id": "VGl0bGU6dGl0bGVfMTIzNA==",
    "manager_title_name": "Engineering Manager"
  },
  "vendor": {
    "id": "vendor_123",
    "name": "Acme Corp",
    "contact_name": "Jane Smith",
    "email": "contact@acme.com",
    "website": "https://acme.com",
    "phone": "+1-555-123-4567"
  },
  "line_items": [
    {
      "id": "arli_abc123",
      "amount": {
        "amount": 100,
        "currency": "USD"
      },
      "original_amount": {
        "amount": 100,
        "currency": "USD"
      },
      "accounting_field_values": [
        {
          "brex_field_id": "ef_123",
          "remote_field_id": "1",
          "brex_field_value_id": "efo_123",
          "remote_field_value_id": "123"
        }
      ]
    }
  ]
}