> ## Documentation Index > Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt > Use this file to discover all available pages before exploring further. # Listar plantillas > Lista las plantillas públicas del catálogo, más tus plantillas privadas si estás autenticado, con filtros, orden, paginación y si cada una encaja en tu cuenta. Devuelve una página de plantillas, filtradas y ordenadas como lo pidas. El catálogo público no requiere **autenticación**. Con una sesión o una clave de API (ámbito `templates:read`), la respuesta también incluye tus plantillas privadas y un bloque `account` en cada plantilla que indica si encaja en tu cuenta en este momento. Las llamadas con cabecera `Authorization` siempre se validan: una clave o un token no válidos devuelven `401`, nunca una respuesta anónima. Las lecturas están limitadas a 60 peticiones por minuto por cliente. **search** `string` Texto a buscar en el nombre, en la descripción (en los tres idiomas), en el slug y en las etiquetas. Ignora mayúsculas y acentos. Hasta 100 caracteres. **category** `string` Solo plantillas de una categoría: `automation`, `ai-agents`, `bots`, `apis`, `cms`, `monitoring`, `starters`, `databases` u `other`. **origin** `string` Solo plantillas de un origen: `vertra` (hechas por la plataforma), `community` (aportadas y revisadas) o `private` (tuyas). `private` lista tus plantillas privadas personales, o las de `workspace_id`, y solo devuelve algo cuando estás autenticado. **tag** `string` Solo plantillas que tengan esta etiqueta. Hasta 50 caracteres. **fits** `boolean` `true` deja solo las plantillas que encajan en tu cuenta en este momento (plan, memoria libre, límites y slots de imagen). **Requiere autenticación**: sin ella, la llamada falla con `AUTH_TOKEN_MISSING`. **sort** `string` (default: recommended) El orden: `recommended` (primero las destacadas y después las más usadas), `popular` (las más usadas), `newest` (las más recientes) o `name` (por nombre). **page** `integer` (default: 1) La página, empezando en 1. **limit** `integer` (default: 20) Plantillas por página, de 1 a 50. **workspace\_id** `string` Incluye las plantillas privadas de ese workspace. El propietario del workspace y los miembros que pueden leer sus aplicaciones pueden listarlas; cualquier otra persona recibe el error de workspace. La galería pública muestra las plantillas públicas o en beta cuya última versión está lista. Las plantillas ocultas y obsoletas no se listan, pero [Obtener plantilla](https://docs.vertracloud.app/es-es/api-reference/endpoint/templates/get.md) sigue sirviéndolas por ID o slug. ### Respuesta **response** `object` Una página de plantillas. **Mostrar objeto** **data** `object[]` Las plantillas de la página. **Mostrar objeto** **id** `string` El ID de la plantilla. **slug** `string` Un nombre corto, único entre las plantillas públicas. Se acepta en cualquier lugar donde va un ID de plantilla. **origin** `string` `vertra`, `community` o `private`. **visibility** `string` `public`, `beta`, `hidden` o `deprecated`. Una plantilla obsoleta no puede usarse para aplicaciones nuevas; las que ya se ejecutan siguen funcionando. **name** `object` El nombre en los tres idiomas: `pt-br` (siempre presente), `en` y `es` (si falta uno, se usa `pt-br`). **description** `object` La descripción, con la misma forma que `name`. **category** `string` Una de las categorías anteriores. **tags** `string[]` Las etiquetas de la plantilla. **icon\_url** `string | null` URL del icono, o `null` cuando no tiene (las plantillas privadas no tienen). **author\_display** `string | null` El nombre que se muestra como autor, o `null` para las plantillas de la plataforma. **links** `object` Enlaces del software que empaqueta la plantilla: `website`, `docs`, `source` y `license`, cada uno opcional. **landing** `string | null` El slug de la página pública dedicada, cuando existe. **featured** `boolean` `true` cuando la plantilla está destacada en la galería. **current\_version** `object` La última versión: `id`, `version` (versión semántica), `security` (`true` para una versión de seguridad) y `created_at`. **services** `object[]` Los servicios que crea la plantilla. Cada uno tiene `id`, `kind` (`app`, `database` o `blob`), `source_type` (`code` o `image` para una aplicación; si no, `null`), `database` (`postgres`, `mysql`, `mongodb` o `redis` para una base de datos; si no, `null`), `blob_visibility` (`private` o `public` para una carpeta de Blob; si no, `null`), `ram` (`min`, `recommended` y `max` opcional, en MB; una carpeta de Blob no usa ninguno), `web` (`required`, `optional` o `none` para una aplicación; si no, `null`) y `conditional` (`true` cuando el servicio solo se crea para algunas respuestas). **creates\_stack** `boolean` `true` cuando usar la plantilla crea un stack, lo que ocurre con dos o más servicios. **ram\_min\_total** `integer` La suma de la memoria mínima de cada servicio, en MB. **byok** `boolean` `true` cuando traes tu propia clave del modelo de IA que usa el software. **required\_plan** `string` El plan más bajo que puede usar la plantilla. **code\_view** `boolean` `false` para una plantilla cerrada: quien la usa no puede ver ni descargar su código. Las plantillas públicas siempre son abiertas. **uses\_count** `integer | null` Cuántas veces se usó una plantilla del catálogo: el total de despliegues terminados con éxito, en todas las versiones. Los despliegues fallidos o revertidos no cuentan, y eliminar la aplicación resultante no lo reduce. Es solo un agregado, sin información sobre quién la usó. `null` para plantillas privadas. **owner** `object | null` El propietario de una plantilla privada, con `user_id` y `workspace_id` (`null` cuando pertenece al usuario); `null` para plantillas del catálogo. **github** `object | null` El repositorio de GitHub vinculado de una plantilla privada (`repository` como `owner/name` y `branch`), o `null`. **created\_at** `string` Cuándo se creó la plantilla. **updated\_at** `string` Cuándo se actualizó la plantilla por última vez. **account** `object` Presente solo cuando la petición está autenticada: lo que usar la plantilla haría con tu cuenta. **Mostrar objeto** **fits** `boolean` `true` cuando tu plan y tus recursos libres cubren la plantilla. **reasons** `object[]` Por qué no encaja; vacío cuando encaja. Cada elemento tiene `reason` y, cuando es un número o un plan, `required` y `available`. Motivos: `no_plan`, `ram`, `web_publish`, `image_plan`, `image_slots`, `private_network` (un enlace de la plantilla no está disponible por las direcciones públicas), `blob_plan`, `min_plan`, `max_apps`, `max_databases` y `deploys_per_hour`. **required\_ram** `integer` La memoria que necesita la plantilla: la suma de la memoria mínima de los servicios que se crearían, en MB. **free\_ram** `integer` La memoria libre de tu cuenta, en MB. **needs\_image\_slot** `boolean` `true` cuando usar la plantilla ocupa un slot de imagen que aún no tienes. Nunca es `true` para una imagen de tu propia plantilla privada. **image\_slots\_free** `integer` Los slots de imagen libres de tu cuenta. **in\_use** `boolean` `true` cuando tu cuenta ya ejecuta aplicaciones creadas a partir de esta plantilla. **in\_use\_count** `integer` Cuántas aplicaciones y stacks de tu cuenta vienen de esta plantilla. **total\_count** `integer` Cuántas plantillas coinciden con los filtros, en todas las páginas. **page** `integer` La página actual. **limit** `integer` El tamaño de página usado. **total\_pages** `integer` El número de páginas. **has\_next\_page** `boolean` `true` cuando hay una página siguiente. **has\_previous\_page** `boolean` `true` cuando hay una página anterior. Una respuesta anónima puede guardarse en caché durante 30 segundos. Una respuesta autenticada nunca se guarda en caché. ```bash cURL theme={null} curl "https://api.vertracloud.app/v1/templates?category=bots&fits=true&sort=popular&limit=10" \ -H "Authorization: Bearer $VERTRA_API_KEY" ``` ```json Response theme={null} { "response": { "data": [ { "id": "7c1d4f0e-3b8a-4d52-9a66-1f0c2e5a9b41", "slug": "discord-bot-js", "origin": "vertra", "visibility": "public", "name": { "pt-br": "Bot de Discord (JavaScript)", "en": "Discord bot (JavaScript)", "es": "Bot de Discord (JavaScript)" }, "description": { "pt-br": "Bot de Discord com discord.js e o comando /ping. Ponto de partida para o seu bot.", "en": "Discord bot with discord.js and a /ping command. A starting point for your bot." }, "category": "bots", "tags": ["discord", "bot", "javascript", "discordjs"], "icon_url": "https://api.vertracloud.app/v1/template-icons/7c1d4f0e-3b8a-4d52-9a66-1f0c2e5a9b41?v=a1b2c3d4", "author_display": null, "links": { "website": "https://discord.js.org", "docs": "https://discordjs.guide" }, "landing": null, "featured": true, "current_version": { "id": "e0b7a2c9-5d14-4f8e-8c3a-92d6b1f47a10", "version": "1.0.0", "security": false, "created_at": "2026-10-26T13:05:00Z" }, "services": [ { "id": "app", "kind": "app", "source_type": "code", "database": null, "blob_visibility": null, "ram": { "min": 256, "recommended": 256 }, "web": "none", "conditional": false } ], "creates_stack": false, "ram_min_total": 256, "byok": false, "required_plan": "economy", "code_view": true, "uses_count": 87, "owner": null, "github": null, "created_at": "2026-10-26T09:00:00Z", "updated_at": "2026-10-26T13:05:00Z", "account": { "fits": true, "reasons": [], "required_ram": 256, "free_ram": 2048, "needs_image_slot": false, "image_slots_free": 0, "in_use": false, "in_use_count": 0 } } ], "total_count": 1, "page": 1, "limit": 10, "total_pages": 1, "has_next_page": false, "has_previous_page": false } } ``` ### Respuestas de error **code** `string` El código de error que indica el motivo del fallo. Valores posibles: * `VALIDATION_ERROR`: Un parámetro de consulta no es válido, por ejemplo una `category` desconocida o un `limit` superior a 50 (`400`). * `AUTH_TOKEN_MISSING`: `fits=true` sin autenticación (`401`). * `API_KEY_SCOPE_DENIED`: La clave de API no tiene el ámbito `templates:read` (`403`). * `WORKSPACE_NOT_FOUND`: El workspace de `workspace_id` no existe o no formas parte de él (`404`). * `RATE_LIMIT_EXCEEDED`: Demasiadas peticiones (`429`). * `INTERNAL_SERVER_ERROR`: Fallo inesperado (`500`). ```json Error Response theme={null} { "code": "AUTH_TOKEN_MISSING" } ``` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.