Read a network token's network, issuer and effective status

GET/cards/network-tokens/tokens/{id}

The card's bound holder (verified customer identity) or staff with cards:tokens:read. network_status is what the token service reports, issuer_status the bank's own block, effective_status the most restrictive of both; card controls still apply to every token authorization.

Path parameters

idstringRequired

Returns

200 OK

assurancestringRequired

card_idstringRequired

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

controlsobjectRequired

Controls are per-token spending controls. They only ever restrict further than the card's own controls, which still apply to every token authorization.

5 child attributes

blocked_mccsarray of stringsOptional

channelsarray of stringsOptional

Empty means every channel of the token's domain

daily_limit_amountintegerOptional

per_transaction_limit_amountintegerOptional

valid_untilstring · date-time or nullOptional

created_atstring · date-timeRequired

decisionobjectRequired

Decision is the issuer's answer to a token authorization request.

4 child attributes

assurancestringRequired

decisionstringRequired

reasonsarray of stringsRequired

verification_methodsarray of objectsOptional

1 child attribute

typestringRequired

device_sha256stringOptional

domain_controlsobjectRequired

DomainControls are the token domain restriction controls the issuer sets at provisioning.

4 child attributes

channelsarray of stringsRequired

cryptogram_requiredbooleanRequired

merchant_idstringOptional

token_requestor_idstringRequired

effective_statusstringRequired

holder_customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

idstringRequired

issuer_statusstringRequired

issuer_suspended_bystringOptional

Holder or staff

last_network_event_atstring · date-time or nullOptional

merchant_idstringOptional

networkstringRequired

network_statusstringRequired

original_card_idstringRequired

Example card_2tVh8nqLxq4GbDe0K1F6S9zRcWm

sequenceintegerRequired

token_expiry_monthintegerRequired

token_expiry_yearintegerRequired

token_last4stringRequired

token_referencestringRequired

token_requestor_idstringRequired

token_requestor_namestringRequired

token_typestringRequired

updated_atstring · date-timeRequired

use_casestringRequired

wallet_consent_idstringOptional

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503