---
title: "Consulta do saldo de uma conta pocket"
method: GET
path: "/pockets/{pocketNumber}/balances"
tags: ["Conta pocket"]
---

# Consulta do saldo de uma conta pocket

`GET /pockets/{pocketNumber}/balances`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/pockets/{pocketNumber}/balances`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Consulte o saldo disponível, bloqueado, em processamento e o total de uma conta pocket.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">pocket.read</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Consulta do saldo de uma conta pocket](/docs/consulta-saldo-pocket)."
}
[/block]

## Path parameters

- `pocketNumber` string, nullable, required

## Parameters

- `#/paths/~1pockets~1{pocketNumber}/get/parameters/2` (unresolved $ref)
- `#/paths/~1legal-agreements~1file/get/parameters/1` (unresolved $ref)

## Response `200`

Recurso encontrado.

- GetPocketBalanceResponse
  - `data` BalanceMap
    - `total` IAmount
      - `value` number, double: Valor da moeda.
      - `currency` string: Sigla da moeda utilizada, de acordo com a ISO 4217.
    - `available` IAmount
      - `value` number, double: Valor da moeda.
      - `currency` string: Sigla da moeda utilizada, de acordo com a ISO 4217.
    - `hold` IAmount
      - `value` number, double: Valor da moeda.
      - `currency` string: Sigla da moeda utilizada, de acordo com a ISO 4217.
  - `links` Link[], nullable
    - `url` string, nullable: URLs que podem ser utilizadas em um próximo estado da entidade. Nesse caso, trata-se da própria requisição realizada.
    - `rel` string, nullable: Descrição de como a URL se relaciona com o recurso atual.
    - `method` string, nullable: Tipo de verbo que deve ser utilizado para acessar a URL. Nesse caso, é o GET.
  - `metadata` object, nullable

## Other responses

- `401` (unresolved $ref)
- `403` (unresolved $ref)
- `404` (unresolved $ref)
- `500` (unresolved $ref)
- `503` (unresolved $ref)

---

[API](https://skmtc.dev/bankly/apis/gest-o-de-contas.md) - [All operations](https://skmtc.dev/bankly/apis/gest-o-de-contas/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/gest-o-de-contas/revisions/39000596dbd3?raw)