> 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/1.-consulta-cadastro-de-clientes.md).

# 1. Consulta Cadastro de Clientes

**Endpoint**

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

```

**Headers**

```

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

```

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

```json
json
{
  "id": null,
  "apelido": "",
  "empresa": ""
}

```

* `id` (opcional): ID do cliente.
* `apelido`: filtro em modo *like* pelo apelido do cliente.
* `empresa`: Filtro no modo *like* pelo apelido da empresa relacionada ou pelo ID da empresa caso o valor seja apenas números, afetando apenas o retorno das empresas da consulta principal.

**Exemplo de Resposta**

```json
json
{
  "current_page": 1,
  "data": [
    {
          "id": 4745,
          "apelido": "AMAZON VILLAGE",
          "razao_social": "CONDOMINIO RESIDENCIAL AMAZON VILLAGE",
          "tipo_doc": "2",
          "nome_contato": "AMAZON VILLAGE",
          "telefone": "9291391307",
          "email": "AMAZONVILLAGE.ADM@GMAIL.COM",
          "segmento": null,
          "cep": "69041-010",
          "rua": "Avenida do Turismo",
          "bairro": "Tarumã",
          "cidade": "Manaus",
          "estado": "AM",
          "numero": null,
          "documento": "11041713000110",
          "empresas": [
              {
                  "empresa_id": 926
              },
              {
                  "empresa_id": 949
              }
          ]
      }
    
    // ...demais registros
  ],
  "first_page_url": "https://cashtrack.com.br/api/cliente/show/cadastros?page=1",
  "from": 1,
  "last_page": 1,
  "last_page_url": "https://cashtrack.com.br/api/cliente/show/cadastros?page=1",
  "links": [...],
  "next_page_url": null,
  "path": "https://cashtrack.com.br/api/cliente/show/cadastros",
  "per_page": 25,
  "prev_page_url": null,
  "to": 9,
  "total": 9
}

```