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

# Consulta dos dados de uma conta pocket

`GET /pockets/{pocketNumber}`

## Request

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

<div class="bkly-ref-description">
  <p>Consulte os dados de uma conta pocket específica.</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 dos dados de uma conta pocket](/docs/consulta-dados-uma-pocket)."
}
[/block]

## Path parameters

- `pocketNumber` string, nullable, required

## Query parameters

- `resultLevel` string, nullable

## Headers

- `api-version` string, required

## Parameters

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

## Response `200`

Recurso encontrado.

- GetPocketNumberResponse
  - `data` QueryFromAPocketResponse
    - `number` string: Número da conta pocket.
    - `label` string: Nome descritivo da conta pocket.
    - `suffix` string: Sufixo atribuído ao número da pocket. Exemplo: BRL.
    - `currency` string: Sigla da moeda corrente da pocket.
    - `type` string: Tipo da conta com a sigla da moeda. Exemplo: POCKET_BRL.
    - `status` string: Situação da conta pocket.
    - `reason` string: Motivo da situação da conta pocket. Nesse caso, sempre será HOLDER_REQUEST.
    - `category` string: Categoria da conta.
    - `useCase` string: Motivo de uso da conta pocket, que pode ser: “ACCOUNT_FOR_UNDER_AGE” (Conta para menor de idade), “CORPORATE_EXPENSES” (Despesas corporativas), “FLEXIBLE_BENEFITS” (Benefícios flexíveis) e “BALANCE_SEGREGATION” (Segregação de saldo).
    - `createdAt` string: Data de criação da conta pocket, no formato yyyy-MM-dd'T'HH:mm:ss.SSS.
    - `updatedAt` string: Data de atualização da conta pocket, no formato yyyy-MM-dd'T'HH:mm:ss.SSS.
    - `user` User
      - `name` string, required: Nome do usuário da conta pocket.
      - `document` Document, required
        - `value` string, nullable: Número do documento do usuário.
        - `type` 'CPF' | 'CNPJ': Tipo do documento do titular da conta.
      - `birthDate` string, date-time, required: Data de nascimento do usuário da conta pocket.
    - `account` object: Esse objeto é retornado apenas em consultas detalhadas (<code>resultLevel</code> = DETAILED).
      - `branch` string: Número da agência bancária.
      - `number` string: Número da conta de pagamento.
      - `status` string: Situação da conta de pagamento (ACTIVE ou CLOSED).
      - `bank` Bank
        - `ispb` string: ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco.
        - `code` string: Código do banco.
        - `name` string: Nome do banco.
      - `holder` HolderCompleteResponse
        - `document` Document
          - `value` string, nullable: Número do documento do usuário.
          - `type` 'CPF' | 'CNPJ': Tipo do documento do titular da conta.
        - `type` string: Tipo do cadastro do titular da conta de pagamento (“CUSTOMER” ou “BUSINESS”).
        - `name` string: Nome do titular da conta de pagamento.
        - `status` string: Situação do cadastro do titular.
        - `createdAt` string: Data de criação do cadastro do titular no formato yyyy-MM-dd'T'HH:mm:ss.SSS.
  - `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`: Acesso não autorizado.
- `403`: O acesso ao recurso foi negado pelo servidor.
- `404` (unresolved $ref)
- `500` (unresolved $ref)
- `503`: O serviço está temporariamente indisponível.

---

[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)