---
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`

## Request

- Base URL: `https://sandbox.openfinance.celcoin.dev`
- URL: `https://sandbox.openfinance.celcoin.dev/baas/v1/open/dat/accounts/{accountId}/balances`
- Auth: HTTP bearer

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.dev/celcoin/apis/api-para-transa-es.md) - [All operations](https://skmtc.dev/celcoin/apis/api-para-transa-es/llms.txt) - [OpenAPI document](https://skmtc.dev/celcoin/apis/api-para-transa-es/revisions/85dd6188a37b?raw)