# Transactions

Uma **transação** contém as informações detalhadas de cada movimento dentro de uma conta. Por exemplo, uma compra em uma loja ou em um restaurante.

## Listar transações

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

Com o método List Transactions, você pode:

1. [Obrigatório] Listar transações relacionadas a um link.id específico (usando o parâmetro de consulta link).
2. Filtrar as transações retornadas usando parâmetros de consulta (veja a seção Filtrando respostas abaixo).
3. Obter os detalhes de um transaction.id específico (usando o parâmetro de consulta id junto com o parâmetro de consulta link).

## 📖 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 transações para um link

 - [POST /api/transactions/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/transactions/retrievetransactions.md): Recupere transações de uma ou mais contas a partir de um link específico.

> 📘 Períodos de Transação e Recuperação
>
> Ao recuperar transações, é importante entender que os intervalos de dados de transações disponíveis dependem de cada instituição. Se você tentar acessar informações mais antigas do que podemos acessar, retornaremos todos os dados que conseguimos ler dentro desse intervalo de datas. Por exemplo, se você solicitar transações do último ano e só pudermos acessar os últimos seis meses, retornaremos as informações correspondentes a esses seis meses de dados.

## Concluir uma solicitação de transações

 - [PATCH /api/transactions/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/transactions/patchtransactions.md): Usado para retomar uma sessão de recuperação de Transação que foi pausada porque um token MFA foi exigido pela instituição.

## Obter os detalhes de uma transação

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

## Excluir uma transação

 - [DELETE /api/transactions/{id}/](https://developers.belvo.com/pt-br/apis/belvoopenapispec/transactions/destroytransaction.md): Excluir uma transação específica da sua conta Belvo.

> ❗️ Limite de taxa
>
> Este endpoint possui limite de taxa. Você pode excluir apenas 5 itens por minuto. Se exceder esse limite, você receberá um código de status 429.