> For the complete documentation index, see [llms.txt](https://docs.cashtrack.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cashtrack.com.br/cashtrack-api-v.1.0.2/requisicoes/9.-consulta-gastos.md).

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