> ## Documentation Index
> Fetch the complete documentation index at: https://scaleup-c34c4386.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/v1/organizations/:id/bank-account

> Retorna a conta bancária ativa da organização, sincronizando com o gateway de pagamentos se necessário

Retorna a conta bancária ativa da organização. Implementa estratégia "sync on load": primeiro busca no banco de dados local; se não encontrada, consulta o gateway diretamente e sincroniza o resultado no banco para consultas futuras.

## Autenticação

Não requer autenticação específica (endpoint público com validação interna).

## Parâmetros de Path

**id** `string` *required*

ID da organização

## Resposta

**id** `string`

ID interno da conta bancária (presente quando encontrada no banco de dados)

**bank\_code** `string`

Código do banco (ex: `341` para Itaú)

**bank\_name** `string`

Nome do banco

**routing\_number** `string`

Número da agência

**account\_number\_last4** `string`

Últimos 4 dígitos da conta

**account\_type** `string`

Tipo da conta: `checking` (corrente) ou `savings` (poupança)

**is\_verified** `boolean`

Se a conta bancária foi verificada

**synced\_from\_zoop** `boolean`

Se os dados foram sincronizados diretamente do gateway nesta requisição (nome do campo conforme contrato da API)

**sync\_failed** `boolean`

Presente com valor `true` se a sincronização com o banco de dados falhou (mas os dados do gateway são retornados)

## Erros

| Código | Descrição |
| - | - |
| `404` | Nenhuma conta bancária encontrada (nem no banco de dados nem no gateway) |

## Exemplo

```bash cURL theme={null}
curl -X GET "https://api.chargefy.io/api/v1/organizations/org_abc123/bank-account"
```

```typescript SDK theme={null}
import { Chargefy } from '@chargefy/sdk';

const chargefy = new Chargefy({
  accessToken: process.env.CHARGEFY_ACCESS_TOKEN,
});

const bankAccount = await chargefy.organizations.getBankAccount('org_abc123');
```

## Resposta de Exemplo (encontrada no banco de dados)

```json theme={null}
{
  "id": "sba_abc123",
  "bank_code": "341",
  "bank_name": "Itaú Unibanco",
  "routing_number": "1234",
  "account_number_last4": "5678",
  "account_type": "checking",
  "is_verified": true,
  "synced_from_zoop": false
}
```

## Resposta de Exemplo (sincronizada do gateway)

```json theme={null}
{
  "id": "sba_xyz789",
  "bank_code": "033",
  "bank_name": "Santander",
  "routing_number": "0001",
  "account_number_last4": "9012",
  "account_type": "checking",
  "is_verified": false,
  "synced_from_zoop": true
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.