Skip to main content
Cards represent Whop-issued payment cards that spend from an account balance. A card can be virtual or physical, assigned to a user, and configured with spending limits. Use the Cards API to create cards, list cards on an account, and retrieve card details for account spending workflows.

​
Endpoints

EndpointRequest
List CardsGET /cards
Create CardPOST /cards
Retrieve CardGET /cards/{card_id}

​
Attributes

​
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.
​
id
string
required
The icrd_ identifier of the card.
​
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
The card’s sensitive details. Only present on GET /cards/:card_id (retrieve); null for cards that are not active or whose details could not be retrieved.

Properties

​
card_number
string
required
The full card number.
​
cvc
string
required
The card verification code.
​
name_on_card
string | null
required
The 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
The user_ identifier of the cardholder, when assigned.
Card
{
	"billing": {
		"city": "New York",
		"country_code": "US",
		"line1": "123 Spring Street",
		"line2": "Suite 4",
		"postal_code": "10012",
		"region": "NY"
	},
	"canceled_at": null,
	"created_at": "2026-06-01T12:00:00Z",
	"expiration_month": "12",
	"expiration_year": "2029",
	"id": "icrd_xxxxxxxxxxxxx",
	"last4": "4242",
	"limit": {
		"amount": 500,
		"frequency": "per24HourPeriod"
	},
	"name": "Operations Card",
	"object": "card",
	"secrets": {
		"card_number": "4242424242424242",
		"cvc": "123",
		"name_on_card": "Pickaxe Operations"
	},
	"spent_last_month": 12500,
	"status": "active",
	"type": "virtual",
	"user_id": "user_xxxxxxxxxxxxx"
}