--- title: 4.4. Consultar Título por Id url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/4.%20Consultas/4.4.%20Consultar%20T%C3%ADtulo%20por%20Id/ --- | Método | URL | |--------|-----| | ![GET](https://img.shields.io/badge/GET-blue) | `https://BASE_URL/public/v1/recebiveis/titulos/{id}` | Consulta um título pelo identificador. Por padrão (quando o parâmetro `portador` não é informado), retorna o título quando ele está em **estoque** — já cedido ao fundo. Informe `portador=Cedente` para consultar um título que ainda está **em carteira do cedente** (ainda não cedido). ## Path Params | Campo | Tipo | Descrição | |-------|------|-----------| | `id` | Número | Identificador do título. | ## Query Params | Campo | Tipo | Descrição | |-------|------|-----------| | `portador` | Texto ou Número | Portador do título: `Cedente` (`1`) ou `Fundo` (`2`). Quando omitido, assume `Fundo` (estoque), preservando o comportamento original do endpoint. Ver [Portadores](#portadores). | ```` json title="Response Body — 200 OK" { "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 } ```` ## Responses | Status | Modelo | Descrição | |--------|--------|-----------| | `200 OK` | `TituloApiPublicaDto` | Título encontrado. | | `400 Bad Request` | `RetornoPadrao` | Erro ao consultar o título. | | `404 Not Found` | `RetornoPadrao` | Título não encontrado para o `portador` informado (por padrão, **fundo**/estoque) ou indisponível para consulta pública. | # Modelo de dados O modelo de retorno é o mesmo descrito na seção **Título** da página **Consultar Título no Estoque**. O portador atual do título é devolvido no campo `portador`. ### 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. |