Questions about Annual Return Filing

API Meetings
1

Hi team,

  1. Can you provide a sample company to test annual report filing? We get the following validation error on trying to test this in the sandbox?
    {"errorMessage": "API backend third party service error.", "rootCause": "errors:[error:Annual Report Date cannot be before a previous Annual Report or the Founding Date.,..}

  2. For filing the annual report, there is a discrepancy between the example request body and the directors schema in the documentation. Is the id property required for filing the change? If so, what should be the value passed to it?

{
...,
"directors": [
        {
          "officer": {
            "email": "api.specs@api.specs",
            "firstName": "firstName",
            "id": 584282, // What should be the id?
            "lastName": "lastName",
            "partyType": "person",
            "middleInitial": "",
            "prevFirstName": "firstName",
            "prevLastName": "lastName",
            "prevMiddleInitial": ""
          },
...]
}
  1. In the Annual Return Schema, annualGeneralMeetingDateis not a required field. However, the latest announcement on Feb 04, 2025, lists mandatory changes. How do we validate these changes and send the right data points in the Annual Return filing?
* You will need to include information about your Annual General Meeting (AGM). There are three options to choose from:
  * The date the AGM was held, or
  * That the AGM will be held, or
  * The date the AGM was waived or deemed to have been held

Thanks

2
  1. You can only submit filings for a business that is linked to the account an API key was created for.
  2. The id property needs to match the id for the given director of your business. This can be determined using the GET /businesses/<business_identifer>/directors endpoint.
  3. Will get back to you on this.
3

@achiu Thanks for your response. I have another question about the annual report schema. In the documentation it doesn’t have a description of the following fields from the Annual Report Request example provided here

"directors": [
        {
          "officer": {...},
          "appointmentDate": "2024-07-23",
          "cessationDate": null,
          "deliveryAddress": {...},
          "mailingAddress":  {...},
          "role": "director",
          "id": 1, // missing from schema description
          "isFeeApplied": false, // missing from schema description
          "isDirectorActionable": true, // missing from schema description
          "actions": [] // missing from schema description
        }
      ]

The response from GET /businesses/<business_identifer>/directors endpoint is also missing these properties.

Please let us know if these are required and what should these values refer to?

Thank you.