> ## Documentation Index
> Fetch the complete documentation index at: https://developers.vivara.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Provide pending documents

> Which documents the insurer may ask for, and how to send them until nothing is missing.

The case lists the documents the insurer requires under `documentation.missing`. Each item says which document types satisfy it, how many files it needs and, for tenant documents, which tenant it is about.

## How it works

1. Read `documentation.missing` in the case.
2. Upload a document for one of the items with `POST /non-payment-insurance/cases/{caseId}/documents`, as a file with its type and, for tenant documents, the tenant's `id`.
3. The response returns the document and the updated `documentation`.
4. Repeat until `documentation.missing` is empty. The case is then `ready-to-issue`.

Documents are stored only. They are sent to the insurer when you issue the policy, so uploading a document does not change the offer. Accepted formats are PDF, JPEG and PNG, up to 10 MB each.

If you upload a document by mistake, remove it with `DELETE /non-payment-insurance/cases/{caseId}/documents/{documentId}` while the case is `pending-documentation` or `ready-to-issue`. The call answers `204` with no body: read the case to see the updated documentation. If the document satisfied a requirement, the case goes back to `pending-documentation`.

## Document types

| Type | Who it is for |
| - | - |
| `data-protection-consent` | The case. The signed data protection annex (Anexo LOPD), signed by the landlord and every tenant. The requirement includes a template to fill in |
| `identity-document` | A tenant |
| `employment-contract` | A tenant |
| `work-history-report` | A tenant. The *vida laboral* |
| `payslip` | A tenant |
| `income-tax-return` | A tenant |
| `quarterly-tax-return` | A tenant |
| `pension-certificate` | A tenant |
| `company-tax-id-card` | A tenant |
| `corporate-income-tax-return` | A tenant |
| `power-of-attorney` | A tenant |
| `guarantor-identity-document` | A tenant |
| `guarantor-income-proof` | A tenant |
| `military-commitment` | A tenant |

Which ones a given person needs depends on their working status, and the case tells you in `documentation.missing`: each requirement lists the types that satisfy it (`anyOf`) and how many files it needs (`minFiles`).

> [!WARNING]
>
> Do not rely on a fixed list. Always read `documentation.missing` from the
> case: the insurer decides what it needs for each offer.

## Documents must be current

The insurer only accepts recent documents. A payslip from several months ago will not accredit current income: ask the tenant for the latest ones.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.