Qodex.ai

Create new company

POST {{baseUrl}}/companies

Steps to create a new company in CAS 360.

  1. Create new company. This will create the basic details for the company and return a companyId which can be used for adding further details.
  2. Create Address. Creates an address in CAS 360 and returns an addressId. If the address already exists, the existing addressId will be returned.
  3. Create Company Address. Attach a new address to a CompanyId using adn AddressId. This includes Registered Office, Address, Business Address, Postal Address or Meeting Address.
  4. Create Contact. Creates a contact (officer, member, beneficial owner) in CAS 360 and returns a ContactId. If such contact already exists, the existing contactId will be returned without being modified.
  5. Create Company Officer. Create a company officer (Director or Secretary) using a ContactId.
  6. Create new share transaction. Create new share transaction for a given company.

Request Body

KeyDatatypeMandatoryConstraints
nameStringYes
numberStringNoMust be a valid ACN if jurisdiction is 'Australia'. Must be a valid NZCN if jurisdiction is 'New Zealand'.'
incorporationDateStringYesISO 8601 date https://en.wikipedia.org/wiki/ISO_8601
annualReviewDateStringYesISO 8601 date https://en.wikipedia.org/wiki/ISO_8601. This should be equal to incorporationDate + 12 months
businessNumberNumberNoABN / NZBN
registrationStateStringNoMust be one of 'ACT'/'NSW'/'VIC'/'QLD'/'SA'/'WA'/'TAS'/'NT'
jurisdictionStringYesCurrently only 'Australia' is allowed
typeObjectNoSee table below
agentIdStringNo
registeredbooleanNoFalse will be an unregistered company, if not specified will default to true

type object

Note: Within Australia, only certain combinations of companyType, companyClass and companySubClass are valid

KeyDatatypeMandatoryConstraints
companyTypeStringYesMust be one of 'Small Proprietary'/'Large Proprietary'/'Public Company'
companyClassStringYesMust be one of 'Limited by Shares'/'Limited by Guarantee'/'Limited by Shares and Guarantee'/'Unlimited'/'No Liability'
companySubClassStringYesMust be one of 'None'/'Superannuation Trustee Company'/'Non Profit Company'/'Home Unit Company'/'Listed'/'Unlisted'/'Section 150 License'/'Unlisted Non Profit

Request Body

{"name"=>"{{name}}", "number"=>"{{number}}", "incorporationDate"=>"{{incorporationDate}}", "annualReviewDate"=>"{{annualReviewDate}}", "registrationState"=>"{{registrationState}}", "jurisdiction"=>"{{jurisdiction}}", "registered"=>true, "type"=>{"companyClass"=>"{{companyClass}}", "companySubClass"=>"{{companySubClass}}", "companyType"=>"{{companyType}}"}}

HEADERS

KeyDatatypeRequiredDescription
Authorizationstring
Content-Typestring

RESPONSES

status: Created

{"agentId":null,"annualReviewDate":"2017-12-03","businessNumber":"123","id":"ef921aa4-b0f8-4ddd-a5b2-fb97fc9255f8","incorporationDate":"2016-12-18","jurisdiction":"Australia","name":"Test company ABC Pty Ltd","number":"550593336","registrationState":"VIC","registered":true,"type":{"companyClass":"Limited by Shares","companySubClass":"None","companyType":"Small Proprietary"}}