Submit Annual Accounts API payload question

This may have been asked before, but I can’t find it. I’m trying to submit annual accounts via the API. According to the tech spec, regarding the Class element,

  • To submit a document to Companies House one of the following should be used.

AA is in the list, which seems like it should be the right value for Annual Accounts. However, if this is used, I get an XML validation error:

XML failed schema validation: Invalid XML: Datatype error: Type:InvalidDatatypeValueException, Message:Value ‘AA’ with length ‘2’ is less than minimum length facet of ‘4’ . line 6 column 30

Is the list on the Tech Spec correct? And what is the right value to use on the Class element when submitting an Annual Account?

Thanks in advance. (Cross-posted from here)

Good Morning,

Try using Accounts rather than AA, it should work then.


Thanks Simon.

Would it be appropriate to update the technical specification in a future release to replace “AA” with “Accounts”, such as in sections 2 (Class), 2.4 (FormSubmission/FormIdentifier)?

Thanks for you help.

Yes, all elements that require it (class / form identifier / category) should all show Accounts.