Resumen de la API REST

Todas las rutas de esta referencia empiezan por /api/v1, en el origen https://app.filmo.io: por ejemplo, GET /api/v1/orders. Las peticiones y las respuestas correctas son JSON (application/json); los errores son application/problem+json.

Una buena primera llamada es GET /api/v1/account. Necesita el scope account:read y devuelve la cuenta, la zona horaria en la que se leen las fechas sin hora y los scopes de la clave que usaste. Para crear una clave, un administrador abre la sección API y MCP de los ajustes de la cuenta en Filmo (*Ajustes → API y MCP*); consulta Autenticación.

curl -sS --fail-with-body "${FILMO_BASE_URL:-https://app.filmo.io}/api/v1/account" \
  -H "Authorization: Bearer $FILMO_API_KEY"

const base = process.env.FILMO_BASE_URL ?? "https://app.filmo.io";
const res = await fetch(base + "/api/v1/account", {
  headers: { Authorization: `Bearer ${process.env.FILMO_API_KEY}` },
});
if (!res.ok) throw new Error(res.status + " " + (await res.text()));
const { data } = await res.json();
console.log(data.name, data.timezone, data.currency);

import os
import requests

base = os.environ.get("FILMO_BASE_URL", "https://app.filmo.io")
res = requests.get(
    base + "/api/v1/account",
    headers={"Authorization": f"Bearer {os.environ['FILMO_API_KEY']}"},
    timeout=30,
)
res.raise_for_status()
data = res.json()["data"]
print(data["name"], data["timezone"], data["currency"])

Para un recorrido guiado desde una clave nueva hasta tu primera escritura, sigue la guía rápida. El archivo OpenAPI y los clientes que puedes generar a partir de él se tratan en Archivo OpenAPI y clientes generados; la referencia de cada operación está en la Referencia de OpenAPI.

Cada respuesta de la API tiene una de tres formas.

Las respuestas de la API llevan una cabecera X-Request-Id, y los cuerpos de error la repiten como requestId. Cítala cuando contactes con soporte. Los endpoints de OAuth son la excepción: no la devuelven. Las cabeceras, el objeto meta adicional que devuelven algunas operaciones y los estados en uso están en Respuestas; todos los códigos de error están en Errores.

• Pide a un administrador de la empresa de alquiler que cree la clave y decide quién la posee: Autenticación.
• Da a la clave solo los permisos que usa la integración: Permisos (scopes).
• Lee qué cubre v1, y qué no cubre, en Capacidades y límites.
• Comprueba qué add-ons tiene tu cuenta: la API y el MCP están incluidos en cualquier plan de pago y no son un add-on, pero un recurso que pertenece a un módulo con un add-on que no has contratado responde 402 addon_required. Consulta Planes y add-ons.
• Una clave trabaja sobre los datos en vivo de la cuenta a la que pertenece. Lee Pruebas antes de tu primera escritura.
• Antes de pasar a producción, repasa Pasar a producción.

Consulta la versión del contrato que devuelve GET /api/v1/account o la publicada en el archivo OpenAPI. Las reglas de compatibilidad y los plazos de aviso están documentados en Versionado.

v1 no envía webhooks. Para mantener otro sistema sincronizado con Filmo, haz polling incremental: pide a cada lista que tenga filtros updated* los registros que han cambiado desde tu último recorrido. Sincronizar datos describe un algoritmo que no se salta registros y cómo detectar eliminaciones.

Cada operación es también una herramienta MCP en https://app.filmo.io/api/v1/mcp, con la misma clave y los mismos permisos (scopes). Consulta la Resumen de MCP.