# Organization

object type

An organization — THE CONTAINER: a merchant's operating organization within its org group.

## Fields

| Field | Type | Notes |
| --- | --- | --- |
| `id` | [ID](/types/#scalars) `ID!` | No further notes. |
| `sysId` | [String](/types/#scalars) `String!` | The group-scoped human-facing system id (OR-…) — the account-number-style immutable org id. |
| `type` | [String](/types/#scalars) `String!` | No further notes. |
| `caption` | [String](/types/#scalars) `String!` | No further notes. |
| `status` | [String](/types/#scalars) `String!` | The FSM state: active \| parked \| suspended \| doomed. |
| `parentId` | [ID](/types/#scalars) `ID!` | The parent org group; for an Organization parentId === rootId. |
| `rootId` | [ID](/types/#scalars) `ID!` | The org-group family root. |
| `createdAt` | [String](/types/#scalars) `String!` | No further notes. |
| `updatedAt` | [String](/types/#scalars) `String!` | No further notes. |
| `revisionNum` | [Int](/types/#scalars) `Int!` | No further notes. |
| `revision` | [ID](/types/#scalars) `ID!` | The OCC revision token — supply it on every mutation of this record; rotates on every write. |
| `refCaptions` | [RefCaption](/types/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](/types/#scalars) `String!` | ISO-3166 country — the org's ONE locked jurisdiction. |
| `code` | [String](/types/#scalars) `String!` | Mutable human-readable organization code. |
| `legalName` | [String](/types/#scalars) `String!` | The registered legal name; the org IS the legal facility. |
| `brandName` | [String](/types/#scalars) | Optional trading brand name; absent = trades under the legal name. |
| `operatingAsName` | [String](/types/#scalars) | Optional operating-as / DBA name. |
| `owners` | [ID](/types/#scalars) `[ID!]!` | The owner Account ids; the composite create sets the creating principal's Account. |
| `costCentre` | [String](/types/#scalars) | 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](/types/#scalars) | The designated PRIMARY PhysicalFacility id. Null only on a pre-composite (bootstrap-seeded) org. |
| `defaultCurrency` | [String](/types/#scalars) | 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](/types/#scalars) | 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](/types/#scalars) | 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](/types/#scalars) | Whether the merchant completed Stripe-hosted onboarding (details_submitted). Stamped at provision + refresh. Null = unprovisioned. |
| `ownerVerifications` | [OwnerVerificationStanding](/types/OwnerVerificationStanding/) `[OwnerVerificationStanding!]!` | The owner seats' identity-verification standings. COMPLIANCE STATUS ONLY, never identity data — Stripe custodies the documents; the platform stores the outcome. |

## Used by

- [organization](/reference/reading-your-records/organization/)
- [provisionStripeAccount](/reference/organization-structure/provisionStripeAccount/)
- [refreshStripeAccountStatus](/reference/organization-structure/refreshStripeAccountStatus/)
- [updateOrganization](/reference/organization-structure/updateOrganization/)