Skip to main content
Cards represent Whop-issued virtual payment cards that spend from an account or user balance. Cards can be assigned to cardholders and configured with spending limits for controlled spending. Use the Cards API to issue cards, list cards for an account or user, and retrieve active card details such as the card number and CVC.

​
Endpoints

​
Attributes

​
string
required
Card ID, prefixed icrd_.
​
object | null
required
The billing address.

Properties

​
string | null
required
Billing city.
​
string | null
required
Billing country code.
​
string | null
required
Street address line 1.
​
string | null
required
Street address line 2.
​
string | null
required
Billing postal code.
​
string | null
required
Billing region or state.
​
string | null
required
When the card was canceled.
​
string | null
required
When the card was created.
​
string | null
required
Card expiration month.
​
string | null
required
Card expiration year.
​
string | null
required
Last four digits of the card number. null for pending invitation cards.
​
object | null
required
The spending limit configuration.

Properties

​
number
required
The limit amount in dollars.
​
string
required
The window the limit amount applies to. per_transaction caps each individual authorization and is what a limit set with transaction_limit reports.Available options: daily, weekly, monthly, one_time, per_transaction
​
string | null
required
Card display name.
​
string
required
​
object | null
Sensitive card details. Present only on GET /cards/:card_id for active cards; null when the card is inactive or details cannot be retrieved.

Properties

​
string
required
Full card number.
​
string
required
Card verification code.
​
string | null
required
Cardholder name printed on the card.
​
string | null
required
The card PIN. Only returned when the request is authenticated as the user the card is assigned to; null for all other callers, including account API keys.
​
integer | null
required
Total spend in the last 30 days, in cents.
​
string | null
required
The card status. denied means the issuer declined the cardholder, so the card will never be issued.Available options: active, frozen, canceled, invited, denied
​
string | null
required
The card type.Available options: virtual, physical
​
string | null
required
Cardholder user ID, prefixed user_, when assigned.
Card