# Tax retentions

## Listar retenções de impostos

 - [GET /api/tax-retentions/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/tax-retentions/listtaxretentions.md): ## ▶️ Uso

Com o método List Tax Retentions, você pode:

1. Listar retenções de impostos relacionadas a um link.id específico (usando o parâmetro de consulta link).
2. Obter os detalhes de um tax-retention.id específico (usando o parâmetro de consulta id).
3. [Não Recomendado] Listar todas as retenções de impostos relacionadas à sua conta Belvo (sem usar nenhum parâmetro de consulta).

## 📖 Paginação

Este método retorna uma resposta paginada (padrão: 100 itens por página). Você pode usar o parâmetro de consulta page_size para aumentar o número de itens retornados até um máximo de 1000 itens. Você pode usar o parâmetro de consulta page para navegar pelos resultados. Para mais detalhes sobre como navegar pelas respostas paginadas da Belvo, consulte nosso artigo Dicas de Paginação.

## 🔦 Filtrando Respostas

Consulte a lista de consultas abaixo para ver uma lista de campos pelos quais você pode filtrar suas respostas. Para mais informações sobre como usar filtros, consulte nosso artigo Filtrando respostas.

## Recuperar retenções de impostos para um link

 - [POST /api/tax-retentions/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/tax-retentions/retrievetaxretentions.md): Recupere informações de retenção de impostos de um link específico. O número máximo de retenções de impostos que pode ser retornado para um período é 500.

## Obter os detalhes de uma retenção de imposto

 - [GET /api/tax-retentions/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/tax-retentions/detailtaxretentions.md): Obtenha os detalhes de uma retenção de imposto específica.

## Excluir uma retenção de imposto

 - [DELETE /api/tax-retentions/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/tax-retentions/destroytaxretention.md): Exclua uma retenção de imposto específica da sua conta Belvo.