---
title: "Retornar as pesquisas ativas para o usuário"
method: GET
path: "/pesquisas"
tags: ["Pesquisas"]
---

# Retornar as pesquisas ativas para o usuário

`GET /pesquisas`

## Request

- Base URL: `https://integracao.cvcrm.com.br/api/v1/cliente`
- URL: `https://integracao.cvcrm.com.br/api/v1/cliente/pesquisas`
- Auth: HTTP bearer

> 🔒 **Autenticação necessária**
>
> Esta API utiliza **Bearer Token** no header Authorization, gerado pelo endpoint de autenticação do próprio Portal do Cliente: `POST /api/v1/cliente/autenticacao` (documento e senha do cliente) ou `POST /api/v1/cliente/autenticacao/sindico` (síndicos).
> ⚠️ O token de integração das APIs v2/v3 (`POST /api/v3/auth/token`) **não é válido** para o Portal do Cliente: ele não representa um cliente e as consultas retornarão vazias ou dados incorretos.

## Query parameters

- `offset` integer
- `limit` integer

## Response `200`

Listagem das pesquisas

- Pesquisas
  - `total` integer
  - `offset` integer
  - `limit` integer
  - `pesquisas` Pesquisa[]
    - `idpesquisa_pessoa` integer
    - `pesquisa` string
    - `descricao` string
    - `data_inicio` string
    - `data_fim` string
    - `visualizado` boolean
    - `resposta` RespostaStatus
      - `respondido` boolean
      - `data` string
    - `responder_url` string

## Other responses

- `204`: Sem conteúdo: o cliente autenticado não possui pesquisas para exibição no painel. São retornadas apenas pesquisas ativas, com a opção "Exibir no painel do cliente" habilitada, com data de início já alcançada e vinculadas ao cliente (diretamente, via reserva ou via atendimento) em fila ativa. Se este retorno for inesperado, confirme se o token utilizado é do Portal do Cliente e se o cliente possui pesquisa disponível no CRM.
- `404`: Nenhum dado encontrado!
- `422`: Erro interno ao realizar ação!

---

[API](https://skmtc.dev/cvcrm/apis/portal-do-cliente.md) - [All operations](https://skmtc.dev/cvcrm/apis/portal-do-cliente/llms.txt) - [OpenAPI document](https://skmtc.dev/cvcrm/apis/portal-do-cliente/revisions/7d95f9678127?raw)