Consultar Saldo

Devuelve el saldo USD actual.

Consultar Saldo

GET /v1/balance

curl -X GET "https://api.zelnum.com/api/v1/balance" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "balance": "5.230000"
}

Campo	Tipo	Descripción
`balance`	string	Saldo disponible en USD, con 6 decimales fijos.

Información de la clave

Devuelve los metadatos de la clave usada en la solicitud. El secreto nunca se devuelve, solo un prefijo enmascarado, para confirmar qué clave se usó sin exponer la credencial.

GET /v1/api-key

curl -X GET "https://api.zelnum.com/api/v1/api-key" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "api_key_id": 12,
  "masked_key": "ck_xxxxxxxxx…****",
  "last_used": "2026-09-12T09:14:03.000000Z",
  "created_at": "2026-08-30T11:02:44.000000Z"
}

Campo	Tipo	Descripción
`api_key_id`	integer	Identificador de la clave, útil en solicitudes de soporte.
`masked_key`	string	Prefijo enmascarado. La clave en texto plano nunca se devuelve aquí.
`last_used`	string \| null	Fecha y hora de la última solicitud autenticada con esta clave.
`created_at`	string	Cuándo se creó la clave.

Las solicitudes a la API se limitan por clave de API y por grupo de endpoints:

Endpoints	Límite
`GET /v1/balance` · `GET /v1/api-key`	60 solicitudes / minuto por clave de API (120 / minuto por IP)

Errores

Estado	`code`	Causa
`401`	`unauthorized`	Falta la clave de API, no es válida o está inactiva.
`403`	`account_banned`	Cuenta suspendida. Contacte con soporte.
`429`	—	Límite de solicitudes alcanzado; consulta Límites de solicitudes.

Ambos endpoints comparten el cubo general: 60 solicitudes / minuto por clave de API.