> ## Documentation Index > Fetch the complete documentation index at: https://docs.1to1ai.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar templates APPROVED del business > Lista templates de WhatsApp APPROVED del business. Útil para descubrir qué `template_name` está disponible al usar `POST /conversation/messages/template` o al programar un schedule humano con fallback de template. **Filtros:** - `search` — filtra por substring del nombre (ILIKE). Sin acentos sensitivity, server-side. - `page` — 1-based, default `1`. - `limit` — default `20`, máximo `50`. **Por qué solo APPROVED:** la API pública solo expone templates listas para enviar a Meta. Para inspeccionar templates en `PENDING`/`REJECTED` revisar el dashboard. ## OpenAPI ````yaml /openapi.json get /{slug}/templates openapi: 3.1.0 info: title: 1TO1 AI Public API version: 0.2.0 description: >- API pública de 1TO1 AI para integraciones externas (n8n, CRMs, scripts). Auth via Bearer token. Rate limit 60 req/min por API key. Contrato REST puro: el body de éxito es el payload directo (status HTTP como señal), errores retornan `{code, message}` con ambos campos garantizados. Ver schema `PublicError`. servers: - url: https://app.1to1.ai/api/v1/public description: Producción security: - bearerAuth: [] paths: /{slug}/templates: get: tags: - Templates summary: Listar templates APPROVED del business description: >- Lista templates de WhatsApp APPROVED del business. Útil para descubrir qué `template_name` está disponible al usar `POST /conversation/messages/template` o al programar un schedule humano con fallback de template. **Filtros:** - `search` — filtra por substring del nombre (ILIKE). Sin acentos sensitivity, server-side. - `page` — 1-based, default `1`. - `limit` — default `20`, máximo `50`. **Por qué solo APPROVED:** la API pública solo expone templates listas para enviar a Meta. Para inspeccionar templates en `PENDING`/`REJECTED` revisar el dashboard. parameters: - $ref: '#/components/parameters/SlugPathParam' - schema: type: string minLength: 1 maxLength: 100 example: confirmacion description: Substring del nombre, case-insensitive. required: false description: Substring del nombre, case-insensitive. name: search in: query - schema: type: integer minimum: 1 default: 1 example: 1 required: false name: page in: query - schema: type: integer minimum: 1 maximum: 50 default: 20 example: 20 required: false name: limit in: query responses: '200': description: Listado paginado de templates APPROVED. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/TemplatesListResponse' '400': description: Query inválida (INVALID_REQUEST). headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '401': description: Token ausente, mal formado o no válido (INVALID_API_TOKEN) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '403': description: >- El slug del path no coincide con el business del token (TOKEN_BUSINESS_MISMATCH) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '422': description: >- El business no tiene canal de WhatsApp configurado (CHANNEL_NOT_CONFIGURED). headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '429': description: >- Rate limit excedido (RATE_LIMIT_EXCEEDED). Headers `Retry-After`, `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` indican cuándo reintentar. headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' '500': description: Error inesperado del servidor (UNKNOWN_ERROR) headers: X-Request-Id: schema: type: string format: uuid description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. required: true description: >- ID único para correlacionar con logs server-side. Si el cliente envía uno válido (UUID), se preserva; si no, se genera uno nuevo. content: application/json: schema: $ref: '#/components/schemas/PublicError' components: parameters: SlugPathParam: schema: $ref: '#/components/schemas/SlugPathParam' required: true description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. name: slug in: path schemas: TemplatesListResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/TemplateSummary' pagination: $ref: '#/components/schemas/TemplatesPagination' required: - data - pagination PublicError: type: object properties: code: type: string example: INVALID_API_TOKEN message: type: string example: >- The provided API token is invalid or has been revoked. Generate a new one in Settings → API Token. required: - code - message description: >- Public API error body. The client should match against `code` (stable canonical identifier) and NOT against `message` (human text, may be refined between API versions without notice). The HTTP status code is the error-type signal (4xx client, 5xx server). SlugPathParam: type: string example: acme description: >- Slug del business, case-insensitive. Debe coincidir con el business del token. TemplateSummary: type: object properties: uuid: type: string format: uuid name: type: string example: confirmacion_cita language: type: string example: es_MX status: type: string example: APPROVED description: >- Estado en Meta. La API pública solo expone APPROVED por diseño — los demás se ocultan. category: type: string example: UTILITY description: 'Categoría Meta: `MARKETING`, `UTILITY`, `AUTHENTICATION`.' body_text: type: - string - 'null' description: Body crudo aprobado en Meta (con placeholders `{{1}}`, `{{2}}`, …). parameters: $ref: '#/components/schemas/TemplateParameters' required: - uuid - name - language - status - category - body_text - parameters description: Template aprobado para usar en envíos y schedules. TemplatesPagination: type: object properties: page: type: integer minimum: 1 total_pages: type: integer minimum: 0 total_count: type: integer minimum: 0 has_more: type: boolean required: - page - total_pages - total_count - has_more description: Metadata de paginación basada en `page` (1-based). TemplateParameters: type: object properties: body_variables: type: array items: $ref: '#/components/schemas/TemplateBodyVariable' header_parameter: allOf: - $ref: '#/components/schemas/TemplateHeaderParameter' - type: - object - 'null' button_parameters: type: array items: allOf: - $ref: '#/components/schemas/TemplateButtonParameter' - description: Parámetro dinámico de botón URL. required: - body_variables - header_parameter - button_parameters description: >- Conjunto completo de placeholders del template — informa qué `body_variables`, `header` y `button_parameters` hay que enviar al usar el template. TemplateBodyVariable: type: object properties: index: type: integer minimum: 1 example: 1 description: Posición 1-based del placeholder en el body (`{{1}}`, `{{2}}`, …). example: type: - string - 'null' description: Valor de ejemplo cargado en Meta al aprobar el template, si existe. example: Ana required: - index - example description: Variable del body del template. TemplateHeaderParameter: type: object properties: type: type: string enum: - text - image - video - document example: image example: type: - string - 'null' description: >- Texto de ejemplo (header text) o handle del media (header media) cargado en Meta. required: - type - example description: >- Parámetro del header del template, si el template tiene header con placeholder. TemplateButtonParameter: type: object properties: subType: type: string enum: - url index: type: integer minimum: 0 example: 0 text: type: string example: ver-promo required: - subType - index - text description: >- Parámetro para botón de tipo URL con placeholder dinámico. `text` reemplaza `{{1}}` en la URL del botón. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: sk_1to1_ description: >- API token emitido desde Settings → API Token del dashboard 1TO1 AI. Enviar en header Authorization: Bearer sk_1to1_... ````