---
title: 4.3 Consultar Título no Estoque
url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/4.%20Consultas/4.3%20Consultar%20T%C3%ADtulo%20no%20Estoque/
---
| Método | URL |
|--------|-----|
| ![GET](https://img.shields.io/badge/GET-blue) | `https://BASE_URL/public/v1/recebiveis/titulos` |

Consulta títulos por portador. Por padrão (quando o parâmetro `Portador` não é informado), retorna os títulos em **estoque** — já cedidos ao fundo. Informe `Portador=Cedente` para listar os títulos que ainda estão **em carteira do cedente** (ainda não cedidos). O retorno é paginado.

## Query Params

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `Portador` | Texto ou Número | Portador dos títulos: `Cedente` (`1`) ou `Fundo` (`2`). Quando omitido, assume `Fundo` (estoque). Ver [Portadores](#portadores). |
| `IdOperacao` | Número | Identificador da operação. |
| `IdCessionario` | Número | Identificador do cessionário. |
| `IdEmpresa` | Número | Identificador da empresa cedente. |
| `SacadoOuNfe` | Texto | Busca por dados do sacado ou NF-e. |
| `IdSacado` | Número | Identificador do sacado. |
| `NomeSacado` | Texto | Nome do sacado. |
| `NumeroDocumento` | Texto | Número do documento. |
| `DataImportacaoInicio` | Data | Data inicial de importação. |
| `DataImportacaoFim` | Data | Data final de importação. |
| `DataAquisicaoInicio` | Data | Data inicial de aquisição. |
| `DataAquisicaoFim` | Data | Data final de aquisição. |
| `DataVencimentoInicio` | Data | Data inicial de vencimento. |
| `DataVencimentoFim` | Data | Data final de vencimento. |
| `DataVencimento` | Data | Data exata de vencimento. |
| `DiasVencimento` | Número | Quantidade de dias até o vencimento. |
| `DataLiquidacaoInicio` | Data | Data inicial de liquidação. |
| `DataLiquidacaoFim` | Data | Data final de liquidação. |
| `EspeciesTitulo` | Lista de números | Códigos das espécies dos títulos. |
| `IdsCredenciadoras` | Lista de números | Identificadores das credenciadoras. |
| `IdsArranjosPagamento` | Lista de números | Identificadores dos arranjos de pagamento. |
| `PossuiLastro` | Booleano | Indica se o título possui lastro. |
| `LastroPerformado` | Booleano | Indica se o lastro é performado. |
| `NumeroNotaFiscalInicio` | Número | Número inicial da nota fiscal. |
| `NumeroNotaFiscalFim` | Número | Número final da nota fiscal. |
| `NumeroSerieNotaFiscalInicio` | Número | Série inicial da nota fiscal. |
| `NumeroSerieNotaFiscalFim` | Número | Série final da nota fiscal. |
| `ValorNominalMin` | Decimal | Valor nominal mínimo. |
| `ValorNominalMax` | Decimal | Valor nominal máximo. |
| `ValorNominal` | Decimal | Valor nominal exato. |
| `ValorPresenteMin` | Decimal | Valor presente mínimo. |
| `ValorPresenteMax` | Decimal | Valor presente máximo. |
| `ValorPresente` | Decimal | Valor presente exato. |
| `ValorAquisicaoMin` | Decimal | Valor de aquisição mínimo. |
| `ValorAquisicaoMax` | Decimal | Valor de aquisição máximo. |
| `ValorPagoMin` | Decimal | Valor pago mínimo. |
| `ValorPagoMax` | Decimal | Valor pago máximo. |
| `ValorSaldoDevedor` | Decimal | Valor de saldo devedor. |
| `PrazoAtualInicio` | Número | Prazo atual mínimo. |
| `PrazoAtualFim` | Número | Prazo atual máximo. |
| `PrazoAquisicaoInicio` | Número | Prazo de aquisição mínimo. |
| `PrazoAquisicaoFim` | Número | Prazo de aquisição máximo. |
| `Status` | Texto | Status do título conforme filtro disponível na API. |
| `Ordem` | Texto | Campo usado para ordenação. |
| `DirecaoOrdem` | Texto | Direção da ordenação. |
| `SiglaArranjo` | Texto | Sigla do arranjo de pagamento. |
| `CnpjCedente` | Texto | CNPJ do cedente. |
| `NomeCedente` | Texto | Nome do cedente. |
| `TipoRecebivel` | Texto | Tipo do recebível. |
| `CpfCnpjSacado` | Texto | CPF ou CNPJ do sacado. |
| `DemonstrarLiquidados` | Booleano | Indica se títulos liquidados devem ser exibidos. |
| `DisponivelParaMovimentacao` | Booleano | Indica se o título está disponível para movimentação (não vinculado a um lote em andamento). |
| `IndicePagina` | Número | Índice da página. |
| `TamanhoDaPagina` | Número | Quantidade de registros por página. |

```` json title="Response Body — 200 OK"
{
  "registros": [
    {
      "id": 1,
      "numeroControleParticipante": "CTRL-001",
      "numeroDocumento": "DOC-123456",
      "nossoNumero": "00012345",
      "dataEmissao": "2025-01-10",
      "dataVencimento": "2025-04-10",
      "bancoCobranca": 341,
      "agenciaCobranca": 1234,
      "especie": "DuplicataMercantil",
      "jurosMoraDia": 0.033,
      "valorAbatimento": 50,
      "tags": [],
      "sacado": {
        "id": 401,
        "tipoPessoa": 2,
        "cpfCnpj": "12345678000199",
        "nome": "Empresa Sacado LTDA",
        "cep": "01310100",
        "endereco": "Avenida Paulista",
        "cidade": "São Paulo",
        "uf": "SP",
        "email": "financeiro@sacado.com.br",
        "telefone": "11999990000",
        "numero": 1000,
        "bairro": "Bela Vista",
        "complemento": "Sala 42"
      },
      "cedente": {
        "id": 301,
        "nome": "Cedente Comércio S.A.",
        "cnpj": "98765432000111"
      },
      "lastro": {
        "id": 501,
        "numeroNotaFiscal": 9871,
        "numeroSerieNotaFiscal": 1,
        "chaveNfe": "NFe35250112345678000199550010000098711000012345",
        "chaveAcessoNfe": "",
        "inscricaoMunicipal": "",
        "codigoMunicipioIBGE": "3550308",
        "dataEmissao": "2025-01-08",
        "valorTotal": 15000,
        "tipoLastroPerformado": "BensPerformado"
      },
      "lotes": [
        {
          "idLote": 987,
          "status": 4,
          "ocorrencia": 1
        }
      ],
      "dataVencimentoAjustada": "2025-04-11",
      "dataLiquidacao": null,
      "valorPresente": 14200,
      "valorDespesa": 120,
      "valorDesconto": 300,
      "valorNominal": 15000,
      "valorAquisicao": 14500,
      "valorPago": null,
      "valorAbertoAtualizadoAdministradora": 14750.10,
      "dataConsultaValorAdministradora": "2025-04-01T08:00:00Z",
      "portador": "Fundo",
      "prazoAtual": 79,
      "dataAquisicao": "2025-01-11",
      "prazoAquisicao": 89,
      "valorSaldoDevedor": 15000,
      "valorMulta": null,
      "taxaDesagio": 2.5,
      "numeroCodigoBarras": null,
      "numeroLinhaDigitavel": null,
      "numeroParcela": 1,
      "numeroTotalParcelas": 1,
      "arranjoPagamento": null,
      "tickerSymbol": null,
      "codigoIpoc": null,
      "disponivelParaMovimentacao": false
    }
  ],
  "paginacao": {
    "paginaAtual": 1,
    "paginaTotal": 1,
    "paginaQuantidadeRegistro": 1,
    "quantidadeRegistros": 1,
    "temPaginaAnterior": false,
    "temProximaPagina": false
  },
  "mensagem": null
}
````

# Modelo de dados

## Retorno

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `registros` | Lista de [Título](#titulo) | Títulos retornados na página atual. |
| `paginacao` | [Paginação](#paginacao) | Dados de paginação. |
| `mensagem` | Texto | Mensagem complementar da consulta. |

### Título

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `id` | Número | Identificador do título. |
| `numeroControleParticipante` | Texto | Número de controle do participante. |
| `numeroDocumento` | Texto | Número do documento. |
| `nossoNumero` | Texto | Nosso número. |
| `dataEmissao` | Data | Data de emissão do título. |
| `dataVencimento` | Data | Data de vencimento do título. |
| `bancoCobranca` | Número | Código do banco de cobrança. |
| `agenciaCobranca` | Número | Código da agência de cobrança. |
| `especie` | Texto (enum) | Nome da espécie do título. Ver [Espécies de título](#especies-de-titulo). |
| `jurosMoraDia` | Decimal | Juros de mora por dia. |
| `valorAbatimento` | Decimal | Valor de abatimento. |
| `tags` | Lista de texto | Tags associadas ao título. |
| `sacado` | [Sacado](#sacado) | Dados do sacado. |
| `cedente` | [Cedente](#cedente) | Dados do cedente. |
| `lastro` | [Lastro](#lastro) | Dados do lastro. |
| `lotes` | Lista de [Lote do título](#lote-do-titulo) | Lotes aos quais o título está vinculado. |
| `dataVencimentoAjustada` | Data | Data de vencimento ajustada. |
| `dataLiquidacao` | Data | Data de liquidação. |
| `valorPresente` | Decimal | Valor presente do título. |
| `valorDespesa` | Decimal | Valor de despesa. |
| `valorDesconto` | Decimal | Valor de desconto. |
| `valorNominal` | Decimal | Valor nominal do título. |
| `valorAquisicao` | Decimal | Valor de aquisição do título. |
| `valorPago` | Decimal | Valor pago. |
| `valorAbertoAtualizadoAdministradora` | Decimal | Valor em aberto atualizado, informado pela administradora na última conciliação. Nulo quando ainda não consultado. |
| `dataConsultaValorAdministradora` | Data e hora | Data/hora (UTC) da última consulta do valor atualizado na administradora. |
| `portador` | Texto | Portador atual do título: `Cedente` ou `Fundo`. Ver [Portadores](#portadores). |
| `prazoAtual` | Número | Prazo atual em dias. |
| `dataAquisicao` | Data | Data de aquisição. |
| `prazoAquisicao` | Número | Prazo de aquisição em dias. |
| `valorSaldoDevedor` | Decimal | Valor de saldo devedor. |
| `valorMulta` | Decimal | Valor de multa. |
| `taxaDesagio` | Decimal | Taxa de deságio. |
| `numeroCodigoBarras` | Texto | Código de barras. |
| `numeroLinhaDigitavel` | Texto | Linha digitável. |
| `numeroParcela` | Número | Número da parcela. |
| `numeroTotalParcelas` | Número | Número total de parcelas. |
| `arranjoPagamento` | Texto | Arranjo de pagamento. |
| `tickerSymbol` | Texto | Ticker associado ao título. |
| `codigoIpoc` | Texto | Código IPOC. |
| `disponivelParaMovimentacao` | Booleano | Indica se o título está disponível para realizar movimentação. |

### Lote do título

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `idLote` | Número | Identificador do lote vinculado ao título. |
| `status` | Número | Código do status do lote. Ver a seção **Status** na página **Consultar Lote**. |
| `ocorrencia` | Número | Código da ocorrência do lote. Ver a seção **Ocorrências** na página **Consultar Lote**. |

### Sacado

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `id` | Número | Identificador do sacado. |
| `tipoPessoa` | Número | `1` = Pessoa Física, `2` = Pessoa Jurídica. |
| `cpfCnpj` | Texto | CPF ou CNPJ do sacado. |
| `nome` | Texto | Nome do sacado. |
| `cep` | Texto | CEP do sacado. |
| `endereco` | Texto | Endereço do sacado. |
| `cidade` | Texto | Cidade do sacado. |
| `uf` | Texto | UF do sacado. |
| `email` | Texto | E-mail do sacado. |
| `telefone` | Texto | Telefone do sacado. |
| `numero` | Número | Número do endereço. |
| `bairro` | Texto | Bairro. |
| `complemento` | Texto | Complemento. |

### Cedente

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `id` | Número | Identificador da empresa cedente. |
| `nome` | Texto | Nome da empresa cedente. |
| `cnpj` | Texto | CNPJ da empresa cedente. |

### Lastro

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `id` | Número | Identificador do lastro. |
| `numeroNotaFiscal` | Número | Número da nota fiscal. |
| `numeroSerieNotaFiscal` | Número | Número de série da nota fiscal. |
| `chaveNfe` | Texto | Chave da NF-e. |
| `chaveAcessoNfe` | Texto | Chave de acesso da NF-e. |
| `inscricaoMunicipal` | Texto | Inscrição municipal. |
| `codigoMunicipioIBGE` | Texto | Código do município segundo o IBGE. |
| `dataEmissao` | Data | Data de emissão do lastro. |
| `valorTotal` | Decimal | Valor total do lastro. |
| `tipoLastroPerformado` | Texto (enum) | Nome do tipo de lastro performado. Ver [Tipos de lastro performado](#tipos-de-lastro-performado). |

### Paginação

| Campo | Tipo | Descrição |
|-------|------|-----------|
| `paginaAtual` | Número | Página atual. |
| `paginaTotal` | Número | Total de páginas. |
| `paginaQuantidadeRegistro` | Número | Quantidade de registros na página. |
| `quantidadeRegistros` | Número | Quantidade total de registros. |
| `temPaginaAnterior` | Booleano | Indica se existe página anterior. |
| `temProximaPagina` | Booleano | Indica se existe próxima página. |

### Espécies de título

O campo `especie` é retornado como texto com o nome do enumerador.

| Valor (texto) | Código | Espécie |
|---------------|--------|---------|
| `DuplicataMercantil` | `2` | Duplicata Mercantil |
| `UnidadeRecebivel` | `3` | Unidade de Recebível |
| `NotaFiscalServico` | `4` | Nota Fiscal Serviço |
| `NotaDeDebito` | `5` | Nota de Débito |
| `CCBPreDigital` | `6` | CCB Pré Digital |
| `NotaPromissoria` | `8` | Nota Promissória |
| `NotaComercial` | `9` | Nota Comercial |
| `Contrato` | `10` | Contrato |
| `NotaFiscal` | `11` | Nota Fiscal |
| `CedulaProdutoRural` | `12` | Cédula de Produto Rural |
| `CTE` | `13` | CT-e |
| `ConfissaoDivida` | `14` | Confissão de Dívida |
| `AssuncaoDivida` | `15` | Assunção de Dívida |
| `FaturaCartaoCredito` | `16` | Fatura de Cartão de Crédito |
| `BloqueioAgendaPagamentoCartao` | `17` | Bloqueio Agenda Pagamento Cartão |

### Tipos de lastro performado

O campo `lastro.tipoLastroPerformado` é retornado como texto com o nome do enumerador.

| Valor (texto) | Código | Descrição |
|---------------|--------|-----------|
| `ServicosNaoPerformado` | `0` | Serviços não performado |
| `ServicosPerformado` | `1` | Serviços performado |
| `BensNaoPerformado` | `2` | Bens não performado |
| `BensPerformado` | `3` | Bens performado |
| `BensServiçosNaoPerformado` | `4` | Bens e serviços não performado |
| `BensServicosPerformado` | `5` | Bens e serviços performado |

### Portadores

| Código | Portador | Descrição |
|--------|----------|-----------|
| `1` | `Cedente` | Título em carteira do cedente (ainda não cedido ao fundo). |
| `2` | `Fundo` | Título cedido ao fundo (estoque). Valor padrão da consulta. |