| Método | URL |
|---|---|
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. |
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. |