> ## 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.

# Track status and policy number

> The statuses of a case, how to follow the outcome, and where to find the policy number.

Every case has a status. Read it with `GET /non-payment-insurance/cases/{caseId}` to know where the case stands and what you can do next.

## Statuses

| Status | Meaning | What you can do |
| - | - | - |
| `pending-documentation` | The offer is priced and documents are missing | Upload the documents in `documentation.missing` |
| `ready-to-issue` | Every required document is uploaded | Issue the policy |
| `rejected` | The insurer will not cover the contract | Choose another candidate and create a new case |
| `policy-requested` | The issuance has been requested and the insurer is finishing it | Wait for the decision |
| `policy-issued` | The policy is in force | Get the policy number and the policy documents |
| `failed` | Vivara could not complete the last step with the insurer | Wait: Vivara is notified and retries. Contact support if it persists |

`rejected` and `policy-issued` are final. The case also lists the actions you can take in `allowedActions`.

## Following the outcome

The insurer does not notify the decision. Poll `GET /non-payment-insurance/cases/{caseId}` with exponential backoff, waiting at least 30 seconds between calls, until the case reaches a final status.

Once the policy is issued, `policy.policyNumber` and `policy.documents` are available. While it is `policy-requested`, `policy.status` tells you whether the insurer is finishing the issuance (`pending-insurer`) or the landlord must sign the policy electronically (`pending-signature`).

## When the case does not go ahead

If the case is `rejected`, go back to your candidates and choose another one. Their scores are still valid, so you do not need to score them again. Create a new case, with a new id, for the new tenant.


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