> ## 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 repræsenterer virtuelle betalingskort, der bruger af en konto- eller brugersaldo.

Kort kan tildeles kortholdere og konfigureres med forbrugsgrænser for kontrolleret forbrug.

Brug Cards API'et til at udstede kort, liste kort for en konto eller bruger, hente aktive kortoplysninger såsom kortnummer og CVC og liste de transaktioner, der er foretaget med dem.

## Endpoints

| Endpoint | Anmodning |
| - | - |
| [List korttransaktioner](https://docs.whop.com/da/api-reference/cards/list-card-transactions.md) | GET `/card_transactions` |
| [Hent korttransaktion](https://docs.whop.com/da/api-reference/cards/retrieve-card-transaction.md) | GET `/card_transactions/{id}` |
| [List kort](https://docs.whop.com/da/api-reference/cards/list-cards.md) | GET `/cards` |
| [Hent kort](https://docs.whop.com/da/api-reference/cards/retrieve-card.md) | GET `/cards/{id}` |
| [Opret kort](https://docs.whop.com/da/api-reference/cards/create-card.md) | POST `/cards` |
| [Opdater kort](https://docs.whop.com/da/api-reference/cards/update-card.md) | PATCH `/cards/{id}` |

## Attributter

**id** `string` *required*

Kort-ID med præfikset `icrd_`.

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

Faktureringsadressen.

> [accordion] Egenskaber
>
> **city** `string | null` *required*
>
> Faktureringsby.
>
> **country\_code** `string | null` *required*
>
> Faktureringslandekode.
>
> **line1** `string | null` *required*
>
> Adresselinje 1.
>
> **line2** `string | null` *required*
>
> Adresselinje 2.
>
> **postal\_code** `string | null` *required*
>
> Faktureringspostnummer.
>
> **region** `string | null` *required*
>
> Faktureringsregion eller -stat.

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

Hvornår kortet blev annulleret.

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

Hvornår kortet blev oprettet.

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

De digitale tegnebøger, kortet er blevet tilføjet til. List Cards, Update Card og webhook-payloads returnerer `null`, ligesom Retrieve Card, når tegnebøgerne ikke kan hentes.

Tilgængelige muligheder: `apple_pay`, `google_pay`

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

Kortets udløbsmåned.

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

Kortets udløbsår.

**issued** `boolean` *required*

`true`, når udstederen har udstedt kortet. `false` for et inviteret kort, der stadig venter på kortholderens onboarding eller gennemgang, eller et, som udstederen har afvist; det har intet kortnummer, før det er udstedt.

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

Sidste fire cifre i kortnummeret. `null` for kort med afventende invitation.

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

Konfigurationen af forbrugsgrænsen.

> [accordion] Egenskaber
>
> **amount** `number` *required*
>
> Grænsebeløbet i dollars.
>
> **frequency** `string` *required*
>
> Det vindue, grænsebeløbet gælder for. `per_transaction` begrænser hver enkelt autorisation og er det, en grænse sat med `transaction_limit` rapporterer.
>
> Tilgængelige muligheder: `daily`, `weekly`, `monthly`, `one_time`, `per_transaction`

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

Kortets visningsnavn.

**object** `string` *required*

**secrets** `object | null`

Følsomme kortoplysninger. Kun til stede på `GET /cards/:id` for aktive kort; `null`, når kortet er inaktivt, eller oplysningerne ikke kan hentes.

> [accordion] Egenskaber
>
> **card\_number** `string` *required*
>
> Fuldt kortnummer.
>
> **cvc** `string` *required*
>
> Kortets verifikationskode.
>
> **name\_on\_card** `string | null` *required*
>
> Kortholderens navn trykt på kortet.
>
> **pin** `string | null` *required*
>
> Kortets PIN-kode. Returneres kun, når anmodningen er godkendt som den bruger, kortet er tildelt; `null` for alle andre kaldere, herunder konto-API-nøgler.

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

Samlet forbrug de seneste 30 dage i cents.

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

Kortets status. `denied` betyder, at udstederen har afvist kortholderen, så kortet aldrig vil blive udstedt.

Tilgængelige muligheder: `active`, `frozen`, `canceled`, `invited`, `denied`

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

Korttypen.

Tilgængelige muligheder: `virtual`, `physical`

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

Kortholderens bruger-ID med præfikset `user_`, når tildelt.

```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/da/api-reference/cards/card-canceled.md)
- [Card created](https://docs.whop.com/da/api-reference/cards/card-created.md)
- [Card frozen](https://docs.whop.com/da/api-reference/cards/card-frozen.md)
