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

# API de Accounts

> Un Account representa a una persona o un negocio en Whop que puede tener su propio perfil, su billetera y ajustes con alcance de cuenta.

Usa las cuentas para los clientes, creadores, comerciantes, vendedores o negocios conectados que admita tu integración.

Usa la API de Accounts para crear cuentas, listar las cuentas visibles para tus credenciales, recuperar o actualizar una cuenta, suspender o eliminar una subcuenta gestionada por tu plataforma y recuperar la cuenta asociada a la clave de API actual.

Los campos `business_type`, `industry_group` e `industry_type` clasifican las cuentas. Consulta el [glosario de tipos de negocio e industrias](#business-types-and-industries) para ver todos los valores válidos.

## Endpoints

| Endpoint | Solicitud |
| - | - |
| [Listar cuentas](https://docs.whop.com/es/api-reference/accounts/list-accounts.md) | GET `/accounts` |
| [Recuperar una cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account.md) | GET `/accounts/{id}` |
| [Recuperar el seguimiento de clientes de una cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account-customer-tracking.md) | GET `/accounts/{account_id}/customer_tracking` |
| [Recuperar las comisiones de una cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account-fees.md) | GET `/accounts/{account_id}/fees` |
| [Listar proveedores de financiación](https://docs.whop.com/es/api-reference/accounts/list-financing-providers.md) | GET `/accounts/{account_id}/financing_providers` |
| [Recuperar las preferencias de una cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account-preferences.md) | GET `/accounts/{account_id}/preferences` |
| [Listar las reservas de una cuenta](https://docs.whop.com/es/api-reference/accounts/list-account-reserves.md) | GET `/accounts/{account_id}/reserves` |
| [Crear una cuenta](https://docs.whop.com/es/api-reference/accounts/create-account.md) | POST `/accounts` |
| [Constituir una empresa](https://docs.whop.com/es/api-reference/accounts/form-company.md) | POST `/accounts/{id}/form_company` |
| [Reintentar pagos de anuncios fallidos](https://docs.whop.com/es/api-reference/accounts/retry-failed-ads-payments.md) | POST `/accounts/{id}/retry_ads_payment` |
| [Suspender una subcuenta](https://docs.whop.com/es/api-reference/accounts/suspend-a-subaccount.md) | POST `/accounts/{id}/suspend` |
| [Transferir la propiedad de una cuenta](https://docs.whop.com/es/api-reference/accounts/transfer-account-ownership.md) | POST `/accounts/{id}/transfer_ownership` |
| [Actualizar una cuenta](https://docs.whop.com/es/api-reference/accounts/update-account.md) | PATCH `/accounts/{id}` |
| [Actualizar las comisiones de una cuenta](https://docs.whop.com/es/api-reference/accounts/update-account-fees.md) | PATCH `/accounts/{account_id}/fees` |
| [Actualizar las preferencias de una cuenta](https://docs.whop.com/es/api-reference/accounts/update-account-preferences.md) | PATCH `/accounts/{account_id}/preferences` |
| [Eliminar una subcuenta](https://docs.whop.com/es/api-reference/accounts/delete-a-subaccount.md) | DELETE `/accounts/{id}` |

## Recargos de comisiones

Los recargos de comisiones permiten a una plataforma añadir cargos o subvencionar las comisiones de pago de sus subcuentas. Gestiónalos a través del documento de comisiones de la cuenta: define valores predeterminados en la cuenta de plataforma o anula comisiones individuales en una subcuenta. Consulta [Recargos y subvenciones de comisiones](https://docs.whop.com/es/developer/platforms/fee-markups.md) para ver ejemplos, límites y requisitos de financiación.

### Endpoints de comisiones

| Acción | Endpoint | Método del SDK |
| - | - | - |
| [Recuperar las comisiones de una cuenta](https://docs.whop.com/es/api-reference/accounts/retrieve-account-fees.md) | `GET /api/v1/accounts/{account_id}/fees` | `client.accounts.fees.retrieve(accountId)` |
| [Actualizar las comisiones de una cuenta](https://docs.whop.com/es/api-reference/accounts/update-account-fees.md) | `PATCH /api/v1/accounts/{account_id}/fees` | `client.accounts.fees.update(accountId, changes)` |

Usa la clave de API de la cuenta de plataforma con el permiso `company:update_child_fees` para configurar los recargos. Cada recargo devuelto incluye `adjustable` y `unadjustable_reason` para que tu integración pueda determinar si se puede editar.

### Leer las comisiones

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

La sección `markups` contiene las tasas efectivas de la subcuenta. La sección `child_markups` de una cuenta de plataforma contiene sus valores predeterminados para las subcuentas.

El `source` de un recargo es `custom` cuando se ha configurado en ese nivel, o `default` cuando recurre a una tasa heredada o a cero. Su campo `default` muestra la tasa que se aplicaría si se borrara el recargo personalizado. Los importes fijos devueltos usan el objeto Money; las actualizaciones aceptan `fixed` como un número en dólares estadounidenses.

### Definir los valores predeterminados de la plataforma

Actualiza `child_markups` en la cuenta de plataforma. Este ejemplo define un recargo de pago del 2 % sin cargo fijo:

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

`percentage: 2` significa 2 %. Los valores predeterminados se aplican a las subcuentas que no tienen una anulación para esa comisión. Los recargos de pago se aplican cuando no se ha definido ninguna comisión de aplicación en el checkout.

### Definir una anulación para una subcuenta

Actualiza `markups` en la subcuenta. Este ejemplo sustituye su recargo de pago heredado por un 1 % más 0,25 \$:

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

Solo cambian las claves que envías. Para otros tipos de transacciones, usa `transfers`, `crypto_swaps`, `deposits` indexado por vía de pago, o `payouts` indexado por método de pago. Consulta el [endpoint de actualización](https://docs.whop.com/es/api-reference/accounts/update-account-fees.md) para ver las claves admitidas y el esquema de la solicitud.

### Borrar un recargo

Envía `null` para el recargo para borrarlo. Borrar la anulación de una subcuenta restaura el valor predeterminado de su plataforma, o cero si no hay ningún valor predeterminado configurado:

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

Para borrar un valor predeterminado de la plataforma, envía `child_markups: { payments: null }` a la cuenta de plataforma. Un `{ percentage: 0, fixed: 0 }` explícito sigue siendo una tasa configurada; usa `null` para restaurar la herencia.

## Documentos legales

Una cuenta publica sus documentos legales como archivos PDF: `terms_of_service`, `privacy_policy`, `return_policy`, `cancellation_policy`, `shipping_policy` y `eula`. Cada uno se lee como un [File](https://docs.whop.com/es/api-reference/files/file) y se define mediante [Update Account](https://docs.whop.com/es/api-reference/accounts/update-account.md) con el `id` de un archivo que hayas [subido](https://docs.whop.com/es/developer/guides/upload-files.md).

Las nuevas disputas toman de forma predeterminada las pruebas de sus políticas de estos documentos. El espacio de la política de cancelación usa `cancellation_policy`, después `terms_of_service` y después `return_policy`. El espacio de la política de reembolso usa `return_policy` y después `terms_of_service`. Cualquiera de los dos espacios recurre a la política de la plataforma Whop cuando no hay ninguno definido, y `shipping_policy` se incluye en las disputas de bienes físicos. Defínelos una vez aquí y usa [Upload Dispute Evidence](https://docs.whop.com/es/api-reference/disputes/upload-dispute-evidence.md) solo cuando una disputa necesite una versión distinta de una política.

```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},
)
```

Envía `null` para un documento para eliminarlo. Solo se aceptan archivos PDF.

## Atributos

**id** `string` *required*

ID de la cuenta, con el prefijo `biz_`.

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

Gasto publicitario cobrado durante toda la vida de la cuenta, en USD. Solo se calcula en `list` para quienes llaman con `stats:read` en la cuenta; `null` en caso contrario.

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

Activos de la cuenta, cada uno con su valor en USD. Vacío cuando `total_usd` es `null`.

> [accordion] Propiedades
>
> **balance** `string` *required*
>
> Importe total mantenido en unidades nativas, como cadena decimal.
>
> **breakdown** `object` *required*
>
> Saldo dividido en importes disponibles, pendientes y en reserva, como cadenas decimales en unidades nativas, con los días en que se espera que se liquide el importe pendiente.
>
> > [accordion] Propiedades
> >
> > **available** `string` *required*
> >
> > Importe que puedes gastar, enviar o retirar ahora, en unidades nativas, como cadena decimal.
> >
> > **finishing\_settlement** `string` *required*
> >
> > La parte de `pending` que ya se ha liquidado y está esperando para pasar a la billetera de criptomonedas o a la Whop Card de la cuenta, donde pasa a ser `available`. El movimiento suele empezar en menos de una hora; mientras se ejecuta, el importe se informa en `in_transit`. No se incluye el dinero movido solo para recargar el saldo mínimo retenido de la cuenta. En unidades nativas, como cadena decimal.
> >
> > **in\_transit** `string` *required*
> >
> > Importe que se mueve entre los propios destinos de la cuenta, como una recarga de tarjeta. En unidades nativas, como cadena decimal.
> >
> > **pending** `string` *required*
> >
> > Importe de pagos recientes que aún se están liquidando, en unidades nativas, como cadena decimal.
> >
> > **pending\_settlements** `object[]` *required*
> >
> > Cuándo se espera que se liquide el importe pendiente, una entrada por día, empezando por la más temprana. El dinero sin un día de liquidación programado, incluido `finishing_settlement`, queda fuera, por lo que estas entradas más `finishing_settlement` pueden sumar menos que `pending`, nunca más.
> >
> > > [accordion] Propiedades
> > >
> > > **amount** `string` *required*
> > >
> > > Importe esperado ese día, en unidades nativas, como cadena decimal.
> > >
> > > **date** `string` *required*
> > >
> > > El día en que se espera que este dinero termine de liquidarse, como fecha ISO 8601.
> >
> > **reserve** `string` *required*
> >
> > Importe retenido, en unidades nativas, como cadena decimal. Recupera las reservas de la cuenta para saber por qué se retiene y cuándo se libera.
>
> **icon\_url** `string | null` *required*
>
> URL del icono del activo.
>
> **name** `string` *required*
>
> El nombre visible del activo
>
> **price\_usd** `number | null` *required*
>
> Precio en USD por unidad, o `null` cuando no hay ningún tipo de cambio disponible.
>
> **symbol** `string` *required*
>
> Símbolo visible del activo, como `USDT`, `cbBTC` o `EUR`.
>
> **value\_usd** `string | null` *required*
>
> Valor en USD del activo, o `null` cuando no hay ningún tipo de cambio disponible.

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

URL de la imagen de banner de la cuenta.

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

Dirección comercial de la cuenta usada para calcular impuestos, con `line1`, `line2`, `city`, `state`, `postal_code` y `country`. `null` cuando no hay ninguna dirección definida.

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

La razón social de la cuenta usada con su dirección fiscal.

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

Categoría de negocio general de la cuenta. Consulta el [glosario de tipos de negocio e industrias](https://docs.whop.com/es/api-reference/accounts/account#business-types-and-industries-glossary) para ver los valores válidos.

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

Si los fondos pendientes pueden transferirse desde esta cuenta de plataforma a sus subcuentas.

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

El documento de política de cancelación de la cuenta, o `null` si no ha publicado ninguno.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del archivo, con el prefijo `file_`.
>
> **blurhash** `string | null` *required*
>
> Marcador de posición BlurHash para una imagen o un vídeo. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **content\_type** `string | null` *required*
>
> El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el archivo, como marca de tiempo ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Duración del audio o del vídeo en segundos. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **filename** `string | null` *required*
>
> El nombre de archivo original, incluida su extensión.
>
> **height** `integer | null` *required*
>
> Altura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **multipart\_chunk\_size** `integer | null`
>
> El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_id** `string | null`
>
> El ID de la carga multiparte, que se devuelve a `complete`. Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_urls** `object[] | null`
>
> La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.
>
> > [accordion] Propiedades
> >
> > **part\_number** `integer` *required*
> >
> > El índice, empezando por 1, de esta parte dentro de la carga multiparte.
> >
> > **url** `string` *required*
> >
> > La URL prefirmada a la que enviar con PUT los bytes de esta parte.
>
> **object** `string` *required*
>
> El tipo de este objeto, siempre `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de sustitución. `filename`, `size` y `content_type` siguen describiendo el archivo original.
>
> **size** `integer | null` *required*
>
> El tamaño del archivo en bytes. `null` hasta que la carga haya terminado.
>
> **upload\_headers** `object`
>
> Cabeceras que se deben enviar con el PUT de la carga. Solo está presente al crear.
>
> **upload\_status** `string` *required*
>
> En qué punto del ciclo de vida de la carga se encuentra el archivo.
>
> Opciones disponibles: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
>
> **url** `string | null` *required*
>
> Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los archivos privados obtienen una URL firmada que caduca. `null` hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.
>
> **visibility** `string` *required*
>
> Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
>
> Opciones disponibles: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forma de onda del audio. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **width** `integer | null` *required*
>
> Anchura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.

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

Vías de pago habilitadas para esta cuenta, cada una `active`, `inactive` o `pending` (incorporación o revisión en curso). Solo se calcula en `retrieve` y `me` para quienes llaman con el alcance `company:balance:read`; `null` en caso contrario.

> [accordion] Propiedades
>
> **accept\_bank\_payments** `string` *required*
>
> Cobros bancarios: débitos, transferencias y vías bancarias locales
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **accept\_bnpl\_payments** `string` *required*
>
> Cobros de compra ahora y paga después; requiere aprobación
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **accept\_card\_payments** `string` *required*
>
> Cobros con tarjeta, incluidos Apple Pay y Google Pay
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **bank\_deposit** `string` *required*
>
> Depósitos por transferencia bancaria o ACH a la cuenta bancaria virtual de la cuenta
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **card\_deposit** `string` *required*
>
> Recargas de saldo cobrando a un método de pago almacenado
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **card\_issuing** `string` *required*
>
> Emisión de tarjetas Whop; requiere la aprobación de la solicitud de tarjeta
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **crypto\_deposit** `string` *required*
>
> Depósitos on-chain a la billetera de criptomonedas de la cuenta
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **crypto\_payout** `string` *required*
>
> Pagos on-chain a una billetera de criptomonedas
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **instant\_payout** `string` *required*
>
> Pagos instantáneos a un destino de pago apto
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **run\_ads** `string` *required*
>
> Lanzamiento de campañas publicitarias a través de Whop Ads. `inactive` hasta que se verifique la identidad o el negocio de la cuenta, mientras un acuerdo de servicios publicitarios solicitado esté pendiente de la firma de la cuenta y mientras la cuenta esté suspendida de Whop Ads.
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **standard\_payout** `string` *required*
>
> Pagos estándar a un destino de pago externo
>
> Opciones disponibles: `active`, `inactive`, `pending`
>
> **transfer** `string` *required*
>
> Transferencias a otras cuentas
>
> Opciones disponibles: `active`, `inactive`, `pending`

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

Detalles de la solicitud de Whop Cards de la cuenta. Se devuelve en `list`, `retrieve` y `me` para quienes llaman con el alcance `company:balance:read`; `null` en caso contrario, o cuando la cuenta no tiene ninguna solicitud de tarjeta ni ninguna revisión de solicitud bloqueante.

> [accordion] Propiedades
>
> **decline\_reason** `string | null` *required*
>
> Motivo por el que el emisor de la tarjeta rechazó la solicitud. `unsupported_state` sustituye a `unsupported_region` para una persona o un negocio verificado en Estados Unidos. `compliance` abarca las comprobaciones de sanciones, personas expuestas políticamente y medios adversos. `other` abarca los motivos que no están en esta lista. `null` cuando `status` no es `denied`, o cuando el emisor no rechazó la solicitud.
>
> Opciones disponibles: `compromised_identity`, `duplicate`, `unsupported_region`, `compliance`, `fraud`, `verification_failed`, `unsupported_state`, `other`
>
> **kind** `string | null` *required*
>
> Si la solicitud de tarjeta verifica un negocio (`business`, KYB) o una persona (`individual`, identidad del consumidor). `null` cuando la solicitud aún no está vinculada a una verificación.
>
> Opciones disponibles: `individual`, `business`
>
> **status** `string` *required*
>
> En qué estado se encuentra la solicitud de tarjeta. `approved` significa que se pueden emitir tarjetas. `needs_verification` significa que el solicitante aún no ha completado la verificación de identidad; `needs_information` significa que sí lo hizo, pero los documentos se rechazaron por un motivo subsanable y deben volver a enviarse. `pending` y `manual_review` están en curso. `denied`, `locked` y `canceled` son definitivos.
>
> Opciones disponibles: `approved`, `pending`, `manual_review`, `denied`, `locked`, `canceled`, `needs_verification`, `needs_information`

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

Si el checkout muestra un campo de NIF-IVA/ID fiscal para que los compradores lo introduzcan de forma opcional. No exige un NIF-IVA para comprar.

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

Estado de constitución de la empresa de la cuenta, gestionado a través de [Form Company](https://docs.whop.com/es/api-reference/accounts/form-company.md). Un `status` `draft` hasta que se paga el checkout de constitución; después, el progreso de la presentación con documentos descargables y firmas pendientes. Vacío cuando el estado de constitución no está disponible temporalmente.

> [accordion] Propiedades
>
> **documents** `object[]`
>
> Documentos de constitución disponibles para descargar, como los Articles of Organization y la carta de confirmación del EIN. Presentes una vez que `status` deja de ser `draft`.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID del documento, con el prefijo `file_`.
> >
> > **name** `string` *required*
> >
> > Nombre del documento legible para personas, como `Articles of Organization`.
> >
> > **type** `string` *required*
> >
> > Categoría del documento: `articles_of_organization`, `operating_agreement`, `ein_letter`, `signed_ss4`, `signed_form8821` o `mail` para la correspondencia postal recibida en nombre de la empresa.
> >
> > **url** `string` *required*
> >
> > URL de CDN para descargar el documento.
>
> **ein\_registered** `boolean`
>
> Si el IRS ha emitido el EIN de la empresa. Presente una vez que `status` deja de ser `draft`.
>
> **legal\_name** `string | null`
>
> Nombre registrado de la empresa, incluida la terminación de la entidad, por ejemplo `Acme, LLC`. Presente una vez que `status` deja de ser `draft`.
>
> **signatures** `object`
>
> Formularios del IRS pendientes de la firma de un fundador, cada uno con una URL de firma alojada. Presente una vez que `status` deja de ser `draft`; vacío cuando no hay nada que firmar.
>
> > [accordion] Propiedades
> >
> > **form8821** `object`
> >
> > Estado de la firma del formulario 8821 del IRS, la autorización de información fiscal. Solo está presente mientras el formulario aún requiere una acción del fundador.
> >
> > > [accordion] Propiedades
> > >
> > > **expires\_at** `string`
> > >
> > > Cuándo caduca la URL de firma, como marca de tiempo ISO 8601. Solo está presente cuando se incluye la URL de firma.
> > >
> > > **status** `string` *required*
> > >
> > > `pending` cuando hay una sesión de firma lista para el fundador; `unknown` cuando no se pudo determinar el estado de la firma.
> > >
> > > Opciones disponibles: `pending`, `unknown`
> > >
> > > **url** `string`
> > >
> > > URL de firma alojada donde el fundador completa el formulario. Presente mientras `status` es `pending` y quien llama tiene `incorporation:write`. Se omite en los webhooks.
> >
> > **ss4** `object`
> >
> > Estado de la firma del formulario SS-4 del IRS, la solicitud del EIN. Solo está presente mientras el formulario aún requiere una acción del fundador.
> >
> > > [accordion] Propiedades
> > >
> > > **expires\_at** `string`
> > >
> > > Cuándo caduca la URL de firma, como marca de tiempo ISO 8601. Solo está presente cuando se incluye la URL de firma.
> > >
> > > **status** `string` *required*
> > >
> > > `pending` cuando hay una sesión de firma lista para el fundador; `unknown` cuando no se pudo determinar el estado de la firma.
> > >
> > > Opciones disponibles: `pending`, `unknown`
> > >
> > > **url** `string`
> > >
> > > URL de firma alojada donde el fundador completa el formulario. Presente mientras `status` es `pending` y quien llama tiene `incorporation:write`. Se omite en los webhooks.
>
> **state\_registered** `boolean`
>
> Si la presentación de constitución ante el estado está completa. Presente una vez que `status` deja de ser `draft`.
>
> **status** `string`
>
> Opciones disponibles: `draft`, `processing`, `filed`, `rejected`, `completed`

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

País en el que se encuentra la cuenta.

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

Cuándo se creó la cuenta, como marca de tiempo ISO 8601.

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

Clientes distintos con un recibo pagado en la cuenta en los últimos 30 días, actualizado cada pocas horas. Solo se calcula en `retrieve` para quienes llaman con `stats:read` en la cuenta; `null` en caso contrario y cuando el recuento no está disponible.

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

Descripción promocional de la cuenta.

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

Cuántos miembros del equipo dependen directamente del negocio, sin ningún responsable por encima. Presente en las lecturas de una sola cuenta.

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

Si Whop reúne y presenta las pruebas de las disputas de esta cuenta. Activarlo suscribe a la cuenta a la comisión por éxito que se cobra en las disputas que gana.

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

Si Economic Intelligence está activado para la cuenta. Se desactiva automáticamente cuando termina su periodo contratado. Mientras está desactivado, la cuenta no puede activar un experimento ni ejecutar una recomendación.

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

Dirección de correo electrónico del propietario de la cuenta.

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

El documento de acuerdo de licencia de usuario final de la cuenta, o `null` si no ha publicado ninguno.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del archivo, con el prefijo `file_`.
>
> **blurhash** `string | null` *required*
>
> Marcador de posición BlurHash para una imagen o un vídeo. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **content\_type** `string | null` *required*
>
> El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el archivo, como marca de tiempo ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Duración del audio o del vídeo en segundos. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **filename** `string | null` *required*
>
> El nombre de archivo original, incluida su extensión.
>
> **height** `integer | null` *required*
>
> Altura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **multipart\_chunk\_size** `integer | null`
>
> El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_id** `string | null`
>
> El ID de la carga multiparte, que se devuelve a `complete`. Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_urls** `object[] | null`
>
> La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.
>
> > [accordion] Propiedades
> >
> > **part\_number** `integer` *required*
> >
> > El índice, empezando por 1, de esta parte dentro de la carga multiparte.
> >
> > **url** `string` *required*
> >
> > La URL prefirmada a la que enviar con PUT los bytes de esta parte.
>
> **object** `string` *required*
>
> El tipo de este objeto, siempre `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de sustitución. `filename`, `size` y `content_type` siguen describiendo el archivo original.
>
> **size** `integer | null` *required*
>
> El tamaño del archivo en bytes. `null` hasta que la carga haya terminado.
>
> **upload\_headers** `object`
>
> Cabeceras que se deben enviar con el PUT de la carga. Solo está presente al crear.
>
> **upload\_status** `string` *required*
>
> En qué punto del ciclo de vida de la carga se encuentra el archivo.
>
> Opciones disponibles: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
>
> **url** `string | null` *required*
>
> Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los archivos privados obtienen una URL firmada que caduca. `null` hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.
>
> **visibility** `string` *required*
>
> Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
>
> Opciones disponibles: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forma de onda del audio. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **width** `integer | null` *required*
>
> Anchura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.

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

El identificador propio de la plataforma principal para esta subcuenta, único entre las subcuentas de la plataforma. `null` cuando no está definido.

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

La solicitud de financiación más reciente de la cuenta. Solo se calcula en `retrieve` y `me` para quienes llaman con el alcance `company:balance:read`; `null` en caso contrario, o cuando la cuenta nunca ha solicitado financiación.

> [accordion] Propiedades
>
> **application\_id** `string` *required*
>
> El ID de la solicitud de financiación más reciente de la cuenta, que empieza por inrq\_. Recupérala para ver los requisitos y los comentarios de la revisión.
>
> **status** `string` *required*
>
> El estado de revisión de la solicitud de financiación más reciente: `requires_collection` (a la espera del comerciante, incluso después de una solicitud de más información), `awaiting_review`, `approved`, `denied` o `completed`. Si los métodos de pago con financiación están habilitados se indica en `capabilities.accept_bnpl_payments`.
>
> Opciones disponibles: `requires_collection`, `awaiting_review`, `completed`, `approved`, `denied`

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

Cuándo una cuenta suspendida puede pagar su saldo a su propio método de pago, como marca de tiempo ISO 8601. Una disputa puede retrasarlo. Se calcula en `retrieve`, `me` y `suspend`; `null` en caso contrario, cuando `status` no es `suspended` y cuando la suspensión retiene el saldo.

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

Preferencias de la página de inicio pública de la cuenta.

Opciones disponibles: `hide_member_count`, `hide_members_card`

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

Vertical de industria específico de la cuenta. Consulta el [glosario de tipos de negocio e industrias](https://docs.whop.com/es/api-reference/accounts/account#business-types-and-industries-glossary) para ver los valores válidos.

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

Prefijo usado para las facturas de la cuenta.

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

El progreso en Whop Levels del `owner` de la cuenta, contabilizado en todas las cuentas que posee, por lo que todas muestran el mismo nivel. Solo se calcula en `retrieve` y `me` para quienes llaman con el alcance `company:basic:read`; `null` en caso contrario y cuando la cuenta no está en Whop Levels.

> [accordion] Propiedades
>
> **account\_level** `integer` *required*
>
> El nivel propio de esta cuenta solo a partir de sus puntos, de `0` a `10`. `current` es mayor cuando las otras cuentas del propietario lo elevan.
>
> **current** `integer` *required*
>
> El nivel que se aplica: el más alto que alcanzó el propietario este mes o en los 5 meses anteriores, de `0` a `10`.
>
> **points** `integer` *required*
>
> Puntos obtenidos este mes en todas las cuentas que posee el propietario, más los puntos de socio del propietario, redondeados hacia abajo. Una cuenta cuyo mes da un saldo neto inferior a cero cuenta como cero.
>
> **points\_by\_source** `object` *required*
>
> Los puntos de este mes, desglosados según dónde se obtuvieron. Cada origen es neto de sus reembolsos, por lo que uno puede ser negativo.
>
> > [accordion] Propiedades
> >
> > **ads** `integer` *required*
> >
> > Puntos de los cargos pagados de Whop Ads, netos de reembolsos: 10 por cada dólar, redondeados hacia cero.
> >
> > **cards** `integer` *required*
> >
> > Puntos del gasto capturado con Whop Card, netos de reembolsos: 10 por cada dólar, redondeados hacia cero.
> >
> > **partners** `integer` *required*
> >
> > Puntos de las cuentas que el propietario refirió como socio: 1 por cada 3 que ganen, redondeados hacia cero.
> >
> > **trading** `integer` *required*
> >
> > Puntos del volumen de trading de perpetuos ejecutado a través de Whop: 1 por cada dólar negociado, redondeados hacia cero.
>
> **resets\_at** `string` *required*
>
> Cuándo se restablecen a cero los puntos de este mes, como marca de tiempo ISO 8601.

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

URL de la imagen del logotipo de la cuenta.

**metadata** `object` *required*

Metadatos arbitrarios de clave/valor proporcionados al crear la cuenta.

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

Tipo de incorporación que ha completado la cuenta.

Opciones disponibles: `platform`, `seller`

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

URL de la imagen Open Graph de la cuenta.

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

Variante de la imagen Open Graph de la cuenta.

Opciones disponibles: `white`, `black`, `orange`

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

Si la orquestación de pagos está habilitada para esta cuenta.

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

Detalles del tipo de negocio cuando business\_type es `other`.

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

Detalles de la industria cuando industry\_type es `other`.

**owner** `object` *required*

El único usuario propietario de la cuenta, cuyo correo electrónico es el `email` anterior. Es distinto del rol `owner` de los miembros del equipo, que puede tener cualquier número de ellos.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del usuario, con el prefijo `user_`.
>
> **name** `string | null` *required*
>
> Nombre visible.
>
> **profile\_picture** `object` *required*
>
> Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no ha definido ninguna imagen.
>
> > [accordion] Propiedades
> >
> > **url** `string` *required*
> >
> > URL de la imagen del avatar. Siempre está presente. Es un marcador de posición generado cuando el usuario no ha definido ninguna imagen.
>
> **username** `string` *required*
>
> Nombre de usuario público.

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

Cuenta principal de las subcuentas, o `null` para las cuentas independientes.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la cuenta, con el prefijo `biz_`.
>
> **fees** `object`
>
> Tasas de recargo que esta cuenta principal cobra a la subcuenta que se está leyendo, indexadas por tipo de comisión (por ejemplo, `crypto_deposit_markup`), cada una con `percentage_fee` y `fixed_fee_usd`. Se resuelven dando prioridad a las anulaciones propias de la subcuenta sobre el valor predeterminado de la plataforma.
>
> **logo\_url** `string | null` *required*
>
> URL de la imagen del logotipo de la cuenta.
>
> **route** `string` *required*
>
> Identificador de la ruta pública de la cuenta.
>
> **title** `string` *required*
>
> Nombre visible de la cuenta.

**partner** `object | null`

El socio de primer nivel activo de la cuenta. Presente en las respuestas de recuperación; null cuando no hay ningún socio de primer nivel activo atribuido a la cuenta. Se omite en otras respuestas.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del usuario, con el prefijo `user_`.
>
> **email** `string | null` *required*
>
> Dirección de correo electrónico para contactar con el socio. Null cuando el socio no ha añadido su propia dirección de correo electrónico.
>
> **name** `string | null` *required*
>
> Nombre visible.
>
> **profile\_picture** `object` *required*
>
> Contenedor del avatar. Su `url` siempre está presente y es un marcador de posición generado cuando el usuario no ha definido ninguna imagen.
>
> > [accordion] Propiedades
> >
> > **url** `string` *required*
> >
> > URL de la imagen del avatar. Siempre está presente. Es un marcador de posición generado cuando el usuario no ha definido ninguna imagen.
>
> **referring\_account** `object | null` *required*
>
> Negocio en nombre del cual el socio refirió esta cuenta, cuando la referencia pertenece a su equipo. `null` para una referencia personal.
>
> > [accordion] Propiedades
> >
> > **id** `string` *required*
> >
> > ID de la cuenta, con el prefijo `biz_`.
> >
> > **title** `string` *required*
> >
> > Nombre visible de la cuenta.
>
> **username** `string` *required*
>
> Nombre de usuario público.
>
> **whop\_partner\_verified\_at** `string | null` *required*
>
> Cuándo el usuario se convirtió en Whop Partner verificado, como marca de tiempo ISO 8601. Null si no está verificado.

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

Controles de salud de pagos aplicados actualmente a la cuenta. Solo se calcula en `retrieve` y `me` para quienes llaman con el alcance `company:balance:read`; `null` en caso contrario.

> [accordion] Propiedades
>
> **dispute\_alert\_auto\_refund** `object` *required*
>
> Ajustes de reembolso automático para las alertas de disputa previas al contracargo.
>
> > [accordion] Propiedades
> >
> > **locked** `boolean` *required*
> >
> > Si se impide al propietario de la cuenta cambiar este umbral.
> >
> > **threshold\_usd** `number | null` *required*
> >
> > Importe máximo de alerta de disputa que se reembolsa automáticamente, en USD. `null` cuando los reembolsos automáticos están desactivados.
>
> **dispute\_alert\_fee\_usd** `number | null` *required*
>
> Comisión cobrada por cada alerta de disputa, en USD. `null` cuando no está disponible.
>
> **enforce\_3ds** `boolean` *required*
>
> Si se fuerza 3-D Secure en todos los pagos con tarjeta en el checkout. La cuenta no puede omitirlo mientras esté activado.
>
> **financing\_disabled** `boolean` *required*
>
> Si los controles de salud de pagos desactivan explícitamente la financiación. Es independiente de la aprobación de financiación en `capabilities.accept_bnpl_payments`.
>
> **high\_risk\_processing\_fee\_percentage** `number` *required*
>
> Porcentaje de comisión de procesamiento adicional para el procesamiento de alto riesgo.
>
> **payment\_method\_warnings** `object[]` *required*
>
> Métodos de pago sobre los que se ha advertido a la cuenta de que se acercan a su límite de tasa de disputas. Cada entrada incluye `payment_method`, `measure` (`disputes`, `disputes_and_tc40s` o `fraud_disputes`), `warned_at` como marca de tiempo ISO 8601, y `rate`, `warning_rate` y `target_rate` como fracciones en las que `0.01` es el 1 %. Vacío cuando no hay ninguno advertido. Un método advertido se pausa, y aparece en `restricted_payment_methods`, si sigue por encima de su tasa objetivo unas cuatro semanas después.
>
> **pending\_auto\_topup\_fee\_percentage** `number` *required*
>
> Porcentaje de comisión cobrado cuando se adelanta saldo pendiente, aún no liquidado, para financiar el saldo de tarjetas de la cuenta, donde `2` significa 2 %. `0` cuando la cuenta está exenta.
>
> **pending\_balance\_delay\_days** `integer` *required*
>
> Días adicionales que los pagos permanecen pendientes antes de estar disponibles.
>
> **reserve** `object` *required*
>
> Reserva aplicada actualmente al volumen de pagos entrantes.
>
> > [accordion] Propiedades
> >
> > **hold\_period\_days** `integer` *required*
> >
> > Número de días que se retienen los fondos reservados antes de liberarlos.
> >
> > **percentage** `number | null` *required*
> >
> > Porcentaje del volumen de pagos entrantes retenido en reserva. `null` cuando no se aplica ninguna reserva.
>
> **resolution\_center\_auto\_refund** `object` *required*
>
> Ajustes de reembolso automático para los casos del centro de resolución.
>
> > [accordion] Propiedades
> >
> > **card\_threshold\_usd** `number | null` *required*
> >
> > Importe máximo de los casos del centro de resolución financiados con tarjeta que se reembolsa automáticamente, en USD. `null` cuando los reembolsos automáticos están desactivados para tarjetas.
> >
> > **financing\_threshold\_usd** `number | null` *required*
> >
> > Importe máximo de los casos del centro de resolución financiados con financiación que se reembolsa automáticamente, en USD. `null` cuando los reembolsos automáticos están desactivados para la financiación.
> >
> > **locked** `boolean` *required*
> >
> > Si se impide al propietario de la cuenta cambiar estos umbrales.
> >
> > **paypal\_threshold\_usd** `number | null` *required*
> >
> > Importe máximo de los casos del centro de resolución financiados con PayPal que se reembolsa automáticamente, en USD. `null` cuando los reembolsos automáticos están desactivados para PayPal.
>
> **restricted\_payment\_methods** `string[]` *required*
>
> Marcas de tarjeta bloqueadas en el checkout para esta cuenta. Vacío cuando no hay ninguna bloqueada. La cuenta no puede volver a habilitarlas por sí misma.
>
> Opciones disponibles: `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*
>
> Por qué los fondos pendientes sin fecha de liquidación aún no se mueven. `kyc_incomplete`, `pending_information_request` y `update_payout_profile` son cuestiones sobre las que el comerciante puede actuar. `compliance_review` significa que se está revisando una verificación que el comerciante ya envió, por lo que estos fondos siguen pendientes hasta que se apruebe. `withdrawals_disabled` significa que Whop ha bloqueado los retiros, por lo que estos fondos no pueden pasar a estar disponibles. `null` cuando no hay ningún motivo que mostrar: aún se están liquidando o se retienen por un motivo que no se indica aquí.
>
> Opciones disponibles: `kyc_incomplete`, `pending_information_request`, `update_payout_profile`, `compliance_review`, `withdrawals_disabled`
>
> **withdrawal\_schedule** `object` *required*
>
> Cómo se retira automáticamente el saldo de la cuenta.
>
> > [accordion] Propiedades
> >
> > **day** `integer | null` *required*
> >
> > Día en que se ejecuta el retiro automático: 0-6 (domingo-sábado) para `weekly`, 1-31 para `monthly`. `null` para `manual` y `daily`.
> >
> > **frequency** `string` *required*
> >
> > Con qué frecuencia se retira automáticamente el saldo de la cuenta.
> >
> > Opciones disponibles: `manual`, `daily`, `weekly`, `monthly`
> >
> > **next\_payout\_date** `string | null` *required*
> >
> > Próxima fecha en la que está programado el retiro automático, como fecha ISO 8601. `null` para `manual` y `daily`, en los que no aplica una única fecha siguiente.

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

Los métodos de pago predeterminados de la cuenta en el checkout. El `payment_method_configuration` propio de una variante o de una configuración de checkout tiene prioridad. `null` cuando la cuenta usa los valores predeterminados de la plataforma Whop.

> [accordion] Propiedades
>
> **disabled** `string[]` *required*
>
> Métodos de pago que este checkout excluye, incluso cuando los valores predeterminados los ofrecerían.
>
> **enabled** `string[]` *required*
>
> Métodos de pago que este checkout ofrece además de los que proporcionan los valores predeterminados.
>
> **include\_platform\_defaults** `boolean` *required*
>
> Si el conjunto predeterminado de Whop es el punto de partida. Cuando es `false`, solo se ofrece `enabled`.

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

Créditos de plataforma emitidos por Whop por divisa, leídos de la caché de saldos. Los créditos solo pueden gastarse en productos aptos de Whop, como Whop Ads, nunca pueden retirarse y no se incluyen en `balances` ni en `total_usd`. Vacío cuando la cuenta no tiene ninguno o `total_usd` es `null`.

> [accordion] Propiedades
>
> **amount** `string` *required*
>
> El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
>
> **currency** `string` *required*
>
> Código de divisa ISO 4217 de tres letras, en minúsculas.
>
> **decimals** `integer` *required*
>
> Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
>
> **display\_decimals** `integer` *required*
>
> Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.

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

El documento de política de privacidad de la cuenta, o `null` si no ha publicado ninguno.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del archivo, con el prefijo `file_`.
>
> **blurhash** `string | null` *required*
>
> Marcador de posición BlurHash para una imagen o un vídeo. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **content\_type** `string | null` *required*
>
> El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el archivo, como marca de tiempo ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Duración del audio o del vídeo en segundos. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **filename** `string | null` *required*
>
> El nombre de archivo original, incluida su extensión.
>
> **height** `integer | null` *required*
>
> Altura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **multipart\_chunk\_size** `integer | null`
>
> El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_id** `string | null`
>
> El ID de la carga multiparte, que se devuelve a `complete`. Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_urls** `object[] | null`
>
> La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.
>
> > [accordion] Propiedades
> >
> > **part\_number** `integer` *required*
> >
> > El índice, empezando por 1, de esta parte dentro de la carga multiparte.
> >
> > **url** `string` *required*
> >
> > La URL prefirmada a la que enviar con PUT los bytes de esta parte.
>
> **object** `string` *required*
>
> El tipo de este objeto, siempre `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de sustitución. `filename`, `size` y `content_type` siguen describiendo el archivo original.
>
> **size** `integer | null` *required*
>
> El tamaño del archivo en bytes. `null` hasta que la carga haya terminado.
>
> **upload\_headers** `object`
>
> Cabeceras que se deben enviar con el PUT de la carga. Solo está presente al crear.
>
> **upload\_status** `string` *required*
>
> En qué punto del ciclo de vida de la carga se encuentra el archivo.
>
> Opciones disponibles: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
>
> **url** `string | null` *required*
>
> Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los archivos privados obtienen una URL firmada que caduca. `null` hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.
>
> **visibility** `string` *required*
>
> Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
>
> Opciones disponibles: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forma de onda del audio. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **width** `integer | null` *required*
>
> Anchura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.

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

Código de clasificación fiscal aplicado de forma predeterminada a los productos de la cuenta, con `id`, `name` y `product_type`. `null` cuando no hay ningún valor predeterminado definido.

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

OBSOLETO: Usa en su lugar el endpoint `GET /economic_intelligence?account_id=\{account_id}`.

> [accordion] Propiedades
>
> **action** `string` *required*
>
> La recomendación; pueden añadirse nuevos valores, así que gestiona correctamente las acciones desconocidas
>
> Opciones disponibles: `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*
>
> Capacidades que esto desbloquearía, o vacío
>
> **cta** `string` *required*
>
> La URL a la que enlaza la llamada a la acción
>
> **cta\_label** `string` *required*
>
> Etiqueta del botón
>
> **description** `string` *required*
>
> Texto de apoyo, o vacío
>
> **icon\_url** `string | null` *required*
>
> URL del icono de ilustración, o `null`
>
> **impact\_score** `integer | null` *required*
>
> Impacto estimado de 0 a 100, o `null` cuando no está clasificado
>
> **reasoning** `string | null` *required*
>
> Por qué se recomendó esta acción, o `null`
>
> **status** `string` *required*
>
> Siempre opcional, nunca bloqueante
>
> Opciones disponibles: `optional`
>
> **title** `string` *required*
>
> Titular de la recomendación

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

Si los usuarios autorizados deben activar la autenticación de dos factores.

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

Acciones que debe realizar el propietario de la cuenta para desbloquear capacidades como los pagos y el gasto con tarjeta, ordenadas por prioridad de visualización. Solo se calcula en `retrieve` y `me` para quienes llaman con el alcance `company:balance:read`; `null` en caso contrario.

> [accordion] Propiedades
>
> **action** `string` *required*
>
> Lo que debe hacer el titular; pueden añadirse nuevos valores, así que gestiona correctamente las acciones desconocidas
>
> Opciones disponibles: `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*
>
> Capacidades bloqueadas hasta que esto se resuelva
>
> **cta** `string | null` *required*
>
> La URL a la que enlaza la llamada a la acción, o null cuando no hay botón
>
> **cta\_label** `string` *required*
>
> Etiqueta del botón, o vacío cuando no hay botón
>
> **description** `string` *required*
>
> Texto de apoyo, o vacío
>
> **icon\_url** `string | null` *required*
>
> La URL del icono de ilustración de la acción, o null si no tiene
>
> **status** `string` *required*
>
> required (actúa ahora) o pending (en revisión)
>
> Opciones disponibles: `required`, `pending`
>
> **title** `string` *required*
>
> Titular de la acción

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

El documento de política de devoluciones de la cuenta, o `null` si no ha publicado ninguno.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del archivo, con el prefijo `file_`.
>
> **blurhash** `string | null` *required*
>
> Marcador de posición BlurHash para una imagen o un vídeo. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **content\_type** `string | null` *required*
>
> El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el archivo, como marca de tiempo ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Duración del audio o del vídeo en segundos. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **filename** `string | null` *required*
>
> El nombre de archivo original, incluida su extensión.
>
> **height** `integer | null` *required*
>
> Altura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **multipart\_chunk\_size** `integer | null`
>
> El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_id** `string | null`
>
> El ID de la carga multiparte, que se devuelve a `complete`. Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_urls** `object[] | null`
>
> La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.
>
> > [accordion] Propiedades
> >
> > **part\_number** `integer` *required*
> >
> > El índice, empezando por 1, de esta parte dentro de la carga multiparte.
> >
> > **url** `string` *required*
> >
> > La URL prefirmada a la que enviar con PUT los bytes de esta parte.
>
> **object** `string` *required*
>
> El tipo de este objeto, siempre `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de sustitución. `filename`, `size` y `content_type` siguen describiendo el archivo original.
>
> **size** `integer | null` *required*
>
> El tamaño del archivo en bytes. `null` hasta que la carga haya terminado.
>
> **upload\_headers** `object`
>
> Cabeceras que se deben enviar con el PUT de la carga. Solo está presente al crear.
>
> **upload\_status** `string` *required*
>
> En qué punto del ciclo de vida de la carga se encuentra el archivo.
>
> Opciones disponibles: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
>
> **url** `string | null` *required*
>
> Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los archivos privados obtienen una URL firmada que caduca. `null` hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.
>
> **visibility** `string` *required*
>
> Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
>
> Opciones disponibles: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forma de onda del audio. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **width** `integer | null` *required*
>
> Anchura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.

**rewards** `object[]`

Recompensas para negocios vinculadas a través del enlace de referencia activo de esta cuenta, con el progreso específico de la cuenta y el estado del libro contable. Presente en las respuestas de recuperación; vacío sin acceso de lectura tanto al saldo como a las estadísticas.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la definición de la recompensa, con el prefijo `prwd_`. El progreso y el estado se aplican a la cuenta que lo contiene.
>
> **qualification\_amount** `object` *required*
>
> Volumen apto en USD necesario para obtener esta recompensa.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> >
> > **currency** `string` *required*
> >
> > Código de divisa ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
>
> **qualification\_progress** `object` *required*
>
> Volumen apto en USD de la actividad de la recompensa acumulado por esta cuenta desde la atribución, calculado con las reglas de cumplimiento.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> >
> > **currency** `string` *required*
> >
> > Código de divisa ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
>
> **qualification\_type** `string` *required*
>
> Actividad que hace que esta cuenta sea apta para la recompensa.
>
> Opciones disponibles: `sales`, `ad_spend`
>
> **reward\_amount** `object` *required*
>
> Importe en USD abonado por esta recompensa. Usa el importe de concesión guardado una vez que ha empezado el cumplimiento.
>
> > [accordion] Propiedades
> >
> > **amount** `string` *required*
> >
> > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> >
> > **currency** `string` *required*
> >
> > Código de divisa ISO 4217 de tres letras, en minúsculas.
> >
> > **decimals** `integer` *required*
> >
> > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> >
> > **display\_decimals** `integer` *required*
> >
> > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
>
> **status** `string` *required*
>
> El estado de la recompensa de esta cuenta. Credited requiere un asiento contable registrado; processing incluye un requisito cumplido a la espera de cumplimiento. Reversing y reversed reflejan una reversión posterior de la recompensa.
>
> Opciones disponibles: `in_progress`, `processing`, `credited`, `reversing`, `reversed`, `unavailable`

**route** `string` *required*

Identificador de la ruta pública de la cuenta.

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

Si Whop envía correos electrónicos transaccionales a los clientes en nombre de esta cuenta.

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

El documento de política de envíos de la cuenta, o `null` si no ha publicado ninguno.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del archivo, con el prefijo `file_`.
>
> **blurhash** `string | null` *required*
>
> Marcador de posición BlurHash para una imagen o un vídeo. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **content\_type** `string | null` *required*
>
> El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el archivo, como marca de tiempo ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Duración del audio o del vídeo en segundos. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **filename** `string | null` *required*
>
> El nombre de archivo original, incluida su extensión.
>
> **height** `integer | null` *required*
>
> Altura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **multipart\_chunk\_size** `integer | null`
>
> El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_id** `string | null`
>
> El ID de la carga multiparte, que se devuelve a `complete`. Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_urls** `object[] | null`
>
> La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.
>
> > [accordion] Propiedades
> >
> > **part\_number** `integer` *required*
> >
> > El índice, empezando por 1, de esta parte dentro de la carga multiparte.
> >
> > **url** `string` *required*
> >
> > La URL prefirmada a la que enviar con PUT los bytes de esta parte.
>
> **object** `string` *required*
>
> El tipo de este objeto, siempre `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de sustitución. `filename`, `size` y `content_type` siguen describiendo el archivo original.
>
> **size** `integer | null` *required*
>
> El tamaño del archivo en bytes. `null` hasta que la carga haya terminado.
>
> **upload\_headers** `object`
>
> Cabeceras que se deben enviar con el PUT de la carga. Solo está presente al crear.
>
> **upload\_status** `string` *required*
>
> En qué punto del ciclo de vida de la carga se encuentra el archivo.
>
> Opciones disponibles: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
>
> **url** `string | null` *required*
>
> Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los archivos privados obtienen una URL firmada que caduca. `null` hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.
>
> **visibility** `string` *required*
>
> Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
>
> Opciones disponibles: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forma de onda del audio. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **width** `integer | null` *required*
>
> Anchura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.

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

Si la cuenta aparece en los whops a los que se ha unido en otras cuentas.

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

Si las reseñas se muestran en las páginas de productos directos al consumidor.

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

Si la cuenta muestra usuarios en el directorio de usuarios.

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

Enlaces sociales de la cuenta.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del enlace social
>
> **title** `string | null` *required*
>
> El título visible opcional del enlace social
>
> **url** `string` *required*
>
> La URL del enlace social
>
> **website** `string` *required*
>
> La plataforma social de este enlace
>
> Opciones disponibles: `x`, `instagram`, `facebook`, `tiktok`, `youtube`, `linkedin`, `twitch`, `website`, `custom`

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

Si la cuenta puede operar en Whop: `active` o `suspended`. Se calcula en `list`, `retrieve`, `me` y `suspend`; `null` en caso contrario.

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

Por qué se suspendió la cuenta, como una etiqueta del tipo `Suspended - Fraudulent activity`. `Suspended` cuando no hay ningún motivo registrado. Se calcula en `retrieve`, `me` y `suspend`. `null` en caso contrario, o cuando `status` no es `suspended`.

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

Configuración de visualización de la página de la tienda de la cuenta.

> [accordion] Propiedades
>
> **accent\_color** `string | null` *required*
>
> Color de acento usado en la página de la tienda de la cuenta.
>
> Opciones disponibles: `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*
>
> Diseño usado en la página de la tienda de la cuenta.
>
> Opciones disponibles: `featured`, `compact`
>
> **profile\_variant** `string | null` *required*
>
> Presentación del perfil usada en la página de la tienda de la cuenta.
>
> Opciones disponibles: `personal`, `business`
>
> **whop\_affiliate\_link** `boolean` *required*
>
> Si la página de la tienda de la cuenta muestra un enlace de afiliado de Whop.

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

Público objetivo de esta cuenta.

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

Códigos de estados de EE. UU. (de los 50 estados más `DC`) en los que la cuenta recauda impuestos: el conjunto completo cuando Whop los ingresa (`tax_remitted_by` `whop`), el subconjunto configurado cuando la cuenta los ingresa por su cuenta (`self`) y vacío cuando no se da ninguno de los dos casos. Al actualizar, envía la lista completa para reemplazarla (solo se permite cuando es `self`).

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

Registros fiscales/de IVA de la cuenta. Vacío cuando no hay ninguno definido.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID del identificador fiscal.
>
> **tax\_id\_type** `string` *required*
>
> Tipo de ID fiscal.
>
> Opciones disponibles: `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*
>
> Valor del ID fiscal, por ejemplo `DE123456789`. Consulta la [guía de IDs fiscales](https://docs.whop.com/es/developer/guides/tax-ids.md).

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

Quién calcula e ingresa los impuestos de la cuenta. `whop` significa que Whop los calcula y los ingresa. `self` significa que Whop los calcula y la cuenta los recauda y los ingresa. `none` significa que ninguno de los dos, y la cuenta es responsable. Los negocios nuevos empiezan con `whop` y las cuentas conectadas nuevas empiezan con `none`. `null` significa que la cuenta aún no tiene ningún ajuste.

Opciones disponibles: `whop`, `self`, `none`

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

Cómo se aplican los impuestos a los precios de la cuenta: `inclusive` (impuestos incluidos en el precio indicado) o `exclusive` (impuestos añadidos al precio). Toma `exclusive` como valor predeterminado cuando no está definido; `null` solo cuando la cuenta no tiene conexión de pagos.

Opciones disponibles: `inclusive`, `exclusive`

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

El documento de términos del servicio de la cuenta, o `null` si no ha publicado ninguno.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID del archivo, con el prefijo `file_`.
>
> **blurhash** `string | null` *required*
>
> Marcador de posición BlurHash para una imagen o un vídeo. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **content\_type** `string | null` *required*
>
> El tipo MIME del archivo original, por ejemplo `application/pdf`. Se conserva cuando la moderación elimina el archivo.
>
> **created\_at** `string` *required*
>
> Cuándo se creó el archivo, como marca de tiempo ISO 8601.
>
> **duration\_seconds** `number | null` *required*
>
> Duración del audio o del vídeo en segundos. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **filename** `string | null` *required*
>
> El nombre de archivo original, incluida su extensión.
>
> **height** `integer | null` *required*
>
> Altura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **multipart\_chunk\_size** `integer | null`
>
> El tamaño en bytes que debe tener cada parte (excepto la última). Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_id** `string | null`
>
> El ID de la carga multiparte, que se devuelve a `complete`. Solo está presente al crear, y solo para cargas multiparte.
>
> **multipart\_upload\_urls** `object[] | null`
>
> La URL prefirmada de cada parte. Solo está presente al crear, y solo para cargas multiparte.
>
> > [accordion] Propiedades
> >
> > **part\_number** `integer` *required*
> >
> > El índice, empezando por 1, de esta parte dentro de la carga multiparte.
> >
> > **url** `string` *required*
> >
> > La URL prefirmada a la que enviar con PUT los bytes de esta parte.
>
> **object** `string` *required*
>
> El tipo de este objeto, siempre `file`.
>
> **removed\_by\_moderation** `boolean` *required*
>
> Si la moderación eliminó el archivo. Cuando es `true`, `url` sirve una imagen de sustitución. `filename`, `size` y `content_type` siguen describiendo el archivo original.
>
> **size** `integer | null` *required*
>
> El tamaño del archivo en bytes. `null` hasta que la carga haya terminado.
>
> **upload\_headers** `object`
>
> Cabeceras que se deben enviar con el PUT de la carga. Solo está presente al crear.
>
> **upload\_status** `string` *required*
>
> En qué punto del ciclo de vida de la carga se encuentra el archivo.
>
> Opciones disponibles: `pending`, `processing`, `ready`, `failed`
>
> **upload\_url** `string | null`
>
> URL prefirmada a la que enviar con PUT los bytes del archivo. Solo está presente al crear, y solo para cargas de una sola parte.
>
> **url** `string | null` *required*
>
> Una URL para descargar el archivo. Los archivos públicos obtienen una URL de CDN permanente y los archivos privados obtienen una URL firmada que caduca. `null` hasta que la carga haya terminado. Cuando la moderación elimina el archivo, una URL de imagen de sustitución.
>
> **visibility** `string` *required*
>
> Los archivos `public` se sirven desde una URL de CDN sin firmar. Los archivos `private` se sirven desde una URL firmada que caduca.
>
> Opciones disponibles: `public`, `private`
>
> **waveform\_url** `string | null` *required*
>
> URL de la forma de onda del audio. Null cuando no está disponible o la moderación lo ha eliminado.
>
> **width** `integer | null` *required*
>
> Anchura de la imagen o del vídeo en píxeles. Null cuando no está disponible o la moderación lo ha eliminado.

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

Comportamiento de 3D Secure para los pagos con tarjeta compatibles realizados en sesión. `mandate_challenge` exige un desafío 3DS antes de procesar el pago; `mandate_if_required` exige un desafío solo cuando el procesador de pagos lo requiere; `frictionless_if_required` usa el flujo 3DS sin fricción habitual. Los pagos de 1000 \$ o más usan `mandate_if_required` a menos que se seleccione `mandate_challenge`. Los requisitos de riesgo y de recuperación de la autenticación pueden anular la preferencia. `null` usa el flujo de checkout estándar.

Opciones disponibles: `mandate_challenge`, `mandate_if_required`, `frictionless_if_required`

**title** `string` *required*

Nombre visible de la cuenta.

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

Ventas de la cuenta durante toda su vida, normalizadas a USD. Solo se calcula en `retrieve` y `me` para quienes llaman con el alcance `stats:read`; `null` en caso contrario.

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

Valor total en USD de los saldos con tipos de cambio conocidos. Solo se calcula en las lecturas de una sola cuenta (`retrieve` y `me`); `null` en las respuestas de listas, las escrituras, cuando falta el permiso de lectura de saldos o cuando la fuente de saldos no está disponible.

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

La dirección de la cuenta de trading, una instantánea de su margen y sus posiciones abiertas, y sus suscripciones de WebSocket. Actívalo con `include_trading=true` en las lecturas de una sola cuenta. `null` en caso contrario, sin permiso de trading o sin una billetera de Ethereum.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> El ID de la billetera de Whop que respalda esta cuenta de trading, con el prefijo `cwal_`.
>
> **account\_id** `string | null` *required*
>
> La cuenta propietaria de esta cuenta de trading, con el prefijo `biz_`. `null` cuando la posee un usuario.
>
> **hyperliquid** `object | null` *required*
>
> Estado específico de Hyperliquid. Presente cuando `provider` es `hyperliquid`; en caso contrario, `null`.
>
> > [accordion] Propiedades
> >
> > **address** `string` *required*
> >
> > Dirección de billetera en minúsculas que contiene la cuenta de Hyperliquid.
> >
> > **depositable** `string | null` *required*
> >
> > USDT0 en la billetera de Whop en Plasma que una operación `deposit` puede mover a esta cuenta, como cadena decimal. `null` cuando no se pudo leer la cadena.
> >
> > **margin\_summary** `object | null` *required*
> >
> > Valor de la cuenta y margen en el exchange principal y en los mercados `xyz`, leídos de Hyperliquid como máximo una vez por segundo. `null` cuando no se pudo leer Hyperliquid. Usa `websocket_subscriptions` para recibir actualizaciones en tiempo real.
> >
> > > [accordion] Propiedades
> > >
> > > **account\_value** `object` *required*
> > >
> > > Valor total de la cuenta en USD, incluidas las ganancias y pérdidas no realizadas.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > >
> > > **total\_margin\_used** `object` *required*
> > >
> > > Margen asignado a las posiciones abiertas, en USD.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > >
> > > **total\_position\_notional** `object` *required*
> > >
> > > Valor nocional combinado de las posiciones abiertas, en USD.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > >
> > > **withdrawable** `object` *required*
> > >
> > > USD que se pueden retirar ahora sin cerrar posiciones.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> >
> > **positions** `trading_position[] | null` *required*
> >
> > Posiciones perpetuas abiertas en el exchange principal y en los mercados `xyz`, leídas de Hyperliquid como máximo una vez por segundo. `null` cuando no se pudo leer Hyperliquid. Usa `websocket_subscriptions` para recibir actualizaciones en tiempo real.
> >
> > > [accordion] Propiedades
> > >
> > > **id** `string` *required*
> > >
> > > ID de la posición de trading, con el prefijo `trdpos_`. Estable para un mercado dentro de una cuenta de trading.
> > >
> > > **entry\_price** `object | null` *required*
> > >
> > > Precio de entrada medio en USD, o `null` cuando el proveedor lo omite.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > >
> > > **hyperliquid** `object | null` *required*
> > >
> > > Detalles del perpetuo de Hyperliquid. Presente en las posiciones de Hyperliquid; en caso contrario, `null`.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **cumulative\_funding** `object` *required*
> > > >
> > > > Funding pagado por la posición en varios periodos, en USD.
> > > >
> > > > > [accordion] Propiedades
> > > > >
> > > > > **all\_time** `object | null` *required*
> > > > >
> > > > > Funding pagado en este mercado a lo largo del historial de la cuenta, en USD, o `null` cuando no está disponible.
> > > > >
> > > > > > [accordion] Propiedades
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > > > >
> > > > > **since\_change** `object | null` *required*
> > > > >
> > > > > Funding pagado desde el último cambio de tamaño de la posición, en USD, o `null` cuando no está disponible.
> > > > >
> > > > > > [accordion] Propiedades
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > > > >
> > > > > **since\_open** `object | null` *required*
> > > > >
> > > > > Funding pagado desde que se abrió la posición, en USD, o `null` cuando no está disponible.
> > > > >
> > > > > > [accordion] Propiedades
> > > > > >
> > > > > > **amount** `string` *required*
> > > > > >
> > > > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > > > >
> > > > > > **currency** `string` *required*
> > > > > >
> > > > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > > > >
> > > > > > **decimals** `integer` *required*
> > > > > >
> > > > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > > > >
> > > > > > **display\_decimals** `integer` *required*
> > > > > >
> > > > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > > >
> > > > **leverage** `object` *required*
> > > >
> > > > Modo de margen y multiplicador de la posición.
> > > >
> > > > > [accordion] Propiedades
> > > > >
> > > > > **type** `string` *required*
> > > > >
> > > > > `cross` comparte el margen entre posiciones. `isolated` limita el margen a esta posición.
> > > > >
> > > > > Opciones disponibles: `cross`, `isolated`
> > > > >
> > > > > **value** `integer` *required*
> > > > >
> > > > > Multiplicador aplicado al margen de la posición, como `10` para 10x.
> > > >
> > > > **liquidation\_price** `object | null` *required*
> > > >
> > > > Precio de liquidación estimado en USD, o `null` cuando Hyperliquid no informa de ninguno.
> > > >
> > > > > [accordion] Propiedades
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > > >
> > > > **margin\_used** `object` *required*
> > > >
> > > > Margen asignado a la posición, en USD.
> > > >
> > > > > [accordion] Propiedades
> > > > >
> > > > > **amount** `string` *required*
> > > > >
> > > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > > >
> > > > > **currency** `string` *required*
> > > > >
> > > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > > >
> > > > > **decimals** `integer` *required*
> > > > >
> > > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > > >
> > > > > **display\_decimals** `integer` *required*
> > > > >
> > > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > > >
> > > > **return\_on\_equity** `string` *required*
> > > >
> > > > Rentabilidad sobre el capital como cadena de ratio decimal, como `0.1` para el 10 %.
> > >
> > > **market** `string` *required*
> > >
> > > Símbolo del mercado en el proveedor, como `ETH`.
> > >
> > > **object** `string` *required*
> > >
> > > **position\_value** `object` *required*
> > >
> > > Valor actual de la posición en USD.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > >
> > > **side** `string` *required*
> > >
> > > Opciones disponibles: `long`, `short`
> > >
> > > **size** `string` *required*
> > >
> > > Tamaño absoluto de la posición como cadena decimal.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > Ganancia o pérdida no realizada en USD. Negativa en caso de pérdida.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> >
> > **websocket\_subscriptions** `object[]` *required*
> >
> > Suscripciones para recibir actualizaciones de la cuenta en tiempo real. Envía cada `message` sin cambios después de conectarte a `websocket_url`.
> >
> > > [accordion] Propiedades
> > >
> > > **channel** `string` *required*
> > >
> > > El flujo de actualizaciones en tiempo real que abre esta suscripción.
> > >
> > > Opciones disponibles: `clearinghouse_state`, `open_orders`, `order_updates`, `user_fills`, `user_events`
> > >
> > > **message** `string` *required*
> > >
> > > Mensaje de suscripción JSON que se debe enviar sin cambios por el WebSocket de Hyperliquid.
> >
> > **websocket\_url** `string` *required*
> >
> > URL del WebSocket de Hyperliquid a la que conectarse directamente para recibir actualizaciones en tiempo real.
>
> **object** `string` *required*
>
> **provider** `string` *required*
>
> Plataforma de trading que contiene las posiciones y las órdenes.
>
> Opciones disponibles: `hyperliquid`
>
> **spot** `object | null` *required*
>
> Activos al contado en la billetera de Whop con su precio de entrada y sus ganancias y pérdidas. `null` cuando no se pudo leer.
>
> > [accordion] Propiedades
> >
> > **holdings** `object[]` *required*
> >
> > Cada activo al contado que la billetera aún contiene, con su precio de entrada medio y sus ganancias y pérdidas. La base de coste considera que las unidades más antiguas se venden primero e incluye los activos que llegaron desde fuera de Whop.
> >
> > > [accordion] Propiedades
> > >
> > > **average\_entry\_price** `object | null` *required*
> > >
> > > El precio medio pagado por unidad de lo que aún se mantiene, en USD, considerando que las unidades más antiguas se venden primero. `null` cuando no se conoce.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > >
> > > **cost\_basis** `object` *required*
> > >
> > > Lo que se pagó en USD por las unidades que aún se mantienen.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > >
> > > **market** `string` *required*
> > >
> > > El `id` del mercado al contado de `GET /trades/markets`, como `BTC`, `XAUT` o el ticker de una acción tokenizada, como `AAPL`.
> > >
> > > **realized\_pnl** `object` *required*
> > >
> > > Ganancias y pérdidas ya consolidadas mediante ventas, en USD.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > >
> > > **unrealized\_pnl** `object` *required*
> > >
> > > El valor de las unidades que aún se mantienen menos su `cost_basis`, en USD.
> > >
> > > > [accordion] Propiedades
> > > >
> > > > **amount** `string` *required*
> > > >
> > > > El importe en unidades principales, como cadena decimal exacta. Por ejemplo, `"10.00"` son diez dólares. Es una cadena para que ningún número de coma flotante lo redondee en tránsito.
> > > >
> > > > **currency** `string` *required*
> > > >
> > > > Código de divisa ISO 4217 de tres letras, en minúsculas.
> > > >
> > > > **decimals** `integer` *required*
> > > >
> > > > Cuántos decimales tiene el importe. Es la precisión con la que se ejecuta el propio cargo.
> > > >
> > > > **display\_decimals** `integer` *required*
> > > >
> > > > Cuántos decimales se deben MOSTRAR. Normalmente es igual a `decimals`, y deliberadamente no siempre: COP se cobra en centavos pero se escribe en pesos enteros, por lo que es `2` y `0`. Usa esto para dar formato al número en tu propia configuración regional.
> > >
> > > **unrealized\_pnl\_percentage** `number | null` *required*
> > >
> > > `unrealized_pnl` como porcentaje de `cost_basis`, donde `2` significa una subida del 2 %. `null` cuando no se conoce.
>
> **user\_id** `string | null` *required*
>
> El usuario propietario de esta cuenta de trading, con el prefijo `user_`. `null` cuando la posee una cuenta.

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

Si la cuenta usa su logotipo como imagen Open Graph de respaldo.

**verification** `object` *required*

Estado de verificación de identidad de la cuenta para los perfiles `individual` (KYC) y `business` (KYB). Cada uno es `null` hasta que se crea; en caso contrario, un `status` de `not_started`, `pending`, `manual_review`, `approved` o `rejected`.

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

Volumen a través de la cuenta en los últimos 30 días (GMV de recibos pagados), normalizado a USD. Solo se calcula en `list` para quienes llaman con `stats:read` en la cuenta; `null` en caso contrario.

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

Volumen a través de la cuenta durante toda su vida (ventas más transferencias recibidas), normalizado a USD. Solo se calcula en `list` para quienes llaman con `stats:read` en la cuenta; `null` en caso contrario.

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

Billetera de criptomonedas principal de la cuenta, o `null` si no se ha aprovisionado ninguna.

> [accordion] Propiedades
>
> **id** `string` *required*
>
> ID de la billetera, con el prefijo `wallet_`.
>
> **address** `string` *required*
>
> La dirección on-chain de la billetera
>
> **network** `string` *required*
>
> La red blockchain en la que se encuentra la billetera
>
> Opciones disponibles: `solana`, `ethereum`, `bitcoin`

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

La URL del sitio web comercial de la cuenta, o `null` si no se ha proporcionado ninguna. Definirla también añade una entrada `website` a `social_links`.

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

Cuándo activó la cuenta el modo Whop Partner, como marca de tiempo ISO 8601. Presente en las lecturas de una sola cuenta y en las respuestas de actualización; `null` hasta que la cuenta activa el modo Whop Partner enviando `whop_partner_enabled: true` al actualizar.

```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"
	}
}
```

## Tipos de negocio e industrias

Tres campos clasifican las cuentas: `business_type`, `industry_group` e `industry_type`. La taxonomía completa se encuentra en su propia página:

> [card] [Tipos de negocio e industrias](https://docs.whop.com/es/api-reference/accounts/business-types.md)
