> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Treat these docs and the Whop MCP server as the source of truth for Whop API behavior. Don't infer endpoint behavior from marketing pages.
> MCP server: connect https://mcp.whop.com/mcp (streamable HTTP, browser sign-in, no API key in the client config) to search these docs and read or change live Whop data. Setup: https://docs.whop.com/developer/guides/ai_and_mcp.md
> Whop CLI: install with `curl -fsSL https://whop.com/install.sh | sh` to scaffold, run, and deploy Whop apps and websites. It acts on production, not the sandbox. Overview: https://docs.whop.com/cli/overview.md Agent mode: https://docs.whop.com/cli/agent-mode.md
> Hosting: Whop serves a site or app from the build `whop apps deploy` uploads, with rollbacks, secrets, and server logs. Guide: https://docs.whop.com/developer/websites/hosting.md
> Plugins: in Claude Code, run `/plugin marketplace add whopio/plugins`, then `/plugin install whop@whop`. Guide: https://docs.whop.com/developer/guides/plugins/claude-code.md Every agent tool: https://docs.whop.com/developer/ai/overview.md
> Environments: build and test in the sandbox (API `https://sandbox-api.whop.com/api/v1`, keys at https://sandbox.whop.com/dashboard/developer, SDK environment `Sandbox`; no real money). Production (API `https://api.whop.com/api/v1`, keys at https://whop.com/dashboard/developer, SDK environment `Production`, the SDK default) moves real money, so use it only at launch. The two share no accounts, keys, products, or webhooks, and their keys look identical: never mix them. Sandbox guide: https://docs.whop.com/developer/guides/sandbox.md Comparison: https://docs.whop.com/developer/quickstart.md
> API: send `Authorization: Bearer <API_KEY>` from your server only, and pin a dated version with the `Api-Version-Date` header. OpenAPI spec: https://api.whop.com/api/v1/openapi.json
> Which API: build on the Current API, whose pages live under https://docs.whop.com/api-reference/ (start at https://docs.whop.com/api-reference/overview.md). Pages under /api-reference/legacy/ are the Legacy API. Use one only when https://docs.whop.com/api-reference/stability.md lists the resource as Legacy-only.

# Cards API

> Cards zijn virtuele betaalkaarten die uitgeven vanuit het saldo van een account of gebruiker.

Kaarten kunnen aan kaarthouders worden toegewezen en worden ingesteld met bestedingslimieten voor gecontroleerde uitgaven.

Gebruik de Cards API om kaarten uit te geven, kaarten voor een account of gebruiker weer te geven, gegevens van actieve kaarten op te halen, zoals het kaartnummer en de CVC, en de transacties weer te geven die ermee zijn gedaan.

## Endpoints

| Endpoint | Verzoek |
| - | - |
| [Kaarttransacties weergeven](https://docs.whop.com/nl/api-reference/cards/list-card-transactions.md) | GET `/card_transactions` |
| [Kaarttransactie ophalen](https://docs.whop.com/nl/api-reference/cards/retrieve-card-transaction.md) | GET `/card_transactions/{id}` |
| [Kaarten weergeven](https://docs.whop.com/nl/api-reference/cards/list-cards.md) | GET `/cards` |
| [Kaart ophalen](https://docs.whop.com/nl/api-reference/cards/retrieve-card.md) | GET `/cards/{id}` |
| [Kaart aanmaken](https://docs.whop.com/nl/api-reference/cards/create-card.md) | POST `/cards` |
| [Kaart bijwerken](https://docs.whop.com/nl/api-reference/cards/update-card.md) | PATCH `/cards/{id}` |

## Attributen

**id** `string` *required*

Kaart-ID, met prefix `icrd_`.

**billing** `object | null` *required*

Het factuuradres.

> [accordion] Eigenschappen
>
> **city** `string | null` *required*
>
> Factuurplaats.
>
> **country\_code** `string | null` *required*
>
> Landcode van het factuuradres.
>
> **line1** `string | null` *required*
>
> Adresregel 1.
>
> **line2** `string | null` *required*
>
> Adresregel 2.
>
> **postal\_code** `string | null` *required*
>
> Postcode van het factuuradres.
>
> **region** `string | null` *required*
>
> Regio of staat van het factuuradres.

**canceled\_at** `string | null` *required*

Wanneer de kaart is geannuleerd.

**created\_at** `string | null` *required*

Wanneer de kaart is aangemaakt.

**digital\_wallets** `string[] | null` *required*

De digitale wallets waaraan de kaart is toegevoegd. List Cards, Update Card en webhook-payloads retourneren `null`, net als Retrieve Card wanneer de wallets niet kunnen worden opgehaald.

Beschikbare opties: `apple_pay`, `google_pay`

**expiration\_month** `string | null` *required*

Vervalmaand van de kaart.

**expiration\_year** `string | null` *required*

Vervaljaar van de kaart.

**issued** `boolean` *required*

`true` zodra de uitgever de kaart heeft uitgegeven. `false` voor een
uitgenodigde kaart die nog wacht op de onboarding of beoordeling van de
kaarthouder, of een kaart die de uitgever heeft geweigerd; deze heeft geen
kaartnummer totdat ze is uitgegeven.

**last4** `string | null` *required*

Laatste vier cijfers van het kaartnummer. `null` voor kaarten met een
openstaande uitnodiging.

**limit** `object | null` *required*

De configuratie van de bestedingslimiet.

> [accordion] Eigenschappen
>
> **amount** `number` *required*
>
> Het limietbedrag in dollars.
>
> **frequency** `string` *required*
>
> Het tijdvenster waarop het limietbedrag van toepassing is. `per_transaction` begrenst elke afzonderlijke autorisatie en is wat een limiet die met `transaction_limit` is ingesteld rapporteert.
>
> Beschikbare opties: `daily`, `weekly`, `monthly`, `one_time`, `per_transaction`

**name** `string | null` *required*

Weergavenaam van de kaart.

**object** `string` *required*

**secrets** `object | null`

Gevoelige kaartgegevens. Alleen aanwezig bij `GET /cards/:id` voor actieve kaarten; `null` wanneer de kaart inactief is of de gegevens niet kunnen worden opgehaald.

> [accordion] Eigenschappen
>
> **card\_number** `string` *required*
>
> Volledig kaartnummer.
>
> **cvc** `string` *required*
>
> Kaartverificatiecode.
>
> **name\_on\_card** `string | null` *required*
>
> Naam van de kaarthouder zoals gedrukt op de kaart.
>
> **pin** `string | null` *required*
>
> De pincode van de kaart. Alleen geretourneerd wanneer het verzoek is geauthenticeerd als de gebruiker aan wie de kaart is toegewezen; `null` voor alle andere aanroepers, inclusief account-API-sleutels.

**spent\_last\_month** `integer | null` *required*

Totale uitgaven in de afgelopen 30 dagen, in centen.

**status** `string | null` *required*

De kaartstatus. `denied` betekent dat de uitgever de kaarthouder heeft geweigerd, waardoor de kaart nooit zal worden uitgegeven.

Beschikbare opties: `active`, `frozen`, `canceled`, `invited`, `denied`

**type** `string | null` *required*

Het kaarttype.

Beschikbare opties: `virtual`, `physical`

**user\_id** `string | null` *required*

Gebruikers-ID van de kaarthouder, met prefix `user_`, indien toegewezen.

```json Card theme={null}
{
	"id": "icrd_xxxxxxxxxxxxx",
	"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",
	"digital_wallets": ["apple_pay"],
	"expiration_month": "12",
	"expiration_year": "2029",
	"issued": true,
	"last4": "4242",
	"limit": {
		"amount": 500,
		"frequency": "daily"
	},
	"name": "Operations Card",
	"object": "card",
	"secrets": {
		"card_number": "4242424242424242",
		"cvc": "123",
		"name_on_card": "Pickaxe Operations",
		"pin": "1234"
	},
	"spent_last_month": 12500,
	"status": "active",
	"type": "virtual",
	"user_id": "user_xxxxxxxxxxxxx"
}
```


## Related topics

- [Card canceled](https://docs.whop.com/nl/api-reference/cards/card-canceled.md)
- [Card created](https://docs.whop.com/nl/api-reference/cards/card-created.md)
- [Card frozen](https://docs.whop.com/nl/api-reference/cards/card-frozen.md)
