# 9. Consulta Gastos

**Endpoint**

```


POST https://cashtrack.com.br/api/cliente/show/gastos?page=1

```

**Headers**

```


Accept: application/json
Content-Type: application/json
Authorization: Bearer {{SEU_TOKEN}}

```

**Corpo da Requisição (Request Body)**

```json
json

{
  "id": "",
  "data_inicial": "",
  "data_final": "",
  "empresa": "",
  "fornecedor": "",
  "valor": "",
  "situacao": "",
  "forma_pagamento": "",
  "banco":""
}

```

* `id` (opcional): ID do gasto.
* `data_inicial` e `data_final`: filtros para a data de lançamento da despesa (formato **dd/mm/aaaa**) valor da coluna "datalançamento" da tabela "gastos".
* `empresa`: filtro pelo apelido da empresa (modo *like*) ou filtro pelo ID da empresa quando o campo conter apenas números.
* `fornecedor`: filtro pelo apelido do fornecedor (modo *like*) ou filtro pelo ID do fornecedor quando o campo conter apenas números.
* `valor`: filtra por valor (na base 100) filtro da coluna "valor" da tabela "gastos".
* `situacao`: Indica a situação do gasto podendo ser filtrado pelo ID (1,2,3 ou 4) ou pelas situações, sendo elas:
  * pago
  * recebido
  * a\_receber
  * a\_pagar
* `forma_pagamento`: Indica a forma de pagamento podendo ser filtrado pelo ID (1,2,3,4,5,6 ou 7) ou pelas formas de pagamento, sendo elas:
  * pix
  * boleto
  * cartao
  * dinheiro
  * transferencia
  * cheque
  * debito\_automatico

`banco` : filtro pelo ID do banco quando o campo conter apenas números ou filtro em modo *like* pelo nome/apelido do banco, caso apelido seja null o filtro será aplicado pelo nome do banco.

**Exemplo de Resposta**

<pre class="language-json"><code class="lang-json">json

{
  "current_page": 1,
  "data": [

<strong>     {
</strong>            "id": 85934,
            "empresa_id": 949,
            "data_lancamento": "23/01/2025",
            "situacao": 1,
            "valor": "138.22",
            "forma_pagamento": 2,
            "fornecedor_id": 6463,
            "related_id": null,
            "categoria_id": 84222,
            "banco_id": 1488,
            "parcelamento": 3,
            "numero_parcelas": null,
            "detalhes": null,
            "centro_id": 98,
            "numero_parcelas_recorrencia": 2,
            "tipo_gasto": 1
        },

    // ...demais registros
  ],
  "first_page_url": "https://cashtrack.com.br/api/cliente/show/gastos?page=1",
  "from": 1,
  "last_page": 1,
  "last_page_url": "https://cashtrack.com.br/api/cliente/show/gastos?page=1",
  "links": [...],
  "next_page_url": null,
  "path": "https://cashtrack.com.br/api/cliente/show/gastos",
  "per_page": 25,
  "prev_page_url": null,
  "to": 15,
  "total": 15
}

</code></pre>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.cashtrack.com.br/cashtrack-api-v.1.0.2/requisicoes/9.-consulta-gastos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.