> ## 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.

# Deletar

> Remova um cliente da sua base

## Visão geral

Este endpoint remove permanentemente um cliente da sua base de dados. O histórico de transações associado ao cliente é mantido para fins fiscais e de auditoria, mas o cliente deixa de aparecer nas listagens.

## Endpoint

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

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

  console.log(response.status);
  ```

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

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

  response = requests.delete(url, headers=headers)
  print(response.status_code)
  ```
</CodeGroup>

## Parâmetros de path

<ParamField path="customer_id" type="string" required>
  Identificador único do cliente a ser removido.
</ParamField>

## Resposta

Em caso de sucesso, a API retorna o status `204 No Content`, sem corpo de resposta.

<Warning>
  Esta ação é irreversível. Clientes com assinaturas ativas devem ter as assinaturas canceladas antes da exclusão.
</Warning>

## Erros comuns

| Código HTTP | Significado                                  |
| ----------- | -------------------------------------------- |
| 401         | Token de autenticação inválido ou ausente    |
| 404         | Cliente não encontrado                       |
| 409         | Cliente possui assinaturas ativas vinculadas |

## Próximos passos

<CardGroup cols={2}>
  <Card title="Listar clientes" icon="user-round-search" href="/listar">
    Consulte todos os clientes cadastrados.
  </Card>

  <Card title="Editar cliente" icon="user-pen" href="/editar-1">
    Atualize os dados de um cliente sem excluí-lo.
  </Card>
</CardGroup>