Skip to content
On this page
Home
>API
>getBalance: Saldo

getBalance: Consultar el saldo de la cuenta

Obtén el saldo de una cuenta con su clave de cuenta, lo cual es conveniente para configurar tus propias alertas y consultas.

Ejemplo de solicitud

Estructura de la Solicitud

ParámetrosTipoRequeridoDescripción
clientKeyStringYesClave de la cuenta del cliente, se puede encontrar aquí
json
POST https://api.capsolver.com/getBalance
Host: api.capsolver.com
Content-Type: application/json

{
  "clientKey": "YOUR_API_KEY"
}

Ejemplo de respuesta

Estructura de la Respuesta

ParámetroTipoDescripción
errorIdIntegerMensaje de error:
0 - sin error
1 - con error
errorCodeStringerrorCode: lista completa de errores
errorDescriptionStringDescripción breve del error
balanceDecimalValor del saldo de la cuenta en USD
packagesArrayPaquetes mensuales/semanales

Ejemplo de Respuesta

json
{
  "errorId": 0,
  "balance": 1071810,
  "packages": []
}

Uso de la solicitud con SDK

python
#pip install --upgrade capsolver
#export CAPSOLVER_API_KEY='...'

import capsolver
# capsolver.api_key = "..."
saldo = capsolver.balance()
go
package main

import (
	capsolver_go "github.com/capsolver/capsolver-go"
	"log"
)

func main() {
	// primero debes instalar el SDK
	//go get github.com/capsolver/capsolver-go
	//export CAPSOLVER_API_KEY='...' o
	//capSolver := CapSolver{apiKey:"..."}

	capSolver := capsolver_go.CapSolver{}
	saldo, err := capSolver.Balance()
	if err != nil {
		log.Fatal(err)
	}
	log.Println(saldo.Balance)

}