---
title: "Consulta por conta"
method: GET
path: "/fund-transfers"
tags: ["Operações via TED"]
---

# Consulta por conta

`GET /fund-transfers`

## Request

- Base URL: `https://api-mtls.sandbox.bankly.com.br`
- URL: `https://api-mtls.sandbox.bankly.com.br/fund-transfers`
- Auth: HTTP bearer

<div class="bkly-ref-description">
  <p>Consulte todas as TEDs realizadas a partir da conta informada.</p> 
  <span class="bkly-ref-small-stable-tag">stable</span> <span class="bkly-ref-scope-tag">scope: ted.cashout.read</span>
</div>
[block:callout]
{
  "type": "info",
  "title": "Nota",
  "body": "Para mais informações, confira a documentação [Consulta por conta](/docs/ted-consulta-conta)."
}
[/block]

## Query parameters

- `branch` string, required: Agência bancária. _Default: **0001**._
- `account` string, required: Número da conta de pagamento.
- `pageSize` integer
- `nextPage` integer

## Headers

- `api-version` string, required
- `x-correlation-id` string, required: Informe um GUID v4. A cada requisição, deve-se gerar um novo GUID.
- `Authorization` string, required: <i>Token</i> de autorização do tipo Bearer.

## Response `200`

Recurso encontrado.

- object
  - `nextPage` string: Se o campo <code>pageSize</code> tiver sido enviado na requisição e se ainda houver dados não apresentados na primeira página retornada, o campo <code>nextPage</code> será retornado com um <i>token</i> que deverá ser utilizado na próxima consulta para visualizar as demais páginas.
  - `data` object[]
    - `companyKey` string: Chave que identifica o parceiro dentro do Bankly.
    - `authenticationCode` string: Código identificador da transação.
    - `amount` number, double: Valor transferido.
    - `description` string: Descrição da transferência.
    - `correlationId` string: GUID informado em cada requisição realizada no <i>endpoint</i>.
    - `sender` HolderComplete
      - `document` string: Número do documento.
      - `name` string: Nome do pagador/recebedor.
      - `account` Account
        - `branch` string: Agência bancária.
        - `number` string: Número da conta.
        - `bank` Bank
          - `ispb` string: ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco.
          - `name` string: Nome do banco.
          - `compe` string: Código do banco.
    - `recipient` HolderComplete
      - `document` string: Número do documento.
      - `name` string: Nome do pagador/recebedor.
      - `account` Account
        - `branch` string: Agência bancária.
        - `number` string: Número da conta.
        - `bank` Bank
          - `ispb` string: ISPB (Identificador de Sistema de Pagamentos Brasileiro) do banco.
          - `name` string: Nome do banco.
          - `compe` string: Código do banco.
    - `channel` string: Indica se a transação é interna (INTERNAL) ou externa (EXTERNAL).
    - `status` 'CREATED' | 'IN PROCESS' | 'APPROVED' | 'REPROVED' | 'DONE' | 'UNDONE' | 'CANCELED'
    - `createdAt` string, date-time: Data de criação da transferência.
    - `updatedAt` string, date-time: Data de de atualização dos dados da transferência.

## Other responses

- `400`: Há algum problema com a sua requisição.
- `403`: O acesso ao recurso foi negado pelo servidor.
- `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`: Ocorreu algum erro inexperado em nosso servidor.

---

[API](https://skmtc.dev/bankly/apis/ted.md) - [All operations](https://skmtc.dev/bankly/apis/ted/llms.txt) - [OpenAPI document](https://skmtc.dev/bankly/apis/ted/revisions/8cb3300a780b?raw)