---
title: "Obtener detalles de un campo personalizado"
method: GET
path: "/custom-fields/properties/{propertyName}"
tags: ["Custom Fields"]
---

# Obtener detalles de un campo personalizado

`GET /custom-fields/properties/{propertyName}`

## Request

- Base URL: `http://localhost:8081`
- URL: `http://localhost:8081/custom-fields/properties/{propertyName}`
- Auth: HTTP bearer

Retorna información detallada sobre un custom field específico.

**Incluye**:
- Metadata del campo (nombre, tipo, total de registros)
- Valores de muestra (por defecto 10, configurable con `?limit=N`)

**Uso**: Para mostrar valores de ejemplo al usuario antes de crear filtro.

## Path parameters

- `propertyName` string, required

## Query parameters

- `limit` integer

## Response `200`

Detalles del campo obtenidos exitosamente

- CustomFieldDetailsResponse
  - `success` boolean, required
  - `field` CustomFieldDetails, required
    - `property_name` string, required: Nombre técnico del campo
    - `data_type` 'TEXT' | 'SELECT' | 'LIST' | 'NUMBER' | 'BOOLEAN' | 'DATE', required
    - `display_name` string, required: Nombre legible
    - `total_records` integer, required: Total de registros
    - `sample_values` string[], required: Valores de muestra
    - `data_type_conflict` string[]: Solo si el nombre tiene definiciones de tipos incompatibles en los tenants consultados (data_type es entonces el del valor más reciente). Ruta de visualización; la segmentación lo rechaza con CUSTOM_FIELD_TYPE_CONFLICT
    - `definition_unverified` boolean: Solo si no se pudieron leer las definiciones; data_type es el del valor más reciente y no está verificado. La segmentación responde 503 en ese caso

## Other responses

- `404`: Campo no encontrado
- `500`: Error interno del servidor

---

[API](https://skmtc.dev/nevent/apis/nevent-data-api.md) · [All operations](https://skmtc.dev/nevent/apis/nevent-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/nevent/apis/nevent-data-api/revisions/81035d32c1c1?raw)