*API REST › Objetos › Cuenta y acceso*

# Cuenta

> La cuenta que hizo la petición, su clave y sus límites de uso.

La cuenta que hizo la petición: su nombre, zona horaria, moneda, país e idioma, los add-ons que tiene, si está en periodo de prueba, la clave de API que hizo la llamada con sus permisos (scopes), los límites de uso y la versión del contrato. Es de solo lectura y es la primera llamada de cualquier integración, porque te dice cómo leer fechas e importes y qué recursos responden 402. Léela con [`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account).

Esquemas: `AccountDto`

## Atributos

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `name` | string | Nombre de la cuenta. |
| `timezone` | string | Zona horaria IANA del negocio, aquella en la que se leen las fechas sin hora de los filtros. |
| `currency` | string | Moneda de la cuenta en ISO 4217; los documentos pueden llevar la suya. |
| `country` | string | País del negocio en ISO 3166-1 alpha-2. |
| `language` | string | Idioma por defecto de los mensajes de error de esta clave (BCP 47), salvo que Accept-Language indique otro. |
| `addons` | string[] | Ids de los add-ons a los que la cuenta tiene acceso hoy. Un recurso tras un add-on que no figura aquí responde 402. `platform`, `user-seat`, `connected-account`, `extra-tax-cif`, `qr-codes`, `incidence`, `purchases`, `activity-log`, `custom-fields`, `profitability`, `web-builder`, `crm`, `consignments`, `email-calendar`, `sales-documents`, `internal-bookings`, `internal-communication`, `advanced-user-permissions`, `ai-pack-25k`, `ai-pack-55k`, `ai-pack-115k` |
| `trial` | object | Periodo de prueba de la cuenta. |
| `trial.active` | boolean | true mientras dura el periodo de prueba de la cuenta: todos los add-ons están desbloqueados. |
| `trial.endsAt` | string<date-time> | Fin de la prueba en ISO 8601 UTC; null si no hay. |
| `apiKey` | object | La clave que hizo la petición. Nunca su secreto. |
| `apiKey.id` | string | Identificador de la clave de API que hizo la petición. |
| `apiKey.name` | string | Nombre dado a la clave cuando se creó. |
| `apiKey.scopes` | string[] | Scopes concedidos a la clave, los que pueden usar sus peticiones. |
| `rateLimits` | object | Límites de uso de la clave, los que informan las cabeceras RateLimit-*. |
| `rateLimits.global` | object | Peticiones por minuto en toda la API. |
| `rateLimits.global.perMinute` | integer |  |
| `rateLimits.availability` | object | Peticiones por minuto de las consultas de disponibilidad, contadas aparte. |
| `rateLimits.availability.perMinute` | integer |  |
| `api` | object | El contrato con el que se sirve a esta cuenta. |
| `api.version` | string | Versión del contrato de la API pública. |
| `api.docsUrl` | string | Dónde está la documentación de esta versión. |

## Valores

| Campo | Valores |
| --- | --- |
| `addons` | `platform`, `user-seat`, `connected-account`, `extra-tax-cif`, `qr-codes`, `incidence`, `purchases`, `activity-log`, `custom-fields`, `profitability`, `web-builder`, `crm`, `consignments`, `email-calendar`, `sales-documents`, `internal-bookings`, `internal-communication`, `advanced-user-permissions`, `ai-pack-25k`, `ai-pack-55k`, `ai-pack-115k` |

## Ejemplo

*Account · Generado a partir del esquema*

```json
{
  "name": "Example",
  "timezone": "string",
  "currency": "EUR",
  "country": "ES",
  "language": "es-ES",
  "addons": [
    "platform"
  ],
  "trial": {
    "active": true,
    "endsAt": "2026-09-01T08:00:00Z"
  },
  "apiKey": {
    "id": "id_8f2a1c",
    "name": "Example",
    "scopes": [
      "string"
    ]
  },
  "rateLimits": {
    "global": {
      "perMinute": 1
    },
    "availability": {
      "perMinute": 1
    }
  },
  "api": {
    "version": "string",
    "docsUrl": "https://example.com"
  }
}
```

## Lo devuelven

- [`GET /api/v1/account`](https://docs.filmo.io/es/rest-api/endpoint-reference/account/get-the-account) — Obtener la cuenta

## Lo modifican

Ninguna operación.

---

URL canónica: https://docs.filmo.io/es/rest-api/objects/account  
Última actualización: 2026-10-25