> ## Documentation Index
> Fetch the complete documentation index at: https://docs.avanttifinance.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Ver Transferência

> Consulte os detalhes de uma transferência Pix Out específica

## Visão geral

Este endpoint retorna os detalhes completos de uma transferência (Pix Out) realizada a partir da sua conta, incluindo status, valor, dados do destinatário e comprovante.

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl --request GET \
    --url https://api.avanttifinance.com/v1/transfers/{transfer_id} \
    --header "Authorization: Bearer SEU_TOKEN_DE_ACESSO"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    "https://api.avanttifinance.com/v1/transfers/" + transferId,
    {
      method: "GET",
      headers: {
        Authorization: \`Bearer \${accessToken}\`,
      },
    }
  );

  const transfer = await response.json();
  console.log(transfer);
  ```

  ```python Python theme={null}
  import requests

  url = f"https://api.avanttifinance.com/v1/transfers/{transfer_id}"
  headers = {"Authorization": f"Bearer {access_token}"}

  response = requests.get(url, headers=headers)
  print(response.json())
  ```
</CodeGroup>

## Parâmetros de path

<ParamField path="transfer_id" type="string" required>
  Identificador único da transferência, retornado no momento da criação do Pix Out.
</ParamField>

## Resposta

<ResponseField name="id" type="string">
  Identificador único da transferência.
</ResponseField>

<ResponseField name="status" type="string">
  Situação atual da transferência. Valores possíveis: `pending`, `processing`, `completed`, `failed`.
</ResponseField>

<ResponseField name="amount" type="integer">
  Valor transferido, em centavos.
</ResponseField>

<ResponseField name="pix_key" type="string">
  Chave Pix do destinatário utilizada na transferência.
</ResponseField>

<ResponseField name="recipient" type="object">
  Dados do destinatário (nome e instituição financeira).
</ResponseField>

<ResponseField name="end_to_end_id" type="string">
  Identificador End-to-End (E2E) gerado pelo Banco Central, disponível após a conclusão.
</ResponseField>

<ResponseField name="created_at" type="string">
  Data e hora de criação da transferência, no formato ISO 8601.
</ResponseField>

### Exemplo de resposta

```json theme={null}
{
  "id": "trf_4d2f1a9c7b",
  "status": "completed",
  "amount": 50000,
  "pix_key": "12345678900",
  "recipient": {
    "name": "João Pereira",
    "bank": "Banco Exemplo S.A."
  },
  "end_to_end_id": "E12345678202606101430abc123def",
  "created_at": "2026-06-10T14:28:00Z"
}
```

## Status possíveis

| Status       | Descrição                                                         |
| ------------ | ----------------------------------------------------------------- |
| `pending`    | Transferência criada, aguardando processamento                    |
| `processing` | Em processamento junto ao Banco Central                           |
| `completed`  | Transferência concluída com sucesso                               |
| `failed`     | Falha na transferência (saldo insuficiente, chave inválida, etc.) |

<Tip>
  Para acompanhar mudanças de status sem precisar consultar este endpoint repetidamente, configure um [Webhook](/webhook) de Pix Out.
</Tip>

## Erros comuns

| Código HTTP | Significado                                         |
| ----------- | --------------------------------------------------- |
| 401         | Token de autenticação inválido ou ausente           |
| 404         | Transferência não encontrada                        |
| 500         | Erro interno — tente novamente ou contate o suporte |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Listar transferências" icon="list" href="/listar-transferencias">
    Consulte o histórico completo de transferências Pix Out.
  </Card>

  <Card title="Pix Out" icon="send" href="/pages/pix-out/overview">
    Saiba como criar uma nova transferência Pix Out.
  </Card>
</CardGroup>