BIbill
reimbursements

Approve or deny a reimbursement

Changed on

Approve or deny a reimbursement request.

See Reimbursements in the Guides section for more information, sample requests, and responses.

post/v3/spend/reimbursements/{reimbursementId}/action

Request

  • Base URL
    https://gateway.stage.bill.com/connect
  • URL
    https://gateway.stage.bill.com/connect/v3/spend/reimbursements/{reimbursementId}/action
  • Auth
    none declared

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

action'APPROVE' | 'DENY' required

Reimbursement action. Set this field as APPROVE or DENY.

notestring

Reimbursement action note

Example request

{
  "action": "APPROVE",
  "note": "Team lunch expense approved"
}

Response

Approve or deny a reimbursement response

idstring

BILL-generated ID of the reimbursement

uuidstring

BILL-generated UUID of the reimbursement

amountnumber

Reimbursement amount

fulfillmentType'ACH' | 'PAYROLL'

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'CREATED' | 'AWAITING_APPROVAL' | 'AWAITING_TIER2_APPROVAL' | 'TIER2_APPROVAL_UNDONE' | 'APPROVAL_UNDONE' | 'DENIAL_UNDONE' | 'APPROVED' | 'CANCEL_PAYMENT' | 'PAID' | 'PAYMENT_FAILED' | 'DENIED' | 'DELETED' | 'ARCHIVED' | 'BUDGET_APPROVAL' | 'ADMIN_APPROVAL' | 'READY_TO_PAY' | 'PAYMENT_PENDING'

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

Changes

  • 54edddceb0a5Revision changes
    • warning

      added the new ADMIN_APPROVAL enum value to the //// response property for the response status

    • warning

      added the new ADMIN_APPROVAL enum value to the ////// response property for the response status

    • warning

      added the new ARCHIVED enum value to the //// response property for the response status

    • warning

      added the new ARCHIVED enum value to the ////// response property for the response status

    • warning

      added the new BUDGET_APPROVAL enum value to the //// response property for the response status

    • warning

      added the new BUDGET_APPROVAL enum value to the ////// response property for the response status

    • warning

      added the new PAYMENT_PENDING enum value to the //// response property for the response status

    • warning

      added the new PAYMENT_PENDING enum value to the ////// response property for the response status

    • warning

      added the new READY_TO_PAY enum value to the //// response property for the response status

    • warning

      added the new READY_TO_PAY enum value to the ////// response property for the response status

    • info

      removed the FUNDING_RECEIVED enum value from the //// response property for the response status

    • info

      removed the FUNDING_RECEIVED enum value from the ////// response property for the response status

    • info

      removed the UNSPECIFIED enum value from the //// response property for the response status

    • info

      removed the UNSPECIFIED enum value from the //// response property for the response status

    • info

      removed the UNSPECIFIED enum value from the ////// response property for the response status