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

FieldDescription
case_numberShort human-readable id like CASE-A1B2C3. Stable for life.
case_statusactive · dormant · on_hold · dissolved
case_agent_idThe staff account (lawyer/ops) handling the case. null if unassigned.
formation_statuspending · filed · formed · failed · dissolved

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