> ## 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.

# Accounts API

> Een Account vertegenwoordigt een persoon of bedrijf op Whop met een eigen profiel, wallet en accountgebonden instellingen.

Gebruik accounts voor klanten, creators, merchants, verkopers of gekoppelde bedrijven die je integratie ondersteunt.

Gebruik de Accounts API om accounts aan te maken, accounts weer te geven die zichtbaar zijn voor je inloggegevens, een account op te halen of bij te werken, een subaccount dat door je platform wordt beheerd te schorsen of te verwijderen, en het account op te halen dat bij de huidige API-sleutel hoort.

De velden `business_type`, `industry_group` en `industry_type` classificeren accounts. Zie de [woordenlijst met bedrijfstypen en branches](#business-types-and-industries) voor alle geldige waarden.

## Endpoints

| Endpoint | Request |
| - | - |
| [List Accounts](https://docs.whop.com/nl/api-reference/accounts/list-accounts.md) | GET `/accounts` |
| [Retrieve Account](https://docs.whop.com/nl/api-reference/accounts/retrieve-account.md) | GET `/accounts/{id}` |
| [Retrieve Account Customer Tracking](https://docs.whop.com/nl/api-reference/accounts/retrieve-account-customer-tracking.md) | GET `/accounts/{account_id}/customer_tracking` |
| [Retrieve Account Fees](https://docs.whop.com/nl/api-reference/accounts/retrieve-account-fees.md) | GET `/accounts/{account_id}/fees` |
| [List Financing Providers](https://docs.whop.com/nl/api-reference/accounts/list-financing-providers.md) | GET `/accounts/{account_id}/financing_providers` |
| [Retrieve Account Preferences](https://docs.whop.com/nl/api-reference/accounts/retrieve-account-preferences.md) | GET `/accounts/{account_id}/preferences` |
| [List Account Reserves](https://docs.whop.com/nl/api-reference/accounts/list-account-reserves.md) | GET `/accounts/{account_id}/reserves` |
| [Create Account](https://docs.whop.com/nl/api-reference/accounts/create-account.md) | POST `/accounts` |
| [Form Company](https://docs.whop.com/nl/api-reference/accounts/form-company.md) | POST `/accounts/{id}/form_company` |
| [Retry Failed Ads Payments](https://docs.whop.com/nl/api-reference/accounts/retry-failed-ads-payments.md) | POST `/accounts/{id}/retry_ads_payment` |
| [Suspend a Subaccount](https://docs.whop.com/nl/api-reference/accounts/suspend-a-subaccount.md) | POST `/accounts/{id}/suspend` |
| [Transfer Account Ownership](https://docs.whop.com/nl/api-reference/accounts/transfer-account-ownership.md) | POST `/accounts/{id}/transfer_ownership` |
| [Update Account](https://docs.whop.com/nl/api-reference/accounts/update-account.md) | PATCH `/accounts/{id}` |
| [Update Account Fees](https://docs.whop.com/nl/api-reference/accounts/update-account-fees.md) | PATCH `/accounts/{account_id}/fees` |
| [Update Account Preferences](https://docs.whop.com/nl/api-reference/accounts/update-account-preferences.md) | PATCH `/accounts/{account_id}/preferences` |
| [Delete a Subaccount](https://docs.whop.com/nl/api-reference/accounts/delete-a-subaccount.md) | DELETE `/accounts/{id}` |

## Opslagen op kosten

Met opslagen op kosten kan een platform kosten toevoegen of uitbetalingskosten subsidiëren voor de subaccounts. Beheer ze via het kostendocument van het account: stel standaarden in op het platformaccount of overschrijf afzonderlijke kosten op een subaccount. Zie [Opslagen en subsidies op kosten](https://docs.whop.com/nl/developer/platforms/fee-markups.md) voor voorbeelden, limieten en financieringsvereisten.

### Kosten-endpoints

| Actie | Endpoint | SDK-methode |
| - | - | - |
| [Accountkosten ophalen](https://docs.whop.com/nl/api-reference/accounts/retrieve-account-fees.md) | `GET /api/v1/accounts/{account_id}/fees` | `client.accounts.fees.retrieve(accountId)` |
| [Accountkosten bijwerken](https://docs.whop.com/nl/api-reference/accounts/update-account-fees.md) | `PATCH /api/v1/accounts/{account_id}/fees` | `client.accounts.fees.update(accountId, changes)` |

Gebruik de API-sleutel van het platformaccount met de machtiging `company:update_child_fees` om opslagen te configureren. Elke geretourneerde opslag bevat `adjustable` en `unadjustable_reason`, zodat je integratie kan bepalen of bewerken mogelijk is.

### Kosten lezen

```typescript theme={null}
const fees = await client.accounts.fees.retrieve("biz_connected_account");
```

De sectie `markups` bevat de effectieve tarieven van het subaccount. De sectie `child_markups` op een platformaccount bevat de standaarden voor subaccounts.

De `source` van een opslag is `custom` wanneer deze op dat niveau is geconfigureerd, of `default` wanneer deze terugvalt op een overgenomen tarief of nul. Het veld `default` toont het tarief dat zou gelden als de aangepaste opslag werd gewist. Geretourneerde vaste bedragen gebruiken het Money-object; updates accepteren `fixed` als getal in Amerikaanse dollars.

### Platformstandaarden instellen

Werk `child_markups` bij op het platformaccount. Dit voorbeeld stelt een betalingsopslag van 2% in zonder vaste kosten:

```typescript theme={null}
await client.accounts.fees.update("biz_platform_id", {
	child_markups: { payments: { percentage: 2, fixed: 0 } },
});
```

`percentage: 2` betekent 2%. Standaarden gelden voor subaccounts zonder overschrijving voor die kosten. Betalingsopslagen gelden wanneer er geen applicatiekosten voor de checkout zijn ingesteld.

### Een overschrijving voor een subaccount instellen

Werk `markups` bij op het subaccount. Dit voorbeeld vervangt de overgenomen betalingsopslag door 1% plus \$0.25:

```typescript theme={null}
await client.accounts.fees.update("biz_connected_account", {
	markups: { payments: { percentage: 1, fixed: 0.25 } },
});
```

Alleen de keys die je verstuurt worden gewijzigd. Gebruik voor andere transactietypen `transfers`, `crypto_swaps`, `deposits` per rail, of `payouts` per uitbetalingsmethode. Zie het [update-endpoint](https://docs.whop.com/nl/api-reference/accounts/update-account-fees.md) voor de ondersteunde keys en het request-schema.

### Een opslag wissen

Stuur `null` voor de opslag om deze te wissen. Als je de overschrijving van een subaccount wist, wordt de platformstandaard hersteld, of nul als er geen standaard is geconfigureerd:

```typescript theme={null}
await client.accounts.fees.update("biz_connected_account", {
	markups: { payments: null },
});
```

Om een platformstandaard te wissen, stuur je `child_markups: { payments: null }` naar het platformaccount. Een expliciete `{ percentage: 0, fixed: 0 }` blijft een geconfigureerd tarief; gebruik `null` om overerving te herstellen.

## Juridische documenten

Een account publiceert de juridische documenten als pdf-bestanden: `terms_of_service`, `privacy_policy`, `return_policy`, `cancellation_policy`, `shipping_policy` en `eula`. Elk wordt teruggelezen als een [File](https://docs.whop.com/nl/api-reference/files/file) en wordt ingesteld via [Update Account](https://docs.whop.com/nl/api-reference/accounts/update-account.md) met de `id` van een bestand dat je hebt [geüpload](https://docs.whop.com/nl/developer/guides/upload-files.md).

Nieuwe geschillen nemen standaard hun beleidsbewijs over uit deze documenten. Het vak voor het annuleringsbeleid gebruikt `cancellation_policy`, dan `terms_of_service`, dan `return_policy`. Het vak voor het terugbetalingsbeleid gebruikt `return_policy`, dan `terms_of_service`. Beide vakken vallen terug op het platformbeleid van Whop wanneer er niets is ingesteld, en `shipping_policy` gaat mee bij geschillen over fysieke goederen. Stel ze hier één keer in en gebruik [Upload Dispute Evidence](https://docs.whop.com/nl/api-reference/disputes/upload-dispute-evidence.md) alleen wanneer één geschil een andere versie van een beleid nodig heeft.

```typescript TypeScript theme={null}
import { readFile } from "node:fs/promises";

const file = await client.files.create({ filename: "terms-of-service.pdf" });
await fetch(file.upload_url!, {
	method: "PUT",
	headers: file.upload_headers as Record<string, string>,
	body: await readFile("./terms-of-service.pdf"),
});

await client.accounts.update({
	id: "biz_xxxxxxxxxxxxx",
	terms_of_service: { id: file.id },
});
```

```python Python theme={null}
import requests

file = client.files.create(filename="terms-of-service.pdf")
with open("./terms-of-service.pdf", "rb") as contents:
    requests.put(file.upload_url, headers=file.upload_headers or {}, data=contents)

client.accounts.update(
    "biz_xxxxxxxxxxxxx",
    terms_of_service={"id": file.id},
)
```

Stuur `null` voor een document om het te verwijderen. Alleen pdf-bestanden worden geaccepteerd.

## Eigenschappen

**id** `string` *required*

Account-ID, met prefix `biz_`.

**ads\_spend\_usd** `number | null` *required*

Totale in rekening gebrachte advertentie-uitgaven van het account, in USD. Alleen berekend bij `list` voor aanroepers met `stats:read` op het account; anders `null`.

**balances** `object[]` *required*

Tegoeden van het account, elk met een waarde in USD. Leeg wanneer `total_usd` `null` is.

> [accordion] Eigenschappen
>
> **balance** `string` *required*
>
> Totaal aangehouden bedrag in native eenheden, als decimale string.
>
> **breakdown** `object` *required*
>
> Saldo uitgesplitst in beschikbare, lopende en gereserveerde bedragen, als decimale strings in native eenheden, met de dagen waarop het lopende bedrag naar verwachting wordt verrekend.
>
> > [accordion] Eigenschappen
> >
> > **available** `string` *required*
> >
> > Bedrag dat je nu kunt uitgeven, versturen of opnemen, in native eenheden, als decimale string.
> >
> > **finishing\_settlement** `string` *required*
> >
> > Het deel van `pending` dat al is verrekend en wacht om naar de crypto-wallet of Whop Card van het account te worden verplaatst, waar het `available` wordt. De verplaatsing begint meestal binnen een uur; zolang die loopt, wordt het bedrag in plaats daarvan in `in_transit` gerapporteerd. Geld dat alleen wordt verplaatst om het aangehouden minimumsaldo van het account aan te vullen, is niet inbegrepen. In native eenheden, als decimale string.
> >
> > **in\_transit** `string` *required*
> >
> > Bedrag dat wordt verplaatst tussen de eigen bestemmingen van het account, zoals het opwaarderen van een kaart. In native eenheden, als decimale string.
> >
> > **pending** `string` *required*
> >
> > Bedrag uit recente betalingen dat nog wordt verrekend, in native eenheden, als decimale string.
> >
> > **pending\_settlements** `object[]` *required*
> >
> > Wanneer het lopende bedrag naar verwachting wordt verrekend, één item per dag, vroegste eerst. Geld zonder geplande verrekeningsdag, inclusief `finishing_settlement`, wordt weggelaten, dus deze items plus `finishing_settlement` kunnen samen minder zijn dan `pending`, maar nooit meer.
> >
> > > [accordion] Eigenschappen
> > >
> > > **amount** `string` *required*
> > >
> > > Bedrag dat die dag wordt verwacht, in native eenheden, als decimale string.
> > >
> > > **date** `string` *required*
> > >
> > > De dag waarop dit geld naar verwachting volledig is verrekend, als ISO 8601-datum.
> >
> > **reserve** `string` *required*
> >
> > Ingehouden bedrag, in native eenheden, als decimale string. Haal de reserves van het account op om te zien waarom het wordt ingehouden en wanneer het vrijkomt.
>
> **icon\_url** `string | null` *required*
>
> URL van het pictogram van het tegoed.
>
> **name** `string` *required*
>
> De weergavenaam van het tegoed
>
> **price\_usd** `number | null` *required*
>
> USD-prijs per eenheid, of `null` wanneer er geen wisselkoers beschikbaar is.
>
> **symbol** `string` *required*
>
> Weergavesymbool van het tegoed, zoals `USDT`, `cbBTC` of `EUR`.
>
> **value\_usd** `string | null` *required*
>
> USD-waarde van het tegoed, of `null` wanneer er geen wisselkoers beschikbaar is.

**banner\_image\_url** `string | null` *required*

URL van de bannerafbeelding van het account.

**business\_address** `object | null` *required*

Zakelijk adres van het account dat wordt gebruikt om belasting te berekenen, met `line1`, `line2`, `city`, `state`, `postal_code` en `country`. `null` wanneer er geen adres is ingesteld.

**business\_name** `string | null` *required*

De wettelijke bedrijfsnaam van het account die samen met het belastingadres wordt gebruikt.

**business\_type** `string | null` *required*

Algemene bedrijfscategorie van het account. Zie de [woordenlijst met bedrijfstypen en branches](https://docs.whop.com/nl/api-reference/accounts/account#business-types-and-industries-glossary) voor geldige waarden.

**can\_transfer\_pending\_balance\_to\_children** `boolean` *required*

Of lopende tegoeden van dit platformaccount naar de subaccounts mogen worden overgemaakt.

**cancellation\_policy** `object | null` *required*

Het annuleringsbeleid van het account, of `null` als het account er geen heeft gepubliceerd.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van het bestand, met prefix `file_`.
>
> **blurhash** `string | null` *required*
>
> BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **content\_type** `string | null` *required*
>
> Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Dit blijft behouden wanneer moderatie het bestand verwijdert.
>
> **created\_at** `string` *required*
>
> Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
>
> **duration\_seconds** `number | null` *required*
>
> Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **filename** `string | null` *required*
>
> De oorspronkelijke bestandsnaam, inclusief extensie.
>
> **height** `integer | null` *required*
>
> Hoogte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **multipart\_chunk\_size** `integer | null`
>
> De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_id** `string | null`
>
> De ID van de multipart-upload, die wordt teruggegeven aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_urls** `object[] | null`
>
> De presigned URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> > [accordion] Eigenschappen
> >
> > **part\_number** `integer` *required*
> >
> > De index (beginnend bij 1) van dit deel binnen de multipart-upload.
> >
> > **url** `string` *required*
> >
> > De presigned URL waarnaar je de bytes van dit deel met PUT verstuurt.
>
> **object** `string` *required*
>
> Het type van dit object, altijd `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Of moderatie het bestand heeft verwijderd. Wanneer `true`, levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.
>
> **size** `integer | null` *required*
>
> De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
>
> **upload\_headers** `object`
>
> Headers die met de upload-PUT moeten worden meegestuurd. Alleen aanwezig bij aanmaken.
>
> **upload\_status** `string` *required*
>
> Waar het bestand zich in de uploadlevenscyclus bevindt.
>
> Beschikbare opties: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> Presigned URL waarnaar je de bytes van het bestand met PUT verstuurt. Alleen aanwezig bij aanmaken, en alleen voor uploads uit één deel.
>
> **url** `string | null` *required*
>
> Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
>
> **visibility** `string` *required*
>
> `public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.
>
> Beschikbare opties: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **width** `integer | null` *required*
>
> Breedte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

**capabilities** `object | null` *required*

Betaalrails die voor dit account zijn ingeschakeld, elk `active`, `inactive` of `pending` (onboarding of beoordeling bezig). Alleen berekend bij `retrieve` en `me` voor aanroepers met de scope `company:balance:read`; anders `null`.

> [accordion] Eigenschappen
>
> **accept\_bank\_payments** `string` *required*
>
> Bankbetalingen: incasso's, overboekingen en lokale bankrails
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **accept\_bnpl\_payments** `string` *required*
>
> Betalingen via achteraf betalen (buy now, pay later); vereist goedkeuring
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **accept\_card\_payments** `string` *required*
>
> Kaartbetalingen, inclusief Apple Pay en Google Pay
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **bank\_deposit** `string` *required*
>
> Stortingen via bankoverschrijving of ACH op de virtuele bankrekening van het account
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **card\_deposit** `string` *required*
>
> Saldo-opwaarderingen door een opgeslagen betaalmethode te belasten
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **card\_issuing** `string` *required*
>
> Uitgifte van Whop-kaarten; vereist goedkeuring van de kaartaanvraag
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **crypto\_deposit** `string` *required*
>
> On-chain stortingen naar de crypto-wallet van het account
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **crypto\_payout** `string` *required*
>
> On-chain uitbetalingen naar een crypto-wallet
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **instant\_payout** `string` *required*
>
> Directe uitbetalingen naar een geschikte uitbetalingsbestemming
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **run\_ads** `string` *required*
>
> Advertentiecampagnes lanceren via Whop Ads. `inactive` totdat de identiteit of het bedrijf van het account is geverifieerd, zolang een aangevraagde overeenkomst voor advertentiediensten wacht op de handtekening van het account, en zolang het account is geschorst van Whop Ads.
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **standard\_payout** `string` *required*
>
> Standaarduitbetalingen naar een externe uitbetalingsbestemming
>
> Beschikbare opties: `active`, `inactive`, `pending`
>
> **transfer** `string` *required*
>
> Overboekingen naar andere accounts
>
> Beschikbare opties: `active`, `inactive`, `pending`

**cards** `object | null` *required*

Gegevens van de Whop Cards-aanvraag voor het account. Geretourneerd bij `list`, `retrieve` en `me` voor aanroepers met de scope `company:balance:read`; anders `null`, of wanneer het account geen kaartaanvraag of blokkerende aanvraagbeoordeling heeft.

> [accordion] Eigenschappen
>
> **decline\_reason** `string | null` *required*
>
> Reden waarom de kaartuitgever de aanvraag heeft afgewezen. `unsupported_state` vervangt `unsupported_region` voor een geverifieerde persoon of een geverifieerd bedrijf in de Verenigde Staten. `compliance` omvat controles op sancties, politiek prominente personen en negatieve media. `other` omvat redenen die niet in deze lijst staan. `null` wanneer `status` niet `denied` is, of wanneer de uitgever de aanvraag niet heeft afgewezen.
>
> Beschikbare opties: `compromised_identity`, `duplicate`, `unsupported_region`, `compliance`, `fraud`, `verification_failed`, `unsupported_state`, `other`
>
> **kind** `string | null` *required*
>
> Of de kaartaanvraag een bedrijf (`business`, KYB) of een persoon (`individual`, consumentenidentiteit) verifieert. `null` wanneer de aanvraag nog niet aan een verificatie is gekoppeld.
>
> Beschikbare opties: `individual`, `business`
>
> **status** `string` *required*
>
> De status van de kaartaanvraag. `approved` betekent dat er kaarten kunnen worden uitgegeven. `needs_verification` betekent dat de aanvrager de identiteitsverificatie nog niet heeft voltooid; `needs_information` betekent dat dit wel is gebeurd, maar dat de documenten om een herstelbare reden zijn afgewezen en opnieuw moeten worden ingediend. `pending` en `manual_review` zijn in behandeling. `denied`, `locked` en `canceled` zijn definitief.
>
> Beschikbare opties: `approved`, `pending`, `manual_review`, `denied`, `locked`, `canceled`, `needs_verification`, `needs_information`

**collect\_vat\_id** `boolean` *required*

Of de checkout een veld voor een btw-/belasting-ID toont dat kopers optioneel kunnen invullen. Een btw-ID is niet vereist om een aankoop te doen.

**company\_formation** `object` *required*

Status van de bedrijfsoprichting voor het account, beheerd via [Form Company](https://docs.whop.com/nl/api-reference/accounts/form-company.md). Een `status` van `draft` totdat de checkout voor de oprichting is betaald, daarna de voortgang van de registratie met downloadbare documenten en handtekeningen die op actie wachten. Leeg wanneer de oprichtingsstatus tijdelijk niet beschikbaar is.

> [accordion] Eigenschappen
>
> **documents** `object[]`
>
> Oprichtingsdocumenten die beschikbaar zijn om te downloaden, zoals de Articles of Organization en de EIN-bevestigingsbrief. Aanwezig zodra `status` niet meer `draft` is.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Document-ID, met prefix `file_`.
> >
> > **name** `string` *required*
> >
> > Leesbare documentnaam, zoals `Articles of Organization`.
> >
> > **type** `string` *required*
> >
> > Documentcategorie: `articles_of_organization`, `operating_agreement`, `ein_letter`, `signed_ss4`, `signed_form8821` of `mail` voor post die namens het bedrijf is ontvangen.
> >
> > **url** `string` *required*
> >
> > CDN-URL om het document te downloaden.
>
> **ein\_registered** `boolean`
>
> Of de EIN van het bedrijf door de IRS is uitgegeven. Aanwezig zodra `status` niet meer `draft` is.
>
> **legal\_name** `string | null`
>
> Geregistreerde bedrijfsnaam inclusief de rechtsvormaanduiding, bijvoorbeeld `Acme, LLC`. Aanwezig zodra `status` niet meer `draft` is.
>
> **signatures** `object`
>
> IRS-formulieren die nog wachten op de handtekening van een oprichter, elk met een gehoste ondertekenings-URL. Aanwezig zodra `status` niet meer `draft` is; leeg wanneer er niets hoeft te worden ondertekend.
>
> > [accordion] Eigenschappen
> >
> > **form8821** `object`
> >
> > Ondertekeningsstatus van IRS-formulier 8821, de machtiging voor belastinginformatie. Alleen aanwezig zolang het formulier nog actie van de oprichter vereist.
> >
> > > [accordion] Eigenschappen
> > >
> > > **expires\_at** `string`
> > >
> > > Wanneer de ondertekenings-URL verloopt, als ISO 8601-tijdstempel. Alleen aanwezig wanneer de ondertekenings-URL is opgenomen.
> > >
> > > **status** `string` *required*
> > >
> > > `pending` wanneer een ondertekeningssessie klaarstaat voor de oprichter; `unknown` wanneer de ondertekeningsstatus niet kon worden bepaald.
> > >
> > > Beschikbare opties: `pending`, `unknown`
> > >
> > > **url** `string`
> > >
> > > Gehoste ondertekenings-URL waar de oprichter het formulier invult. Aanwezig zolang `status` `pending` is en de aanroeper `incorporation:write` heeft. Weggelaten uit webhooks.
> >
> > **ss4** `object`
> >
> > Ondertekeningsstatus van IRS-formulier SS-4, de EIN-aanvraag. Alleen aanwezig zolang het formulier nog actie van de oprichter vereist.
> >
> > > [accordion] Eigenschappen
> > >
> > > **expires\_at** `string`
> > >
> > > Wanneer de ondertekenings-URL verloopt, als ISO 8601-tijdstempel. Alleen aanwezig wanneer de ondertekenings-URL is opgenomen.
> > >
> > > **status** `string` *required*
> > >
> > > `pending` wanneer een ondertekeningssessie klaarstaat voor de oprichter; `unknown` wanneer de ondertekeningsstatus niet kon worden bepaald.
> > >
> > > Beschikbare opties: `pending`, `unknown`
> > >
> > > **url** `string`
> > >
> > > Gehoste ondertekenings-URL waar de oprichter het formulier invult. Aanwezig zolang `status` `pending` is en de aanroeper `incorporation:write` heeft. Weggelaten uit webhooks.
>
> **state\_registered** `boolean`
>
> Of de registratie van de oprichting bij de staat is voltooid. Aanwezig zodra `status` niet meer `draft` is.
>
> **status** `string`
>
> Beschikbare opties: `draft`, `processing`, `filed`, `rejected`, `completed`

**country** `string | null` *required*

Land waar het account is gevestigd.

**created\_at** `string` *required*

Wanneer het account is aangemaakt, als ISO 8601-tijdstempel.

**customers\_l30d** `integer | null` *required*

Unieke klanten met een betaald ontvangstbewijs bij het account in de afgelopen 30 dagen, elke paar uur vernieuwd. Alleen berekend bij `retrieve` voor aanroepers met `stats:read` op het account; anders `null`, en ook wanneer het aantal niet beschikbaar is.

**description** `string | null` *required*

Promotionele beschrijving van het account.

**direct\_reports\_count** `integer`

Hoeveel teamleden rechtstreeks aan het bedrijf rapporteren, zonder manager boven zich. Aanwezig bij het lezen van een enkel account.

**dispute\_fighter\_enabled** `boolean` *required*

Of Whop bewijs voor geschillen verzamelt en indient voor dit account. Door dit in te schakelen kiest het account voor de succesvergoeding die wordt gerekend over gewonnen geschillen.

**economic\_intelligence** `boolean` *required*

Of Economic Intelligence is ingeschakeld voor het account. Het wordt automatisch uitgeschakeld wanneer de vastgelegde periode afloopt. Zolang het is uitgeschakeld, kan het account geen experiment activeren of een aanbeveling uitvoeren.

**email** `string | null` *required*

E-mailadres van de accounteigenaar.

**eula** `object | null` *required*

De licentieovereenkomst voor eindgebruikers (EULA) van het account, of `null` als het account er geen heeft gepubliceerd.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van het bestand, met prefix `file_`.
>
> **blurhash** `string | null` *required*
>
> BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **content\_type** `string | null` *required*
>
> Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Dit blijft behouden wanneer moderatie het bestand verwijdert.
>
> **created\_at** `string` *required*
>
> Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
>
> **duration\_seconds** `number | null` *required*
>
> Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **filename** `string | null` *required*
>
> De oorspronkelijke bestandsnaam, inclusief extensie.
>
> **height** `integer | null` *required*
>
> Hoogte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **multipart\_chunk\_size** `integer | null`
>
> De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_id** `string | null`
>
> De ID van de multipart-upload, die wordt teruggegeven aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_urls** `object[] | null`
>
> De presigned URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> > [accordion] Eigenschappen
> >
> > **part\_number** `integer` *required*
> >
> > De index (beginnend bij 1) van dit deel binnen de multipart-upload.
> >
> > **url** `string` *required*
> >
> > De presigned URL waarnaar je de bytes van dit deel met PUT verstuurt.
>
> **object** `string` *required*
>
> Het type van dit object, altijd `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Of moderatie het bestand heeft verwijderd. Wanneer `true`, levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.
>
> **size** `integer | null` *required*
>
> De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
>
> **upload\_headers** `object`
>
> Headers die met de upload-PUT moeten worden meegestuurd. Alleen aanwezig bij aanmaken.
>
> **upload\_status** `string` *required*
>
> Waar het bestand zich in de uploadlevenscyclus bevindt.
>
> Beschikbare opties: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> Presigned URL waarnaar je de bytes van het bestand met PUT verstuurt. Alleen aanwezig bij aanmaken, en alleen voor uploads uit één deel.
>
> **url** `string | null` *required*
>
> Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
>
> **visibility** `string` *required*
>
> `public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.
>
> Beschikbare opties: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **width** `integer | null` *required*
>
> Breedte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

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

De eigen identifier van het bovenliggende platform voor dit subaccount, uniek binnen de subaccounts van het platform. `null` wanneer niet ingesteld.

**financing** `object | null` *required*

De meest recente financieringsaanvraag van het account. Alleen berekend bij `retrieve` en `me` voor aanroepers met de scope `company:balance:read`; anders `null`, of wanneer het account nooit financiering heeft aangevraagd.

> [accordion] Eigenschappen
>
> **application\_id** `string` *required*
>
> De ID van de meest recente financieringsaanvraag van het account, beginnend met inrq\_. Haal deze op voor vereisten en feedback op de beoordeling.
>
> **status** `string` *required*
>
> De beoordelingsstatus van de meest recente financieringsaanvraag: `requires_collection` (wacht op de verkoper, ook na een verzoek om meer informatie), `awaiting_review`, `approved`, `denied` of `completed`. Of financieringsbetaalmethoden zijn ingeschakeld, staat in `capabilities.accept_bnpl_payments`.
>
> Beschikbare opties: `requires_collection`, `awaiting_review`, `completed`, `approved`, `denied`

**funds\_release\_at** `string | null` *required*

Wanneer een geschorst account het saldo kan uitbetalen naar de eigen uitbetalingsmethode, als ISO 8601-tijdstempel. Een geschil kan dit moment uitstellen. Berekend bij `retrieve`, `me` en `suspend`; anders `null`, wanneer `status` niet `suspended` is, en wanneer de schorsing het saldo vasthoudt.

**home\_preferences** `string[]` *required*

Voorkeuren voor de openbare startpagina van het account.

Beschikbare opties: `hide_member_count`, `hide_members_card`

**industry\_type** `string | null` *required*

Specifieke branche van het account. Zie de [woordenlijst met bedrijfstypen en branches](https://docs.whop.com/nl/api-reference/accounts/account#business-types-and-industries-glossary) voor geldige waarden.

**invoice\_prefix** `string | null` *required*

Prefix dat wordt gebruikt voor facturen van het account.

**level** `object | null` *required*

De voortgang in Whop Levels van de `owner` van het account, geteld over alle accounts die deze persoon bezit, zodat ze allemaal hetzelfde level tonen. Alleen berekend bij `retrieve` en `me` voor aanroepers met de scope `company:basic:read`; anders `null`, en ook wanneer het account niet deelneemt aan Whop Levels.

> [accordion] Eigenschappen
>
> **account\_level** `integer` *required*
>
> Het eigen level van dit account op basis van alleen de eigen punten, van `0` tot `10`. `current` is hoger wanneer de andere accounts van de eigenaar het optillen.
>
> **current** `integer` *required*
>
> Het level dat van toepassing is: het hoogste dat de eigenaar deze maand of in de 5 maanden ervoor heeft bereikt, van `0` tot `10`.
>
> **points** `integer` *required*
>
> Punten die deze maand zijn verdiend over alle accounts van de eigenaar, plus de partnerpunten van de eigenaar, naar beneden afgerond. Een account met een netto negatieve maand telt als nul.
>
> **points\_by\_source** `object` *required*
>
> De punten van deze maand, uitgesplitst naar waar ze zijn verdiend. Elke bron is verrekend met de eigen terugbetalingen, dus een bron kan negatief zijn.
>
> > [accordion] Eigenschappen
> >
> > **ads** `integer` *required*
> >
> > Punten uit betaalde Whop Ads-kosten, na aftrek van terugbetalingen: 10 voor elke dollar, afgerond richting nul.
> >
> > **cards** `integer` *required*
> >
> > Punten uit vastgelegde uitgaven met de Whop Card, na aftrek van terugbetalingen: 10 voor elke dollar, afgerond richting nul.
> >
> > **partners** `integer` *required*
> >
> > Punten uit accounts die de eigenaar als partner heeft doorverwezen: 1 voor elke 3 die zij verdienen, afgerond richting nul.
> >
> > **trading** `integer` *required*
> >
> > Punten uit handelsvolume in perpetuals dat via Whop is uitgevoerd: 1 voor elke verhandelde dollar, afgerond richting nul.
>
> **resets\_at** `string` *required*
>
> Wanneer de punten van deze maand worden teruggezet naar nul, als ISO 8601-tijdstempel.

**logo\_url** `string | null` *required*

URL van de logoafbeelding van het account.

**metadata** `object` *required*

Willekeurige key/value-metadata die bij het aanmaken van het account is opgegeven.

**onboarding\_type** `string | null` *required*

Type onboarding dat het account heeft voltooid.

Beschikbare opties: `platform`, `seller`

**opengraph\_image\_url** `string | null` *required*

URL van de Open Graph-afbeelding van het account.

**opengraph\_image\_variant** `string | null` *required*

Variant van de Open Graph-afbeelding van het account.

Beschikbare opties: `white`, `black`, `orange`

**orchestration\_enabled** `boolean` *required*

Of betalingsorkestratie is ingeschakeld voor dit account.

**other\_business\_description** `string | null` *required*

Details over het bedrijfstype wanneer business\_type `other` is.

**other\_industry\_description** `string | null` *required*

Details over de branche wanneer industry\_type `other` is.

**owner** `object` *required*

De enige gebruiker die eigenaar is van het account, wiens e-mailadres de `email` hierboven is. Dit staat los van de rol `owner` voor teamleden, die door een onbeperkt aantal teamleden kan worden vervuld.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Gebruikers-ID, met prefix `user_`.
>
> **name** `string | null` *required*
>
> Weergavenaam.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> **username** `string` *required*
>
> Openbare gebruikersnaam.

**parent\_account** `object | null` *required*

Bovenliggend account voor subaccounts, of `null` voor zelfstandige accounts.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Account-ID, met prefix `biz_`.
>
> **fees** `object`
>
> Opslagpercentages die dit bovenliggende account in rekening brengt bij het subaccount dat wordt gelezen, per kostentype (bijvoorbeeld `crypto_deposit_markup`), elk met `percentage_fee` en `fixed_fee_usd`. Bepaald waarbij de eigen overschrijvingen van het subaccount voorrang hebben op de standaard van het platform.
>
> **logo\_url** `string | null` *required*
>
> URL van de logoafbeelding van het account.
>
> **route** `string` *required*
>
> Openbare route-identifier van het account.
>
> **title** `string` *required*
>
> Weergavenaam van het account.

**partner** `object | null`

De actieve eerstelijnspartner van het account. Aanwezig in retrieve-responses; null wanneer er geen actieve eerstelijnspartner aan het account is toegeschreven. Weggelaten uit andere responses.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Gebruikers-ID, met prefix `user_`.
>
> **email** `string | null` *required*
>
> E-mailadres om contact op te nemen met de partner. Null wanneer de partner geen eigen e-mailadres heeft toegevoegd.
>
> **name** `string | null` *required*
>
> Weergavenaam.
>
> **profile\_picture** `object` *required*
>
> Avatar-wrapper. De `url` is altijd aanwezig en is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> > [accordion] Eigenschappen
> >
> > **url** `string` *required*
> >
> > URL van de avatarafbeelding. Altijd aanwezig. Het is een gegenereerde placeholder wanneer de gebruiker geen foto heeft ingesteld.
>
> **referring\_account** `object | null` *required*
>
> Het bedrijf namens welk de partner dit account heeft doorverwezen, wanneer de doorverwijzing bij hun team hoort. `null` voor een persoonlijke doorverwijzing.
>
> > [accordion] Eigenschappen
> >
> > **id** `string` *required*
> >
> > Account-ID, met prefix `biz_`.
> >
> > **title** `string` *required*
> >
> > Weergavenaam van het account.
>
> **username** `string` *required*
>
> Openbare gebruikersnaam.
>
> **whop\_partner\_verified\_at** `string | null` *required*
>
> Wanneer de gebruiker een geverifieerde Whop Partner werd, als ISO 8601-tijdstempel. Null als niet geverifieerd.

**payment\_controls** `object | null` *required*

Maatregelen voor betalingsgezondheid die momenteel op het account worden toegepast. Alleen berekend bij `retrieve` en `me` voor aanroepers met de scope `company:balance:read`; anders `null`.

> [accordion] Eigenschappen
>
> **dispute\_alert\_auto\_refund** `object` *required*
>
> Instellingen voor automatische terugbetaling bij waarschuwingen over geschillen vóór een chargeback.
>
> > [accordion] Eigenschappen
> >
> > **locked** `boolean` *required*
> >
> > Of de accounteigenaar wordt verhinderd deze drempel te wijzigen.
> >
> > **threshold\_usd** `number | null` *required*
> >
> > Maximaal bedrag van een geschilwaarschuwing dat automatisch wordt terugbetaald, in USD. `null` wanneer automatische terugbetalingen zijn uitgeschakeld.
>
> **dispute\_alert\_fee\_usd** `number | null` *required*
>
> Kosten die voor elke geschilwaarschuwing in rekening worden gebracht, in USD. `null` wanneer niet beschikbaar.
>
> **enforce\_3ds** `boolean` *required*
>
> Of 3-D Secure wordt afgedwongen bij elke kaartbetaling in de checkout. Het account kan dit niet omzeilen zolang het is ingesteld.
>
> **financing\_disabled** `boolean` *required*
>
> Of de maatregelen voor betalingsgezondheid financiering expliciet uitschakelen. Dit staat los van de goedkeuring voor financiering in `capabilities.accept_bnpl_payments`.
>
> **high\_risk\_processing\_fee\_percentage** `number` *required*
>
> Extra percentage verwerkingskosten voor verwerking met een hoog risico.
>
> **payment\_method\_warnings** `object[]` *required*
>
> Betaalmethoden waarvoor het account een waarschuwing heeft gekregen dat ze de grens voor het geschilpercentage naderen. Elk item bevat `payment_method`, `measure` (`disputes`, `disputes_and_tc40s` of `fraud_disputes`), `warned_at` als ISO 8601-tijdstempel, en de `rate`, `warning_rate` en `target_rate` als fracties waarbij `0.01` gelijk is aan 1%. Leeg wanneer er geen waarschuwingen zijn. Een gewaarschuwde methode wordt gepauzeerd en verschijnt in `restricted_payment_methods` als deze ongeveer vier weken later nog steeds boven het doelpercentage zit.
>
> **pending\_auto\_topup\_fee\_percentage** `number` *required*
>
> Percentage kosten dat in rekening wordt gebracht wanneer een lopend, nog niet verrekend saldo wordt voorgeschoten om het kaartsaldo van het account te financieren, waarbij `2` 2% betekent. `0` wanneer het account is vrijgesteld.
>
> **pending\_balance\_delay\_days** `integer` *required*
>
> Extra dagen dat betalingen in behandeling blijven voordat ze beschikbaar worden.
>
> **reserve** `object` *required*
>
> Reserve die momenteel wordt toegepast op het inkomende betalingsvolume.
>
> > [accordion] Eigenschappen
> >
> > **hold\_period\_days** `integer` *required*
> >
> > Aantal dagen dat gereserveerde tegoeden worden vastgehouden voordat ze worden vrijgegeven.
> >
> > **percentage** `number | null` *required*
> >
> > Percentage van het inkomende betalingsvolume dat in reserve wordt gehouden. `null` wanneer er geen reserve wordt toegepast.
>
> **resolution\_center\_auto\_refund** `object` *required*
>
> Instellingen voor automatische terugbetaling bij zaken in het resolutiecentrum.
>
> > [accordion] Eigenschappen
> >
> > **card\_threshold\_usd** `number | null` *required*
> >
> > Maximaal bedrag van een met een kaart betaalde zaak in het resolutiecentrum dat automatisch wordt terugbetaald, in USD. `null` wanneer automatische terugbetalingen voor kaarten zijn uitgeschakeld.
> >
> > **financing\_threshold\_usd** `number | null` *required*
> >
> > Maximaal bedrag van een met financiering betaalde zaak in het resolutiecentrum dat automatisch wordt terugbetaald, in USD. `null` wanneer automatische terugbetalingen voor financiering zijn uitgeschakeld.
> >
> > **locked** `boolean` *required*
> >
> > Of de accounteigenaar wordt verhinderd deze drempels te wijzigen.
> >
> > **paypal\_threshold\_usd** `number | null` *required*
> >
> > Maximaal bedrag van een met PayPal betaalde zaak in het resolutiecentrum dat automatisch wordt terugbetaald, in USD. `null` wanneer automatische terugbetalingen voor PayPal zijn uitgeschakeld.
>
> **restricted\_payment\_methods** `string[]` *required*
>
> Kaartmerken die in de checkout voor dit account zijn geblokkeerd. Leeg wanneer er geen zijn geblokkeerd. Het account kan ze niet zelf opnieuw inschakelen.
>
> Beschikbare opties: `card_visa`, `card_mastercard`, `card_american_express`, `card_discover_global_network`, `addi`, `affirm`, `afterpay_clearpay`, `alma`, `billie`, `capchase_pay`, `claritypay`, `flex_pay`, `klarna`, `kriya`, `kueski`, `mondu`, `oney`, `scalapay`, `sequra`, `sezzle`, `splitit`, `sunbit`, `tabby`, `tamara`, `zip`, `card_installments_three`, `card_installments_six`, `card_installments_twelve`, `oney_3x`, `oney_4x`, `klarna_pay_now`, `us_bank_account`, `sepa_debit`, `bacs_debit`, `au_becs_debit`, `acss_debit`, `pay_by_bank`, `payto`, `paypal`, `cashapp`, `venmo`, `amazon_pay`, `link`, `wechat_pay`
>
> **undated\_pending\_reason** `string | null` *required*
>
> Waarom lopende tegoeden zonder verrekeningsdatum nog niet worden verplaatst. `kyc_incomplete`, `pending_information_request` en `update_payout_profile` zijn zaken waarop de verkoper actie kan ondernemen. `compliance_review` betekent dat een verificatie die de verkoper al heeft ingediend wordt beoordeeld, zodat deze tegoeden in behandeling blijven totdat die is afgerond. `withdrawals_disabled` betekent dat Whop opnames heeft geblokkeerd, zodat deze tegoeden niet beschikbaar kunnen worden. `null` wanneer er geen reden is om te tonen — nog in verrekening, of vastgehouden om een reden die hier niet wordt genoemd.
>
> Beschikbare opties: `kyc_incomplete`, `pending_information_request`, `update_payout_profile`, `compliance_review`, `withdrawals_disabled`
>
> **withdrawal\_schedule** `object` *required*
>
> Hoe het saldo van het account automatisch wordt opgenomen.
>
> > [accordion] Eigenschappen
> >
> > **day** `integer | null` *required*
> >
> > Dag waarop de automatische opname wordt uitgevoerd: 0-6 (zondag-zaterdag) voor `weekly`, 1-31 voor `monthly`. `null` voor `manual` en `daily`.
> >
> > **frequency** `string` *required*
> >
> > Hoe vaak het saldo van het account automatisch wordt opgenomen.
> >
> > Beschikbare opties: `manual`, `daily`, `weekly`, `monthly`
> >
> > **next\_payout\_date** `string | null` *required*
> >
> > Volgende datum waarop de automatische opname gepland staat, als ISO 8601-datum. `null` voor `manual` en `daily`, waarbij geen enkele volgende datum van toepassing is.

**payment\_method\_configuration** `object | null` *required*

De standaardbetaalmethoden van het account in de checkout. De eigen `payment_method_configuration` van een variant of checkoutconfiguratie heeft voorrang. `null` wanneer het account de platformstandaarden van Whop gebruikt.

> [accordion] Eigenschappen
>
> **disabled** `string[]` *required*
>
> Betaalmethoden die deze checkout achterhoudt, zelfs wanneer de standaarden ze zouden aanbieden.
>
> **enabled** `string[]` *required*
>
> Betaalmethoden die deze checkout aanbiedt bovenop wat de standaarden bieden.
>
> **include\_platform\_defaults** `boolean` *required*
>
> Of de standaardset van Whop het uitgangspunt is. Wanneer `false`, wordt alleen `enabled` aangeboden.

**platform\_credits** `object[]` *required*

Door Whop uitgegeven platformtegoeden per valuta, gelezen uit de saldocache. Tegoeden kunnen alleen worden besteed aan geschikte Whop-producten zoals Whop Ads, kunnen nooit worden opgenomen en zijn niet opgenomen in `balances` of `total_usd`. Leeg wanneer het account er geen heeft of `total_usd` `null` is.

> [accordion] Eigenschappen
>
> **amount** `string` *required*
>
> Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
>
> **currency** `string` *required*
>
> Valutacode volgens ISO 4217 van drie letters, in kleine letters.
>
> **decimals** `integer` *required*
>
> Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
>
> **display\_decimals** `integer` *required*
>
> Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.

**privacy\_policy** `object | null` *required*

Het privacybeleid van het account, of `null` als het account er geen heeft gepubliceerd.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van het bestand, met prefix `file_`.
>
> **blurhash** `string | null` *required*
>
> BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **content\_type** `string | null` *required*
>
> Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Dit blijft behouden wanneer moderatie het bestand verwijdert.
>
> **created\_at** `string` *required*
>
> Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
>
> **duration\_seconds** `number | null` *required*
>
> Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **filename** `string | null` *required*
>
> De oorspronkelijke bestandsnaam, inclusief extensie.
>
> **height** `integer | null` *required*
>
> Hoogte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **multipart\_chunk\_size** `integer | null`
>
> De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_id** `string | null`
>
> De ID van de multipart-upload, die wordt teruggegeven aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_urls** `object[] | null`
>
> De presigned URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> > [accordion] Eigenschappen
> >
> > **part\_number** `integer` *required*
> >
> > De index (beginnend bij 1) van dit deel binnen de multipart-upload.
> >
> > **url** `string` *required*
> >
> > De presigned URL waarnaar je de bytes van dit deel met PUT verstuurt.
>
> **object** `string` *required*
>
> Het type van dit object, altijd `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Of moderatie het bestand heeft verwijderd. Wanneer `true`, levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.
>
> **size** `integer | null` *required*
>
> De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
>
> **upload\_headers** `object`
>
> Headers die met de upload-PUT moeten worden meegestuurd. Alleen aanwezig bij aanmaken.
>
> **upload\_status** `string` *required*
>
> Waar het bestand zich in de uploadlevenscyclus bevindt.
>
> Beschikbare opties: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> Presigned URL waarnaar je de bytes van het bestand met PUT verstuurt. Alleen aanwezig bij aanmaken, en alleen voor uploads uit één deel.
>
> **url** `string | null` *required*
>
> Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
>
> **visibility** `string` *required*
>
> `public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.
>
> Beschikbare opties: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **width** `integer | null` *required*
>
> Breedte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

**product\_tax\_code** `object | null` *required*

Belastingclassificatiecode die standaard op de producten van het account wordt toegepast, met `id`, `name` en `product_type`. `null` wanneer er geen standaard is ingesteld.

**recommended\_actions** `object[] | null` *required*

VEROUDERD: Gebruik in plaats daarvan het endpoint `GET /economic_intelligence?account_id=\{account_id}`.

> [accordion] Eigenschappen
>
> **action** `string` *required*
>
> De aanbeveling; er kunnen nieuwe waarden worden toegevoegd, dus handel onbekende acties netjes af
>
> Beschikbare opties: `theme_business`, `create_product`, `create_plan`, `verify_identity`, `connect_affiliate_program`, `create_promotion`, `migrate_from_stripe`, `accept_first_payment`, `launch_first_ad`, `launch_draft_campaign`, `increase_ad_budget`, `refresh_ad_creatives`, `fix_ad_billing`, `exclude_customers_from_ads`, `retarget_abandoned_checkouts`, `fix_funnel_dropoff`, `invite_team_member`, `enable_tax_collection`, `create_card`, `apply_for_financing`
>
> **blocked\_capabilities** `string[]` *required*
>
> Mogelijkheden die dit zou ontgrendelen, of leeg
>
> **cta** `string` *required*
>
> De URL waarnaar de call-to-action linkt
>
> **cta\_label** `string` *required*
>
> Knoplabel
>
> **description** `string` *required*
>
> Ondersteunende tekst, of leeg
>
> **icon\_url** `string | null` *required*
>
> URL van het illustratiepictogram, of `null`
>
> **impact\_score** `integer | null` *required*
>
> Geschatte impact van 0-100, of `null` wanneer niet gerangschikt
>
> **reasoning** `string | null` *required*
>
> Waarom deze actie is aanbevolen, of `null`
>
> **status** `string` *required*
>
> Altijd optioneel — nooit blokkerend
>
> Beschikbare opties: `optional`
>
> **title** `string` *required*
>
> Kop van de aanbeveling

**require\_2fa** `boolean` *required*

Of geautoriseerde gebruikers tweestapsverificatie moeten inschakelen.

**required\_actions** `object[] | null` *required*

Acties die de accounteigenaar moet ondernemen om mogelijkheden zoals uitbetalingen en kaartuitgaven te deblokkeren, gesorteerd op weergaveprioriteit. Alleen berekend bij `retrieve` en `me` voor aanroepers met de scope `company:balance:read`; anders `null`.

> [accordion] Eigenschappen
>
> **action** `string` *required*
>
> Wat de houder moet doen; er kunnen nieuwe waarden worden toegevoegd, dus handel onbekende acties netjes af
>
> Beschikbare opties: `deposit_funds`, `review_held_payments`, `submit_information_request`, `update_automatic_withdrawal_method`, `reauthorize_payout_methods`, `update_payout_method`, `update_payout_profile`, `card_usage_review`, `verify_identity`, `scale_account_setup`, `sign_formation_documents`, `configure_tax_remitter`, `add_vat_registration`, `confirm_tax_details`, `accept_payout_terms`, `enable_two_factor_authentication`, `respond_to_abuse_report`
>
> **blocked\_capabilities** `string[]` *required*
>
> Mogelijkheden die geblokkeerd zijn totdat dit is opgelost
>
> **cta** `string | null` *required*
>
> De URL waarnaar de call-to-action linkt, of null wanneer er geen knop is
>
> **cta\_label** `string` *required*
>
> Knoplabel, of leeg wanneer er geen knop is
>
> **description** `string` *required*
>
> Ondersteunende tekst, of leeg
>
> **icon\_url** `string | null` *required*
>
> De URL van het illustratiepictogram van de actie, of null als die er geen heeft
>
> **status** `string` *required*
>
> required (nu actie ondernemen) of pending (in beoordeling)
>
> Beschikbare opties: `required`, `pending`
>
> **title** `string` *required*
>
> Kop van de actie

**return\_policy** `object | null` *required*

Het retourbeleid van het account, of `null` als het account er geen heeft gepubliceerd.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van het bestand, met prefix `file_`.
>
> **blurhash** `string | null` *required*
>
> BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **content\_type** `string | null` *required*
>
> Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Dit blijft behouden wanneer moderatie het bestand verwijdert.
>
> **created\_at** `string` *required*
>
> Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
>
> **duration\_seconds** `number | null` *required*
>
> Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **filename** `string | null` *required*
>
> De oorspronkelijke bestandsnaam, inclusief extensie.
>
> **height** `integer | null` *required*
>
> Hoogte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **multipart\_chunk\_size** `integer | null`
>
> De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_id** `string | null`
>
> De ID van de multipart-upload, die wordt teruggegeven aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_urls** `object[] | null`
>
> De presigned URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> > [accordion] Eigenschappen
> >
> > **part\_number** `integer` *required*
> >
> > De index (beginnend bij 1) van dit deel binnen de multipart-upload.
> >
> > **url** `string` *required*
> >
> > De presigned URL waarnaar je de bytes van dit deel met PUT verstuurt.
>
> **object** `string` *required*
>
> Het type van dit object, altijd `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Of moderatie het bestand heeft verwijderd. Wanneer `true`, levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.
>
> **size** `integer | null` *required*
>
> De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
>
> **upload\_headers** `object`
>
> Headers die met de upload-PUT moeten worden meegestuurd. Alleen aanwezig bij aanmaken.
>
> **upload\_status** `string` *required*
>
> Waar het bestand zich in de uploadlevenscyclus bevindt.
>
> Beschikbare opties: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> Presigned URL waarnaar je de bytes van het bestand met PUT verstuurt. Alleen aanwezig bij aanmaken, en alleen voor uploads uit één deel.
>
> **url** `string | null` *required*
>
> Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
>
> **visibility** `string` *required*
>
> `public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.
>
> Beschikbare opties: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **width** `integer | null` *required*
>
> Breedte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

**rewards** `object[]`

Zakelijke beloningen die via de actieve doorverwijslink van dit account zijn gekoppeld, met accountspecifieke voortgang en grootboekstatus. Aanwezig in retrieve-responses; leeg zonder leestoegang tot zowel saldo als statistieken.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> ID van de beloningsdefinitie, met prefix `prwd_`. Voortgang en status gelden voor het bovenliggende account.
>
> **qualification\_amount** `object` *required*
>
> Kwalificerend USD-volume dat nodig is om deze beloning te verdienen.
>
> > [accordion] Eigenschappen
> >
> > **amount** `string` *required*
> >
> > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> >
> > **currency** `string` *required*
> >
> > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> >
> > **decimals** `integer` *required*
> >
> > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
>
> **qualification\_progress** `object` *required*
>
> Kwalificerend USD-volume voor de activiteit van de beloning dat dit account sinds de toeschrijving heeft opgebouwd, berekend volgens de uitvoeringsregels.
>
> > [accordion] Eigenschappen
> >
> > **amount** `string` *required*
> >
> > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> >
> > **currency** `string` *required*
> >
> > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> >
> > **decimals** `integer` *required*
> >
> > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
>
> **qualification\_type** `string` *required*
>
> Activiteit waardoor dit account in aanmerking komt voor de beloning.
>
> Beschikbare opties: `sales`, `ad_spend`
>
> **reward\_amount** `object` *required*
>
> USD-bedrag dat voor deze beloning wordt bijgeschreven. Gebruikt het opgeslagen toekenningsbedrag zodra de uitvoering is gestart.
>
> > [accordion] Eigenschappen
> >
> > **amount** `string` *required*
> >
> > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> >
> > **currency** `string` *required*
> >
> > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> >
> > **decimals** `integer` *required*
> >
> > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> >
> > **display\_decimals** `integer` *required*
> >
> > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
>
> **status** `string` *required*
>
> De beloningsstatus van dit account. Credited vereist een geboekte grootboekpost; processing omvat een behaalde vereiste die wacht op uitvoering. Reversing en reversed weerspiegelen een latere terugdraaiing van de beloning.
>
> Beschikbare opties: `in_progress`, `processing`, `credited`, `reversing`, `reversed`, `unavailable`

**route** `string` *required*

Openbare route-identifier van het account.

**send\_customer\_emails** `boolean` *required*

Of Whop namens dit account transactionele e-mails naar klanten stuurt.

**shipping\_policy** `object | null` *required*

Het verzendbeleid van het account, of `null` als het account er geen heeft gepubliceerd.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van het bestand, met prefix `file_`.
>
> **blurhash** `string | null` *required*
>
> BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **content\_type** `string | null` *required*
>
> Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Dit blijft behouden wanneer moderatie het bestand verwijdert.
>
> **created\_at** `string` *required*
>
> Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
>
> **duration\_seconds** `number | null` *required*
>
> Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **filename** `string | null` *required*
>
> De oorspronkelijke bestandsnaam, inclusief extensie.
>
> **height** `integer | null` *required*
>
> Hoogte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **multipart\_chunk\_size** `integer | null`
>
> De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_id** `string | null`
>
> De ID van de multipart-upload, die wordt teruggegeven aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_urls** `object[] | null`
>
> De presigned URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> > [accordion] Eigenschappen
> >
> > **part\_number** `integer` *required*
> >
> > De index (beginnend bij 1) van dit deel binnen de multipart-upload.
> >
> > **url** `string` *required*
> >
> > De presigned URL waarnaar je de bytes van dit deel met PUT verstuurt.
>
> **object** `string` *required*
>
> Het type van dit object, altijd `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Of moderatie het bestand heeft verwijderd. Wanneer `true`, levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.
>
> **size** `integer | null` *required*
>
> De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
>
> **upload\_headers** `object`
>
> Headers die met de upload-PUT moeten worden meegestuurd. Alleen aanwezig bij aanmaken.
>
> **upload\_status** `string` *required*
>
> Waar het bestand zich in de uploadlevenscyclus bevindt.
>
> Beschikbare opties: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> Presigned URL waarnaar je de bytes van het bestand met PUT verstuurt. Alleen aanwezig bij aanmaken, en alleen voor uploads uit één deel.
>
> **url** `string | null` *required*
>
> Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
>
> **visibility** `string` *required*
>
> `public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.
>
> Beschikbare opties: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **width** `integer | null` *required*
>
> Breedte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

**show\_joined\_whops** `boolean` *required*

Of het account verschijnt in de whops waarvan andere accounts lid zijn.

**show\_reviews\_dtc** `boolean` *required*

Of reviews worden getoond op productpagina's die rechtstreeks aan consumenten verkopen.

**show\_user\_directory** `boolean` *required*

Of het account gebruikers toont in de gebruikersgids.

**social\_links** `object[]` *required*

Sociale links van het account.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van de sociale link
>
> **title** `string | null` *required*
>
> De optionele weergavetitel van de sociale link
>
> **url** `string` *required*
>
> De URL van de sociale link
>
> **website** `string` *required*
>
> Het sociale platform voor deze link
>
> Beschikbare opties: `x`, `instagram`, `facebook`, `tiktok`, `youtube`, `linkedin`, `twitch`, `website`, `custom`

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

Of het account op Whop kan opereren: `active` of `suspended`. Berekend bij `list`, `retrieve`, `me` en `suspend`; anders `null`.

**status\_reason** `string | null` *required*

Waarom het account is geschorst, als label zoals `Suspended - Fraudulent activity`. `Suspended` wanneer er geen reden is vastgelegd. Berekend bij `retrieve`, `me` en `suspend`. Anders `null`, of wanneer `status` niet `suspended` is.

**store\_page\_config** `object` *required*

Weergaveconfiguratie van de winkelpagina van het account.

> [accordion] Eigenschappen
>
> **accent\_color** `string | null` *required*
>
> Accentkleur die op de winkelpagina van het account wordt gebruikt.
>
> Beschikbare opties: `ruby`, `tomato`, `red`, `crimson`, `pink`, `plum`, `purple`, `violet`, `iris`, `cyan`, `teal`, `jade`, `green`, `grass`, `brown`, `blue`, `orange`, `indigo`, `sky`, `mint`, `yellow`, `amber`, `lime`, `lemon`, `magenta`, `gold`, `bronze`, `gray`
>
> **layout** `string | null` *required*
>
> Indeling die op de winkelpagina van het account wordt gebruikt.
>
> Beschikbare opties: `featured`, `compact`
>
> **profile\_variant** `string | null` *required*
>
> Profielweergave die op de winkelpagina van het account wordt gebruikt.
>
> Beschikbare opties: `personal`, `business`
>
> **whop\_affiliate\_link** `boolean` *required*
>
> Of de winkelpagina van het account een Whop-affiliatelink toont.

**target\_audience** `string | null` *required*

Doelgroep voor dit account.

**tax\_collection\_enabled\_states** `string[]` *required*

Codes van Amerikaanse staten (van de 50 staten plus `DC`) waar het account belasting int: de volledige set wanneer Whop afdraagt (`tax_remitted_by` `whop`), de geconfigureerde subset wanneer het account zelf afdraagt (`self`), en leeg wanneer geen van beide. Stuur bij een update de volledige lijst om deze te vervangen (alleen toegestaan bij `self`).

**tax\_identifiers** `object[]` *required*

Belasting-/btw-registraties van het account. Leeg wanneer er geen zijn ingesteld.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> ID van de belastingidentifier.
>
> **tax\_id\_type** `string` *required*
>
> Type belasting-ID.
>
> Beschikbare opties: `ad_nrt`, `ao_tin`, `ar_cuit`, `al_tin`, `am_tin`, `aw_tin`, `au_abn`, `au_arn`, `eu_vat`, `az_tin`, `bs_tin`, `bh_vat`, `bd_bin`, `bb_tin`, `by_tin`, `bj_ifu`, `bo_tin`, `ba_tin`, `br_cnpj`, `br_cpf`, `bg_uic`, `bf_ifu`, `kh_tin`, `cm_niu`, `ca_bn`, `ca_gst_hst`, `ca_pst_bc`, `ca_pst_mb`, `ca_pst_sk`, `ca_qst`, `cv_nif`, `cl_tin`, `cn_tin`, `co_nit`, `cd_nif`, `cr_tin`, `hr_oib`, `do_rcn`, `ec_ruc`, `eg_tin`, `sv_nit`, `et_tin`, `eu_oss_vat`, `ge_vat`, `gh_tin`, `de_stn`, `gb_vat`, `gn_nif`, `hk_br`, `hu_tin`, `is_vat`, `in_gst`, `id_npwp`, `il_vat`, `jp_cn`, `jp_rn`, `jp_trn`, `kz_bin`, `ke_pin`, `kg_tin`, `la_tin`, `li_uid`, `li_vat`, `my_frp`, `my_itn`, `my_sst`, `mr_nif`, `mx_rfc`, `md_vat`, `me_pib`, `ma_vat`, `np_pan`, `nz_gst`, `ng_tin`, `mk_vat`, `no_vat`, `no_voec`, `om_vat`, `pe_ruc`, `ph_tin`, `pl_nip`, `ro_tin`, `ru_inn`, `ru_kpp`, `sa_vat`, `sn_ninea`, `rs_pib`, `sg_gst`, `sg_uen`, `si_tin`, `za_vat`, `kr_brn`, `es_cif`, `ch_uid`, `ch_vat`, `tw_vat`, `tj_tin`, `tz_vat`, `th_vat`, `tr_tin`, `ug_tin`, `ua_vat`, `ae_trn`, `us_ein`, `uy_ruc`, `uz_tin`, `uz_vat`, `ve_rif`, `vn_tin`, `zm_tin`, `zw_tin`, `sr_fin`, `xi_vat`
>
> **tax\_id\_value** `string` *required*
>
> Waarde van de belasting-ID, bijvoorbeeld `DE123456789`. Zie de [gids voor belasting-ID's](https://docs.whop.com/nl/developer/guides/tax-ids.md).

**tax\_remitted\_by** `string | null` *required*

Wie belasting berekent en afdraagt voor het account. `whop` betekent dat Whop berekent en afdraagt. `self` betekent dat Whop berekent, en dat het account int en afdraagt. `none` betekent geen van beide, en het account is verantwoordelijk. Nieuwe bedrijven beginnen op `whop` en nieuwe gekoppelde accounts beginnen op `none`. `null` betekent dat het account nog geen instelling heeft.

Beschikbare opties: `whop`, `self`, `none`

**tax\_type** `string | null` *required*

Hoe belasting op de prijzen van het account wordt toegepast: `inclusive` (belasting inbegrepen in de vermelde prijs) of `exclusive` (belasting wordt erbovenop gerekend). Standaard `exclusive` wanneer niet ingesteld; alleen `null` wanneer het account geen betalingskoppeling heeft.

Beschikbare opties: `inclusive`, `exclusive`

**terms\_of\_service** `object | null` *required*

De servicevoorwaarden van het account, of `null` als het account er geen heeft gepubliceerd.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van het bestand, met prefix `file_`.
>
> **blurhash** `string | null` *required*
>
> BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **content\_type** `string | null` *required*
>
> Het MIME-type van het oorspronkelijke bestand, bijvoorbeeld `application/pdf`. Dit blijft behouden wanneer moderatie het bestand verwijdert.
>
> **created\_at** `string` *required*
>
> Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
>
> **duration\_seconds** `number | null` *required*
>
> Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **filename** `string | null` *required*
>
> De oorspronkelijke bestandsnaam, inclusief extensie.
>
> **height** `integer | null` *required*
>
> Hoogte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **multipart\_chunk\_size** `integer | null`
>
> De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_id** `string | null`
>
> De ID van de multipart-upload, die wordt teruggegeven aan `complete`. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> **multipart\_upload\_urls** `object[] | null`
>
> De presigned URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
>
> > [accordion] Eigenschappen
> >
> > **part\_number** `integer` *required*
> >
> > De index (beginnend bij 1) van dit deel binnen de multipart-upload.
> >
> > **url** `string` *required*
> >
> > De presigned URL waarnaar je de bytes van dit deel met PUT verstuurt.
>
> **object** `string` *required*
>
> Het type van dit object, altijd `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Of moderatie het bestand heeft verwijderd. Wanneer `true`, levert `url` een vervangende afbeelding. `filename`, `size` en `content_type` beschrijven nog steeds het oorspronkelijke bestand.
>
> **size** `integer | null` *required*
>
> De bestandsgrootte in bytes. `null` totdat de upload is voltooid.
>
> **upload\_headers** `object`
>
> Headers die met de upload-PUT moeten worden meegestuurd. Alleen aanwezig bij aanmaken.
>
> **upload\_status** `string` *required*
>
> Waar het bestand zich in de uploadlevenscyclus bevindt.
>
> Beschikbare opties: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> Presigned URL waarnaar je de bytes van het bestand met PUT verstuurt. Alleen aanwezig bij aanmaken, en alleen voor uploads uit één deel.
>
> **url** `string | null` *required*
>
> Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL en privébestanden krijgen een ondertekende URL die verloopt. `null` totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
>
> **visibility** `string` *required*
>
> `public`-bestanden worden geleverd via een niet-ondertekende CDN-URL. `private`-bestanden worden geleverd via een ondertekende URL die verloopt.
>
> Beschikbare opties: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.
>
> **width** `integer | null` *required*
>
> Breedte van de afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.

**three\_ds\_level** `string | null` *required*

3D Secure-gedrag voor ondersteunde on-session kaartbetalingen. `mandate_challenge` vereist een 3DS-challenge voordat de betaling wordt verwerkt; `mandate_if_required` vereist alleen een challenge wanneer de betalingsverwerker dat vereist; `frictionless_if_required` gebruikt de gewone frictieloze 3DS-flow. Betalingen van \$1,000 of meer gebruiken `mandate_if_required`, tenzij `mandate_challenge` is geselecteerd. Vereisten voor risico en herstel van authenticatie kunnen de voorkeur overschrijven. `null` gebruikt de standaard checkout-flow.

Beschikbare opties: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

**title** `string` *required*

Weergavenaam van het account.

**total\_earned\_usd** `number | null` *required*

Totale verkopen van het account, genormaliseerd naar USD. Alleen berekend bij `retrieve` en `me` voor aanroepers met de scope `stats:read`; anders `null`.

**total\_usd** `string | null` *required*

Totale USD-waarde van de saldi met bekende wisselkoersen. Alleen berekend bij het lezen van een enkel account (`retrieve` en `me`); `null` bij list-responses, schrijfacties, ontbrekende leesrechten voor het saldo of een niet-beschikbare saldobron.

**trading** `trading_account | null` *required*

Het adres van het handelsaccount, een momentopname van de margin en open posities, en de WebSocket-abonnementen. Schakel in met `include_trading=true` bij het lezen van een enkel account. Anders `null`, zonder handelsrechten, of zonder Ethereum-wallet.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> De ID van de Whop-wallet achter dit handelsaccount, met prefix `cwal_`.
>
> **account\_id** `string | null` *required*
>
> Het account dat eigenaar is van dit handelsaccount, met prefix `biz_`. `null` wanneer een gebruiker eigenaar is.
>
> **hyperliquid** `object | null` *required*
>
> Hyperliquid-specifieke status. Aanwezig wanneer `provider` `hyperliquid` is, anders `null`.
>
> > [accordion] Eigenschappen
> >
> > **address** `string` *required*
> >
> > Walletadres in kleine letters dat het Hyperliquid-account aanhoudt.
> >
> > **depositable** `string | null` *required*
> >
> > USDT0 in de Whop-wallet op Plasma dat een `deposit`-trade naar dit account kan verplaatsen, als decimale string. `null` wanneer de chain niet kon worden gelezen.
> >
> > **margin\_summary** `object | null` *required*
> >
> > Accountwaarde en margin over de hoofdexchange en de `xyz`-markten, maximaal eens per seconde gelezen van Hyperliquid. `null` wanneer Hyperliquid niet kon worden gelezen. Gebruik `websocket_subscriptions` voor live updates.
> >
> > > [accordion] Eigenschappen
> > >
> > > **account\_value** `object` *required*
> > >
> > > Totale accountwaarde in USD, inclusief niet-gerealiseerde winst en verlies.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > >
> > > **total\_margin\_used** `object` *required*
> > >
> > > Margin die over open posities is verdeeld, in USD.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > >
> > > **total\_position\_notional** `object` *required*
> > >
> > > Gecombineerde nominale waarde van open posities, in USD.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > >
> > > **withdrawable** `object` *required*
> > >
> > > USD die nu kan worden opgenomen zonder posities te sluiten.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> >
> > **positions** `trading_position[] | null` *required*
> >
> > Open perpetual-posities over de hoofdexchange en de `xyz`-markten, maximaal eens per seconde gelezen van Hyperliquid. `null` wanneer Hyperliquid niet kon worden gelezen. Gebruik `websocket_subscriptions` voor live updates.
> >
> > > [accordion] Eigenschappen
> > >
> > > **id** `string` *required*
> > >
> > > ID van de handelspositie, met prefix `trdpos_`. Stabiel voor een markt binnen één handelsaccount.
> > >
> > > **entry\_price** `object | null` *required*
> > >
> > > Gemiddelde instapprijs in USD, of `null` wanneer de provider deze weglaat.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > >
> > > **hyperliquid** `object | null` *required*
> > >
> > > Details van Hyperliquid-perpetuals. Aanwezig bij Hyperliquid-posities, anders `null`.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **cumulative\_funding** `object` *required*
> > > >
> > > > Funding die over meerdere periodes op de positie is betaald, in USD.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **all\_time** `object | null` *required*
> > > > >
> > > > > Funding die over de hele geschiedenis van het account op deze markt is betaald, in USD, of `null` wanneer niet beschikbaar.
> > > > >
> > > > > > [accordion] Eigenschappen
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > > > >
> > > > > **since\_change** `object | null` *required*
> > > > >
> > > > > Funding die is betaald sinds de positiegrootte voor het laatst is gewijzigd, in USD, of `null` wanneer niet beschikbaar.
> > > > >
> > > > > > [accordion] Eigenschappen
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > > > >
> > > > > **since\_open** `object | null` *required*
> > > > >
> > > > > Funding die is betaald sinds de positie is geopend, in USD, of `null` wanneer niet beschikbaar.
> > > > >
> > > > > > [accordion] Eigenschappen
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > > >
> > > > **leverage** `object` *required*
> > > >
> > > > Marginmodus en multiplier voor de positie.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **type** `string` *required*
> > > > >
> > > > > `cross` deelt margin over posities. `isolated` beperkt de margin tot deze positie.
> > > > >
> > > > > Beschikbare opties: `cross`, `isolated`
> > > > >
> > > > > **value** `integer` *required*
> > > > >
> > > > > Multiplier die op de margin van de positie wordt toegepast, zoals `10` voor 10x.
> > > >
> > > > **liquidation\_price** `object | null` *required*
> > > >
> > > > Geschatte liquidatieprijs in USD, of `null` wanneer Hyperliquid er geen rapporteert.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > > >
> > > > **margin\_used** `object` *required*
> > > >
> > > > Margin die aan de positie is toegewezen, in USD.
> > > >
> > > > > [accordion] Eigenschappen
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > > >
> > > > **return\_on\_equity** `string` *required*
> > > >
> > > > Rendement op eigen vermogen als string met een decimale ratio, zoals `0.1` voor 10%.
> > >
> > > **market** `string` *required*
> > >
> > > Marktsymbool bij de provider, zoals `ETH`.
> > >
> > > **object** `string` *required*
> > >
> > > **position\_value** `object` *required*
> > >
> > > Huidige waarde van de positie in USD.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > >
> > > **side** `string` *required*
> > >
> > > Beschikbare opties: `long`, `short`
> > >
> > > **size** `string` *required*
> > >
> > > Absolute positiegrootte als decimale string.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > Niet-gerealiseerde winst of verlies in USD. Negatief bij een verlies.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> >
> > **websocket\_subscriptions** `object[]` *required*
> >
> > Abonnementen voor live accountupdates. Stuur elk `message` ongewijzigd na het verbinden met `websocket_url`.
> >
> > > [accordion] Eigenschappen
> > >
> > > **channel** `string` *required*
> > >
> > > De live updatestream die dit abonnement opent.
> > >
> > > Beschikbare opties: `clearinghouse_state`, `open_orders`, `order_updates`, `user_fills`, `user_events`
> > >
> > > **message** `string` *required*
> > >
> > > JSON-abonnementsbericht om ongewijzigd via de Hyperliquid-WebSocket te versturen.
> >
> > **websocket\_url** `string` *required*
> >
> > Hyperliquid-WebSocket-URL om rechtstreeks verbinding mee te maken voor live updates.
>
> **object** `string` *required*
>
> **provider** `string` *required*
>
> Handelsplatform dat de posities en orders aanhoudt.
>
> Beschikbare opties: `hyperliquid`
>
> **spot** `object | null` *required*
>
> Spot-tegoeden in de Whop-wallet met hun instapprijs en winst en verlies. `null` wanneer deze niet konden worden gelezen.
>
> > [accordion] Eigenschappen
> >
> > **holdings** `object[]` *required*
> >
> > Elk spot-asset dat de wallet nog aanhoudt, met de gemiddelde instapprijs en winst en verlies. De kostprijs telt de oudste eenheden als eerst verkocht en omvat assets die van buiten Whop zijn binnengekomen.
> >
> > > [accordion] Eigenschappen
> > >
> > > **average\_entry\_price** `object | null` *required*
> > >
> > > De gemiddelde prijs die per eenheid is betaald voor wat nog wordt aangehouden, in USD, waarbij de oudste eenheden als eerst verkocht worden geteld. `null` wanneer onbekend.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > >
> > > **cost\_basis** `object` *required*
> > >
> > > Wat in USD is betaald voor de eenheden die nog worden aangehouden.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > >
> > > **market** `string` *required*
> > >
> > > De `id` van de spotmarkt uit `GET /trades/markets`, zoals `BTC`, `XAUT` of de ticker van een getokeniseerd aandeel zoals `AAPL`.
> > >
> > > **realized\_pnl** `object` *required*
> > >
> > > Winsten en verliezen die al door verkoop zijn vastgelegd, in USD.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > De waarde van de eenheden die nog worden aangehouden minus hun `cost_basis`, in USD.
> > >
> > > > [accordion] Eigenschappen
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > Het bedrag in hoofdeenheden, als exacte decimale string. `"10.00"` is bijvoorbeeld tien dollar. Het is een string zodat geen float het onderweg afrondt.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Valutacode volgens ISO 4217 van drie letters, in kleine letters.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de betaling zelf wordt uitgevoerd.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Hoeveel decimalen je moet TONEN. Meestal gelijk aan `decimals`, en bewust niet altijd: COP wordt in centavos afgerekend maar in hele peso's geschreven, dus het is `2` en `0`. Formatteer het getal hiermee in je eigen locale.
> > >
> > > **unrealized\_pnl\_percentage** `number | null` *required*
> > >
> > > `unrealized_pnl` als percentage van `cost_basis`, waarbij `2` een stijging van 2% betekent. `null` wanneer onbekend.
>
> **user\_id** `string | null` *required*
>
> De gebruiker die eigenaar is van dit handelsaccount, met prefix `user_`. `null` wanneer een account eigenaar is.

**use\_logo\_as\_opengraph\_image\_fallback** `boolean` *required*

Of het account het logo gebruikt als fallback voor de Open Graph-afbeelding.

**verification** `object` *required*

Status van de identiteitsverificatie van het account voor de profielen `individual` (KYC) en `business` (KYB). Elk is `null` totdat het is aangemaakt, anders een `status` van `not_started`, `pending`, `manual_review`, `approved` of `rejected`.

**volume\_l30d\_usd** `number | null` *required*

Volume via het account in de afgelopen 30 dagen (GMV uit betaalde ontvangstbewijzen), genormaliseerd naar USD. Alleen berekend bij `list` voor aanroepers met `stats:read` op het account; anders `null`.

**volume\_usd** `number | null` *required*

Totaal volume via het account — verkopen plus ontvangen overboekingen — genormaliseerd naar USD. Alleen berekend bij `list` voor aanroepers met `stats:read` op het account; anders `null`.

**wallet** `object | null` *required*

Primaire crypto-wallet van het account, of `null` als er nog geen is aangemaakt.

> [accordion] Eigenschappen
>
> **id** `string` *required*
>
> Wallet-ID, met prefix `wallet_`.
>
> **address** `string` *required*
>
> Het on-chain adres van de wallet
>
> **network** `string` *required*
>
> Het blockchainnetwerk waarop de wallet staat
>
> Beschikbare opties: `solana`, `ethereum`, `bitcoin`

**website** `string | null` *required*

De URL van de bedrijfswebsite van het account, of `null` als er geen is opgegeven. Als je deze instelt, wordt ook een `website`-item toegevoegd aan `social_links`.

**whop\_partner\_enabled\_at** `string | null`

Wanneer het account de Whop Partner-modus heeft ingeschakeld, als ISO 8601-tijdstempel. Aanwezig bij het lezen van een enkel account en in update-responses; `null` totdat het account de Whop Partner-modus inschakelt door `whop_partner_enabled: true` te sturen bij een update.

```json Account theme={null}
{
	"id": "biz_xxxxxxxxxxxxx",
	"trading": {
		"id": "cwal_xxxxxxxxxxxxx",
		"object": "trading_account",
		"account_id": "biz_xxxxxxxxxxxxx",
		"user_id": null,
		"provider": "hyperliquid",
		"hyperliquid": {
			"address": "0x1234567890abcdef1234567890abcdef12345678",
			"websocket_url": "wss://api.hyperliquid.xyz/ws",
			"websocket_subscriptions": [
				{
					"channel": "clearinghouse_state",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"clearinghouseState\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "open_orders",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"openOrders\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "order_updates",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"orderUpdates\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_fills",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userFills\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				},
				{
					"channel": "user_events",
					"message": "{\"method\":\"subscribe\",\"subscription\":{\"type\":\"userEvents\",\"user\":\"0x1234567890abcdef1234567890abcdef12345678\"}}"
				}
			],
			"depositable": "1250.50",
			"margin_summary": {
				"account_value": {
					"currency": "usd",
					"amount": "1520.50",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_position_notional": {
					"currency": "usd",
					"amount": "4350.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"total_margin_used": {
					"currency": "usd",
					"amount": "435.00",
					"decimals": 2,
					"display_decimals": 2
				},
				"withdrawable": {
					"currency": "usd",
					"amount": "500.00",
					"decimals": 2,
					"display_decimals": 2
				}
			},
			"positions": [
				{
					"id": "trdpos_0123456789abcdef",
					"object": "trading_position",
					"market": "ETH",
					"side": "short",
					"size": "1.5",
					"entry_price": {
						"currency": "usd",
						"amount": "3000.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"position_value": {
						"currency": "usd",
						"amount": "4350.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "150.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"hyperliquid": {
						"leverage": {
							"type": "cross",
							"value": 10
						},
						"liquidation_price": {
							"currency": "usd",
							"amount": "4912.40",
							"decimals": 2,
							"display_decimals": 2
						},
						"margin_used": {
							"currency": "usd",
							"amount": "435.00",
							"decimals": 2,
							"display_decimals": 2
						},
						"return_on_equity": "0.33",
						"cumulative_funding": {
							"all_time": {
								"currency": "usd",
								"amount": "1.20",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_open": {
								"currency": "usd",
								"amount": "0.40",
								"decimals": 2,
								"display_decimals": 2
							},
							"since_change": {
								"currency": "usd",
								"amount": "0.10",
								"decimals": 2,
								"display_decimals": 2
							}
						}
					}
				}
			]
		},
		"spot": {
			"holdings": [
				{
					"market": "BTC",
					"average_entry_price": {
						"currency": "usd",
						"amount": "79841.12345678",
						"decimals": 8,
						"display_decimals": 8
					},
					"cost_basis": {
						"currency": "usd",
						"amount": "400.00",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl": {
						"currency": "usd",
						"amount": "38.25",
						"decimals": 2,
						"display_decimals": 2
					},
					"unrealized_pnl_percentage": 9.5625,
					"realized_pnl": {
						"currency": "usd",
						"amount": "3.25",
						"decimals": 2,
						"display_decimals": 2
					}
				}
			]
		}
	},
	"balances": [
		{
			"balance": "1250.5",
			"breakdown": {
				"available": "1200.50",
				"in_transit": "0",
				"pending": "50.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "50.00",
						"date": "2026-08-01"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": "https://cdn.whop.com/tokens/usdt.png",
			"name": "Tether USD",
			"price_usd": 1,
			"symbol": "USDT",
			"value_usd": "1250.50"
		},
		{
			"balance": "45.00",
			"breakdown": {
				"available": "40.00",
				"in_transit": "0",
				"pending": "5.00",
				"reserve": "0",
				"pending_settlements": [
					{
						"amount": "3.00",
						"date": "2026-08-01"
					},
					{
						"amount": "2.00",
						"date": "2026-08-04"
					}
				],
				"finishing_settlement": "0"
			},
			"icon_url": null,
			"name": "EUR",
			"price_usd": 1.11,
			"symbol": "EUR",
			"value_usd": "50.00"
		}
	],
	"platform_credits": [
		{
			"amount": "25.00",
			"currency": "usd",
			"decimals": 2,
			"display_decimals": 2
		}
	],
	"banner_image_url": "https://cdn.whop.com/banner.png",
	"business_type": "ecommerce",
	"can_transfer_pending_balance_to_children": false,
	"cancellation_policy": null,
	"country": "US",
	"created_at": "2026-06-01T12:00:00Z",
	"description": "Petal Post delivers fresh bouquets.",
	"economic_intelligence": false,
	"email": "hello@petalpost.example",
	"eula": null,
	"external_id": null,
	"home_preferences": ["hide_member_count"],
	"industry_type": "flower_delivery_gig",
	"invoice_prefix": "PETAL",
	"company_formation": {
		"status": "filed",
		"legal_name": "Petal Post, LLC",
		"state_registered": true,
		"ein_registered": false,
		"signatures": {
			"ss4": {
				"status": "pending",
				"url": "https://esign.doola.com/session/sess_1a2b3c",
				"expires_at": "2026-08-01T00:00:00Z"
			}
		},
		"documents": [
			{
				"id": "file_petalpost123",
				"name": "Articles of Organization",
				"type": "articles_of_organization",
				"url": "https://img.whop.com/documents/articles-of-organization.pdf"
			}
		]
	},
	"logo_url": "https://cdn.whop.com/logo.png",
	"metadata": {
		"external_merchant_id": "merchant_123"
	},
	"onboarding_type": "seller",
	"opengraph_image_url": "https://cdn.whop.com/og.png",
	"opengraph_image_variant": "black",
	"other_business_description": "Local flower delivery",
	"other_industry_description": "Same-day floral gifts",
	"owner": {
		"id": "user_xxxxxxxxxxxx",
		"username": "petalpost",
		"name": "Ada Flores",
		"profile_picture": {
			"url": "https://cdn.whop.com/user.png"
		}
	},
	"parent_account": {
		"id": "biz_platform123",
		"title": "Petal Platform",
		"route": "petal-platform",
		"logo_url": "https://cdn.whop.com/petal-platform-logo.png"
	},
	"privacy_policy": null,
	"require_2fa": true,
	"dispute_fighter_enabled": false,
	"orchestration_enabled": true,
	"collect_vat_id": false,
	"capabilities": {
		"accept_card_payments": "active",
		"accept_bank_payments": "active",
		"accept_bnpl_payments": "inactive",
		"standard_payout": "inactive",
		"instant_payout": "inactive",
		"crypto_payout": "inactive",
		"transfer": "inactive",
		"bank_deposit": "active",
		"crypto_deposit": "active",
		"card_deposit": "active",
		"card_issuing": "inactive",
		"run_ads": "active"
	},
	"payment_controls": {
		"dispute_alert_auto_refund": {
			"threshold_usd": 250,
			"locked": false
		},
		"resolution_center_auto_refund": {
			"card_threshold_usd": null,
			"financing_threshold_usd": null,
			"paypal_threshold_usd": null,
			"locked": false
		},
		"dispute_alert_fee_usd": 29,
		"high_risk_processing_fee_percentage": 0,
		"pending_auto_topup_fee_percentage": 2,
		"pending_balance_delay_days": 0,
		"financing_disabled": false,
		"enforce_3ds": false,
		"restricted_payment_methods": [],
		"payment_method_warnings": [],
		"reserve": {
			"percentage": null,
			"hold_period_days": 90
		},
		"withdrawal_schedule": {
			"frequency": "monthly",
			"day": 1,
			"next_payout_date": "2026-09-01"
		},
		"undated_pending_reason": null
	},
	"cards": {
		"kind": "business",
		"status": "approved",
		"decline_reason": null
	},
	"financing": null,
	"required_actions": [
		{
			"action": "verify_identity",
			"status": "required",
			"title": "Identity verification required",
			"description": "Complete verification before your total earnings exceed $5k to continue accepting payments.",
			"cta_label": "Verify now",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/balance/?verify=true",
			"icon_url": null,
			"blocked_capabilities": [
				"accept_card_payments",
				"accept_bank_payments",
				"standard_payout",
				"instant_payout",
				"crypto_payout",
				"transfer",
				"bank_deposit",
				"card_issuing"
			]
		}
	],
	"recommended_actions": [
		{
			"action": "migrate_from_stripe",
			"status": "optional",
			"title": "Migrate your business from Stripe.",
			"description": "",
			"cta_label": "Get started",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/settings/stripe-migrations/",
			"icon_url": "https://whop.com/illustrations/orange/crane.svg",
			"blocked_capabilities": [],
			"reasoning": null,
			"impact_score": null
		},
		{
			"action": "accept_first_payment",
			"status": "optional",
			"title": "Accept your first payment.",
			"description": "",
			"cta_label": "Create payment link",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/links/checkout/create/",
			"icon_url": "https://whop.com/illustrations/orange/card.svg",
			"blocked_capabilities": [],
			"reasoning": null,
			"impact_score": null
		},
		{
			"action": "apply_for_financing",
			"status": "optional",
			"title": "Offer financing at checkout",
			"description": "Let customers pay over time with buy now, pay later.",
			"cta_label": "Apply",
			"cta": "https://whop.com/dashboard/biz_xxxxxxxxxxxxx/settings/payments/",
			"icon_url": "https://whop.com/illustrations/orange/piggy-bank.svg",
			"blocked_capabilities": ["accept_bnpl_payments"],
			"reasoning": null,
			"impact_score": null
		}
	],
	"return_policy": null,
	"route": "petal-post",
	"shipping_policy": null,
	"website": "https://petalpost.example",
	"send_customer_emails": true,
	"payment_method_configuration": {
		"enabled": ["klarna"],
		"disabled": ["crypto"],
		"include_platform_defaults": true
	},
	"show_joined_whops": false,
	"show_reviews_dtc": true,
	"show_user_directory": false,
	"status": "active",
	"status_reason": null,
	"funds_release_at": null,
	"terms_of_service": null,
	"three_ds_level": "mandate_challenge",
	"total_earned_usd": 3450,
	"ads_spend_usd": 180.25,
	"volume_usd": 4250.5,
	"volume_l30d_usd": 1200,
	"customers_l30d": 24,
	"level": {
		"current": 1,
		"points": 41000,
		"points_by_source": {
			"cards": 40000,
			"ads": 0,
			"trading": 1000,
			"partners": 0
		},
		"resets_at": "2026-11-01T04:00:00.000Z",
		"account_level": 0
	},
	"social_links": [
		{
			"id": "social_petalpost123",
			"title": "Petal Post",
			"url": "https://petalpost.example",
			"website": "website"
		}
	],
	"store_page_config": {
		"accent_color": "red",
		"layout": "compact",
		"profile_variant": "business",
		"whop_affiliate_link": true
	},
	"target_audience": "Customers sending flowers locally",
	"tax_collection_enabled_states": ["CA", "NY"],
	"tax_remitted_by": "whop",
	"tax_type": "exclusive",
	"product_tax_code": {
		"id": "ptc_CzLNn2Z058xEC1",
		"name": "Digital Group Chat",
		"product_type": "digital"
	},
	"business_address": {
		"line1": "123 Garden Way",
		"line2": null,
		"city": "Austin",
		"state": "TX",
		"postal_code": "78701",
		"country": "US"
	},
	"business_name": "Petal Post, LLC",
	"tax_identifiers": [
		{
			"id": "taxid_petalpost123",
			"tax_id_type": "us_ein",
			"tax_id_value": "12-3456789"
		}
	],
	"title": "Petal Post",
	"total_usd": "1300.50",
	"use_logo_as_opengraph_image_fallback": true,
	"verification": {
		"business": null,
		"individual": {
			"status": "approved"
		}
	},
	"wallet": {
		"id": "wallet_petalpost123",
		"address": "So11111111111111111111111111111111111111112",
		"network": "solana"
	}
}
```

## Bedrijfstypen en branches

Drie velden classificeren accounts: `business_type`, `industry_group` en `industry_type`. De volledige taxonomie staat op een eigen pagina:

> [card] [Bedrijfstypen en branches](https://docs.whop.com/nl/api-reference/accounts/business-types.md)


## Related topics

- [External Accounts API](https://docs.whop.com/nl/api-reference/external-accounts/external-account.md)
- [List Accounts](https://docs.whop.com/nl/api-reference/accounts/list-accounts.md)
- [Update Account](https://docs.whop.com/nl/api-reference/accounts/update-account.md)
