ItemsFiltrar ítems activos

Filtrar ítems activos

GEThttps://api.copayex.com/api/v1/items/active

Parámetros de solicitud

CampoTipoUbicaciónRequeridoDescripción
querystringQueryNoTexto libre para título/descripcion.
dateFromstring (ISO8601)QueryNoFecha inicial de creación.
dateTostring (ISO8601)QueryNoFecha final de creación.

Parámetros de respuesta

Devuelve una lista de ítems con la misma estructura que otros listados ([{ ... }]). Campos principales:

CampoTipoDescripción
idnumberIdentificador interno del ítem.
numbernumberConsecutivo recomendado para el frontend.
uuidstringIdentificador global (UUID).
amountnumberMonto total configurado.
amountPayednumberMonto acumulado pagado.
titlestringNombre visible del ítem.
descriptionstringDescripción opcional.
status"active" | "finished" | "void"Estado del ítem (en este endpoint serán active).
paymentMethodsstring[]Métodos de pago habilitados (ej. "mercadopago").
staticQrstring | nullnull si no tiene QR; de lo contrario, ID del QR asociado.
createdAtstring (ISO8601)Fecha de creación.

Ejemplos de solicitud

curl -G "https://api.copayex.com/api/v1/items/active" \
  -H "Authorization: Bearer <client_access_token>" \
  --data-urlencode "query=Reserva"

Respuesta de ejemplo

[
  {
    "uuid": "a1474c92-f58e-4066-9421-2cdf0e06e435",
    "id": 1,
    "amount": 1200,
    "amountPayed": 0,
    "number": 1,
    "title": "Combo latte",
    "description": "Café + medialunas",
    "createdAt": "2025-11-11T21:44:01.000Z",
    "status": "active",
    "paymentMethods": ["mercadopago"],
    "staticQr": null
  }
]