---
title: "Consulta de dados de uma conta"
method: GET
path: "/accounts/{accountNumber}"
tags: ["Consulta e encerramento"]
---

# Consulta de dados de uma conta

`GET /accounts/{accountNumber}`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/accounts/{accountNumber}`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Realize a consulta dos dados de uma conta específica. Opcionalmente, é possível obter o saldo dessa conta (exceto o saldo bloqueado).</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> 
  <span class="bkly-ref-scope-tag">scope: account.read</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Consulta de dados de uma conta](/docs/consulta-de-dados-de-uma-conta)."
}
[/block]

## Path parameters

- `accountNumber` string, required: Número da conta de pagamento.

## Query parameters

- `includeBalance` boolean
- `code` string: Código do banco da conta consultada. Para conta corrente, este campo é <b>obrigatório</b>.
- `branch` string: Número da agência associada à conta consultada. Para conta corrente, este campo é <b>obrigatório</b>.

## Parameters

- `#/paths/~1legal-agreements~1file/get/parameters/0` (unresolved $ref)
- `#/paths/~1legal-agreements~1file/get/parameters/1` (unresolved $ref)

## Response `200`

Recurso encontrado.

- AccountDetailedResponse
  - `balance` SummarizedBalance: Objeto que contém informações sobre o saldo sumarizado da conta.
    - `inProcess` Balance: Saldo da conta.
      - `amount` number, double: Valor em decimal.
      - `currency` string: Código da moeda com base na ISO 4217. _Default: *BRL*_
    - `available` Balance: Saldo da conta.
      - `amount` number, double: Valor em decimal.
      - `currency` string: Código da moeda com base na ISO 4217. _Default: *BRL*_
    - `blocked` Balance: Saldo da conta.
      - `amount` number, double: Valor em decimal.
      - `currency` string: Código da moeda com base na ISO 4217. _Default: *BRL*_
  - `status` 'ACTIVE' | 'CLOSED': Situação da conta.
  - `branch` string: Agência bancária. _Default: **0001**._
  - `number` Schema (unresolved $ref)
  - `type` 'payment': Tipo de conta.
  - `bank` Bank
    - `ispb` string: ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco.
    - `code` string: Código do banco.
    - `name` string: Nome do banco.
  - `programId` string: Identificador do programa de contas que determina o tipo de conta.

## Other responses

- `400`: Há algum problema com a sua requisição.
- `403` (unresolved $ref)
- `409`: A solicitação conflitou com o estado atual do recurso existente no servidor.
- `422`: A sintaxe da requisição está correta, mas não foi possível processá-la devido a uma regra de negócio.
- `500` (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)