{
  "openapi": "3.1.2",
  "info": {
    "title": "Registry Write examples",
    "version": "1.0.0-draft",
    "description": "NON-NORMATIVE deployment profile illustrating Write operations for birth registrations,\nhouseholds, and individuals. It specialises the GovStack Digital Registries Write contract\nwithout adding shared domain obligations. Selected PublicSchema vocabulary and schemas are\nreferences; Write envelopes, review states, source commands, and request-local identifiers are\nexample conventions.\n\nBirth declaration and correction bodies are source commands, not the read Birth resource or an\naction log. After authoritative commit, accepted Birth content maps into a PublicSchema\n`crvs/Birth` projection. Pending, rejected, and blocked Change Requests have no authoritative\nRecord effect.\n\nThe example source owns one transaction boundary and exposes households and individuals as\nalternative Collection views. Only its declared compound Household create and add-member\nprofiles carry that cross-Record atomic guarantee. The profile does not imply multi-Registry\ntransactions, distributed atomicity, or a generic batch-write feature.\n",
    "contact": {
      "name": "GovStack Digital Registries Working Group",
      "url": "https://github.com/GovStackWorkingGroup/bb-digital-registries"
    },
    "x-govstack-api-guide": {
      "version": "0.3.0-draft",
      "rulesetVersion": "0.3.0-draft"
    }
  },
  "servers": [
    {
      "url": "https://registry.example",
      "description": "Reserved non-production deployment used only by these examples."
    }
  ],
  "tags": [
    {
      "name": "Direct Write examples",
      "description": "Source-backed direct commits using concrete example inputs."
    },
    {
      "name": "Change request examples",
      "description": "Immutable proposals with review and application state observed separately."
    }
  ],
  "paths": {
    "/v1/collections/birth-registrations/records": {
      "post": {
        "operationId": "createBirthRegistration",
        "summary": "Create a birth declaration directly",
        "description": "Commits a declaration command and maps accepted Birth content into the authoritative PublicSchema Birth projection. Evidence and reasons remain source-command annotations, not Birth event fields.",
        "tags": [
          "Direct Write examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:record:create"
            ]
          }
        ],
        "x-govstack-digital-registries-write": {
          "registry": "https://registry.example/registries/example",
          "collection": "birth-registrations",
          "capability": "create",
          "inputSchema": "./write-examples.schema.json#/$defs/BirthDeclarationCreateInput"
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Source declaration command mapped to a PublicSchema Birth projection.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BirthDeclarationCreateInput"
              },
              "example": {
                "data": {
                  "transactionId": "tx-birth-declaration-001",
                  "birth": {
                    "@context": "https://publicschema.org/ctx/draft.jsonld",
                    "@id": "urn:request-local:birth-event",
                    "@type": "https://publicschema.org/crvs/Birth",
                    "event_date": "2026-10-30",
                    "child": {
                      "@type": "https://publicschema.org/crvs/Person",
                      "person": {
                        "@id": "urn:request-local:child",
                        "@type": "https://publicschema.org/Person",
                        "given_name": "Nok",
                        "family_name": "Example"
                      }
                    },
                    "parents": [
                      {
                        "@type": "https://publicschema.org/crvs/Parent",
                        "person": "https://registry.example/v1/collections/individuals/records/person_42",
                        "parental_role": "gestational"
                      }
                    ],
                    "sex_at_birth": "female"
                  },
                  "annotation": {
                    "reasonCode": "initial_declaration",
                    "statement": "Birth declared by the recorded informant."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/BirthRecordCreated"
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/WriteCollectionNotAvailable"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "415": {
            "$ref": "#/components/responses/WriteUnsupportedMediaType"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableContent"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    },
    "/v1/collections/households/records": {
      "post": {
        "operationId": "createHousehold",
        "summary": "Create a Household directly",
        "description": "Commits a Household with existing Person URI references or, only in the declared same-source compound profile, embedded new Persons with request-local `@id` values committed atomically.",
        "tags": [
          "Direct Write examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:record:create"
            ]
          }
        ],
        "x-govstack-digital-registries-write": {
          "registry": "https://registry.example/registries/example",
          "collection": "households",
          "capability": "create",
          "inputSchema": "./write-examples.schema.json#/$defs/HouseholdCreateInput"
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Existing-reference or explicitly atomic compound Household create input.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/HouseholdCreateInput"
              },
              "example": {
                "data": {
                  "@context": "https://publicschema.org/ctx/draft.jsonld",
                  "@id": "urn:request-local:household-existing",
                  "@type": "https://publicschema.org/Household",
                  "name": "Example household",
                  "group_type": "household",
                  "memberships": [
                    {
                      "person": "https://registry.example/v1/collections/individuals/records/person_42",
                      "group": "urn:request-local:household-existing",
                      "role": "head",
                      "start_date": "2026-10-01",
                      "is_active": true
                    }
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/HouseholdRecordCreated"
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/WriteCollectionNotAvailable"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "415": {
            "$ref": "#/components/responses/WriteUnsupportedMediaType"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableContent"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    },
    "/v1/collections/individuals/records": {
      "post": {
        "operationId": "createIndividual",
        "summary": "Create a Person directly",
        "description": "Commits an individual using the PublicSchema Person field vocabulary.",
        "tags": [
          "Direct Write examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:record:create"
            ]
          }
        ],
        "x-govstack-digital-registries-write": {
          "registry": "https://registry.example/registries/example",
          "collection": "individuals",
          "capability": "create",
          "inputSchema": "./write-examples.schema.json#/$defs/IndividualCreateInput"
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Concrete PublicSchema Person create input.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/IndividualCreateInput"
              },
              "example": {
                "data": {
                  "@context": "https://publicschema.org/ctx/draft.jsonld",
                  "@type": "https://publicschema.org/Person",
                  "given_name": "Somchai",
                  "family_name": "Example",
                  "date_of_birth": "1990-02-12"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/IndividualRecordCreated"
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/WriteCollectionNotAvailable"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "415": {
            "$ref": "#/components/responses/WriteUnsupportedMediaType"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableContent"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    },
    "/v1/collections/individuals/records/{recordId}": {
      "get": {
        "operationId": "retrieveIndividualForWrite",
        "summary": "Retrieve the permitted Person view used for conditional update",
        "description": "Returns the permitted individual-write companion view of the current authoritative Person record. Artifact validation checks the declared strong ETag handoff, not runtime authority or projection currency.",
        "tags": [
          "Direct Write examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:record:read"
            ]
          }
        ],
        "x-govstack-digital-registries": {
          "registry": "https://registry.example/registries/example",
          "collection": "individuals",
          "capability": "retrieve",
          "view": "individual-write",
          "features": [
            "conditional-read"
          ]
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/RecordId"
          },
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IfNoneMatch"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/Record"
          },
          "304": {
            "$ref": "#/components/responses/NotModified"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/RecordNotAvailable"
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        }
      },
      "patch": {
        "operationId": "updateRecord",
        "summary": "Apply a merge patch to a Person directly",
        "description": "Applies an RFC 7396 JSON Merge Patch to the writable Person projection. Send the target Record's strong validator in `If-Match`. A synchronous commit returns bodyless `204` with the new strong `ETag`.",
        "tags": [
          "Direct Write examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:record:update"
            ]
          }
        ],
        "x-govstack-digital-registries-write": {
          "registry": "https://registry.example/registries/example",
          "collection": "individuals",
          "capability": "update",
          "inputSchema": "./write-examples.schema.json#/$defs/IndividualUpdateInput",
          "inputMediaType": "application/merge-patch+json",
          "companionRead": {
            "operationId": "retrieveIndividualForWrite",
            "view": "individual-write"
          }
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/RecordId"
          },
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IfMatch"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Closed merge-patch subset of the Person projection.",
          "content": {
            "application/merge-patch+json": {
              "schema": {
                "$ref": "#/components/schemas/IndividualUpdateInput"
              },
              "example": {
                "data": {
                  "preferred_name": "Som"
                }
              }
            }
          }
        },
        "responses": {
          "204": {
            "description": "Person updated and committed; response is bodyless.",
            "headers": {
              "ETag": {
                "$ref": "#/components/headers/StrongETag"
              },
              "Cache-Control": {
                "$ref": "#/components/headers/WriteCacheControl"
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/WriteRecordNotAvailable"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "412": {
            "$ref": "#/components/responses/PreconditionFailed"
          },
          "415": {
            "$ref": "#/components/responses/WriteUnsupportedMediaType"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableContent"
          },
          "428": {
            "$ref": "#/components/responses/PreconditionRequired"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    },
    "/v1/collections/birth-registrations/records/{recordId}": {
      "get": {
        "operationId": "retrieveBirthRegistrationForWrite",
        "summary": "Retrieve the permitted Birth view used for correction",
        "description": "Returns the permitted birth-registration-write companion view of the current authoritative Birth record. Artifact validation checks the declared strong ETag handoff, not runtime authority or projection currency.",
        "tags": [
          "Direct Write examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:record:read"
            ]
          }
        ],
        "x-govstack-digital-registries": {
          "registry": "https://registry.example/registries/example",
          "collection": "birth-registrations",
          "capability": "retrieve",
          "view": "birth-registration-write",
          "features": [
            "conditional-read"
          ]
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/RecordId"
          },
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IfNoneMatch"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/Record"
          },
          "304": {
            "$ref": "#/components/responses/NotModified"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/RecordNotAvailable"
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        }
      }
    },
    "/v1/collections/birth-registrations/records/{recordId}/correct-birth": {
      "post": {
        "operationId": "correctBirth",
        "summary": "Apply a birth correction directly",
        "description": "Applies the fixed `correct-birth` transition. Send the authoritative birth-registration Record's strong validator in `If-Match`. `parameters.birthPatch` names PublicSchema Birth projection fields, while `annotation` carries source-command reasons and evidence. The projection changes only after commit.",
        "tags": [
          "Direct Write examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:record:transition"
            ]
          }
        ],
        "x-govstack-digital-registries-write": {
          "registry": "https://registry.example/registries/example",
          "collection": "birth-registrations",
          "capability": "transition",
          "inputSchema": "./write-examples.schema.json#/$defs/BirthCorrectionInput",
          "action": "correct-birth",
          "transitionProfile": "publicschema-birth-correction",
          "companionRead": {
            "operationId": "retrieveBirthRegistrationForWrite",
            "view": "birth-registration-write"
          }
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/RecordId"
          },
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IfMatch"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Fixed correction command mapped to the eventual PublicSchema Birth view.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BirthCorrectionInput"
              },
              "example": {
                "name": "correct-birth",
                "parameters": {
                  "transactionId": "tx-birth-correction-direct-001",
                  "birthPatch": {
                    "event_location": {
                      "location_name": "Corrected District Hospital"
                    }
                  },
                  "annotation": {
                    "reasonCode": "clerical_error",
                    "statement": "Correct the place of occurrence from the supporting facility record.",
                    "supportingEvidence": [
                      {
                        "evidenceType": "facility_record",
                        "reference": "https://registry.example/evidence/facility_record_991",
                        "issuedAt": "2026-10-30T09:30:00Z"
                      }
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/BirthTransitionApplied"
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/WriteRecordNotAvailable"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "412": {
            "$ref": "#/components/responses/PreconditionFailed"
          },
          "415": {
            "$ref": "#/components/responses/WriteUnsupportedMediaType"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableContent"
          },
          "428": {
            "$ref": "#/components/responses/PreconditionRequired"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    },
    "/v1/collections/households/records/{recordId}": {
      "get": {
        "operationId": "retrieveHouseholdForWrite",
        "summary": "Retrieve the permitted Household view used for membership changes",
        "description": "Returns the permitted household-write companion view of the current authoritative Household record. Artifact validation checks the declared strong ETag handoff, not runtime authority or projection currency.",
        "tags": [
          "Direct Write examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:record:read"
            ]
          }
        ],
        "x-govstack-digital-registries": {
          "registry": "https://registry.example/registries/example",
          "collection": "households",
          "capability": "retrieve",
          "view": "household-write",
          "features": [
            "conditional-read"
          ]
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/RecordId"
          },
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IfNoneMatch"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/Record"
          },
          "304": {
            "$ref": "#/components/responses/NotModified"
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/RecordNotAvailable"
          },
          "406": {
            "$ref": "#/components/responses/NotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/TooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/InternalError"
          },
          "503": {
            "$ref": "#/components/responses/ServiceUnavailable"
          }
        }
      }
    },
    "/v1/collections/households/records/{recordId}/add-member": {
      "post": {
        "operationId": "addHouseholdMember",
        "summary": "Add an existing or newly declared Person to a Household",
        "description": "Applies the fixed `add-member` transition. An existing Person uses an absolute Record URI. This profile also accepts an embedded Person with a request-local `@id` under its declared same-source atomic transaction. This is not a portable multi-Registry transaction guarantee.",
        "tags": [
          "Direct Write examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:record:transition"
            ]
          }
        ],
        "x-govstack-digital-registries-write": {
          "registry": "https://registry.example/registries/example",
          "collection": "households",
          "capability": "transition",
          "inputSchema": "./write-examples.schema.json#/$defs/HouseholdAddMemberInput",
          "action": "add-member",
          "transitionProfile": "publicschema-household-add-member",
          "companionRead": {
            "operationId": "retrieveHouseholdForWrite",
            "view": "household-write"
          }
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/RecordId"
          },
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IfMatch"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "One PublicSchema GroupMembership with an existing URI or embedded new Person.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/HouseholdAddMemberInput"
              },
              "example": {
                "name": "add-member",
                "parameters": {
                  "membership": {
                    "person": "https://registry.example/v1/collections/individuals/records/person_88",
                    "group": "https://registry.example/v1/collections/households/records/household_8",
                    "role": "child",
                    "start_date": "2026-11-04",
                    "is_active": true
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/HouseholdTransitionApplied"
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/WriteRecordNotAvailable"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "412": {
            "$ref": "#/components/responses/PreconditionFailed"
          },
          "415": {
            "$ref": "#/components/responses/WriteUnsupportedMediaType"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableContent"
          },
          "428": {
            "$ref": "#/components/responses/PreconditionRequired"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    },
    "/v1/change-requests": {
      "post": {
        "operationId": "submitChangeRequest",
        "summary": "Submit a PublicSchema-profile change proposal",
        "description": "Creates an immutable pending proposal with the corresponding direct operation's concrete input and no authoritative Record effect. Transition proposals carry the target Record's strong `baseETag`; later review `If-Match` guards the Change Request representation and is a separate precondition.",
        "tags": [
          "Change request examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:change-request:submit"
            ]
          }
        ],
        "x-govstack-digital-registries-write": {
          "registry": "https://registry.example/registries/example",
          "capability": "change-requests",
          "inputSchema": "./write-examples.schema.json#/$defs/PublicSchemaChangeRequestInput"
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": true,
          "description": "Concrete create or transition proposal for this deployment.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/PublicSchemaChangeRequestInput"
              },
              "example": {
                "kind": "transition",
                "target": {
                  "collectionId": "birth-registrations",
                  "recordId": "birth_19"
                },
                "baseETag": "\"birth-v8\"",
                "input": {
                  "name": "correct-birth",
                  "parameters": {
                    "transactionId": "tx-birth-correction-review-001",
                    "birthPatch": {
                      "event_location": {
                        "location_name": "North District Hospital"
                      }
                    },
                    "annotation": {
                      "reasonCode": "clerical_error",
                      "statement": "Correct from the facility record."
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "$ref": "#/components/responses/ChangeRequestCreated"
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/TargetNotAvailable"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "415": {
            "$ref": "#/components/responses/WriteUnsupportedMediaType"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableContent"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    },
    "/v1/change-requests/{changeRequestId}": {
      "get": {
        "operationId": "getChangeRequest",
        "summary": "Retrieve a PublicSchema-profile change request",
        "description": "Returns the immutable proposal with independent review and application states.",
        "tags": [
          "Change request examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:change-request:read"
            ]
          }
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/ChangeRequestId"
          },
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IfNoneMatch"
          }
        ],
        "responses": {
          "200": {
            "$ref": "#/components/responses/ChangeRequest"
          },
          "304": {
            "$ref": "#/components/responses/WriteNotModified"
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/ChangeRequestNotAvailable"
          },
          "406": {
            "$ref": "#/components/responses/WriteNotAcceptable"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    },
    "/v1/change-requests/{changeRequestId}/approve": {
      "post": {
        "operationId": "approveChangeRequest",
        "summary": "Approve the exact PublicSchema-profile proposal version",
        "description": "`If-Match` guards the Change Request. Approval records only the review decision and returns `applicationState: not-started`. A separately authorised worker may later attempt the authoritative commit, where stored `baseETag` independently guards the target Record.",
        "tags": [
          "Change request examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:change-request:review"
            ]
          }
        ],
        "x-govstack-digital-registries-write": {
          "registry": "https://registry.example/registries/example",
          "capability": "change-requests"
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/ChangeRequestId"
          },
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IfMatch"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReviewDecisionInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ChangeRequestApproved"
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/ChangeRequestNotAvailable"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "412": {
            "$ref": "#/components/responses/PreconditionFailed"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableContent"
          },
          "428": {
            "$ref": "#/components/responses/PreconditionRequired"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    },
    "/v1/change-requests/{changeRequestId}/reject": {
      "post": {
        "operationId": "rejectChangeRequest",
        "summary": "Reject the exact PublicSchema-profile proposal version",
        "description": "Rejects the proposal selected by strong `If-Match` without changing any Record.",
        "tags": [
          "Change request examples"
        ],
        "security": [
          {
            "serviceOAuth": [
              "bb:digital-registries:change-request:review"
            ]
          }
        ],
        "x-govstack-digital-registries-write": {
          "registry": "https://registry.example/registries/example",
          "capability": "change-requests"
        },
        "parameters": [
          {
            "$ref": "#/components/parameters/ChangeRequestId"
          },
          {
            "$ref": "#/components/parameters/Traceparent"
          },
          {
            "$ref": "#/components/parameters/IfMatch"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ReviewDecisionInput"
              }
            }
          }
        },
        "responses": {
          "200": {
            "$ref": "#/components/responses/ChangeRequestRejected"
          },
          "400": {
            "$ref": "#/components/responses/WriteBadRequest"
          },
          "401": {
            "$ref": "#/components/responses/WriteUnauthorized"
          },
          "403": {
            "$ref": "#/components/responses/WriteForbidden"
          },
          "404": {
            "$ref": "#/components/responses/ChangeRequestNotAvailable"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "412": {
            "$ref": "#/components/responses/PreconditionFailed"
          },
          "422": {
            "$ref": "#/components/responses/UnprocessableContent"
          },
          "428": {
            "$ref": "#/components/responses/PreconditionRequired"
          },
          "429": {
            "$ref": "#/components/responses/WriteTooManyRequests"
          },
          "500": {
            "$ref": "#/components/responses/WriteInternalError"
          },
          "503": {
            "$ref": "#/components/responses/WriteServiceUnavailable"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "serviceOAuth": {
        "type": "oauth2",
        "description": "Confidential inter-BB client credentials. Tokens are audience- and scope-restricted; sender-constrained access tokens are recommended.",
        "flows": {
          "clientCredentials": {
            "tokenUrl": "https://identity.example/token",
            "scopes": {
              "bb:digital-registries:record:read": "Read an authorised write-capable Record view.",
              "bb:digital-registries:record:create": "Attempt authorised direct Record creation.",
              "bb:digital-registries:record:update": "Attempt authorised direct Record update.",
              "bb:digital-registries:record:transition": "Attempt an authorised named Record transition.",
              "bb:digital-registries:change-request:submit": "Submit an authorised immutable proposal.",
              "bb:digital-registries:change-request:read": "Read caller-visible proposals and states.",
              "bb:digital-registries:change-request:review": "Approve or reject an exact proposal version.",
              "bb:digital-registries:change-request:withdraw": "Withdraw a proposal when policy permits.",
              "bb:digital-registries:change-request:apply": "Execute an approved proposal under current policy.",
              "bb:digital-registries:operation:read": "Read caller-visible asynchronous operation state."
            }
          }
        }
      }
    },
    "parameters": {
      "CollectionId": {
        "name": "collectionId",
        "in": "path",
        "required": true,
        "description": "Concrete collection selected by this profile.",
        "schema": {
          "type": "string",
          "enum": [
            "birth-registrations",
            "households",
            "individuals"
          ]
        }
      },
      "Traceparent": {
        "name": "traceparent",
        "in": "header",
        "required": false,
        "description": "W3C Trace Context. Propagate valid context; create context when absent or invalid. Problem traceId is the effective trace-id. Trace metadata excludes personal data.",
        "schema": {
          "type": "string"
        }
      },
      "IdempotencyKey": {
        "name": "Idempotency-Key",
        "in": "header",
        "required": true,
        "description": "Opaque, client-generated, high-entropy Structured Field String, including quotation marks, with at most 200 characters inside them; UUID values are recommended. Replay lookup binds the method, canonical target URI, authenticated client, tenant or equivalent authorisation partition, and effective trusted purpose. The fingerprint binds the method, canonical target URI, content type, canonical body, and every declared semantic header. A missing, malformed, or oversized key returns `400` before processing. The deployment publishes `idempotencyReplayWindow`; after expiry, it may process the key as new only if its profile permits. Within the window, a completed matching retry returns the original status, body, `Content-Type`, and `Location`, with per-attempt headers regenerated. Fingerprint mismatch returns `422`; a matching in-flight retry returns `409`. Before disclosing a stored result, the service rechecks current authorisation, effective trusted purpose, and disclosure policy. A purpose change cannot select the stored result because purpose is in the lookup scope. The key never preserves or creates a grant.",
        "schema": {
          "type": "string",
          "minLength": 3,
          "maxLength": 202,
          "pattern": "^\"(?:[\\x20-\\x21\\x23-\\x5B\\x5D-\\x7E]|\\\\[\"\\\\]){1,200}\"$"
        },
        "example": "\"018f47d2-4c42-7ca4-bf47-2bd31f88b922\""
      },
      "RecordId": {
        "name": "recordId",
        "in": "path",
        "required": true,
        "description": "Stable opaque identifier within the selected registry, encoded as one path segment.",
        "schema": {
          "$ref": "#/components/schemas/RecordId"
        }
      },
      "IfNoneMatch": {
        "name": "If-None-Match",
        "in": "header",
        "required": false,
        "description": "Conditional request against the selected representation's ETag. Authorisation precedes evaluation of the validator.",
        "schema": {
          "type": "string"
        }
      },
      "IfMatch": {
        "name": "If-Match",
        "in": "header",
        "required": true,
        "description": "One strong `ETag` for the target representation; weak validators and wildcards are not accepted. For a Record mutation, the service compares the companion guard atomically with commit and returns generic `412` on mismatch without disclosing which guard state changed. For review, it guards the Change Request, not the proposal's `baseETag`, which guards the source Record at commit.",
        "schema": {
          "$ref": "#/components/schemas/StrongETag"
        }
      },
      "ChangeRequestId": {
        "name": "changeRequestId",
        "in": "path",
        "required": true,
        "description": "Opaque change-request identifier encoded as one path segment.",
        "schema": {
          "$ref": "#/components/schemas/OpaqueId"
        }
      }
    },
    "schemas": {
      "BirthDeclarationCreateInput": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/BirthDeclarationCommand",
            "description": "Domain data submitted to the selected concrete Write operation."
          },
          "source": {
            "$ref": "#/components/schemas/SourceReference-2",
            "description": "Optional authoritative-source correlation metadata defined by the shared Write contract."
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false,
        "description": "Direct or governed birth-declaration command mapped to a PublicSchema Birth projection after commit."
      },
      "BirthCorrectionInput": {
        "type": "object",
        "properties": {
          "name": {
            "const": "correct-birth",
            "description": "Fixed published name of the selected transition; it is not a runtime action selector.",
            "type": "string"
          },
          "parameters": {
            "$ref": "#/components/schemas/BirthCorrectionCommand",
            "description": "Typed parameters for the fixed transition operation."
          },
          "source": {
            "$ref": "#/components/schemas/SourceReference-2",
            "description": "Optional authoritative-source correlation metadata defined by the shared Write contract."
          }
        },
        "required": [
          "name",
          "parameters"
        ],
        "additionalProperties": false,
        "description": "Fixed correct-birth transition input carrying a closed Birth patch and command annotation."
      },
      "HouseholdExistingCreateInput": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/HouseholdWithExistingPersons",
            "description": "Domain data submitted to the selected concrete Write operation."
          },
          "source": {
            "$ref": "#/components/schemas/SourceReference-2",
            "description": "Optional authoritative-source correlation metadata defined by the shared Write contract."
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false,
        "description": "Household create input whose memberships reference existing Person records."
      },
      "HouseholdCompoundCreateInput": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/HouseholdCompoundCreate",
            "description": "Domain data submitted to the selected concrete Write operation."
          },
          "source": {
            "$ref": "#/components/schemas/SourceReference-2",
            "description": "Optional authoritative-source correlation metadata defined by the shared Write contract."
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false,
        "description": "Same-source atomic Household create input containing at least one request-local new Person."
      },
      "HouseholdCreateInput": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/HouseholdExistingCreateInput",
            "description": "Alternative 1 for household create input."
          },
          {
            "$ref": "#/components/schemas/HouseholdCompoundCreateInput",
            "description": "Alternative 2 for household create input."
          }
        ],
        "description": "Supported Household create alternatives for existing or newly embedded Persons."
      },
      "HouseholdAddMemberInput": {
        "type": "object",
        "properties": {
          "name": {
            "const": "add-member",
            "description": "Fixed published name of the selected transition; it is not a runtime action selector.",
            "type": "string"
          },
          "parameters": {
            "$ref": "#/components/schemas/HouseholdAddMemberParameters",
            "description": "Typed parameters for the fixed transition operation."
          },
          "source": {
            "$ref": "#/components/schemas/SourceReference-2",
            "description": "Optional authoritative-source correlation metadata defined by the shared Write contract."
          }
        },
        "required": [
          "name",
          "parameters"
        ],
        "additionalProperties": false,
        "description": "Fixed add-member transition input for an existing Household target."
      },
      "IndividualCreateInput": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/IndividualCreateData",
            "description": "Domain data submitted to the selected concrete Write operation."
          },
          "source": {
            "$ref": "#/components/schemas/SourceReference-2",
            "description": "Optional authoritative-source correlation metadata defined by the shared Write contract."
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false,
        "description": "Independent Person create input that leaves authority-owned identity fields unset."
      },
      "IndividualUpdateInput": {
        "type": "object",
        "description": "RFC 7396 merge patch over the selected PublicSchema Person projection.",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "preferred_name": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/preferred_name",
                    "description": "Alternative 1 for preferred name."
                  },
                  {
                    "type": "null",
                    "description": "Alternative 2 for preferred name."
                  }
                ],
                "description": "PublicSchema `preferred_name` value retained with its published spelling and domain meaning."
              },
              "phone_number": {
                "type": [
                  "string",
                  "null"
                ],
                "pattern": "^\\+[1-9]\\d{1,14}$",
                "description": "Nullable E.164 international telephone number; null removes the existing value."
              },
              "email_address": {
                "type": [
                  "string",
                  "null"
                ],
                "format": "email",
                "description": "Nullable email address; null removes the existing value."
              }
            },
            "minProperties": 1,
            "additionalProperties": false,
            "description": "Domain data submitted to the selected concrete Write operation."
          }
        },
        "required": [
          "data"
        ],
        "additionalProperties": false
      },
      "PublicSchemaChangeRequestInput": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/CreateChangeRequest",
            "description": "Alternative 1 for public schema change request input."
          },
          {
            "$ref": "#/components/schemas/TransitionChangeRequest",
            "description": "Alternative 2 for public schema change request input."
          }
        ],
        "description": "Strict proposal request correlated to a concrete create or transition profile input."
      },
      "PublicSchemaChangeRequest": {
        "type": "object",
        "properties": {
          "changeRequestId": {
            "type": "string",
            "minLength": 1,
            "description": "Authority-assigned identifier for the immutable change request."
          },
          "proposalVersion": {
            "type": "integer",
            "minimum": 1,
            "description": "Monotonically increasing representation version guarded by review If-Match."
          },
          "kind": {
            "enum": [
              "create",
              "transition"
            ],
            "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
            "type": "string"
          },
          "target": {
            "oneOf": [
              {
                "type": "object",
                "properties": {
                  "collectionId": {
                    "enum": [
                      "birth-registrations",
                      "households",
                      "individuals"
                    ],
                    "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                    "type": "string"
                  }
                },
                "required": [
                  "collectionId"
                ],
                "additionalProperties": false,
                "description": "Alternative 1 for target."
              },
              {
                "type": "object",
                "properties": {
                  "collectionId": {
                    "enum": [
                      "birth-registrations",
                      "households"
                    ],
                    "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                    "type": "string"
                  },
                  "recordId": {
                    "$ref": "#/components/schemas/RecordId"
                  }
                },
                "required": [
                  "collectionId",
                  "recordId"
                ],
                "additionalProperties": false,
                "description": "Alternative 2 for target."
              }
            ],
            "description": "Collection and, when applicable, Record selected by the proposal."
          },
          "baseETag": {
            "$ref": "#/components/schemas/StrongETag-2",
            "description": "Strong target Record validator checked by the independently authorised application worker at commit."
          },
          "input": {
            "type": "object",
            "description": "Concrete typed input that would be used by the corresponding direct operation."
          },
          "reviewState": {
            "enum": [
              "pending",
              "approved",
              "rejected",
              "withdrawn"
            ],
            "description": "Review state: pending awaits a decision, approved or rejected records that decision, and withdrawn records submitter withdrawal.",
            "type": "string"
          },
          "applicationState": {
            "enum": [
              "not-started",
              "applying",
              "applied",
              "blocked",
              "failed"
            ],
            "description": "Application state: not-started has no authoritative effect, applying is in progress, applied committed, and blocked or failed did not commit.",
            "type": "string"
          },
          "result": {
            "$ref": "#/components/schemas/PublicSchemaWriteResult",
            "description": "Authoritative Write result present only after successful application."
          },
          "error": {
            "$ref": "#/components/schemas/ProcessingError",
            "description": "Processing error present only when authoritative application is blocked or failed."
          },
          "submittedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "Z$",
            "description": "UTC instant at which the change request was submitted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "Z$",
            "description": "UTC instant at which the change-request representation last changed."
          }
        },
        "required": [
          "changeRequestId",
          "proposalVersion",
          "kind",
          "target",
          "input",
          "reviewState",
          "applicationState",
          "submittedAt",
          "updatedAt"
        ],
        "allOf": [
          {
            "if": {
              "properties": {
                "kind": {
                  "const": "create",
                  "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
                  "type": "string"
                }
              },
              "required": [
                "kind"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "properties": {
                "target": {
                  "type": "object",
                  "properties": {
                    "collectionId": {
                      "enum": [
                        "birth-registrations",
                        "households",
                        "individuals"
                      ],
                      "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "collectionId"
                  ],
                  "additionalProperties": false,
                  "description": "Collection and, when applicable, Record selected by the proposal."
                },
                "input": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/BirthDeclarationCreateInput",
                      "description": "Alternative 1 for input."
                    },
                    {
                      "$ref": "#/components/schemas/HouseholdExistingCreateInput",
                      "description": "Alternative 2 for input."
                    },
                    {
                      "$ref": "#/components/schemas/HouseholdCompoundCreateInput",
                      "description": "Alternative 3 for input."
                    },
                    {
                      "$ref": "#/components/schemas/IndividualCreateInput",
                      "description": "Alternative 4 for input."
                    }
                  ],
                  "description": "Concrete typed input that would be used by the corresponding direct operation."
                }
              },
              "not": {
                "required": [
                  "baseETag"
                ],
                "description": "Forbidden field combination for public schema change request."
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 1 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "kind": {
                  "const": "transition",
                  "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
                  "type": "string"
                }
              },
              "required": [
                "kind"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "required": [
                "baseETag"
              ],
              "properties": {
                "target": {
                  "type": "object",
                  "properties": {
                    "collectionId": {
                      "enum": [
                        "birth-registrations",
                        "households"
                      ],
                      "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                      "type": "string"
                    },
                    "recordId": {
                      "$ref": "#/components/schemas/RecordId"
                    }
                  },
                  "required": [
                    "collectionId",
                    "recordId"
                  ],
                  "additionalProperties": false,
                  "description": "Collection and, when applicable, Record selected by the proposal."
                },
                "input": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/BirthCorrectionInput",
                      "description": "Alternative 1 for input."
                    },
                    {
                      "$ref": "#/components/schemas/HouseholdAddMemberInput",
                      "description": "Alternative 2 for input."
                    }
                  ],
                  "description": "Concrete typed input that would be used by the corresponding direct operation."
                }
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 2 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "kind": {
                  "const": "create",
                  "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
                  "type": "string"
                },
                "target": {
                  "properties": {
                    "collectionId": {
                      "const": "birth-registrations",
                      "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "collectionId"
                  ],
                  "description": "Collection and, when applicable, Record selected by the proposal."
                }
              },
              "required": [
                "kind",
                "target"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "properties": {
                "input": {
                  "$ref": "#/components/schemas/BirthDeclarationCreateInput",
                  "description": "Concrete typed input that would be used by the corresponding direct operation."
                }
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 3 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "kind": {
                  "const": "create",
                  "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
                  "type": "string"
                },
                "target": {
                  "properties": {
                    "collectionId": {
                      "const": "households",
                      "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "collectionId"
                  ],
                  "description": "Collection and, when applicable, Record selected by the proposal."
                }
              },
              "required": [
                "kind",
                "target"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "properties": {
                "input": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/HouseholdExistingCreateInput",
                      "description": "Alternative 1 for input."
                    },
                    {
                      "$ref": "#/components/schemas/HouseholdCompoundCreateInput",
                      "description": "Alternative 2 for input."
                    }
                  ],
                  "description": "Concrete typed input that would be used by the corresponding direct operation."
                }
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 4 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "kind": {
                  "const": "create",
                  "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
                  "type": "string"
                },
                "target": {
                  "properties": {
                    "collectionId": {
                      "const": "individuals",
                      "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "collectionId"
                  ],
                  "description": "Collection and, when applicable, Record selected by the proposal."
                }
              },
              "required": [
                "kind",
                "target"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "properties": {
                "input": {
                  "$ref": "#/components/schemas/IndividualCreateInput",
                  "description": "Concrete typed input that would be used by the corresponding direct operation."
                }
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 5 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "kind": {
                  "const": "transition",
                  "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
                  "type": "string"
                },
                "target": {
                  "properties": {
                    "collectionId": {
                      "const": "birth-registrations",
                      "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "collectionId"
                  ],
                  "description": "Collection and, when applicable, Record selected by the proposal."
                }
              },
              "required": [
                "kind",
                "target"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "properties": {
                "input": {
                  "$ref": "#/components/schemas/BirthCorrectionInput",
                  "description": "Concrete typed input that would be used by the corresponding direct operation."
                }
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 6 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "kind": {
                  "const": "transition",
                  "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
                  "type": "string"
                },
                "target": {
                  "properties": {
                    "collectionId": {
                      "const": "households",
                      "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "collectionId"
                  ],
                  "description": "Collection and, when applicable, Record selected by the proposal."
                }
              },
              "required": [
                "kind",
                "target"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "properties": {
                "input": {
                  "$ref": "#/components/schemas/HouseholdAddMemberInput",
                  "description": "Concrete typed input that would be used by the corresponding direct operation."
                }
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 7 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "reviewState": {
                  "enum": [
                    "pending",
                    "rejected",
                    "withdrawn"
                  ],
                  "description": "Review state: pending awaits a decision, approved or rejected records that decision, and withdrawn records submitter withdrawal.",
                  "type": "string"
                }
              },
              "required": [
                "reviewState"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "properties": {
                "applicationState": {
                  "const": "not-started",
                  "description": "Application state: not-started has no authoritative effect, applying is in progress, applied committed, and blocked or failed did not commit.",
                  "type": "string"
                }
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 8 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "applicationState": {
                  "const": "applied",
                  "description": "Application state: not-started has no authoritative effect, applying is in progress, applied committed, and blocked or failed did not commit.",
                  "type": "string"
                }
              },
              "required": [
                "applicationState"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "required": [
                "result"
              ],
              "properties": {
                "reviewState": {
                  "const": "approved",
                  "description": "Review state: pending awaits a decision, approved or rejected records that decision, and withdrawn records submitter withdrawal.",
                  "type": "string"
                }
              },
              "not": {
                "required": [
                  "error"
                ],
                "description": "Forbidden field combination for public schema change request."
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 9 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "applicationState": {
                  "enum": [
                    "blocked",
                    "failed"
                  ],
                  "description": "Application state: not-started has no authoritative effect, applying is in progress, applied committed, and blocked or failed did not commit.",
                  "type": "string"
                }
              },
              "required": [
                "applicationState"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "required": [
                "error"
              ],
              "properties": {
                "reviewState": {
                  "const": "approved",
                  "description": "Review state: pending awaits a decision, approved or rejected records that decision, and withdrawn records submitter withdrawal.",
                  "type": "string"
                }
              },
              "not": {
                "required": [
                  "result"
                ],
                "description": "Forbidden field combination for public schema change request."
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 10 for public schema change request; every composed constraint applies."
          },
          {
            "if": {
              "properties": {
                "applicationState": {
                  "enum": [
                    "not-started",
                    "applying"
                  ],
                  "description": "Application state: not-started has no authoritative effect, applying is in progress, applied committed, and blocked or failed did not commit.",
                  "type": "string"
                }
              },
              "required": [
                "applicationState"
              ],
              "description": "Condition selecting the correlated public schema change request response or proposal constraint."
            },
            "then": {
              "not": {
                "anyOf": [
                  {
                    "required": [
                      "result"
                    ],
                    "description": "Alternative 1 for public schema change request."
                  },
                  {
                    "required": [
                      "error"
                    ],
                    "description": "Alternative 2 for public schema change request."
                  }
                ],
                "description": "Forbidden field combination for public schema change request."
              },
              "description": "Constraint applied when the preceding public schema change request condition matches."
            },
            "description": "Composed constraint 11 for public schema change request; every composed constraint applies."
          }
        ],
        "description": "Open response envelope exposing review and application state independently."
      },
      "ApprovedPublicSchemaDecisionReceipt": {
        "type": "object",
        "properties": {
          "changeRequestId": {
            "type": "string",
            "minLength": 1,
            "description": "Authority-assigned identifier for the immutable change request."
          },
          "proposalVersion": {
            "type": "integer",
            "minimum": 1,
            "description": "Monotonically increasing representation version guarded by review If-Match."
          },
          "kind": {
            "enum": [
              "create",
              "update",
              "transition"
            ],
            "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
            "type": "string"
          },
          "target": {
            "type": "object",
            "minProperties": 1,
            "description": "Collection and, when applicable, Record selected by the proposal."
          },
          "input": {
            "type": "object",
            "minProperties": 1,
            "description": "Concrete typed input that would be used by the corresponding direct operation."
          },
          "reviewState": {
            "const": "approved",
            "description": "Review state: pending awaits a decision, approved or rejected records that decision, and withdrawn records submitter withdrawal.",
            "type": "string"
          },
          "applicationState": {
            "const": "not-started",
            "description": "Application state: not-started has no authoritative effect, applying is in progress, applied committed, and blocked or failed did not commit.",
            "type": "string"
          },
          "submittedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "Z(?![\\s\\S])",
            "description": "UTC instant at which the change request was submitted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "Z(?![\\s\\S])",
            "description": "UTC instant at which the change-request representation last changed."
          }
        },
        "required": [
          "changeRequestId",
          "proposalVersion",
          "kind",
          "target",
          "input",
          "reviewState",
          "applicationState",
          "submittedAt",
          "updatedAt"
        ],
        "not": {
          "anyOf": [
            {
              "required": [
                "result"
              ],
              "description": "Alternative 1 for approved public schema decision receipt."
            },
            {
              "required": [
                "error"
              ],
              "description": "Alternative 2 for approved public schema decision receipt."
            }
          ],
          "description": "Forbidden field combination for approved public schema decision receipt."
        },
        "description": "Open review receipt proving approval without implying authoritative application."
      },
      "RejectedPublicSchemaDecisionReceipt": {
        "type": "object",
        "properties": {
          "changeRequestId": {
            "type": "string",
            "minLength": 1,
            "description": "Authority-assigned identifier for the immutable change request."
          },
          "proposalVersion": {
            "type": "integer",
            "minimum": 1,
            "description": "Monotonically increasing representation version guarded by review If-Match."
          },
          "kind": {
            "enum": [
              "create",
              "update",
              "transition"
            ],
            "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
            "type": "string"
          },
          "target": {
            "type": "object",
            "minProperties": 1,
            "description": "Collection and, when applicable, Record selected by the proposal."
          },
          "input": {
            "type": "object",
            "minProperties": 1,
            "description": "Concrete typed input that would be used by the corresponding direct operation."
          },
          "reviewState": {
            "const": "rejected",
            "description": "Review state: pending awaits a decision, approved or rejected records that decision, and withdrawn records submitter withdrawal.",
            "type": "string"
          },
          "applicationState": {
            "const": "not-started",
            "description": "Application state: not-started has no authoritative effect, applying is in progress, applied committed, and blocked or failed did not commit.",
            "type": "string"
          },
          "submittedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "Z(?![\\s\\S])",
            "description": "UTC instant at which the change request was submitted."
          },
          "updatedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "Z(?![\\s\\S])",
            "description": "UTC instant at which the change-request representation last changed."
          }
        },
        "required": [
          "changeRequestId",
          "proposalVersion",
          "kind",
          "target",
          "input",
          "reviewState",
          "applicationState",
          "submittedAt",
          "updatedAt"
        ],
        "not": {
          "anyOf": [
            {
              "required": [
                "result"
              ],
              "description": "Alternative 1 for rejected public schema decision receipt."
            },
            {
              "required": [
                "error"
              ],
              "description": "Alternative 2 for rejected public schema decision receipt."
            }
          ],
          "description": "Forbidden field combination for rejected public schema decision receipt."
        },
        "description": "Open review receipt proving rejection without changing an authoritative Record."
      },
      "PublicSchemaWriteResult": {
        "type": "object",
        "properties": {
          "collectionId": {
            "enum": [
              "birth-registrations",
              "households",
              "individuals"
            ],
            "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
            "type": "string"
          },
          "recordId": {
            "$ref": "#/components/schemas/RecordId"
          },
          "etag": {
            "$ref": "#/components/schemas/StrongETag-2",
            "description": "Strong entity tag for the authoritative Record after commit."
          },
          "requestLocalReferences": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LocalReferenceResolution",
              "description": "One request local references array entry accepted by this profile."
            },
            "uniqueItems": true,
            "description": "Mappings from created request-local URIs to authority-assigned Collection and Record identifiers."
          }
        },
        "required": [
          "collectionId",
          "recordId",
          "etag"
        ],
        "description": "Open authoritative result for one target Record plus profile-local request-reference resolutions."
      },
      "Identifier.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Identifier",
        "description": "A coded value assigned to an entity within an identification scheme. Identifiers disambiguate entities such as persons, groups, locations, administrative areas, or records within a specific registry or catalog. The identifier is the value and its scheme; documents that carry identifiers (passports, national ID cards, beneficiary cards) are modeled separately as IdentityDocument.\n",
        "type": "object",
        "properties": {
          "identifier_value": {
            "type": "string",
            "description": "The alphanumeric value of the identifier as issued or recorded."
          },
          "identifier_scheme_id": {
            "type": "string",
            "description": "A URI or code that identifies the scheme or system under which the identifier was assigned."
          },
          "identifier_scheme_name": {
            "type": "string",
            "description": "The human-readable name of the identifier scheme, such as 'National Identity Number' or 'Social Security Number'."
          },
          "identifier_type": {
            "type": "string",
            "enum": [
              "national_id_number",
              "social_security_number",
              "tax_id_number",
              "program_id_number",
              "household_id_number",
              "passport_number",
              "drivers_license_number",
              "voter_id_number",
              "birth_registration_number",
              "marriage_registration_number",
              "death_registration_number",
              "country_code",
              "subdivision_code",
              "postal_code",
              "p_code",
              "fips_code",
              "hasc_code",
              "un_locode",
              "transaction_reference",
              "other"
            ],
            "$comment": "https://publicschema.org/vocab/identifier-type",
            "description": "The category of identifier value (for example, national ID number, passport number, P-code)."
          }
        }
      },
      "Geometry.schema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "title": "GeoJSON Geometry",
        "oneOf": [
          {
            "title": "GeoJSON Point",
            "type": "object",
            "required": [
              "type",
              "coordinates"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "Point"
                ]
              },
              "coordinates": {
                "type": "array",
                "minItems": 2,
                "items": {
                  "type": "number"
                }
              },
              "bbox": {
                "type": "array",
                "minItems": 4,
                "items": {
                  "type": "number"
                }
              }
            }
          },
          {
            "title": "GeoJSON LineString",
            "type": "object",
            "required": [
              "type",
              "coordinates"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "LineString"
                ]
              },
              "coordinates": {
                "type": "array",
                "minItems": 2,
                "items": {
                  "type": "array",
                  "minItems": 2,
                  "items": {
                    "type": "number"
                  }
                }
              },
              "bbox": {
                "type": "array",
                "minItems": 4,
                "items": {
                  "type": "number"
                }
              }
            }
          },
          {
            "title": "GeoJSON Polygon",
            "type": "object",
            "required": [
              "type",
              "coordinates"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "Polygon"
                ]
              },
              "coordinates": {
                "type": "array",
                "items": {
                  "type": "array",
                  "minItems": 4,
                  "items": {
                    "type": "array",
                    "minItems": 2,
                    "items": {
                      "type": "number"
                    }
                  }
                }
              },
              "bbox": {
                "type": "array",
                "minItems": 4,
                "items": {
                  "type": "number"
                }
              }
            }
          },
          {
            "title": "GeoJSON MultiPoint",
            "type": "object",
            "required": [
              "type",
              "coordinates"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "MultiPoint"
                ]
              },
              "coordinates": {
                "type": "array",
                "items": {
                  "type": "array",
                  "minItems": 2,
                  "items": {
                    "type": "number"
                  }
                }
              },
              "bbox": {
                "type": "array",
                "minItems": 4,
                "items": {
                  "type": "number"
                }
              }
            }
          },
          {
            "title": "GeoJSON MultiLineString",
            "type": "object",
            "required": [
              "type",
              "coordinates"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "MultiLineString"
                ]
              },
              "coordinates": {
                "type": "array",
                "items": {
                  "type": "array",
                  "minItems": 2,
                  "items": {
                    "type": "array",
                    "minItems": 2,
                    "items": {
                      "type": "number"
                    }
                  }
                }
              },
              "bbox": {
                "type": "array",
                "minItems": 4,
                "items": {
                  "type": "number"
                }
              }
            }
          },
          {
            "title": "GeoJSON MultiPolygon",
            "type": "object",
            "required": [
              "type",
              "coordinates"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "MultiPolygon"
                ]
              },
              "coordinates": {
                "type": "array",
                "items": {
                  "type": "array",
                  "items": {
                    "type": "array",
                    "minItems": 4,
                    "items": {
                      "type": "array",
                      "minItems": 2,
                      "items": {
                        "type": "number"
                      }
                    }
                  }
                }
              },
              "bbox": {
                "type": "array",
                "minItems": 4,
                "items": {
                  "type": "number"
                }
              }
            }
          }
        ]
      },
      "Location.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Location",
        "description": "A named geographic or administrative area, such as a region, district, commune, or village. Location captures where a household or event is situated within an administrative hierarchy, distinct from a street address.\n",
        "type": "object",
        "properties": {
          "location_name": {
            "type": "string",
            "description": "A human-readable place name for the location."
          },
          "latitude": {
            "type": "number",
            "description": "The geographic latitude in decimal degrees (WGS84)."
          },
          "longitude": {
            "type": "number",
            "description": "The geographic longitude in decimal degrees (WGS84)."
          },
          "geometry": {
            "$ref": "#/components/schemas/Geometry.schema",
            "description": "The geographic boundary or shape, expressed as a GeoJSON Geometry object (Point, Polygon, MultiPolygon, etc.)."
          },
          "administrative_level": {
            "type": "integer",
            "description": "The numeric tier in the administrative hierarchy, following the OCHA COD-AB convention: 0 = country, 1 = first subnational (state, province, region), 2 = second subnational (district, county, department), and so on. No fixed maximum depth."
          },
          "level_name": {
            "type": "string",
            "description": "The country-specific name for this administrative tier (e.g., state, department, commune, ward)."
          },
          "parent_location": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Location.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The parent location in the administrative hierarchy."
          },
          "geocodes": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Identifier.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Administrative or statistical codes that identify this area within a coding system (FIPS, P-code, postal code, etc.)."
            }
          }
        }
      },
      "IdentityDocument.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "IdentityDocument",
        "description": "A physical or digital document that asserts one or more identifiers about a party (person, household, group, or organization). Distinct from the identifier itself: the number on a passport is an Identifier; the passport book is an IdentityDocument. Documents have their own lifecycle (issue date, expiry, issuing authority) independent of the identifier value, and the same identifier may appear on successive documents. Distinct from Certificate (a re-issuable extract of a civil-status record under CIEC conventions) and from IdentityCredential (the Verifiable Credential envelope that may attest an IdentityDocument in digital form).\n",
        "type": "object",
        "properties": {
          "identifiers": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Identifier.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identifiers carried by this entity, such as national ID numbers, program IDs, or identifiers asserted by an identity document."
            }
          },
          "document_type": {
            "type": "string",
            "enum": [
              "passport",
              "national_id_card",
              "drivers_license",
              "voter_id_card",
              "digital_identity_credential",
              "birth_certificate",
              "marriage_certificate",
              "death_certificate",
              "program_beneficiary_card",
              "other"
            ],
            "$comment": "https://publicschema.org/vocab/document-type",
            "description": "The category of identity document (passport, national ID card, beneficiary card, etc.)."
          },
          "issued_to": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Party.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The party (person, household, group, or organization) to whom the document, voucher, or credential is issued."
          },
          "issuing_authority": {
            "type": "string",
            "description": "The organization or government body that issued the document or credential."
          },
          "issuing_jurisdiction": {
            "type": "string",
            "description": "The geographic jurisdiction under which the document or credential was issued, expressed as an ISO 3166-2 subdivision code or ISO 3166-1 country code."
          },
          "issue_date": {
            "type": "string",
            "format": "date",
            "description": "The date on which this record or document was issued."
          },
          "expiry_date": {
            "type": "string",
            "format": "date",
            "description": "The date on which this record or document expires or becomes invalid."
          }
        }
      },
      "Party.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Party",
        "description": "A person, an organized group of persons or an organization that can be identified, enrolled in programs, and receive benefits or services. Party is the shared supertype for Person, Group and Organization, enabling references that accept any of them.\n",
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The full display name of the record. Depending on the concept, this is a person's or group's name, or the title of a program, instrument, scoring rule, or software product."
          },
          "identifiers": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Identifier.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identifiers carried by this entity, such as national ID numbers, program IDs, or identifiers asserted by an identity document."
            }
          },
          "identity_documents": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/IdentityDocument.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identity documents held by this party, such as passports, national identity cards, civil registration certificates, and program-issued beneficiary cards, or, for an organization, a certificate of registration."
            }
          }
        }
      },
      "Address.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Address",
        "description": "A structured physical or postal location used to reach a person, household, or organization. Addresses combine spatial and administrative components such as street, settlement, district, and postal code.\n",
        "type": "object",
        "properties": {
          "full_address": {
            "type": "string",
            "description": "The complete address written as a single text string. Coexists with structured address components for systems that store addresses as free text."
          },
          "street_address": {
            "type": "string",
            "description": "The street name, number, and any apartment or building identifiers."
          },
          "house_number": {
            "type": "string",
            "description": "The house, building, or plot number within a street or road."
          },
          "building_name": {
            "type": "string",
            "description": "The name of a building, estate, or compound, used in contexts where locations are identified by name rather than street number."
          },
          "address_area": {
            "type": "string",
            "description": "The name of a geographic area such as a neighborhood, quarter, or ward that groups addresses below the city level."
          },
          "city": {
            "type": "string",
            "description": "The city, town, or village component of the address."
          },
          "administrative_area": {
            "type": "string",
            "description": "The first-level administrative subdivision (province, state, region) containing the address."
          },
          "postal_code": {
            "type": "string",
            "description": "The postal or zip code of the address."
          },
          "country": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/country",
            "description": "The country, expressed as an ISO 3166-1 alpha-2 code where possible."
          },
          "location": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Location.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The geographic location of the subject of this record, captured as coordinates or administrative area."
          }
        }
      },
      "Person.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Person",
        "description": "The unique individual human being who is a subject of record. Person is the persistent, indivisible unit of identity in registries; operational statuses such as Registrant, Applicant, or Beneficiary are transient roles defined by the person's relationship to a specific Program, not properties of the person themselves. A person who runs a business that the register of its jurisdiction does not treat as a distinct body, such as many sole traders, remains a Person; the business is an Organization only where the register treats it as one.\n",
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The full display name of the record. Depending on the concept, this is a person's or group's name, or the title of a program, instrument, scoring rule, or software product."
          },
          "identifiers": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Identifier.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identifiers carried by this entity, such as national ID numbers, program IDs, or identifiers asserted by an identity document."
            }
          },
          "identity_documents": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/IdentityDocument.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identity documents held by this party, such as passports, national identity cards, civil registration certificates, and program-issued beneficiary cards, or, for an organization, a certificate of registration."
            }
          },
          "date_of_birth": {
            "type": "string",
            "format": "date",
            "description": "The date on which the person was born."
          },
          "date_of_death": {
            "type": "string",
            "format": "date",
            "description": "The date on which the person died."
          },
          "country_of_birth": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/country",
            "description": "The country where the person was born, expressed as an ISO 3166-1 code."
          },
          "given_name": {
            "type": "string",
            "description": "The given (first) name of the person."
          },
          "family_name": {
            "type": "string",
            "description": "The family (last) name or surname of the person."
          },
          "family_name_at_birth": {
            "type": "string",
            "description": "The family name of the person at the time of birth, before any change due to marriage or other legal event."
          },
          "given_name_at_birth": {
            "type": "string",
            "description": "The given name of the person at the time of birth, before any legal name change."
          },
          "preferred_name": {
            "type": "string",
            "description": "The name a person is commonly known by, when it differs from their legal name. Covers chosen names, professional names, and naming conventions where given name plus family name is insufficient."
          },
          "patronymic_name": {
            "type": "string",
            "description": "A name derived from the given name of the person's father or a paternal ancestor, used in naming conventions where patronymics are a distinct component of a person's full name."
          },
          "matronymic_name": {
            "type": "string",
            "description": "A name derived from the given name of the person's mother."
          },
          "gender": {
            "type": "string",
            "enum": [
              "male",
              "female",
              "other",
              "not_stated"
            ],
            "$comment": "https://publicschema.org/vocab/gender-type",
            "description": "The gender of the person as recorded in a social protection registry or identity document."
          },
          "nationality": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/country",
            "description": "The country of citizenship or nationality, expressed as an ISO 3166-1 alpha-2 code where possible."
          },
          "sex": {
            "type": "string",
            "enum": [
              "not_known",
              "male",
              "female",
              "not_applicable"
            ],
            "$comment": "https://publicschema.org/vocab/sex",
            "description": "The biological sex of a person as recorded in an official register or identity document."
          },
          "marital_status": {
            "type": "string",
            "enum": [
              "never_married",
              "married",
              "widowed",
              "divorced",
              "legally_separated",
              "consensual_union"
            ],
            "$comment": "https://publicschema.org/vocab/marital-status",
            "description": "The marital or civil status of a person as recorded in an administrative system."
          },
          "number_of_spouses": {
            "type": "integer",
            "description": "The number of current spouses the person has. Captures polygamous or polyandrous union type separately from marital status, following the UN census framework and DHS approach."
          },
          "education_level": {
            "type": "string",
            "enum": [
              "none",
              "early_childhood",
              "primary",
              "lower_secondary",
              "upper_secondary",
              "post_secondary_non_tertiary",
              "short_cycle_tertiary",
              "bachelor",
              "master",
              "doctoral"
            ],
            "$comment": "https://publicschema.org/vocab/education-level",
            "description": "The highest level of formal education completed by a person."
          },
          "preferred_language": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/language",
            "description": "The preferred language of communication for a person, using ISO 639-3 codes."
          },
          "occupation": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/occupation",
            "description": "The person's primary occupation, classified according to the ISCO-08 sub-major groups."
          },
          "literacy": {
            "type": "string",
            "enum": [
              "literate",
              "illiterate"
            ],
            "$comment": "https://publicschema.org/vocab/literacy",
            "description": "Whether the person can, with understanding, both read and write a short simple statement on everyday life."
          },
          "religion": {
            "type": "string",
            "description": "The religion, religious denomination, or sect of the person, as self-identified. No international classification exists; countries define their own value sets."
          },
          "ethnic_group": {
            "type": "string",
            "description": "The ethnic or cultural group of the person, as self-identified. The UNSD recommends nationally defined categories based on self-identification; no international classification exists."
          },
          "employment_status": {
            "type": "string",
            "enum": [
              "employed",
              "unemployed",
              "outside_labour_force"
            ],
            "$comment": "https://publicschema.org/vocab/employment-status",
            "description": "The labour force participation status of the person: whether they are employed, unemployed, or outside the labour force."
          },
          "status_in_employment": {
            "type": "string",
            "enum": [
              "employee",
              "employer",
              "own_account_worker",
              "dependent_contractor",
              "contributing_family_worker",
              "cooperative_member"
            ],
            "$comment": "https://publicschema.org/vocab/status-in-employment",
            "description": "The type of employment relationship: whether the person is an employee, employer, own-account worker, contributing family worker, or cooperative member."
          },
          "industry": {
            "type": "string",
            "description": "The branch of economic activity in which the person works, classified according to the International Standard Industrial Classification (ISIC Rev.4). Too large to enumerate; countries use national adaptations."
          },
          "phone_number": {
            "type": "string",
            "description": "A contact phone number for the person, including country code."
          },
          "email_address": {
            "type": "string",
            "description": "An email address through which the person can be contacted."
          },
          "domicile": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Address.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The place that the person treats as their permanent home, which may differ from the address of their current household."
          },
          "group_memberships": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/GroupMembership.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Group memberships held by this person, linking them to households, families, or other groups."
            }
          },
          "biometric_samples": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/BiometricSample.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Biometric samples associated with this person, linking to fingerprint, iris, face, and other biometric records."
            }
          },
          "pregnancy_status": {
            "type": "string",
            "enum": [
              "not_pregnant",
              "pregnant",
              "postpartum",
              "unknown"
            ],
            "$comment": "https://publicschema.org/vocab/pregnancy-status",
            "description": "The current pregnancy status of the person."
          },
          "displacement_status": {
            "type": "string",
            "enum": [
              "resident",
              "idp",
              "idp_returnee",
              "refugee",
              "asylum_seeker",
              "returnee_from_abroad",
              "international_migrant",
              "stateless"
            ],
            "$comment": "https://publicschema.org/vocab/displacement-status",
            "description": "The legal, administrative, or protection status of the person with respect to displacement and migration."
          },
          "functioning_status": {
            "type": "string",
            "enum": [
              "no_difficulty",
              "some_difficulty",
              "a_lot_of_difficulty",
              "cannot_do"
            ],
            "$comment": "https://publicschema.org/vocab/functional-difficulty-severity",
            "description": "A coarse current-state summary of the person's functioning difficulty, used by operational systems for targeting and eligibility queries. This is NOT a Washington Group or Child Functioning Module classification of the person: WG and CFM items are measured at the point of administration through a FunctioningProfile, and deriving a disability identifier requires applying a documented cutoff rule. Populate functioning_status from a FunctioningProfile only by citing the cutoff rule alongside; otherwise treat it as a self-declared or enumerator-judged summary."
          },
          "nutrition_status": {
            "type": "string",
            "enum": [
              "adequate",
              "moderate_acute_malnutrition",
              "severe_acute_malnutrition"
            ],
            "$comment": "https://publicschema.org/vocab/acute-malnutrition-severity",
            "description": "A coarse current-state summary of the person's acute malnutrition status, used by operational systems for targeting and referral queries. This is NOT a z-score classification on a specific measurement: band classifications depend on a growth reference, an age at measurement, and oedema status captured on a dedicated anthropometric profile published in a sibling schema (see ADR-011). Populate nutrition_status from an anthropometric profile only by citing the cutoff rule alongside."
          }
        }
      },
      "GroupMembership.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "GroupMembership",
        "description": "The link between a Person and a Group, carrying the role the person plays within that group membership (such as head, spouse, child, owner, operator, or worker). Applicable role values depend on the kind of group. This link allows a person to belong to multiple groups at the same time.\n",
        "type": "object",
        "properties": {
          "person": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Person.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "A reference to the individual Person this record relates to."
          },
          "group": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Group.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The group to which the person belongs."
          },
          "role": {
            "type": "string",
            "enum": [
              "head",
              "spouse",
              "child",
              "dependent",
              "parent",
              "sibling",
              "grandparent",
              "grandchild",
              "other_relative",
              "non_relative",
              "owner",
              "operator",
              "worker"
            ],
            "$comment": "https://publicschema.org/vocab/group-role",
            "description": "The role recorded for the person within the group membership. Applicable values depend on the kind of group (for example head, spouse, child, owner, operator, or worker)."
          },
          "start_date": {
            "type": "string",
            "format": "date",
            "description": "The date on which this became effective."
          },
          "end_date": {
            "type": "string",
            "format": "date",
            "description": "The last day on which this is effective. A period includes both its start date and its end date, so a period that applies only on 30 June 2026 has start date 2026-06-30 and end date 2026-06-30."
          },
          "is_active": {
            "type": "boolean",
            "description": "Whether the membership or relationship is currently in effect, as opposed to expired, suspended, or terminated."
          }
        }
      },
      "Group.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Group",
        "description": "An abstract collection of persons that serves as the base for concrete group types such as Household and Family. Groups are linked to their members via membership links. In native PublicSchema modeling, the concrete subtype carries the authoritative semantics; group_type is kept as an interoperability classifier for systems that exchange groups through a flatter category field.\n",
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The full display name of the record. Depending on the concept, this is a person's or group's name, or the title of a program, instrument, scoring rule, or software product."
          },
          "identifiers": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Identifier.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identifiers carried by this entity, such as national ID numbers, program IDs, or identifiers asserted by an identity document."
            }
          },
          "identity_documents": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/IdentityDocument.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identity documents held by this party, such as passports, national identity cards, civil registration certificates, and program-issued beneficiary cards, or, for an organization, a certificate of registration."
            }
          },
          "group_type": {
            "type": "string",
            "enum": [
              "household",
              "family",
              "farm",
              "other"
            ],
            "$comment": "https://publicschema.org/vocab/group-type",
            "description": "An interoperability classifier for the category of group record being exchanged or exported. In native PublicSchema modeling, the concrete Group subtype is the authoritative signal when known."
          },
          "formation_date": {
            "type": "string",
            "format": "date",
            "description": "The date on which this group or organization was formed or registered."
          },
          "member_count": {
            "type": "integer",
            "description": "The total number of members in this household or group."
          },
          "memberships": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/GroupMembership.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "The membership links connecting persons to this group, each carrying role and lifecycle dates."
            }
          }
        }
      },
      "BiometricSample.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "BiometricSample",
        "description": "A biometric measurement captured from a person, such as a fingerprint image, iris scan, or facial photograph. Each record represents a single capture of a single biometric position (e.g., right index finger). A BiometricSample record may also document a capture exception: when exception_reason is non-null, the record explains why the biometric could not be captured rather than holding actual sample data.\n",
        "type": "object",
        "properties": {
          "person": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Person.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "A reference to the individual Person this record relates to."
          },
          "biometric_modality": {
            "type": "string",
            "enum": [
              "face",
              "fingerprint",
              "iris",
              "signature",
              "voice"
            ],
            "$comment": "https://publicschema.org/vocab/biometric-modality",
            "description": "The type of biometric measurement (face, fingerprint, iris, signature, voice)."
          },
          "biometric_subtype": {
            "type": "string",
            "enum": [
              "right_thumb",
              "right_index",
              "right_middle",
              "right_ring",
              "right_little",
              "left_thumb",
              "left_index",
              "left_middle",
              "left_ring",
              "left_little",
              "right_eye",
              "left_eye",
              "both_eyes",
              "portrait"
            ],
            "$comment": "https://publicschema.org/vocab/biometric-subtype",
            "description": "The specific body part or position within a biometric modality (e.g., right index finger, left eye, portrait)."
          },
          "impression_type": {
            "type": "string",
            "enum": [
              "live_scan_plain",
              "live_scan_rolled",
              "live_scan_swipe",
              "live_scan_vertical_roll",
              "live_scan_palm",
              "live_scan_optical_contactless_plain",
              "non_live_scan_plain",
              "non_live_scan_rolled",
              "non_live_scan_palm",
              "latent_impression",
              "latent_tracing",
              "latent_photo",
              "latent_lift",
              "latent_palm_impression",
              "latent_palm_tracing",
              "latent_palm_photo",
              "latent_palm_lift",
              "other",
              "unknown"
            ],
            "$comment": "https://publicschema.org/vocab/impression-type",
            "description": "The method by which a fingerprint biometric was captured (e.g., live scan plain, rolled, latent)."
          },
          "capture_date": {
            "type": "string",
            "format": "date",
            "description": "The date on which the biometric sample was captured."
          },
          "quality_score": {
            "type": "integer",
            "description": "A quality score for the biometric sample, on a 0-100 scale per ISO 29794-1. Higher values indicate better quality."
          },
          "quality_algorithm": {
            "type": "string",
            "description": "The algorithm or standard used to compute the quality score (e.g., NFIQ2, ISO_29794_4)."
          },
          "sample_uri": {
            "type": "string",
            "description": "A URI reference to the biometric sample data. The referenced resource contains the actual biometric data (image, audio, or other signal)."
          },
          "sample_format": {
            "type": "string",
            "description": "The MIME type of the biometric sample data (e.g., image/jp2, image/jpeg, application/octet-stream)."
          },
          "exception_reason": {
            "type": "string",
            "enum": [
              "amputated",
              "bandaged",
              "damaged",
              "unable_to_capture"
            ],
            "$comment": "https://publicschema.org/vocab/biometric-exception-reason",
            "description": "The reason a biometric sample could not be captured. When non-null, this record documents a capture exception rather than holding biometric data."
          },
          "capture_device": {
            "type": "string",
            "description": "An identifier or description of the device used to capture the biometric sample."
          }
        }
      },
      "Person.schema-2": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Person",
        "description": "A temporal snapshot of a Person as observed at the time of a vital event. Carries the same demographic properties as Person, but frozen at event time rather than reflecting current values. Used wherever a vital event needs to record who a person was (occupation, residence, education, etc.) at the moment the event occurred.\n",
        "type": "object",
        "properties": {
          "person": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Person.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "A reference to the individual Person this record relates to."
          },
          "nationality": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/country",
            "description": "The country of citizenship or nationality, expressed as an ISO 3166-1 alpha-2 code where possible."
          },
          "occupation": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/occupation",
            "description": "The person's primary occupation, classified according to the ISCO-08 sub-major groups."
          },
          "education_level": {
            "type": "string",
            "enum": [
              "none",
              "early_childhood",
              "primary",
              "lower_secondary",
              "upper_secondary",
              "post_secondary_non_tertiary",
              "short_cycle_tertiary",
              "bachelor",
              "master",
              "doctoral"
            ],
            "$comment": "https://publicschema.org/vocab/education-level",
            "description": "The highest level of formal education completed by a person."
          },
          "marital_status": {
            "type": "string",
            "enum": [
              "never_married",
              "married",
              "widowed",
              "divorced",
              "legally_separated",
              "consensual_union"
            ],
            "$comment": "https://publicschema.org/vocab/marital-status",
            "description": "The marital or civil status of a person as recorded in an administrative system."
          },
          "literacy": {
            "type": "string",
            "enum": [
              "literate",
              "illiterate"
            ],
            "$comment": "https://publicschema.org/vocab/literacy",
            "description": "Whether the person can, with understanding, both read and write a short simple statement on everyday life."
          },
          "religion": {
            "type": "string",
            "description": "The religion, religious denomination, or sect of the person, as self-identified. No international classification exists; countries define their own value sets."
          },
          "ethnic_group": {
            "type": "string",
            "description": "The ethnic or cultural group of the person, as self-identified. The UNSD recommends nationally defined categories based on self-identification; no international classification exists."
          },
          "employment_status": {
            "type": "string",
            "enum": [
              "employed",
              "unemployed",
              "outside_labour_force"
            ],
            "$comment": "https://publicschema.org/vocab/employment-status",
            "description": "The labour force participation status of the person: whether they are employed, unemployed, or outside the labour force."
          },
          "status_in_employment": {
            "type": "string",
            "enum": [
              "employee",
              "employer",
              "own_account_worker",
              "dependent_contractor",
              "contributing_family_worker",
              "cooperative_member"
            ],
            "$comment": "https://publicschema.org/vocab/status-in-employment",
            "description": "The type of employment relationship: whether the person is an employee, employer, own-account worker, contributing family worker, or cooperative member."
          },
          "industry": {
            "type": "string",
            "description": "The branch of economic activity in which the person works, classified according to the International Standard Industrial Classification (ISIC Rev.4). Too large to enumerate; countries use national adaptations."
          },
          "place_of_usual_residence": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Location.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The usual place of residence of the person at the time of the vital event. Used by national statistics offices to allocate vital events to the place where people live, not only where events occur."
          },
          "age_at_event": {
            "type": "integer",
            "description": "The stated age of the person at the time of the vital event. Used in low-completeness settings where date of birth is unknown and stated age is the only age data available."
          }
        }
      },
      "Parent.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Parent",
        "description": "A crvs/Person subtype that captures a parental role alongside the inherited person-of-record properties. Used on Birth, Adoption, PaternityRecognition, and Legitimation so that biological and legal parentage can be captured explicitly rather than collapsed into a single parent slot.\nA Parent instance is scoped to a single event context: the parental_role, establishment_basis, and certificate_label recorded here are the values asserted at the time of that event. Reusing the same Parent instance across multiple events would break snapshot semantics because the role or establishment basis may differ. The canonical way to assert parenthood across contexts is via Relationship records between Person instances, while Parent captures a point-in-time declaration tied to an event.\nThe parental_role property carries the role-nature (biological, gestational, legal, or adoptive), decoupled from gender. The establishment_basis property captures the legal route by which parentage was established (for example, marital presumption, voluntary recognition, or adoption order). The certificate_label property is a free-text field for the jurisdiction-specific label that must appear on the printed certificate.\n",
        "type": "object",
        "properties": {
          "person": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Person.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "A reference to the individual Person this record relates to."
          },
          "nationality": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/country",
            "description": "The country of citizenship or nationality, expressed as an ISO 3166-1 alpha-2 code where possible."
          },
          "occupation": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/occupation",
            "description": "The person's primary occupation, classified according to the ISCO-08 sub-major groups."
          },
          "education_level": {
            "type": "string",
            "enum": [
              "none",
              "early_childhood",
              "primary",
              "lower_secondary",
              "upper_secondary",
              "post_secondary_non_tertiary",
              "short_cycle_tertiary",
              "bachelor",
              "master",
              "doctoral"
            ],
            "$comment": "https://publicschema.org/vocab/education-level",
            "description": "The highest level of formal education completed by a person."
          },
          "marital_status": {
            "type": "string",
            "enum": [
              "never_married",
              "married",
              "widowed",
              "divorced",
              "legally_separated",
              "consensual_union"
            ],
            "$comment": "https://publicschema.org/vocab/marital-status",
            "description": "The marital or civil status of a person as recorded in an administrative system."
          },
          "literacy": {
            "type": "string",
            "enum": [
              "literate",
              "illiterate"
            ],
            "$comment": "https://publicschema.org/vocab/literacy",
            "description": "Whether the person can, with understanding, both read and write a short simple statement on everyday life."
          },
          "religion": {
            "type": "string",
            "description": "The religion, religious denomination, or sect of the person, as self-identified. No international classification exists; countries define their own value sets."
          },
          "ethnic_group": {
            "type": "string",
            "description": "The ethnic or cultural group of the person, as self-identified. The UNSD recommends nationally defined categories based on self-identification; no international classification exists."
          },
          "employment_status": {
            "type": "string",
            "enum": [
              "employed",
              "unemployed",
              "outside_labour_force"
            ],
            "$comment": "https://publicschema.org/vocab/employment-status",
            "description": "The labour force participation status of the person: whether they are employed, unemployed, or outside the labour force."
          },
          "status_in_employment": {
            "type": "string",
            "enum": [
              "employee",
              "employer",
              "own_account_worker",
              "dependent_contractor",
              "contributing_family_worker",
              "cooperative_member"
            ],
            "$comment": "https://publicschema.org/vocab/status-in-employment",
            "description": "The type of employment relationship: whether the person is an employee, employer, own-account worker, contributing family worker, or cooperative member."
          },
          "industry": {
            "type": "string",
            "description": "The branch of economic activity in which the person works, classified according to the International Standard Industrial Classification (ISIC Rev.4). Too large to enumerate; countries use national adaptations."
          },
          "place_of_usual_residence": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Location.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The usual place of residence of the person at the time of the vital event. Used by national statistics offices to allocate vital events to the place where people live, not only where events occur."
          },
          "age_at_event": {
            "type": "integer",
            "description": "The stated age of the person at the time of the vital event. Used in low-completeness settings where date of birth is unknown and stated age is the only age data available."
          },
          "parental_role": {
            "type": "string",
            "enum": [
              "biological",
              "gestational",
              "legal",
              "adoptive"
            ],
            "$comment": "https://publicschema.org/vocab/crvs/parental-role",
            "description": "The role-nature of the parent relationship (biological, gestational, legal, or adoptive), decoupled from gender. Makes the nature of parentage explicit and separable from the parent's identity. For jurisdictions requiring gendered or positional labels on the printed certificate, use certificate_label alongside this property."
          },
          "establishment_basis": {
            "type": "string",
            "enum": [
              "marital_presumption",
              "voluntary_recognition",
              "judicial_declaration",
              "adoption_order",
              "surrogacy_order"
            ],
            "$comment": "https://publicschema.org/vocab/crvs/parent-establishment-basis",
            "description": "The legal route by which the parent's parentage was established: marital presumption, voluntary recognition, judicial declaration, adoption order, or surrogacy order. Complements parental_role, which captures the role-nature (biological, gestational, legal, adoptive); establishment_basis captures the mechanism."
          },
          "certificate_label": {
            "type": "string",
            "description": "A free-text field carrying the role label as it must appear on the printed legal certificate. Jurisdictions that require gendered designations (for example, 'mother', 'father') or positional labels ('parent 1', 'parent 2') on the certificate use this field. The underlying role-nature is already carried on parental_role; certificate_label is purely a display hint for document generation."
          }
        }
      },
      "Birth.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Birth",
        "description": "A live birth, meaning the complete expulsion or extraction of a product of conception from its mother, irrespective of duration of pregnancy, which after such separation breathes or shows any other evidence of life. Captures the child, the parents, and attributes used by civil registration and vital statistics (sex at birth, birth order, attendant, weight, place type).\n",
        "type": "object",
        "properties": {
          "identifiers": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Identifier.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identifiers carried by this entity, such as national ID numbers, program IDs, or identifiers asserted by an identity document."
            }
          },
          "event_date": {
            "type": "string",
            "format": "date",
            "description": "The date on which the vital event (birth, death, marriage, etc.) occurred. Distinct from the registration date, which is when the event was recorded by a registration authority."
          },
          "event_date_estimated": {
            "type": "boolean",
            "description": "Whether the event date is an estimate rather than a known exact date. Common for late-registered births or deaths where the precise date is not documented."
          },
          "event_location": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Location.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The specific place where the vital event occurred (for example, the hospital of birth or the place of death). Distinct from the registration location, which is where the event was recorded."
          },
          "registration_date": {
            "type": "string",
            "format": "date",
            "description": "The date on which the vital event was officially registered with the civil registration authority. May be later than the event date, especially for late registrations."
          },
          "registration_location": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Location.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The civil registration office where the vital event was registered. Often a municipal or district-level registry distinct from the place of occurrence."
          },
          "registration_type": {
            "type": "string",
            "enum": [
              "current",
              "late",
              "court_ordered",
              "reconstruction"
            ],
            "$comment": "https://publicschema.org/vocab/crvs/registration-type",
            "description": "The regime under which the registration was processed: current (within the legal window), late, court-ordered, or reconstruction of a lost record. Affects legal weight and downstream uses."
          },
          "registrar": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Person.schema-2"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The civil registration officer who recorded the event. In many jurisdictions this is the officer whose signature appears on the acte."
          },
          "informant": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Person.schema-2"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The person who declares the vital event to the civil registration authority. Typically a parent for births, a relative or medical professional for deaths, or the parties themselves for marriages."
          },
          "registration_status": {
            "type": "string",
            "enum": [
              "declared",
              "pending_validation",
              "registered",
              "rejected",
              "cancelled",
              "corrected",
              "archived"
            ],
            "$comment": "https://publicschema.org/vocab/crvs/registration-status",
            "description": "The lifecycle state of the registration process for this vital event: whether it is declared, pending validation, registered, rejected, cancelled, or has been corrected or archived."
          },
          "child": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Person.schema-2"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The child whose birth, adoption, or legitimation is recorded in this event."
          },
          "parents": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Parent.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "The parents of the child, each captured as a Parent link entity that combines a Person with a parental role-nature (biological, gestational, legal, or adoptive)."
            }
          },
          "sex_at_birth": {
            "type": "string",
            "enum": [
              "not_known",
              "male",
              "female",
              "not_applicable"
            ],
            "$comment": "https://publicschema.org/vocab/sex",
            "description": "The sex of the child as observed and recorded at the time of birth. Distinct from any later legal or administrative sex marker."
          },
          "nationality_at_birth": {
            "type": "string",
            "$comment": "https://publicschema.org/vocab/country",
            "description": "The nationality acquired by the child at the time of birth, typically derived from parentage (jus sanguinis) or place of birth (jus soli) according to the applicable national law."
          },
          "place_type": {
            "type": "string",
            "enum": [
              "health_facility",
              "home",
              "en_route",
              "other",
              "unknown"
            ],
            "$comment": "https://publicschema.org/vocab/crvs/place-type",
            "description": "The category of place where the vital event occurred (health facility, home, en route, etc.). Complements the specific Location by describing what kind of setting it was."
          },
          "birth_type": {
            "type": "string",
            "enum": [
              "single",
              "twin",
              "triplet",
              "quadruplet",
              "quintuplet",
              "higher_order"
            ],
            "$comment": "https://publicschema.org/vocab/crvs/birth-type",
            "description": "Whether the birth was single, twin, triplet, or higher-order multiple. Captured at the level of the delivery, not per infant."
          },
          "birth_order": {
            "type": "integer",
            "description": "For multiple births, the sequence number of this infant among the siblings born in the same delivery (1 for first-born, 2 for second-born, etc.)."
          },
          "weight_at_birth": {
            "type": "number",
            "description": "The weight of the child at birth, recorded in grams. A core UN Principles and Recommendations vital statistics variable used to identify low birth weight."
          },
          "attendant_at_birth": {
            "type": "string",
            "enum": [
              "physician",
              "midwife",
              "nurse",
              "traditional_birth_attendant",
              "other",
              "none"
            ],
            "$comment": "https://publicschema.org/vocab/crvs/birth-attendant",
            "description": "The type of person who attended the delivery (physician, midwife, nurse, traditional birth attendant, other, or none). Used as a proxy for safe delivery in health statistics."
          }
        }
      },
      "JsonLdType": {
        "type": "object",
        "properties": {
          "@context": {
            "const": "https://publicschema.org/ctx/draft.jsonld",
            "description": "Pinned PublicSchema JSON-LD context used by this example instance.",
            "type": "string"
          },
          "@id": {
            "type": "string",
            "format": "uri",
            "description": "URI identity for the object; create commands restrict it to a declared request-local identifier."
          },
          "@type": {
            "type": "string",
            "format": "uri",
            "description": "Canonical PublicSchema type URI for this object."
          }
        },
        "description": "Schema for json ld type in this non-normative Write example profile."
      },
      "PublicSchemaBirth": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Birth.schema",
            "description": "Composed constraint 1 for public schema birth; every composed constraint applies."
          },
          {
            "$ref": "#/components/schemas/JsonLdType",
            "description": "Composed constraint 2 for public schema birth; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@type": {
                "const": "https://publicschema.org/crvs/Birth",
                "description": "Canonical PublicSchema type URI for this object.",
                "type": "string"
              }
            },
            "description": "Composed constraint 3 for public schema birth; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for public schema birth in this non-normative Write example profile."
      },
      "RequestLocalId": {
        "type": "string",
        "pattern": "^urn:request-local:[A-Za-z0-9._-]+$",
        "description": "A URI scoped to one request. It has no authoritative meaning unless the source commits the request and returns a resolution."
      },
      "PublicSchemaLocation": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Location.schema",
            "description": "Composed constraint 1 for public schema location; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "parent_location": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/PublicSchemaLocation",
                    "description": "Alternative 1 for parent location."
                  },
                  {
                    "type": "string",
                    "format": "uri",
                    "description": "Alternative 2 for parent location."
                  }
                ],
                "description": "Containing PublicSchema Location or a URI reference to that location."
              },
              "geocodes": {
                "type": "array",
                "items": {
                  "$ref": "#/components/schemas/PublicSchemaIdentifier",
                  "description": "One geocodes array entry accepted by this profile."
                },
                "description": "Closed PublicSchema Identifier objects representing geographic codes."
              }
            },
            "description": "Composed constraint 2 for public schema location; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for public schema location in this non-normative Write example profile."
      },
      "PublicSchemaIdentifier": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Identifier.schema",
            "description": "Composed constraint 1 for public schema identifier; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for public schema identifier in this non-normative Write example profile."
      },
      "ExistingPersonReference": {
        "type": "string",
        "pattern": "^https://registry\\.example/v1/collections/individuals/records/[A-Za-z0-9._~-]+$",
        "description": "Schema for existing person reference in this non-normative Write example profile."
      },
      "PublicSchemaCrvsPerson": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Person.schema-2",
            "description": "Composed constraint 1 for public schema crvs person; every composed constraint applies."
          },
          {
            "$ref": "#/components/schemas/JsonLdType",
            "description": "Composed constraint 2 for public schema crvs person; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@type": {
                "const": "https://publicschema.org/crvs/Person",
                "description": "Canonical PublicSchema type URI for this object.",
                "type": "string"
              },
              "place_of_usual_residence": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/PublicSchemaLocation",
                    "description": "Alternative 1 for place of usual residence."
                  },
                  {
                    "type": "string",
                    "format": "uri",
                    "description": "Alternative 2 for place of usual residence."
                  }
                ],
                "description": "Closed PublicSchema Location object or URI reference for usual residence at the vital event."
              }
            },
            "description": "Composed constraint 3 for public schema crvs person; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for public schema crvs person in this non-normative Write example profile."
      },
      "PublicSchemaAddress": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Address.schema",
            "description": "Composed constraint 1 for public schema address; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "location": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/PublicSchemaLocation",
                    "description": "Alternative 1 for location."
                  },
                  {
                    "type": "string",
                    "format": "uri",
                    "description": "Alternative 2 for location."
                  }
                ],
                "description": "Closed PublicSchema Location object or URI reference."
              }
            },
            "description": "Composed constraint 2 for public schema address; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for public schema address in this non-normative Write example profile."
      },
      "PublicSchemaPerson": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Person.schema",
            "description": "Composed constraint 1 for public schema person; every composed constraint applies."
          },
          {
            "$ref": "#/components/schemas/JsonLdType",
            "description": "Composed constraint 2 for public schema person; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@type": {
                "const": "https://publicschema.org/Person",
                "description": "Canonical PublicSchema type URI for this object.",
                "type": "string"
              },
              "domicile": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/PublicSchemaAddress",
                    "description": "Alternative 1 for domicile."
                  },
                  {
                    "type": "string",
                    "format": "uri",
                    "description": "Alternative 2 for domicile."
                  }
                ],
                "description": "Closed PublicSchema Address object or URI reference for the person's permanent home."
              }
            },
            "description": "Composed constraint 3 for public schema person; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for public schema person in this non-normative Write example profile."
      },
      "EmbeddedNewPerson": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PublicSchemaPerson",
            "description": "Composed constraint 1 for embedded new person; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@id": {
                "$ref": "#/components/schemas/RequestLocalId",
                "description": "URI identity for the object; create commands restrict it to a declared request-local identifier."
              }
            },
            "required": [
              "@id",
              "@type",
              "given_name",
              "family_name"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "identifiers"
                  ],
                  "description": "Alternative 1 for embedded new person."
                },
                {
                  "required": [
                    "identity_documents"
                  ],
                  "description": "Alternative 2 for embedded new person."
                },
                {
                  "required": [
                    "biometric_samples"
                  ],
                  "description": "Alternative 3 for embedded new person."
                },
                {
                  "required": [
                    "group_memberships"
                  ],
                  "description": "Alternative 4 for embedded new person."
                }
              ],
              "description": "Forbidden field combination for embedded new person."
            },
            "description": "Composed constraint 2 for embedded new person; every composed constraint applies."
          }
        ],
        "description": "Schema for embedded new person in this non-normative Write example profile."
      },
      "BirthChildForDeclaration": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PublicSchemaCrvsPerson",
            "description": "Composed constraint 1 for birth child for declaration; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "person": {
                "$ref": "#/components/schemas/EmbeddedNewPerson",
                "description": "Typed Person object or authoritative Person reference permitted by this profile branch."
              }
            },
            "required": [
              "@type",
              "person"
            ],
            "description": "Composed constraint 2 for birth child for declaration; every composed constraint applies."
          }
        ],
        "description": "Schema for birth child for declaration in this non-normative Write example profile."
      },
      "PublicSchemaCrvsParent": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Parent.schema",
            "description": "Composed constraint 1 for public schema crvs parent; every composed constraint applies."
          },
          {
            "$ref": "#/components/schemas/JsonLdType",
            "description": "Composed constraint 2 for public schema crvs parent; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@type": {
                "const": "https://publicschema.org/crvs/Parent",
                "description": "Canonical PublicSchema type URI for this object.",
                "type": "string"
              },
              "place_of_usual_residence": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/PublicSchemaLocation",
                    "description": "Alternative 1 for place of usual residence."
                  },
                  {
                    "type": "string",
                    "format": "uri",
                    "description": "Alternative 2 for place of usual residence."
                  }
                ],
                "description": "Closed PublicSchema Location object or URI reference for usual residence at the vital event."
              }
            },
            "description": "Composed constraint 3 for public schema crvs parent; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for public schema crvs parent in this non-normative Write example profile."
      },
      "BirthParentForDeclaration": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PublicSchemaCrvsParent",
            "description": "Composed constraint 1 for birth parent for declaration; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "person": {
                "$ref": "#/components/schemas/ExistingPersonReference",
                "description": "Typed Person object or authoritative Person reference permitted by this profile branch."
              }
            },
            "required": [
              "@type",
              "person",
              "parental_role"
            ],
            "description": "Composed constraint 2 for birth parent for declaration; every composed constraint applies."
          }
        ],
        "description": "Schema for birth parent for declaration in this non-normative Write example profile."
      },
      "BirthEventForDeclaration": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PublicSchemaBirth",
            "description": "Composed constraint 1 for birth event for declaration; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@context": {
                "const": "https://publicschema.org/ctx/draft.jsonld",
                "description": "Pinned PublicSchema JSON-LD context used by this example instance.",
                "type": "string"
              },
              "@id": {
                "$ref": "#/components/schemas/RequestLocalId",
                "description": "URI identity for the object; create commands restrict it to a declared request-local identifier."
              },
              "event_location": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/PublicSchemaLocation",
                    "description": "Alternative 1 for event location."
                  },
                  {
                    "type": "string",
                    "format": "uri",
                    "description": "Alternative 2 for event location."
                  }
                ],
                "description": "PublicSchema `event_location` value retained with its published spelling and domain meaning."
              },
              "informant": {
                "$ref": "#/components/schemas/ExistingPersonReference",
                "description": "Authoritative reference to the existing Person who supplied the birth information."
              },
              "child": {
                "$ref": "#/components/schemas/BirthChildForDeclaration",
                "description": "Typed CRVS child wrapper containing the request-local new Person."
              },
              "parents": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "$ref": "#/components/schemas/BirthParentForDeclaration",
                  "description": "One parents array entry accepted by this profile."
                },
                "description": "Typed CRVS parent wrappers referencing existing Persons."
              }
            },
            "required": [
              "@context",
              "@id",
              "@type",
              "event_date",
              "child",
              "parents",
              "sex_at_birth"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "identifiers"
                  ],
                  "description": "Alternative 1 for birth event for declaration."
                },
                {
                  "required": [
                    "registration_date"
                  ],
                  "description": "Alternative 2 for birth event for declaration."
                },
                {
                  "required": [
                    "registration_location"
                  ],
                  "description": "Alternative 3 for birth event for declaration."
                },
                {
                  "required": [
                    "registration_type"
                  ],
                  "description": "Alternative 4 for birth event for declaration."
                },
                {
                  "required": [
                    "registrar"
                  ],
                  "description": "Alternative 5 for birth event for declaration."
                },
                {
                  "required": [
                    "registration_status"
                  ],
                  "description": "Alternative 6 for birth event for declaration."
                }
              ],
              "description": "Forbidden field combination for birth event for declaration."
            },
            "description": "Composed constraint 2 for birth event for declaration; every composed constraint applies."
          }
        ],
        "description": "Schema for birth event for declaration in this non-normative Write example profile."
      },
      "EvidenceReference": {
        "type": "object",
        "description": "A source-specific evidence pointer. It is intentionally outside the PublicSchema Birth event.",
        "properties": {
          "evidenceType": {
            "type": "string",
            "minLength": 1,
            "description": "Deployment-defined classification of the supporting evidence."
          },
          "reference": {
            "type": "string",
            "format": "uri",
            "description": "URI of the source-specific supporting evidence."
          },
          "issuedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "Z(?![\\s\\S])",
            "description": "UTC instant at which the referenced evidence was issued."
          }
        },
        "required": [
          "evidenceType",
          "reference"
        ],
        "additionalProperties": false
      },
      "BirthAnnotation": {
        "type": "object",
        "description": "Declaration or correction reason and evidence carried by the Write command, not by the PublicSchema Birth event.",
        "properties": {
          "reasonCode": {
            "type": "string",
            "minLength": 1,
            "description": "Deployment-defined reason code for the declaration or correction command."
          },
          "statement": {
            "type": "string",
            "minLength": 1,
            "description": "Human-readable rationale for the declaration or correction command."
          },
          "supportingEvidence": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/EvidenceReference",
              "description": "One supporting evidence array entry accepted by this profile."
            },
            "uniqueItems": true,
            "description": "Source-specific evidence references supporting the command."
          }
        },
        "required": [
          "reasonCode",
          "statement"
        ],
        "additionalProperties": false
      },
      "BirthDeclarationCommand": {
        "type": "object",
        "description": "A source command mapped to a PublicSchema Birth event. It is not the stored or read Birth resource.",
        "properties": {
          "transactionId": {
            "type": "string",
            "minLength": 8,
            "description": "Client-generated source-command correlation identifier; it does not replace the HTTP Idempotency-Key."
          },
          "birth": {
            "$ref": "#/components/schemas/BirthEventForDeclaration",
            "description": "Proposed PublicSchema Birth event content, projected only after authoritative commit."
          },
          "annotation": {
            "$ref": "#/components/schemas/BirthAnnotation",
            "description": "Command-only reason and evidence metadata that is not projected into the Birth event."
          }
        },
        "required": [
          "transactionId",
          "birth",
          "annotation"
        ],
        "additionalProperties": false
      },
      "SourceReference": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "system",
          "revision"
        ],
        "description": "Optional source-backed audit reference supplied with a mutation. Its presence does not require event sourcing or a history API, and the server validates it under source policy.",
        "properties": {
          "system": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048,
            "description": "Stable identifier of the source system or authority."
          },
          "revision": {
            "type": "string",
            "minLength": 1,
            "maxLength": 256,
            "description": "Source-backed revision identifier."
          },
          "recordedAt": {
            "type": "string",
            "format": "date-time",
            "pattern": "Z(?![\\s\\S])",
            "description": "UTC instant at which the source recorded this revision, when supplied."
          }
        },
        "examples": [
          {
            "system": "https://source.example/systems/register",
            "revision": "source-revision-17",
            "recordedAt": "2026-11-04T08:00:00Z"
          }
        ]
      },
      "SourceReference-2": {
        "$ref": "#/components/schemas/SourceReference",
        "description": "Schema for source reference in this non-normative Write example profile."
      },
      "StrongETag": {
        "type": "string",
        "minLength": 3,
        "maxLength": 258,
        "pattern": "^\"[\\x21\\x23-\\x7E]{1,256}\"(?![\\s\\S])",
        "description": "GovStack Write profile of one quoted strong entity tag using bounded visible ASCII opaque-tag characters. Weak W/ validators, wildcard, lists, spaces, controls, non-ASCII, and trailing input are not admitted.",
        "examples": [
          "\"record-7fa9\""
        ]
      },
      "RecordId": {
        "type": "string",
        "minLength": 1,
        "description": "Stable opaque identifier unique across all collections in the selected Registry, unchanged throughout the Record's lifecycle and never reassigned to a different Record. The same Record retains its identifier across collections and views. Suitable source identifiers are retained. Exposed identifiers are non-personal and safe for URL references. Collection actions occupy a separate namespace, so source identifiers such as lookup and search remain valid Record Identifiers.",
        "examples": [
          "r_42"
        ]
      },
      "StrongETag-2": {
        "$ref": "#/components/schemas/StrongETag",
        "description": "Schema for strong etag in this non-normative Write example profile."
      },
      "LocalReferenceResolution": {
        "type": "object",
        "properties": {
          "requestLocalId": {
            "$ref": "#/components/schemas/RequestLocalId",
            "description": "Request-local URI declared in the accepted command and resolved only after commit."
          },
          "collectionId": {
            "enum": [
              "birth-registrations",
              "households",
              "individuals"
            ],
            "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
            "type": "string"
          },
          "recordId": {
            "$ref": "#/components/schemas/RecordId"
          }
        },
        "required": [
          "requestLocalId",
          "collectionId",
          "recordId"
        ],
        "additionalProperties": false,
        "description": "Schema for local reference resolution in this non-normative Write example profile."
      },
      "Problem": {
        "type": "object",
        "description": "RFC 9457 problem details with one stable machine identifier in type and a trace identifier for correlation. Error text contains no personal data or system-internal detail.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "properties": {
          "type": {
            "type": "string",
            "format": "uri",
            "pattern": "^https://govstack\\.global/problems/[a-z][a-z0-9-]{1,30}/[a-z][a-z0-9]*(?:-[a-z0-9]+)*$",
            "description": "Stable GovStack problem-type URI and machine identifier in the form https://govstack.global/problems/{bb-code}/{problem-slug}, where the problem slug uses kebab-case."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Short human-readable summary of the problem type."
          },
          "status": {
            "type": "integer",
            "minimum": 400,
            "maximum": 599,
            "description": "HTTP status code for this occurrence."
          },
          "detail": {
            "type": "string",
            "description": "Human-readable explanation specific to this occurrence."
          },
          "instance": {
            "type": "string",
            "format": "uri-reference",
            "description": "URI reference identifying this problem occurrence."
          },
          "traceId": {
            "type": "string",
            "pattern": "^(?!0{32}$)[\\da-f]{32}$",
            "description": "The 32-hex-digit trace-id component of the effective request traceparent."
          }
        }
      },
      "FieldError": {
        "type": "object",
        "description": "Human-readable failure associated with one request field.",
        "required": [
          "pointer",
          "message"
        ],
        "properties": {
          "pointer": {
            "type": "string",
            "format": "json-pointer",
            "description": "JSON Pointer identifying the invalid request field."
          },
          "message": {
            "type": "string",
            "minLength": 1,
            "description": "Human-readable explanation of the field failure."
          }
        }
      },
      "ValidationProblem": {
        "description": "Problem details for a request containing one or more invalid fields.",
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Field-level validation details.",
            "required": [
              "errors"
            ],
            "properties": {
              "errors": {
                "type": "array",
                "minItems": 1,
                "description": "One entry for each request field that failed validation.",
                "items": {
                  "$ref": "#/components/schemas/FieldError"
                }
              }
            }
          }
        ]
      },
      "BadRequestProblem": {
        "description": "Malformed non-field input or request-body field validation failure.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "oneOf": [
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/ValidationProblem"
              },
              {
                "type": "object",
                "description": "Bind field validation failure to the 400 invalid-request problem type.",
                "required": [
                  "type",
                  "title",
                  "status",
                  "traceId"
                ],
                "properties": {
                  "type": {
                    "const": "https://govstack.global/problems/digital-registries/invalid-request",
                    "description": "Stable invalid-request problem type."
                  },
                  "status": {
                    "const": 400,
                    "description": "HTTP Bad Request status."
                  }
                }
              }
            ]
          },
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/Problem"
              },
              {
                "type": "object",
                "description": "Bind non-field request failure to the 400 bad-request problem type.",
                "required": [
                  "type",
                  "title",
                  "status",
                  "traceId"
                ],
                "properties": {
                  "type": {
                    "const": "https://govstack.global/problems/digital-registries/bad-request",
                    "description": "Stable bad-request problem type."
                  },
                  "status": {
                    "const": 400,
                    "description": "HTTP Bad Request status."
                  }
                },
                "not": {
                  "required": [
                    "errors"
                  ],
                  "description": "Non-field failure omits body-relative errors."
                }
              }
            ]
          }
        ]
      },
      "UnauthorizedProblem": {
        "description": "Authentication failed for the current HTTP request.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind authentication failure to the 401 problem identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/unauthorized",
                "description": "Stable unauthorized problem type."
              },
              "status": {
                "const": 401,
                "description": "HTTP Unauthorized status."
              }
            }
          }
        ]
      },
      "ForbiddenProblem": {
        "description": "Current authenticated context lacks the required grant.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind authorisation failure to the 403 problem identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/forbidden",
                "description": "Stable forbidden problem type."
              },
              "status": {
                "const": 403,
                "description": "HTTP Forbidden status."
              }
            }
          }
        ]
      },
      "CollectionNotAvailableProblem": {
        "description": "A Collection is absent or protected from disclosure.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind every concealed or absent Collection outcome to one stable identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/collection-not-available",
                "description": "Stable Collection-unavailable problem type."
              },
              "status": {
                "const": 404,
                "description": "HTTP Not Found status."
              }
            }
          }
        ]
      },
      "ConflictProblem": {
        "description": "State conflict or matching idempotent request still in flight.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "oneOf": [
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/Problem"
              },
              {
                "type": "object",
                "description": "Bind a resource or workflow state conflict to its 409 identity.",
                "required": [
                  "type",
                  "title",
                  "status",
                  "traceId"
                ],
                "properties": {
                  "type": {
                    "const": "https://govstack.global/problems/digital-registries/state-conflict",
                    "description": "Stable state-conflict problem type."
                  },
                  "status": {
                    "const": 409,
                    "description": "HTTP Conflict status."
                  }
                }
              }
            ]
          },
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/Problem"
              },
              {
                "type": "object",
                "description": "Bind a matching in-flight retry to its distinct 409 identity.",
                "required": [
                  "type",
                  "title",
                  "status",
                  "traceId"
                ],
                "properties": {
                  "type": {
                    "const": "https://govstack.global/problems/digital-registries/idempotency-in-flight",
                    "description": "Stable in-flight idempotency problem type."
                  },
                  "status": {
                    "const": 409,
                    "description": "HTTP Conflict status."
                  }
                }
              }
            ]
          }
        ]
      },
      "UnsupportedMediaTypeProblem": {
        "description": "Request Content-Type is not supported by the operation.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind request media-type rejection to the 415 problem identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/unsupported-media-type",
                "description": "Stable unsupported-media-type problem type."
              },
              "status": {
                "const": 415,
                "description": "HTTP Unsupported Media Type status."
              }
            }
          }
        ]
      },
      "UnprocessableContentProblem": {
        "description": "Semantic body validation failure or idempotency fingerprint mismatch.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "oneOf": [
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/ValidationProblem"
              },
              {
                "type": "object",
                "description": "Bind semantic field validation failure to its 422 identity.",
                "required": [
                  "type",
                  "title",
                  "status",
                  "traceId"
                ],
                "properties": {
                  "type": {
                    "const": "https://govstack.global/problems/digital-registries/invalid-content",
                    "description": "Stable invalid-content problem type."
                  },
                  "status": {
                    "const": 422,
                    "description": "HTTP Unprocessable Content status."
                  }
                }
              }
            ]
          },
          {
            "allOf": [
              {
                "$ref": "#/components/schemas/Problem"
              },
              {
                "type": "object",
                "description": "Bind idempotency fingerprint mismatch to its distinct 422 identity.",
                "required": [
                  "type",
                  "title",
                  "status",
                  "traceId"
                ],
                "properties": {
                  "type": {
                    "const": "https://govstack.global/problems/digital-registries/idempotency-fingerprint-mismatch",
                    "description": "Stable fingerprint-mismatch problem type."
                  },
                  "status": {
                    "const": 422,
                    "description": "HTTP Unprocessable Content status."
                  }
                },
                "not": {
                  "required": [
                    "errors"
                  ],
                  "description": "Fingerprint mismatch has no body-relative field errors."
                }
              }
            ]
          }
        ]
      },
      "TooManyRequestsProblem": {
        "description": "Caller-visible rate limit was exceeded.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind rate-limit rejection to the 429 problem identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/too-many-requests",
                "description": "Stable too-many-requests problem type."
              },
              "status": {
                "const": 429,
                "description": "HTTP Too Many Requests status."
              }
            }
          }
        ]
      },
      "InternalErrorProblem": {
        "description": "Unexpected server failure with no internal details.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind unexpected server failure to the 500 problem identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/internal-error",
                "description": "Stable internal-error problem type."
              },
              "status": {
                "const": 500,
                "description": "HTTP Internal Server Error status."
              }
            }
          }
        ]
      },
      "ServiceUnavailableProblem": {
        "description": "Service temporarily cannot accept work.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind temporary service unavailability to the 503 problem identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/service-unavailable",
                "description": "Stable service-unavailable problem type."
              },
              "status": {
                "const": 503,
                "description": "HTTP Service Unavailable status."
              }
            }
          }
        ]
      },
      "Household.schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "title": "Household",
        "description": "A social and economic unit of one or more persons who share food and other essentials for living. The operational definition varies across countries and programs, combining criteria of co-residence, shared budget, shared cooking, kinship, and administrative registration.\n",
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The full display name of the record. Depending on the concept, this is a person's or group's name, or the title of a program, instrument, scoring rule, or software product."
          },
          "identifiers": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Identifier.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identifiers carried by this entity, such as national ID numbers, program IDs, or identifiers asserted by an identity document."
            }
          },
          "identity_documents": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/IdentityDocument.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "Identity documents held by this party, such as passports, national identity cards, civil registration certificates, and program-issued beneficiary cards, or, for an organization, a certificate of registration."
            }
          },
          "group_type": {
            "type": "string",
            "enum": [
              "household",
              "family",
              "farm",
              "other"
            ],
            "$comment": "https://publicschema.org/vocab/group-type",
            "description": "An interoperability classifier for the category of group record being exchanged or exported. In native PublicSchema modeling, the concrete Group subtype is the authoritative signal when known."
          },
          "formation_date": {
            "type": "string",
            "format": "date",
            "description": "The date on which this group or organization was formed or registered."
          },
          "member_count": {
            "type": "integer",
            "description": "The total number of members in this household or group."
          },
          "memberships": {
            "type": "array",
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/GroupMembership.schema"
                },
                {
                  "type": "string",
                  "description": "URI or identifier reference"
                }
              ],
              "description": "The membership links connecting persons to this group, each carrying role and lifecycle dates."
            }
          },
          "address": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Address.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The physical or postal address associated with this household."
          },
          "location": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/Location.schema"
              },
              {
                "type": "string",
                "description": "URI or identifier reference"
              }
            ],
            "description": "The geographic location of the subject of this record, captured as coordinates or administrative area."
          },
          "food_security_level": {
            "type": "string",
            "enum": [
              "food_secure",
              "mildly_insecure",
              "moderately_insecure",
              "severely_insecure"
            ],
            "$comment": "https://publicschema.org/vocab/food-security-level",
            "description": "A coarse current-state summary of the household's food insecurity, used by operational systems for targeting and referral queries. This is NOT the raw output of a specific food-security assessment instrument: item-level responses (FCS, rCSI, LCS, HDDS, FIES, HHS, MDD-W, MAHFP) belong on a dedicated food-security profile published in a sibling schema (see ADR-011). Populate food_security_level from a Profile only by citing the instrument and cutoff rule that produced the band via a ScoringEvent; otherwise treat it as a self-declared or enumerator-judged summary."
          },
          "pregnant_or_lactating_count": {
            "type": "integer",
            "description": "The number of pregnant or lactating women currently living in the household. Used by humanitarian programs to size nutrition, health, and protection interventions (PLW-targeted food rations, antenatal care outreach, MIYCN counselling). Recorded at household level because the eligibility unit for most PLW programming is the household, not the individual; an individual-level pregnancy_status property is also available on Person for case-management workflows."
          },
          "chronic_illness_in_household": {
            "type": "boolean",
            "description": "Whether any household member is reported to have a chronic illness or long-term medical condition (e.g. hypertension, diabetes, HIV, TB, asthma). Recorded at household level for vulnerability triage and case-management referral; the specific condition and the affected member are recorded on Person-scoped or program-specific records, not here."
          }
        }
      },
      "PublicSchemaHousehold": {
        "allOf": [
          {
            "$ref": "#/components/schemas/Household.schema",
            "description": "Composed constraint 1 for public schema household; every composed constraint applies."
          },
          {
            "$ref": "#/components/schemas/JsonLdType",
            "description": "Composed constraint 2 for public schema household; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@type": {
                "const": "https://publicschema.org/Household",
                "description": "Canonical PublicSchema type URI for this object.",
                "type": "string"
              },
              "group_type": {
                "const": "household",
                "description": "PublicSchema `group_type` value retained with its published spelling and domain meaning.",
                "type": "string"
              },
              "address": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/PublicSchemaAddress",
                    "description": "Alternative 1 for address."
                  },
                  {
                    "type": "string",
                    "format": "uri",
                    "description": "Alternative 2 for address."
                  }
                ],
                "description": "PublicSchema `address` value retained with its published spelling and domain meaning."
              },
              "location": {
                "oneOf": [
                  {
                    "$ref": "#/components/schemas/PublicSchemaLocation",
                    "description": "Alternative 1 for location."
                  },
                  {
                    "type": "string",
                    "format": "uri",
                    "description": "Alternative 2 for location."
                  }
                ],
                "description": "Closed PublicSchema Location object or URI reference."
              }
            },
            "description": "Composed constraint 3 for public schema household; every composed constraint applies."
          }
        ],
        "not": {
          "anyOf": [
            {
              "required": [
                "identifiers"
              ],
              "description": "Alternative 1 for public schema household."
            },
            {
              "required": [
                "identity_documents"
              ],
              "description": "Alternative 2 for public schema household."
            }
          ],
          "description": "Forbidden field combination for public schema household."
        },
        "unevaluatedProperties": false,
        "description": "Schema for public schema household in this non-normative Write example profile."
      },
      "ExistingPersonMembership": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GroupMembership.schema",
            "description": "Composed constraint 1 for existing person membership; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "person": {
                "$ref": "#/components/schemas/ExistingPersonReference",
                "description": "Typed Person object or authoritative Person reference permitted by this profile branch."
              },
              "group": {
                "$ref": "#/components/schemas/RequestLocalId",
                "description": "Household reference bound either request-locally during create or authoritatively during transition."
              }
            },
            "required": [
              "person",
              "group",
              "role"
            ],
            "description": "Composed constraint 2 for existing person membership; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for existing person membership in this non-normative Write example profile."
      },
      "HouseholdWithExistingPersons": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PublicSchemaHousehold",
            "description": "Composed constraint 1 for household with existing persons; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@context": {
                "const": "https://publicschema.org/ctx/draft.jsonld",
                "description": "Pinned PublicSchema JSON-LD context used by this example instance.",
                "type": "string"
              },
              "@id": {
                "$ref": "#/components/schemas/RequestLocalId",
                "description": "URI identity for the object; create commands restrict it to a declared request-local identifier."
              },
              "memberships": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "$ref": "#/components/schemas/ExistingPersonMembership",
                  "description": "One memberships array entry accepted by this profile."
                },
                "description": "PublicSchema `memberships` value retained with its published spelling and domain meaning."
              }
            },
            "required": [
              "@context",
              "@id",
              "@type",
              "group_type",
              "name",
              "memberships"
            ],
            "description": "Composed constraint 2 for household with existing persons; every composed constraint applies."
          }
        ],
        "description": "Schema for household with existing persons in this non-normative Write example profile."
      },
      "EmbeddedPersonMembership": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GroupMembership.schema",
            "description": "Composed constraint 1 for embedded person membership; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "person": {
                "$ref": "#/components/schemas/EmbeddedNewPerson",
                "description": "Typed Person object or authoritative Person reference permitted by this profile branch."
              },
              "group": {
                "$ref": "#/components/schemas/RequestLocalId",
                "description": "Household reference bound either request-locally during create or authoritatively during transition."
              }
            },
            "required": [
              "person",
              "group",
              "role"
            ],
            "description": "Composed constraint 2 for embedded person membership; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for embedded person membership in this non-normative Write example profile."
      },
      "HouseholdCompoundCreate": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PublicSchemaHousehold",
            "description": "Composed constraint 1 for household compound create; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@context": {
                "const": "https://publicschema.org/ctx/draft.jsonld",
                "description": "Pinned PublicSchema JSON-LD context used by this example instance.",
                "type": "string"
              },
              "@id": {
                "$ref": "#/components/schemas/RequestLocalId",
                "description": "URI identity for the object; create commands restrict it to a declared request-local identifier."
              },
              "memberships": {
                "type": "array",
                "minItems": 1,
                "items": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ExistingPersonMembership",
                      "description": "Alternative 1 for memberships."
                    },
                    {
                      "$ref": "#/components/schemas/EmbeddedPersonMembership",
                      "description": "Alternative 2 for memberships."
                    }
                  ],
                  "description": "One memberships array entry accepted by this profile."
                },
                "contains": {
                  "$ref": "#/components/schemas/EmbeddedPersonMembership",
                  "description": "Required membership variant within memberships."
                },
                "minContains": 1,
                "description": "PublicSchema `memberships` value retained with its published spelling and domain meaning."
              }
            },
            "required": [
              "@context",
              "@id",
              "@type",
              "group_type",
              "name",
              "memberships"
            ],
            "description": "Composed constraint 2 for household compound create; every composed constraint applies."
          }
        ],
        "description": "Schema for household compound create in this non-normative Write example profile."
      },
      "IndividualCreateData": {
        "allOf": [
          {
            "$ref": "#/components/schemas/PublicSchemaPerson",
            "description": "Composed constraint 1 for individual create data; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "@context": {
                "const": "https://publicschema.org/ctx/draft.jsonld",
                "description": "Pinned PublicSchema JSON-LD context used by this example instance.",
                "type": "string"
              }
            },
            "required": [
              "@context",
              "@type",
              "given_name",
              "family_name"
            ],
            "not": {
              "anyOf": [
                {
                  "required": [
                    "identifiers"
                  ],
                  "description": "Alternative 1 for individual create data."
                },
                {
                  "required": [
                    "identity_documents"
                  ],
                  "description": "Alternative 2 for individual create data."
                },
                {
                  "required": [
                    "biometric_samples"
                  ],
                  "description": "Alternative 3 for individual create data."
                },
                {
                  "required": [
                    "group_memberships"
                  ],
                  "description": "Alternative 4 for individual create data."
                },
                {
                  "required": [
                    "@id"
                  ],
                  "description": "Alternative 5 for individual create data."
                }
              ],
              "description": "Forbidden field combination for individual create data."
            },
            "description": "Composed constraint 2 for individual create data; every composed constraint applies."
          }
        ],
        "description": "Schema for individual create data in this non-normative Write example profile."
      },
      "Record": {
        "type": "object",
        "description": "Record identity and its typed, permitted domain view. Registry identity, data schema and field meanings are supplied by the collection and operation binding. data may include nested objects, embedded relationship components, references and predefined related-data views with declared ownership and temporal semantics. Revision, lifecycle and provenance fields, when supplied, are source-backed. Readers accept additive envelope fields.",
        "required": [
          "recordId",
          "data"
        ],
        "properties": {
          "recordId": {
            "$ref": "#/components/schemas/RecordId"
          },
          "data": {
            "type": "object",
            "description": "Caller-authorised domain view. A field-selection operation admits omission of selectable fields within this same schema and always retains recordId and data. Deployments should reuse suitable established domain schemas and vocabularies, including national or sector schemas. The contract identifies adopted models and versions and binds their concepts to a concrete JSON Schema, documenting mappings, local constraints and extensions. The view may contain typed nested structures and relationships."
          }
        },
        "examples": [
          {
            "recordId": "r_42",
            "data": {
              "legalName": "Example Ltd",
              "registrationStatus": "DISSOLVED"
            }
          }
        ]
      },
      "RecordNotAvailableProblem": {
        "description": "A Record is absent, outside the selected Collection, or protected from disclosure.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind every concealed or absent Record outcome to the stable read identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/record-not-available",
                "description": "Stable Record-unavailable problem type."
              },
              "status": {
                "const": 404,
                "description": "HTTP Not Found status."
              }
            }
          }
        ]
      },
      "preferred_name": {
        "type": "string",
        "description": "The name a person is commonly known by, when it differs from their legal name. Covers chosen names, professional names, and naming conventions where given name plus family name is insufficient."
      },
      "PreconditionFailedProblem": {
        "description": "A supplied strong If-Match validator did not match current state.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind a failed If-Match comparison to the 412 problem identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/precondition-failed",
                "description": "Stable precondition-failed problem type."
              },
              "status": {
                "const": 412,
                "description": "HTTP Precondition Failed status."
              }
            }
          }
        ]
      },
      "PreconditionRequiredProblem": {
        "description": "Required If-Match header was absent.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind missing required If-Match to the 428 problem identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/precondition-required",
                "description": "Stable precondition-required problem type."
              },
              "status": {
                "const": 428,
                "description": "HTTP Precondition Required status."
              }
            }
          }
        ]
      },
      "event_date": {
        "type": "string",
        "format": "date",
        "description": "The date on which the vital event (birth, death, marriage, etc.) occurred. Distinct from the registration date, which is when the event was recorded by a registration authority."
      },
      "event_date_estimated": {
        "type": "boolean",
        "description": "Whether the event date is an estimate rather than a known exact date. Common for late-registered births or deaths where the precise date is not documented."
      },
      "registration_type": {
        "type": "string",
        "enum": [
          "current",
          "late",
          "court_ordered",
          "reconstruction"
        ],
        "$comment": "https://publicschema.org/vocab/crvs/registration-type",
        "description": "The regime under which the registration was processed: current (within the legal window), late, court-ordered, or reconstruction of a lost record. Affects legal weight and downstream uses."
      },
      "sex_at_birth": {
        "type": "string",
        "enum": [
          "not_known",
          "male",
          "female",
          "not_applicable"
        ],
        "$comment": "https://publicschema.org/vocab/sex",
        "description": "The sex of the child as observed and recorded at the time of birth. Distinct from any later legal or administrative sex marker."
      },
      "nationality_at_birth": {
        "type": "string",
        "$comment": "https://publicschema.org/vocab/country",
        "description": "The nationality acquired by the child at the time of birth, typically derived from parentage (jus sanguinis) or place of birth (jus soli) according to the applicable national law."
      },
      "place_type": {
        "type": "string",
        "enum": [
          "health_facility",
          "home",
          "en_route",
          "other",
          "unknown"
        ],
        "$comment": "https://publicschema.org/vocab/crvs/place-type",
        "description": "The category of place where the vital event occurred (health facility, home, en route, etc.). Complements the specific Location by describing what kind of setting it was."
      },
      "birth_type": {
        "type": "string",
        "enum": [
          "single",
          "twin",
          "triplet",
          "quadruplet",
          "quintuplet",
          "higher_order"
        ],
        "$comment": "https://publicschema.org/vocab/crvs/birth-type",
        "description": "Whether the birth was single, twin, triplet, or higher-order multiple. Captured at the level of the delivery, not per infant."
      },
      "birth_order": {
        "type": "integer",
        "description": "For multiple births, the sequence number of this infant among the siblings born in the same delivery (1 for first-born, 2 for second-born, etc.)."
      },
      "weight_at_birth": {
        "type": "number",
        "description": "The weight of the child at birth, recorded in grams. A core UN Principles and Recommendations vital statistics variable used to identify low birth weight."
      },
      "attendant_at_birth": {
        "type": "string",
        "enum": [
          "physician",
          "midwife",
          "nurse",
          "traditional_birth_attendant",
          "other",
          "none"
        ],
        "$comment": "https://publicschema.org/vocab/crvs/birth-attendant",
        "description": "The type of person who attended the delivery (physician, midwife, nurse, traditional birth attendant, other, or none). Used as a proxy for safe delivery in health statistics."
      },
      "BirthProjectionPatch": {
        "type": "object",
        "description": "A merge-patch-shaped subset that maps to the eventual PublicSchema Birth projection only after authoritative commit.",
        "properties": {
          "event_date": {
            "$ref": "#/components/schemas/event_date",
            "description": "PublicSchema `event_date` value retained with its published spelling and domain meaning."
          },
          "event_date_estimated": {
            "$ref": "#/components/schemas/event_date_estimated",
            "description": "PublicSchema `event_date_estimated` value retained with its published spelling and domain meaning."
          },
          "event_location": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/PublicSchemaLocation",
                "description": "Alternative 1 for event location."
              },
              {
                "type": "string",
                "format": "uri",
                "description": "Alternative 2 for event location."
              }
            ],
            "description": "PublicSchema `event_location` value retained with its published spelling and domain meaning."
          },
          "registration_location": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/PublicSchemaLocation",
                "description": "Alternative 1 for registration location."
              },
              {
                "type": "string",
                "format": "uri",
                "description": "Alternative 2 for registration location."
              }
            ],
            "description": "PublicSchema `registration_location` value retained with its published spelling and domain meaning."
          },
          "registration_type": {
            "$ref": "#/components/schemas/registration_type",
            "description": "PublicSchema `registration_type` value retained with its published spelling and domain meaning."
          },
          "sex_at_birth": {
            "$ref": "#/components/schemas/sex_at_birth",
            "description": "PublicSchema `sex_at_birth` value retained with its published spelling and domain meaning."
          },
          "nationality_at_birth": {
            "$ref": "#/components/schemas/nationality_at_birth",
            "description": "PublicSchema `nationality_at_birth` value retained with its published spelling and domain meaning."
          },
          "place_type": {
            "$ref": "#/components/schemas/place_type",
            "description": "PublicSchema `place_type` value retained with its published spelling and domain meaning."
          },
          "birth_type": {
            "$ref": "#/components/schemas/birth_type",
            "description": "PublicSchema `birth_type` value retained with its published spelling and domain meaning."
          },
          "birth_order": {
            "$ref": "#/components/schemas/birth_order",
            "description": "PublicSchema `birth_order` value retained with its published spelling and domain meaning."
          },
          "weight_at_birth": {
            "$ref": "#/components/schemas/weight_at_birth",
            "description": "PublicSchema `weight_at_birth` value retained with its published spelling and domain meaning."
          },
          "attendant_at_birth": {
            "$ref": "#/components/schemas/attendant_at_birth",
            "description": "PublicSchema `attendant_at_birth` value retained with its published spelling and domain meaning."
          }
        },
        "minProperties": 1,
        "additionalProperties": false
      },
      "BirthCorrectionCommand": {
        "type": "object",
        "description": "A correction command. Direct execution or approved application maps birthPatch into the PublicSchema Birth projection.",
        "properties": {
          "transactionId": {
            "type": "string",
            "minLength": 8,
            "description": "Client-generated source-command correlation identifier; it does not replace the HTTP Idempotency-Key."
          },
          "birthPatch": {
            "$ref": "#/components/schemas/BirthProjectionPatch",
            "description": "Partial Birth projection change; omitted properties remain unchanged and null values are rejected."
          },
          "annotation": {
            "$ref": "#/components/schemas/BirthAnnotation",
            "description": "Command-only reason and evidence metadata that is not projected into the Birth event."
          }
        },
        "required": [
          "transactionId",
          "birthPatch",
          "annotation"
        ],
        "additionalProperties": false
      },
      "ExistingHouseholdReference": {
        "type": "string",
        "pattern": "^https://registry\\.example/v1/collections/households/records/[A-Za-z0-9._~-]+$",
        "description": "Schema for existing household reference in this non-normative Write example profile."
      },
      "ExistingPersonMembershipForExistingHousehold": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GroupMembership.schema",
            "description": "Composed constraint 1 for existing person membership for existing household; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "person": {
                "$ref": "#/components/schemas/ExistingPersonReference",
                "description": "Typed Person object or authoritative Person reference permitted by this profile branch."
              },
              "group": {
                "$ref": "#/components/schemas/ExistingHouseholdReference",
                "description": "Household reference bound either request-locally during create or authoritatively during transition."
              }
            },
            "required": [
              "person",
              "group",
              "role"
            ],
            "description": "Composed constraint 2 for existing person membership for existing household; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for existing person membership for existing household in this non-normative Write example profile."
      },
      "EmbeddedPersonMembershipForExistingHousehold": {
        "allOf": [
          {
            "$ref": "#/components/schemas/GroupMembership.schema",
            "description": "Composed constraint 1 for embedded person membership for existing household; every composed constraint applies."
          },
          {
            "type": "object",
            "properties": {
              "person": {
                "$ref": "#/components/schemas/EmbeddedNewPerson",
                "description": "Typed Person object or authoritative Person reference permitted by this profile branch."
              },
              "group": {
                "$ref": "#/components/schemas/ExistingHouseholdReference",
                "description": "Household reference bound either request-locally during create or authoritatively during transition."
              }
            },
            "required": [
              "person",
              "group",
              "role"
            ],
            "description": "Composed constraint 2 for embedded person membership for existing household; every composed constraint applies."
          }
        ],
        "unevaluatedProperties": false,
        "description": "Schema for embedded person membership for existing household in this non-normative Write example profile."
      },
      "HouseholdAddMemberParameters": {
        "type": "object",
        "properties": {
          "membership": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/ExistingPersonMembershipForExistingHousehold",
                "description": "Alternative 1 for membership."
              },
              {
                "$ref": "#/components/schemas/EmbeddedPersonMembershipForExistingHousehold",
                "description": "Alternative 2 for membership."
              }
            ],
            "description": "PublicSchema household membership to add under the profile's source transaction guarantee."
          }
        },
        "required": [
          "membership"
        ],
        "additionalProperties": false,
        "description": "Schema for household add member parameters in this non-normative Write example profile."
      },
      "BirthDeclarationChangeRequest": {
        "type": "object",
        "properties": {
          "kind": {
            "const": "create",
            "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
            "type": "string"
          },
          "target": {
            "type": "object",
            "properties": {
              "collectionId": {
                "const": "birth-registrations",
                "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                "type": "string"
              }
            },
            "required": [
              "collectionId"
            ],
            "additionalProperties": false,
            "description": "Collection and, when applicable, Record selected by the proposal."
          },
          "input": {
            "$ref": "#/components/schemas/BirthDeclarationCreateInput",
            "description": "Concrete typed input that would be used by the corresponding direct operation."
          }
        },
        "required": [
          "kind",
          "target",
          "input"
        ],
        "additionalProperties": false,
        "description": "Schema for birth declaration change request in this non-normative Write example profile."
      },
      "HouseholdCreateChangeRequest": {
        "type": "object",
        "properties": {
          "kind": {
            "const": "create",
            "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
            "type": "string"
          },
          "target": {
            "type": "object",
            "properties": {
              "collectionId": {
                "const": "households",
                "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                "type": "string"
              }
            },
            "required": [
              "collectionId"
            ],
            "additionalProperties": false,
            "description": "Collection and, when applicable, Record selected by the proposal."
          },
          "input": {
            "$ref": "#/components/schemas/HouseholdCreateInput",
            "description": "Concrete typed input that would be used by the corresponding direct operation."
          }
        },
        "required": [
          "kind",
          "target",
          "input"
        ],
        "additionalProperties": false,
        "description": "Schema for household create change request in this non-normative Write example profile."
      },
      "IndividualCreateChangeRequest": {
        "type": "object",
        "properties": {
          "kind": {
            "const": "create",
            "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
            "type": "string"
          },
          "target": {
            "type": "object",
            "properties": {
              "collectionId": {
                "const": "individuals",
                "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                "type": "string"
              }
            },
            "required": [
              "collectionId"
            ],
            "additionalProperties": false,
            "description": "Collection and, when applicable, Record selected by the proposal."
          },
          "input": {
            "$ref": "#/components/schemas/IndividualCreateInput",
            "description": "Concrete typed input that would be used by the corresponding direct operation."
          }
        },
        "required": [
          "kind",
          "target",
          "input"
        ],
        "additionalProperties": false,
        "description": "Schema for individual create change request in this non-normative Write example profile."
      },
      "CreateChangeRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/BirthDeclarationChangeRequest",
            "description": "Alternative 1 for create change request."
          },
          {
            "$ref": "#/components/schemas/HouseholdCreateChangeRequest",
            "description": "Alternative 2 for create change request."
          },
          {
            "$ref": "#/components/schemas/IndividualCreateChangeRequest",
            "description": "Alternative 3 for create change request."
          }
        ],
        "description": "Schema for create change request in this non-normative Write example profile."
      },
      "BirthCorrectionChangeRequest": {
        "type": "object",
        "properties": {
          "kind": {
            "const": "transition",
            "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
            "type": "string"
          },
          "target": {
            "type": "object",
            "properties": {
              "collectionId": {
                "const": "birth-registrations",
                "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                "type": "string"
              },
              "recordId": {
                "$ref": "#/components/schemas/RecordId"
              }
            },
            "required": [
              "collectionId",
              "recordId"
            ],
            "additionalProperties": false,
            "description": "Collection and, when applicable, Record selected by the proposal."
          },
          "baseETag": {
            "$ref": "#/components/schemas/StrongETag-2",
            "description": "Strong target Record validator checked by the independently authorised application worker at commit."
          },
          "input": {
            "$ref": "#/components/schemas/BirthCorrectionInput",
            "description": "Concrete typed input that would be used by the corresponding direct operation."
          }
        },
        "required": [
          "kind",
          "target",
          "baseETag",
          "input"
        ],
        "additionalProperties": false,
        "description": "Schema for birth correction change request in this non-normative Write example profile."
      },
      "HouseholdAddMemberChangeRequest": {
        "type": "object",
        "properties": {
          "kind": {
            "const": "transition",
            "description": "Write kind: create proposes a new Record, update proposes a merge patch, and transition proposes a fixed named action.",
            "type": "string"
          },
          "target": {
            "type": "object",
            "properties": {
              "collectionId": {
                "const": "households",
                "description": "Collection identifier: birth-registrations contains Birth projections, households contains Household records, and individuals contains Person records.",
                "type": "string"
              },
              "recordId": {
                "$ref": "#/components/schemas/RecordId"
              }
            },
            "required": [
              "collectionId",
              "recordId"
            ],
            "additionalProperties": false,
            "description": "Collection and, when applicable, Record selected by the proposal."
          },
          "baseETag": {
            "$ref": "#/components/schemas/StrongETag-2",
            "description": "Strong target Record validator checked by the independently authorised application worker at commit."
          },
          "input": {
            "$ref": "#/components/schemas/HouseholdAddMemberInput",
            "description": "Concrete typed input that would be used by the corresponding direct operation."
          }
        },
        "required": [
          "kind",
          "target",
          "baseETag",
          "input"
        ],
        "additionalProperties": false,
        "description": "Schema for household add member change request in this non-normative Write example profile."
      },
      "TransitionChangeRequest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/BirthCorrectionChangeRequest",
            "description": "Alternative 1 for transition change request."
          },
          {
            "$ref": "#/components/schemas/HouseholdAddMemberChangeRequest",
            "description": "Alternative 2 for transition change request."
          }
        ],
        "description": "Schema for transition change request in this non-normative Write example profile."
      },
      "ProcessingError": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "format": "uri",
            "description": "Stable URI identifying the processing-error category."
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Short human-readable processing-error summary."
          },
          "detail": {
            "type": "string",
            "description": "Optional human-readable processing-error detail suitable for the authorised caller."
          },
          "traceId": {
            "type": "string",
            "pattern": "^(?!0{32}$)[0-9a-f]{32}$",
            "description": "Trace identifier used to correlate the processing failure without exposing protected data."
          }
        },
        "required": [
          "type",
          "title",
          "traceId"
        ],
        "additionalProperties": false,
        "description": "Schema for processing error in this non-normative Write example profile."
      },
      "NotAvailableProblem": {
        "description": "Resource is absent, out of scope, or protected from existence disclosure.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind concealed or absent resource outcomes to one 404 identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/not-available",
                "description": "Stable not-available problem type."
              },
              "status": {
                "const": 404,
                "description": "HTTP Not Found status."
              }
            }
          }
        ]
      },
      "OpaqueId": {
        "type": "string",
        "minLength": 1,
        "maxLength": 256,
        "pattern": "^[A-Za-z0-9][A-Za-z0-9._~-]{0,255}(?![\\s\\S])",
        "description": "Opaque, non-personal identifier with no client-inferred internal format.",
        "examples": [
          "op_7"
        ]
      },
      "NotAcceptableProblem": {
        "description": "No response representation satisfies the request Accept header.",
        "required": [
          "type",
          "title",
          "status",
          "traceId"
        ],
        "allOf": [
          {
            "$ref": "#/components/schemas/Problem"
          },
          {
            "type": "object",
            "description": "Bind representation negotiation failure to the 406 problem identity.",
            "required": [
              "type",
              "title",
              "status",
              "traceId"
            ],
            "properties": {
              "type": {
                "const": "https://govstack.global/problems/digital-registries/not-acceptable",
                "description": "Stable not-acceptable problem type."
              },
              "status": {
                "const": 406,
                "description": "HTTP Not Acceptable status."
              }
            }
          }
        ]
      },
      "ReviewDecisionInput": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "comment"
        ],
        "description": "Optional body for a review action. `comment` is retained governance context only, not authoritative Record data, actor identity, trusted purpose, approval state, or a substitute for the operation selected by the request URI and current authorisation.",
        "properties": {
          "comment": {
            "type": "string",
            "minLength": 1,
            "maxLength": 2000,
            "description": "Human review note safe for the Change Request's authorised audience."
          }
        },
        "examples": [
          {
            "comment": "Reviewed against the submitted evidence."
          }
        ]
      }
    },
    "responses": {
      "BirthRecordCreated": {
        "description": "Birth declaration and request-local child Person committed under the example source transaction.",
        "headers": {
          "Location": {
            "$ref": "#/components/headers/Location"
          },
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PublicSchemaWriteResult"
            },
            "example": {
              "collectionId": "birth-registrations",
              "recordId": "birth_20",
              "etag": "\"birth-v1\"",
              "requestLocalReferences": [
                {
                  "requestLocalId": "urn:request-local:birth-event",
                  "collectionId": "birth-registrations",
                  "recordId": "birth_20"
                },
                {
                  "requestLocalId": "urn:request-local:child",
                  "collectionId": "individuals",
                  "recordId": "person_101"
                }
              ]
            }
          }
        }
      },
      "HouseholdRecordCreated": {
        "description": "Household and any explicitly declared same-source embedded Persons committed atomically.",
        "headers": {
          "Location": {
            "$ref": "#/components/headers/Location"
          },
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PublicSchemaWriteResult"
            },
            "example": {
              "collectionId": "households",
              "recordId": "household_8",
              "etag": "\"household-v1\"",
              "requestLocalReferences": [
                {
                  "requestLocalId": "urn:request-local:household-existing",
                  "collectionId": "households",
                  "recordId": "household_8"
                }
              ]
            }
          }
        }
      },
      "IndividualRecordCreated": {
        "description": "Individual Person Record committed with an authority-assigned Record identifier.",
        "headers": {
          "Location": {
            "$ref": "#/components/headers/Location"
          },
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PublicSchemaWriteResult"
            },
            "example": {
              "collectionId": "individuals",
              "recordId": "person_105",
              "etag": "\"person-v1\""
            }
          }
        }
      },
      "BirthTransitionApplied": {
        "description": "Birth correction committed authoritatively with a new strong target ETag.",
        "headers": {
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PublicSchemaWriteResult"
            },
            "example": {
              "collectionId": "birth-registrations",
              "recordId": "birth_19",
              "etag": "\"birth-v8\""
            }
          }
        }
      },
      "HouseholdTransitionApplied": {
        "description": "Household membership transition committed atomically with a new strong target ETag.",
        "headers": {
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PublicSchemaWriteResult"
            },
            "example": {
              "collectionId": "households",
              "recordId": "household_8",
              "etag": "\"household-v2\""
            }
          }
        }
      },
      "ChangeRequestCreated": {
        "description": "Immutable pending proposal created; no authoritative Record effect has occurred.",
        "headers": {
          "Location": {
            "$ref": "#/components/headers/Location"
          },
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PublicSchemaChangeRequest"
            },
            "example": {
              "changeRequestId": "cr_birth_correction_2",
              "proposalVersion": 1,
              "kind": "transition",
              "target": {
                "collectionId": "birth-registrations",
                "recordId": "birth_19"
              },
              "baseETag": "\"birth-v8\"",
              "input": {
                "name": "correct-birth",
                "parameters": {
                  "transactionId": "tx-birth-correction-review-001",
                  "birthPatch": {
                    "event_location": {
                      "location_name": "North District Hospital"
                    }
                  },
                  "annotation": {
                    "reasonCode": "clerical_error",
                    "statement": "Correct from the facility record."
                  }
                }
              },
              "reviewState": "pending",
              "applicationState": "not-started",
              "submittedAt": "2026-11-04T03:00:00Z",
              "updatedAt": "2026-11-04T03:00:00Z"
            }
          }
        }
      },
      "ChangeRequest": {
        "description": "One visible proposal with review and application state represented independently.",
        "headers": {
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/PublicSchemaChangeRequest"
            },
            "example": {
              "changeRequestId": "cr_birth_correction_2",
              "proposalVersion": 1,
              "kind": "transition",
              "target": {
                "collectionId": "birth-registrations",
                "recordId": "birth_19"
              },
              "baseETag": "\"birth-v8\"",
              "input": {
                "name": "correct-birth",
                "parameters": {
                  "transactionId": "tx-birth-correction-review-001",
                  "birthPatch": {
                    "event_location": {
                      "location_name": "North District Hospital"
                    }
                  },
                  "annotation": {
                    "reasonCode": "clerical_error",
                    "statement": "Correct from the facility record."
                  }
                }
              },
              "reviewState": "pending",
              "applicationState": "not-started",
              "submittedAt": "2026-11-04T03:00:00Z",
              "updatedAt": "2026-11-04T03:00:00Z"
            }
          }
        }
      },
      "ChangeRequestApproved": {
        "description": "Approval recorded without attempting authoritative application.",
        "headers": {
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ApprovedPublicSchemaDecisionReceipt"
            },
            "example": {
              "changeRequestId": "cr_birth_correction_2",
              "proposalVersion": 1,
              "kind": "transition",
              "target": {
                "collectionId": "birth-registrations",
                "recordId": "birth_19"
              },
              "baseETag": "\"birth-v8\"",
              "input": {
                "name": "correct-birth",
                "parameters": {
                  "transactionId": "tx-birth-correction-review-001",
                  "birthPatch": {
                    "event_location": {
                      "location_name": "North District Hospital"
                    }
                  },
                  "annotation": {
                    "reasonCode": "clerical_error",
                    "statement": "Correct from the facility record."
                  }
                }
              },
              "reviewState": "approved",
              "applicationState": "not-started",
              "submittedAt": "2026-11-04T03:00:00Z",
              "updatedAt": "2026-11-04T03:05:00Z"
            }
          }
        }
      },
      "ChangeRequestRejected": {
        "description": "Rejection recorded without changing any authoritative Record.",
        "headers": {
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/RejectedPublicSchemaDecisionReceipt"
            },
            "example": {
              "changeRequestId": "cr_birth_correction_2",
              "proposalVersion": 1,
              "kind": "transition",
              "target": {
                "collectionId": "birth-registrations",
                "recordId": "birth_19"
              },
              "baseETag": "\"birth-v8\"",
              "input": {
                "name": "correct-birth",
                "parameters": {
                  "transactionId": "tx-birth-correction-review-001",
                  "birthPatch": {
                    "event_location": {
                      "location_name": "North District Hospital"
                    }
                  },
                  "annotation": {
                    "reasonCode": "clerical_error",
                    "statement": "Correct from the facility record."
                  }
                }
              },
              "reviewState": "rejected",
              "applicationState": "not-started",
              "submittedAt": "2026-11-04T03:00:00Z",
              "updatedAt": "2026-11-04T03:05:00Z"
            }
          }
        }
      },
      "WriteBadRequest": {
        "description": "Malformed input, including missing or malformed required Idempotency-Key.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/BadRequestProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/bad-request",
              "title": "Bad request",
              "status": 400,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteUnauthorized": {
        "description": "Missing or invalid access token.",
        "headers": {
          "WWW-Authenticate": {
            "$ref": "#/components/headers/WwwAuthenticate"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/UnauthorizedProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/unauthorized",
              "title": "Authentication required",
              "status": 401,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteForbidden": {
        "description": "Authenticated caller is not authorised for this operation.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/ForbiddenProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/forbidden",
              "title": "Not authorised",
              "status": 403,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteCollectionNotAvailable": {
        "description": "Collection is absent or its existence is protected. This is the same stable public Collection-not-available outcome used by Read operations.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/CollectionNotAvailableProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/collection-not-available",
              "title": "Collection not available",
              "status": 404,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "Conflict": {
        "description": "Current state conflicts with the operation, or a matching idempotent retry remains in flight. Failed If-Match uses 412 instead.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/ConflictProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/state-conflict",
              "title": "Current state conflicts with the request",
              "status": 409,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteUnsupportedMediaType": {
        "description": "Request Content-Type is not supported by this operation.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/UnsupportedMediaTypeProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/unsupported-media-type",
              "title": "Unsupported media type",
              "status": 415,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "UnprocessableContent": {
        "description": "Well-formed input violates semantics, or Idempotency-Key is reused in the same scope with a different request fingerprint.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/UnprocessableContentProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/idempotency-fingerprint-mismatch",
              "title": "Idempotency key fingerprint mismatch",
              "status": 422,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteTooManyRequests": {
        "description": "Caller-visible rate limit exceeded.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/RetryAfter"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/TooManyRequestsProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/too-many-requests",
              "title": "Rate limit exceeded",
              "status": 429,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteInternalError": {
        "description": "Unexpected server failure with no internal detail.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/InternalErrorProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/internal-error",
              "title": "Internal server error",
              "status": 500,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteServiceUnavailable": {
        "description": "Service temporarily unavailable.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/RetryAfter"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/ServiceUnavailableProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/service-unavailable",
              "title": "Service unavailable",
              "status": 503,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "Record": {
        "description": "One permitted Record in the published view. Retrieve and Lookup share this envelope. ETag is not required unless conditional-read is selected by Retrieve.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          },
          "ETag": {
            "$ref": "#/components/headers/ETag"
          }
        },
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Record"
            }
          }
        }
      },
      "NotModified": {
        "description": "A Retrieve selecting conditional-read matches its representation validator after authorisation; the response is bodyless.",
        "headers": {
          "ETag": {
            "$ref": "#/components/headers/ConditionalETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          }
        }
      },
      "BadRequest": {
        "description": "`bad-request` identifies malformed or structurally invalid input, including malformed\nJSON, missing or undeclared body members, and incorrect JSON types. It also identifies\ninvalid or unsupported query parameters or invalid pagination controls, such as an\nout-of-range `pageSize`. When `field-selection` is selected, empty, duplicate,\nincorrectly typed or out-of-bounds selections and unsupported `fields` query values\nuse `400`.\n\n`invalid-cursor` identifies a malformed, expired, or mismatched continuation,\nincluding changed path selectors such as a `revision-list` parent `recordId`, request\ncriteria, ordering, effective `pageSize`, field or temporal selection, or trusted purpose.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "examples": {
              "malformed": {
                "value": {
                  "type": "https://govstack.global/problems/digital-registries/bad-request",
                  "title": "Invalid request",
                  "status": 400,
                  "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
                }
              },
              "structure": {
                "summary": "A required request member is missing",
                "value": {
                  "type": "https://govstack.global/problems/digital-registries/bad-request",
                  "title": "Invalid request",
                  "status": 400,
                  "detail": "The request is missing a required member.",
                  "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
                }
              },
              "cursor": {
                "value": {
                  "type": "https://govstack.global/problems/digital-registries/invalid-cursor",
                  "title": "Invalid continuation",
                  "status": 400,
                  "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
                }
              }
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Missing or invalid access token; the problem reveals no record existence.",
        "headers": {
          "WWW-Authenticate": {
            "$ref": "#/components/headers/WwwAuthenticate"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/unauthorized",
              "title": "Authentication required",
              "status": 401,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "Forbidden": {
        "description": "Access to the operation or view is denied. Protected Record existence uses the 404 response.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/forbidden",
              "title": "Operation not permitted",
              "status": 403,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "RecordNotAvailable": {
        "description": "Absent Records, Records outside the declared collection and protected existence return the same status, problem type and public detail. Record-specific counts and hints are withheld.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/RecordNotAvailableProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/record-not-available",
              "title": "Record not available",
              "status": 404,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "NotAcceptable": {
        "description": "The requested response media type is not supported.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/not-acceptable",
              "title": "Response media type not supported",
              "status": 406,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "TooManyRequests": {
        "description": "The gateway enforces its published quota scope and supplies Retry-After. Advisory RateLimit headers are gateway-owned.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/RetryAfter"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/too-many-requests",
              "title": "Request rate exceeded",
              "status": 429,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "InternalError": {
        "description": "Request failure, including a source contract violation. Protected-existence policy precedes Record-specific diagnostics. Problem text excludes personal data, source counts and internal details; type is the sole machine identifier, with code and timestamp omitted.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/internal-error",
              "title": "Request could not be completed",
              "status": 500,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "ServiceUnavailable": {
        "description": "The service temporarily cannot accept work; no dependency topology is exposed.",
        "headers": {
          "Retry-After": {
            "$ref": "#/components/headers/RetryAfter"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/CacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/Problem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/service-unavailable",
              "title": "Service temporarily unavailable",
              "status": 503,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteRecordNotAvailable": {
        "description": "Record is absent, outside the collection, or its existence is protected. This is the same stable public Record-not-available outcome used by the companion read.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/RecordNotAvailableProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/record-not-available",
              "title": "Record not available",
              "status": 404,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "PreconditionFailed": {
        "description": "If-Match did not match the current strong validator.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/PreconditionFailedProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/precondition-failed",
              "title": "Source state changed",
              "status": 412,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "PreconditionRequired": {
        "description": "Required If-Match was absent.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/PreconditionRequiredProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/precondition-required",
              "title": "If-Match is required",
              "status": 428,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "TargetNotAvailable": {
        "description": "Proposal target is absent, outside the allowed Registry context, or protected from existence disclosure.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/NotAvailableProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/not-available",
              "title": "Resource not available",
              "status": 404,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteNotModified": {
        "description": "Conditional GET validator matched; response is bodyless.",
        "headers": {
          "ETag": {
            "$ref": "#/components/headers/StrongETag"
          },
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        }
      },
      "ChangeRequestNotAvailable": {
        "description": "Change request is absent or its existence is protected.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/NotAvailableProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/not-available",
              "title": "Resource not available",
              "status": 404,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      },
      "WriteNotAcceptable": {
        "description": "No response representation matches Accept.",
        "headers": {
          "Cache-Control": {
            "$ref": "#/components/headers/WriteCacheControl"
          }
        },
        "content": {
          "application/problem+json": {
            "schema": {
              "$ref": "#/components/schemas/NotAcceptableProblem"
            },
            "example": {
              "type": "https://govstack.global/problems/digital-registries/not-acceptable",
              "title": "Representation not available",
              "status": 406,
              "traceId": "6f1c3f0e2a9b4c8d7e6f5a4b3c2d1e0f"
            }
          }
        }
      }
    },
    "headers": {
      "Location": {
        "description": "URI of the created Record, change request, or asynchronous Operation.",
        "required": true,
        "schema": {
          "type": "string",
          "format": "uri-reference"
        }
      },
      "StrongETag": {
        "description": "Strong validator suitable for If-Match; weak validators are forbidden. On a selected Record companion read it is also an opaque mutation guard, without encoded source values or any grant of authority.",
        "required": true,
        "schema": {
          "$ref": "#/components/schemas/StrongETag"
        },
        "example": "\"record-7fa9\""
      },
      "WriteCacheControl": {
        "description": "Required no-store policy for protected Write and workflow responses.",
        "required": true,
        "schema": {
          "type": "string",
          "const": "no-store"
        }
      },
      "WwwAuthenticate": {
        "description": "Bearer authentication challenge, with no record-specific facts.",
        "schema": {
          "type": "string"
        },
        "example": "Bearer"
      },
      "RetryAfter": {
        "description": "Delay in seconds or HTTP-date before retrying; authoritative over any advisory quota fields.",
        "schema": {
          "type": "string"
        },
        "example": "30"
      },
      "CacheControl": {
        "description": "Protected reads and errors use no-store. Deployments may publish another caching policy for public or properly isolated representations while preserving authorisation.",
        "schema": {
          "type": "string",
          "const": "no-store"
        }
      },
      "ETag": {
        "description": "HTTP representation validator, which may be omitted; it is not a source revision identifier.",
        "schema": {
          "type": "string"
        },
        "example": "W/\"representation-7fa9\""
      },
      "ConditionalETag": {
        "description": "Required representation validator on 200 and 304 responses of Retrieve selecting conditional-read. It identifies the permitted representation, effective field and temporal selection, and effective trusted purpose context, not a source revision.",
        "required": true,
        "schema": {
          "type": "string"
        },
        "example": "W/\"representation-7fa9\""
      }
    }
  }
}