List all issuing tokens for card

Lists all Issuing Token objects for a given card.

Parameters

cardstringRequired
The Issuing card identifier to list tokens for.

createdobject
Only return Issuing tokens that were created during the given date interval.

statusenum

Select Issuing tokens with the given status.

Possible enum values

active

Token is provisioned and usable for payments.

deleted

Terminal state. Token can no longer be used.

requested

Token has been requested to be provisioned, but has not completed the activation process.

suspended

Token temporarily cannot be used for payments.

More parameters

ending_beforestring

limitinteger

starting_afterstring

Returns

A dictionary with a data property that contains an array of up to limit tokens, starting after token starting_after. Each entry in the array is a separate Issuing Token object. If no more tokens are available, the resulting array will be empty.

GET /v1/issuing/tokens

Server-side language

curl -G https://api.stripe.com/v1/issuing/tokens \
  -u "sk_test_BQokikJ...2HlWgH4olfQ2sk_test_BQokikJOvBiI2HlWgH4olfQ2:" \
  -d limit=3 \
  -d card=ic_1MytUz2eZvKYlo2CZCn5fuvZ

Response

{
  "object": "list",
  "url": "/v1/issuing/tokens",
  "has_more": false,
  "data": [
    {
      "id": "intok_1MzDbE2eZvKYlo2C26a98MDg",
      "object": "issuing.token",
      "card": "ic_1MytUz2eZvKYlo2CZCn5fuvZ",
      "created": 1682059060,
      "network_updated_at": 1682059060,
      "livemode": false,
      "status": "suspended",
      "last4": "2424",
      "token_service_provider": "visa",
      "wallet_provider": "apple_pay",
      "device_fingerprint": "intd_1MzDbE2eZvKYcp3095svdf"
    }
  ]
}

Transactions

Any use of an issued card that results in funds entering or leaving your Stripe account, such as a completed purchase or refund, is represented by an Issuing Transaction object.

Related guide: Issued card transactions

Endpoints

POST/v1/issuing/transactions/:id

GET/v1/issuing/transactions/:id

GET/v1/issuing/transactions

POST/v1/test_helpers/issuing/transactions/create_force_capture

POST/v1/test_helpers/issuing/transactions/create_unlinked_refund

POST/v1/test_helpers/issuing/transactions/:id/refund