---
title: "Listar definiciones de campos personalizados de variantes"
method: GET
path: "/api/v1/products/variant-metafield-definitions"
tags: ["API"]
---

# Listar definiciones de campos personalizados de variantes

`GET /api/v1/products/variant-metafield-definitions`

## Request

- Base URL: `https://api.lapyme.com.ar`
- URL: `https://api.lapyme.com.ar/api/v1/products/variant-metafield-definitions`
- Auth: HTTP bearer

Devuelve las definiciones no sistémicas de variantes. Cada variante guarda su propio valor: enviá key y value en variants[].metafields de Guardar las variantes de un producto. Una clave es de productos o de variantes, nunca de ambos. Las definiciones select incluyen todos los valores configurados u observados, deduplicados y con su cantidad de variantes. Los valores de texto libre no se enumeran. La disponibilidad depende de que los campos personalizados estén habilitados para la organización.

## Response `200`

Definiciones obtenidas exitosamente

- ApiProductMetafieldDefinitionsResponse
  - `request_id` string, required
  - `data` object, required
    - `definitions` object[], required
      - `id` string, uuid, required
      - `object` 'metafield_definition', required
      - `key` string, required
      - `name` string, required
      - `description` string, nullable, required
      - `field_type` 'boolean' | 'text' | 'number' | 'date' | 'select', required
      - `validations` ApiSharedObjecta855803bd5, required
        - `required` boolean, required
        - `min_length` integer
        - `max_length` integer
        - `min` number
        - `max` number
        - `options` string[]
      - `values` object[]
        - `value` string, required
        - `configured` boolean, required
        - `observed` boolean, required
        - `product_count` integer, required
  - `warnings` unknown[], required
    - unknown

## Other responses

- `401`: API key faltante o inválida
- `403`: Scope insuficiente o funcionalidad no habilitada
- `429`: Límite de solicitudes excedido para la organización
- `500`: Error interno
- `503`: Verificación de credenciales temporalmente ocupada; reintentá sin cambiar la operación ni su Idempotency-Key.

## Changes

- **2026-11-03** `ed0d46e68fbe`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lapyme/apis/la-pyme-api/changes/api/v1/products/variant-metafield-definitions/get.md)

---

[API](https://skmtc.dev/lapyme/apis/la-pyme-api.md) - [All operations](https://skmtc.dev/lapyme/apis/la-pyme-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lapyme/apis/la-pyme-api/revisions/067bbb55f421?raw)