Skip to main content

Real-Time Account Updater
Enterprise

Account Updater is an Enterprise feature. Request access in the portal.

Real-Time Update

Attempts to retrieve updates to a single card token in real-time. Possibly returns a new card token if there were updates available.

POST
https://api.basistheory.com/account-updater/real-time
Copy

Permissions

account-updater:real-time:invoke

Request

curl "https://api.basistheory.com/account-updater/real-time" \
-H 'Content-Type: application/json' \
-H 'BT-API-KEY: ...' \
-X POST \
-d '{
"token_id": "b4b89606-794a-4652-b375-f4e1d717a5db"
}'

Request Parameters

AttributeRequiredTypeDescription
token_idtruestringCard Token identifier
expiration_monthfalseintegerThe 2-digit expiration month of the account number. Not required if the card token already stores this value.
expiration_yearfalseintegerThe 4-digit expiration year of the account number. Not required if the card token already stores this value.

The token_id must correspond to a card token in your tenant and the card must contain a number valid for the Visa or Mastercard networks. If the card number corresponds to a different network, the WRN_UNSUPPORTED_NETWORK result code will be returned.

If the card token is missing an expiration date, the expiration_month and expiration_year parameters must be provided. If the token already contains an expiration date, these parameters will override the token's expiration date when requesting updates from the network.

Response

PropertyTypeDescription
new_tokenobjectReturns a new token if an update was found.
result_codestringThe result code of this update request
{
"new_token": {
"id": "c06d0789-0a38-40be-b7cc-c28a718f76f1",
"tenant_id": "77cb0024-123e-41a8-8ff8-a3d5a0fa8a08",
"type": "card",
"card": {
"bin": "42424242",
"last4": "4242",
"expiration_month": 12,
"expiration_year": 2027,
"brand": "visa",
"funding": "credit",
"issuer_country": {
"alpha2": "PL",
"name": "Bermuda",
"numeric": "369"
},
"authentication": "sca_required"
},
...
},
"result_code": "UPD_PAN"
}