Ver los timbres

Ir al contenido

GET

/v1/balance

Los timbres de producción que le quedan, por paquete. En pruebas se timbra gratis.

Autorización

bearerAuth

headerAutorizaciónBearer <llave>

Su llave secreta: fk_test_… en pruebas, fk_live_… en producción. Desarrolladores › Llaves.

Cuerpo de la respuesta

Correcto.

application/json

response

Timbres de producción de la cuenta, por paquete, el que vence antes primero.

object*string

Qué tipo de objeto es («invoice», «customer»…).

livemode*boolean

true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT.

available*integer

Timbres disponibles en total.

Rango-9007199254740991 <= value <= 9007199254740991

unlimited*boolean

true si la cuenta timbra sin usar timbres.

low_balance_at*integer

Con esta cantidad o menos llega balance.low (y otra vez al acabarse). Se elige en Desarrolladores › Timbres.

Rango-9007199254740991 <= value <= 9007199254740991

auto_recharge*|

La recarga automática con la tarjeta guardada, o null si está apagada.

packs*array<>

Los paquetes con timbres, el que vence antes primero (en ese orden se usan).

curl -X GET 'https://api.fiscalisto.com/v1/balance' \  -H 'Authorization: Bearer fk_test_…'

{  "object": "balance",  "livemode": true,  "available": 20,  "unlimited": false,  "low_balance_at": 100,  "auto_recharge": null,  "packs": [    {      "timbres": 20,      "remaining": 20,      "purchased_at": "2026-10-24T10:15:42-06:00",      "expires_at": null    }  ]}

Ver los timbres

AutorizaciónCopiar enlace a esta sección

Cuerpo de la respuestaCopiar enlace a esta sección

Autorización

Cuerpo de la respuesta