---
title: 10.1. Listar Documentos do Título
url: https://docs.vehub.com.br/API/Integra%C3%A7%C3%A3o%20FIDC/10.%20Documentos%20do%20T%C3%ADtulo/10.1.%20Listar%20Documentos%20do%20T%C3%ADtulo/
---
| Método | URL |
|--------|-----|
| ![GET](https://img.shields.io/badge/GET-blue) | `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](10.3.%20Baixar%20Documento%20do%20T%C3%ADtulo.md) e [Desvincular Documento do Título](10.4.%20Desvincular%20Documento%20do%20T%C3%ADtulo.md), 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`.

```` bash title="Exemplo de cURL"
curl -X GET "https://BASE_URL/public/v1/recebiveis/titulos/551203/documentos" \
  -H "Authorization: Bearer {token}" \
  -H "GrupoEconomico: {grupo}"
````

```` json title="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`.

```` json title="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`.