API de cuenta y consumo

Uso de Cuenta

Obtiene tu plan actual, límite mensual de solicitudes, conteo de uso y solicitudes restantes para el período de facturación actual.

Solicitud

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.postalkit.mx/v1/account/usage

Respuesta

{
  "data": {
    "plan": "free",
    "monthly_limit": 100,
    "usage_count": 42,
    "remaining": 58,
    "period": "2026-08"
  }
}

Versión de Base de Datos

Obtiene cuándo cambió por última vez el catálogo postal, cuándo se revisó por última vez contra la fuente oficial y la versión actual de la API.

Solicitud

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.postalkit.mx/v1/account/db-version

Respuesta

{
  "data": {
    "last_updated": "2026-08-01T03:00:00.000000Z",
    "catalog_version": "2026-08-01",
    "last_checked_at": "2026-09-01T03:00:00.000000Z",
    "version": "1.0.0"
  }
}

last_checked_at avanza el primero de cada mes haya cambiado o no el catálogo publicado, así que un last_updated que lleva meses sin moverse es una fuente que no se ha movido. Cada ejecución registrada aparece en Actualizaciones del catálogo.