Raise a corporate-secretarial request

Everything a founder can ask GVRN for once the company exists: a copy of a document, a change to the company's details, shareholders or directors, a resolution, a statutory filing, a tax registration, or anything else. Each one opens a ticket on GVRN's corporate-secretarial queue carrying the subject, the founder's own words and whatever the partner's form collected.

kind comes from the catalogue's requestKinds, whose suggestedFields say what that kind's form should collect into payload — advisory, never validated, since the partner owns its UI.

Files are base64 in the body, at most 5 of them and 10MB decoded across the request — a signed director's consent, the bank's wording for a certified copy. Each file's media type is detected from its bytes rather than taken from the request, so one whose type cannot be determined is refused by name and the whole request fails: a partner told its request was raised would otherwise have no way to tell which files landed. They are stored against the CRM ticket, where the operator working the request already looks; attachmentCount on every read confirms what arrived.

Only on a filed incorporation. A draft's members, entity and company details are all still editable through this API, so there is nothing to ask for until the company is filed.

GVRN does the work in its own systems; this API reports the request's status back and nothing more. A request is not a filing instruction and nothing is charged by raising one.