Ver agradecimentos

Utilize esse método para buscar e visualizar os agradecimentos realizados por colaboradores que receberam reconhecimentos.

Método

GET api/v2/recognitions/thanks

Headers

Header	Valor
Authorization	Bearer access_token

Obtenha o access_token pelo método de autenticação.

Parâmetros

Query Parameters (Opcionais)

Parâmetro	Tipo	Descrição
start_date	date	Data inicial para filtrar agradecimentos (padrão é início do mês atual)
end_date	date	Data final para filtrar agradecimentos (padrão é fim do mês atual)
sender	string	email ou registration_id do colaborador que enviou o reconhecimento
receiver	string	email ou registration_id do colaborador que recebeu o reconhecimento
user_group_uuid	string	uuid do grupo de usuários para filtrar agradecimentos. Consulte a lista de grupos para obter os UUIDs disponíveis

Exemplo de Requisição

Para buscar agradecimentos com filtros:

GET api/v2/recognitions/thanks?start_date=01-10-2025&end_date=31-10-2025&[email protected]

Para buscar agradecimentos por grupo de usuários:

GET api/v2/recognitions/thanks?start_date=01-01-2025&end_date=31-12-2025&user_group_uuid=11111111-2222-3333-4444-555555555555

Para buscar todos os agradecimentos:

GET api/v2/recognitions/thanks

Resposta

200 - Sucesso

{
    "filters": {
        "start_date": "2025-10-01",
        "end_date": "2025-10-31"
    },
    "thanks": [
        {
            "recognition_date": "28/08/2025",
            "sender_name": "EDNELSON SILVA",
            "sender_email": "[email protected]",
            "sender_registration_id": "000089",
            "receiver_name": "MARCELO MALAGUETA",
            "receiver_email": "[email protected]",
            "receiver_registration_id": "001109",
            "message": "Excelente trabalho na apresentação do projeto! Sua organização e clareza foram fundamentais para o sucesso da reunião.",
            "thank_date": "03/10/2025"
        },
        {
            "recognition_date": "29/08/2025",
            "sender_name": "CAMILE PAULA",
            "sender_email": "[email protected]",
            "sender_registration_id": "000233",
            "receiver_name": "PATRICIA SANTOS",
            "receiver_email": "[email protected]",
            "receiver_registration_id": "000556",
            "message": "Parabéns pela iniciativa em melhorar os processos da equipe. Sua proatividade e visão estratégica fazem toda a diferença.",
            "thank_date": "01/10/2025"
        },
        {
            "recognition_date": "03/09/2025",
            "sender_name": "FELIPE FALCONI",
            "sender_email": "[email protected]",
            "sender_registration_id": "000602",
            "receiver_name": "JANA FARIA",
            "receiver_email": "[email protected]",
            "receiver_registration_id": "001303",
            "message": "Obrigado pelo suporte constante e pela paciência ao ensinar os novos membros da equipe. Você é um exemplo de liderança.",
            "thank_date": "03/10/2025"
        },
        {
            "recognition_date": "19/09/2025",
            "sender_name": "GABRIEL HOHL",
            "sender_email": "[email protected]",
            "sender_registration_id": "001141",
            "receiver_name": "AUGUSTO NETO",
            "receiver_email": "[email protected]",
            "receiver_registration_id": "001217",
            "message": "Sua capacidade de resolver problemas complexos e manter a calma sob pressão é impressionante. Obrigado por sempre estar disponível.",
            "thank_date": "02/10/2025"
        },
        {
            "recognition_date": "25/09/2025",
            "sender_name": "CARLOS MENDES",
            "sender_email": "[email protected]",
            "sender_registration_id": "001200",
            "receiver_name": "MARIA COSTA",
            "receiver_email": "[email protected]",
            "receiver_registration_id": "001201",
            "message": "Parabéns pelo excelente trabalho no fechamento do projeto. Sua organização e atenção aos detalhes foram essenciais para o sucesso.",
            "thank_date": "04/10/2025"
        }
    ]
}

Exemplo com filtro de grupo de usuários

{
    "filters": {
        "start_date": "2025-01-01",
        "end_date": "2025-12-31",
        "user_group": {
            "name": "Grupo Fictício API",
            "uuid": "11111111-2222-3333-4444-555555555555"
        }
    },
    "thanks": [
        {
            "recognition_date": "15/03/2025",
            "sender_name": "ANTONIO SILVA",
            "sender_email": "[email protected]",
            "sender_registration_id": "001200",
            "receiver_name": "BEATRIZ AMORIM",
            "receiver_email": "[email protected]",
            "receiver_registration_id": "001201",
            "message": "Excelente trabalho no projeto de automação. Sua dedicação e conhecimento técnico foram fundamentais para o sucesso da implementação.",
            "thank_date": "16/03/2025"
        },
        {
            "recognition_date": "22/06/2025",
            "sender_name": "ELIANE COSTA",
            "sender_email": "[email protected]",
            "sender_registration_id": "001203",
            "receiver_name": "FABIO MARTINS",
            "receiver_email": "[email protected]",
            "receiver_registration_id": "001204",
            "message": "Parabéns pela iniciativa em melhorar os processos da equipe. Sua proatividade e visão estratégica fazem toda a diferença.",
            "thank_date": "23/06/2025"
        }
    ]
}

401 - Não Autorizado

{
  "error": "access token expired"
}

Nesse caso, verifique se o access_token no header Authorization está correto e não expirou.

400 - Requisição Inválida

{
  "error": "Data inicial inválida"
}

Nesse caso, verifique se a data inicial está no formato correto (DD-MM-YYYY).

{
  "error": "Data final inválida"
}

Nesse caso, verifique se a data final está no formato correto (DD-MM-YYYY).

{
  "error": "Data inicial deve ser anterior ou igual à data final"
}

Nesse caso, ajuste as datas para que a data inicial seja anterior ou igual à data final.

{
  "error": "O intervalo máximo permitido é de 12 meses"
}

Nesse caso, reduza o intervalo entre as datas para no máximo 12 meses.

{
  "error": "sender not found"
}

Nesse caso, verifique se o email ou registration_id do remetente está correto e existe no sistema.

{
  "error": "receiver not found"
}

Nesse caso, verifique se o email ou registration_id do destinatário está correto e existe no sistema.

{
  "error": "user group not found"
}

Nesse caso, verifique se o UUID do grupo de usuários está correto e existe no sistema.