---
title: 4.7. Patrimônio Líquido do Fundo
url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/4.%20Consultas/4.7.%20Patrim%C3%B4nio%20L%C3%ADquido%20do%20Fundo/
---
| Método | URL |
|--------|-----|
| ![GET](https://img.shields.io/badge/GET-blue) | `https://BASE_URL/public/api/v1/patrimonio-liquido` |

Consulta o **patrimônio líquido (PL)** dos fundos numa data de referência.

O PL é informado manualmente, um dia útil por vez. Quando o dia pedido ainda **não tem PL informado**, o endpoint não devolve vazio: ele recua para o **último dia anterior que tenha** e devolve aquele valor, dizendo em `dataReferencia` a que data ele realmente pertence.

> O recuo só olha **para trás**. Um PL cadastrado em data posterior à pedida nunca é devolvido — devolvê-lo inventaria histórico que não existia na data consultada.

> Os resultados respeitam o RLS e ficam restritos ao grupo econômico do token informado no header `GrupoEconomico`.

## Query Params

Todos os parâmetros são **opcionais**.

| Parâmetro | Tipo | Descrição |
|-----------|------|-----------|
| `dataReferencia` | Texto (date) | Data-base da consulta. Formato `YYYY-MM-DD`. Quando omitida, assume a data atual. |
| `idCessionario` | Número (long) | Filtra por um financiador (fundo). Quando omitido, devolve **todos** os fundos ativos do grupo econômico que tenham PL até a data. |

> Query parameters são **case-insensitive** (`dataReferencia` ou `DataReferencia` funcionam).

## Request

```` text title="Exemplo de querystring"
GET https://BASE_URL/public/api/v1/patrimonio-liquido?dataReferencia=2026-03-20&idCessionario=12
````

## Response

A resposta é sempre uma **lista**, mesmo quando `idCessionario` é informado (com um único item).

```` json title="Response Body — 200 OK"
[
  {
    "idCessionario": 12,
    "nome": "FIDC Exemplo",
    "cnpj": "12345678000190",
    "dataReferenciaSolicitada": "2026-03-20",
    "dataReferencia": "2026-03-18",
    "patrimonioLiquido": 12450000.00,
    "dataCadastro": "2026-03-18T21:42:11.482Z",
    "dataAtualizacao": null
  }
]
````

No exemplo acima, **não havia PL cadastrado em 20/03**: o valor devolvido é o de **18/03**, o último dia com informação até a data pedida.

# Modelo de dados

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `idCessionario` | Número (long) | Identificador do financiador (fundo). |
| `nome` | Texto | Nome do fundo. |
| `cnpj` | Texto | CNPJ do fundo, somente dígitos. |
| `dataReferenciaSolicitada` | Texto (date) | A data que você pediu, repetida na resposta. |
| `dataReferencia` | Texto (date) | A data a que o `patrimonioLiquido` devolvido realmente se refere. |
| `patrimonioLiquido` | Número (decimal) | Valor do patrimônio líquido do fundo na `dataReferencia`. |
| `dataCadastro` | Texto (date-time) | Quando o PL daquela data foi cadastrado. |
| `dataAtualizacao` | Texto (date-time) | Quando o valor foi corrigido pela última vez. `null` quando nunca foi alterado depois de cadastrado. |

## Como interpretar as duas datas

`dataReferenciaSolicitada` e `dataReferencia` existem separadas de propósito — é a diferença entre elas que diz **quão defasado** está o número que você recebeu.

| Situação | Resultado |
|----------|-----------|
| `dataReferencia` **igual** a `dataReferenciaSolicitada` | Há PL informado no próprio dia pedido. |
| `dataReferencia` **anterior** a `dataReferenciaSolicitada` | O dia pedido não tem PL; o valor é o do último dia com informação. Quanto maior a distância, mais antigo o dado. |

Sem comparar as duas, um PL de três semanas atrás chega indistinguível do PL de hoje.

## Códigos de retorno

| Código | Modelo | Descrição |
|--------|--------|-----------|
| `200 OK` | Lista de `PatrimonioLiquidoDto` | Consulta realizada. Sem `idCessionario`, a lista pode vir **vazia** quando nenhum fundo ativo tem PL até a data. |
| `400 Bad Request` | `RetornoPadrao` | Erro ao consultar o patrimônio líquido. |
| `404 Not Found` | `RetornoPadrao` | Só ocorre com `idCessionario` informado: o fundo não existe, está inativo, ou não tem PL algum até a data pedida. |

> Com `idCessionario` informado, a ausência de PL é **404**, não uma lista vazia com `200`. Quem pede um fundo específico espera um número, e um `[]` com `200` convida a tratar a ausência como zero.

```` json title="Response Body — 404 Not Found"
{
  "status": "erro",
  "mensagem": "Não há patrimônio líquido informado para o financiador 12 até 20/03/2026."
}
````