GET /templates

Lista los templates de credenciales disponibles para tu organizacion.

Request

GET /api/v1/templates?page=1&page_size=20

Headers

Header	Requerido	Descripcion
X-API-Key	Si	Tu API key

Query Parameters

Parametro	Tipo	Default	Descripcion
page	integer	1	Numero de pagina
page_size	integer	20	Resultados por pagina (max 100)

Response

{
  "templates": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "name": "Certificado de Completitud - Curso Python",
      "description": "Certificado otorgado a estudiantes que completaron el curso",
      "achievement_type": "Certificate",
      "required_fields": [
        {"name": "email", "type": "string", "description": "Recipient email address"},
        {"name": "recipient_name", "type": "string", "description": "Recipient full name"},
        {"name": "result_value", "type": "string", "description": "Grade/result (LetterGrade)"}
      ],
      "optional_fields": [
        {"name": "activity_end_date", "type": "date", "description": "Activity end date (YYYY-MM-DD)"}
      ]
    }
  ],
  "total": 1,
  "page": 1,
  "page_size": 20
}

Campos de cada template

Campo	Descripcion
id	UUID del template (usar como template_id en otros endpoints)
name	Nombre del template
description	Descripcion del template
achievement_type	Tipo: Badge, Certificate, Diploma, etc.
required_fields	Campos obligatorios al emitir
optional_fields	Campos opcionales

Ejemplo

curl -X GET "https://app.unicreda.com/api/v1/templates?page=1&page_size=10" \
  -H "X-API-Key: uc_live_tu_key_aqui"

import requests

response = requests.get(
    "https://app.unicreda.com/api/v1/templates",
    headers={"X-API-Key": "uc_live_tu_key_aqui"},
    params={"page": 1, "page_size": 10}
)
templates = response.json()["templates"]