Listar ativos financeiros de um cliente

GET

/assets/fiancial/{clientId}

Lista os ativos financeiros do cliente informado em clientId, de um ano por vez, em páginas de 60 itens. Com year, devolve os ativos desse ano, do cadastro mais recente para o mais antigo. Sem year, devolve os ativos do ano mais recente encontrado na página pedida. totalValue é a soma dos valores de todos os ativos do ano, não só da página. next vale true quando a página veio com 60 itens, o que indica que pode haver mais. page começa em 1, e valor menor ou igual a 0 vale 1. O caminho é /assets/fiancial/{clientId}, e essa é a grafia que a API atende. Requer autenticação via Bearer JWT ou header x-api-key. O cliente precisa pertencer à empresa do usuário: cliente inexistente devolve 404 (Cliente não encontrado), cliente de outra empresa devolve 401 (Acesso negado) e usuário inativo devolve 404 (Usuário não encontrado).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

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

Parâmetros de Caminho

Parâmetros de Consulta

Parâmetros Header

Respostas

🟢200

application/json

Ativos financeiros do cliente

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠404NotFound

🟠429TooManyRequests

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/assets/fiancial/7c9e6679-7425-40de-944b-e07fc1f90ae7?page=1&year=2026' \
--header 'x-api-key: SUA_CHAVE_DE_API' \
--header 'Authorization: Bearer <token>'

Response Example

200 - Sucesso

{
    "items": [
        {
            "_id": "f1a2b3c4-0000-4000-8000-000000000401",
            "type": "FUNDO",
            "description": "Fundo de investimento",
            "situationAt": [],
            "value": 120000,
            "year": "2026"
        }
    ],
    "next": false,
    "totalValue": 120000
}

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

Página anterior

Atualizar bem móvel

Próxima página

Listar imóveis rurais de um cliente, com totais