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

# Consultar Conta Bancária

> Consulta os detalhes de uma conta bancária específica

## Visão Geral

Este endpoint retorna os detalhes completos de uma conta bancária ou chave PIX específica cadastrada.

## Endpoint

```
GET https://api.klivopay.com.br/api/public/v1/bank-accounts/{bankAccountHash}
```

## Parâmetros

<ParamField path="bankAccountHash" type="string" required>
  Hash identificador único da conta bancária
</ParamField>

<ParamField query="api_token" type="string" required>
  Seu token de autenticação da API KlivoPay
</ParamField>

## Exemplo de Requisição

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET 'https://api.klivopay.com.br/api/public/v1/bank-accounts/bank123abc?api_token=seu_token_aqui'
  ```

  ```javascript JavaScript theme={null}
  const bankAccountHash = 'bank123abc';
  const response = await fetch(
    `https://api.klivopay.com.br/api/public/v1/bank-accounts/${bankAccountHash}?api_token=seu_token_aqui`
  );
  const data = await response.json();
  console.log(data);
  ```

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

  bank_account_hash = 'bank123abc'
  url = f'https://api.klivopay.com.br/api/public/v1/bank-accounts/{bank_account_hash}'
  params = {'api_token': 'seu_token_aqui'}

  response = requests.get(url, params=params)
  print(response.json())
  ```

  ```php PHP theme={null}
  <?php
  $bankAccountHash = 'bank123abc';
  $url = "https://api.klivopay.com.br/api/public/v1/bank-accounts/{$bankAccountHash}?api_token=seu_token_aqui";
  $response = file_get_contents($url);
  print_r(json_decode($response));
  ?>
  ```
</CodeGroup>

## Resposta de Sucesso - PIX

```json 200 OK theme={null}
{
  "success": true,
  "data": {
    "hash": "bank123abc",
    "type": "pix",
    "pix_key_type": "cpf",
    "pix_key": "123.456.789-00",
    "status": "active",
    "created_at": "2025-01-15T10:00:00Z",
    "updated_at": "2025-01-15T10:00:00Z"
  }
}
```

## Resposta de Sucesso - Conta Bancária

```json 200 OK theme={null}
{
  "success": true,
  "data": {
    "hash": "bank456def",
    "type": "bank",
    "bank_code": "001",
    "bank_name": "Banco do Brasil",
    "account_type": "checking",
    "account_number": "12345-6",
    "agency": "1234",
    "holder_name": "João Silva",
    "holder_document": "123.456.789-00",
    "status": "active",
    "created_at": "2025-01-10T14:30:00Z",
    "updated_at": "2025-01-10T14:30:00Z"
  }
}
```

## Códigos de Resposta

<ResponseField name="200" type="OK">
  Conta bancária encontrada e retornada com sucesso
</ResponseField>

<ResponseField name="401" type="Unauthorized">
  Token de API inválido ou ausente
</ResponseField>

<ResponseField name="404" type="Not Found">
  Conta bancária não encontrada
</ResponseField>

<ResponseField name="500" type="Internal Server Error">
  Erro interno do servidor
</ResponseField>