Listar pedidos de recomendação

GET

/v2/recommendations/

Lista os pedidos de recomendação de clientes feitos por todas as empresas da rede, do mais recente para o mais antigo, para que os usuários possam avaliar clientes que conhecem. Ficam de fora os pedidos cujo CPF/CNPJ é o da própria empresa ou o do usuário autenticado. O CPF/CNPJ vem mascarado. Para cada pedido, informa se foi feito nas últimas 24 horas (new), se foi feito pela empresa do usuário (requestedByThisCompany), se o usuário já avaliou (alreadyReplied) e se há novidade para o usuário (viewed = false). Os totais de avaliações, aprovações e reprovações só vêm nos pedidos feitos pela própria empresa. A lista não é paginada: todos os pedidos vêm numa única resposta. Requer autenticação via Bearer JWT ou header x-api-key.

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Header

Respostas

🟢200

application/json

Harvested 200

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v2/recommendations/' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "items": [
        {
            "_id": "3d6f0a9e-2b7c-4e51-9a8d-0c4b7e2f1a63",
            "taxId": "12.***.***/0001-90",
            "kind": "legal",
            "informedName": "Agropecuária Boa Safra Ltda",
            "state": "MT",
            "city": "Sorriso",
            "createdAt": "2026-09-24T13:20:05.412Z",
            "new": true,
            "requestedByThisCompany": true,
            "alreadyReplied": false,
            "totalReplies": 2,
            "totalApprovals": 2,
            "totalDisapprovals": 0,
            "viewed": false
        },
        {
            "_id": "9a2b4c6d-8e0f-4a1b-b3c5-d7e9f1a3b5c7",
            "taxId": "123.***.***-09",
            "kind": "natural",
            "informedName": "João da Silva",
            "state": "GO",
            "city": "Rio Verde",
            "createdAt": "2026-09-20T10:02:44.001Z",
            "new": false,
            "requestedByThisCompany": false,
            "alreadyReplied": true,
            "viewed": true
        }
    ]
}

Modificado em 2026-10-13 09:47:06

Página anterior

Listar registros do Radar RJ da empresa

Próxima página

Solicitar recomendação de um cliente