---
title: "Consulta de contas"
method: GET
path: "/business/{documentNumber}/accounts"
tags: ["Conta pessoa jurídica"]
---

# Consulta de contas

`GET /business/{documentNumber}/accounts`

## Request

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

<div class="bkly-ref-description">
  <p>Realize a consulta de todas as contas que determinado cliente do tipo <b>pessoa jurídica</b> possui.</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 contas](/docs/consulta-contas-cliente-pessoa-juridica)."
}
[/block]

## Path parameters

- `documentNumber` string, required: Número do documento CNPJ da empresa.

## Parameters

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

## Response `200`

Recurso encontrado.

- AccountBasicResponse[]
  - `status` 'ACTIVE' | 'CLOSED': Situação da conta.
  - `branch` string: Número da agência bancária.
  - `number` string: Número da conta de pagamento.
  - `type` 'checking' | '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` (unresolved $ref)
- `403` (unresolved $ref)
- `409` (unresolved $ref)
- `422` (unresolved $ref)
- `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)