The compliance calendar is read-only. Reading it never triggers a filing, a recomputation, or any side effect — it reflects what doola already tracks for the company.
Retrieving the calendar
Statuses
status is derived at read time from the resolved due date and the company’s state:
The annual-report event is always returned — even for an unsupported state or a company that is too new. The
status carries the reason and the date fields are null, so you never receive an empty list you have to disambiguate.Roll-forward
The annual report recurs each year. Once a report is filed,nextDueDate advances to the next occurrence and lastFiledDate records when the previous one was filed — so a future due date is always explainable to the customer.
Errors
Ownership is enforced the same way across the Partner API: a company that exists but isn’t yours returns
404, never 403, so existence cannot be probed across partners. See Errors.