Cards

Create Card

Changed on

Issues a virtual card, or applies for card issuing. An account with no application files one here and gets back a 202; call again to issue the card once it is approved.

post/cards

Request

  • Base URL: https://api.whop.com/api/v1
  • URL: https://api.whop.com/api/v1/cards
  • Auth: HTTP bearer

Headers

Idempotency-Keystring
Example:d9105228-4a08-46b1-8b91-42fed586d383

A unique key that makes this request safe to retry. See Idempotent requests.

Request body

account_idstring

The owning account ID (a biz_ identifier). Provide this or user_id.

assigned_user_idstring

The account member (a user_ identifier) to assign the card to. Required for business card issuing accounts, and whenever a company API key files an account's first card application.

namestring

A display name for the card.

spend_limitnumber

Spending limit amount, in dollars.

spend_limit_frequency'daily' | 'weekly' | 'monthly' | 'one_time'

The window the spend limit applies to.

transaction_limitnumber

Per-transaction limit amount, in dollars.

user_idstring

The owning user ID (a user_ identifier). Provide this or account_id.

Example request

{
  "account_id": "biz_xxxxxxxxxxxxxx",
  "assigned_user_id": "user_xxxxxxxxxxxxxx",
  "name": "Detailer card",
  "spend_limit": 500,
  "spend_limit_frequency": "weekly",
  "transaction_limit": 200,
  "user_id": "user_xxxxxxxxxxxxxx"
}

Response

card created

canceled_atstring date-time nullable required

When the card was canceled.

created_atstring date-time nullable required

When the card was created.

expiration_monthstring nullable required

Card expiration month.

expiration_yearstring nullable required

Card expiration year.

idstring required

Card ID, prefixed icrd_.

last4string nullable required

Last four digits of the card number. null for pending invitation cards.

namestring nullable required

Card display name.

object'card' required
spent_last_monthinteger nullable required

Total spend in the last 30 days, in cents.

status'null' | 'active' | 'frozen' | 'canceled' | 'invited' | 'denied' nullable required

The card status. denied means the issuer declined the cardholder, so the card will never be issued.

type'null' | 'virtual' | 'physical' nullable required

The card type.

user_idstring nullable required

Cardholder user ID, prefixed user_, when assigned.

Example response

{
  "billing": {
    "city": "Austin",
    "country_code": "US",
    "line1": "4180 Burnet Rd",
    "line2": "Suite 210",
    "postal_code": "78756",
    "region": "TX"
  },
  "created_at": "2026-01-01T12:00:00.000Z",
  "expiration_month": "12",
  "expiration_year": "2030",
  "id": "icrd_xxxxxxxxxxxxxx",
  "last4": "4242",
  "limit": {
    "amount": 2500,
    "frequency": "monthly"
  },
  "name": "Detailing supplies",
  "object": "card",
  "status": "active",
  "type": "virtual",
  "user_id": "user_xxxxxxxxxxxxxx"
}

Changes

  • a84d4905fdbbRevision changes
    • breaking

      added subschema #1 subschema #2 subschema #3 to the response body oneOf list for the response status

    • info

      removed subschema #1 subschema #2 subschema #3 from the response body oneOf list for the response status

  • f1020c3ecda4Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status