Administración

Obtener saldo de la organización

Devuelve los totales actuales de saldo de la organización para el token de gestión.

GEThttps://api.tokenlab.sh/v1/management/balance

Resumen

Este endpoint devuelve los totales actuales de saldo de la organización asociada al token de gestión. Usa la misma referencia actual de saldo de organización que la facturación y la liquidación.

Notas

  • Los campos monetarios solo admiten USD.

  • Los campos monetarios se devuelven en USD. Usa balance, total_recharge y total_used para visualización; usa balance_decimal, total_recharge_decimal y total_used_decimal para conciliación exacta.

Ejemplo

Solicitud

cURL
curl -X GET "https://api.tokenlab.sh/v1/management/balance" \
  -H "Authorization: Bearer mt-your-management-token"

Solicitud / Respuesta

Esta página ofrece el esquema OpenAPI y ejemplos de solicitudes que puedes copiar. Envía las solicitudes de gestión desde tu terminal o cliente con un Management Token; esta página no permite enviarlas directamente.

Ejemplo de respuesta

Respuesta

200 OK
{
  "object": "organization_balance",
  "organization_id": "org_123",
  "balance": 42.5,
  "balance_decimal": "42.50",
  "total_recharge": 100,
  "total_recharge_decimal": "100",
  "total_used": 57.5,
  "total_used_decimal": "57.50"
}

Campos importantes

objectstring
Siempre organization_balance.
organization_idstring
Organización asociada al token de gestión actual.
balancenumber
Saldo actual de la organización en USD como JSON number para visualización.
balance_decimalstring
Saldo actual exacto de la organización en USD como cadena decimal para conciliación.
total_rechargenumber
Total de recargas correctas de la organización en USD como JSON number para visualización.
total_recharge_decimalstring
Total exacto de recargas correctas de la organización en USD como cadena decimal para conciliación.
total_usednumber
Gasto acumulado de uso de la organización en USD como JSON number para visualización.
total_used_decimalstring
Gasto acumulado exacto de uso de la organización en USD como cadena decimal para conciliación.

Autorización

ManagementTokenAuth
AuthorizationBearer <token>

Autenticación con Management Token. Cree o gestione Management Tokens en Dashboard > API > Management Tokens.

Ubicación: header

Respuesta

application/json

application/json

application/json

application/json