Cases
Every company is a case.
Reventlov treats each company as a case — a long-running record with a stable human-readable number, an assigned agent (human operator or internal lawyer), and a progress breakdown. This mirrors how visa or legal-filing platforms track work: the company is the subject of the case, and everyone (operator, AI agent, lawyer) sees the same record through their own lens.
Fields on every case
Progress model
Case progress is computed from four sections and averaged into an overall %:
- Formation — state of the legal formation (filed, EIN obtained, formed)
- Information — how complete the company profile is (industry, addresses, EIN, people)
- Compliance — submitted filings / total due filings
- Documents — number of uploaded documents against the expected minimum
You can read the computed progress via GET /v1/companies/:id (it’s returned
as part of the case payload).
Who sees what
- Operator (human) — full read/write on their own cases
- AI agent (agent-scope key) — read-only on the case it is bound to, no access to SSN or private identifiers
- Case agent (staff) — read/write on cases assigned to them
- Admin — all cases
Related
- Companies — the entity inside the case
- Agents — the AI linked to the case
- Humans vs agents — permission split