# Extrato da conta

Consulte o histórico de movimentações da conta.

GET`/account/transactions`

Try it

## Parâmetros de consulta

[page](#request-page)integer

Número da página. Padrão 1.

[pageSize](#request-pageSize)integer

Quantidade de itens. Padrão 50, máximo 100.

[search](#request-search)string

Pesquisa pelo ID ou descrição.

[type](#request-type)string

entrada, saida ou all.

[status](#request-status)string

Situação exibida no extrato, como Aprovado ou Pendente.

[dateFrom](#request-dateFrom)string

Início do período em formato ISO.

[dateTo](#request-dateTo)string

Fim do período em formato ISO.

## Autorização

[X-API-Key](#auth-X-API-Key)stringrequired

Chave VibeCash com permissão para esta operação.

## Resposta

200 application/json

[success](#response-success)booleanrequired

Indica se a operação foi concluída pela API.

[message](#response-message)stringrequired

Mensagem da operação.

[data](#response-data)objectrequired

Dados retornados pela operação.

Show child attributes[items](#response-data-items)array

Itens da consulta.

[total](#response-data-total)integer

Quantidade de itens, quando a rota oferece paginação.

[page](#response-data-page)integer

Página atual.

[pageSize](#response-data-pageSize)integer

Itens por página.

[requestId](#response-requestId)string

Identificador da requisição.

## Erros

As falhas retornam o envelope com `success: false`. Consulte [erros e códigos HTTP](/docs/api-reference/guides/errors) para interpretar validação, permissão, conflito e saldo insuficiente.

## Exemplo de requisição

```bash
curl --request GET \
  --url 'https://seu-dominio/v1/account/transactions' \
  --header 'X-API-Key: tp_live_SUA_CHAVE'
```

## Exemplo de resposta

```json
{
  "success": true,
  "message": "Operação concluída",
  "data": {
    "items": [],
    "page": 1,
    "pageSize": 50,
    "pages": 1,
    "total": 0,
    "summary": {
      "count": 0,
      "approvedCount": 0,
      "entriesNet": 0,
      "exitsNet": 0,
      "fees": 0,
      "net": 0
    }
  },
  "requestId": "req_exemplo"
}
```
