Organization
object type
An organization — THE CONTAINER: a merchant's operating organization within its org group.
Fields
| Field | Type | Notes |
|---|---|---|
id | ID ID! | No further notes. |
sysId | String String! | The group-scoped human-facing system id (OR-…) — the account-number-style immutable org id. |
type | String String! | No further notes. |
caption | String String! | No further notes. |
status | String String! | The FSM state: active | parked | suspended | doomed. |
parentId | ID ID! | The parent org group; for an Organization parentId === rootId. |
rootId | ID ID! | The org-group family root. |
createdAt | String String! | No further notes. |
updatedAt | String String! | No further notes. |
revisionNum | Int Int! | No further notes. |
revision | ID ID! | The OCC revision token — supply it on every mutation of this record; rotates on every write. |
refCaptions | RefCaption [RefCaption!]! | The server-composed captions of this record's declared references (the referenced-caption rule): owners → the Account captions (caption ONLY — never email/loginName) · primaryPhysicalFacility → the PF caption · costCentre → the CostCentre caption (by sysId). |
jurisdiction | String String! | ISO-3166 country — the org's ONE locked jurisdiction. |
code | String String! | Mutable human-readable organization code. |
legalName | String String! | The registered legal name; the org IS the legal facility. |
brandName | String | Optional trading brand name; absent = trades under the legal name. |
operatingAsName | String | Optional operating-as / DBA name. |
owners | ID [ID!]! | The owner Account ids; the composite create sets the creating principal's Account. |
costCentre | String | The org's EXACTLY-ONE CostCentre sysId (CC-…) — kit-minted WITH the org; the envelope attribution anchor. Null only on a pre- org. |
primaryPhysicalFacility | ID | The designated PRIMARY PhysicalFacility id. Null only on a pre-composite (bootstrap-seeded) org. |
defaultCurrency | String | The org's DEFAULT trading currency. Optional — but an org may not SELECT a Style until it carries one, and every selected style's non-doomed Products must price it (CONFLICT/CURRENCY_FLOOR, the three-site closure). |
stripeAccountRef | String | The org's Stripe Connect account ref (acct_…, 'each org = a connected account') — KIT-STAMPED by provisionStripeAccount, IMMUTABLE once set (never caller-editable). Null = unprovisioned (card payments route the platform account). |
stripeChargesEnabled | Boolean | Whether the connected account can take DIRECT charges (charges_enabled; the applyTender card lane routes direct only when true). Stamped at provision + refreshStripeAccountStatus. Null = unprovisioned. |
stripeDetailsSubmitted | Boolean | Whether the merchant completed Stripe-hosted onboarding (details_submitted). Stamped at provision + refresh. Null = unprovisioned. |
ownerVerifications | OwnerVerificationStanding [OwnerVerificationStanding!]! | The owner seats' identity-verification standings. COMPLIANCE STATUS ONLY, never identity data — Stripe custodies the documents; the platform stores the outcome. |