---
title: "List Mappings"
method: GET
path: "/api/admin/stelorder/mappings"
tags: ["copilot_frontend", "admin", "Admin Stelorder"]
---

# List Mappings

`GET /api/admin/stelorder/mappings`

Lista todos los mapeos de Stelorder con filtros opcionales.

Args:
    category: Filtrar por categoría específica
    is_active: Filtrar por mapeos activos/inactivos
    db: Sesión de base de datos

Returns:
    Lista de mapeos con count total

Example:
    GET /admin/stelorder/mappings?category=incident_type&is_active=true

## Query parameters

- `category` string, nullable — Filtrar por categoría
- `is_active` boolean, nullable — Filtrar por estado activo

## Response `200`

Successful Response

- StelorderMappingsList — Schema de respuesta para lista de mapeos.
  - `mappings` StelorderMappingResponse[], required
    - `category` string, required — Categoría del mapeo: technician_calendar, incident_type, etc.
    - `hubspot_label` string, required — Etiqueta legible en HubSpot
    - `hubspot_value` string, nullable — Valor técnico (ej: email para técnicos)
    - `stelorder_id` integer, nullable — ID numérico del recurso en Stelorder
    - `stelorder_name` string, nullable — Nombre del recurso en Stelorder
    - `is_default` boolean — Si es el valor por defecto para esta categoría
    - `is_active` boolean — Si el mapeo está activo
    - `notes` string, nullable — Notas adicionales sobre este mapeo
    - `id` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `count` integer, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api.md) · [All operations](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hogarsolar/hogarsolar-backend-api/revisions/d9861e46bef8/schema)