*API REST › Referencia de endpoints › Cuenta y acceso › Cuenta*

# Obtener la cuenta

> Devuelve la cuenta que hizo la petición: su nombre, la zona horaria en la que se leen las fechas sin hora, su divisa y su país, los add-ons a los que tiene acceso (un recurso detrás de un add-on que no figura responde 402), si está en periodo de prueba, la clave de API que hizo la petición con sus scopes, los límites de uso que informan las cabeceras RateLimit-* y la versión de este contrato.

Es la primera llamada de cualquier integración: sustituye a adivinar.

`GET /api/v1/account` — permiso `account:read`

Permiso: `account:read` · 120/min · If-None-Match · MCP: `filmo_account_get`

## Autorizaciones

Clave de API como Bearer, con el permiso de abajo. `account:read`

## Cabeceras

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `If-None-Match` | string | No | Lectura condicional: el `ETag` de la copia que ya tienes. Si el recurso no ha cambiado, la respuesta es `304` sin cuerpo. |

## Ejemplos de petición

*Obtener la cuenta*

**cURL**

```bash
curl https://app.filmo.io/api/v1/account \
  --header "Authorization: Bearer $FILMO_API_KEY"
```

**Node.js**

```javascript
fetch('https://app.filmo.io/api/v1/account', {
  headers: {
    Authorization: 'Bearer YOUR_FILMO_API_KEY'
  }
})
```

**Python**

```python
import requests

requests.get("https://app.filmo.io/api/v1/account",
    headers={
      "Authorization": "Bearer YOUR_FILMO_API_KEY"
    }
)
```

## Respuesta

Esquema de la respuesta: `AccountDto`

| Estado | Descripción |
| --- | --- |
| 200 | Respuesta correcta. |
| 304 | No modificado: el `If-None-Match` enviado coincide con el `ETag` actual. Sin cuerpo; la copia que tienes está al día. |
| 401 | Fallo de autenticación (unauthorized, api_key_invalid, api_key_revoked, api_key_expired, api_key_owner_inactive, api_key_owner_not_admin). |
| 403 | No permitido (insufficient_scope: la clave de API no tiene el scope requerido, indicado en `requiredScope`; forbidden: el propietario de la clave carece del permiso que exige la operación). `insufficient_scope` se responde antes de que la petición cuente contra el límite de peticiones, así que no lleva cabeceras `RateLimit-*`; `forbidden` sí. |
| 429 | Límite de peticiones superado (rate_limited): reintenta tras `Retry-After` segundos; `RateLimit-*` indica qué cuota se ha agotado. |
| 500 | Error interno (internal_error). |

**200**

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `data` | object | La cuenta que hizo la petición, su clave y sus límites de uso. |
| `data.name` | string | Nombre de la cuenta. |
| `data.timezone` | string | Zona horaria IANA del negocio, aquella en la que se leen las fechas sin hora de los filtros. |
| `data.currency` | string | Moneda de la cuenta en ISO 4217; los documentos pueden llevar la suya. |
| `data.country` | string | País del negocio en ISO 3166-1 alpha-2. |
| `data.language` | string | Idioma por defecto de los mensajes de error de esta clave (BCP 47), salvo que Accept-Language indique otro. |
| `data.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` |
| `data.trial` | object | Periodo de prueba de la cuenta. |
| `data.trial.active` | boolean | true mientras dura el periodo de prueba de la cuenta: todos los add-ons están desbloqueados. |
| `data.trial.endsAt` | string<date-time> | Fin de la prueba en ISO 8601 UTC; null si no hay. |
| `data.apiKey` | object | La clave que hizo la petición. Nunca su secreto. |
| `data.apiKey.id` | string | Identificador de la clave de API que hizo la petición. |
| `data.apiKey.name` | string | Nombre dado a la clave cuando se creó. |
| `data.apiKey.scopes` | string[] | Scopes concedidos a la clave, los que pueden usar sus peticiones. |
| `data.rateLimits` | object | Límites de uso de la clave, los que informan las cabeceras RateLimit-*. |
| `data.rateLimits.global` | object | Peticiones por minuto en toda la API. |
| `data.rateLimits.global.perMinute` | integer |  |
| `data.rateLimits.availability` | object | Peticiones por minuto de las consultas de disponibilidad, contadas aparte. |
| `data.rateLimits.availability.perMinute` | integer |  |
| `data.api` | object | El contrato con el que se sirve a esta cuenta. |
| `data.api.version` | string | Versión del contrato de la API pública. |
| `data.api.docsUrl` | string | Dónde está la documentación de esta versión. |
| `meta` | object | Información adicional sobre la respuesta. |
| `meta.warnings` | object[] | Avisos del ciclo de vida; solo aparecen cuando la operación está obsoleta. |
| `meta.warnings.code` | string | Código de aviso estable. `deprecated` |
| `meta.warnings.message` | string | Para personas: qué está obsoleto, hasta cuándo y qué usar. |
| `meta.warnings.sunset` | string | Día (YYYY-MM-DD) en que la operación deja de estar disponible. |
| `meta.warnings.replacement` | string | `operationId` de la operación que hay que usar en su lugar, o null si no hay ninguna. |
| `meta.warnings.link` | string | Dónde está documentada la deprecación (el changelog). |

*Respuesta de ejemplo · 200*

```json
{
  "data": {
    "name": "Example account",
    "timezone": "Europe/Madrid",
    "currency": "EUR",
    "country": "ES",
    "language": "es-ES",
    "addons": [
      "platform"
    ],
    "trial": {
      "active": true,
      "endsAt": "2026-09-01T08:00:00.000Z"
    },
    "apiKey": {
      "id": "api_key_9f3a2b",
      "name": "Example api key",
      "scopes": [
        "Example scopes"
      ]
    },
    "rateLimits": {
      "global": {
        "perMinute": 50
      },
      "availability": {
        "perMinute": 50
      }
    },
    "api": {
      "version": "Example version",
      "docsUrl": "https://example.com/resource"
    }
  }
}
```

304: Sin cuerpo.

## Errores

| Estado | Códigos | Significado |
| --- | --- | --- |

## Obsolescencia

Esta operación no está obsoleta. Las obsolescencias se anuncian con la cabecera Deprecation y una fecha de retirada.

---

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