---
title: "Consulta de uma transação"
method: GET
path: "/pockets/{pocketNumber}/transactions/{authenticationCode}"
tags: ["Conta pocket"]
---

# Consulta de uma transação

`GET /pockets/{pocketNumber}/transactions/{authenticationCode}`

## Request

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

<div class="bkly-ref-description">
  <p>Realize consulta de uma transação específica, de depósito ou resgate, ocorrida entre a conta de pagamento e a pocket.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span>  
  <span class="bkly-ref-scope-tag">pocket.transaction.read</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Consulta de uma transação](/docs/consulta-uma-transacao)."
}
[/block]

## Path parameters

- `pocketNumber` string, nullable, required
- `authenticationCode` 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.

- GetPocketTransactionResponse
  - `data` QueryFromAPocketTransactionResponse
    - `authenticationCode` string: Identificador da transação.
    - `amount` IAmount
      - `value` number, double: Valor da moeda.
      - `currency` string: Sigla da moeda utilizada, de acordo com a ISO 4217.
    - `pocket` object
      - `number` string: Número da conta pocket.
      - `status` 'ACTIVE' | 'DORMANT' | 'LOCKED' | 'CLOSED', nullable: Situação da conta Pocket.
      - `balances` BalanceTotal: Saldo da conta.
        - `total` object
          - `value` number: Valor total do saldo.
          - `currency` string: Sigla da moeda do saldo, de acordo com a ISO 4217.
      - `account` PaymentAccount
        - `branch` string: Número da agência.
        - `number` string: Número da conta.
        - `status` 'ACTIVE' | 'CLOSED': Situação da 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.
        - `balances` BalanceTotal: Saldo da conta.
          - `total` object
            - `value` number: Valor total do saldo.
            - `currency` string: Sigla da moeda do saldo, de acordo com a ISO 4217.
        - `holder` HolderResponseDepRed
          - `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.
    - `type` string: Tipo de transação realizada (DEPOSIT ou REDEEM).
    - `status` string: Situação da transação, que pode ser: “CREATED” (criada), “IN_PROCESS” (em processamento), “DONE” (concluída), “UNDONE” (desfeita) e “ERROR” (erro).
    - `createdAt` string: Data de criação da transação, no formato yyyy-MM-dd'T'HH:mm:ss.SSS.
    - `updatedAt` string: Data de atualização da transação, 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

- `400` (unresolved $ref)
- `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)