Método	URL
	`https://BASE_URL/public/v1/recebiveis/titulos/{id}/documentos`

Lista os documentos de um título: primeiro o lastro principal (o documento fiscal — nota fiscal, CT-e, duplicata), depois os documentos adicionais (contrato mestre, termo de utilização...) na ordem em que foram anexados.

Use esta rota para saber o que já está no título antes de anexar, para obter o idLastro usado em Baixar Documento do Título e Desvincular Documento do Título, e para acompanhar o envio de cada documento à administradora do fundo.

Path Params¶

Campo	Tipo	Descrição
`id`	Número	Identificador do título.

Esta rota não possui Request Body.

Exemplo de cURL

curl -X GET "https://BASE_URL/public/v1/recebiveis/titulos/551203/documentos" \
  -H "Authorization: Bearer {token}" \
  -H "GrupoEconomico: {grupo}"

Response Body — 200 OK

[
  {
    "idLastro": 98100,
    "tipoDocumento": "NFSE",
    "nomeArquivo": "nota-4231.pdf",
    "principal": true,
    "statusEnvioAdministradora": "EnviadoComSucesso",
    "erroEnvioAdministradora": null,
    "dataVinculo": "2026-09-29T14:02:11.512Z",
    "quantidadeTitulosVinculados": 3
  },
  {
    "idLastro": 98231,
    "tipoDocumento": "Contrato",
    "nomeArquivo": "contrato-mestre.pdf",
    "principal": false,
    "statusEnvioAdministradora": "AguardandoEnvio",
    "erroEnvioAdministradora": null,
    "dataVinculo": "2026-09-29T14:05:40.118Z",
    "quantidadeTitulosVinculados": 12
  }
]

Erros¶

Erros retornam o envelope RetornoPadrao.

Response Body — 404 Not Found (título não encontrado)

{
  "status": "erro",
  "mensagem": "Título(s) 551203 não encontrado(s)."
}

Modelo de dados¶

Documento¶

Campo	Tipo	Descrição
`idLastro`	Número	Identificador do documento. É o `idLastro` das rotas de download e de desvínculo.
`tipoDocumento`	Texto	Tipo do documento, pelo nome (ver tabela abaixo). Pode vir `null` no lastro principal de títulos antigos.
`nomeArquivo`	Texto	Nome do arquivo. `null` quando o lastro principal ainda não tem arquivo.
`principal`	Booleano	`true` no lastro principal (documento fiscal). O principal não pode ser desvinculado.
`statusEnvioAdministradora`	Texto	Situação do envio à administradora: `AguardandoEnvio`, `Enviando`, `EnviadoComSucesso` ou `FalhaAoEnviar`.
`erroEnvioAdministradora`	Texto	Motivo da última falha de envio, quando houver.
`dataVinculo`	Data e hora	Quando o documento passou a fazer parte do título.
`quantidadeTitulosVinculados`	Número	Quantos títulos usam o documento. Maior que `1` indica documento compartilhado, como o contrato mestre.

Tipos de documento¶

`tipoDocumento`	Natureza
`NFE`, `NFSE`, `CTE`, `DuplicataMercantil`	Documento fiscal (lastro principal).
`Contrato`, `TermoUtilizacao`, `CCB`, `NC`, `Nsu`	Documento adicional.

Observações¶

Situação do envio por título: num documento compartilhado, statusEnvioAdministradora é o do envio deste título — o mesmo contrato mestre pode já ter saído num lote e estar aguardando envio em outro.
Só títulos com operação: título sem operação não tem documentos e responde 404.