Saltar a contenido

List account credit history


title: List the stamp-credit history

List the caller's stamp-credit history, newest first: the top-ups that added credit and the stamps that used it. Read-only. This concerns the account's prepaid credit only, not CFDIs (those are in list_invoices) and not payments received for an invoice. Returns {billing: on, total, limit, offset, entries: [{when (ISO 8601 UTC or null), kind (topup | bonus | welcome_bonus | referral_bonus | stamp | stamp_refund | adjustment), amount (signed: stamps are negative), currency, cfdi_id (the stamped document, for stamp rows, else null)}]} or {billing: off}.

Alcance (scope): invoices:read · Características: Solo lectura, Idempotente

Parámetros

Parámetro Tipo Obligatorio Descripción
limit integer No
offset integer No
issuer string Sí Id of the issuer the call acts for, from list_issuers.

Esquema de entrada (JSON Schema)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 20
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "default": 0
    },
    "issuer": {
      "type": "string",
      "format": "uuid",
      "description": "Id of the issuer the call acts for, from list_issuers."
    }
  },
  "required": [
    "issuer"
  ]
}