---
title: "Consulta dos feedbacks dos instrumentos"
method: POST
path: "/feedbacks"
tags: ["Score"]
---

# Consulta dos feedbacks dos instrumentos

`POST /feedbacks`

## Request

- Base URL: `https://www.pulses.com.br/api/engage/v1`
- URL: `https://www.pulses.com.br/api/engage/v1/feedbacks`
- Auth: API key in header `Authorization`

Este endpoint permite a consulta dos feedbacks dos instrumentos. O formato do retorno varia conforme o parâmetro 'format' enviado na requisição.

## Request body

- object
  - `startDate` string, required: start date
  - `endDate` string, required: end date
  - `instrument` string, required: uid instrument
  - `leaders` integer[]: Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o id do atributo.
  - `groups` integer[]: Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o id do atributo.
  - `positions` string[]: Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.
  - `genders` string[]: Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo
  - `sexes` string[]: Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.
  - `unitBusinesses` string[]: Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.
  - `unitGeographies` string[]: Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.
  - `tags` string[]: Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.
  - `scholarities` string[]: Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.
  - `format` 'list' | 'listLeaders' | 'listGroups': Formato do retorno: 'list' ou não informado para retorno padrão, 'listLeaders' para incluir líder associado, 'listGroups' para incluir grupos associados

## Response `200`

Successful response - o formato varia conforme o parâmetro 'format'

- union
  - object[]
    - `Id` number: Id do Feedback
    - `Recebido em` string: data do recebimento (formato: DD/MM/YYYY)
    - `Dimensão` string: nome da dimensão
    - `Pergunta do Fator` string: texto da pergunta
    - `Pergunta do feedback` string: Texto da pergunta de feedback
    - `Nota` string: Nota vinculada à pergunta que gerou feedback
    - `Feedback` string: Texto do feedback recebido
    - `Enviado por` string: Nome de quem enviou o feedback
    - `Lido` string: Visualizado pelo administrador
    - `Resposta` string: Última resposta enviada
    - `Respondido por` string: Nome de quem respondeu
    - `Respondido em` string: Data de resposta (formato: dd/mm/yyy)
  - object[]
    - `Id` number: Id do Feedback
    - `Recebido em` string: data do recebimento (formato: DD/MM/YYYY)
    - `Dimensão` string: nome da dimensão
    - `Pergunta do Fator` string: texto da pergunta
    - `Pergunta do feedback` string: Texto da pergunta de feedback
    - `Nota` string: Nota vinculada à pergunta que gerou feedback
    - `Feedback` string: Texto do feedback recebido
    - `Enviado por` string: Nome de quem enviou o feedback
    - `Lido` string: Visualizado pelo administrador
    - `Resposta` string: Última resposta enviada
    - `Respondido por` string: Nome de quem respondeu
    - `Respondido em` string: Data de resposta (formato: dd/mm/yyy)
    - `Atribuído ao Líder` string: Nome do líder associado àquele comentário. Líderes sem o mínimo de respondentes não serão retornados, exibindo um texto em branco.
  - object[]
    - `Id` number: Id do Feedback
    - `Recebido em` string: data do recebimento (formato: DD/MM/YYYY)
    - `Dimensão` string: nome da dimensão
    - `Pergunta do Fator` string: texto da pergunta
    - `Pergunta do feedback` string: Texto da pergunta de feedback
    - `Nota` string: Nota vinculada à pergunta que gerou feedback
    - `Feedback` string: Texto do feedback recebido
    - `Enviado por` string: Nome de quem enviou o feedback
    - `Lido` string: Visualizado pelo administrador
    - `Resposta` string: Última resposta enviada
    - `Respondido por` string: Nome de quem respondeu
    - `Respondido em` string: Data de resposta (formato: dd/mm/yyy)
    - `Grupo` string: Grupos associados àquele comentário (separados por vírgula). Grupos sem o mínimo de respondentes não serão exibidos na listagem.

## Other responses

- `400`: Erro de validação de parâmetros
- `404`: Filtro sem comentários achados ou sem o mínimo de respondentes

---

[API](https://skmtc.dev/gupy/apis/api-gupy-clima-e-engajamento.md) - [All operations](https://skmtc.dev/gupy/apis/api-gupy-clima-e-engajamento/llms.txt) - [OpenAPI document](https://skmtc.dev/gupy/apis/api-gupy-clima-e-engajamento/revisions/04af6d64e930?raw)