Accounting

Get accounting record by ID

Changed on

Retrieve a single accounting record by its unique identifier

get/v3/accounting/records/{record_id}

Request

Path parameters

record_idstring required

Query parameters

single_entryboolean

Whether to return single entry line items

Response

Accounting record retrieved successfully

due_atstring date-time nullable

Source due at in UTC timezone. For bills only

erp_posting_datestring date-time required

ERP impact date in UTC timezone

idstring required

Unique identifier for the accounting record

invoice_numberstring nullable

Invoice number. For bills only

memostring nullable

Memo/description

posted_atstring date-time required

Source posted date in UTC timezone

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

Review status

source_idstring nullable

Source transaction ID

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

Source type

status'APPROVED' | 'CANCELED' | 'DRAFT' | 'OUT_OF_POLICY' | 'SETTLED' | 'SPLIT' | 'SUBMITTED' | 'VOID' nullable

The source expense's approval/lifecycle status. For bills this reflects the bill's approval state (e.g. SUBMITTED = pending approval, APPROVED = approved), which is not derivable from review_status (always READY_FOR_EXPORT when polling).

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

updated_atstring date-time required

Last update timestamp in UTC timezone

versionnumber required

Version number

Example response

{
  "amount": {
    "amount": 100,
    "currency": "USD"
  },
  "billing_amount": {
    "amount": 100,
    "currency": "USD"
  },
  "id": "accr_abc123",
  "line_items": [
    {
      "accounting_field_values": [
        {
          "brex_field_id": "ef_123",
          "brex_field_value_id": "efo_123",
          "field_name": "Accounting Entity",
          "field_value_name": "Test USA Inc.",
          "remote_field_id": "1",
          "remote_field_value_id": "123",
          "set_by_details": {
            "rule_id": "rule_abc123",
            "type": "CUSTOM_RULE"
          }
        }
      ],
      "amortization": {
        "amortization_template": {
          "display_name": "Annual Prepaid Insurance",
          "id": "efo_123",
          "remote_id": "12345"
        }
      },
      "amount": {
        "amount": 100,
        "currency": "USD"
      },
      "billing_amount": {
        "amount": 100,
        "currency": "USD"
      },
      "id": "arli_abc123",
      "original_amount": {
        "amount": 100,
        "currency": "USD"
      }
    }
  ],
  "original_amount": {
    "amount": 100,
    "currency": "USD"
  },
  "user": {
    "account_id": "cuacc_1234",
    "brex_assistant": {
      "disabled_reason": "USER_DISABLED",
      "experience": "IAF",
      "is_enabled": true
    },
    "department_id": "cudmnt_1234",
    "department_name": "Engineering",
    "email": "john.doe@example.com",
    "first_name": "John",
    "id": "cuuser_1234",
    "last_name": "Doe",
    "location_id": "culoc_1234",
    "location_name": "San Francisco",
    "manager_first_name": "Jane",
    "manager_id": "cuuser_1234",
    "manager_last_name": "Smith",
    "manager_title_id": "ti_1234",
    "manager_title_name": "Engineering Manager",
    "notification_preferences": {
      "preferred_channels": [
        {
          "channel": "WHATSAPP",
          "reply_mode": "TWO_WAY"
        }
      ],
      "text": "SMS"
    },
    "phone_number": "+14155551234",
    "role": "CARD_ADMIN",
    "status": "ACTIVE",
    "title_id": "ti_1234",
    "title_name": "Software Engineer"
  },
  "vendor": {
    "contact_name": "Jane Smith",
    "customer_account_id": "cuaac_123",
    "customer_dba_name": "Acme Corporation",
    "email": "contact@acme.com",
    "id": "LF5tfXg4ZzNFcy1EVXFwe2dKKV4oXj9IPFIjQHFJOzg",
    "name": "Acme Corp",
    "phone": "+1-555-123-4567",
    "rail_account_details": [
      {
        "bank_account_class": "BUSINESS",
        "bank_name": "Chase Bank",
        "beneficiary_type": "BUSINESS",
        "display_name": "Main Business Checking",
        "id": "rad_abc123",
        "inserted_at": "2024-01-15T10:30:00Z",
        "properties": {
          "routingNumber": "121000248",
          "accountNumber": "****1234"
        },
        "rail": {
          "type": "US_ACH"
        },
        "status": "ACTIVE",
        "target_country": "US",
        "target_currency": {
          "code": "USD"
        },
        "updated_at": "2024-01-15T10:30:00Z"
      }
    ],
    "website": "https://acme.com"
  }
}

Changes

    • breaking

      the response property //// became nullable for the status

    • breaking

      the response property ///// became optional for the status

    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the // response's property type changed from no type to object for status

    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the response's property type changed from no type to object for status

    • breaking

      the response's property type changed from no type to object for status

    • warning

      added the new AMORTIZATION_PROVISIONING_FAILED enum value to the response property for the response status

    • warning

      added the new AMORTIZATION_PROVISIONING_FAILED enum value to the response property for the response status

    • warning

      added the new AMORTIZATION_PROVISIONING_FAILED enum value to the response property for the response status

    • warning

      added the new AMORTIZATION_PROVISIONING_FAILED enum value to the response property for the response status

    • warning

      added the new AMORTIZATION_PROVISIONING_FAILED enum value to the response property for the response status

    • info

      the endpoint scheme security bearer was added to the API

    • info

      api tag Accounting added

    • info

      api tag Accounting Records removed

    • info

      added the optional property to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property //// to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property //// to the response with the status

    • info

      added the required property ///// to the response with the status

    • info

      added the required property ///// to the response with the status

    • info

      added the required property ///// to the response with the status