Sign in

v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB
cards

Freeze a vendor card

Freeze an existing vendor card.

You can freeze virtual cards and physical cards. A frozen card cannot be used for payments.

post/v3/spend/cards/{cardId}/freeze

Path parameters

cardIdstring required

BILL-generated ID or UUID of the card

Example:{{se_card_uuid}}

Headers

apiTokenstring nullable

Access token for Spend & Expense API authentication

Example:{{api_token}}

Response

Freeze a vendor card response

idstring

BILL-generated ID of the card

uuidstring

BILL-generated UUID of the card

namestring

Card name

userIdstring

BILL-generated ID of the user linked with the card

userUuidstring

BILL-generated UUID of the user linked with the card

budgetIdstring

BILL-generated ID of the budget linked with the card

budgetUuidstring

BILL-generated UUID of the budget linked with the card

lastFourstring

Last four digits of the card number

validThrustring

BILL-generated card expiration date. The value is in the MM/YY format.

Note: Use the validThru value as the expiration date in a card payment. Do not use the expirationDate value for this operation.

expirationDatestring date

User-generated card expiration date. This value is in the yyyy-MM-dd format. BILL automatically closes the card account on this date.

Note: Use the validThru value as the expiration date in a card payment. Do not use the expirationDate value for this operation.

status'ACTIVATED' | 'NOT_ACTIVATED' | 'FROZEN' | 'DELETED'

Card status.

deletedReason'CANCELLED' | 'LOST' | 'STOLEN' | 'MISPLACED' | 'FRAUD_CONFIRMED'

Delete card reason. This field is available in the response only when status is DELETED.

type'PHYSICAL' | 'VIRTUAL_MEMBER' | 'VIRTUAL_VENDOR' | 'VIRTUAL'

Card type.

shareBudgetFundsboolean

Set as true to share all the budget funds with the card. This option enables the card user to spend from unallocated budget funds when the allocation is empty.

recurringboolean

Set as true to renew the card funds in the next budget period

recurringLimitnumber

Card spend limit for the all future budget periods

createdTimestring date-time

Created date and time

updatedTimestring date-time

Updated date and time