---
title: "Obtém os saldos da conta identificada por accountId"
method: GET
path: "/baas/v1/open/dat/accounts/{accountId}/balances"
tags: ["Accounts | Dados"]
---

# Obtém os saldos da conta identificada por accountId

`GET /baas/v1/open/dat/accounts/{accountId}/balances`

Método para obter os saldos da conta de depósito à vista, poupança ou pagamento pré-paga identificada por 
accountId mantida pelo cliente na instituição transmissora.

PERMISSÃO NECESSÁRIA: `ACCOUNTS_BALANCES_READ`

## Path parameters

- `accountId` string, required

## Response `200`

Dados relativos aos saldos da conta obtidos com sucesso

- object
  - `data` object, required — Conjunto de informações das Contas de depósito à vista, poupança e de pagamento pré-paga
    - `availableAmount` object, required — Saldo disponível para utilização imediata
      - `amount` string, required — Valor do saldo disponível
      - `currency` string, required — Moeda referente ao valor monetário (ISO-4217)
    - `blockedAmount` object, required — Saldo bloqueado, não disponível para utilização imediata
      - `amount` string, required — Valor do saldo bloqueado
      - `currency` string, required — Moeda referente ao valor monetário (ISO-4217)
    - `automaticallyInvestedAmount` object, required — Saldo disponível com aplicação automática
      - `amount` string, required — Valor do saldo em aplicação automática
      - `currency` string, required — Moeda referente ao valor monetário (ISO-4217)
    - `updateDateTime` string, date-time, required — Data e hora da última atualização do saldo
  - `links` Links, required — Referências para outros recursos da API requisitada
    - `self` string, uri, required — URI completo que gerou a resposta atual
    - `first` string, uri — URI da primeira página que originou essa lista de resultados
    - `prev` string, uri — URI da página anterior dessa lista de resultados
    - `next` string, uri — URI da próxima página dessa lista de resultados
    - `last` string, uri — URI da última página dessa lista de resultados
  - `meta` Meta, required — Meta informações referente à API requisitada
    - `totalRecords` integer, required — Número total de registros no resultado
    - `totalPages` integer, required — Número total de páginas no resultado
    - `requestDateTime` string, date-time, required — Data e hora da consulta, conforme especificação RFC-3339, formato UTC

## Other responses

- `400` — Requisição malformada
- `401` — Token inválido ou não autorizado
- `403` — Token tem escopo incorreto ou política de segurança violada
- `404` — Conta não encontrada
- `429` — Muitas solicitações foram feitas dentro de um determinado período

---

[API](https://skmtc.net/celcoin/apis/api-para-transa-es.md) · [All operations](https://skmtc.net/celcoin/apis/api-para-transa-es/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/celcoin/api-para-transa-es/revisions/85dd6188a37b/schema)