| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Una fila por evento del historial de gift cards (use_value = consumo de saldo, recharge = recarga, created, assign, activate, deactivate, updated y otros), mas expiraciones inferidas (inferido=true). Cada fila trae la gift card con su id (el mismo giftcardId/promocionId de promociones_descuentos tipo 4), el codigo enmascarado (**** + ultimos 4; nunca el codigo completo), el saldo actual y el vencimiento, y el cliente dueno actual. monto esta en unidades monetarias; saldoActual es el saldo de hoy, no el historico. Las fechas salen en hora del negocio y una fecha YYYY-MM-DD es el dia completo en la zona horaria del negocio. Con giftcard_id devuelve el historial de una tarjeta; con evento=recharge solo recargas.
| Scope requerido | giftcards:read |
| Método | GET /ext/v3/giftcards/eventos |
Query
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
giftcard_id | integer | no | Id de la gift card (giftcardId / promocionId de un descuento tipo 4) |
evento | enum: use_value | recharge | created | assign | no | Solo esta accion: use_value (consumo), recharge (recarga), created o assign. Omitir = todas, incluidas expiraciones inferidas |
fecha_inicio | string | no | YYYY-MM-DD o ISO 8601, inclusiva |
fecha_fin | string | no | YYYY-MM-DD o ISO 8601, inclusiva |
clauId | string | no | UID del cliente dueno actual |
email | string | no | Correo del cliente dueno actual |
numId | string | no | Identificacion del cliente dueno actual |
extId | string | no | ID externo del cliente dueno actual |
page_size | integer | no | Registros por pagina Default 100. |
page | integer | no | Numero de pagina Default 1. |
orden | enum: asc | desc | no | Orden por fecha del evento Default "asc". |
Ejemplo
curl -X GET 'https://api3.clau.io/ext/v3/giftcards/eventos' \
-H 'apikey: ck_1_...'Respuesta 200
{
"codigoRespuesta": 0,
"msj": "Exito",
"data": {
"eventos": [
{
"eventoId": "historial-60",
"evento": "use_value",
"fecha": "2026-10-20 13:15:20",
"inferido": false,
"monto": 12.5,
"giftcard": {
"giftcardId": 310,
"codigo": "****4321",
"tipo": "rechargeable",
"estadoId": 1,
"saldoActual": 7.5,
"fechaExpiracion": "2027-12-31"
},
"cliente": {
"clauId": "uid-7",
"email": "[email protected]",
"numId": "8-888-888",
"nombre": "Ana",
"apellido": "Perez",
"extId": "EXT-7"
}
}
],
"paginacion": {
"pagina": 1,
"tamanoPagina": 100,
"totalRegistros": 1,
"totalPaginas": 1,
"tieneSiguiente": false
}
},
"meta": {
"requestId": "5f1c…",
"appId": 1,
"scope": "giftcards:read"
}
}Errores: 401 key inválida (9501), 403 sin scope (9503, meta.requiredScope), 400 parámetros (details), 429 límite de tasa. Agregue ?help=true para la ayuda en texto plano.