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

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

Properties

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

Properties

​
amount
number
required
The limit amount in dollars.
​
frequency
string
required
Limit window, for example per24HourPeriod or perAuthorization.
​
name
string | null
required
Card display name.
​
object
string
required
​
secrets
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

​
card_number
string
required
Full card number.
​
cvc
string
required
Card verification code.
​
name_on_card
string | null
required
Cardholder name printed on the card.
​
spent_last_month
integer | null
required
Total spend in the last 30 days, in cents.
​
status
string,null | null
required
The card status.Available options: active, frozen, canceled, invited
​
type
string,null | null
required
The card type.Available options: virtual, physical
​
user_id
string | null
required
Cardholder user ID, prefixed user_, when assigned.
Card