---
title: "Obtener saldo de Funding Account"
method: GET
path: "/payouts-configuration/funding-account/balance"
tags: ["Funding Account"]
---

# Obtener saldo de Funding Account

`GET /payouts-configuration/funding-account/balance`

## Request

- Base URL: `https://api.trytoku.com`
- URL: `https://api.trytoku.com/payouts-configuration/funding-account/balance`
- Auth: API key in header `x-api-key`

Devuelve el saldo disponible de una Funding Account de la organización, consultado en el gateway que la opera.

Se usa para verificar que hay fondos antes de ejecutar payouts. La cuenta se elige con `id_funding_account`; una organización con una sola Funding Account puede omitirlo y se consulta esa. Con más de una el parámetro es obligatorio: el saldo decide si se dispersa, así que no se elige una cuenta por posición. El saldo se lee por el primer gateway activo de la cuenta. El número de cuenta se devuelve enmascarado: solo quedan visibles sus últimos cuatro caracteres.

La organización consultada es siempre la que el gateway autentica, no una que se pueda elegir en la petición.

Responde `422` cuando la organización no tiene Funding Accounts, cuando tiene más de una y la petición no indica `id_funding_account`, cuando ninguno de los gateways de la cuenta está activo, o cuando el gateway consultado exige el `tax_id` de la organización y no está registrado.

**Límite de tasa:** 1000 solicitudes por hora. Al superarlo, la API responde `429`. Ver [Límites de tasa](/reference/limites-de-tasa).

## Query parameters

- `id_funding_account` string, uuid, nullable: Funding Account cuyo saldo se consulta. Se puede omitir solo cuando la organización tiene una sola cuenta vigente

## Response `200`

Saldo de la Funding Account de la organización.

- AccountBalanceResponse: Saldo de la primera Funding Account de la organización, consultado a través del primer gateway habilitado.
  - `account_number` string, required: Número de cuenta enmascarado de la Funding Account con que se hizo la consulta (solo quedan visibles los últimos cuatro caracteres).
  - `balance` string, required: Saldo disponible que informa el gateway.
  - `currency_code` string, required: Código de moneda de la Funding Account con que se hizo la consulta.
  - `gateway` string, required: Gateway con que se obtuvo el saldo (actualmente, el primer gateway habilitado de la organización).
  - `id_funding_account` string, required: Funding Account con que se consultó el saldo (actualmente, la primera configurada en la organización).
  - `organization_id` string, required: Identificador de la organización para la que se consultó el saldo.

## Other responses

- `400`: La petición llegó sin el identificador de organización que inyecta el gateway.
- `404`: No existe configuración de payouts para la organización, o la Funding Account indicada no es una cuenta vigente suya.
- `422`: La organización no tiene una Funding Account con gateway activo, tiene más de una y la petición no indica `id_funding_account`, le faltan datos que el gateway exige, o el gateway rechazó la consulta.
- `502`: El gateway respondió con un error o con un saldo que no se pudo interpretar.
- `503`: No se pudo establecer comunicación con el gateway.

## Changes

- **2026-11-03** `a6ef070075b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/trytoku/apis/toku-api/changes/payouts-configuration/funding-account/balance/get.md)

---

[API](https://skmtc.dev/trytoku/apis/toku-api.md) - [All operations](https://skmtc.dev/trytoku/apis/toku-api/llms.txt) - [OpenAPI document](https://skmtc.dev/trytoku/apis/toku-api/revisions/a6ef070075b1?raw)