Sign in

v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB
reimbursements

Update a reimbursement

Update details about an existing reimbursement.

patch/v3/spend/reimbursements/{reimbursementId}

Path parameters

reimbursementIdstring required

BILL-generated ID or UUID of the reimbursement

Example:{{se_reimbursement_uuid}}

Headers

apiTokenstring nullable

Access token for Spend & Expense API authentication

Example:{{api_token}}

Request body

userIdstring

BILL-generated ID of the user to be reimbursed

budgetIdstring

BILL-generated ID of the budget to be used for the reimbursement

amountnumber

Reimbursement amount

notestring

Reimbursement note. Use this field to describe the business purpose for the expense.

merchantNamestring

Merchant name for the expense

occurredDatestring date

Expense created date. The value is in the yyyy-MM-dd format.

Example request

{
  "occurredDate": "2026-12-26"
}

Response

Update a reimbursement response

idstring

BILL-generated ID of the reimbursement

uuidstring

BILL-generated UUID of the reimbursement

amountnumber

Reimbursement amount

fulfillmentType'PAYROLL' | 'ACH' | 'UNSPECIFIED'

Reimbursement fulfillment type.

fundRequestAmountnumber

Amount that must be added to the user funds for the user to have enough funds for this reimbursement

fundRequestBudgetAmountnumber

Amount that must be added to the budget for the user to have enough funds for this reimbursement

merchantNamestring

Merchant name for the expense

notestring

Reimbursement note. Use this field to describe the business purpose for the expense.

submittedTimestring date-time

Reimbursement request submission date and time

occurredDatestring date

Expense created date. The value is in the yyyy-MM-dd format.

retiredboolean

This field is set as true if the reimbursement has been deleted

status'UNSPECIFIED' | 'CREATED' | 'AWAITING_APPROVAL' | 'APPROVAL_UNDONE' | 'AWAITING_TIER2_APPROVAL' | 'TIER2_APPROVAL_UNDONE' | 'APPROVED' | 'CANCEL_PAYMENT' | 'FUNDING_RECEIVED' | 'PAID' | 'PAYMENT_FAILED' | 'DENIED' | 'DENIAL_UNDONE' | 'DELETED'

Reimbursement status.

type'PURCHASE' | 'MILEAGE'

Reimbursement type.

batchIdstring

ACH batch ID.

You can use batchId to identify the set of reimbursements bundled together when funds are withdrawn from the company bank account. Reimbursements with the same batchId are withdrawn at the same time.

batchAmountnumber

ACH batch amount

budgetIdstring

BILL-generated ID of the budget to be used for the reimbursement

budgetUuidstring

BILL-generated UUID of the budget to be used for the reimbursement

userIdstring

BILL-generated ID of the user to be reimbursed

userUuidstring

BILL-generated UUID of the user to be reimbursed