# Domain reference

This page lists domain fields and values. For the concept, see [Domains](/products/custody/v1.36/governance/domains). For operations, see [Manage domains](/products/custody/v1.36/governance/domains/manage-domains).

## Domain payload


```json
{
  "payload": {
    "id": "1f1e3d9c-f2bf-4a92-a0fa-4a825e70ecb4",
    "alias": "Operations",
    "lock": "Unlocked",
    "governingStrategy": "ConsiderDescendants",
    "permissions": {
      "readAccess": {
        "domains": ["admin"],
        "users": ["admin"],
        "accounts": ["admin"],
        "transactions": ["admin"],
        "policies": ["admin"],
        "endpoints": ["admin"],
        "requests": ["admin"],
        "events": ["admin"]
      }
    },
    "description": "Operations domain",
    "customProperties": {},
    "users": [],
    "policies": [],
    "type": "v0_CreateDomain"
  }
}
```

## Fields

| Field | Type | Required | Description |
|  --- | --- | --- | --- |
| `id` | UUID string | Yes | Unique domain identifier. |
| `alias` | string | Yes | Human-readable domain name. |
| `lock` | enum | Yes | `Unlocked` or `Locked`. |
| `governingStrategy` | enum | No | `ConsiderDescendants` or `CoerceDescendants`. |
| `permissions` | object | Yes | Read access by object type. |
| `description` | string | No | Domain description. |
| `customProperties` | object | Yes | String key-value metadata. Use `{}` when empty. |
| `users` | array | No | Users to create with the domain. |
| `policies` | array | No | Policies to create with the domain. |
| `childrenDomainIds` | array | No | Existing child domain IDs to reparent under the new domain. Include only for domain injection. |
| `type` | string | Yes | `v0_CreateDomain`. |


## Governing strategy values

| Value | Behavior |
|  --- | --- |
| `ConsiderDescendants` | Parent and child policies can both be considered. |
| `CoerceDescendants` | Matching parent policies override child policies. |


## Read access fields

| Field | Controls visibility of |
|  --- | --- |
| `domains` | Domain records and hierarchy. |
| `users` | User records and roles. |
| `accounts` | Account records and balances. |
| `transactions` | Transaction records. |
| `policies` | Policy definitions. |
| `endpoints` | Endpoint records. |
| `requests` | Intents and requests. |
| `events` | System events. |


## Lock values

| Value | Behavior |
|  --- | --- |
| `Unlocked` | Domain can operate. |
| `Locked` | Domain activity is disabled. |


For policy fields embedded in a domain payload, see [Policy reference](/products/custody/v1.36/governance/policies/reference).