Listar ítems

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

Devuelve todos los ítems sin filtros adicionales.

Parámetros de solicitud

Sin parámetros.

Parámetros de respuesta

La respuesta es una lista de ítems con los siguientes campos:

Campo	Tipo	Descripción
`id`	number	Identificador interno del ítem.
`number`	number	Consecutivo recomendado para consultas en frontend.
`uuid`	string	Identificador único (UUID) del ítem.
`amount`	number	Monto total configurado.
`amountPayed`	number	Monto pagado hasta el momento.
`title`	string	Nombre del ítem.
`description`	string	Descripción del ítem.
`status`	`"active" \| "finished" \| "void"`	Estado actual del ítem.
`paymentMethods`	string[]	Métodos de pago habilitados (ej. `"mercadopago"`).
`staticQr`	string \| null	`null` indica que no hay QR asociado; si existe muestra el ID del QR.
`createdAt`	string (ISO8601)	Fecha de creación del ítem.

Ejemplos de solicitud

curl -X GET "https://api.copayex.com/api/v1/items" \
  -H "Authorization: Bearer <client_access_token>"

const response = await fetch("https://api.copayex.com/api/v1/items", {
  method: "GET",
  headers: {
    Authorization: "Bearer <client_access_token>",
  },
});
 
const data = await response.json();
console.log(data);

import requests
 
headers = {
    "Authorization": "Bearer <client_access_token>"
}
 
response = requests.get(
    "https://api.copayex.com/api/v1/items",
    headers=headers,
    timeout=10,
)
response.raise_for_status()
print(response.json())

Respuesta de ejemplo

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

Crear ítem Asociar QR estático