---
title: 4.1. Contas Correntes
url: https://docs.vehub.com.br/API/Cadastro%20de%20Cedente/4.%20Dados%20Banc%C3%A1rios%20e%20Contatos/4.1.%20Contas%20Correntes/
---
Gerenciamento das contas correntes vinculadas ao cedente.

---

## Listar Contas Correntes

| Método | URL |
|--------|-----|
| ![GET](https://img.shields.io/badge/GET-blue) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/contas` |

Lista as contas correntes **ativas** do cedente — útil para obter o `idConta` usado no [vínculo com operações](../7.%20V%C3%ADnculo%20com%20Opera%C3%A7%C3%B5es/7.1.%20Vincular%20Cedente%20a%20Opera%C3%A7%C3%B5es.md).

```` json title="Response Body"
[
  {
    "idConta": 10,
    "codigoBanco": "341",
    "nomeBanco": "Itau Unibanco",
    "agencia": "1234",
    "conta": "56789",
    "tipoConta": 1,
    "descricao": "Conta principal",
    "principal": true
  }
]
````

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `idConta` | Número | Identificador da conta corrente. |
| `codigoBanco` | Texto | Código COMPE do banco. |
| `nomeBanco` | Texto | Nome do banco. |
| `agencia` | Texto | Número da agência. |
| `conta` | Texto | Número da conta. |
| `tipoConta` | Número | Tipo da conta. Ver [Tipo de Conta](../1.%20In%C3%ADcio/1.3.%20Dicion%C3%A1rio%20de%20Dados.md#tipo-de-conta). |
| `descricao` | Texto | Apelido/descrição da conta. |
| `principal` | Booleano | Indica se é a conta principal. |

---

## Adicionar Conta Corrente

| Método | URL |
|--------|-----|
| ![POST](https://img.shields.io/badge/POST-green) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/contas` |

```` json title="Request Body"
{
  "codigoBanco": "341",
  "agencia": "1234",
  "conta": "56789",
  "digito": "0",
  "tipoConta": 1,
  "descricao": "Conta principal"
}
````

```` json title="Response Body"
{
  "idConta": 10,
  "idEmpresa": 123,
  "status": "Conta corrente adicionada com sucesso."
}
````

---

## Atualizar Conta Corrente

| Método | URL |
|--------|-----|
| ![PUT](https://img.shields.io/badge/PUT-orange) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/contas/{idConta}` |

Somente os campos enviados serão atualizados.

```` json title="Request Body"
{
  "agencia": "5678",
  "descricao": "Conta atualizada"
}
````

```` json title="Response Body"
{
  "idConta": 10,
  "status": "Conta corrente atualizada com sucesso."
}
````

---

## Remover Conta Corrente

| Método | URL |
|--------|-----|
| ![DELETE](https://img.shields.io/badge/DELETE-red) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/contas/{idConta}` |

```` json title="Response Body"
{
  "status": "Conta corrente removida com sucesso."
}
````

---

# Modelo de Dados

## Requisição — Conta Corrente

| Campo | Tipo | Obrigatório | Descrição |
|-------|------|:-----------:|----------|
| `codigoBanco` | Texto (10) | ✅ | Código do banco (COMPE ou ISPB) |
| `agencia` | Texto (10) | ✅ | Número da agência (sem dígito) |
| `conta` | Texto (20) | ✅ | Número da conta (sem dígito) |
| `digito` | Texto (2) | ✅ | Dígito verificador da conta |
| `tipoConta` | Número | Opcional | Tipo da conta. Ver [Tipo de Conta](../1.%20In%C3%ADcio/1.3.%20Dicion%C3%A1rio%20de%20Dados.md#tipo-de-conta). Default: `1` |
| `descricao` | Texto (200) | Opcional | Descrição/apelido da conta |

## Retorno

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `idConta` | Número | ID da conta corrente |
| `idEmpresa` | Número | ID da empresa cedente |
| `status` | Texto | Mensagem de status da operação |