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

# Listar definiciones de campos personalizados de ventas

`GET /api/v1/sales/metafield-definitions`

## Request

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

Devuelve páginas de campos personalizados de ventas de la empresa autenticada. Incluye key, tipo y validaciones. Enviá key y value en metafields al crear o editar una venta. Usa next_cursor para continuar; limit admite de 1 a 100. Requiere sales:read; sales:write y admin incluyen este permiso. No requiere Idempotency-Key.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Definiciones obtenidas exitosamente

- ApiSaleMetafieldDefinitionsResponse
  - `request_id` string, required
  - `object` 'list', required
  - `url` string, required
  - `data` ApiSharedObjectd7e4c12cd9[], required
    - `object` 'metafield_definition', required
    - `id` string, uuid, required
    - `key` string, required
    - `name` string, required
    - `description` string, nullable, required
    - `field_type` 'boolean' | 'text' | 'number' | 'date' | 'select', required
    - `validations` ApiSharedObjectba357c1d29, required
      - `required` boolean, required
      - `min_length` number
      - `max_length` number
      - `min` number
      - `max` number
      - `options` string[]
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Cursor o límite inválido
- `401`: Credencial faltante o inválida
- `403`: Scope insuficiente
- `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/sales/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)