Ir para o conteúdo
Método URL
GET 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.