Skip to main content

Company party

The end-to-end journey for a COMPANY party, from the caller's perspective. For the shared status machine and entity-type matrix see the party overview; for the call contract see endpoints → parties.

A company is fully available, and is the only entity type that owns relationships — INDIVIDUAL members are attached to it.

End-to-end journey​

Provision drives the party PROSPECT → ACTIVE in a single call (see the party overview).

What differs for companies​

  • Owns relationships. A company is the only entity type with relationship routes. Each relationship attaches an INDIVIDUAL member with a relationshipType (e.g. DIRECTOR, SHAREHOLDER, BENEFICIAL_OWNER). All three relationship routes are scoped to the company partyId. The path party must be a COMPANY and the related party an INDIVIDUAL (wrong type → 404 PAR004001, deliberately not 409); linking a party to itself → 400 PAR000013.
  • Read shape. GET surfaces entityType: COMPANY with entityDetails carrying { acn, abn }; companyType, incorporationDate, and jurisdiction are not returned in this phase.