Sample - Stripe API
GET/v1/tokens/{token}

Retrieve a token

Retrieves the token identified by token. Use expand to request expanded response fields when the default token representation is insufficient.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
tokenstringrequired
The unique identifier of the token. Must be a string no longer than 5000 characters.
expandarray<string>optional
Fields to expand in the response. Each value must be a string no longer than 5000 characters.

2 status codes
200Returns the token object with its identifier, token type, creation time, live-mode indicator, usage status, and any associated card or bank account details.
bank_accountobjectoptional
These bank accounts are payment methods on `Customer` objects. On the other hand [External Accounts](/api#external_accounts) are transfer destinations on `Account` objects for connected accounts. They can be bank accounts or debit cards as well, and are documented in the links above. Related guide: [Bank debits and transfers](/payments/bank-debits-transfers)
cardobjectoptional
You can store multiple cards on a customer in order to charge the customer later. You can also store multiple debit cards on a recipient in order to transfer to those cards later. Related guide: [Card payments with Sources](https://docs.stripe.com/sources/cards)
client_ipstringoptional
IP address of the client that generates the token.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:token
typestringrequired
Type of the token: `account`, `bank_account`, `card`, or `pii`.
usedbooleanrequired
Determines if you have already used this token (you can only use tokens once).
defaultError response.
errorobjectrequired

Error handling

token must be a string no longer than 5000 characters. Each expand value must be a string no longer than 5000 characters.