{
  "openapi": "3.1.0",
  "info": {
    "title": "CentriPOS Retail API",
    "version": "2026-08-24",
    "description": "Comprehensive, versioned retail operations contract. All examples are synthetic. Public operations are live. Private operations marked authenticated-live are operational only for explicitly entitled tenants with tenant-bound keys and least-privilege scopes. Operations marked certified-live additionally require separate tenant and API-client checkout certification. Private POS operations remain controlled-rollout until tenant-scoped keys, scopes, sandbox isolation, audit logs, idempotency, and webhooks are enforced end to end.",
    "termsOfService": "https://getcentri.com/terms",
    "contact": {
      "name": "CentriPOS Developer Support",
      "url": "https://support.centripos.com/support",
      "email": "support@getcentri.com"
    }
  },
  "externalDocs": {
    "description": "CentriPOS Developer Platform",
    "url": "https://support.centripos.com/developers/"
  },
  "servers": [
    {
      "url": "https://pos.getcentri.com",
      "description": "Branded CentriPOS edge. Entitled authenticated-live operations are enabled; all non-enabled operations fail closed."
    }
  ],
  "tags": [
    {
      "name": "Sales & receipts",
      "description": "Transactions, line items, tenders, returns, receipts, shifts, and closures."
    },
    {
      "name": "Catalog",
      "description": "Products, variants, taxonomy, media, attributes, custom fields, and price books."
    },
    {
      "name": "Inventory",
      "description": "Levels, reservations, movements, adjustments, counts, transfers, and serials."
    },
    {
      "name": "Customers",
      "description": "People, companies, households, groups, addresses, balances, notes, and history."
    },
    {
      "name": "Invoicing",
      "description": "Account invoices, line items, payments, balances, billing schedules, and project links."
    },
    {
      "name": "Service Center",
      "description": "Service tickets, visits, work orders, charges, time, warranties, and recurring plans."
    },
    {
      "name": "Projects & work",
      "description": "Projects, boards, milestones, tasks, dependencies, comments, approvals, and linked billing."
    },
    {
      "name": "Orders & fulfillment",
      "description": "Orders, pickup, delivery, shipping, capacity, shipments, and tracking events."
    },
    {
      "name": "Purchasing",
      "description": "Suppliers, purchase orders, receiving, cost lists, and supplier returns."
    },
    {
      "name": "Pricing & tax",
      "description": "Price books, promotions, coupons, taxes, and eligibility evaluation."
    },
    {
      "name": "Merchant setup",
      "description": "Merchant projection, locations, registers, users, roles, and payment types."
    },
    {
      "name": "Reports & exports",
      "description": "Approved aggregates, saved reports, asynchronous exports, and register summaries."
    },
    {
      "name": "Webhooks & audit",
      "description": "Subscriptions, immutable events, delivery attempts, redelivery, and request logs."
    },
    {
      "name": "Events & scheduled offerings",
      "description": "Offerings, occurrences, capacity pools, event-ticket products, participants, registrations, attendance, waitlists, assets, and publication feeds."
    },
    {
      "name": "Company calendar",
      "description": "Canonical event, delivery, service, project, work, staff, external, and custom schedule entries."
    },
    {
      "name": "Public storefront",
      "description": "Published, browser-safe catalog and theme projections."
    }
  ],
  "paths": {
    "/api/retail/v1/sales": {
      "get": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "List sales",
        "description": "List sales",
        "operationId": "list_sales",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "required": false,
            "description": "Opaque customer identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List sales response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SalePage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "sale_test_01J9EXAMPLE",
                      "object": "sale",
                      "status": "synthetic_example",
                      "name": "Example sale",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_sale_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "sales:read"
      },
      "post": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "Create a sale",
        "description": "Create a sale Requires Idempotency-Key. Payment capture is a separately certified surface.",
        "operationId": "create_sale",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "location_id": {
                    "type": "string"
                  },
                  "register_id": {
                    "type": "string"
                  },
                  "customer_id": {
                    "type": "string"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "line_items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "variant_id": {
                          "type": "string"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "variant_id",
                        "quantity"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "location_id",
                  "register_id",
                  "customer_id",
                  "currency",
                  "line_items"
                ],
                "additionalProperties": false
              },
              "example": {
                "location_id": "loc_test_01J9NORTHSTAR",
                "register_id": "reg_test_01J9FRONT01",
                "customer_id": "cus_test_01J9ALEXMORGAN",
                "currency": "USD",
                "line_items": [
                  {
                    "variant_id": "var_test_01J9HARBORQUEEN",
                    "quantity": 1
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a sale response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaleEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "sal_test_01J9NEWSALE",
                    "object": "sale",
                    "status": "accepted",
                    "name": "Example sale",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_sale_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "sales:write"
      }
    },
    "/api/retail/v1/sales/{sale_id}": {
      "get": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "Get a complete sale",
        "description": "Retrieve the full whitelisted transaction projection, including line snapshots, discounts, taxes, tenders, fulfillment, returns, and invoice links.",
        "operationId": "get_sale",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "sale_id",
            "in": "path",
            "required": true,
            "description": "Opaque sale id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a complete sale response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SaleEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "sal_test_01J9SALE10482",
                    "sale_number": "S-10482",
                    "status": "completed",
                    "channel": "in_store",
                    "currency": "USD",
                    "location": {
                      "id": "loc_test_01J9NORTHSTAR",
                      "name": "Northstar Main Store",
                      "code": "MAIN",
                      "timezone": "America/Chicago"
                    },
                    "register": {
                      "id": "reg_test_01J9FRONT01",
                      "name": "Front Register",
                      "code": "FRONT-1"
                    },
                    "register_session": {
                      "id": "rsn_test_01J9SHIFT7",
                      "opened_at": "2026-08-24T13:00:00Z"
                    },
                    "cashier": {
                      "id": "usr_test_01J9CASEY",
                      "display_name": "Casey Reed"
                    },
                    "associate": {
                      "id": "usr_test_01J9JORDAN",
                      "display_name": "Jordan Lee",
                      "attribution": "sale"
                    },
                    "customer": {
                      "id": "cus_test_01J9ALEXMORGAN",
                      "first_name": "Alex",
                      "last_name": "Morgan",
                      "display_name": "Alex Morgan",
                      "email": "alex.morgan@example.test",
                      "phone": "+1-555-010-0184",
                      "customer_group": {
                        "id": "cgrp_test_household",
                        "name": "Household"
                      },
                      "marketing_consent": {
                        "email": true,
                        "sms": false,
                        "updated_at": "2026-08-20T14:22:19Z"
                      }
                    },
                    "totals": {
                      "subtotal": 1699,
                      "discount_total": 100,
                      "shipping_total": 0,
                      "tax_total": 128.72,
                      "total": 1727.72,
                      "amount_paid": 1727.72,
                      "balance_due": 0,
                      "change_given": 0
                    },
                    "line_items": [
                      {
                        "id": "line_test_01J9SALE10482A",
                        "sort_order": 1,
                        "quantity": 1,
                        "product": {
                          "id": "prd_test_01J9HARBOR12",
                          "name": "Harbor 12-inch Hybrid Mattress",
                          "brand": "Northstar Sleep"
                        },
                        "variant": {
                          "id": "var_test_01J9HARBORQUEEN",
                          "name": "Queen / Medium",
                          "sku": "DEMO-HBR-Q-MED",
                          "options": [
                            {
                              "name": "Size",
                              "value": "Queen"
                            },
                            {
                              "name": "Feel",
                              "value": "Medium"
                            }
                          ]
                        },
                        "unit_price": 1699,
                        "quantity_price": 1699,
                        "discount_total": 100,
                        "tax_total": 128.72,
                        "line_total": 1727.72,
                        "discounts": [
                          {
                            "id": "promo_test_100OFF",
                            "name": "Synthetic launch offer",
                            "type": "fixed",
                            "amount": 100
                          }
                        ],
                        "tax_lines": [
                          {
                            "id": "tax_test_state_local",
                            "name": "Combined sales tax",
                            "rate": 0.0805,
                            "taxable_amount": 1599,
                            "amount": 128.72
                          }
                        ],
                        "fulfillment": {
                          "type": "pickup",
                          "status": "ready",
                          "location": {
                            "id": "loc_test_01J9NORTHSTAR",
                            "name": "Northstar Main Store",
                            "code": "MAIN",
                            "timezone": "America/Chicago"
                          },
                          "promised_at": "2026-08-26T18:00:00Z"
                        },
                        "inventory_commitment": {
                          "state": "backordered",
                          "reserved_quantity": 0,
                          "backorder_quantity": 1,
                          "policy": "allow_notify",
                          "eta_date": "2026-09-03",
                          "customer_message": "Available on backorder. Estimated fulfillment in 10 days."
                        },
                        "backorder": {
                          "object": "commerce_backorder_commitment",
                          "id": "boc_test_01J9SALE10482A",
                          "status": "awaiting_stock",
                          "requested_quantity": 1,
                          "initially_reserved_quantity": 0,
                          "backorder_quantity": 1,
                          "allocated_quantity": 0,
                          "remaining_quantity": 1,
                          "policy": "allow_notify",
                          "eta_date": "2026-09-03",
                          "customer_message": "Available on backorder. Estimated fulfillment in 10 days.",
                          "allocated_at": null,
                          "fulfilled_at": null,
                          "cancelled_at": null,
                          "created_at": "2026-08-24T14:31:02Z",
                          "updated_at": "2026-08-24T14:31:02Z"
                        },
                        "warranty": {
                          "term_years": 15,
                          "registered": false
                        },
                        "note": null
                      }
                    ],
                    "payments": [
                      {
                        "id": "pay_test_01J9SALE10482A",
                        "tender_type": "card",
                        "status": "completed",
                        "amount": 1727.72,
                        "currency": "USD",
                        "processed_at": "2026-08-24T14:36:18Z",
                        "processor": {
                          "provider": "synthetic_gateway",
                          "card_brand": "visa",
                          "last_four": "4242",
                          "authorization_code": "DEMO42",
                          "provider_reference": "payref_test_01J9EXAMPLE"
                        }
                      }
                    ],
                    "returns": [],
                    "fulfillment": {
                      "status": "ready",
                      "order_ids": [
                        "ful_test_01J9PICKUP10482"
                      ]
                    },
                    "receipt": {
                      "id": "rec_test_01J9RECEIPT10482",
                      "receipt_number": "R-10482",
                      "resource_url": "/api/retail/v1/receipts/rec_test_01J9RECEIPT10482",
                      "document_url": "/api/retail/v1/receipts/rec_test_01J9RECEIPT10482/document"
                    },
                    "source": {
                      "type": "register",
                      "external_reference": null
                    },
                    "note": "Synthetic sandbox transaction for documentation.",
                    "created_at": "2026-08-24T14:31:02Z",
                    "completed_at": "2026-08-24T14:36:18Z",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSSALE",
                    "environment": "test",
                    "expansions": [
                      "line_items",
                      "payments",
                      "customer",
                      "fulfillment",
                      "receipt"
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "sales:read"
      }
    },
    "/api/retail/v1/sales/{sale_id}/complete": {
      "post": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "Complete a sale",
        "description": "Complete a sale Requires Idempotency-Key and canonical completed payment evidence.",
        "operationId": "complete_sale",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "sale_id",
            "in": "path",
            "required": true,
            "description": "Opaque sale id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "payment_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "payment_ids"
                ],
                "additionalProperties": false
              },
              "example": {
                "payment_ids": [
                  "pay_test_01J9SALE10482A"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Complete a sale response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "sal_test_01J9SALE10482",
                    "object": "sale",
                    "status": "accepted",
                    "name": "Example sale",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_sale_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "sales:write"
      }
    },
    "/api/retail/v1/sales/{sale_id}/void": {
      "post": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "Void a sale",
        "description": "Void a sale Production-impacting action. Requires a permitted sale state and Idempotency-Key.",
        "operationId": "void_sale",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "sale_id",
            "in": "path",
            "required": true,
            "description": "Opaque sale id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string"
                  }
                },
                "required": [
                  "reason"
                ],
                "additionalProperties": false
              },
              "example": {
                "reason": "Synthetic duplicate transaction"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Void a sale response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "sal_test_01J9SALE10482",
                    "object": "sale",
                    "status": "accepted",
                    "name": "Example sale",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_sale_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "sales:write"
      }
    },
    "/api/retail/v1/sales/{sale_id}/line-items": {
      "get": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "List sale line items",
        "description": "Returns whitelisted immutable sale-line snapshots, including product, pricing, tax, return, and fulfillment fields. Cost remains independently scope-gated.",
        "operationId": "sale_lines",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "sale_id",
            "in": "path",
            "required": true,
            "description": "Opaque sale id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List sale line items response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": [
                    {
                      "id": "line_test_01J9SALE10482A",
                      "sort_order": 1,
                      "quantity": 1,
                      "product": {
                        "id": "prd_test_01J9HARBOR12",
                        "name": "Harbor 12-inch Hybrid Mattress",
                        "brand": "Northstar Sleep"
                      },
                      "variant": {
                        "id": "var_test_01J9HARBORQUEEN",
                        "name": "Queen / Medium",
                        "sku": "DEMO-HBR-Q-MED",
                        "options": [
                          {
                            "name": "Size",
                            "value": "Queen"
                          },
                          {
                            "name": "Feel",
                            "value": "Medium"
                          }
                        ]
                      },
                      "unit_price": 1699,
                      "quantity_price": 1699,
                      "discount_total": 100,
                      "tax_total": 128.72,
                      "line_total": 1727.72,
                      "discounts": [
                        {
                          "id": "promo_test_100OFF",
                          "name": "Synthetic launch offer",
                          "type": "fixed",
                          "amount": 100
                        }
                      ],
                      "tax_lines": [
                        {
                          "id": "tax_test_state_local",
                          "name": "Combined sales tax",
                          "rate": 0.0805,
                          "taxable_amount": 1599,
                          "amount": 128.72
                        }
                      ],
                      "fulfillment": {
                        "type": "pickup",
                        "status": "ready",
                        "location": {
                          "id": "loc_test_01J9NORTHSTAR",
                          "name": "Northstar Main Store",
                          "code": "MAIN",
                          "timezone": "America/Chicago"
                        },
                        "promised_at": "2026-08-26T18:00:00Z"
                      },
                      "inventory_commitment": {
                        "state": "backordered",
                        "reserved_quantity": 0,
                        "backorder_quantity": 1,
                        "policy": "allow_notify",
                        "eta_date": "2026-09-03",
                        "customer_message": "Available on backorder. Estimated fulfillment in 10 days."
                      },
                      "backorder": {
                        "object": "commerce_backorder_commitment",
                        "id": "boc_test_01J9SALE10482A",
                        "status": "awaiting_stock",
                        "requested_quantity": 1,
                        "initially_reserved_quantity": 0,
                        "backorder_quantity": 1,
                        "allocated_quantity": 0,
                        "remaining_quantity": 1,
                        "policy": "allow_notify",
                        "eta_date": "2026-09-03",
                        "customer_message": "Available on backorder. Estimated fulfillment in 10 days.",
                        "allocated_at": null,
                        "fulfilled_at": null,
                        "cancelled_at": null,
                        "created_at": "2026-08-24T14:31:02Z",
                        "updated_at": "2026-08-24T14:31:02Z"
                      },
                      "warranty": {
                        "term_years": 15,
                        "registered": false
                      },
                      "note": null
                    }
                  ],
                  "meta": {
                    "request_id": "req_test_01J9DOCSSALE",
                    "environment": "test",
                    "expansions": [
                      "line_items",
                      "payments",
                      "customer",
                      "fulfillment",
                      "receipt"
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "sales:read"
      }
    },
    "/api/retail/v1/sales/{sale_id}/payments": {
      "get": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "List payment summaries",
        "description": "Returns permitted tender summaries and masked provider references, never raw card, bank, terminal, token, merchant, or provider payload data.",
        "operationId": "sale_payments",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "sale_id",
            "in": "path",
            "required": true,
            "description": "Opaque sale id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List payment summaries response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": [
                    {
                      "id": "pay_test_01J9SALE10482A",
                      "tender_type": "card",
                      "status": "completed",
                      "amount": 1727.72,
                      "currency": "USD",
                      "processed_at": "2026-08-24T14:36:18Z",
                      "processor": {
                        "provider": "synthetic_gateway",
                        "card_brand": "visa",
                        "last_four": "4242",
                        "authorization_code": "DEMO42",
                        "provider_reference": "payref_test_01J9EXAMPLE"
                      }
                    }
                  ],
                  "meta": {
                    "request_id": "req_test_01J9DOCSSALE",
                    "environment": "test",
                    "expansions": [
                      "line_items",
                      "payments",
                      "customer",
                      "fulfillment",
                      "receipt"
                    ]
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "sales:read"
      }
    },
    "/api/retail/v1/sales/{sale_id}/returns": {
      "post": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "Create a return",
        "description": "Create a return Requires Idempotency-Key. Refund execution requires certified payment permissions.",
        "operationId": "create_return",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "sale_id",
            "in": "path",
            "required": true,
            "description": "Opaque sale id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "lines": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "line_item_id": {
                          "type": "string"
                        },
                        "quantity": {
                          "type": "integer"
                        },
                        "reason": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "line_item_id",
                        "quantity",
                        "reason"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "refund_method": {
                    "type": "string"
                  }
                },
                "required": [
                  "lines",
                  "refund_method"
                ],
                "additionalProperties": false
              },
              "example": {
                "lines": [
                  {
                    "line_item_id": "line_test_01J9SALE10482A",
                    "quantity": 1,
                    "reason": "Unopened return"
                  }
                ],
                "refund_method": "original_tender"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a return response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "ret_test_01J9RETURN1",
                    "object": "return",
                    "status": "accepted",
                    "name": "Example return",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_return_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "sales:write"
      },
      "get": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "List sale returns",
        "description": "List sale returns",
        "operationId": "list_returns",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "sale_id",
            "in": "path",
            "required": true,
            "description": "Opaque sale id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List sale returns response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "return_test_01J9EXAMPLE",
                      "object": "return",
                      "status": "synthetic_example",
                      "name": "Example return",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_return_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "sales:read"
      }
    },
    "/api/retail/v1/receipts/{receipt_id}": {
      "get": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "Get receipt data",
        "description": "Retrieve the complete canonical receipt read model for a sale without payment credentials.",
        "operationId": "get_receipt",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "receipt_id",
            "in": "path",
            "required": true,
            "description": "Opaque receipt id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get receipt data response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ReceiptEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "rec_test_01J9RECEIPT10482",
                    "receipt_number": "R-10482",
                    "sale_id": "sal_test_01J9SALE10482",
                    "sale_number": "S-10482",
                    "status": "issued",
                    "issued_at": "2026-08-24T14:36:19Z",
                    "merchant": {
                      "display_name": "Northstar Home & Sleep",
                      "location": {
                        "name": "Northstar Main Store",
                        "address": "100 Example Avenue, Sample City, IL 60000"
                      },
                      "phone": "+1-555-010-0100",
                      "tax_identifier_display": "**-***6789"
                    },
                    "customer": {
                      "id": "cus_test_01J9ALEXMORGAN",
                      "display_name": "Alex Morgan",
                      "email": "alex.morgan@example.test"
                    },
                    "cashier": {
                      "id": "usr_test_01J9CASEY",
                      "display_name": "Casey Reed"
                    },
                    "line_items": [
                      {
                        "id": "line_test_01J9SALE10482A",
                        "sort_order": 1,
                        "quantity": 1,
                        "product": {
                          "id": "prd_test_01J9HARBOR12",
                          "name": "Harbor 12-inch Hybrid Mattress",
                          "brand": "Northstar Sleep"
                        },
                        "variant": {
                          "id": "var_test_01J9HARBORQUEEN",
                          "name": "Queen / Medium",
                          "sku": "DEMO-HBR-Q-MED",
                          "options": [
                            {
                              "name": "Size",
                              "value": "Queen"
                            },
                            {
                              "name": "Feel",
                              "value": "Medium"
                            }
                          ]
                        },
                        "unit_price": 1699,
                        "quantity_price": 1699,
                        "discount_total": 100,
                        "tax_total": 128.72,
                        "line_total": 1727.72,
                        "discounts": [
                          {
                            "id": "promo_test_100OFF",
                            "name": "Synthetic launch offer",
                            "type": "fixed",
                            "amount": 100
                          }
                        ],
                        "tax_lines": [
                          {
                            "id": "tax_test_state_local",
                            "name": "Combined sales tax",
                            "rate": 0.0805,
                            "taxable_amount": 1599,
                            "amount": 128.72
                          }
                        ],
                        "fulfillment": {
                          "type": "pickup",
                          "status": "ready",
                          "location": {
                            "id": "loc_test_01J9NORTHSTAR",
                            "name": "Northstar Main Store",
                            "code": "MAIN",
                            "timezone": "America/Chicago"
                          },
                          "promised_at": "2026-08-26T18:00:00Z"
                        },
                        "inventory_commitment": {
                          "state": "backordered",
                          "reserved_quantity": 0,
                          "backorder_quantity": 1,
                          "policy": "allow_notify",
                          "eta_date": "2026-09-03",
                          "customer_message": "Available on backorder. Estimated fulfillment in 10 days."
                        },
                        "backorder": {
                          "object": "commerce_backorder_commitment",
                          "id": "boc_test_01J9SALE10482A",
                          "status": "awaiting_stock",
                          "requested_quantity": 1,
                          "initially_reserved_quantity": 0,
                          "backorder_quantity": 1,
                          "allocated_quantity": 0,
                          "remaining_quantity": 1,
                          "policy": "allow_notify",
                          "eta_date": "2026-09-03",
                          "customer_message": "Available on backorder. Estimated fulfillment in 10 days.",
                          "allocated_at": null,
                          "fulfilled_at": null,
                          "cancelled_at": null,
                          "created_at": "2026-08-24T14:31:02Z",
                          "updated_at": "2026-08-24T14:31:02Z"
                        },
                        "warranty": {
                          "term_years": 15,
                          "registered": false
                        },
                        "note": null
                      }
                    ],
                    "tenders": [
                      {
                        "type": "card",
                        "label": "Visa ending 4242",
                        "amount": 1727.72,
                        "status": "completed"
                      }
                    ],
                    "totals": {
                      "subtotal": 1699,
                      "discount_total": 100,
                      "shipping_total": 0,
                      "tax_total": 128.72,
                      "total": 1727.72,
                      "amount_paid": 1727.72,
                      "balance_due": 0,
                      "change_given": 0
                    },
                    "tax_summary": [
                      {
                        "name": "Combined sales tax",
                        "rate": 0.0805,
                        "taxable_amount": 1599,
                        "amount": 128.72
                      }
                    ],
                    "fulfillment_summary": "Pickup at Northstar Main Store on Aug 26, 2026",
                    "return_summary": {
                      "returnable_until": "2026-09-23T23:59:59Z",
                      "returned_total": 0
                    },
                    "links": {
                      "self": "/api/retail/v1/receipts/rec_test_01J9RECEIPT10482",
                      "sale": "/api/retail/v1/sales/sal_test_01J9SALE10482",
                      "document": "/api/retail/v1/receipts/rec_test_01J9RECEIPT10482/document"
                    }
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSRECEIPT",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "sales:read"
      }
    },
    "/api/retail/v1/receipts/{receipt_id}/document": {
      "get": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "Download receipt document",
        "description": "Download receipt document",
        "operationId": "get_receipt_document",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "receipt_id",
            "in": "path",
            "required": true,
            "description": "Opaque receipt id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Download receipt document response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DocumentEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "rec_test_01J9RECEIPT10482",
                    "content_type": "application/pdf",
                    "expires_at": "2026-08-24T14:51:19Z",
                    "download_url": "https://downloads.example.test/receipt-synthetic.pdf"
                  },
                  "meta": {
                    "request_id": "req_test_receipt_document",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "sales:read"
      }
    },
    "/api/retail/v1/register-closures": {
      "get": {
        "tags": [
          "Sales & receipts"
        ],
        "summary": "List register closures",
        "description": "List register closures",
        "operationId": "list_register_closures",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "register_id",
            "in": "query",
            "required": false,
            "description": "Filter by register id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "closed_since",
            "in": "query",
            "required": false,
            "description": "Filter by closed since.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List register closures response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "register_closure_test_01J9EXAMPLE",
                      "object": "register_closure",
                      "status": "synthetic_example",
                      "name": "Example register closure",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_register_closure_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "sales:read"
      }
    },
    "/api/retail/v1/products": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List products",
        "description": "List products",
        "operationId": "list_products",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Filter by active.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "sku",
            "in": "query",
            "required": false,
            "description": "Filter by sku.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "brand_id",
            "in": "query",
            "required": false,
            "description": "Filter by brand id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "updated_since",
            "in": "query",
            "required": false,
            "description": "Return records updated at or after this RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List products response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductPage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "product_test_01J9EXAMPLE",
                      "object": "product",
                      "status": "synthetic_example",
                      "name": "Example product",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_product_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "catalog:read"
      },
      "post": {
        "tags": [
          "Catalog"
        ],
        "summary": "Create a product",
        "description": "Create a product",
        "operationId": "create_product",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "brand_id": {
                    "type": "string"
                  },
                  "category_id": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "brand_id",
                  "category_id",
                  "status"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Harbor 12-inch Hybrid Mattress",
                "brand_id": "brd_test_northstar",
                "category_id": "cat_test_mattresses",
                "status": "draft"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a product response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "prd_test_01J9NEWPRODUCT",
                    "object": "product",
                    "status": "accepted",
                    "name": "Example product",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_product_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "catalog:write"
      }
    },
    "/api/retail/v1/products/{product_id}": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "Get a product",
        "description": "Retrieve the supported product resource with variants, media, approved custom fields, taxonomy, and warranty links.",
        "operationId": "get_product",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "product_id",
            "in": "path",
            "required": true,
            "description": "Opaque product id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a product response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "prd_test_01J9HARBOR12",
                    "handle": "harbor-12-hybrid-mattress",
                    "name": "Harbor 12-inch Hybrid Mattress",
                    "brand": {
                      "id": "brd_test_northstar",
                      "name": "Northstar Sleep"
                    },
                    "status": "active",
                    "sellable": true,
                    "online_backorder_policy": {
                      "mode": "allow_notify",
                      "max_backorder_quantity": 2,
                      "eta_days": 10,
                      "customer_message": "Available on backorder. Estimated fulfillment in 10 days."
                    },
                    "description": "A balanced hybrid with responsive support and a quilted comfort surface.",
                    "category": {
                      "id": "cat_test_mattresses",
                      "name": "Mattresses",
                      "slug": "mattresses"
                    },
                    "tags": [
                      {
                        "id": "tag_test_hybrid",
                        "name": "Hybrid",
                        "slug": "hybrid"
                      }
                    ],
                    "variants": [
                      {
                        "id": "var_test_01J9HARBORQUEEN",
                        "name": "Queen / Medium",
                        "sku": "DEMO-HBR-Q-MED",
                        "barcode": "000000000001",
                        "price": {
                          "amount": 1699,
                          "currency": "USD"
                        },
                        "options": [
                          {
                            "name": "Size",
                            "value": "Queen"
                          },
                          {
                            "name": "Feel",
                            "value": "Medium"
                          }
                        ],
                        "inventory": {
                          "tracked": true,
                          "available": 6,
                          "reserved": 1,
                          "incoming": 4
                        },
                        "online_backorder_policy": {
                          "mode": "inherit",
                          "max_backorder_quantity": null,
                          "eta_days": null,
                          "customer_message": null
                        }
                      }
                    ],
                    "custom_fields": {
                      "price_area": [
                        {
                          "key": "warranty_years",
                          "label": "Warranty",
                          "value": 15,
                          "value_type": "number"
                        }
                      ],
                      "description": [
                        {
                          "key": "construction",
                          "label": "Construction",
                          "value": "Hybrid",
                          "value_type": "text"
                        }
                      ],
                      "specifications": [
                        {
                          "key": "profile_height",
                          "label": "Profile height",
                          "value": 12,
                          "unit": "in",
                          "value_type": "number"
                        },
                        {
                          "key": "firmness_level",
                          "label": "Firmness level",
                          "value": 6,
                          "value_type": "number"
                        }
                      ]
                    },
                    "media": [
                      {
                        "id": "med_test_01J9HARBORFRONT",
                        "type": "image",
                        "role": "primary",
                        "alt": "Synthetic Harbor mattress product render",
                        "url": "https://pos.getcentri.com/media/product/demo/harbor-12-front.webp"
                      }
                    ],
                    "created_at": "2026-07-14T16:03:11Z",
                    "updated_at": "2026-08-22T19:45:02Z"
                  },
                  "meta": {
                    "request_id": "req_test_product",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "catalog:read"
      },
      "patch": {
        "tags": [
          "Catalog"
        ],
        "summary": "Update a product",
        "description": "Update a product",
        "operationId": "update_product",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "product_id",
            "in": "path",
            "required": true,
            "description": "Opaque product id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "description": {
                    "type": "string"
                  }
                },
                "required": [
                  "description"
                ],
                "additionalProperties": false
              },
              "example": {
                "description": "Updated synthetic description."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a product response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProductEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "prd_test_01J9HARBOR12",
                    "object": "product",
                    "status": "accepted",
                    "name": "Example product",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_product_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "catalog:write"
      }
    },
    "/api/retail/v1/products/{product_id}/variants": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List product variants",
        "description": "List product variants",
        "operationId": "list_variants",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "product_id",
            "in": "path",
            "required": true,
            "description": "Opaque product id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List product variants response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "var_test_01J9HARBORQUEEN",
                      "name": "Queen / Medium",
                      "sku": "DEMO-HBR-Q-MED",
                      "barcode": "000000000001",
                      "price": {
                        "amount": 1699,
                        "currency": "USD"
                      },
                      "options": [
                        {
                          "name": "Size",
                          "value": "Queen"
                        },
                        {
                          "name": "Feel",
                          "value": "Medium"
                        }
                      ],
                      "inventory": {
                        "tracked": true,
                        "available": 6,
                        "reserved": 1,
                        "incoming": 4
                      },
                      "online_backorder_policy": {
                        "mode": "inherit",
                        "max_backorder_quantity": null,
                        "eta_days": null,
                        "customer_message": null
                      }
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_variants",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "catalog:read"
      },
      "post": {
        "tags": [
          "Catalog"
        ],
        "summary": "Create a variant",
        "description": "Create a variant",
        "operationId": "create_variant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "product_id",
            "in": "path",
            "required": true,
            "description": "Opaque product id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "sku": {
                    "type": "string"
                  },
                  "options": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "name": {
                          "type": "string"
                        },
                        "value": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "name",
                        "value"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "name",
                  "sku",
                  "options"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "King / Medium",
                "sku": "DEMO-HBR-K-MED",
                "options": [
                  {
                    "name": "Size",
                    "value": "King"
                  },
                  {
                    "name": "Feel",
                    "value": "Medium"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a variant response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "var_test_01J9NEWVARIANT",
                    "object": "variant",
                    "status": "accepted",
                    "name": "Example variant",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_variant_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "catalog:write"
      }
    },
    "/api/retail/v1/categories": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List categories",
        "description": "List categories",
        "operationId": "list_categories",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "parent_id",
            "in": "query",
            "required": false,
            "description": "Filter by parent id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List categories response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "category_test_01J9EXAMPLE",
                      "object": "category",
                      "status": "synthetic_example",
                      "name": "Example category",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_category_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "catalog:read"
      }
    },
    "/api/retail/v1/brands": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List brands",
        "description": "List brands",
        "operationId": "list_brands",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Filter by search.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List brands response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "brand_test_01J9EXAMPLE",
                      "object": "brand",
                      "status": "synthetic_example",
                      "name": "Example brand",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_brand_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "catalog:read"
      }
    },
    "/api/retail/v1/tags": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List tags",
        "description": "List tags",
        "operationId": "list_tags",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Filter by search.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List tags response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "tag_test_01J9EXAMPLE",
                      "object": "tag",
                      "status": "synthetic_example",
                      "name": "Example tag",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_tag_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "catalog:read"
      }
    },
    "/api/retail/v1/custom-field-groups": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List custom field groups",
        "description": "List custom field groups",
        "operationId": "list_custom_fields",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "entity_type",
            "in": "query",
            "required": false,
            "description": "Filter by entity type.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Filter by active.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List custom field groups response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "custom_field_group_test_01J9EXAMPLE",
                      "object": "custom_field_group",
                      "status": "synthetic_example",
                      "name": "Example custom field group",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_custom_field_group_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "catalog:read"
      }
    },
    "/api/retail/v1/products/{product_id}/media": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List product media",
        "description": "List product media",
        "operationId": "list_media",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "product_id",
            "in": "path",
            "required": true,
            "description": "Opaque product id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List product media response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "med_test_01J9HARBORFRONT",
                      "type": "image",
                      "role": "primary",
                      "alt": "Synthetic Harbor mattress product render",
                      "url": "https://pos.getcentri.com/media/product/demo/harbor-12-front.webp"
                    }
                  ],
                  "meta": {
                    "request_id": "req_test_media",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "catalog:read"
      }
    },
    "/api/retail/v1/inventory/stock": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "List inventory stock",
        "description": "List inventory stock",
        "operationId": "list_stock",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "product_id",
            "in": "query",
            "required": false,
            "description": "One or more assigned add-on product identifiers; required only for the variants resource.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List inventory stock response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InventoryLevelPage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "location": {
                        "id": "loc_test_01J9NORTHSTAR",
                        "name": "Northstar Main Store",
                        "code": "MAIN",
                        "timezone": "America/Chicago"
                      },
                      "product": {
                        "id": "prd_test_01J9HARBOR12",
                        "name": "Harbor 12-inch Hybrid Mattress"
                      },
                      "variant": {
                        "id": "var_test_01J9HARBORQUEEN",
                        "sku": "DEMO-HBR-Q-MED",
                        "name": "Queen / Medium"
                      },
                      "on_hand": 7,
                      "reserved": 1,
                      "available": 6,
                      "incoming": 4,
                      "reorder_point": 2,
                      "updated_at": "2026-08-24T14:29:08Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSINVENTORY",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "inventory:read"
      }
    },
    "/api/retail/v1/inventory/levels": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "Get authoritative product inventory levels",
        "description": "Return every variant at every tenant location, effective reservations, available quantities, per-location totals, and separate unassigned product-level stock. product_id is required.",
        "operationId": "list_levels",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "product_id",
            "in": "query",
            "required": true,
            "description": "One or more assigned add-on product identifiers; required only for the variants resource.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get authoritative product inventory levels response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InventoryLevelsEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "object": "inventory_levels",
                    "product": {
                      "id": "prd_test_01J9HARBOR12",
                      "name": "Harbor 12-inch Hybrid Mattress",
                      "sku": "DEMO-HBR",
                      "track_inventory": true
                    },
                    "inventory_model": "variant",
                    "locations": [
                      {
                        "location": {
                          "id": "loc_test_01J9NORTHSTAR",
                          "name": "Northstar Main Store",
                          "internal_name": "Northstar Main Store",
                          "type": "retail",
                          "is_active": true
                        },
                        "unassigned_product_level": {
                          "id": null,
                          "stock_on_hand": 0,
                          "reserved_quantity": 0,
                          "inventory_reserved_quantity": 0,
                          "commerce_reserved_quantity": 0,
                          "available_quantity": 0,
                          "reorder_point": null,
                          "reorder_quantity": null,
                          "updated_at": null
                        },
                        "variants": [
                          {
                            "id": "stock_test_01J9HARBORQUEEN",
                            "object": "inventory_level",
                            "stock_type": "variant",
                            "location_id": "loc_test_01J9NORTHSTAR",
                            "product_id": "prd_test_01J9HARBOR12",
                            "variant_id": "var_test_01J9HARBORQUEEN",
                            "variant_name": "Queen / Medium",
                            "sku": "DEMO-HBR-Q-MED",
                            "attributes": {
                              "Size": "Queen",
                              "Feel": "Medium"
                            },
                            "variant_enabled": true,
                            "stock_on_hand": 7,
                            "reserved_quantity": 1,
                            "inventory_reserved_quantity": 1,
                            "commerce_reserved_quantity": 0,
                            "available_quantity": 6,
                            "reorder_point": 2,
                            "reorder_quantity": 4,
                            "updated_at": "2026-08-24T14:29:08Z"
                          }
                        ],
                        "variant_totals": {
                          "stock_on_hand": 7,
                          "reserved_quantity": 1,
                          "available_quantity": 6
                        }
                      }
                    ],
                    "totals": {
                      "variants": {
                        "stock_on_hand": 7,
                        "reserved_quantity": 1,
                        "available_quantity": 6
                      },
                      "unassigned_product_level": {
                        "stock_on_hand": 0,
                        "reserved_quantity": 0,
                        "available_quantity": 0
                      }
                    }
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSINVENTORYLEVELS",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "inventory:read"
      }
    },
    "/api/retail/v1/inventory/levels/{location_id}/{variant_id}": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "Get one inventory level",
        "description": "Get one inventory level",
        "operationId": "get_level",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "location_id",
            "in": "path",
            "required": true,
            "description": "Opaque location id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "variant_id",
            "in": "path",
            "required": true,
            "description": "Opaque variant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get one inventory level response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InventoryLevelEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "location": {
                      "id": "loc_test_01J9NORTHSTAR",
                      "name": "Northstar Main Store",
                      "code": "MAIN",
                      "timezone": "America/Chicago"
                    },
                    "product": {
                      "id": "prd_test_01J9HARBOR12",
                      "name": "Harbor 12-inch Hybrid Mattress"
                    },
                    "variant": {
                      "id": "var_test_01J9HARBORQUEEN",
                      "sku": "DEMO-HBR-Q-MED",
                      "name": "Queen / Medium"
                    },
                    "on_hand": 7,
                    "reserved": 1,
                    "available": 6,
                    "incoming": 4,
                    "reorder_point": 2,
                    "updated_at": "2026-08-24T14:29:08Z"
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSINVENTORY",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "inventory:read"
      }
    },
    "/api/retail/v1/inventory/movements": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "List inventory movements",
        "description": "List inventory movements",
        "operationId": "list_movements",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "product_id",
            "in": "query",
            "required": false,
            "description": "One or more assigned add-on product identifiers; required only for the variants resource.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List inventory movements response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "inventory_movement_test_01J9EXAMPLE",
                      "object": "inventory_movement",
                      "status": "synthetic_example",
                      "name": "Example inventory movement",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_inventory_movement_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "inventory:read"
      }
    },
    "/api/retail/v1/inventory/adjustments": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Create an inventory adjustment",
        "description": "Create an inventory adjustment Requires Idempotency-Key and an auditable reason.",
        "operationId": "create_adjustment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "location_id": {
                    "type": "string"
                  },
                  "variant_id": {
                    "type": "string"
                  },
                  "quantity_delta": {
                    "type": "integer"
                  },
                  "reason": {
                    "type": "string"
                  }
                },
                "required": [
                  "location_id",
                  "variant_id",
                  "quantity_delta",
                  "reason"
                ],
                "additionalProperties": false
              },
              "example": {
                "location_id": "loc_test_01J9NORTHSTAR",
                "variant_id": "var_test_01J9HARBORQUEEN",
                "quantity_delta": -1,
                "reason": "Synthetic cycle count correction"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an inventory adjustment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "adj_test_01J9EXAMPLE",
                    "object": "inventory_adjustment",
                    "status": "accepted",
                    "name": "Example inventory adjustment",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_inventory_adjustment_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "inventory:write"
      }
    },
    "/api/retail/v1/inventory/counts": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "List inventory counts",
        "description": "List inventory counts",
        "operationId": "list_counts",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List inventory counts response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "inventory_count_test_01J9EXAMPLE",
                      "object": "inventory_count",
                      "status": "synthetic_example",
                      "name": "Example inventory count",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_inventory_count_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "inventory:read"
      },
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Start an inventory count",
        "description": "Start an inventory count",
        "operationId": "create_count",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "location_id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "location_id",
                  "name"
                ],
                "additionalProperties": false
              },
              "example": {
                "location_id": "loc_test_01J9NORTHSTAR",
                "name": "Synthetic August count"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Start an inventory count response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "cnt_test_01J9EXAMPLE",
                    "object": "inventory_count",
                    "status": "accepted",
                    "name": "Example inventory count",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_inventory_count_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "inventory:write"
      }
    },
    "/api/retail/v1/inventory/transfers": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "List inventory transfers",
        "description": "List inventory transfers",
        "operationId": "list_transfers",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "source_location_id",
            "in": "query",
            "required": false,
            "description": "Filter by source location id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "destination_location_id",
            "in": "query",
            "required": false,
            "description": "Filter by destination location id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List inventory transfers response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "inventory_transfer_test_01J9EXAMPLE",
                      "object": "inventory_transfer",
                      "status": "synthetic_example",
                      "name": "Example inventory transfer",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_inventory_transfer_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "inventory:read"
      },
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Create an inventory transfer",
        "description": "Create an inventory transfer",
        "operationId": "create_transfer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "source_location_id": {
                    "type": "string"
                  },
                  "destination_location_id": {
                    "type": "string"
                  },
                  "lines": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "variant_id": {
                          "type": "string"
                        },
                        "quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "variant_id",
                        "quantity"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "source_location_id",
                  "destination_location_id",
                  "lines"
                ],
                "additionalProperties": false
              },
              "example": {
                "source_location_id": "loc_test_01J9NORTHSTAR",
                "destination_location_id": "loc_test_01J9SECOND",
                "lines": [
                  {
                    "variant_id": "var_test_01J9HARBORQUEEN",
                    "quantity": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an inventory transfer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "trn_test_01J9EXAMPLE",
                    "object": "inventory_transfer",
                    "status": "accepted",
                    "name": "Example inventory transfer",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_inventory_transfer_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "inventory:write"
      }
    },
    "/api/retail/v1/inventory/transfers/{transfer_id}/dispatch": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Dispatch a transfer",
        "description": "Dispatch a transfer",
        "operationId": "dispatch_transfer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "transfer_id",
            "in": "path",
            "required": true,
            "description": "Opaque transfer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "dispatched_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "dispatched_at"
                ],
                "additionalProperties": false
              },
              "example": {
                "dispatched_at": "2026-08-25T14:00:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Dispatch a transfer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "trn_test_01J9EXAMPLE",
                    "object": "inventory_transfer",
                    "status": "accepted",
                    "name": "Example inventory transfer",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_inventory_transfer_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "inventory:write"
      }
    },
    "/api/retail/v1/inventory/transfers/{transfer_id}/receive": {
      "post": {
        "tags": [
          "Inventory"
        ],
        "summary": "Receive a transfer",
        "description": "Receive a transfer",
        "operationId": "receive_transfer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "transfer_id",
            "in": "path",
            "required": true,
            "description": "Opaque transfer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "lines": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "variant_id": {
                          "type": "string"
                        },
                        "quantity_received": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "variant_id",
                        "quantity_received"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "lines"
                ],
                "additionalProperties": false
              },
              "example": {
                "lines": [
                  {
                    "variant_id": "var_test_01J9HARBORQUEEN",
                    "quantity_received": 2
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Receive a transfer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "trn_test_01J9EXAMPLE",
                    "object": "inventory_transfer",
                    "status": "accepted",
                    "name": "Example inventory transfer",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_inventory_transfer_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "inventory:write"
      }
    },
    "/api/retail/v1/customers": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "List customers",
        "description": "List customers",
        "operationId": "list_customers",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Filter by search.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "updated_since",
            "in": "query",
            "required": false,
            "description": "Return records updated at or after this RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List customers response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerPage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "customer_test_01J9EXAMPLE",
                      "object": "customer",
                      "status": "synthetic_example",
                      "name": "Example customer",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_customer_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "customers:read"
      },
      "post": {
        "tags": [
          "Customers"
        ],
        "summary": "Create a customer",
        "description": "Create a customer",
        "operationId": "create_customer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "first_name": {
                    "type": "string"
                  },
                  "last_name": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  },
                  "phone": {
                    "type": "string"
                  }
                },
                "required": [
                  "first_name",
                  "last_name",
                  "email",
                  "phone"
                ],
                "additionalProperties": false
              },
              "example": {
                "first_name": "Alex",
                "last_name": "Morgan",
                "email": "alex.morgan@example.test",
                "phone": "+1-555-010-0184"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a customer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "cus_test_01J9ALEXMORGAN",
                    "object": "customer",
                    "status": "accepted",
                    "name": "Example customer",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_customer_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "customers:write"
      }
    },
    "/api/retail/v1/customers/{customer_id}": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "Get a customer",
        "description": "Retrieve the supported, scope-limited customer account projection.",
        "operationId": "get_customer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "required": true,
            "description": "Opaque customer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a customer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "cus_test_01J9ALEXMORGAN",
                    "first_name": "Alex",
                    "last_name": "Morgan",
                    "display_name": "Alex Morgan",
                    "email": "alex.morgan@example.test",
                    "phone": "+1-555-010-0184",
                    "customer_group": {
                      "id": "cgrp_test_household",
                      "name": "Household"
                    },
                    "marketing_consent": {
                      "email": true,
                      "sms": false,
                      "updated_at": "2026-08-20T14:22:19Z"
                    },
                    "addresses": [
                      {
                        "id": "addr_test_01J9ALEXHOME",
                        "type": "home",
                        "line1": "200 Example Street",
                        "city": "Sample City",
                        "region": "IL",
                        "postal_code": "60000",
                        "country": "US"
                      }
                    ],
                    "balances": {
                      "account_balance": 0,
                      "store_credit": 75,
                      "loyalty_points": 240
                    },
                    "lifetime": {
                      "completed_sales": 4,
                      "net_sales": 4836.18,
                      "last_sale_at": "2026-08-24T14:36:18Z"
                    },
                    "created_at": "2025-11-03T17:44:20Z",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSCUSTOMER",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "customers:read"
      },
      "patch": {
        "tags": [
          "Customers"
        ],
        "summary": "Update a customer",
        "description": "Update a customer",
        "operationId": "update_customer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "required": true,
            "description": "Opaque customer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "phone": {
                    "type": "string"
                  }
                },
                "required": [
                  "phone"
                ],
                "additionalProperties": false
              },
              "example": {
                "phone": "+1-555-010-0184"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a customer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CustomerEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "cus_test_01J9ALEXMORGAN",
                    "object": "customer",
                    "status": "accepted",
                    "name": "Example customer",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_customer_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "customers:write"
      }
    },
    "/api/retail/v1/customers/{customer_id}/addresses": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "List customer addresses",
        "description": "List customer addresses",
        "operationId": "customer_addresses",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "required": true,
            "description": "Opaque customer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List customer addresses response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "addr_test_01J9ALEXHOME",
                      "type": "home",
                      "line1": "200 Example Street",
                      "city": "Sample City",
                      "region": "IL",
                      "postal_code": "60000",
                      "country": "US"
                    }
                  ],
                  "meta": {
                    "request_id": "req_test_01J9DOCSCUSTOMER",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "customers:read"
      }
    },
    "/api/retail/v1/customers/{customer_id}/sales": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "List customer sales",
        "description": "List customer sales",
        "operationId": "customer_sales",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "customer_id",
            "in": "path",
            "required": true,
            "description": "Opaque customer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_since",
            "in": "query",
            "required": false,
            "description": "Return records created at or after this RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List customer sales response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SalePage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "sale_test_01J9EXAMPLE",
                      "object": "sale",
                      "status": "synthetic_example",
                      "name": "Example sale",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_sale_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "sales:read"
      }
    },
    "/api/retail/v1/customer-groups": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "List customer groups",
        "description": "List customer groups",
        "operationId": "list_customer_groups",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "List customer groups response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "customer_group_test_01J9EXAMPLE",
                      "object": "customer_group",
                      "status": "synthetic_example",
                      "name": "Example customer group",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_customer_group_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "customers:read"
      }
    },
    "/api/retail/v1/households": {
      "get": {
        "tags": [
          "Customers"
        ],
        "summary": "List households",
        "description": "List households",
        "operationId": "list_households",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Filter by search.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List households response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "household_test_01J9EXAMPLE",
                      "object": "household",
                      "status": "synthetic_example",
                      "name": "Example household",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_household_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "customers:read"
      }
    },
    "/api/retail/v1/invoices": {
      "get": {
        "tags": [
          "Invoicing"
        ],
        "summary": "List invoices",
        "description": "List invoices",
        "operationId": "list_invoices",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "required": false,
            "description": "Opaque customer identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List invoices response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoicePage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "inv_test_01J9INVOICE10482",
                      "object": "invoice",
                      "invoice_number": "INV-10482",
                      "status": "open",
                      "customer_id": "cus_test_01J9ALEXMORGAN",
                      "customer_name": "Alex Morgan",
                      "customer_email": "alex.morgan@example.test",
                      "sale_id": "sal_test_01J9SALE10482",
                      "totals": {
                        "subtotal": 2400,
                        "tax": 193.2,
                        "total": 2593.2,
                        "amount_paid": 1000,
                        "balance_due": 1593.2
                      },
                      "notes": "Synthetic account invoice for documentation.",
                      "issued_at": "2026-08-24T14:36:18Z",
                      "due_date": "2026-09-23",
                      "paid_at": null,
                      "line_items": [
                        {
                          "id": "invl_test_01J9LABOR",
                          "description": "Installation labor",
                          "quantity": 8,
                          "unit_price": 150,
                          "amount": 1200,
                          "sort_order": 1,
                          "created_at": "2026-08-24T14:36:18Z"
                        },
                        {
                          "id": "invl_test_01J9MATERIAL",
                          "description": "Approved materials",
                          "quantity": 1,
                          "unit_price": 1200,
                          "amount": 1200,
                          "sort_order": 2,
                          "created_at": "2026-08-24T14:36:18Z"
                        }
                      ],
                      "payments": [
                        {
                          "id": "invpay_test_01J9DEPOSIT",
                          "amount": 1000,
                          "payment_type_id": "paytype_test_ach",
                          "notes": "Synthetic deposit",
                          "created_at": "2026-08-24T14:40:00Z"
                        }
                      ],
                      "project_links": [
                        {
                          "id": "pinv_test_01J9LINK",
                          "project_id": "prj_test_01J9INSTALL",
                          "invoice_id": "inv_test_01J9INVOICE10482",
                          "created_at": "2026-08-24T14:36:18Z"
                        }
                      ],
                      "created_at": "2026-08-24T14:36:18Z",
                      "updated_at": "2026-08-24T14:40:00Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_invoice_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "invoices:read"
      },
      "post": {
        "tags": [
          "Invoicing"
        ],
        "summary": "Create an invoice",
        "description": "Create an invoice Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "create_invoice",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer_id": {
                    "type": "string"
                  },
                  "due_date": {
                    "type": "string"
                  },
                  "line_items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "description": {
                          "type": "string"
                        },
                        "quantity": {
                          "type": "integer"
                        },
                        "unit_price": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "description",
                        "quantity",
                        "unit_price"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "project_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "customer_id",
                  "due_date",
                  "line_items",
                  "project_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "customer_id": "cus_test_01J9ALEXMORGAN",
                "due_date": "2026-09-23",
                "line_items": [
                  {
                    "description": "Installation labor",
                    "quantity": 8,
                    "unit_price": 150
                  }
                ],
                "project_id": "prj_test_01J9INSTALL"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an invoice response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "inv_test_01J9NEWINVOICE",
                    "object": "invoice",
                    "status": "accepted",
                    "name": "Example invoice",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_invoice_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "invoices:write"
      }
    },
    "/api/retail/v1/invoices/{invoice_id}": {
      "get": {
        "tags": [
          "Invoicing"
        ],
        "summary": "Get a complete invoice",
        "description": "Retrieve the supported invoice header, totals, line items, payments, balance, sale relationship, and project links.",
        "operationId": "get_invoice",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "required": true,
            "description": "Opaque invoice id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a complete invoice response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "inv_test_01J9INVOICE10482",
                    "object": "invoice",
                    "invoice_number": "INV-10482",
                    "status": "open",
                    "customer_id": "cus_test_01J9ALEXMORGAN",
                    "customer_name": "Alex Morgan",
                    "customer_email": "alex.morgan@example.test",
                    "sale_id": "sal_test_01J9SALE10482",
                    "totals": {
                      "subtotal": 2400,
                      "tax": 193.2,
                      "total": 2593.2,
                      "amount_paid": 1000,
                      "balance_due": 1593.2
                    },
                    "notes": "Synthetic account invoice for documentation.",
                    "issued_at": "2026-08-24T14:36:18Z",
                    "due_date": "2026-09-23",
                    "paid_at": null,
                    "line_items": [
                      {
                        "id": "invl_test_01J9LABOR",
                        "description": "Installation labor",
                        "quantity": 8,
                        "unit_price": 150,
                        "amount": 1200,
                        "sort_order": 1,
                        "created_at": "2026-08-24T14:36:18Z"
                      },
                      {
                        "id": "invl_test_01J9MATERIAL",
                        "description": "Approved materials",
                        "quantity": 1,
                        "unit_price": 1200,
                        "amount": 1200,
                        "sort_order": 2,
                        "created_at": "2026-08-24T14:36:18Z"
                      }
                    ],
                    "payments": [
                      {
                        "id": "invpay_test_01J9DEPOSIT",
                        "amount": 1000,
                        "payment_type_id": "paytype_test_ach",
                        "notes": "Synthetic deposit",
                        "created_at": "2026-08-24T14:40:00Z"
                      }
                    ],
                    "project_links": [
                      {
                        "id": "pinv_test_01J9LINK",
                        "project_id": "prj_test_01J9INSTALL",
                        "invoice_id": "inv_test_01J9INVOICE10482",
                        "created_at": "2026-08-24T14:36:18Z"
                      }
                    ],
                    "created_at": "2026-08-24T14:36:18Z",
                    "updated_at": "2026-08-24T14:40:00Z"
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSINVOICE",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "invoices:read"
      },
      "patch": {
        "tags": [
          "Invoicing"
        ],
        "summary": "Update an invoice",
        "description": "Update an invoice Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "update_invoice",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "required": true,
            "description": "Opaque invoice id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "due_date": {
                    "type": "string"
                  },
                  "notes": {
                    "type": "string"
                  }
                },
                "required": [
                  "due_date",
                  "notes"
                ],
                "additionalProperties": false
              },
              "example": {
                "due_date": "2026-09-30",
                "notes": "Synthetic revised terms."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an invoice response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "inv_test_01J9INVOICE10482",
                    "object": "invoice",
                    "status": "accepted",
                    "name": "Example invoice",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_invoice_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "invoices:write"
      }
    },
    "/api/retail/v1/invoices/{invoice_id}/payments": {
      "post": {
        "tags": [
          "Invoicing"
        ],
        "summary": "Record an invoice payment",
        "description": "Record an invoice payment Requires Idempotency-Key and canonical payment evidence.",
        "operationId": "record_invoice_payment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "required": true,
            "description": "Opaque invoice id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "integer"
                  },
                  "payment_type_id": {
                    "type": "string"
                  },
                  "notes": {
                    "type": "string"
                  }
                },
                "required": [
                  "amount",
                  "payment_type_id",
                  "notes"
                ],
                "additionalProperties": false
              },
              "example": {
                "amount": 500,
                "payment_type_id": "paytype_test_ach",
                "notes": "Synthetic payment"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record an invoice payment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "invpay_test_01J9PAYMENT",
                    "object": "invoice_payment",
                    "status": "accepted",
                    "name": "Example invoice payment",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_invoice_payment_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "invoices:write"
      },
      "get": {
        "tags": [
          "Invoicing"
        ],
        "summary": "List invoice payments",
        "description": "Returns tenant-bound invoice payment records with amounts, approved payment-type references, notes, and timestamps.",
        "operationId": "list_invoice_payments",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "required": true,
            "description": "Opaque invoice id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List invoice payments response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": [
                    {
                      "id": "invpay_test_01J9DEPOSIT",
                      "amount": 1000,
                      "payment_type_id": "paytype_test_ach",
                      "notes": "Synthetic deposit",
                      "created_at": "2026-08-24T14:40:00Z"
                    }
                  ],
                  "meta": {
                    "request_id": "req_test_01J9DOCSINVOICE",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "invoices:read"
      }
    },
    "/api/retail/v1/service/tickets": {
      "get": {
        "tags": [
          "Service Center"
        ],
        "summary": "List service tickets",
        "description": "List service tickets",
        "operationId": "list_service_tickets",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "priority",
            "in": "query",
            "required": false,
            "description": "Filter by priority.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "required": false,
            "description": "Opaque customer identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List service tickets response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceTicketPage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "svc_test_01J9TICKET01",
                      "object": "service_ticket",
                      "ticket_number": "SVC-2081",
                      "ticket_type": "installation",
                      "status": "scheduled",
                      "priority": "normal",
                      "lifecycle_stage": "work_order",
                      "origin_channel": "phone",
                      "customer": {
                        "id": "cus_test_01J9ALEXMORGAN",
                        "name": "Alex Morgan",
                        "phone": "+1-555-010-0184",
                        "email": "alex.morgan@example.test"
                      },
                      "service_address": {
                        "street": "300 Example Boulevard",
                        "street_2": null,
                        "city": "Sample City",
                        "state": "IL",
                        "postal_code": "60000"
                      },
                      "location_id": "loc_test_01J9NORTHSTAR",
                      "product_id": "prd_test_01J9HARBOR12",
                      "variant_id": "var_test_01J9HARBORQUEEN",
                      "linked_sale_id": "sal_test_01J9SALE10482",
                      "converted_sale_id": null,
                      "assigned_profile_id": "usr_test_01J9TECH01",
                      "assigned_team_function": "field_service",
                      "project_id": "prj_test_01J9INSTALL",
                      "work_item_id": "work_test_01J9INSTALL",
                      "warranty": {
                        "provider": "Example Manufacturer",
                        "claim_number": null
                      },
                      "billing": {
                        "billable": true,
                        "estimated_charge": 450,
                        "approved_charge": 450,
                        "charge_status": "approved",
                        "quote_status": "accepted",
                        "quote_total": 450
                      },
                      "work_order_status": "scheduled",
                      "summary": "Install and verify adjustable base",
                      "details": "Synthetic service detail for documentation.",
                      "requested_resolution": "Complete installation and customer walkthrough.",
                      "customer_concern": null,
                      "resolution_summary": null,
                      "scheduled_at": "2026-08-28T14:00:00Z",
                      "next_follow_up_at": "2026-08-29T15:00:00Z",
                      "completed_at": null,
                      "closed_at": null,
                      "visits": [
                        {
                          "id": "visit_test_01J9SITE01",
                          "object": "service_visit",
                          "service_ticket_id": "svc_test_01J9TICKET01",
                          "visit_type": "onsite",
                          "status": "scheduled",
                          "assigned_profile_id": "usr_test_01J9TECH01",
                          "scheduled_start": "2026-08-28T14:00:00Z",
                          "scheduled_end": "2026-08-28T16:00:00Z",
                          "en_route_at": null,
                          "arrived_at": null,
                          "departed_at": null,
                          "completed_at": null,
                          "address": {
                            "line1": "300 Example Boulevard",
                            "city": "Sample City",
                            "region": "IL",
                            "postal_code": "60000"
                          },
                          "customer_present": true,
                          "sentiment": null,
                          "billable": true,
                          "notes": "Synthetic scheduled visit.",
                          "technician_notes": null,
                          "customer_notes": "Call on arrival.",
                          "checklist": [
                            {
                              "id": "svci_test_01J9CHECK01",
                              "label": "Confirm work area",
                              "is_complete": false,
                              "completed_by": null,
                              "completed_at": null,
                              "sort_order": 1
                            }
                          ],
                          "created_at": "2026-08-24T15:00:00Z",
                          "updated_at": "2026-08-24T15:00:00Z"
                        }
                      ],
                      "items": [
                        {
                          "id": "svcitm_test_01J9BASE",
                          "product_id": "prd_test_01J9HARBOR12",
                          "variant_id": "var_test_01J9HARBORQUEEN",
                          "product_name": "Harbor 12-inch Hybrid Mattress",
                          "variant_name": "Queen / Medium",
                          "sku": "DEMO-HBR-Q-MED",
                          "item_kind": "installed_product",
                          "allocation_status": "allocated",
                          "quantity": 1,
                          "unit_price": 1699,
                          "line_total": 1699,
                          "note": null,
                          "sort_order": 1
                        }
                      ],
                      "charges": [
                        {
                          "id": "svcchg_test_01J9LABOR",
                          "charge_type": "labor",
                          "description": "Installation labor",
                          "quantity": 2,
                          "unit_rate": 150,
                          "amount": 300,
                          "status": "approved",
                          "invoice_id": "inv_test_01J9INVOICE10482"
                        }
                      ],
                      "time_entries": [
                        {
                          "id": "svctime_test_01J9PLAN",
                          "profile_id": "usr_test_01J9TECH01",
                          "entry_type": "planned",
                          "status": "approved",
                          "minutes": 120,
                          "billable": true,
                          "hourly_rate": 150
                        }
                      ],
                      "warranty_claim": null,
                      "events": [
                        {
                          "id": "svcevt_test_01J9SCHEDULED",
                          "event_type": "scheduled",
                          "actor_profile_id": "usr_test_01J9CASEY",
                          "note": "Synthetic schedule event",
                          "created_at": "2026-08-24T15:00:00Z"
                        }
                      ],
                      "created_at": "2026-08-24T14:50:00Z",
                      "updated_at": "2026-08-24T15:00:00Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_service_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "service:read"
      },
      "post": {
        "tags": [
          "Service Center"
        ],
        "summary": "Create a service ticket",
        "description": "Create a service ticket Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "create_service_ticket",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticket_type": {
                    "type": "string"
                  },
                  "customer_id": {
                    "type": "string"
                  },
                  "summary": {
                    "type": "string"
                  },
                  "priority": {
                    "type": "string"
                  }
                },
                "required": [
                  "ticket_type",
                  "customer_id",
                  "summary",
                  "priority"
                ],
                "additionalProperties": false
              },
              "example": {
                "ticket_type": "installation",
                "customer_id": "cus_test_01J9ALEXMORGAN",
                "summary": "Install and verify adjustable base",
                "priority": "normal"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a service ticket response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "svc_test_01J9NEWTICKET",
                    "object": "service_ticket",
                    "status": "accepted",
                    "name": "Example service ticket",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_service_ticket_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "service:write"
      }
    },
    "/api/retail/v1/service/tickets/{ticket_id}": {
      "get": {
        "tags": [
          "Service Center"
        ],
        "summary": "Get a complete service ticket",
        "description": "Retrieve the supported ticket with customer and address snapshots, items, visits, charges, time entries, warranty claim, work links, and lifecycle events.",
        "operationId": "get_service_ticket",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a complete service ticket response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceTicketEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "svc_test_01J9TICKET01",
                    "object": "service_ticket",
                    "ticket_number": "SVC-2081",
                    "ticket_type": "installation",
                    "status": "scheduled",
                    "priority": "normal",
                    "lifecycle_stage": "work_order",
                    "origin_channel": "phone",
                    "customer": {
                      "id": "cus_test_01J9ALEXMORGAN",
                      "name": "Alex Morgan",
                      "phone": "+1-555-010-0184",
                      "email": "alex.morgan@example.test"
                    },
                    "service_address": {
                      "street": "300 Example Boulevard",
                      "street_2": null,
                      "city": "Sample City",
                      "state": "IL",
                      "postal_code": "60000"
                    },
                    "location_id": "loc_test_01J9NORTHSTAR",
                    "product_id": "prd_test_01J9HARBOR12",
                    "variant_id": "var_test_01J9HARBORQUEEN",
                    "linked_sale_id": "sal_test_01J9SALE10482",
                    "converted_sale_id": null,
                    "assigned_profile_id": "usr_test_01J9TECH01",
                    "assigned_team_function": "field_service",
                    "project_id": "prj_test_01J9INSTALL",
                    "work_item_id": "work_test_01J9INSTALL",
                    "warranty": {
                      "provider": "Example Manufacturer",
                      "claim_number": null
                    },
                    "billing": {
                      "billable": true,
                      "estimated_charge": 450,
                      "approved_charge": 450,
                      "charge_status": "approved",
                      "quote_status": "accepted",
                      "quote_total": 450
                    },
                    "work_order_status": "scheduled",
                    "summary": "Install and verify adjustable base",
                    "details": "Synthetic service detail for documentation.",
                    "requested_resolution": "Complete installation and customer walkthrough.",
                    "customer_concern": null,
                    "resolution_summary": null,
                    "scheduled_at": "2026-08-28T14:00:00Z",
                    "next_follow_up_at": "2026-08-29T15:00:00Z",
                    "completed_at": null,
                    "closed_at": null,
                    "visits": [
                      {
                        "id": "visit_test_01J9SITE01",
                        "object": "service_visit",
                        "service_ticket_id": "svc_test_01J9TICKET01",
                        "visit_type": "onsite",
                        "status": "scheduled",
                        "assigned_profile_id": "usr_test_01J9TECH01",
                        "scheduled_start": "2026-08-28T14:00:00Z",
                        "scheduled_end": "2026-08-28T16:00:00Z",
                        "en_route_at": null,
                        "arrived_at": null,
                        "departed_at": null,
                        "completed_at": null,
                        "address": {
                          "line1": "300 Example Boulevard",
                          "city": "Sample City",
                          "region": "IL",
                          "postal_code": "60000"
                        },
                        "customer_present": true,
                        "sentiment": null,
                        "billable": true,
                        "notes": "Synthetic scheduled visit.",
                        "technician_notes": null,
                        "customer_notes": "Call on arrival.",
                        "checklist": [
                          {
                            "id": "svci_test_01J9CHECK01",
                            "label": "Confirm work area",
                            "is_complete": false,
                            "completed_by": null,
                            "completed_at": null,
                            "sort_order": 1
                          }
                        ],
                        "created_at": "2026-08-24T15:00:00Z",
                        "updated_at": "2026-08-24T15:00:00Z"
                      }
                    ],
                    "items": [
                      {
                        "id": "svcitm_test_01J9BASE",
                        "product_id": "prd_test_01J9HARBOR12",
                        "variant_id": "var_test_01J9HARBORQUEEN",
                        "product_name": "Harbor 12-inch Hybrid Mattress",
                        "variant_name": "Queen / Medium",
                        "sku": "DEMO-HBR-Q-MED",
                        "item_kind": "installed_product",
                        "allocation_status": "allocated",
                        "quantity": 1,
                        "unit_price": 1699,
                        "line_total": 1699,
                        "note": null,
                        "sort_order": 1
                      }
                    ],
                    "charges": [
                      {
                        "id": "svcchg_test_01J9LABOR",
                        "charge_type": "labor",
                        "description": "Installation labor",
                        "quantity": 2,
                        "unit_rate": 150,
                        "amount": 300,
                        "status": "approved",
                        "invoice_id": "inv_test_01J9INVOICE10482"
                      }
                    ],
                    "time_entries": [
                      {
                        "id": "svctime_test_01J9PLAN",
                        "profile_id": "usr_test_01J9TECH01",
                        "entry_type": "planned",
                        "status": "approved",
                        "minutes": 120,
                        "billable": true,
                        "hourly_rate": 150
                      }
                    ],
                    "warranty_claim": null,
                    "events": [
                      {
                        "id": "svcevt_test_01J9SCHEDULED",
                        "event_type": "scheduled",
                        "actor_profile_id": "usr_test_01J9CASEY",
                        "note": "Synthetic schedule event",
                        "created_at": "2026-08-24T15:00:00Z"
                      }
                    ],
                    "created_at": "2026-08-24T14:50:00Z",
                    "updated_at": "2026-08-24T15:00:00Z"
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSSERVICE",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "service:read"
      },
      "patch": {
        "tags": [
          "Service Center"
        ],
        "summary": "Update a service ticket",
        "description": "Update a service ticket Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "update_service_ticket",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "scheduled_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "scheduled_at"
                ],
                "additionalProperties": false
              },
              "example": {
                "status": "scheduled",
                "scheduled_at": "2026-08-28T14:00:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a service ticket response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "svc_test_01J9TICKET01",
                    "object": "service_ticket",
                    "status": "accepted",
                    "name": "Example service ticket",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_service_ticket_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "service:write"
      }
    },
    "/api/retail/v1/service/visits": {
      "get": {
        "tags": [
          "Service Center"
        ],
        "summary": "List service visits",
        "description": "List service visits",
        "operationId": "list_service_visits",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List service visits response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceVisitPage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "visit_test_01J9SITE01",
                      "object": "service_visit",
                      "service_ticket_id": "svc_test_01J9TICKET01",
                      "visit_type": "onsite",
                      "status": "scheduled",
                      "assigned_profile_id": "usr_test_01J9TECH01",
                      "scheduled_start": "2026-08-28T14:00:00Z",
                      "scheduled_end": "2026-08-28T16:00:00Z",
                      "en_route_at": null,
                      "arrived_at": null,
                      "departed_at": null,
                      "completed_at": null,
                      "address": {
                        "line1": "300 Example Boulevard",
                        "city": "Sample City",
                        "region": "IL",
                        "postal_code": "60000"
                      },
                      "customer_present": true,
                      "sentiment": null,
                      "billable": true,
                      "notes": "Synthetic scheduled visit.",
                      "technician_notes": null,
                      "customer_notes": "Call on arrival.",
                      "checklist": [
                        {
                          "id": "svci_test_01J9CHECK01",
                          "label": "Confirm work area",
                          "is_complete": false,
                          "completed_by": null,
                          "completed_at": null,
                          "sort_order": 1
                        }
                      ],
                      "created_at": "2026-08-24T15:00:00Z",
                      "updated_at": "2026-08-24T15:00:00Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_visit_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "service:read"
      },
      "post": {
        "tags": [
          "Service Center"
        ],
        "summary": "Schedule a service visit",
        "description": "Schedule a service visit Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "create_service_visit",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "service_ticket_id": {
                    "type": "string"
                  },
                  "visit_type": {
                    "type": "string"
                  },
                  "scheduled_start": {
                    "type": "string"
                  },
                  "scheduled_end": {
                    "type": "string"
                  }
                },
                "required": [
                  "service_ticket_id",
                  "visit_type",
                  "scheduled_start",
                  "scheduled_end"
                ],
                "additionalProperties": false
              },
              "example": {
                "service_ticket_id": "svc_test_01J9TICKET01",
                "visit_type": "onsite",
                "scheduled_start": "2026-08-28T14:00:00Z",
                "scheduled_end": "2026-08-28T16:00:00Z"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Schedule a service visit response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "visit_test_01J9NEWVISIT",
                    "object": "service_visit",
                    "status": "accepted",
                    "name": "Example service visit",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_service_visit_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "service:write"
      }
    },
    "/api/retail/v1/service/visits/{visit_id}": {
      "get": {
        "tags": [
          "Service Center"
        ],
        "summary": "Get a service visit",
        "description": "Retrieve the visit schedule, assignment, route timestamps, notes, and checklist.",
        "operationId": "get_service_visit",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "visit_id",
            "in": "path",
            "required": true,
            "description": "Opaque visit id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a service visit response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ServiceVisitEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "visit_test_01J9SITE01",
                    "object": "service_visit",
                    "service_ticket_id": "svc_test_01J9TICKET01",
                    "visit_type": "onsite",
                    "status": "scheduled",
                    "assigned_profile_id": "usr_test_01J9TECH01",
                    "scheduled_start": "2026-08-28T14:00:00Z",
                    "scheduled_end": "2026-08-28T16:00:00Z",
                    "en_route_at": null,
                    "arrived_at": null,
                    "departed_at": null,
                    "completed_at": null,
                    "address": {
                      "line1": "300 Example Boulevard",
                      "city": "Sample City",
                      "region": "IL",
                      "postal_code": "60000"
                    },
                    "customer_present": true,
                    "sentiment": null,
                    "billable": true,
                    "notes": "Synthetic scheduled visit.",
                    "technician_notes": null,
                    "customer_notes": "Call on arrival.",
                    "checklist": [
                      {
                        "id": "svci_test_01J9CHECK01",
                        "label": "Confirm work area",
                        "is_complete": false,
                        "completed_by": null,
                        "completed_at": null,
                        "sort_order": 1
                      }
                    ],
                    "created_at": "2026-08-24T15:00:00Z",
                    "updated_at": "2026-08-24T15:00:00Z"
                  },
                  "meta": {
                    "request_id": "req_test_visit",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "service:read"
      },
      "patch": {
        "tags": [
          "Service Center"
        ],
        "summary": "Update a service visit",
        "description": "Update a service visit Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "update_service_visit",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "visit_id",
            "in": "path",
            "required": true,
            "description": "Opaque visit id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "completed_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "completed_at"
                ],
                "additionalProperties": false
              },
              "example": {
                "status": "completed",
                "completed_at": "2026-08-28T15:42:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a service visit response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "visit_test_01J9SITE01",
                    "object": "service_visit",
                    "status": "accepted",
                    "name": "Example service visit",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_service_visit_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "service:write"
      }
    },
    "/api/retail/v1/service/plans": {
      "get": {
        "tags": [
          "Service Center"
        ],
        "summary": "List service plans",
        "description": "List service plans",
        "operationId": "list_service_plans",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "List service plans response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "service_plan_test_01J9EXAMPLE",
                      "object": "service_plan",
                      "status": "synthetic_example",
                      "name": "Example service plan",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_service_plan_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "service:read"
      }
    },
    "/api/retail/v1/service/enrollments": {
      "get": {
        "tags": [
          "Service Center"
        ],
        "summary": "List service-plan enrollments",
        "description": "List service-plan enrollments",
        "operationId": "list_service_enrollments",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "required": false,
            "description": "Opaque customer identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List service-plan enrollments response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "service_plan_enrollment_test_01J9EXAMPLE",
                      "object": "service_plan_enrollment",
                      "status": "synthetic_example",
                      "name": "Example service plan enrollment",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_service_plan_enrollment_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "service:read"
      }
    },
    "/api/retail/v1/service/tickets/{ticket_id}/charges": {
      "post": {
        "tags": [
          "Service Center"
        ],
        "summary": "Add a service charge",
        "description": "Add a service charge Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "create_service_charge",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "charge_type": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "quantity": {
                    "type": "integer"
                  },
                  "unit_rate": {
                    "type": "integer"
                  }
                },
                "required": [
                  "charge_type",
                  "description",
                  "quantity",
                  "unit_rate"
                ],
                "additionalProperties": false
              },
              "example": {
                "charge_type": "labor",
                "description": "Installation labor",
                "quantity": 2,
                "unit_rate": 150
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Add a service charge response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "svcchg_test_01J9NEWCHARGE",
                    "object": "service_charge",
                    "status": "accepted",
                    "name": "Example service charge",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_service_charge_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "service:write"
      }
    },
    "/api/retail/v1/service/tickets/{ticket_id}/time-entries": {
      "post": {
        "tags": [
          "Service Center"
        ],
        "summary": "Add a service time entry",
        "description": "Add a service time entry Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "create_service_time_entry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "profile_id": {
                    "type": "string"
                  },
                  "minutes": {
                    "type": "integer"
                  },
                  "billable": {
                    "type": "boolean"
                  },
                  "hourly_rate": {
                    "type": "integer"
                  }
                },
                "required": [
                  "profile_id",
                  "minutes",
                  "billable",
                  "hourly_rate"
                ],
                "additionalProperties": false
              },
              "example": {
                "profile_id": "usr_test_01J9TECH01",
                "minutes": 120,
                "billable": true,
                "hourly_rate": 150
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Add a service time entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "svctime_test_01J9NEWENTRY",
                    "object": "service_time_entry",
                    "status": "accepted",
                    "name": "Example service time entry",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_service_time_entry_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "service:write"
      }
    },
    "/api/retail/v1/projects": {
      "get": {
        "tags": [
          "Projects & work"
        ],
        "summary": "List projects",
        "description": "List projects",
        "operationId": "list_projects",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "customer_id",
            "in": "query",
            "required": false,
            "description": "Opaque customer identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List projects response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProjectPage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "prj_test_01J9INSTALL",
                      "object": "project",
                      "project_number": "PRJ-1042",
                      "name": "Primary bedroom installation",
                      "description": "Synthetic customer installation project.",
                      "project_type": "installation",
                      "status": "active",
                      "health": "on_track",
                      "location_id": "loc_test_01J9NORTHSTAR",
                      "engagement_id": null,
                      "template_id": "template_test_installation",
                      "customer_id": "cus_test_01J9ALEXMORGAN",
                      "linked_sale_id": "sal_test_01J9SALE10482",
                      "owner_profile_id": "usr_test_01J9CASEY",
                      "start_on": "2026-08-24",
                      "due_on": "2026-08-28",
                      "completed_at": null,
                      "boards": [
                        {
                          "id": "board_test_01J9INSTALL",
                          "name": "Installation",
                          "is_default": true,
                          "sort_order": 1,
                          "columns": [
                            {
                              "id": "column_test_01J9READY",
                              "name": "Ready",
                              "status_key": "ready",
                              "sort_order": 2,
                              "wip_limit": null,
                              "is_done": false
                            }
                          ]
                        }
                      ],
                      "milestones": [
                        {
                          "id": "mile_test_01J9DELIVERY",
                          "title": "Delivery and setup",
                          "status": "open",
                          "owner_profile_id": "usr_test_01J9TECH01",
                          "due_on": "2026-08-28",
                          "completed_at": null,
                          "sort_order": 1
                        }
                      ],
                      "work_items": [
                        {
                          "id": "work_test_01J9INSTALL",
                          "object": "work_item",
                          "project_id": "prj_test_01J9INSTALL",
                          "board_id": "board_test_01J9INSTALL",
                          "column_id": "column_test_01J9READY",
                          "milestone_id": "mile_test_01J9DELIVERY",
                          "parent_item_id": null,
                          "item_number": "TASK-14",
                          "item_type": "task",
                          "title": "Complete installation",
                          "description": "Install, inspect, and walk the customer through operation.",
                          "status": "ready",
                          "priority": "normal",
                          "assigned_profile_id": "usr_test_01J9TECH01",
                          "start_on": "2026-08-28",
                          "due_at": "2026-08-28T16:00:00Z",
                          "completed_at": null,
                          "estimated_minutes": 120,
                          "actual_minutes": null,
                          "recurrence_rule": null,
                          "sort_order": 14,
                          "checklist": [
                            {
                              "id": "workcheck_test_01J9VERIFY",
                              "title": "Verify final operation",
                              "is_complete": false,
                              "sort_order": 1
                            }
                          ],
                          "dependencies": [],
                          "comments": [
                            {
                              "id": "workcomment_test_01J9NOTE",
                              "body": "Synthetic project note.",
                              "author_profile_id": "usr_test_01J9CASEY",
                              "created_at": "2026-08-24T15:00:00Z"
                            }
                          ],
                          "approvals": [
                            {
                              "id": "workapproval_test_01J9CUSTOMER",
                              "status": "pending",
                              "request_note": "Customer sign-off",
                              "decision_note": null,
                              "decided_at": null
                            }
                          ],
                          "created_at": "2026-08-24T14:45:00Z",
                          "updated_at": "2026-08-24T15:00:00Z"
                        }
                      ],
                      "comments": [
                        {
                          "id": "prjcomment_test_01J9NOTE",
                          "body": "Synthetic project note.",
                          "author_profile_id": "usr_test_01J9CASEY",
                          "created_at": "2026-08-24T15:00:00Z"
                        }
                      ],
                      "contact_links": [
                        {
                          "id": "prjcontact_test_01J9CUSTOMER",
                          "contact_id": "cus_test_01J9ALEXMORGAN",
                          "role": "customer",
                          "is_primary": true
                        }
                      ],
                      "invoice_links": [
                        {
                          "id": "pinv_test_01J9LINK",
                          "invoice_id": "inv_test_01J9INVOICE10482",
                          "created_at": "2026-08-24T14:36:18Z"
                        }
                      ],
                      "created_at": "2026-08-24T14:40:00Z",
                      "updated_at": "2026-08-24T15:00:00Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_project_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "projects:read"
      },
      "post": {
        "tags": [
          "Projects & work"
        ],
        "summary": "Create a project",
        "description": "Create a project Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "create_project",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "project_type": {
                    "type": "string"
                  },
                  "customer_id": {
                    "type": "string"
                  },
                  "start_on": {
                    "type": "string"
                  },
                  "due_on": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "project_type",
                  "customer_id",
                  "start_on",
                  "due_on"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Primary bedroom installation",
                "project_type": "installation",
                "customer_id": "cus_test_01J9ALEXMORGAN",
                "start_on": "2026-08-24",
                "due_on": "2026-08-28"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a project response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "prj_test_01J9NEWPROJECT",
                    "object": "project",
                    "status": "accepted",
                    "name": "Example project",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_project_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "projects:write"
      }
    },
    "/api/retail/v1/projects/{project_id}": {
      "get": {
        "tags": [
          "Projects & work"
        ],
        "summary": "Get a complete project",
        "description": "Retrieve the supported project with boards and columns, milestones, work items, comments, contacts, invoice links, and ownership.",
        "operationId": "get_project",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "required": true,
            "description": "Opaque project id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a complete project response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ProjectEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "prj_test_01J9INSTALL",
                    "object": "project",
                    "project_number": "PRJ-1042",
                    "name": "Primary bedroom installation",
                    "description": "Synthetic customer installation project.",
                    "project_type": "installation",
                    "status": "active",
                    "health": "on_track",
                    "location_id": "loc_test_01J9NORTHSTAR",
                    "engagement_id": null,
                    "template_id": "template_test_installation",
                    "customer_id": "cus_test_01J9ALEXMORGAN",
                    "linked_sale_id": "sal_test_01J9SALE10482",
                    "owner_profile_id": "usr_test_01J9CASEY",
                    "start_on": "2026-08-24",
                    "due_on": "2026-08-28",
                    "completed_at": null,
                    "boards": [
                      {
                        "id": "board_test_01J9INSTALL",
                        "name": "Installation",
                        "is_default": true,
                        "sort_order": 1,
                        "columns": [
                          {
                            "id": "column_test_01J9READY",
                            "name": "Ready",
                            "status_key": "ready",
                            "sort_order": 2,
                            "wip_limit": null,
                            "is_done": false
                          }
                        ]
                      }
                    ],
                    "milestones": [
                      {
                        "id": "mile_test_01J9DELIVERY",
                        "title": "Delivery and setup",
                        "status": "open",
                        "owner_profile_id": "usr_test_01J9TECH01",
                        "due_on": "2026-08-28",
                        "completed_at": null,
                        "sort_order": 1
                      }
                    ],
                    "work_items": [
                      {
                        "id": "work_test_01J9INSTALL",
                        "object": "work_item",
                        "project_id": "prj_test_01J9INSTALL",
                        "board_id": "board_test_01J9INSTALL",
                        "column_id": "column_test_01J9READY",
                        "milestone_id": "mile_test_01J9DELIVERY",
                        "parent_item_id": null,
                        "item_number": "TASK-14",
                        "item_type": "task",
                        "title": "Complete installation",
                        "description": "Install, inspect, and walk the customer through operation.",
                        "status": "ready",
                        "priority": "normal",
                        "assigned_profile_id": "usr_test_01J9TECH01",
                        "start_on": "2026-08-28",
                        "due_at": "2026-08-28T16:00:00Z",
                        "completed_at": null,
                        "estimated_minutes": 120,
                        "actual_minutes": null,
                        "recurrence_rule": null,
                        "sort_order": 14,
                        "checklist": [
                          {
                            "id": "workcheck_test_01J9VERIFY",
                            "title": "Verify final operation",
                            "is_complete": false,
                            "sort_order": 1
                          }
                        ],
                        "dependencies": [],
                        "comments": [
                          {
                            "id": "workcomment_test_01J9NOTE",
                            "body": "Synthetic project note.",
                            "author_profile_id": "usr_test_01J9CASEY",
                            "created_at": "2026-08-24T15:00:00Z"
                          }
                        ],
                        "approvals": [
                          {
                            "id": "workapproval_test_01J9CUSTOMER",
                            "status": "pending",
                            "request_note": "Customer sign-off",
                            "decision_note": null,
                            "decided_at": null
                          }
                        ],
                        "created_at": "2026-08-24T14:45:00Z",
                        "updated_at": "2026-08-24T15:00:00Z"
                      }
                    ],
                    "comments": [
                      {
                        "id": "prjcomment_test_01J9NOTE",
                        "body": "Synthetic project note.",
                        "author_profile_id": "usr_test_01J9CASEY",
                        "created_at": "2026-08-24T15:00:00Z"
                      }
                    ],
                    "contact_links": [
                      {
                        "id": "prjcontact_test_01J9CUSTOMER",
                        "contact_id": "cus_test_01J9ALEXMORGAN",
                        "role": "customer",
                        "is_primary": true
                      }
                    ],
                    "invoice_links": [
                      {
                        "id": "pinv_test_01J9LINK",
                        "invoice_id": "inv_test_01J9INVOICE10482",
                        "created_at": "2026-08-24T14:36:18Z"
                      }
                    ],
                    "created_at": "2026-08-24T14:40:00Z",
                    "updated_at": "2026-08-24T15:00:00Z"
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSPROJECT",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "projects:read"
      },
      "patch": {
        "tags": [
          "Projects & work"
        ],
        "summary": "Update a project",
        "description": "Update a project Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "update_project",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "required": true,
            "description": "Opaque project id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "health": {
                    "type": "string"
                  },
                  "due_on": {
                    "type": "string"
                  }
                },
                "required": [
                  "health",
                  "due_on"
                ],
                "additionalProperties": false
              },
              "example": {
                "health": "on_track",
                "due_on": "2026-08-29"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a project response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "prj_test_01J9INSTALL",
                    "object": "project",
                    "status": "accepted",
                    "name": "Example project",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_project_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "projects:write"
      }
    },
    "/api/retail/v1/projects/{project_id}/items": {
      "get": {
        "tags": [
          "Projects & work"
        ],
        "summary": "List project work items",
        "description": "List project work items",
        "operationId": "list_project_items",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "required": true,
            "description": "Opaque project id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List project work items response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkItemPage"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "work_test_01J9INSTALL",
                      "object": "work_item",
                      "project_id": "prj_test_01J9INSTALL",
                      "board_id": "board_test_01J9INSTALL",
                      "column_id": "column_test_01J9READY",
                      "milestone_id": "mile_test_01J9DELIVERY",
                      "parent_item_id": null,
                      "item_number": "TASK-14",
                      "item_type": "task",
                      "title": "Complete installation",
                      "description": "Install, inspect, and walk the customer through operation.",
                      "status": "ready",
                      "priority": "normal",
                      "assigned_profile_id": "usr_test_01J9TECH01",
                      "start_on": "2026-08-28",
                      "due_at": "2026-08-28T16:00:00Z",
                      "completed_at": null,
                      "estimated_minutes": 120,
                      "actual_minutes": null,
                      "recurrence_rule": null,
                      "sort_order": 14,
                      "checklist": [
                        {
                          "id": "workcheck_test_01J9VERIFY",
                          "title": "Verify final operation",
                          "is_complete": false,
                          "sort_order": 1
                        }
                      ],
                      "dependencies": [],
                      "comments": [
                        {
                          "id": "workcomment_test_01J9NOTE",
                          "body": "Synthetic project note.",
                          "author_profile_id": "usr_test_01J9CASEY",
                          "created_at": "2026-08-24T15:00:00Z"
                        }
                      ],
                      "approvals": [
                        {
                          "id": "workapproval_test_01J9CUSTOMER",
                          "status": "pending",
                          "request_note": "Customer sign-off",
                          "decision_note": null,
                          "decided_at": null
                        }
                      ],
                      "created_at": "2026-08-24T14:45:00Z",
                      "updated_at": "2026-08-24T15:00:00Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_project_items",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "projects:read"
      },
      "post": {
        "tags": [
          "Projects & work"
        ],
        "summary": "Create a work item",
        "description": "Create a work item Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "create_work_item",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "project_id",
            "in": "path",
            "required": true,
            "description": "Opaque project id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "item_type": {
                    "type": "string"
                  },
                  "priority": {
                    "type": "string"
                  },
                  "due_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "title",
                  "item_type",
                  "priority",
                  "due_at"
                ],
                "additionalProperties": false
              },
              "example": {
                "title": "Complete installation",
                "item_type": "task",
                "priority": "normal",
                "due_at": "2026-08-28T16:00:00Z"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a work item response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "work_test_01J9NEWITEM",
                    "object": "work_item",
                    "status": "accepted",
                    "name": "Example work item",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_work_item_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "projects:write"
      }
    },
    "/api/retail/v1/work-items/{work_item_id}": {
      "get": {
        "tags": [
          "Projects & work"
        ],
        "summary": "Get a complete work item",
        "description": "Retrieve the work item with checklist, dependencies, comments, approvals, estimates, assignment, and completion state.",
        "operationId": "get_work_item",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "work_item_id",
            "in": "path",
            "required": true,
            "description": "Opaque work item id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a complete work item response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WorkItemEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "work_test_01J9INSTALL",
                    "object": "work_item",
                    "project_id": "prj_test_01J9INSTALL",
                    "board_id": "board_test_01J9INSTALL",
                    "column_id": "column_test_01J9READY",
                    "milestone_id": "mile_test_01J9DELIVERY",
                    "parent_item_id": null,
                    "item_number": "TASK-14",
                    "item_type": "task",
                    "title": "Complete installation",
                    "description": "Install, inspect, and walk the customer through operation.",
                    "status": "ready",
                    "priority": "normal",
                    "assigned_profile_id": "usr_test_01J9TECH01",
                    "start_on": "2026-08-28",
                    "due_at": "2026-08-28T16:00:00Z",
                    "completed_at": null,
                    "estimated_minutes": 120,
                    "actual_minutes": null,
                    "recurrence_rule": null,
                    "sort_order": 14,
                    "checklist": [
                      {
                        "id": "workcheck_test_01J9VERIFY",
                        "title": "Verify final operation",
                        "is_complete": false,
                        "sort_order": 1
                      }
                    ],
                    "dependencies": [],
                    "comments": [
                      {
                        "id": "workcomment_test_01J9NOTE",
                        "body": "Synthetic project note.",
                        "author_profile_id": "usr_test_01J9CASEY",
                        "created_at": "2026-08-24T15:00:00Z"
                      }
                    ],
                    "approvals": [
                      {
                        "id": "workapproval_test_01J9CUSTOMER",
                        "status": "pending",
                        "request_note": "Customer sign-off",
                        "decision_note": null,
                        "decided_at": null
                      }
                    ],
                    "created_at": "2026-08-24T14:45:00Z",
                    "updated_at": "2026-08-24T15:00:00Z"
                  },
                  "meta": {
                    "request_id": "req_test_work_item",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "projects:read"
      },
      "patch": {
        "tags": [
          "Projects & work"
        ],
        "summary": "Update a work item",
        "description": "Update a work item Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "update_work_item",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "work_item_id",
            "in": "path",
            "required": true,
            "description": "Opaque work item id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "completed_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "completed_at"
                ],
                "additionalProperties": false
              },
              "example": {
                "status": "done",
                "completed_at": "2026-08-28T15:42:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a work item response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "work_test_01J9INSTALL",
                    "object": "work_item",
                    "status": "accepted",
                    "name": "Example work item",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_work_item_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "projects:write"
      }
    },
    "/api/retail/v1/work-items/{work_item_id}/comments": {
      "post": {
        "tags": [
          "Projects & work"
        ],
        "summary": "Add a work-item comment",
        "description": "Add a work-item comment Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "create_work_comment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "work_item_id",
            "in": "path",
            "required": true,
            "description": "Opaque work item id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "body": {
                    "type": "string"
                  }
                },
                "required": [
                  "body"
                ],
                "additionalProperties": false
              },
              "example": {
                "body": "Synthetic completion note."
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Add a work-item comment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "workcomment_test_01J9NEWCOMMENT",
                    "object": "work_comment",
                    "status": "accepted",
                    "name": "Example work comment",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_work_comment_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "projects:write"
      }
    },
    "/api/retail/v1/work-items/{work_item_id}/approvals": {
      "post": {
        "tags": [
          "Projects & work"
        ],
        "summary": "Request work approval",
        "description": "Request work approval Requires Idempotency-Key. Production mutation remains operation-gated.",
        "operationId": "request_work_approval",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "work_item_id",
            "in": "path",
            "required": true,
            "description": "Opaque work item id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "approver_profile_id": {
                    "type": "string"
                  },
                  "request_note": {
                    "type": "string"
                  }
                },
                "required": [
                  "approver_profile_id",
                  "request_note"
                ],
                "additionalProperties": false
              },
              "example": {
                "approver_profile_id": "usr_test_01J9MANAGER",
                "request_note": "Review completed installation."
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Request work approval response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "workapproval_test_01J9NEWAPPROVAL",
                    "object": "work_approval",
                    "status": "accepted",
                    "name": "Example work approval",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_work_approval_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "projects:write"
      }
    },
    "/api/retail/v1/fulfillment/orders": {
      "get": {
        "tags": [
          "Orders & fulfillment"
        ],
        "summary": "List fulfillment orders",
        "description": "Lists operational fulfillment orders from the native sale and line-item model, including an explicit online-store channel link when the order originated in CentriPOS commerce.",
        "operationId": "list_orders",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Filter by type.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "promised_since",
            "in": "query",
            "required": false,
            "description": "Filter by promised since.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List fulfillment orders response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": [
                    {
                      "id": "018f6f54-a4dc-7c99-8f44-111111111111",
                      "object": "fulfillment_order",
                      "sale_id": "018f6f54-a4dc-7c99-8f44-111111111111",
                      "sale_number": "S-10482",
                      "status": "ready",
                      "sale_status": "completed",
                      "channel": "online_store",
                      "storefront_order": {
                        "id": "018f6f54-a4dc-7c99-8f44-222222222222",
                        "order_number": "WEB-10482",
                        "status": "paid"
                      },
                      "customer_id": "cus_test_01J9ALEXMORGAN",
                      "location_id": "loc_test_01J9NORTHSTAR",
                      "fulfillment": {
                        "type": "pickup",
                        "status": "ready",
                        "promised_date": "2026-08-26",
                        "time_preference": "Afternoon",
                        "source_location_id": "loc_test_01J9NORTHSTAR",
                        "pickup_location_id": "loc_test_01J9NORTHSTAR",
                        "pickup_method_id": "018f6f54-a4dc-7c99-8f44-333333333333",
                        "ship_to_location_id": null,
                        "shipping_method": null,
                        "delivery_address": null,
                        "delivery_phone": "+1-555-010-0184"
                      },
                      "totals": {
                        "total": 1727.72,
                        "amount_paid": 1727.72,
                        "balance_due": 0
                      },
                      "item_summary": {
                        "line_count": 1,
                        "quantity": 1,
                        "open_line_count": 1
                      },
                      "created_at": "2026-08-24T14:31:02Z",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSFULFILLMENTLIST",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "fulfillment:read"
      }
    },
    "/api/retail/v1/fulfillment/orders/{order_id}": {
      "get": {
        "tags": [
          "Orders & fulfillment"
        ],
        "summary": "Get a fulfillment order",
        "description": "Returns the complete whitelisted fulfillment projection with line snapshots, customer delivery contact, online-order linkage, and safe shipment summaries.",
        "operationId": "get_order",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "required": true,
            "description": "Opaque order id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a fulfillment order response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": {
                    "id": "018f6f54-a4dc-7c99-8f44-111111111111",
                    "object": "fulfillment_order",
                    "sale_id": "018f6f54-a4dc-7c99-8f44-111111111111",
                    "sale_number": "S-10482",
                    "status": "ready",
                    "sale_status": "completed",
                    "channel": "online_store",
                    "storefront_order": {
                      "id": "018f6f54-a4dc-7c99-8f44-222222222222",
                      "order_number": "WEB-10482",
                      "status": "paid"
                    },
                    "customer_id": "cus_test_01J9ALEXMORGAN",
                    "location_id": "loc_test_01J9NORTHSTAR",
                    "fulfillment": {
                      "type": "pickup",
                      "status": "ready",
                      "promised_date": "2026-08-26",
                      "time_preference": "Afternoon",
                      "source_location_id": "loc_test_01J9NORTHSTAR",
                      "pickup_location_id": "loc_test_01J9NORTHSTAR",
                      "pickup_method_id": "018f6f54-a4dc-7c99-8f44-333333333333",
                      "ship_to_location_id": null,
                      "shipping_method": null,
                      "delivery_address": null,
                      "delivery_phone": "+1-555-010-0184"
                    },
                    "totals": {
                      "total": 1727.72,
                      "amount_paid": 1727.72,
                      "balance_due": 0
                    },
                    "item_summary": {
                      "line_count": 1,
                      "quantity": 1,
                      "open_line_count": 1
                    },
                    "line_items": [
                      {
                        "id": "line_test_01J9SALE10482A",
                        "sort_order": 1,
                        "quantity": 1,
                        "product": {
                          "id": "prd_test_01J9HARBOR12",
                          "name": "Harbor 12-inch Hybrid Mattress",
                          "brand": "Northstar Sleep"
                        },
                        "variant": {
                          "id": "var_test_01J9HARBORQUEEN",
                          "name": "Queen / Medium",
                          "sku": "DEMO-HBR-Q-MED",
                          "options": [
                            {
                              "name": "Size",
                              "value": "Queen"
                            },
                            {
                              "name": "Feel",
                              "value": "Medium"
                            }
                          ]
                        },
                        "unit_price": 1699,
                        "quantity_price": 1699,
                        "discount_total": 100,
                        "tax_total": 128.72,
                        "line_total": 1727.72,
                        "discounts": [
                          {
                            "id": "promo_test_100OFF",
                            "name": "Synthetic launch offer",
                            "type": "fixed",
                            "amount": 100
                          }
                        ],
                        "tax_lines": [
                          {
                            "id": "tax_test_state_local",
                            "name": "Combined sales tax",
                            "rate": 0.0805,
                            "taxable_amount": 1599,
                            "amount": 128.72
                          }
                        ],
                        "fulfillment": {
                          "type": "pickup",
                          "status": "ready",
                          "location": {
                            "id": "loc_test_01J9NORTHSTAR",
                            "name": "Northstar Main Store",
                            "code": "MAIN",
                            "timezone": "America/Chicago"
                          },
                          "promised_at": "2026-08-26T18:00:00Z"
                        },
                        "inventory_commitment": {
                          "state": "backordered",
                          "reserved_quantity": 0,
                          "backorder_quantity": 1,
                          "policy": "allow_notify",
                          "eta_date": "2026-09-03",
                          "customer_message": "Available on backorder. Estimated fulfillment in 10 days."
                        },
                        "backorder": {
                          "object": "commerce_backorder_commitment",
                          "id": "boc_test_01J9SALE10482A",
                          "status": "awaiting_stock",
                          "requested_quantity": 1,
                          "initially_reserved_quantity": 0,
                          "backorder_quantity": 1,
                          "allocated_quantity": 0,
                          "remaining_quantity": 1,
                          "policy": "allow_notify",
                          "eta_date": "2026-09-03",
                          "customer_message": "Available on backorder. Estimated fulfillment in 10 days.",
                          "allocated_at": null,
                          "fulfilled_at": null,
                          "cancelled_at": null,
                          "created_at": "2026-08-24T14:31:02Z",
                          "updated_at": "2026-08-24T14:31:02Z"
                        },
                        "warranty": {
                          "term_years": 15,
                          "registered": false
                        },
                        "note": null
                      }
                    ],
                    "customer": {
                      "id": "cus_test_01J9ALEXMORGAN",
                      "first_name": "Alex",
                      "last_name": "Morgan",
                      "email": "alex.morgan@example.test",
                      "phone": "+1-555-010-0184"
                    },
                    "online_order": {
                      "id": "018f6f54-a4dc-7c99-8f44-222222222222",
                      "order_number": "WEB-10482",
                      "status": "paid",
                      "shipping_address": null,
                      "fulfillment_type": "pickup",
                      "fulfillment_date": "2026-08-26",
                      "delivery_method_id": null,
                      "pickup_location_id": "loc_test_01J9NORTHSTAR",
                      "shipping_method_id": null,
                      "totals": {
                        "subtotal": 1599,
                        "shipping": 0,
                        "tax": 128.72,
                        "total": 1727.72
                      },
                      "tax_breakdown": [
                        {
                          "name": "Combined sales tax",
                          "amount": 128.72
                        }
                      ],
                      "created_at": "2026-08-24T14:31:02Z",
                      "updated_at": "2026-08-24T14:36:18Z"
                    },
                    "shipments": [],
                    "created_at": "2026-08-24T14:31:02Z",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSFULFILLMENT",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "fulfillment:read"
      },
      "patch": {
        "tags": [
          "Orders & fulfillment"
        ],
        "summary": "Update fulfillment status",
        "description": "Update fulfillment status",
        "operationId": "update_order",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "required": true,
            "description": "Opaque order id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "note": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "note"
                ],
                "additionalProperties": false
              },
              "example": {
                "status": "ready",
                "note": "Synthetic order staged at pickup desk."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update fulfillment status response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "ful_test_01J9PICKUP10482",
                    "object": "fulfillment_order",
                    "status": "accepted",
                    "name": "Example fulfillment order",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_fulfillment_order_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "fulfillment:write"
      }
    },
    "/api/retail/v1/delivery-methods": {
      "get": {
        "tags": [
          "Orders & fulfillment"
        ],
        "summary": "List delivery methods",
        "description": "Returns tenant-defined delivery pricing, coverage, availability, and online eligibility without private provider configuration.",
        "operationId": "list_delivery_methods",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "List delivery methods response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": [
                    {
                      "id": "018f6f54-a4dc-7c99-8f44-444444444444",
                      "object": "delivery_method",
                      "name": "Local delivery",
                      "description": "Synthetic local delivery method.",
                      "is_enabled": true,
                      "online_enabled": true,
                      "price": {
                        "enabled": true,
                        "base": 79,
                        "apply_tax": false,
                        "mode": "flat",
                        "distance_multiplier": null,
                        "distance_adjustment": null,
                        "rounding_mode": "nearest_cent"
                      },
                      "availability_behavior": "scheduled",
                      "coverage": {
                        "mode": "distance",
                        "minimum_distance_miles": 0,
                        "maximum_distance_miles": 30
                      },
                      "sort_order": 1,
                      "created_at": "2026-08-20T14:00:00Z",
                      "updated_at": "2026-08-24T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "request_id": "req_test_01J9DOCSDELIVERY",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "fulfillment:read"
      }
    },
    "/api/retail/v1/shipping-methods": {
      "get": {
        "tags": [
          "Orders & fulfillment"
        ],
        "summary": "List shipping methods",
        "description": "Returns tenant-defined shipping methods, pricing, tax behavior, coverage, and online eligibility.",
        "operationId": "list_shipping_methods",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "List shipping methods response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": [
                    {
                      "id": "018f6f54-a4dc-7c99-8f44-555555555555",
                      "object": "shipping_method",
                      "name": "Ground shipping",
                      "description": "Synthetic ground service.",
                      "is_enabled": true,
                      "online_enabled": true,
                      "base_price": 49,
                      "apply_tax": false,
                      "coverage_mode": "configured_zones",
                      "sort_order": 1,
                      "created_at": "2026-08-20T14:00:00Z",
                      "updated_at": "2026-08-24T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "request_id": "req_test_01J9DOCSSHIPPING",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "fulfillment:read"
      }
    },
    "/api/retail/v1/fulfillment/availability": {
      "get": {
        "tags": [
          "Orders & fulfillment"
        ],
        "summary": "Get fulfillment availability",
        "description": "Get fulfillment availability",
        "operationId": "get_availability",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Filter by type.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "postal_code",
            "in": "query",
            "required": false,
            "description": "Filter by postal code.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Filter by from.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "Filter by to.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get fulfillment availability response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "type": "pickup",
                    "location": {
                      "id": "loc_test_01J9NORTHSTAR",
                      "name": "Northstar Main Store",
                      "code": "MAIN",
                      "timezone": "America/Chicago"
                    },
                    "dates": [
                      {
                        "date": "2026-08-26",
                        "remaining_capacity": 8
                      },
                      {
                        "date": "2026-08-27",
                        "remaining_capacity": 5
                      }
                    ]
                  },
                  "meta": {
                    "request_id": "req_test_availability",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "fulfillment:read"
      }
    },
    "/api/retail/v1/shipments": {
      "post": {
        "tags": [
          "Orders & fulfillment"
        ],
        "summary": "Create a shipment",
        "description": "Create a shipment",
        "operationId": "create_shipment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "fulfillment_order_id": {
                    "type": "string"
                  },
                  "shipping_method_id": {
                    "type": "string"
                  },
                  "packages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "weight": {
                          "type": "integer"
                        },
                        "weight_unit": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "weight",
                        "weight_unit"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "fulfillment_order_id",
                  "shipping_method_id",
                  "packages"
                ],
                "additionalProperties": false
              },
              "example": {
                "fulfillment_order_id": "ful_test_01J9SHIP10483",
                "shipping_method_id": "shp_method_test_ground",
                "packages": [
                  {
                    "weight": 82,
                    "weight_unit": "lb"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a shipment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "shp_test_01J9EXAMPLE",
                    "object": "shipment",
                    "status": "accepted",
                    "name": "Example shipment",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_shipment_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "fulfillment:write"
      }
    },
    "/api/retail/v1/shipments/{shipment_id}": {
      "get": {
        "tags": [
          "Orders & fulfillment"
        ],
        "summary": "Get a shipment",
        "description": "Returns safe shipment and tracking state without labels, credentials, provider requests, rate payloads, or raw responses.",
        "operationId": "get_shipment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "shipment_id",
            "in": "path",
            "required": true,
            "description": "Opaque shipment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a shipment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": {
                    "id": "018f6f54-a4dc-7c99-8f44-666666666666",
                    "object": "shipment",
                    "sale_id": "sal_test_01J9SALE10482",
                    "location_id": "loc_test_01J9NORTHSTAR",
                    "provider": "synthetic_carrier_api",
                    "status": "in_transit",
                    "carrier": "Example Carrier",
                    "service": "ground",
                    "tracking_number": "DEMO123456789",
                    "tracking_url": "https://tracking.example.test/DEMO123456789",
                    "parcel": {
                      "weight": 82,
                      "weight_unit": "lb"
                    },
                    "ship_to": {
                      "city": "Sample City",
                      "region": "IL",
                      "postal_code": "60000",
                      "country": "US"
                    },
                    "ship_from": {
                      "city": "Sample City",
                      "region": "IL",
                      "postal_code": "60001",
                      "country": "US"
                    },
                    "purchased_at": "2026-08-24T15:00:00Z",
                    "voided_at": null,
                    "created_at": "2026-08-24T14:50:00Z",
                    "updated_at": "2026-08-25T10:00:00Z"
                  },
                  "meta": {
                    "request_id": "req_test_01J9DOCSSHIPMENT",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "fulfillment:read"
      }
    },
    "/api/retail/v1/suppliers": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "List suppliers",
        "description": "List suppliers",
        "operationId": "list_suppliers",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Filter by search.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Filter by active.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List suppliers response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "supplier_test_01J9EXAMPLE",
                      "object": "supplier",
                      "status": "synthetic_example",
                      "name": "Example supplier",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_supplier_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "purchasing:read"
      }
    },
    "/api/retail/v1/suppliers/{supplier_id}": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "Get a supplier",
        "description": "Get a supplier",
        "operationId": "get_supplier",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "supplier_id",
            "in": "path",
            "required": true,
            "description": "Opaque supplier id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a supplier response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "sup_test_01J9EXAMPLE",
                    "object": "supplier",
                    "status": "synthetic_example",
                    "name": "Example supplier",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_supplier",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "purchasing:read"
      }
    },
    "/api/retail/v1/purchase-orders": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "List purchase orders",
        "description": "List purchase orders",
        "operationId": "list_purchase_orders",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "supplier_id",
            "in": "query",
            "required": false,
            "description": "Filter by supplier id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List purchase orders response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "purchase_order_test_01J9EXAMPLE",
                      "object": "purchase_order",
                      "status": "synthetic_example",
                      "name": "Example purchase order",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_purchase_order_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "purchasing:read"
      },
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "Create a purchase order",
        "description": "Create a purchase order",
        "operationId": "create_purchase_order",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "supplier_id": {
                    "type": "string"
                  },
                  "destination_location_id": {
                    "type": "string"
                  },
                  "lines": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "variant_id": {
                          "type": "string"
                        },
                        "quantity": {
                          "type": "integer"
                        },
                        "unit_cost": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "variant_id",
                        "quantity",
                        "unit_cost"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "supplier_id",
                  "destination_location_id",
                  "lines"
                ],
                "additionalProperties": false
              },
              "example": {
                "supplier_id": "sup_test_01J9EXAMPLE",
                "destination_location_id": "loc_test_01J9NORTHSTAR",
                "lines": [
                  {
                    "variant_id": "var_test_01J9HARBORQUEEN",
                    "quantity": 4,
                    "unit_cost": 725
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a purchase order response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "po_test_01J9EXAMPLE",
                    "object": "purchase_order",
                    "status": "accepted",
                    "name": "Example purchase order",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_purchase_order_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "purchasing:write"
      }
    },
    "/api/retail/v1/purchase-orders/{purchase_order_id}": {
      "get": {
        "tags": [
          "Purchasing"
        ],
        "summary": "Get a purchase order",
        "description": "Get a purchase order",
        "operationId": "get_purchase_order",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "purchase_order_id",
            "in": "path",
            "required": true,
            "description": "Opaque purchase order id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a purchase order response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "po_test_01J9EXAMPLE",
                    "object": "purchase_order",
                    "status": "synthetic_example",
                    "name": "Example purchase order",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_purchase_order",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "purchasing:read"
      }
    },
    "/api/retail/v1/purchase-orders/{purchase_order_id}/submit": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "Submit a purchase order",
        "description": "Submit a purchase order",
        "operationId": "submit_purchase_order",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "purchase_order_id",
            "in": "path",
            "required": true,
            "description": "Opaque purchase order id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "submitted_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "submitted_at"
                ],
                "additionalProperties": false
              },
              "example": {
                "submitted_at": "2026-08-25T15:00:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Submit a purchase order response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "po_test_01J9EXAMPLE",
                    "object": "purchase_order",
                    "status": "accepted",
                    "name": "Example purchase order",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_purchase_order_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "purchasing:write"
      }
    },
    "/api/retail/v1/purchase-orders/{purchase_order_id}/receivings": {
      "post": {
        "tags": [
          "Purchasing"
        ],
        "summary": "Receive purchase-order inventory",
        "description": "Receive purchase-order inventory",
        "operationId": "receive_purchase_order",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "purchase_order_id",
            "in": "path",
            "required": true,
            "description": "Opaque purchase order id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "location_id": {
                    "type": "string"
                  },
                  "lines": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "variant_id": {
                          "type": "string"
                        },
                        "quantity_received": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "variant_id",
                        "quantity_received"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "location_id",
                  "lines"
                ],
                "additionalProperties": false
              },
              "example": {
                "location_id": "loc_test_01J9NORTHSTAR",
                "lines": [
                  {
                    "variant_id": "var_test_01J9HARBORQUEEN",
                    "quantity_received": 4
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Receive purchase-order inventory response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "rcv_test_01J9EXAMPLE",
                    "object": "receiving",
                    "status": "accepted",
                    "name": "Example receiving",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_receiving_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "purchasing:write"
      }
    },
    "/api/retail/v1/price-books": {
      "get": {
        "tags": [
          "Pricing & tax"
        ],
        "summary": "List price books",
        "description": "List price books",
        "operationId": "list_price_books",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Filter by active.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "description": "Filter by channel.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List price books response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "price_book_test_01J9EXAMPLE",
                      "object": "price_book",
                      "status": "synthetic_example",
                      "name": "Example price book",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_price_book_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "pricing:read"
      }
    },
    "/api/retail/v1/price-books/{price_book_id}": {
      "get": {
        "tags": [
          "Pricing & tax"
        ],
        "summary": "Get a price book",
        "description": "Get a price book",
        "operationId": "get_price_book",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "price_book_id",
            "in": "path",
            "required": true,
            "description": "Opaque price book id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a price book response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "pb_test_01J9EXAMPLE",
                    "object": "price_book",
                    "status": "synthetic_example",
                    "name": "Example price book",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_price_book",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "pricing:read"
      }
    },
    "/api/retail/v1/promotions": {
      "get": {
        "tags": [
          "Pricing & tax"
        ],
        "summary": "List promotions",
        "description": "List promotions",
        "operationId": "list_promotions",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "description": "Filter by channel.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "active_at",
            "in": "query",
            "required": false,
            "description": "Filter by active at.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List promotions response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "promotion_test_01J9EXAMPLE",
                      "object": "promotion",
                      "status": "synthetic_example",
                      "name": "Example promotion",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_promotion_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "pricing:read"
      },
      "post": {
        "tags": [
          "Pricing & tax"
        ],
        "summary": "Create a promotion",
        "description": "Create a promotion",
        "operationId": "create_promotion",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "channel": {
                    "type": "string"
                  },
                  "action": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "amount": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "type",
                      "amount"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "name",
                  "channel",
                  "action"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Synthetic weekend offer",
                "channel": "in_store_and_online",
                "action": {
                  "type": "fixed_discount",
                  "amount": 100
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a promotion response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "promo_test_01J9EXAMPLE",
                    "object": "promotion",
                    "status": "accepted",
                    "name": "Example promotion",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_promotion_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "pricing:write"
      }
    },
    "/api/retail/v1/tax-rates": {
      "get": {
        "tags": [
          "Pricing & tax"
        ],
        "summary": "List tax rates",
        "description": "List tax rates",
        "operationId": "list_tax_rates",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Filter by active.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List tax rates response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "tax_rate_test_01J9EXAMPLE",
                      "object": "tax_rate",
                      "status": "synthetic_example",
                      "name": "Example tax rate",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_tax_rate_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "pricing:read"
      }
    },
    "/api/retail/v1/merchant": {
      "get": {
        "tags": [
          "Merchant setup"
        ],
        "summary": "Get merchant projection",
        "description": "Get merchant projection",
        "operationId": "get_merchant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Get merchant projection response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "mrc_test_01J9NORTHSTAR",
                    "display_name": "Northstar Home & Sleep",
                    "currency": "USD",
                    "timezone": "America/Chicago",
                    "environment": "test"
                  },
                  "meta": {
                    "request_id": "req_test_merchant",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "merchant:read"
      }
    },
    "/api/retail/v1/locations": {
      "get": {
        "tags": [
          "Merchant setup"
        ],
        "summary": "List locations",
        "description": "List locations",
        "operationId": "list_locations",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Filter by active.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List locations response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "loc_test_01J9NORTHSTAR",
                      "name": "Northstar Main Store",
                      "code": "MAIN",
                      "timezone": "America/Chicago"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_locations",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "locations:read"
      }
    },
    "/api/retail/v1/locations/{location_id}": {
      "get": {
        "tags": [
          "Merchant setup"
        ],
        "summary": "Get a location",
        "description": "Get a location",
        "operationId": "get_location",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "location_id",
            "in": "path",
            "required": true,
            "description": "Opaque location id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a location response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "loc_test_01J9NORTHSTAR",
                    "name": "Northstar Main Store",
                    "code": "MAIN",
                    "timezone": "America/Chicago"
                  },
                  "meta": {
                    "request_id": "req_test_location",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "locations:read"
      }
    },
    "/api/retail/v1/registers": {
      "get": {
        "tags": [
          "Merchant setup"
        ],
        "summary": "List registers",
        "description": "List registers",
        "operationId": "list_registers",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Filter by active.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List registers response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "reg_test_01J9FRONT01",
                      "name": "Front Register",
                      "code": "FRONT-1"
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_registers",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "locations:read"
      }
    },
    "/api/retail/v1/users": {
      "get": {
        "tags": [
          "Merchant setup"
        ],
        "summary": "List users",
        "description": "List users",
        "operationId": "list_users",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "role_id",
            "in": "query",
            "required": false,
            "description": "Filter by role id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Filter by active.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List users response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "user_test_01J9EXAMPLE",
                      "object": "user",
                      "status": "synthetic_example",
                      "name": "Example user",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_user_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "users:read"
      }
    },
    "/api/retail/v1/roles": {
      "get": {
        "tags": [
          "Merchant setup"
        ],
        "summary": "List roles",
        "description": "List roles",
        "operationId": "list_roles",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "List roles response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "role_test_01J9EXAMPLE",
                      "object": "role",
                      "status": "synthetic_example",
                      "name": "Example role",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_role_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "users:read"
      }
    },
    "/api/retail/v1/payment-types": {
      "get": {
        "tags": [
          "Merchant setup"
        ],
        "summary": "List payment types",
        "description": "List payment types",
        "operationId": "list_payment_types",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "List payment types response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "payment_type_test_01J9EXAMPLE",
                      "object": "payment_type",
                      "status": "synthetic_example",
                      "name": "Example payment type",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_payment_type_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "merchant:read"
      }
    },
    "/api/retail/v1/reports/sales-summary": {
      "get": {
        "tags": [
          "Reports & exports"
        ],
        "summary": "Read sales summary",
        "description": "Read sales summary",
        "operationId": "sales_summary",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "from",
            "in": "query",
            "required": false,
            "description": "Filter by from.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "to",
            "in": "query",
            "required": false,
            "description": "Filter by to.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "group_by",
            "in": "query",
            "required": false,
            "description": "Filter by group by.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Read sales summary response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "currency": "USD",
                    "period": {
                      "from": "2026-08-01",
                      "to": "2026-08-24"
                    },
                    "gross_sales": 128450.32,
                    "discounts": 6830.15,
                    "returns": 4210.5,
                    "net_sales": 117409.67,
                    "tax": 9446.48,
                    "transactions": 241
                  },
                  "meta": {
                    "request_id": "req_test_sales_report",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "reports:read"
      }
    },
    "/api/retail/v1/reports/inventory-valuation": {
      "get": {
        "tags": [
          "Reports & exports"
        ],
        "summary": "Read inventory valuation",
        "description": "Read inventory valuation",
        "operationId": "inventory_valuation",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "location_id",
            "in": "query",
            "required": false,
            "description": "Opaque location identifier visible to the authenticated API client.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "description": "Filter by as of.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "group_by",
            "in": "query",
            "required": false,
            "description": "Filter by group by.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Read inventory valuation response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "report_test_01J9EXAMPLE",
                    "object": "inventory_valuation",
                    "status": "synthetic_example",
                    "name": "Example inventory valuation",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_inventory_valuation",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "reports:read"
      }
    },
    "/api/retail/v1/exports": {
      "post": {
        "tags": [
          "Reports & exports"
        ],
        "summary": "Create an asynchronous export",
        "description": "Create an asynchronous export",
        "operationId": "create_export",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "resource": {
                    "type": "string"
                  },
                  "format": {
                    "type": "string"
                  },
                  "filters": {
                    "type": "object",
                    "properties": {
                      "from": {
                        "type": "string"
                      },
                      "to": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "from",
                      "to"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "resource",
                  "format",
                  "filters"
                ],
                "additionalProperties": false
              },
              "example": {
                "resource": "sales",
                "format": "csv",
                "filters": {
                  "from": "2026-08-01",
                  "to": "2026-08-24"
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an asynchronous export response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "exp_test_01J9EXAMPLE",
                    "object": "export",
                    "status": "accepted",
                    "name": "Example export",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_export_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "reports:export"
      }
    },
    "/api/retail/v1/exports/{export_id}": {
      "get": {
        "tags": [
          "Reports & exports"
        ],
        "summary": "Get export status",
        "description": "Get export status",
        "operationId": "get_export",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "export_id",
            "in": "path",
            "required": true,
            "description": "Opaque export id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get export status response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "exp_test_01J9EXAMPLE",
                    "status": "completed",
                    "format": "csv",
                    "expires_at": "2026-08-25T14:36:18Z",
                    "download_url": "https://downloads.example.test/export-synthetic.csv"
                  },
                  "meta": {
                    "request_id": "req_test_export",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "reports:export"
      }
    },
    "/api/retail/v1/webhook-subscriptions": {
      "get": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "List webhook subscriptions",
        "description": "List webhook subscriptions",
        "operationId": "list_webhooks",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "List webhook subscriptions response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "webhook_subscription_test_01J9EXAMPLE",
                      "object": "webhook_subscription",
                      "status": "synthetic_example",
                      "name": "Example webhook subscription",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_webhook_subscription_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "webhooks:read"
      },
      "post": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "Create a webhook subscription",
        "description": "Create a webhook subscription Signing secret is shown once. Requires Idempotency-Key. Event and calendar delivery also requires the subscription client to retain the corresponding resource-read scope.",
        "operationId": "create_webhook",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string"
                  },
                  "events": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "url",
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "url": "https://integrator.example.test/webhooks/centripos",
                "events": [
                  "commerce_backorder.created",
                  "commerce_backorder.updated",
                  "event_offering.created",
                  "event_offering.updated",
                  "event_offering.deleted",
                  "event_occurrence.created",
                  "event_occurrence.updated",
                  "event_occurrence.deleted",
                  "event_occurrence_instance.created",
                  "event_occurrence_instance.updated",
                  "event_occurrence_instance.deleted",
                  "event_occurrence_exception.created",
                  "event_occurrence_exception.updated",
                  "event_occurrence_exception.deleted",
                  "event_capacity_pool.created",
                  "event_capacity_pool.updated",
                  "event_capacity_pool.deleted",
                  "event_ticket_option.created",
                  "event_ticket_option.updated",
                  "event_ticket_option.deleted",
                  "event_payment_plan_policy.created",
                  "event_payment_plan_policy.updated",
                  "event_payment_plan_policy.archived",
                  "event_space.created",
                  "event_space.updated",
                  "event_space.deleted",
                  "event_track.created",
                  "event_track.updated",
                  "event_track.deleted",
                  "event_occurrence_track.created",
                  "event_occurrence_track.updated",
                  "event_occurrence_track.deleted",
                  "event_person.created",
                  "event_person.updated",
                  "event_person.deleted",
                  "event_organization.created",
                  "event_organization.updated",
                  "event_organization.deleted",
                  "event_stakeholder_role.created",
                  "event_stakeholder_role.updated",
                  "event_stakeholder_role.deleted",
                  "event_selection_group.created",
                  "event_selection_group.updated",
                  "event_selection_group.deleted",
                  "event_selection_group_occurrence.created",
                  "event_selection_group_occurrence.updated",
                  "event_selection_group_occurrence.deleted",
                  "event_addon_option.created",
                  "event_addon_option.updated",
                  "event_addon_option.deleted",
                  "event_participant.created",
                  "event_participant.updated",
                  "event_participant.deleted",
                  "event_participant_guardian.created",
                  "event_participant_guardian.updated",
                  "event_participant_guardian.deleted",
                  "event_participant_addon.created",
                  "event_participant_addon.updated",
                  "event_participant_addon.deleted",
                  "event_occurrence_enrollment.created",
                  "event_occurrence_enrollment.updated",
                  "event_occurrence_enrollment.deleted",
                  "event_registration.created",
                  "event_registration.updated",
                  "event_registration.deleted",
                  "event_registration_payment_plan.activated",
                  "event_registration_payment_plan.paused",
                  "event_registration_payment_plan.resumed",
                  "event_registration_payment_plan.delinquent",
                  "event_registration_payment_plan.completed",
                  "event_registration_payment_plan.canceled",
                  "event_registration_payment_plan.admission_reinstated",
                  "event_ticket.created",
                  "event_ticket.updated",
                  "event_ticket.deleted",
                  "event_checkin.created",
                  "event_waitlist_entry.created",
                  "event_waitlist_entry.updated",
                  "event_waitlist_entry.deleted",
                  "event_asset.created",
                  "event_asset.updated",
                  "event_asset.deleted",
                  "event_publication_feed.created",
                  "event_publication_feed.updated",
                  "event_publication_feed.deleted",
                  "event_registration_form.created",
                  "event_registration_form.updated",
                  "event_registration_form.deleted",
                  "event_offering_form_assignment.created",
                  "event_offering_form_assignment.updated",
                  "event_offering_form_assignment.deleted",
                  "event_registration_form_completion.created",
                  "event_registration_form_completion.updated",
                  "event_registration_question.created",
                  "event_registration_question.updated",
                  "event_registration_question.deleted",
                  "event_waiver.created",
                  "event_waiver.updated",
                  "event_waiver.deleted",
                  "event_offering_waiver_assignment.created",
                  "event_offering_waiver_assignment.updated",
                  "event_offering_waiver_assignment.deleted",
                  "event_waiver_acceptance.created",
                  "event_venue.created",
                  "event_venue.updated",
                  "event_venue.deleted",
                  "event_ticket_preset.created",
                  "event_ticket_preset.updated",
                  "event_ticket_preset.deleted",
                  "event_purchase_rule_set.created",
                  "event_purchase_rule_set.updated",
                  "event_purchase_rule_set.deleted",
                  "event_purchase_rule_group.created",
                  "event_purchase_rule_group.updated",
                  "event_purchase_rule_group.deleted",
                  "event_purchase_rule_condition.created",
                  "event_purchase_rule_condition.updated",
                  "event_purchase_rule_condition.deleted",
                  "event_purchase_rule_action.created",
                  "event_purchase_rule_action.updated",
                  "event_purchase_rule_action.deleted",
                  "event_scanner_device.created",
                  "event_scanner_device.updated",
                  "event_scanner_device.deleted",
                  "event_scanner_sync_batch.created",
                  "event_ticket_delivery_settings.created",
                  "event_ticket_delivery_settings.updated",
                  "event_ticket_artifact.created",
                  "event_ticket_artifact.updated",
                  "event_ticket_artifact.deleted",
                  "event_venue_layout.created",
                  "event_venue_layout.updated",
                  "event_venue_layout.deleted",
                  "event_seating_section.created",
                  "event_seating_section.updated",
                  "event_seating_section.deleted",
                  "event_seating_row.created",
                  "event_seating_row.updated",
                  "event_seating_row.deleted",
                  "event_seat.created",
                  "event_seat.updated",
                  "event_seat.deleted",
                  "event_seating_pricing_zone.created",
                  "event_seating_pricing_zone.updated",
                  "event_seating_pricing_zone.deleted",
                  "event_seating_zone_seat.created",
                  "event_seating_zone_seat.deleted",
                  "event_occurrence_seating_config.created",
                  "event_occurrence_seating_config.updated",
                  "event_occurrence_seating_config.deleted",
                  "event_ticket_seating_zone_rule.created",
                  "event_ticket_seating_zone_rule.updated",
                  "event_ticket_seating_zone_rule.deleted",
                  "event_seat_hold.created",
                  "event_seat_hold.updated",
                  "event_seat_hold.deleted",
                  "event_seat_assignment.created",
                  "event_seat_assignment.updated",
                  "event_seat_assignment.deleted",
                  "event_seat_inventory_event.created",
                  "event_access_code_set.created",
                  "event_access_code_set.updated",
                  "event_access_code_set.deleted",
                  "event_access_code.created",
                  "event_access_code.updated",
                  "event_access_code.deleted",
                  "event_access_code_reservation.created",
                  "event_access_code_reservation.updated",
                  "event_access_code_reservation.deleted",
                  "event_registration_intent_physical_seat.created",
                  "event_registration_intent_physical_seat.updated",
                  "event_registration_intent_physical_seat.deleted",
                  "calendar_entry.created",
                  "calendar_entry.updated",
                  "calendar_entry.deleted",
                  "calendar_entry_attendee.created",
                  "calendar_entry_attendee.updated",
                  "calendar_entry_attendee.deleted"
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a webhook subscription response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "whsub_test_01J9EXAMPLE",
                    "object": "webhook_subscription",
                    "status": "accepted",
                    "name": "Example webhook subscription",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_webhook_subscription_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "webhooks:write"
      }
    },
    "/api/retail/v1/webhook-subscriptions/{subscription_id}": {
      "get": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "Get a webhook subscription",
        "description": "Get a webhook subscription",
        "operationId": "get_webhook",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "subscription_id",
            "in": "path",
            "required": true,
            "description": "Opaque subscription id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a webhook subscription response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "whsub_test_01J9EXAMPLE",
                    "object": "webhook_subscription",
                    "status": "synthetic_example",
                    "name": "Example webhook subscription",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_webhook_subscription",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "webhooks:read"
      },
      "patch": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "Update a webhook subscription",
        "description": "Update a webhook subscription",
        "operationId": "update_webhook",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "subscription_id",
            "in": "path",
            "required": true,
            "description": "Opaque subscription id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "events": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "events"
                ],
                "additionalProperties": false
              },
              "example": {
                "events": [
                  "sale.completed",
                  "sale.returned",
                  "inventory.level.changed",
                  "commerce_backorder.created",
                  "commerce_backorder.updated"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a webhook subscription response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "whsub_test_01J9EXAMPLE",
                    "object": "webhook_subscription",
                    "status": "accepted",
                    "name": "Example webhook subscription",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_webhook_subscription_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "webhooks:write"
      },
      "delete": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "Delete a webhook subscription",
        "description": "Delete a webhook subscription",
        "operationId": "delete_webhook",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "subscription_id",
            "in": "path",
            "required": true,
            "description": "Opaque subscription id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "webhooks:write"
      }
    },
    "/api/retail/v1/webhook-events": {
      "get": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "List webhook events",
        "description": "List immutable signed-delivery payloads. Event and calendar objects include the complete scalar safe projection allowed for that resource, changed_fields when supplied, and a branded scope-gated resource_url; protected answers, signatures, credentials, payment data, arbitrary metadata, and portal secrets are never embedded.",
        "operationId": "list_webhook_events",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "event",
            "in": "query",
            "required": false,
            "description": "Filter by event.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_since",
            "in": "query",
            "required": false,
            "description": "Return records created at or after this RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List webhook events response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebhookEventPage"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": [
                    {
                      "id": "50000000-0000-4000-8000-000000000001",
                      "type": "event_offering.updated",
                      "api_version": "2026-08-24",
                      "created_at": "2026-08-25T15:00:00Z",
                      "data": {
                        "object": {
                          "id": "10000000-0000-4000-8000-000000000001",
                          "object": "event_offering",
                          "slug": "robotics-discovery-camp",
                          "name": "Robotics Discovery Camp",
                          "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
                          "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
                          "event_kind": "camp",
                          "delivery_format": "in_person",
                          "status": "published",
                          "visibility": "public",
                          "timezone": "America/New_York",
                          "venue_id": null,
                          "venue_name": "Northstar Learning Lab",
                          "support_email": "events@example.test",
                          "support_phone": "+1-555-010-0100",
                          "registration_opens_at": "2026-08-25T13:00:00Z",
                          "registration_closes_at": "2026-09-13T23:59:00Z",
                          "minimum_age_months": 96,
                          "maximum_age_months": 156,
                          "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
                          "image_alt_text": "Synthetic robotics camp work table",
                          "canonical_public_url": null,
                          "registration_url": null,
                          "redirect_url": null,
                          "redirect_status_code": null,
                          "redirect_expires_at": null,
                          "source_system": "centripos",
                          "external_id": null,
                          "version": 3,
                          "published_at": "2026-08-25T15:00:00Z",
                          "created_at": "2026-08-25T14:00:00Z",
                          "updated_at": "2026-08-25T15:00:00Z",
                          "changed_fields": [
                            "registration_closes_at",
                            "updated_at"
                          ],
                          "resource_url": "https://pos.getcentri.com/api/retail/v1/events/10000000-0000-4000-8000-000000000001"
                        }
                      }
                    }
                  ],
                  "pagination": {
                    "next_cursor": null,
                    "has_more": false,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_event_webhooks",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "webhooks:read"
      }
    },
    "/api/retail/v1/webhook-deliveries": {
      "get": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "List webhook deliveries",
        "description": "List webhook deliveries",
        "operationId": "list_webhook_deliveries",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "subscription_id",
            "in": "query",
            "required": false,
            "description": "Filter by subscription id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "event_id",
            "in": "query",
            "required": false,
            "description": "Filter by event id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List webhook deliveries response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "webhook_delivery_test_01J9EXAMPLE",
                      "object": "webhook_delivery",
                      "status": "synthetic_example",
                      "name": "Example webhook delivery",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_webhook_delivery_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "webhooks:read"
      }
    },
    "/api/retail/v1/webhook-deliveries/{delivery_id}/redeliver": {
      "post": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "Redeliver a webhook event",
        "description": "Redeliver a webhook event",
        "operationId": "redeliver_webhook",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "delivery_id",
            "in": "path",
            "required": true,
            "description": "Opaque delivery id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string"
                  }
                },
                "required": [
                  "reason"
                ],
                "additionalProperties": false
              },
              "example": {
                "reason": "Synthetic integration replay test"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Redeliver a webhook event response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "id": "whdel_test_01J9EXAMPLE",
                    "object": "webhook_delivery",
                    "status": "accepted",
                    "name": "Example webhook delivery",
                    "updated_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "request_id": "req_test_webhook_delivery_mutation",
                    "environment": "test",
                    "idempotency": {
                      "key": "doc-example-7f404326",
                      "replayed": false
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "webhooks:write"
      }
    },
    "/api/retail/v1/request-logs": {
      "get": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "List API request logs",
        "description": "List API request logs",
        "operationId": "list_request_logs",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "method",
            "in": "query",
            "required": false,
            "description": "Filter by method.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "route",
            "in": "query",
            "required": false,
            "description": "Filter by route.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_since",
            "in": "query",
            "required": false,
            "description": "Return records created at or after this RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List API request logs response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": [
                    {
                      "id": "request_log_test_01J9EXAMPLE",
                      "object": "request_log",
                      "status": "synthetic_example",
                      "name": "Example request log",
                      "updated_at": "2026-08-24T14:36:18Z"
                    }
                  ],
                  "pagination": {
                    "next_cursor": "cur_test_NEXT_PAGE",
                    "has_more": true,
                    "limit": 50
                  },
                  "meta": {
                    "request_id": "req_test_request_log_list",
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "audit:read"
      }
    },
    "/api/retail/v1/request-logs/{request_id}": {
      "get": {
        "tags": [
          "Webhooks & audit"
        ],
        "summary": "Get an API request log",
        "description": "Get an API request log",
        "operationId": "get_request_log",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "request_id",
            "in": "path",
            "required": true,
            "description": "Opaque request id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an API request log response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ResourceEnvelope"
                },
                "example": {
                  "api_version": "2026-08",
                  "data": {
                    "request_id": "req_test_01J9DOCSSALE",
                    "method": "GET",
                    "route_template": "/sales/{sale_id}",
                    "status": 200,
                    "duration_ms": 84,
                    "scope": "sales:read",
                    "idempotency": null,
                    "created_at": "2026-08-24T14:36:18Z"
                  },
                  "meta": {
                    "environment": "test"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "controlled-rollout",
        "x-required-scope": "audit:read"
      }
    },
    "/api/retail/v1/events/{event_id}/publication-validation": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Validate Event Publication",
        "description": "Run the authoritative publish-time validation for timezone, prose, pricing, inventory, URLs, redirects, and lifecycle consistency without changing publication state.",
        "operationId": "validateEventPublication",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Validate Event Publication response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/events/{event_id}/publication-validation"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_validate-event-publication",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      }
    },
    "/api/retail/v1/events/{event_id}/publish": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Publish Event",
        "description": "Publish only through the authoritative validator. A validation failure leaves the offering unchanged and returns structured issues.",
        "operationId": "publishEvent",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  }
                },
                "required": [
                  "version"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 3
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Publish Event response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/events/{event_id}/publish"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_publish-event",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/purchase-rules/evaluate": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Evaluate Event Purchase Rules",
        "description": "Evaluate the saved visual rule graph server-side. Storefront quote performs its own authoritative evaluation; client-side previews never authorize checkout.",
        "operationId": "evaluateEventPurchaseRules",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "context": {
                    "type": "object",
                    "properties": {
                      "quantity": {
                        "type": "integer"
                      },
                      "customer_tags": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "quantity",
                      "customer_tags"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "ticket_option_id",
                  "context"
                ],
                "additionalProperties": false
              },
              "example": {
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "context": {
                  "quantity": 2,
                  "customer_tags": [
                    "member"
                  ]
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Evaluate Event Purchase Rules response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/events/{event_id}/purchase-rules/evaluate"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_evaluate-event-purchase-rules",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/scanner-manifest": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Offline Scanner Manifest",
        "description": "Download one device-bound, bounded offline admission manifest. Credentials remain operationally scoped and are not webhook or CRM fields.",
        "operationId": "getEventOfflineScannerManifest",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Offline Scanner Manifest response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/events/{event_id}/scanner-manifest"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-offline-scanner-manifest",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:read"
      }
    },
    "/api/retail/v1/events/{event_id}/scanner-sync": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Sync Event Offline Scans",
        "description": "Synchronize a bounded, idempotent offline scan batch and preserve accepted, duplicate, denied, and failed outcomes as admission evidence.",
        "operationId": "syncEventOfflineScans",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "device_key": {
                    "type": "string"
                  },
                  "client_batch_id": {
                    "type": "string"
                  },
                  "occurrence_id": {
                    "type": "string"
                  },
                  "scans": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "credential": {
                          "type": "string"
                        },
                        "direction": {
                          "type": "string"
                        },
                        "checked_in_at": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "credential",
                        "direction",
                        "checked_in_at"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "device_key",
                  "client_batch_id",
                  "occurrence_id",
                  "scans"
                ],
                "additionalProperties": false
              },
              "example": {
                "device_key": "scanner-demo-001",
                "client_batch_id": "batch-demo-001",
                "occurrence_id": "10000000-0000-4000-8000-000000000002",
                "scans": [
                  {
                    "credential": "synthetic-credential",
                    "direction": "in",
                    "checked_in_at": "2026-08-25T14:00:00Z"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Sync Event Offline Scans response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/events/{event_id}/scanner-sync"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_sync-event-offline-scans",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:write"
      }
    },
    "/api/retail/v1/event-venues": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Venues",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventVenues",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Venues response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-venues"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-venues",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Venue",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "createEventVenue",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "timezone": {
                    "type": "string"
                  },
                  "address_line_1": {
                    "type": "string"
                  },
                  "locality": {
                    "type": "string"
                  },
                  "administrative_area": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  },
                  "country_code": {
                    "type": "string"
                  }
                },
                "required": [
                  "slug",
                  "name",
                  "timezone",
                  "address_line_1",
                  "locality",
                  "administrative_area",
                  "postal_code",
                  "country_code"
                ],
                "additionalProperties": false
              },
              "example": {
                "slug": "northstar-learning-lab",
                "name": "Northstar Learning Lab",
                "timezone": "America/New_York",
                "address_line_1": "100 Example Avenue",
                "locality": "Sample City",
                "administrative_area": "OH",
                "postal_code": "43000",
                "country_code": "US"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Venue response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venues"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-venue",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-venues/{venue_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Venue",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventVenue",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "venue_id",
            "in": "path",
            "required": true,
            "description": "Opaque venue id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Venue response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venues/{venue_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-venue",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Venue",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventVenue",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "venue_id",
            "in": "path",
            "required": true,
            "description": "Opaque venue id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "arrival_instructions": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "arrival_instructions"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "arrival_instructions": "Use the east entrance."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Venue response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venues/{venue_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-venue",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Venue",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventVenue",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "venue_id",
            "in": "path",
            "required": true,
            "description": "Opaque venue id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Venue response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venues/{venue_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-venue",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-ticket-presets": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Ticket Presets",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventTicketPresets",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Ticket Presets response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-ticket-presets"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-ticket-presets",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Ticket Preset",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "createEventTicketPreset",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "default_label": {
                    "type": "string"
                  },
                  "default_price": {
                    "type": "integer"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "inventory_mode": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "name",
                  "default_label",
                  "default_price",
                  "currency",
                  "inventory_mode"
                ],
                "additionalProperties": false
              },
              "example": {
                "code": "standard-camp",
                "name": "Standard camp admission",
                "default_label": "Camper",
                "default_price": 625,
                "currency": "USD",
                "inventory_mode": "unlimited"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Ticket Preset response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-presets"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-ticket-preset",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-ticket-presets/{ticket_preset_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Ticket Preset",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventTicketPreset",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_preset_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket preset id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Ticket Preset response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-presets/{ticket_preset_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-ticket-preset",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Ticket Preset",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventTicketPreset",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_preset_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket preset id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "default_label": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "default_label"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "default_label": "Camp admission"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Ticket Preset response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-presets/{ticket_preset_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-ticket-preset",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Ticket Preset",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventTicketPreset",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_preset_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket preset id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Ticket Preset response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-presets/{ticket_preset_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-ticket-preset",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-access-code-sets": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Access Code Sets",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventAccessCodeSets",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Access Code Sets response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-access-code-sets"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-access-code-sets",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Access Code Set",
        "description": "Create manager-readable access-code-set metadata for one offering or ticket option. Secret-shaped metadata keys, raw codes, and digests are rejected; individual credentials use the credential-scoped creation route.",
        "operationId": "createEventAccessCodeSet",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "offering_id": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "max_redemptions": {
                    "type": "integer"
                  }
                },
                "required": [
                  "offering_id",
                  "code",
                  "name",
                  "status",
                  "max_redemptions"
                ],
                "additionalProperties": false
              },
              "example": {
                "offering_id": "10000000-0000-4000-8000-000000000001",
                "code": "MEMBERS",
                "name": "Member registration",
                "status": "active",
                "max_redemptions": 250
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Access Code Set response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-access-code-sets"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-access-code-set",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-access-code-sets/{code_set_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Access Code Set",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventAccessCodeSet",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "code_set_id",
            "in": "path",
            "required": true,
            "description": "Opaque code set id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Access Code Set response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-access-code-sets/{code_set_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-access-code-set",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Access Code Set",
        "description": "Update access-code-set lifecycle and manager-readable metadata with optional version preconditions. Secret-shaped metadata keys, raw codes, and digests are rejected.",
        "operationId": "updateEventAccessCodeSet",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "code_set_id",
            "in": "path",
            "required": true,
            "description": "Opaque code set id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  },
                  "max_redemptions": {
                    "type": "integer"
                  }
                },
                "required": [
                  "version",
                  "status",
                  "max_redemptions"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "status": "active",
                "max_redemptions": 300
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Access Code Set response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-access-code-sets/{code_set_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-access-code-set",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Access Code Set",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventAccessCodeSet",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "code_set_id",
            "in": "path",
            "required": true,
            "description": "Opaque code set id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Access Code Set response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-access-code-sets/{code_set_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-access-code-set",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-access-code-sets/{code_set_id}/codes": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Access Code Summaries",
        "description": "List safe access-code metadata, key versions, masked hints, confirmed redemption counts, and active reservation counts through the dedicated summary RPC. Raw codes and code_hash are never readable.",
        "operationId": "listEventAccessCodeSummaries",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "code_set_id",
            "in": "path",
            "required": true,
            "description": "Opaque code set id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Access Code Summaries response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-access-code-sets/{code_set_id}/codes"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-access-code-summaries",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Access Code",
        "description": "Accept a transient 10–128 character code only on this trusted management route. The service trims and uppercases it, requires at least one letter and one digit, selects the active versioned HMAC secret, computes HMAC-SHA256 with the frozen tenant/set domain, persists only the digest and key version, and returns only safe summary metadata; raw codes and hashes are never returned.",
        "operationId": "createEventAccessCode",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "code_set_id",
            "in": "path",
            "required": true,
            "description": "Opaque code set id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "max_redemptions": {
                    "type": "integer"
                  }
                },
                "required": [
                  "code",
                  "label",
                  "max_redemptions"
                ],
                "additionalProperties": false
              },
              "example": {
                "code": "SYNTHETIC-MEMBER-2026",
                "label": "Member preview",
                "max_redemptions": 1
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Access Code response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-access-code-sets/{code_set_id}/codes"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-access-code",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:write"
      }
    },
    "/api/retail/v1/event-access-codes/{access_code_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Access Code Summary",
        "description": "Read one safe access-code summary with immutable key-version metadata and without raw code or code_hash.",
        "operationId": "getEventAccessCodeSummary",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "access_code_id",
            "in": "path",
            "required": true,
            "description": "Opaque access code id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Access Code Summary response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-access-codes/{access_code_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-access-code-summary",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Access Code",
        "description": "Update label, lifecycle, redemption limit, or active dates. Rotate a code by creating a new record and revoking the old one; raw code, hash, key version, hint, and arbitrary metadata cannot be replaced.",
        "operationId": "updateEventAccessCode",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "access_code_id",
            "in": "path",
            "required": true,
            "description": "Opaque access code id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "status"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "status": "revoked"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Access Code response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-access-codes/{access_code_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-access-code",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:write"
      }
    },
    "/api/retail/v1/event-access-code-reservations": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Access Code Reservations",
        "description": "Read checkout-owned reservation projections without access-code hashes or raw codes.",
        "operationId": "listEventAccessCodeReservations",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Access Code Reservations response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-access-code-reservations"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-access-code-reservations",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      }
    },
    "/api/retail/v1/event-registration-intent-physical-seats": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Registration Intent Physical Seats",
        "description": "Read quote-to-intent seat-link projections. Checkout owns attachment, shortening, conversion, and release through service-only commands.",
        "operationId": "listEventRegistrationIntentPhysicalSeats",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Registration Intent Physical Seats response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-registration-intent-physical-seats"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-registration-intent-physical-seats",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      }
    },
    "/api/retail/v1/event-purchase-rules": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Purchase Rules",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventPurchaseRules",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Purchase Rules response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-purchase-rules"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-purchase-rules",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Purchase Rule",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "createEventPurchaseRule",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "attributes": {
                    "type": "object",
                    "properties": {
                      "offering_id": {
                        "type": "string"
                      },
                      "code": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string"
                      },
                      "priority": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "offering_id",
                      "code",
                      "name",
                      "status",
                      "priority"
                    ],
                    "additionalProperties": false
                  },
                  "groups": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "client_key": {
                          "type": "string"
                        },
                        "match_mode": {
                          "type": "string"
                        },
                        "sort_order": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "client_key",
                        "match_mode",
                        "sort_order"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "conditions": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "client_key": {
                          "type": "string"
                        },
                        "group_client_key": {
                          "type": "string"
                        },
                        "field_key": {
                          "type": "string"
                        },
                        "operator": {
                          "type": "string"
                        },
                        "value_json": {
                          "type": "string"
                        },
                        "sort_order": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "client_key",
                        "group_client_key",
                        "field_key",
                        "operator",
                        "value_json",
                        "sort_order"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "actions": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "action_type": {
                          "type": "string"
                        },
                        "sort_order": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "action_type",
                        "sort_order"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "attributes",
                  "groups",
                  "conditions",
                  "actions"
                ],
                "additionalProperties": false
              },
              "example": {
                "attributes": {
                  "offering_id": "10000000-0000-4000-8000-000000000001",
                  "code": "member-window",
                  "name": "Member window",
                  "status": "active",
                  "priority": 10
                },
                "groups": [
                  {
                    "client_key": "root",
                    "match_mode": "all",
                    "sort_order": 10
                  }
                ],
                "conditions": [
                  {
                    "client_key": "member",
                    "group_client_key": "root",
                    "field_key": "customer.tag",
                    "operator": "contains",
                    "value_json": "member",
                    "sort_order": 10
                  }
                ],
                "actions": [
                  {
                    "action_type": "allow",
                    "sort_order": 10
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Purchase Rule response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-purchase-rules"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-purchase-rule",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-purchase-rules/{rule_set_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Purchase Rule",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventPurchaseRule",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "rule_set_id",
            "in": "path",
            "required": true,
            "description": "Opaque rule set id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Purchase Rule response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-purchase-rules/{rule_set_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-purchase-rule",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Purchase Rule",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventPurchaseRule",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "rule_set_id",
            "in": "path",
            "required": true,
            "description": "Opaque rule set id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "attributes": {
                    "type": "object",
                    "properties": {
                      "version": {
                        "type": "integer"
                      },
                      "name": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "version",
                      "name",
                      "status"
                    ],
                    "additionalProperties": false
                  },
                  "groups": {
                    "type": "array",
                    "items": {}
                  },
                  "conditions": {
                    "type": "array",
                    "items": {}
                  },
                  "actions": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "action_type": {
                          "type": "string"
                        },
                        "sort_order": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "action_type",
                        "sort_order"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "attributes",
                  "groups",
                  "conditions",
                  "actions"
                ],
                "additionalProperties": false
              },
              "example": {
                "attributes": {
                  "version": 1,
                  "name": "Updated member window",
                  "status": "active"
                },
                "groups": [],
                "conditions": [],
                "actions": [
                  {
                    "action_type": "allow",
                    "sort_order": 10
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Purchase Rule response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-purchase-rules/{rule_set_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-purchase-rule",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Purchase Rule",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventPurchaseRule",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "rule_set_id",
            "in": "path",
            "required": true,
            "description": "Opaque rule set id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Purchase Rule response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-purchase-rules/{rule_set_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-purchase-rule",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-scanner-devices": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Scanner Devices",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventScannerDevices",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Scanner Devices response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-scanner-devices"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-scanner-devices",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Register Event Scanner Device",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "registerEventScannerDevice",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "device_key": {
                    "type": "string"
                  },
                  "display_name": {
                    "type": "string"
                  },
                  "capabilities": {
                    "type": "object",
                    "properties": {
                      "camera": {
                        "type": "boolean"
                      },
                      "offline": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "camera",
                      "offline"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "device_key",
                  "display_name",
                  "capabilities"
                ],
                "additionalProperties": false
              },
              "example": {
                "device_key": "scanner-demo-001",
                "display_name": "North gate iPad",
                "capabilities": {
                  "camera": true,
                  "offline": true
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Register Event Scanner Device response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-scanner-devices"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_register-event-scanner-device",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:write"
      }
    },
    "/api/retail/v1/event-scanner-devices/{scanner_device_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Scanner Device",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventScannerDevice",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "scanner_device_id",
            "in": "path",
            "required": true,
            "description": "Opaque scanner device id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Scanner Device response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-scanner-devices/{scanner_device_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-scanner-device",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Scanner Device",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventScannerDevice",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "scanner_device_id",
            "in": "path",
            "required": true,
            "description": "Opaque scanner device id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "display_name": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "display_name"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "display_name": "North gate scanner"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Scanner Device response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-scanner-devices/{scanner_device_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-scanner-device",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Retire Event Scanner Device",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "retireEventScannerDevice",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "scanner_device_id",
            "in": "path",
            "required": true,
            "description": "Opaque scanner device id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Retire Event Scanner Device response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-scanner-devices/{scanner_device_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_retire-event-scanner-device",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:write"
      }
    },
    "/api/retail/v1/event-scanner-sync-batches": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Scanner Sync Batches",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventScannerSyncBatches",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Scanner Sync Batches response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-scanner-sync-batches"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-scanner-sync-batches",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:read"
      }
    },
    "/api/retail/v1/event-scanner-sync-batches/{scanner_sync_batch_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Scanner Sync Batch",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventScannerSyncBatch",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "scanner_sync_batch_id",
            "in": "path",
            "required": true,
            "description": "Opaque scanner sync batch id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Scanner Sync Batch response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-scanner-sync-batches/{scanner_sync_batch_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-scanner-sync-batch",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:read"
      }
    },
    "/api/retail/v1/event-ticket-delivery-settings": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Ticket Delivery Settings",
        "description": "Read display-only PDF and wallet delivery configuration. Signing certificates, private keys, tokens, provider state, and arbitrary credential material are excluded.",
        "operationId": "getEventTicketDeliverySettings",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Get Event Ticket Delivery Settings response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-delivery-settings"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-ticket-delivery-settings",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Ticket Delivery Settings",
        "description": "Update display-only PDF and wallet delivery configuration with an optional version precondition. Provider credentials belong in isolated secrets and are rejected from metadata.",
        "operationId": "updateEventTicketDeliverySettings",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "issuer_name": {
                    "type": "string"
                  },
                  "pdf_enabled": {
                    "type": "boolean"
                  },
                  "apple_wallet_enabled": {
                    "type": "boolean"
                  },
                  "google_wallet_enabled": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "issuer_name",
                  "pdf_enabled",
                  "apple_wallet_enabled",
                  "google_wallet_enabled"
                ],
                "additionalProperties": false
              },
              "example": {
                "issuer_name": "Northstar Learning",
                "pdf_enabled": true,
                "apple_wallet_enabled": true,
                "google_wallet_enabled": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Ticket Delivery Settings response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-delivery-settings"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-ticket-delivery-settings",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:write"
      }
    },
    "/api/retail/v1/event-tickets/{ticket_id}/artifacts": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Ticket Artifacts",
        "description": "List branded PDF or wallet artifact metadata for one credential-scoped ticket; provider secrets and raw payloads are excluded.",
        "operationId": "listEventTicketArtifacts",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Ticket Artifacts response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-tickets/{ticket_id}/artifacts"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-ticket-artifacts",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:read"
      }
    },
    "/api/retail/v1/event-ticket-artifacts/{ticket_artifact_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Ticket Artifact",
        "description": "Read one branded ticket artifact projection without provider credentials or private state.",
        "operationId": "getEventTicketArtifact",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_artifact_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket artifact id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Ticket Artifact response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-artifacts/{ticket_artifact_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-ticket-artifact",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:read"
      }
    },
    "/api/retail/v1/event-venue-layouts": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Venue Layouts",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventVenueLayouts",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Venue Layouts response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-venue-layouts"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-venue-layouts",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Venue Layout",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "createEventVenueLayout",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "venue_id": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "layout_kind": {
                    "type": "string"
                  },
                  "canvas_width": {
                    "type": "integer"
                  },
                  "canvas_height": {
                    "type": "integer"
                  }
                },
                "required": [
                  "venue_id",
                  "code",
                  "name",
                  "layout_kind",
                  "canvas_width",
                  "canvas_height"
                ],
                "additionalProperties": false
              },
              "example": {
                "venue_id": "10000000-0000-4000-8000-000000000041",
                "code": "main-hall",
                "name": "Main hall",
                "layout_kind": "reserved_seating",
                "canvas_width": 1600,
                "canvas_height": 900
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Venue Layout response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venue-layouts"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-venue-layout",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-venue-layouts/{layout_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Venue Layout",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventVenueLayout",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "layout_id",
            "in": "path",
            "required": true,
            "description": "Opaque layout id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Venue Layout response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venue-layouts/{layout_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-venue-layout",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Venue Layout",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventVenueLayout",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "layout_id",
            "in": "path",
            "required": true,
            "description": "Opaque layout id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "name"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "name": "Main conference hall"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Venue Layout response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venue-layouts/{layout_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-venue-layout",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Venue Layout",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventVenueLayout",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "layout_id",
            "in": "path",
            "required": true,
            "description": "Opaque layout id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Venue Layout response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venue-layouts/{layout_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-venue-layout",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-venue-layouts/{layout_id}/publish": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Publish Event Venue Layout",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "publishEventVenueLayout",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "layout_id",
            "in": "path",
            "required": true,
            "description": "Opaque layout id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Publish Event Venue Layout response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venue-layouts/{layout_id}/publish"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_publish-event-venue-layout",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-venue-layouts/{layout_id}/sections": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Seating Sections",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventSeatingSections",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "layout_id",
            "in": "path",
            "required": true,
            "description": "Opaque layout id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Seating Sections response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-venue-layouts/{layout_id}/sections"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-seating-sections",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Seating Section",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "createEventSeatingSection",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "layout_id",
            "in": "path",
            "required": true,
            "description": "Opaque layout id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "color": {
                    "type": "string"
                  },
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "code",
                  "name",
                  "color",
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "code": "floor-a",
                "name": "Floor A",
                "color": "#3346d3",
                "sort_order": 10
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Seating Section response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venue-layouts/{layout_id}/sections"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-seating-section",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seating-sections/{section_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Seating Section",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventSeatingSection",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "section_id",
            "in": "path",
            "required": true,
            "description": "Opaque section id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Seating Section response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-sections/{section_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-seating-section",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Seating Section",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventSeatingSection",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "section_id",
            "in": "path",
            "required": true,
            "description": "Opaque section id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "name"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "name": "Floor section A"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Seating Section response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-sections/{section_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-seating-section",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Seating Section",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventSeatingSection",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "section_id",
            "in": "path",
            "required": true,
            "description": "Opaque section id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Seating Section response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-sections/{section_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-seating-section",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seating-sections/{section_id}/rows": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Seating Rows",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventSeatingRows",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "section_id",
            "in": "path",
            "required": true,
            "description": "Opaque section id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Seating Rows response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-seating-sections/{section_id}/rows"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-seating-rows",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Seating Row With Seats",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "createEventSeatingRowWithSeats",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "section_id",
            "in": "path",
            "required": true,
            "description": "Opaque section id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "seat_count": {
                    "type": "integer"
                  },
                  "first_seat_number": {
                    "type": "integer"
                  },
                  "origin_x": {
                    "type": "integer"
                  },
                  "origin_y": {
                    "type": "integer"
                  },
                  "seat_spacing": {
                    "type": "integer"
                  }
                },
                "required": [
                  "code",
                  "label",
                  "seat_count",
                  "first_seat_number",
                  "origin_x",
                  "origin_y",
                  "seat_spacing"
                ],
                "additionalProperties": false
              },
              "example": {
                "code": "A",
                "label": "Row A",
                "seat_count": 20,
                "first_seat_number": 1,
                "origin_x": 100,
                "origin_y": 100,
                "seat_spacing": 36
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Seating Row With Seats response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-sections/{section_id}/rows"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-seating-row-with-seats",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seating-rows/{row_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Seating Row",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventSeatingRow",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "row_id",
            "in": "path",
            "required": true,
            "description": "Opaque row id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Seating Row response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-rows/{row_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-seating-row",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Seating Row",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventSeatingRow",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "row_id",
            "in": "path",
            "required": true,
            "description": "Opaque row id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "label": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "label"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "label": "Row A"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Seating Row response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-rows/{row_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-seating-row",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Seating Row",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventSeatingRow",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "row_id",
            "in": "path",
            "required": true,
            "description": "Opaque row id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Seating Row response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-rows/{row_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-seating-row",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seats": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Seats",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventSeats",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Seats response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-seats"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-seats",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      }
    },
    "/api/retail/v1/event-seats/{seat_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Seat",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventSeat",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seat_id",
            "in": "path",
            "required": true,
            "description": "Opaque seat id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Seat response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seats/{seat_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-seat",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Seat",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventSeat",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seat_id",
            "in": "path",
            "required": true,
            "description": "Opaque seat id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  },
                  "accessibility_type": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "status",
                  "accessibility_type"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "status": "active",
                "accessibility_type": "wheelchair"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Seat response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seats/{seat_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-seat",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Seat",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventSeat",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seat_id",
            "in": "path",
            "required": true,
            "description": "Opaque seat id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Seat response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seats/{seat_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-seat",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-venue-layouts/{layout_id}/pricing-zones": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Seating Pricing Zones",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventSeatingPricingZones",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "layout_id",
            "in": "path",
            "required": true,
            "description": "Opaque layout id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Seating Pricing Zones response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-venue-layouts/{layout_id}/pricing-zones"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-seating-pricing-zones",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Seating Pricing Zone",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "createEventSeatingPricingZone",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "layout_id",
            "in": "path",
            "required": true,
            "description": "Opaque layout id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "color": {
                    "type": "string"
                  },
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "code",
                  "name",
                  "color",
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "code": "premium",
                "name": "Premium",
                "color": "#f97316",
                "sort_order": 10
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Seating Pricing Zone response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-venue-layouts/{layout_id}/pricing-zones"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-seating-pricing-zone",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seating-pricing-zones/{pricing_zone_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Seating Pricing Zone",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventSeatingPricingZone",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "pricing_zone_id",
            "in": "path",
            "required": true,
            "description": "Opaque pricing zone id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Seating Pricing Zone response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-pricing-zones/{pricing_zone_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-seating-pricing-zone",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Seating Pricing Zone",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventSeatingPricingZone",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "pricing_zone_id",
            "in": "path",
            "required": true,
            "description": "Opaque pricing zone id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "name"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "name": "Premium floor"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Seating Pricing Zone response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-pricing-zones/{pricing_zone_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-seating-pricing-zone",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Seating Pricing Zone",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventSeatingPricingZone",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "pricing_zone_id",
            "in": "path",
            "required": true,
            "description": "Opaque pricing zone id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Seating Pricing Zone response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-pricing-zones/{pricing_zone_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-seating-pricing-zone",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seating-pricing-zones/{pricing_zone_id}/seats": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Seating Pricing Zone Seats",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventSeatingPricingZoneSeats",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "pricing_zone_id",
            "in": "path",
            "required": true,
            "description": "Opaque pricing zone id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Seating Pricing Zone Seats response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-seating-pricing-zones/{pricing_zone_id}/seats"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-seating-pricing-zone-seats",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      }
    },
    "/api/retail/v1/event-seating-pricing-zones/{pricing_zone_id}/assign-seats": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Assign Event Seats To Pricing Zone",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "assignEventSeatsToPricingZone",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "pricing_zone_id",
            "in": "path",
            "required": true,
            "description": "Opaque pricing zone id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "seat_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "seat_ids"
                ],
                "additionalProperties": false
              },
              "example": {
                "seat_ids": [
                  "10000000-0000-4000-8000-000000000042"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Assign Event Seats To Pricing Zone response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-pricing-zones/{pricing_zone_id}/assign-seats"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_assign-event-seats-to-pricing-zone",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seating-configurations": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Seating Configurations",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventSeatingConfigurations",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Seating Configurations response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-seating-configurations"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-seating-configurations",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Seating Configuration",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "createEventSeatingConfiguration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "offering_id": {
                    "type": "string"
                  },
                  "occurrence_id": {
                    "type": "string"
                  },
                  "layout_id": {
                    "type": "string"
                  },
                  "selection_mode": {
                    "type": "string"
                  },
                  "hold_duration_seconds": {
                    "type": "integer"
                  }
                },
                "required": [
                  "offering_id",
                  "occurrence_id",
                  "layout_id",
                  "selection_mode",
                  "hold_duration_seconds"
                ],
                "additionalProperties": false
              },
              "example": {
                "offering_id": "10000000-0000-4000-8000-000000000001",
                "occurrence_id": "10000000-0000-4000-8000-000000000002",
                "layout_id": "10000000-0000-4000-8000-000000000043",
                "selection_mode": "customer_selects",
                "hold_duration_seconds": 600
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Seating Configuration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-configurations"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-seating-configuration",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seating-configurations/{seating_config_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Seating Configuration",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventSeatingConfiguration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Seating Configuration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-configurations/{seating_config_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-seating-configuration",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Seating Configuration",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventSeatingConfiguration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "status"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "status": "on_sale"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Seating Configuration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-configurations/{seating_config_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-seating-configuration",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Seating Configuration",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventSeatingConfiguration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Seating Configuration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-configurations/{seating_config_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-seating-configuration",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seating-configurations/{seating_config_id}/seat-map": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Physical Seat Map",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventPhysicalSeatMap",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Physical Seat Map response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-configurations/{seating_config_id}/seat-map"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-physical-seat-map",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      }
    },
    "/api/retail/v1/event-seating-configurations/{seating_config_id}/zone-rules": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Ticket Seating Zone Rules",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventTicketSeatingZoneRules",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Ticket Seating Zone Rules response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-seating-configurations/{seating_config_id}/zone-rules"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-ticket-seating-zone-rules",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create Event Ticket Seating Zone Rule",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "createEventTicketSeatingZoneRule",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "pricing_zone_id": {
                    "type": "string"
                  },
                  "price_adjustment": {
                    "type": "integer"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  }
                },
                "required": [
                  "ticket_option_id",
                  "pricing_zone_id",
                  "price_adjustment",
                  "currency",
                  "status"
                ],
                "additionalProperties": false
              },
              "example": {
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "pricing_zone_id": "10000000-0000-4000-8000-000000000044",
                "price_adjustment": 50,
                "currency": "USD",
                "status": "active"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create Event Ticket Seating Zone Rule response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-configurations/{seating_config_id}/zone-rules"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_create-event-ticket-seating-zone-rule",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-ticket-seating-zone-rules/{zone_rule_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Ticket Seating Zone Rule",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventTicketSeatingZoneRule",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "zone_rule_id",
            "in": "path",
            "required": true,
            "description": "Opaque zone rule id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Ticket Seating Zone Rule response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-seating-zone-rules/{zone_rule_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-ticket-seating-zone-rule",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update Event Ticket Seating Zone Rule",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "updateEventTicketSeatingZoneRule",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "zone_rule_id",
            "in": "path",
            "required": true,
            "description": "Opaque zone rule id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "price_adjustment": {
                    "type": "integer"
                  }
                },
                "required": [
                  "version",
                  "price_adjustment"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "price_adjustment": 40
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update Event Ticket Seating Zone Rule response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-seating-zone-rules/{zone_rule_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_update-event-ticket-seating-zone-rule",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive Event Ticket Seating Zone Rule",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "archiveEventTicketSeatingZoneRule",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "zone_rule_id",
            "in": "path",
            "required": true,
            "description": "Opaque zone rule id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive Event Ticket Seating Zone Rule response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-ticket-seating-zone-rules/{zone_rule_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_archive-event-ticket-seating-zone-rule",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-seating-configurations/{seating_config_id}/holds": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Seat Holds",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventSeatHolds",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Seat Holds response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-seating-configurations/{seating_config_id}/holds"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-seat-holds",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Hold Event Physical Seats",
        "description": "Atomically hold up to 250 same-tenant seats with a caller-supplied SHA-256 holder digest and gateway idempotency. Never send a raw cart or session secret.",
        "operationId": "holdEventPhysicalSeats",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "seat_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "holder_key_hash": {
                    "type": "string"
                  },
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "client_reference": {
                    "type": "string"
                  }
                },
                "required": [
                  "seat_ids",
                  "holder_key_hash",
                  "ticket_option_id",
                  "client_reference"
                ],
                "additionalProperties": false
              },
              "example": {
                "seat_ids": [
                  "10000000-0000-4000-8000-000000000042"
                ],
                "holder_key_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "client_reference": "synthetic-cart-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Hold Event Physical Seats response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-configurations/{seating_config_id}/holds"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_hold-event-physical-seats",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-seat-holds/{seat_hold_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Seat Hold",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventSeatHold",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seat_hold_id",
            "in": "path",
            "required": true,
            "description": "Opaque seat hold id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Seat Hold response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seat-holds/{seat_hold_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-seat-hold",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      }
    },
    "/api/retail/v1/event-seating-configurations/{seating_config_id}/hold-groups/{hold_group_id}/release": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Release Event Physical Seat Holds",
        "description": "Release one hold group only when the supplied holder digest matches.",
        "operationId": "releaseEventPhysicalSeatHolds",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "hold_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque hold group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "holder_key_hash": {
                    "type": "string"
                  },
                  "reason": {
                    "type": "string"
                  }
                },
                "required": [
                  "holder_key_hash",
                  "reason"
                ],
                "additionalProperties": false
              },
              "example": {
                "holder_key_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "reason": "Synthetic cart abandoned"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Release Event Physical Seat Holds response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-configurations/{seating_config_id}/hold-groups/{hold_group_id}/release"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_release-event-physical-seat-holds",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-seating-configurations/{seating_config_id}/hold-groups/{hold_group_id}/confirm": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Confirm Event Physical Seat Holds",
        "description": "Atomically convert a hold group into registration and ticket seat assignments; the lifecycle ledger and inventory events remain server-owned.",
        "operationId": "confirmEventPhysicalSeatHolds",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seating_config_id",
            "in": "path",
            "required": true,
            "description": "Opaque seating config id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "hold_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque hold group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "registration_id": {
                    "type": "string"
                  },
                  "seat_ticket_map": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "seat_id": {
                          "type": "string"
                        },
                        "ticket_id": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "seat_id",
                        "ticket_id"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "assignment_source": {
                    "type": "string"
                  }
                },
                "required": [
                  "registration_id",
                  "seat_ticket_map",
                  "assignment_source"
                ],
                "additionalProperties": false
              },
              "example": {
                "registration_id": "10000000-0000-4000-8000-000000000010",
                "seat_ticket_map": [
                  {
                    "seat_id": "10000000-0000-4000-8000-000000000042",
                    "ticket_id": "10000000-0000-4000-8000-000000000011"
                  }
                ],
                "assignment_source": "purchase"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Confirm Event Physical Seat Holds response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seating-configurations/{seating_config_id}/hold-groups/{hold_group_id}/confirm"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_confirm-event-physical-seat-holds",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-seat-assignments": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Seat Assignments",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventSeatAssignments",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Seat Assignments response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-seat-assignments"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-seat-assignments",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      }
    },
    "/api/retail/v1/event-seat-assignments/{seat_assignment_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Seat Assignment",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventSeatAssignment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seat_assignment_id",
            "in": "path",
            "required": true,
            "description": "Opaque seat assignment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Seat Assignment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seat-assignments/{seat_assignment_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-seat-assignment",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      }
    },
    "/api/retail/v1/event-seat-inventory-events": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List Event Seat Inventory Events",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "listEventSeatInventoryEvents",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List Event Seat Inventory Events response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourcePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000099",
                      "object": "event_platform_resource",
                      "status": "synthetic",
                      "resource_path": "/event-seat-inventory-events"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_list-event-seat-inventory-events",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      }
    },
    "/api/retail/v1/event-seat-inventory-events/{seat_inventory_event_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get Event Seat Inventory Event",
        "description": "Use this tenant-bound Events platform resource through its documented least-privilege scope, version rules, and branded API path.",
        "operationId": "getEventSeatInventoryEvent",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "seat_inventory_event_id",
            "in": "path",
            "required": true,
            "description": "Opaque seat inventory event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get Event Seat Inventory Event response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPlatformResourceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000099",
                    "object": "event_platform_resource",
                    "status": "synthetic",
                    "resource_path": "/event-seat-inventory-events/{seat_inventory_event_id}"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_get-event-seat-inventory-event",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      }
    },
    "/api/retail/v1/event-ticket-products": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event-ticket products",
        "description": "List active, nondeleted catalog products whose immutable product type is event_ticket. The opaque cursor preserves deterministic created-at and ID ordering.",
        "operationId": "listEventTicketProducts",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event-ticket products response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketProductPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "20000000-0000-4000-8000-000000000001",
                      "object": "event_ticket_product",
                      "name": "Robotics camp — full day",
                      "sku": "DEMO-CAMP-FULL",
                      "barcode": null,
                      "brand_id": null,
                      "product_type": "event_ticket",
                      "description": "Synthetic full-day camp admission product.",
                      "online_description": "<p>Morning, supervised lunch bridge, and afternoon camp admission.</p>",
                      "retail_price": 595,
                      "recommended_retail_price": null,
                      "track_inventory": false,
                      "has_serial_numbers": false,
                      "is_active": true,
                      "sell_pos": true,
                      "sell_online": true,
                      "publish_status": "published",
                      "online_backorder_policy": {
                        "mode": "inherit",
                        "max_backorder_quantity": null,
                        "eta_days": null,
                        "customer_message": null
                      },
                      "channel_status": null,
                      "sold_status": null,
                      "dimensions": {
                        "length": null,
                        "width": null,
                        "height": null,
                        "unit": null,
                        "weight": null,
                        "weight_unit": null
                      },
                      "seo": {
                        "slug": "robotics-camp-full-day",
                        "title": "Robotics camp — full day",
                        "description": "Synthetic event-ticket product for documentation."
                      },
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "fulfillment_medium": "digital"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_products",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "has_more": false,
                    "limit": 50,
                    "next_cursor": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "catalog:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event-ticket product",
        "description": "Create the constrained catalog product used by event ticket options. This operation requires both catalog:write and events:write and server-forces digital fulfillment, no inventory tracking, no serial numbers, and product_type event_ticket. Event-ticket products remain directly POS-sellable; sell_pos defaults to true and may be managed through the allowlist.",
        "operationId": "createEventTicketProduct",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "sku": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "online_description": {
                    "type": "string"
                  },
                  "retail_price": {
                    "type": "integer"
                  },
                  "is_active": {
                    "type": "boolean"
                  },
                  "sell_pos": {
                    "type": "boolean"
                  },
                  "sell_online": {
                    "type": "boolean"
                  },
                  "publish_status": {
                    "type": "string"
                  },
                  "seo_slug": {
                    "type": "string"
                  },
                  "seo_title": {
                    "type": "string"
                  },
                  "seo_description": {
                    "type": "string"
                  },
                  "product_type": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "sku",
                  "description",
                  "online_description",
                  "retail_price",
                  "is_active",
                  "sell_pos",
                  "sell_online",
                  "publish_status",
                  "seo_slug",
                  "seo_title",
                  "seo_description",
                  "product_type"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Robotics camp — full day",
                "sku": "DEMO-CAMP-FULL",
                "description": "Synthetic full-day camp admission product.",
                "online_description": "<p>Morning, supervised lunch bridge, and afternoon camp admission.</p>",
                "retail_price": 595,
                "is_active": true,
                "sell_pos": true,
                "sell_online": true,
                "publish_status": "published",
                "seo_slug": "robotics-camp-full-day",
                "seo_title": "Robotics camp — full day",
                "seo_description": "Synthetic event-ticket product for documentation.",
                "product_type": "event_ticket"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event-ticket product response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketProductEnvelope"
                },
                "example": {
                  "data": {
                    "id": "20000000-0000-4000-8000-000000000001",
                    "object": "event_ticket_product",
                    "name": "Robotics camp — full day",
                    "sku": "DEMO-CAMP-FULL",
                    "barcode": null,
                    "brand_id": null,
                    "product_type": "event_ticket",
                    "description": "Synthetic full-day camp admission product.",
                    "online_description": "<p>Morning, supervised lunch bridge, and afternoon camp admission.</p>",
                    "retail_price": 595,
                    "recommended_retail_price": null,
                    "track_inventory": false,
                    "has_serial_numbers": false,
                    "is_active": true,
                    "sell_pos": true,
                    "sell_online": true,
                    "publish_status": "published",
                    "online_backorder_policy": {
                      "mode": "inherit",
                      "max_backorder_quantity": null,
                      "eta_days": null,
                      "customer_message": null
                    },
                    "channel_status": null,
                    "sold_status": null,
                    "dimensions": {
                      "length": null,
                      "width": null,
                      "height": null,
                      "unit": null,
                      "weight": null,
                      "weight_unit": null
                    },
                    "seo": {
                      "slug": "robotics-camp-full-day",
                      "title": "Robotics camp — full day",
                      "description": "Synthetic event-ticket product for documentation."
                    },
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "fulfillment_medium": "digital"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_product_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "catalog:write",
        "x-additional-required-scopes": [
          "events:write"
        ]
      }
    },
    "/api/retail/v1/event-ticket-products/{product_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event-ticket product",
        "description": "Get an event-ticket product",
        "operationId": "getEventTicketProduct",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "product_id",
            "in": "path",
            "required": true,
            "description": "Opaque product id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event-ticket product response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketProductEnvelope"
                },
                "example": {
                  "data": {
                    "id": "20000000-0000-4000-8000-000000000001",
                    "object": "event_ticket_product",
                    "name": "Robotics camp — full day",
                    "sku": "DEMO-CAMP-FULL",
                    "barcode": null,
                    "brand_id": null,
                    "product_type": "event_ticket",
                    "description": "Synthetic full-day camp admission product.",
                    "online_description": "<p>Morning, supervised lunch bridge, and afternoon camp admission.</p>",
                    "retail_price": 595,
                    "recommended_retail_price": null,
                    "track_inventory": false,
                    "has_serial_numbers": false,
                    "is_active": true,
                    "sell_pos": true,
                    "sell_online": true,
                    "publish_status": "published",
                    "online_backorder_policy": {
                      "mode": "inherit",
                      "max_backorder_quantity": null,
                      "eta_days": null,
                      "customer_message": null
                    },
                    "channel_status": null,
                    "sold_status": null,
                    "dimensions": {
                      "length": null,
                      "width": null,
                      "height": null,
                      "unit": null,
                      "weight": null,
                      "weight_unit": null
                    },
                    "seo": {
                      "slug": "robotics-camp-full-day",
                      "title": "Robotics camp — full day",
                      "description": "Synthetic event-ticket product for documentation."
                    },
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "fulfillment_medium": "digital"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_product",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "catalog:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event-ticket product",
        "description": "Update only the event-ticket product allowlist. This operation requires both catalog:write and events:write; direct POS selling remains supported through sell_pos, while product_type and server-enforced digital, inventory, and serial invariants cannot be changed.",
        "operationId": "updateEventTicketProduct",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "product_id",
            "in": "path",
            "required": true,
            "description": "Opaque product id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "retail_price": {
                    "type": "integer"
                  },
                  "sell_pos": {
                    "type": "boolean"
                  },
                  "sell_online": {
                    "type": "boolean"
                  },
                  "publish_status": {
                    "type": "string"
                  },
                  "seo_slug": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "retail_price",
                  "sell_pos",
                  "sell_online",
                  "publish_status",
                  "seo_slug"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Robotics camp — full day",
                "retail_price": 625,
                "sell_pos": true,
                "sell_online": true,
                "publish_status": "published",
                "seo_slug": "robotics-camp-full-day"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event-ticket product response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketProductEnvelope"
                },
                "example": {
                  "data": {
                    "id": "20000000-0000-4000-8000-000000000001",
                    "object": "event_ticket_product",
                    "name": "Robotics camp — full day",
                    "sku": "DEMO-CAMP-FULL",
                    "barcode": null,
                    "brand_id": null,
                    "product_type": "event_ticket",
                    "description": "Synthetic full-day camp admission product.",
                    "online_description": "<p>Morning, supervised lunch bridge, and afternoon camp admission.</p>",
                    "retail_price": 625,
                    "recommended_retail_price": null,
                    "track_inventory": false,
                    "has_serial_numbers": false,
                    "is_active": true,
                    "sell_pos": true,
                    "sell_online": true,
                    "publish_status": "published",
                    "online_backorder_policy": {
                      "mode": "inherit",
                      "max_backorder_quantity": null,
                      "eta_days": null,
                      "customer_message": null
                    },
                    "channel_status": null,
                    "sold_status": null,
                    "dimensions": {
                      "length": null,
                      "width": null,
                      "height": null,
                      "unit": null,
                      "weight": null,
                      "weight_unit": null
                    },
                    "seo": {
                      "slug": "robotics-camp-full-day",
                      "title": "Robotics camp — full day",
                      "description": "Synthetic event-ticket product for documentation."
                    },
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-26T04:20:00Z",
                    "fulfillment_medium": "digital"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_product_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "catalog:write",
        "x-additional-required-scopes": [
          "events:write"
        ]
      }
    },
    "/api/retail/v1/events": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event offerings",
        "description": "List event offerings",
        "operationId": "listEvents",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event offerings response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOfferingPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000001",
                      "object": "event_offering",
                      "slug": "robotics-discovery-camp",
                      "name": "Robotics Discovery Camp",
                      "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
                      "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
                      "event_kind": "camp",
                      "delivery_format": "in_person",
                      "status": "published",
                      "visibility": "public",
                      "timezone": "America/New_York",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "online_meeting_url": null,
                      "support_email": "events@example.test",
                      "support_phone": "+1-555-010-0100",
                      "registration_opens_at": "2026-08-25T13:00:00Z",
                      "registration_closes_at": "2026-09-13T23:59:00Z",
                      "minimum_age_months": 96,
                      "maximum_age_months": 156,
                      "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
                      "image_alt_text": "Synthetic robotics camp work table",
                      "theme": {
                        "primary_color": "#3346d3",
                        "accent_color": "#f97316",
                        "card_style": "image"
                      },
                      "portal_settings": {
                        "show_schedule": true,
                        "show_tickets": true,
                        "show_calendar_download": true
                      },
                      "metadata": {
                        "reporting_program": "STEM camp"
                      },
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 3,
                      "published_at": "2026-08-25T15:00:00Z",
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_offerings",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event offering",
        "description": "Create an event offering",
        "operationId": "createEvent",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "short_description": {
                    "type": "string"
                  },
                  "description_html": {
                    "type": "string"
                  },
                  "event_kind": {
                    "type": "string"
                  },
                  "delivery_format": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "visibility": {
                    "type": "string"
                  },
                  "timezone": {
                    "type": "string"
                  },
                  "venue_name": {
                    "type": "string"
                  },
                  "location_details": {
                    "type": "object",
                    "properties": {
                      "address": {
                        "type": "string"
                      },
                      "city": {
                        "type": "string"
                      },
                      "region": {
                        "type": "string"
                      },
                      "postal_code": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "address",
                      "city",
                      "region",
                      "postal_code"
                    ],
                    "additionalProperties": false
                  },
                  "registration_opens_at": {
                    "type": "string"
                  },
                  "registration_closes_at": {
                    "type": "string"
                  },
                  "minimum_age_months": {
                    "type": "integer"
                  },
                  "maximum_age_months": {
                    "type": "integer"
                  },
                  "primary_image_url": {
                    "type": "string"
                  },
                  "image_alt_text": {
                    "type": "string"
                  },
                  "theme": {
                    "type": "object",
                    "properties": {
                      "primary_color": {
                        "type": "string"
                      },
                      "accent_color": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "primary_color",
                      "accent_color"
                    ],
                    "additionalProperties": false
                  },
                  "portal_settings": {
                    "type": "object",
                    "properties": {
                      "show_schedule": {
                        "type": "boolean"
                      },
                      "show_tickets": {
                        "type": "boolean"
                      },
                      "show_calendar_download": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "show_schedule",
                      "show_tickets",
                      "show_calendar_download"
                    ],
                    "additionalProperties": false
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "slug",
                  "name",
                  "short_description",
                  "description_html",
                  "event_kind",
                  "delivery_format",
                  "status",
                  "visibility",
                  "timezone",
                  "venue_name",
                  "location_details",
                  "registration_opens_at",
                  "registration_closes_at",
                  "minimum_age_months",
                  "maximum_age_months",
                  "primary_image_url",
                  "image_alt_text",
                  "theme",
                  "portal_settings",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "slug": "robotics-discovery-camp",
                "name": "Robotics Discovery Camp",
                "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
                "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
                "event_kind": "camp",
                "delivery_format": "in_person",
                "status": "draft",
                "visibility": "public",
                "timezone": "America/New_York",
                "venue_name": "Northstar Learning Lab",
                "location_details": {
                  "address": "100 Example Avenue",
                  "city": "Sample City",
                  "region": "OH",
                  "postal_code": "43000"
                },
                "registration_opens_at": "2026-08-25T13:00:00Z",
                "registration_closes_at": "2026-09-13T23:59:00Z",
                "minimum_age_months": 96,
                "maximum_age_months": 156,
                "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
                "image_alt_text": "Synthetic robotics camp work table",
                "theme": {
                  "primary_color": "#3346d3",
                  "accent_color": "#f97316"
                },
                "portal_settings": {
                  "show_schedule": true,
                  "show_tickets": true,
                  "show_calendar_download": true
                },
                "source_system": "example_integration",
                "external_id": "offering-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event offering response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOfferingEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000001",
                    "object": "event_offering",
                    "slug": "robotics-discovery-camp",
                    "name": "Robotics Discovery Camp",
                    "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
                    "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
                    "event_kind": "camp",
                    "delivery_format": "in_person",
                    "status": "published",
                    "visibility": "public",
                    "timezone": "America/New_York",
                    "venue_name": "Northstar Learning Lab",
                    "location_details": {
                      "address": "100 Example Avenue",
                      "city": "Sample City",
                      "region": "OH",
                      "postal_code": "43000"
                    },
                    "online_meeting_url": null,
                    "support_email": "events@example.test",
                    "support_phone": "+1-555-010-0100",
                    "registration_opens_at": "2026-08-25T13:00:00Z",
                    "registration_closes_at": "2026-09-13T23:59:00Z",
                    "minimum_age_months": 96,
                    "maximum_age_months": 156,
                    "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
                    "image_alt_text": "Synthetic robotics camp work table",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image"
                    },
                    "portal_settings": {
                      "show_schedule": true,
                      "show_tickets": true,
                      "show_calendar_download": true
                    },
                    "metadata": {
                      "reporting_program": "STEM camp"
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 3,
                    "published_at": "2026-08-25T15:00:00Z",
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_offering_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event offering",
        "description": "Retrieve the offering and its occurrence, ticket-option, capacity-pool, asset, and publication-feed relationships.",
        "operationId": "getEvent",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event offering response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOfferingEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000001",
                    "object": "event_offering",
                    "slug": "robotics-discovery-camp",
                    "name": "Robotics Discovery Camp",
                    "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
                    "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
                    "event_kind": "camp",
                    "delivery_format": "in_person",
                    "status": "published",
                    "visibility": "public",
                    "timezone": "America/New_York",
                    "venue_name": "Northstar Learning Lab",
                    "location_details": {
                      "address": "100 Example Avenue",
                      "city": "Sample City",
                      "region": "OH",
                      "postal_code": "43000"
                    },
                    "online_meeting_url": null,
                    "support_email": "events@example.test",
                    "support_phone": "+1-555-010-0100",
                    "registration_opens_at": "2026-08-25T13:00:00Z",
                    "registration_closes_at": "2026-09-13T23:59:00Z",
                    "minimum_age_months": 96,
                    "maximum_age_months": 156,
                    "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
                    "image_alt_text": "Synthetic robotics camp work table",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image"
                    },
                    "portal_settings": {
                      "show_schedule": true,
                      "show_tickets": true,
                      "show_calendar_download": true
                    },
                    "metadata": {
                      "reporting_program": "STEM camp"
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 3,
                    "published_at": "2026-08-25T15:00:00Z",
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "occurrences": {
                        "count": 3,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/occurrences"
                      },
                      "ticket_options": {
                        "count": 1,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/ticket-options"
                      },
                      "capacity_pools": {
                        "count": 2,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/capacity-pools"
                      },
                      "assets": {
                        "count": 1,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/assets"
                      },
                      "publication_feeds": {
                        "count": 1,
                        "collection": null,
                        "note": "Use each publication feed's cursor-paged offerings collection."
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_offering",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event offering",
        "description": "Update an event offering",
        "operationId": "updateEvent",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  },
                  "short_description": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "status",
                  "short_description"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 3,
                "status": "published",
                "short_description": "Updated synthetic camp summary."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event offering response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOfferingEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000001",
                    "object": "event_offering",
                    "slug": "robotics-discovery-camp",
                    "name": "Robotics Discovery Camp",
                    "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
                    "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
                    "event_kind": "camp",
                    "delivery_format": "in_person",
                    "status": "published",
                    "visibility": "public",
                    "timezone": "America/New_York",
                    "venue_name": "Northstar Learning Lab",
                    "location_details": {
                      "address": "100 Example Avenue",
                      "city": "Sample City",
                      "region": "OH",
                      "postal_code": "43000"
                    },
                    "online_meeting_url": null,
                    "support_email": "events@example.test",
                    "support_phone": "+1-555-010-0100",
                    "registration_opens_at": "2026-08-25T13:00:00Z",
                    "registration_closes_at": "2026-09-13T23:59:00Z",
                    "minimum_age_months": 96,
                    "maximum_age_months": 156,
                    "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
                    "image_alt_text": "Synthetic robotics camp work table",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image"
                    },
                    "portal_settings": {
                      "show_schedule": true,
                      "show_tickets": true,
                      "show_calendar_download": true
                    },
                    "metadata": {
                      "reporting_program": "STEM camp"
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 3,
                    "published_at": "2026-08-25T15:00:00Z",
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "occurrences": {
                        "count": 3,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/occurrences"
                      },
                      "ticket_options": {
                        "count": 1,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/ticket-options"
                      },
                      "capacity_pools": {
                        "count": 2,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/capacity-pools"
                      },
                      "assets": {
                        "count": 1,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/assets"
                      },
                      "publication_feeds": {
                        "count": 1,
                        "collection": null,
                        "note": "Use each publication feed's cursor-paged offerings collection."
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_offering_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event offering",
        "description": "Archive an event offering",
        "operationId": "archiveEvent",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event offering response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOfferingEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000001",
                    "object": "event_offering",
                    "slug": "robotics-discovery-camp",
                    "name": "Robotics Discovery Camp",
                    "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
                    "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
                    "event_kind": "camp",
                    "delivery_format": "in_person",
                    "status": "archived",
                    "visibility": "public",
                    "timezone": "America/New_York",
                    "venue_name": "Northstar Learning Lab",
                    "location_details": {
                      "address": "100 Example Avenue",
                      "city": "Sample City",
                      "region": "OH",
                      "postal_code": "43000"
                    },
                    "online_meeting_url": null,
                    "support_email": "events@example.test",
                    "support_phone": "+1-555-010-0100",
                    "registration_opens_at": "2026-08-25T13:00:00Z",
                    "registration_closes_at": "2026-09-13T23:59:00Z",
                    "minimum_age_months": 96,
                    "maximum_age_months": 156,
                    "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
                    "image_alt_text": "Synthetic robotics camp work table",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image"
                    },
                    "portal_settings": {
                      "show_schedule": true,
                      "show_tickets": true,
                      "show_calendar_download": true
                    },
                    "metadata": {
                      "reporting_program": "STEM camp"
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 3,
                    "published_at": "2026-08-25T15:00:00Z",
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "occurrences": {
                        "count": 3,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/occurrences"
                      },
                      "ticket_options": {
                        "count": 1,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/ticket-options"
                      },
                      "capacity_pools": {
                        "count": 2,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/capacity-pools"
                      },
                      "assets": {
                        "count": 1,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/assets"
                      },
                      "publication_feeds": {
                        "count": 1,
                        "collection": null,
                        "note": "Use each publication feed's cursor-paged offerings collection."
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_offering_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/report": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event offering report",
        "description": "Return privacy-safe financial, add-on, participant, attendance, lifecycle, capacity, session, track, stakeholder, and allowlisted standard-answer slices. Both reports:read and events:registrations:read are required, and the response is bounded to 2 MiB.",
        "operationId": "getEventReport",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event offering report response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOfferingReportEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_offering_report",
                    "generated_at": "2026-08-25T15:00:00Z",
                    "tenant_id": "40000000-0000-4000-8000-000000000001",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_options": [
                      {
                        "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                        "label": "Full day",
                        "registrations": 18,
                        "seats": 18,
                        "gross": 10710,
                        "cancelled": 1,
                        "refunded": 0
                      }
                    ],
                    "participant_repeat": [
                      {
                        "segment": "first_time",
                        "participants": 12
                      },
                      {
                        "segment": "repeat",
                        "participants": 6
                      }
                    ],
                    "age_bands": [
                      {
                        "band": "9_12",
                        "participants": 15
                      },
                      {
                        "band": "13_17",
                        "participants": 3
                      }
                    ],
                    "attendance": [
                      {
                        "segment": "attended",
                        "registrations": 16
                      },
                      {
                        "segment": "no_show",
                        "registrations": 1
                      },
                      {
                        "segment": "upcoming_or_pending",
                        "registrations": 1
                      }
                    ],
                    "registration_lifecycle": [
                      {
                        "status": "confirmed",
                        "registrations": 17
                      },
                      {
                        "status": "cancelled",
                        "registrations": 1
                      }
                    ],
                    "waitlist": [
                      {
                        "status": "waiting",
                        "entries": 3,
                        "requested_seats": 3
                      }
                    ],
                    "capacity": [
                      {
                        "pool_id": "10000000-0000-4000-8000-000000000005",
                        "name": "Morning camper seats",
                        "capacity": 24,
                        "overbook_allowance": 0,
                        "booked_units": 18,
                        "utilization_percent": 75
                      }
                    ],
                    "addons": [
                      {
                        "product_id": "20000000-0000-4000-8000-000000000002",
                        "product_name": "Camp T-shirt",
                        "variant_id": "20000000-0000-4000-8000-000000000003",
                        "variant_name": "Youth M",
                        "assigned_units": 12,
                        "returned_units": 1,
                        "gross_revenue": 240,
                        "net_revenue": 220
                      }
                    ],
                    "sessions": [
                      {
                        "occurrence_id": "10000000-0000-4000-8000-000000000002",
                        "name": "Morning camp",
                        "instance_id": "10000000-0000-4000-8000-000000000029",
                        "starts_at": "2026-09-14T13:00:00Z",
                        "selected": 18,
                        "attended": 16
                      }
                    ],
                    "tracks": [
                      {
                        "track_id": "10000000-0000-4000-8000-000000000031",
                        "name": "Robotics",
                        "sessions": 2,
                        "enrollments": 18
                      }
                    ],
                    "stakeholders": [
                      {
                        "role": "instructor",
                        "display_name": "Jordan Example",
                        "occurrence_id": "10000000-0000-4000-8000-000000000002"
                      }
                    ],
                    "reported_answers": [
                      {
                        "report_key": "merchandise.shirt_size",
                        "value": "youth_m",
                        "responses": 8
                      }
                    ],
                    "financial_summary": {
                      "gross_registration_amount": 10710,
                      "receipt_line_gross": 10710,
                      "discount_amount": 0,
                      "refunded_registration_amount": 0,
                      "net_registration_amount": 10710
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_offering_report",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "response_byte_limit": 2097152
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "The event report exceeds its 2 MiB response bound.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "reports:read",
        "x-additional-required-scopes": [
          "events:registrations:read"
        ]
      }
    },
    "/api/retail/v1/events/{event_id}/spaces": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event spaces",
        "description": "List normalized event rooms or venues with optional capacity and safe location details.",
        "operationId": "listEventSpaces",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event spaces response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSpacePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000030",
                      "object": "event_space",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "code": "LAB-A",
                      "name": "Robotics Lab A",
                      "venue_name": "Northstar Learning Lab",
                      "capacity": 24,
                      "location_details": {
                        "floor": "1",
                        "room": "A"
                      },
                      "status": "active",
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_spaces",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event space",
        "description": "Create an event space",
        "operationId": "createEventSpace",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "venue_name": {
                    "type": "string"
                  },
                  "capacity": {
                    "type": "integer"
                  },
                  "location_details": {
                    "type": "object",
                    "properties": {
                      "floor": {
                        "type": "string"
                      },
                      "room": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "floor",
                      "room"
                    ],
                    "additionalProperties": false
                  },
                  "status": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "name",
                  "venue_name",
                  "capacity",
                  "location_details",
                  "status",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "code": "LAB-A",
                "name": "Robotics Lab A",
                "venue_name": "Northstar Learning Lab",
                "capacity": 24,
                "location_details": {
                  "floor": "1",
                  "room": "A"
                },
                "status": "active",
                "source_system": "example_integration",
                "external_id": "space-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event space response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSpaceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000030",
                    "object": "event_space",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "code": "LAB-A",
                    "name": "Robotics Lab A",
                    "venue_name": "Northstar Learning Lab",
                    "capacity": 24,
                    "location_details": {
                      "floor": "1",
                      "room": "A"
                    },
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_space_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-spaces/{space_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event space",
        "description": "Get an event space",
        "operationId": "getEventSpace",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "space_id",
            "in": "path",
            "required": true,
            "description": "Opaque space id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event space response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSpaceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000030",
                    "object": "event_space",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "code": "LAB-A",
                    "name": "Robotics Lab A",
                    "venue_name": "Northstar Learning Lab",
                    "capacity": 24,
                    "location_details": {
                      "floor": "1",
                      "room": "A"
                    },
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_space",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event space",
        "description": "Update an event space",
        "operationId": "updateEventSpace",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "space_id",
            "in": "path",
            "required": true,
            "description": "Opaque space id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "capacity": {
                    "type": "integer"
                  }
                },
                "required": [
                  "name",
                  "capacity"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Robotics Lab A",
                "capacity": 28
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event space response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSpaceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000030",
                    "object": "event_space",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "code": "LAB-A",
                    "name": "Robotics Lab A",
                    "venue_name": "Northstar Learning Lab",
                    "capacity": 28,
                    "location_details": {
                      "floor": "1",
                      "room": "A"
                    },
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_space_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event space",
        "description": "Archive an event space",
        "operationId": "archiveEventSpace",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "space_id",
            "in": "path",
            "required": true,
            "description": "Opaque space id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event space response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSpaceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000030",
                    "object": "event_space",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "code": "LAB-A",
                    "name": "Robotics Lab A",
                    "venue_name": "Northstar Learning Lab",
                    "capacity": 24,
                    "location_details": {
                      "floor": "1",
                      "room": "A"
                    },
                    "status": "archived",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_space_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/tracks": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event tracks",
        "description": "List normalized conference, camp, class, or agenda tracks.",
        "operationId": "listEventTracks",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event tracks response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTrackPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000031",
                      "object": "event_track",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "code": "ROBOTICS",
                      "name": "Robotics",
                      "description": "Synthetic conference and camp robotics sessions.",
                      "color": "#3346d3",
                      "status": "active",
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_tracks",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event track",
        "description": "Create an event track",
        "operationId": "createEventTrack",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "color": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "code",
                  "name",
                  "description",
                  "color",
                  "status",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "code": "ROBOTICS",
                "name": "Robotics",
                "description": "Synthetic conference and camp robotics sessions.",
                "color": "#3346d3",
                "status": "active",
                "source_system": "example_integration",
                "external_id": "track-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event track response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTrackEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000031",
                    "object": "event_track",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "code": "ROBOTICS",
                    "name": "Robotics",
                    "description": "Synthetic conference and camp robotics sessions.",
                    "color": "#3346d3",
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_track_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-tracks/{track_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event track",
        "description": "Get an event track",
        "operationId": "getEventTrack",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "track_id",
            "in": "path",
            "required": true,
            "description": "Opaque track id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event track response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTrackEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000031",
                    "object": "event_track",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "code": "ROBOTICS",
                    "name": "Robotics",
                    "description": "Synthetic conference and camp robotics sessions.",
                    "color": "#3346d3",
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_track",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event track",
        "description": "Update an event track",
        "operationId": "updateEventTrack",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "track_id",
            "in": "path",
            "required": true,
            "description": "Opaque track id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "color": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "color"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Applied robotics",
                "color": "#4455cc"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event track response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTrackEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000031",
                    "object": "event_track",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "code": "ROBOTICS",
                    "name": "Applied robotics",
                    "description": "Synthetic conference and camp robotics sessions.",
                    "color": "#4455cc",
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_track_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event track",
        "description": "Archive an event track",
        "operationId": "archiveEventTrack",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "track_id",
            "in": "path",
            "required": true,
            "description": "Opaque track id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event track response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTrackEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000031",
                    "object": "event_track",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "code": "ROBOTICS",
                    "name": "Robotics",
                    "description": "Synthetic conference and camp robotics sessions.",
                    "color": "#3346d3",
                    "status": "archived",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_track_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-people": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event people",
        "description": "List normalized speakers, instructors, staff, and organizers. customer_id is omitted unless the key also has events:registrations:read.",
        "operationId": "listEventPeople",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event people response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPersonPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000032",
                      "object": "event_person",
                      "display_name": "Jordan Example",
                      "title": "Lead instructor",
                      "bio_html": "<p>Synthetic instructor profile for documentation.</p>",
                      "photo_url": "https://pos.getcentri.com/media/events/synthetic/jordan-example.webp",
                      "status": "active",
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "customer_reference_omitted": true
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_people",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event person",
        "description": "Create a public-facing person profile. Linking it to a customer additionally requires events:registrations:write.",
        "operationId": "createEventPerson",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "display_name": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "bio_html": {
                    "type": "string"
                  },
                  "photo_url": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "display_name",
                  "title",
                  "bio_html",
                  "photo_url",
                  "status",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "display_name": "Jordan Example",
                "title": "Lead instructor",
                "bio_html": "<p>Synthetic instructor profile for documentation.</p>",
                "photo_url": "https://pos.getcentri.com/media/events/synthetic/jordan-example.webp",
                "status": "active",
                "source_system": "example_integration",
                "external_id": "person-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event person response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPersonEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000032",
                    "object": "event_person",
                    "display_name": "Jordan Example",
                    "title": "Lead instructor",
                    "bio_html": "<p>Synthetic instructor profile for documentation.</p>",
                    "photo_url": "https://pos.getcentri.com/media/events/synthetic/jordan-example.webp",
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "customer_reference_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_person_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write",
        "x-conditional-scopes": [
          {
            "scope": "events:registrations:write",
            "when": "The body supplies a customer_id link."
          }
        ]
      }
    },
    "/api/retail/v1/event-people/{person_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event person",
        "description": "Retrieve an event person; customer_reference_omitted signals that the key did not also have events:registrations:read.",
        "operationId": "getEventPerson",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "person_id",
            "in": "path",
            "required": true,
            "description": "Opaque person id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event person response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPersonEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000032",
                    "object": "event_person",
                    "display_name": "Jordan Example",
                    "title": "Lead instructor",
                    "bio_html": "<p>Synthetic instructor profile for documentation.</p>",
                    "photo_url": "https://pos.getcentri.com/media/events/synthetic/jordan-example.webp",
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "customer_reference_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_person",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event person",
        "description": "Update an event person",
        "operationId": "updateEventPerson",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "person_id",
            "in": "path",
            "required": true,
            "description": "Opaque person id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  }
                },
                "required": [
                  "title"
                ],
                "additionalProperties": false
              },
              "example": {
                "title": "Program director"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event person response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPersonEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000032",
                    "object": "event_person",
                    "display_name": "Jordan Example",
                    "title": "Program director",
                    "bio_html": "<p>Synthetic instructor profile for documentation.</p>",
                    "photo_url": "https://pos.getcentri.com/media/events/synthetic/jordan-example.webp",
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "customer_reference_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_person_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write",
        "x-conditional-scopes": [
          {
            "scope": "events:registrations:write",
            "when": "The body supplies or changes customer_id."
          }
        ]
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event person",
        "description": "Archive an event person",
        "operationId": "archiveEventPerson",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "person_id",
            "in": "path",
            "required": true,
            "description": "Opaque person id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event person response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPersonEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000032",
                    "object": "event_person",
                    "display_name": "Jordan Example",
                    "title": "Lead instructor",
                    "bio_html": "<p>Synthetic instructor profile for documentation.</p>",
                    "photo_url": "https://pos.getcentri.com/media/events/synthetic/jordan-example.webp",
                    "status": "archived",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "customer_reference_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_person_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-organizations": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event organizations",
        "description": "List normalized sponsors, exhibitors, vendors, partners, and hosts.",
        "operationId": "listEventOrganizations",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event organizations response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOrganizationPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000033",
                      "object": "event_organization",
                      "name": "Example Robotics Foundation",
                      "organization_type": "sponsor",
                      "description_html": "<p>Synthetic sponsor used only in documentation.</p>",
                      "website_url": "https://example.test/robotics-foundation",
                      "logo_url": "https://pos.getcentri.com/media/events/synthetic/example-foundation.svg",
                      "status": "active",
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_organizations",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event organization",
        "description": "Create an event organization",
        "operationId": "createEventOrganization",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "organization_type": {
                    "type": "string"
                  },
                  "description_html": {
                    "type": "string"
                  },
                  "website_url": {
                    "type": "string"
                  },
                  "logo_url": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "name",
                  "organization_type",
                  "description_html",
                  "website_url",
                  "logo_url",
                  "status",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "name": "Example Robotics Foundation",
                "organization_type": "sponsor",
                "description_html": "<p>Synthetic sponsor used only in documentation.</p>",
                "website_url": "https://example.test/robotics-foundation",
                "logo_url": "https://pos.getcentri.com/media/events/synthetic/example-foundation.svg",
                "status": "active",
                "source_system": "example_integration",
                "external_id": "organization-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event organization response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOrganizationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000033",
                    "object": "event_organization",
                    "name": "Example Robotics Foundation",
                    "organization_type": "sponsor",
                    "description_html": "<p>Synthetic sponsor used only in documentation.</p>",
                    "website_url": "https://example.test/robotics-foundation",
                    "logo_url": "https://pos.getcentri.com/media/events/synthetic/example-foundation.svg",
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_organization_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-organizations/{organization_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event organization",
        "description": "Get an event organization",
        "operationId": "getEventOrganization",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "organization_id",
            "in": "path",
            "required": true,
            "description": "Opaque organization id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event organization response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOrganizationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000033",
                    "object": "event_organization",
                    "name": "Example Robotics Foundation",
                    "organization_type": "sponsor",
                    "description_html": "<p>Synthetic sponsor used only in documentation.</p>",
                    "website_url": "https://example.test/robotics-foundation",
                    "logo_url": "https://pos.getcentri.com/media/events/synthetic/example-foundation.svg",
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_organization",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event organization",
        "description": "Update an event organization",
        "operationId": "updateEventOrganization",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "organization_id",
            "in": "path",
            "required": true,
            "description": "Opaque organization id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "organization_type": {
                    "type": "string"
                  }
                },
                "required": [
                  "organization_type"
                ],
                "additionalProperties": false
              },
              "example": {
                "organization_type": "partner"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event organization response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOrganizationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000033",
                    "object": "event_organization",
                    "name": "Example Robotics Foundation",
                    "organization_type": "partner",
                    "description_html": "<p>Synthetic sponsor used only in documentation.</p>",
                    "website_url": "https://example.test/robotics-foundation",
                    "logo_url": "https://pos.getcentri.com/media/events/synthetic/example-foundation.svg",
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_organization_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event organization",
        "description": "Archive an event organization",
        "operationId": "archiveEventOrganization",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "organization_id",
            "in": "path",
            "required": true,
            "description": "Opaque organization id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event organization response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOrganizationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000033",
                    "object": "event_organization",
                    "name": "Example Robotics Foundation",
                    "organization_type": "sponsor",
                    "description_html": "<p>Synthetic sponsor used only in documentation.</p>",
                    "website_url": "https://example.test/robotics-foundation",
                    "logo_url": "https://pos.getcentri.com/media/events/synthetic/example-foundation.svg",
                    "status": "archived",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_organization_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/stakeholders": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event stakeholders",
        "description": "List speaker, instructor, staff, organizer, sponsor, exhibitor, vendor, or host roles. Each role references exactly one person or organization.",
        "operationId": "listEventStakeholders",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event stakeholders response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventStakeholderPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000034",
                      "object": "event_stakeholder_role",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "person_id": "10000000-0000-4000-8000-000000000032",
                      "organization_id": null,
                      "role": "instructor",
                      "role_label": "Morning lead instructor",
                      "is_public": true,
                      "sort_order": 10,
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_stakeholders",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event stakeholder",
        "description": "Create an event stakeholder",
        "operationId": "createEventStakeholder",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "occurrence_id": {
                    "type": "string"
                  },
                  "person_id": {
                    "type": "string"
                  },
                  "organization_id": {},
                  "role": {
                    "type": "string"
                  },
                  "role_label": {
                    "type": "string"
                  },
                  "is_public": {
                    "type": "boolean"
                  },
                  "sort_order": {
                    "type": "integer"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "occurrence_id",
                  "person_id",
                  "organization_id",
                  "role",
                  "role_label",
                  "is_public",
                  "sort_order",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "occurrence_id": "10000000-0000-4000-8000-000000000002",
                "person_id": "10000000-0000-4000-8000-000000000032",
                "organization_id": null,
                "role": "instructor",
                "role_label": "Morning lead instructor",
                "is_public": true,
                "sort_order": 10,
                "source_system": "example_integration",
                "external_id": "stakeholder-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event stakeholder response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventStakeholderEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000034",
                    "object": "event_stakeholder_role",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "person_id": "10000000-0000-4000-8000-000000000032",
                    "organization_id": null,
                    "role": "instructor",
                    "role_label": "Morning lead instructor",
                    "is_public": true,
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_stakeholder_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-stakeholder-roles/{stakeholder_role_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event stakeholder",
        "description": "Get an event stakeholder",
        "operationId": "getEventStakeholder",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "stakeholder_role_id",
            "in": "path",
            "required": true,
            "description": "Opaque stakeholder role id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event stakeholder response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventStakeholderEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000034",
                    "object": "event_stakeholder_role",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "person_id": "10000000-0000-4000-8000-000000000032",
                    "organization_id": null,
                    "role": "instructor",
                    "role_label": "Morning lead instructor",
                    "is_public": true,
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_stakeholder",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event stakeholder",
        "description": "Update an event stakeholder",
        "operationId": "updateEventStakeholder",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "stakeholder_role_id",
            "in": "path",
            "required": true,
            "description": "Opaque stakeholder role id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "role_label": {
                    "type": "string"
                  },
                  "is_public": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "role_label",
                  "is_public"
                ],
                "additionalProperties": false
              },
              "example": {
                "role_label": "Lead robotics instructor",
                "is_public": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event stakeholder response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventStakeholderEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000034",
                    "object": "event_stakeholder_role",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "person_id": "10000000-0000-4000-8000-000000000032",
                    "organization_id": null,
                    "role": "instructor",
                    "role_label": "Lead robotics instructor",
                    "is_public": true,
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_stakeholder_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Delete an event stakeholder",
        "description": "Delete an event stakeholder",
        "operationId": "deleteEventStakeholder",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "stakeholder_role_id",
            "in": "path",
            "required": true,
            "description": "Opaque stakeholder role id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/selection-groups": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event selection groups",
        "description": "List minimum/maximum attendee session-choice groups and their overlap policy.",
        "operationId": "listEventSelectionGroups",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event selection groups response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSelectionGroupPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000035",
                      "object": "event_selection_group",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "code": "AFTERNOON-LAB",
                      "name": "Choose one afternoon lab",
                      "description": "Select one non-overlapping lab session.",
                      "minimum_selections": 1,
                      "maximum_selections": 1,
                      "conflict_policy": "no_overlap",
                      "status": "active",
                      "sort_order": 10,
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_selection_groups",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event selection group",
        "description": "Create an event selection group",
        "operationId": "createEventSelectionGroup",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "minimum_selections": {
                    "type": "integer"
                  },
                  "maximum_selections": {
                    "type": "integer"
                  },
                  "conflict_policy": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "sort_order": {
                    "type": "integer"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "ticket_option_id",
                  "code",
                  "name",
                  "description",
                  "minimum_selections",
                  "maximum_selections",
                  "conflict_policy",
                  "status",
                  "sort_order",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "code": "AFTERNOON-LAB",
                "name": "Choose one afternoon lab",
                "description": "Select one non-overlapping lab session.",
                "minimum_selections": 1,
                "maximum_selections": 1,
                "conflict_policy": "no_overlap",
                "status": "active",
                "sort_order": 10,
                "source_system": "example_integration",
                "external_id": "selection-group-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event selection group response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSelectionGroupEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000035",
                    "object": "event_selection_group",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "code": "AFTERNOON-LAB",
                    "name": "Choose one afternoon lab",
                    "description": "Select one non-overlapping lab session.",
                    "minimum_selections": 1,
                    "maximum_selections": 1,
                    "conflict_policy": "no_overlap",
                    "status": "active",
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_selection_group_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-selection-groups/{selection_group_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event selection group",
        "description": "Get an event selection group",
        "operationId": "getEventSelectionGroup",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "selection_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque selection group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event selection group response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSelectionGroupEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000035",
                    "object": "event_selection_group",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "code": "AFTERNOON-LAB",
                    "name": "Choose one afternoon lab",
                    "description": "Select one non-overlapping lab session.",
                    "minimum_selections": 1,
                    "maximum_selections": 1,
                    "conflict_policy": "no_overlap",
                    "status": "active",
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_selection_group",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event selection group",
        "description": "Update an event selection group",
        "operationId": "updateEventSelectionGroup",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "selection_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque selection group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "maximum_selections": {
                    "type": "integer"
                  },
                  "conflict_policy": {
                    "type": "string"
                  }
                },
                "required": [
                  "maximum_selections",
                  "conflict_policy"
                ],
                "additionalProperties": false
              },
              "example": {
                "maximum_selections": 2,
                "conflict_policy": "no_overlap"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event selection group response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSelectionGroupEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000035",
                    "object": "event_selection_group",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "code": "AFTERNOON-LAB",
                    "name": "Choose one afternoon lab",
                    "description": "Select one non-overlapping lab session.",
                    "minimum_selections": 1,
                    "maximum_selections": 2,
                    "conflict_policy": "no_overlap",
                    "status": "active",
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_selection_group_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event selection group",
        "description": "Archive an event selection group",
        "operationId": "archiveEventSelectionGroup",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "selection_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque selection group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event selection group response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSelectionGroupEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000035",
                    "object": "event_selection_group",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "code": "AFTERNOON-LAB",
                    "name": "Choose one afternoon lab",
                    "description": "Select one non-overlapping lab session.",
                    "minimum_selections": 1,
                    "maximum_selections": 1,
                    "conflict_policy": "no_overlap",
                    "status": "archived",
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_selection_group_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-selection-groups/{selection_group_id}/occurrences": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List selection-group occurrences",
        "description": "List selection-group occurrences",
        "operationId": "listEventSelectionGroupOccurrences",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "selection_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque selection group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List selection-group occurrences response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSelectionGroupOccurrencePage"
                },
                "example": {
                  "data": [
                    {
                      "object": "event_selection_group_occurrence",
                      "selection_group_id": "10000000-0000-4000-8000-000000000035",
                      "occurrence_id": "10000000-0000-4000-8000-000000000003",
                      "sort_order": 10,
                      "created_at": "2026-08-25T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_selection_group_occurrences",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "has_more": false,
                    "limit": 50,
                    "next_cursor": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Add an occurrence to a selection group",
        "description": "Add an occurrence to a selection group",
        "operationId": "createEventSelectionGroupOccurrence",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "selection_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque selection group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "occurrence_id": {
                    "type": "string"
                  },
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "occurrence_id",
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "occurrence_id": "10000000-0000-4000-8000-000000000003",
                "sort_order": 10
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Add an occurrence to a selection group response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSelectionGroupOccurrenceEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_selection_group_occurrence",
                    "selection_group_id": "10000000-0000-4000-8000-000000000035",
                    "occurrence_id": "10000000-0000-4000-8000-000000000003",
                    "sort_order": 10,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_selection_group_occurrence_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-selection-groups/{selection_group_id}/occurrences/{occurrence_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a selection-group occurrence",
        "description": "Get a selection-group occurrence",
        "operationId": "getEventSelectionGroupOccurrence",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "selection_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque selection group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a selection-group occurrence response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSelectionGroupOccurrenceEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_selection_group_occurrence",
                    "selection_group_id": "10000000-0000-4000-8000-000000000035",
                    "occurrence_id": "10000000-0000-4000-8000-000000000003",
                    "sort_order": 10,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_selection_group_occurrence",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update a selection-group occurrence",
        "description": "Update a selection-group occurrence",
        "operationId": "updateEventSelectionGroupOccurrence",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "selection_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque selection group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "sort_order": 20
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a selection-group occurrence response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventSelectionGroupOccurrenceEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_selection_group_occurrence",
                    "selection_group_id": "10000000-0000-4000-8000-000000000035",
                    "occurrence_id": "10000000-0000-4000-8000-000000000003",
                    "sort_order": 20,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_selection_group_occurrence_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Remove an occurrence from a selection group",
        "description": "Remove an occurrence from a selection group",
        "operationId": "deleteEventSelectionGroupOccurrence",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "selection_group_id",
            "in": "path",
            "required": true,
            "description": "Opaque selection group id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/addon-options": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event add-on options",
        "description": "List ordinary product or variant options that can be assigned to an attendee during registration.",
        "operationId": "listEventAddonOptions",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event add-on options response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventAddonOptionPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000036",
                      "object": "event_addon_option",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "ticket_option_id": null,
                      "product_id": "20000000-0000-4000-8000-000000000002",
                      "variant_id": "20000000-0000-4000-8000-000000000003",
                      "label": "Camp T-shirt",
                      "description": "Optional attendee-sized shirt.",
                      "minimum_per_participant": 0,
                      "maximum_per_participant": 1,
                      "required": false,
                      "status": "active",
                      "sort_order": 10,
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_addon_options",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event add-on option",
        "description": "Create an event add-on option",
        "operationId": "createEventAddonOption",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticket_option_id": {},
                  "product_id": {
                    "type": "string"
                  },
                  "variant_id": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "minimum_per_participant": {
                    "type": "integer"
                  },
                  "maximum_per_participant": {
                    "type": "integer"
                  },
                  "required": {
                    "type": "boolean"
                  },
                  "status": {
                    "type": "string"
                  },
                  "sort_order": {
                    "type": "integer"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "ticket_option_id",
                  "product_id",
                  "variant_id",
                  "label",
                  "description",
                  "minimum_per_participant",
                  "maximum_per_participant",
                  "required",
                  "status",
                  "sort_order",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "ticket_option_id": null,
                "product_id": "20000000-0000-4000-8000-000000000002",
                "variant_id": "20000000-0000-4000-8000-000000000003",
                "label": "Camp T-shirt",
                "description": "Optional attendee-sized shirt.",
                "minimum_per_participant": 0,
                "maximum_per_participant": 1,
                "required": false,
                "status": "active",
                "sort_order": 10,
                "source_system": "example_integration",
                "external_id": "addon-option-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event add-on option response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventAddonOptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000036",
                    "object": "event_addon_option",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": null,
                    "product_id": "20000000-0000-4000-8000-000000000002",
                    "variant_id": "20000000-0000-4000-8000-000000000003",
                    "label": "Camp T-shirt",
                    "description": "Optional attendee-sized shirt.",
                    "minimum_per_participant": 0,
                    "maximum_per_participant": 1,
                    "required": false,
                    "status": "active",
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_addon_option_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-addon-options/{addon_option_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event add-on option",
        "description": "Get an event add-on option",
        "operationId": "getEventAddonOption",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "addon_option_id",
            "in": "path",
            "required": true,
            "description": "Opaque addon option id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event add-on option response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventAddonOptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000036",
                    "object": "event_addon_option",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": null,
                    "product_id": "20000000-0000-4000-8000-000000000002",
                    "variant_id": "20000000-0000-4000-8000-000000000003",
                    "label": "Camp T-shirt",
                    "description": "Optional attendee-sized shirt.",
                    "minimum_per_participant": 0,
                    "maximum_per_participant": 1,
                    "required": false,
                    "status": "active",
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_addon_option",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event add-on option",
        "description": "Update an event add-on option",
        "operationId": "updateEventAddonOption",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "addon_option_id",
            "in": "path",
            "required": true,
            "description": "Opaque addon option id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "maximum_per_participant": {
                    "type": "integer"
                  }
                },
                "required": [
                  "maximum_per_participant"
                ],
                "additionalProperties": false
              },
              "example": {
                "maximum_per_participant": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event add-on option response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventAddonOptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000036",
                    "object": "event_addon_option",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": null,
                    "product_id": "20000000-0000-4000-8000-000000000002",
                    "variant_id": "20000000-0000-4000-8000-000000000003",
                    "label": "Camp T-shirt",
                    "description": "Optional attendee-sized shirt.",
                    "minimum_per_participant": 0,
                    "maximum_per_participant": 2,
                    "required": false,
                    "status": "active",
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_addon_option_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event add-on option",
        "description": "Archive an event add-on option",
        "operationId": "archiveEventAddonOption",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "addon_option_id",
            "in": "path",
            "required": true,
            "description": "Opaque addon option id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event add-on option response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventAddonOptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000036",
                    "object": "event_addon_option",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": null,
                    "product_id": "20000000-0000-4000-8000-000000000002",
                    "variant_id": "20000000-0000-4000-8000-000000000003",
                    "label": "Camp T-shirt",
                    "description": "Optional attendee-sized shirt.",
                    "minimum_per_participant": 0,
                    "maximum_per_participant": 1,
                    "required": false,
                    "status": "archived",
                    "sort_order": 10,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_addon_option_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/occurrences": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event occurrences",
        "description": "List event occurrences",
        "operationId": "listEventOccurrences",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "starts_after",
            "in": "query",
            "required": false,
            "description": "Return schedule records ending or starting at or after this RFC 3339 timestamp, as defined by the operation.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "starts_before",
            "in": "query",
            "required": false,
            "description": "Return schedule records starting before this RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event occurrences response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrencePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000002",
                      "object": "event_occurrence",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_key": "camp-2026-09-14-am",
                      "name": "Morning camp",
                      "session_kind": "morning",
                      "enrollment_policy": "entitlement_only",
                      "status": "published",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "recurrence_until": "2026-09-18T16:00:00Z",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "online_meeting_url": null,
                      "attendee_instructions": "Use the east entrance and bring the issued ticket.",
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 2,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrences",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event occurrence",
        "description": "Create an event occurrence",
        "operationId": "createEventOccurrence",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "occurrence_key": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "session_kind": {
                    "type": "string"
                  },
                  "enrollment_policy": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "starts_at": {
                    "type": "string"
                  },
                  "ends_at": {
                    "type": "string"
                  },
                  "timezone": {
                    "type": "string"
                  },
                  "all_day": {
                    "type": "boolean"
                  },
                  "recurrence_rule": {
                    "type": "string"
                  },
                  "recurrence_until": {
                    "type": "string"
                  },
                  "venue_name": {
                    "type": "string"
                  },
                  "location_details": {
                    "type": "object",
                    "properties": {
                      "city": {
                        "type": "string"
                      },
                      "region": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "city",
                      "region"
                    ],
                    "additionalProperties": false
                  },
                  "attendee_instructions": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "occurrence_key",
                  "name",
                  "session_kind",
                  "enrollment_policy",
                  "status",
                  "starts_at",
                  "ends_at",
                  "timezone",
                  "all_day",
                  "recurrence_rule",
                  "recurrence_until",
                  "venue_name",
                  "location_details",
                  "attendee_instructions",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "occurrence_key": "camp-2026-09-14-am",
                "name": "Morning camp",
                "session_kind": "morning",
                "enrollment_policy": "entitlement_only",
                "status": "published",
                "starts_at": "2026-09-14T13:00:00Z",
                "ends_at": "2026-09-14T16:00:00Z",
                "timezone": "America/New_York",
                "all_day": false,
                "recurrence_rule": "FREQ=DAILY;COUNT=5",
                "recurrence_until": "2026-09-18T16:00:00Z",
                "venue_name": "Northstar Learning Lab",
                "location_details": {
                  "city": "Sample City",
                  "region": "OH"
                },
                "attendee_instructions": "Use the east entrance and bring the issued ticket.",
                "source_system": "example_integration",
                "external_id": "occurrence-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event occurrence response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000002",
                    "object": "event_occurrence",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_key": "camp-2026-09-14-am",
                    "name": "Morning camp",
                    "session_kind": "morning",
                    "enrollment_policy": "entitlement_only",
                    "status": "published",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "timezone": "America/New_York",
                    "all_day": false,
                    "recurrence_rule": "FREQ=DAILY;COUNT=5",
                    "recurrence_until": "2026-09-18T16:00:00Z",
                    "venue_name": "Northstar Learning Lab",
                    "location_details": {
                      "address": "100 Example Avenue",
                      "city": "Sample City",
                      "region": "OH",
                      "postal_code": "43000"
                    },
                    "online_meeting_url": null,
                    "attendee_instructions": "Use the east entrance and bring the issued ticket.",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-occurrences/{occurrence_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event occurrence",
        "description": "Get an event occurrence",
        "operationId": "getEventOccurrence",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event occurrence response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000002",
                    "object": "event_occurrence",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_key": "camp-2026-09-14-am",
                    "name": "Morning camp",
                    "session_kind": "morning",
                    "enrollment_policy": "entitlement_only",
                    "status": "published",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "timezone": "America/New_York",
                    "all_day": false,
                    "recurrence_rule": "FREQ=DAILY;COUNT=5",
                    "recurrence_until": "2026-09-18T16:00:00Z",
                    "venue_name": "Northstar Learning Lab",
                    "location_details": {
                      "address": "100 Example Avenue",
                      "city": "Sample City",
                      "region": "OH",
                      "postal_code": "43000"
                    },
                    "online_meeting_url": null,
                    "attendee_instructions": "Use the east entrance and bring the issued ticket.",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event occurrence",
        "description": "Update descriptive occurrence fields only. Schedule, recurrence, timezone, all-day, and status changes use staged reconcile-series or a dated occurrence exception; generic instance PATCH and DELETE routes are not registered.",
        "operationId": "updateEventOccurrence",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "name": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 240
                  },
                  "venue_name": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 240
                  },
                  "attendee_instructions": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 10000
                  },
                  "online_meeting_url": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "uri"
                  },
                  "occurrence_key": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160
                  },
                  "session_kind": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80
                  },
                  "enrollment_policy": {
                    "type": "string",
                    "enum": [
                      "entitlement_only",
                      "selection_optional",
                      "selection_required"
                    ]
                  },
                  "location_details": {
                    "type": "object"
                  },
                  "external_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "maxLength": 240
                  }
                },
                "description": "Descriptive fields only. Schedule, recurrence, timezone, all-day, and status changes require reconcile-series or an occurrence exception."
              },
              "example": {
                "version": 2,
                "name": "Morning robotics camp",
                "venue_name": "Northstar Learning Lab",
                "attendee_instructions": "Use the east entrance."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event occurrence response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000002",
                    "object": "event_occurrence",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_key": "camp-2026-09-14-am",
                    "name": "Morning camp",
                    "session_kind": "morning",
                    "enrollment_policy": "entitlement_only",
                    "status": "published",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "timezone": "America/New_York",
                    "all_day": false,
                    "recurrence_rule": "FREQ=DAILY;COUNT=5",
                    "recurrence_until": "2026-09-18T16:00:00Z",
                    "venue_name": "Northstar Learning Lab",
                    "location_details": {
                      "address": "100 Example Avenue",
                      "city": "Sample City",
                      "region": "OH",
                      "postal_code": "43000"
                    },
                    "online_meeting_url": null,
                    "attendee_instructions": "Use the east entrance and bring the issued ticket.",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-occurrences/{occurrence_id}/reconcile-series": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Reconcile a recurring occurrence series",
        "description": "Stage a broad, version-checked recurring-series replacement in batches of at most 500 desired instances and 10,000 per reconciliation. Send a new Idempotency-Key per batch, reuse reconciliation_id, and set is_final_batch only on the complete final batch. Collecting returns 202; applied returns 200.",
        "operationId": "reconcileEventOccurrenceSeries",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_version": {
                    "type": "integer"
                  },
                  "series_patch": {
                    "type": "object",
                    "properties": {
                      "starts_at": {
                        "type": "string"
                      },
                      "ends_at": {
                        "type": "string"
                      },
                      "timezone": {
                        "type": "string"
                      },
                      "recurrence_rule": {
                        "type": "string"
                      },
                      "recurrence_until": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "starts_at",
                      "ends_at",
                      "timezone",
                      "recurrence_rule",
                      "recurrence_until",
                      "status"
                    ],
                    "additionalProperties": false
                  },
                  "replace_window_start": {
                    "type": "string"
                  },
                  "replace_window_end": {
                    "type": "string"
                  },
                  "desired_instances": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "original_start_at": {
                          "type": "string"
                        },
                        "starts_at": {
                          "type": "string"
                        },
                        "ends_at": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "original_start_at",
                        "starts_at",
                        "ends_at",
                        "status"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "is_final_batch": {
                    "type": "boolean"
                  },
                  "reconciliation_id": {}
                },
                "required": [
                  "expected_version",
                  "series_patch",
                  "replace_window_start",
                  "replace_window_end",
                  "desired_instances",
                  "is_final_batch",
                  "reconciliation_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "expected_version": 2,
                "series_patch": {
                  "starts_at": "2026-09-14T13:00:00Z",
                  "ends_at": "2026-09-14T16:00:00Z",
                  "timezone": "America/New_York",
                  "recurrence_rule": "FREQ=DAILY;COUNT=5",
                  "recurrence_until": "2026-09-18T16:00:00Z",
                  "status": "published"
                },
                "replace_window_start": "2026-09-14T00:00:00Z",
                "replace_window_end": "2026-09-19T00:00:00Z",
                "desired_instances": [
                  {
                    "original_start_at": "2026-09-14T13:00:00Z",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "status": "scheduled"
                  }
                ],
                "is_final_batch": true,
                "reconciliation_id": null
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Reconcile a recurring occurrence series response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceSeriesReconciliationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000002",
                    "object": "event_occurrence_series_reconciliation",
                    "reconciliation_id": "10000000-0000-4000-8000-000000000038",
                    "status": "applied",
                    "staged_count": 5,
                    "version": 3,
                    "idempotency_result": "created"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_series_reconciliation",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "202": {
            "description": "Reconcile a recurring occurrence series intermediate response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceSeriesReconciliationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000002",
                    "object": "event_occurrence_series_reconciliation",
                    "reconciliation_id": "10000000-0000-4000-8000-000000000038",
                    "status": "applied",
                    "staged_count": 5,
                    "version": 3,
                    "idempotency_result": "created"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_series_reconciliation",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-occurrences/{occurrence_id}/exceptions": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List occurrence exceptions",
        "description": "List cancellation, reschedule, and field-override exceptions without rewriting the recurrence series.",
        "operationId": "listEventOccurrenceExceptions",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List occurrence exceptions response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceExceptionPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000004",
                      "object": "event_occurrence_exception",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "original_start_at": "2026-09-16T13:00:00Z",
                      "exception_type": "rescheduled",
                      "starts_at": "2026-09-16T14:00:00Z",
                      "ends_at": "2026-09-16T17:00:00Z",
                      "override_fields": {
                        "attendee_instructions": "Wednesday begins one hour later."
                      },
                      "reason": "Synthetic venue schedule change",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_exceptions",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an occurrence exception",
        "description": "Create an occurrence exception",
        "operationId": "createEventOccurrenceException",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "original_start_at": {
                    "type": "string"
                  },
                  "exception_type": {
                    "type": "string"
                  },
                  "starts_at": {
                    "type": "string"
                  },
                  "ends_at": {
                    "type": "string"
                  },
                  "override_fields": {
                    "type": "object",
                    "properties": {
                      "attendee_instructions": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "attendee_instructions"
                    ],
                    "additionalProperties": false
                  },
                  "reason": {
                    "type": "string"
                  }
                },
                "required": [
                  "original_start_at",
                  "exception_type",
                  "starts_at",
                  "ends_at",
                  "override_fields",
                  "reason"
                ],
                "additionalProperties": false
              },
              "example": {
                "original_start_at": "2026-09-16T13:00:00Z",
                "exception_type": "rescheduled",
                "starts_at": "2026-09-16T14:00:00Z",
                "ends_at": "2026-09-16T17:00:00Z",
                "override_fields": {
                  "attendee_instructions": "Wednesday begins one hour later."
                },
                "reason": "Synthetic venue schedule change"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an occurrence exception response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceExceptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000004",
                    "object": "event_occurrence_exception",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "original_start_at": "2026-09-16T13:00:00Z",
                    "exception_type": "rescheduled",
                    "starts_at": "2026-09-16T14:00:00Z",
                    "ends_at": "2026-09-16T17:00:00Z",
                    "override_fields": {
                      "attendee_instructions": "Wednesday begins one hour later."
                    },
                    "reason": "Synthetic venue schedule change",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_exception_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-occurrence-exceptions/{occurrence_exception_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an occurrence exception",
        "description": "Get an occurrence exception",
        "operationId": "getEventOccurrenceException",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_exception_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence exception id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an occurrence exception response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceExceptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000004",
                    "object": "event_occurrence_exception",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "original_start_at": "2026-09-16T13:00:00Z",
                    "exception_type": "rescheduled",
                    "starts_at": "2026-09-16T14:00:00Z",
                    "ends_at": "2026-09-16T17:00:00Z",
                    "override_fields": {
                      "attendee_instructions": "Wednesday begins one hour later."
                    },
                    "reason": "Synthetic venue schedule change",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_exception",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an occurrence exception",
        "description": "Update an occurrence exception",
        "operationId": "updateEventOccurrenceException",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_exception_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence exception id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "starts_at": {
                    "type": "string"
                  },
                  "ends_at": {
                    "type": "string"
                  },
                  "reason": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "starts_at",
                  "ends_at",
                  "reason"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "starts_at": "2026-09-16T14:30:00Z",
                "ends_at": "2026-09-16T17:30:00Z",
                "reason": "Synthetic final schedule"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an occurrence exception response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceExceptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000004",
                    "object": "event_occurrence_exception",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "original_start_at": "2026-09-16T13:00:00Z",
                    "exception_type": "rescheduled",
                    "starts_at": "2026-09-16T14:30:00Z",
                    "ends_at": "2026-09-16T17:30:00Z",
                    "override_fields": {
                      "attendee_instructions": "Wednesday begins one hour later."
                    },
                    "reason": "Synthetic venue schedule change",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_exception_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Delete an occurrence exception",
        "description": "Delete an occurrence exception",
        "operationId": "deleteEventOccurrenceException",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_exception_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence exception id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-occurrences/{occurrence_id}/instances": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List concrete occurrence instances",
        "description": "List durable concrete dates materialized from an occurrence series. Use occurrence_instance_id, not a recomputed timestamp, for date-specific enrollment, admission, and calendar evidence.",
        "operationId": "listEventOccurrenceInstances",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 50
            }
          },
          {
            "name": "starts_after",
            "in": "query",
            "required": false,
            "description": "Return schedule records ending or starting at or after this RFC 3339 timestamp, as defined by the operation.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "starts_before",
            "in": "query",
            "required": false,
            "description": "Return schedule records starting before this RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List concrete occurrence instances response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceInstancePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000029",
                      "object": "event_occurrence_instance",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "exception_id": null,
                      "instance_key": "i_2eb330438a5137b15d3d8f0b2ff4bd5e9bbc2a3f2db213e7",
                      "original_start_at": "2026-09-14T13:00:00Z",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "status": "scheduled",
                      "source_system": "recurrence_materializer",
                      "external_id": "occurrence:10000000-0000-4000-8000-000000000002:original:2026-09-14T13:00:00Z",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_instances",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "has_more": false,
                    "limit": 50,
                    "next_cursor": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Materialize concrete occurrence instances",
        "description": "Upsert 1 to 500 bounded concrete UTC dates for one occurrence. Identity is stable by occurrence and original_start_at; rescheduling uses an occurrence exception or staged series reconciliation rather than direct instance mutation.",
        "operationId": "materializeEventOccurrenceInstances",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "instances"
                ],
                "properties": {
                  "instances": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 500,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "required": [
                        "original_start_at",
                        "ends_at"
                      ],
                      "properties": {
                        "original_start_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "starts_at": {
                          "type": "string",
                          "format": "date-time",
                          "description": "Effective start; defaults to original_start_at when omitted."
                        },
                        "ends_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "status": {
                          "type": "string",
                          "enum": [
                            "scheduled",
                            "cancelled",
                            "completed"
                          ],
                          "default": "scheduled"
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "instances": [
                  {
                    "original_start_at": "2026-09-14T13:00:00Z",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "status": "scheduled"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Materialize concrete occurrence instances response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceInstanceListEnvelope"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000029",
                      "object": "event_occurrence_instance",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "exception_id": null,
                      "instance_key": "i_2eb330438a5137b15d3d8f0b2ff4bd5e9bbc2a3f2db213e7",
                      "original_start_at": "2026-09-14T13:00:00Z",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "status": "scheduled",
                      "source_system": "recurrence_materializer",
                      "external_id": "occurrence:10000000-0000-4000-8000-000000000002:original:2026-09-14T13:00:00Z",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_instances_materialize",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-occurrence-instances/{occurrence_instance_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a concrete occurrence instance",
        "description": "Get a concrete occurrence instance",
        "operationId": "getEventOccurrenceInstance",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_instance_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence instance id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a concrete occurrence instance response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceInstanceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000029",
                    "object": "event_occurrence_instance",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "exception_id": null,
                    "instance_key": "i_2eb330438a5137b15d3d8f0b2ff4bd5e9bbc2a3f2db213e7",
                    "original_start_at": "2026-09-14T13:00:00Z",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "timezone": "America/New_York",
                    "status": "scheduled",
                    "source_system": "recurrence_materializer",
                    "external_id": "occurrence:10000000-0000-4000-8000-000000000002:original:2026-09-14T13:00:00Z",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_instance",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      }
    },
    "/api/retail/v1/event-occurrences/{occurrence_id}/tracks": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List occurrence tracks",
        "description": "List occurrence tracks",
        "operationId": "listEventOccurrenceTracks",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List occurrence tracks response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceTrackPage"
                },
                "example": {
                  "data": [
                    {
                      "object": "event_occurrence_track",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "track_id": "10000000-0000-4000-8000-000000000031",
                      "sort_order": 10,
                      "created_at": "2026-08-25T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_tracks",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "has_more": false,
                    "limit": 50,
                    "next_cursor": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Add a track to an occurrence",
        "description": "Add a track to an occurrence",
        "operationId": "createEventOccurrenceTrack",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "track_id": {
                    "type": "string"
                  },
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "track_id",
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "track_id": "10000000-0000-4000-8000-000000000031",
                "sort_order": 10
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Add a track to an occurrence response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceTrackEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_occurrence_track",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "track_id": "10000000-0000-4000-8000-000000000031",
                    "sort_order": 10,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_track_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-occurrences/{occurrence_id}/tracks/{track_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an occurrence track",
        "description": "Get an occurrence track",
        "operationId": "getEventOccurrenceTrack",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "track_id",
            "in": "path",
            "required": true,
            "description": "Opaque track id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an occurrence track response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceTrackEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_occurrence_track",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "track_id": "10000000-0000-4000-8000-000000000031",
                    "sort_order": 10,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_track",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an occurrence track",
        "description": "Update an occurrence track",
        "operationId": "updateEventOccurrenceTrack",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "track_id",
            "in": "path",
            "required": true,
            "description": "Opaque track id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "sort_order": 20
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an occurrence track response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceTrackEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_occurrence_track",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "track_id": "10000000-0000-4000-8000-000000000031",
                    "sort_order": 20,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_track_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Remove a track from an occurrence",
        "description": "Remove a track from an occurrence",
        "operationId": "deleteEventOccurrenceTrack",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "track_id",
            "in": "path",
            "required": true,
            "description": "Opaque track id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/capacity-pools": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event capacity pools",
        "description": "List event capacity pools",
        "operationId": "listEventCapacityPools",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event capacity pools response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventCapacityPoolPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000005",
                      "object": "event_capacity_pool",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "code": "MORNING-SEATS",
                      "name": "Morning camper seats",
                      "capacity": 24,
                      "overbook_allowance": 0,
                      "waitlist_enabled": true,
                      "status": "active",
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_capacity_pools",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event capacity pool",
        "description": "Create an event capacity pool",
        "operationId": "createEventCapacityPool",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "occurrence_id": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "capacity": {
                    "type": "integer"
                  },
                  "overbook_allowance": {
                    "type": "integer"
                  },
                  "waitlist_enabled": {
                    "type": "boolean"
                  },
                  "status": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "occurrence_id",
                  "code",
                  "name",
                  "capacity",
                  "overbook_allowance",
                  "waitlist_enabled",
                  "status",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "occurrence_id": "10000000-0000-4000-8000-000000000002",
                "code": "MORNING-SEATS",
                "name": "Morning camper seats",
                "capacity": 24,
                "overbook_allowance": 0,
                "waitlist_enabled": true,
                "status": "active",
                "source_system": "example_integration",
                "external_id": "capacity-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event capacity pool response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventCapacityPoolEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000005",
                    "object": "event_capacity_pool",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "code": "MORNING-SEATS",
                    "name": "Morning camper seats",
                    "capacity": 24,
                    "overbook_allowance": 0,
                    "waitlist_enabled": true,
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_capacity_pool_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-capacity-pools/{capacity_pool_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event capacity pool",
        "description": "Get an event capacity pool",
        "operationId": "getEventCapacityPool",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "capacity_pool_id",
            "in": "path",
            "required": true,
            "description": "Opaque capacity pool id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event capacity pool response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventCapacityPoolEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000005",
                    "object": "event_capacity_pool",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "code": "MORNING-SEATS",
                    "name": "Morning camper seats",
                    "capacity": 24,
                    "overbook_allowance": 0,
                    "waitlist_enabled": true,
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_capacity_pool",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event capacity pool",
        "description": "Update an event capacity pool",
        "operationId": "updateEventCapacityPool",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "capacity_pool_id",
            "in": "path",
            "required": true,
            "description": "Opaque capacity pool id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "capacity": {
                    "type": "integer"
                  },
                  "waitlist_enabled": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "version",
                  "capacity",
                  "waitlist_enabled"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "capacity": 28,
                "waitlist_enabled": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event capacity pool response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventCapacityPoolEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000005",
                    "object": "event_capacity_pool",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "code": "MORNING-SEATS",
                    "name": "Morning camper seats",
                    "capacity": 28,
                    "overbook_allowance": 0,
                    "waitlist_enabled": true,
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_capacity_pool_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Close an event capacity pool",
        "description": "Close an event capacity pool",
        "operationId": "closeEventCapacityPool",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "capacity_pool_id",
            "in": "path",
            "required": true,
            "description": "Opaque capacity pool id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Close an event capacity pool response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventCapacityPoolEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000005",
                    "object": "event_capacity_pool",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "code": "MORNING-SEATS",
                    "name": "Morning camper seats",
                    "capacity": 24,
                    "overbook_allowance": 0,
                    "waitlist_enabled": true,
                    "status": "closed",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_capacity_pool_close",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/ticket-options": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event ticket options",
        "description": "List event ticket options",
        "operationId": "listEventTicketOptions",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event ticket options response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketOptionPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000008",
                      "object": "event_ticket_option",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "product_id": "20000000-0000-4000-8000-000000000001",
                      "code": "FULL-DAY",
                      "label": "Full day",
                      "description": "Admission to morning, supervised lunch bridge, and afternoon camp sessions.",
                      "status": "active",
                      "sales_opens_at": "2026-08-25T13:00:00Z",
                      "sales_closes_at": "2026-09-13T23:59:00Z",
                      "minimum_per_order": 1,
                      "maximum_per_order": 4,
                      "seats_per_ticket": 1,
                      "assignment_policy": "at_checkout",
                      "assignment_deadline_at": null,
                      "sort_order": 30,
                      "eligibility_rules": {
                        "minimum_age_months": 96,
                        "maximum_age_months": 156
                      },
                      "portal_settings": {
                        "show_schedule": true,
                        "show_ticket": true,
                        "calendar_download": true
                      },
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_options",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event ticket option",
        "description": "Create a ticket option backed by an active same-tenant event_ticket product, then atomically configure its occurrence bundle and capacity allocations.",
        "operationId": "createEventTicketOption",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "product_id": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "minimum_per_order": {
                    "type": "integer"
                  },
                  "maximum_per_order": {
                    "type": "integer"
                  },
                  "seats_per_ticket": {
                    "type": "integer"
                  },
                  "assignment_policy": {
                    "type": "string"
                  },
                  "assignment_deadline_at": {},
                  "occurrence_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "capacity_allocations": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "capacity_pool_id": {
                          "type": "string"
                        },
                        "units_per_seat": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "capacity_pool_id",
                        "units_per_seat"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "product_id",
                  "code",
                  "label",
                  "description",
                  "status",
                  "minimum_per_order",
                  "maximum_per_order",
                  "seats_per_ticket",
                  "assignment_policy",
                  "assignment_deadline_at",
                  "occurrence_ids",
                  "capacity_allocations",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "product_id": "20000000-0000-4000-8000-000000000001",
                "code": "FULL-DAY",
                "label": "Full day",
                "description": "Admission to morning, supervised lunch bridge, and afternoon camp sessions.",
                "status": "active",
                "minimum_per_order": 1,
                "maximum_per_order": 4,
                "seats_per_ticket": 1,
                "assignment_policy": "at_checkout",
                "assignment_deadline_at": null,
                "occurrence_ids": [
                  "10000000-0000-4000-8000-000000000002",
                  "10000000-0000-4000-8000-000000000040",
                  "10000000-0000-4000-8000-000000000003"
                ],
                "capacity_allocations": [
                  {
                    "capacity_pool_id": "10000000-0000-4000-8000-000000000005",
                    "units_per_seat": 1
                  },
                  {
                    "capacity_pool_id": "10000000-0000-4000-8000-000000000006",
                    "units_per_seat": 1
                  }
                ],
                "source_system": "example_integration",
                "external_id": "ticket-option-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event ticket option response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketOptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000008",
                    "object": "event_ticket_option",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "product_id": "20000000-0000-4000-8000-000000000001",
                    "code": "FULL-DAY",
                    "label": "Full day",
                    "description": "Admission to morning, supervised lunch bridge, and afternoon camp sessions.",
                    "status": "active",
                    "sales_opens_at": "2026-08-25T13:00:00Z",
                    "sales_closes_at": "2026-09-13T23:59:00Z",
                    "minimum_per_order": 1,
                    "maximum_per_order": 4,
                    "seats_per_ticket": 1,
                    "assignment_policy": "at_checkout",
                    "assignment_deadline_at": null,
                    "sort_order": 30,
                    "eligibility_rules": {
                      "minimum_age_months": 96,
                      "maximum_age_months": 156
                    },
                    "portal_settings": {
                      "show_schedule": true,
                      "show_ticket": true,
                      "calendar_download": true
                    },
                    "relationships": {
                      "occurrences": {
                        "count": 3,
                        "collection": null,
                        "note": "Use occurrence collections and the ticket option aggregate write contract."
                      },
                      "capacity_allocations": {
                        "count": 2,
                        "collection": null,
                        "note": "Use the ticket option aggregate write contract."
                      }
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_option_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-ticket-options/{ticket_option_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event ticket option",
        "description": "Get an event ticket option",
        "operationId": "getEventTicketOption",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_option_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket option id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event ticket option response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketOptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000008",
                    "object": "event_ticket_option",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "product_id": "20000000-0000-4000-8000-000000000001",
                    "code": "FULL-DAY",
                    "label": "Full day",
                    "description": "Admission to morning, supervised lunch bridge, and afternoon camp sessions.",
                    "status": "active",
                    "sales_opens_at": "2026-08-25T13:00:00Z",
                    "sales_closes_at": "2026-09-13T23:59:00Z",
                    "minimum_per_order": 1,
                    "maximum_per_order": 4,
                    "seats_per_ticket": 1,
                    "assignment_policy": "at_checkout",
                    "assignment_deadline_at": null,
                    "sort_order": 30,
                    "eligibility_rules": {
                      "minimum_age_months": 96,
                      "maximum_age_months": 156
                    },
                    "portal_settings": {
                      "show_schedule": true,
                      "show_ticket": true,
                      "calendar_download": true
                    },
                    "relationships": {
                      "occurrences": {
                        "count": 3,
                        "collection": null,
                        "note": "Use occurrence collections and the ticket option aggregate write contract."
                      },
                      "capacity_allocations": {
                        "count": 2,
                        "collection": null,
                        "note": "Use the ticket option aggregate write contract."
                      }
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_option",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event ticket option",
        "description": "Update an event ticket option",
        "operationId": "updateEventTicketOption",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_option_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket option id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "occurrence_ids": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "capacity_allocations": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "capacity_pool_id": {
                          "type": "string"
                        },
                        "units_per_seat": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "capacity_pool_id",
                        "units_per_seat"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "version",
                  "occurrence_ids",
                  "capacity_allocations"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "occurrence_ids": [
                  "10000000-0000-4000-8000-000000000002",
                  "10000000-0000-4000-8000-000000000040",
                  "10000000-0000-4000-8000-000000000003"
                ],
                "capacity_allocations": [
                  {
                    "capacity_pool_id": "10000000-0000-4000-8000-000000000005",
                    "units_per_seat": 1
                  },
                  {
                    "capacity_pool_id": "10000000-0000-4000-8000-000000000006",
                    "units_per_seat": 1
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event ticket option response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketOptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000008",
                    "object": "event_ticket_option",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "product_id": "20000000-0000-4000-8000-000000000001",
                    "code": "FULL-DAY",
                    "label": "Full day",
                    "description": "Admission to morning, supervised lunch bridge, and afternoon camp sessions.",
                    "status": "active",
                    "sales_opens_at": "2026-08-25T13:00:00Z",
                    "sales_closes_at": "2026-09-13T23:59:00Z",
                    "minimum_per_order": 1,
                    "maximum_per_order": 4,
                    "seats_per_ticket": 1,
                    "assignment_policy": "at_checkout",
                    "assignment_deadline_at": null,
                    "sort_order": 30,
                    "eligibility_rules": {
                      "minimum_age_months": 96,
                      "maximum_age_months": 156
                    },
                    "portal_settings": {
                      "show_schedule": true,
                      "show_ticket": true,
                      "calendar_download": true
                    },
                    "relationships": {
                      "occurrences": {
                        "count": 3,
                        "collection": null,
                        "note": "Use occurrence collections and the ticket option aggregate write contract."
                      },
                      "capacity_allocations": {
                        "count": 2,
                        "collection": null,
                        "note": "Use the ticket option aggregate write contract."
                      }
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_option_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event ticket option",
        "description": "Archive an event ticket option",
        "operationId": "archiveEventTicketOption",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_option_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket option id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event ticket option response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketOptionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000008",
                    "object": "event_ticket_option",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "product_id": "20000000-0000-4000-8000-000000000001",
                    "code": "FULL-DAY",
                    "label": "Full day",
                    "description": "Admission to morning, supervised lunch bridge, and afternoon camp sessions.",
                    "status": "archived",
                    "sales_opens_at": "2026-08-25T13:00:00Z",
                    "sales_closes_at": "2026-09-13T23:59:00Z",
                    "minimum_per_order": 1,
                    "maximum_per_order": 4,
                    "seats_per_ticket": 1,
                    "assignment_policy": "at_checkout",
                    "assignment_deadline_at": null,
                    "sort_order": 30,
                    "eligibility_rules": {
                      "minimum_age_months": 96,
                      "maximum_age_months": 156
                    },
                    "portal_settings": {
                      "show_schedule": true,
                      "show_ticket": true,
                      "calendar_download": true
                    },
                    "relationships": {
                      "occurrences": {
                        "count": 3,
                        "collection": null,
                        "note": "Use occurrence collections and the ticket option aggregate write contract."
                      },
                      "capacity_allocations": {
                        "count": 2,
                        "collection": null,
                        "note": "Use the ticket option aggregate write contract."
                      }
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_option_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-payment-plan-policies": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event payment-plan policies",
        "description": "List offering-level or ticket-specific deposit and installment policies. Results use the same opaque or paired legacy created-at cursor contract as other event configuration collections.",
        "operationId": "listEventPaymentPlanPolicies",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "offering_id",
            "in": "query",
            "required": false,
            "description": "Filter by offering id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "ticket_option_id",
            "in": "query",
            "required": false,
            "description": "Opaque event ticket-option identifier within the published offering.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "customer_selectable",
            "in": "query",
            "required": false,
            "description": "Filter by customer selectable.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event payment-plan policies response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPaymentPlanPolicyPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000047",
                      "object": "event_payment_plan_policy",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "code": "FULL-DAY-DEPOSIT",
                      "name": "25% deposit plus three weekly installments",
                      "description": "Synthetic household plan that reserves a camp seat after its deposit clears.",
                      "status": "active",
                      "customer_selectable": true,
                      "deposit_mode": "percentage",
                      "deposit_value": 25,
                      "remaining_installment_count": 3,
                      "interval_unit": "weeks",
                      "interval_count": 1,
                      "first_installment_delay_days": 1,
                      "final_due_days_before_start": 1,
                      "grace_period_days": 3,
                      "capacity_policy": "reserve_on_deposit",
                      "admission_policy": "active_plan_allowed",
                      "delinquency_policy": "manual_review",
                      "auto_collect_allowed": false,
                      "sort_order": 10,
                      "metadata": {
                        "audience": "household"
                      },
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_payment_plan_policies",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event payment-plan policy",
        "description": "Create a tenant-validated policy for one offering and optional same-offering ticket option. A unique Idempotency-Key is required; the receipt quote and checkout services remain authoritative for calculated dates and cents.",
        "operationId": "createEventPaymentPlanPolicy",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "offering_id": {
                    "type": "string"
                  },
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "customer_selectable": {
                    "type": "boolean"
                  },
                  "deposit_mode": {
                    "type": "string"
                  },
                  "deposit_value": {
                    "type": "integer"
                  },
                  "remaining_installment_count": {
                    "type": "integer"
                  },
                  "interval_unit": {
                    "type": "string"
                  },
                  "interval_count": {
                    "type": "integer"
                  },
                  "first_installment_delay_days": {
                    "type": "integer"
                  },
                  "final_due_days_before_start": {
                    "type": "integer"
                  },
                  "grace_period_days": {
                    "type": "integer"
                  },
                  "capacity_policy": {
                    "type": "string"
                  },
                  "admission_policy": {
                    "type": "string"
                  },
                  "delinquency_policy": {
                    "type": "string"
                  },
                  "auto_collect_allowed": {
                    "type": "boolean"
                  },
                  "sort_order": {
                    "type": "integer"
                  },
                  "metadata": {
                    "type": "object",
                    "properties": {
                      "audience": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "audience"
                    ],
                    "additionalProperties": false
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {}
                },
                "required": [
                  "offering_id",
                  "ticket_option_id",
                  "code",
                  "name",
                  "description",
                  "status",
                  "customer_selectable",
                  "deposit_mode",
                  "deposit_value",
                  "remaining_installment_count",
                  "interval_unit",
                  "interval_count",
                  "first_installment_delay_days",
                  "final_due_days_before_start",
                  "grace_period_days",
                  "capacity_policy",
                  "admission_policy",
                  "delinquency_policy",
                  "auto_collect_allowed",
                  "sort_order",
                  "metadata",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "offering_id": "10000000-0000-4000-8000-000000000001",
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "code": "FULL-DAY-DEPOSIT",
                "name": "25% deposit plus three weekly installments",
                "description": "Synthetic household plan that reserves a camp seat after its deposit clears.",
                "status": "active",
                "customer_selectable": true,
                "deposit_mode": "percentage",
                "deposit_value": 25,
                "remaining_installment_count": 3,
                "interval_unit": "weeks",
                "interval_count": 1,
                "first_installment_delay_days": 1,
                "final_due_days_before_start": 1,
                "grace_period_days": 3,
                "capacity_policy": "reserve_on_deposit",
                "admission_policy": "active_plan_allowed",
                "delinquency_policy": "manual_review",
                "auto_collect_allowed": false,
                "sort_order": 10,
                "metadata": {
                  "audience": "household"
                },
                "source_system": "centripos",
                "external_id": null
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event payment-plan policy response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPaymentPlanPolicyEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000047",
                    "object": "event_payment_plan_policy",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "code": "FULL-DAY-DEPOSIT",
                    "name": "25% deposit plus three weekly installments",
                    "description": "Synthetic household plan that reserves a camp seat after its deposit clears.",
                    "status": "active",
                    "customer_selectable": true,
                    "deposit_mode": "percentage",
                    "deposit_value": 25,
                    "remaining_installment_count": 3,
                    "interval_unit": "weeks",
                    "interval_count": 1,
                    "first_installment_delay_days": 1,
                    "final_due_days_before_start": 1,
                    "grace_period_days": 3,
                    "capacity_policy": "reserve_on_deposit",
                    "admission_policy": "active_plan_allowed",
                    "delinquency_policy": "manual_review",
                    "auto_collect_allowed": false,
                    "sort_order": 10,
                    "metadata": {
                      "audience": "household"
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_payment_plan_policy_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-payment-plan-policies/{policy_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event payment-plan policy",
        "description": "Get an event payment-plan policy",
        "operationId": "getEventPaymentPlanPolicy",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "policy_id",
            "in": "path",
            "required": true,
            "description": "Opaque policy id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event payment-plan policy response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPaymentPlanPolicyEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000047",
                    "object": "event_payment_plan_policy",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "code": "FULL-DAY-DEPOSIT",
                    "name": "25% deposit plus three weekly installments",
                    "description": "Synthetic household plan that reserves a camp seat after its deposit clears.",
                    "status": "active",
                    "customer_selectable": true,
                    "deposit_mode": "percentage",
                    "deposit_value": 25,
                    "remaining_installment_count": 3,
                    "interval_unit": "weeks",
                    "interval_count": 1,
                    "first_installment_delay_days": 1,
                    "final_due_days_before_start": 1,
                    "grace_period_days": 3,
                    "capacity_policy": "reserve_on_deposit",
                    "admission_policy": "active_plan_allowed",
                    "delinquency_policy": "manual_review",
                    "auto_collect_allowed": false,
                    "sort_order": 10,
                    "metadata": {
                      "audience": "household"
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_payment_plan_policy",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event payment-plan policy",
        "description": "Update the supported policy fields with optimistic version protection. offering_id and external_id identity cannot be reassigned, and an archived policy is immutable.",
        "operationId": "updateEventPaymentPlanPolicy",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "policy_id",
            "in": "path",
            "required": true,
            "description": "Opaque policy id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "customer_selectable": {
                    "type": "boolean"
                  },
                  "grace_period_days": {
                    "type": "integer"
                  }
                },
                "required": [
                  "version",
                  "customer_selectable",
                  "grace_period_days"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "customer_selectable": false,
                "grace_period_days": 5
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event payment-plan policy response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPaymentPlanPolicyEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000047",
                    "object": "event_payment_plan_policy",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "code": "FULL-DAY-DEPOSIT",
                    "name": "25% deposit plus three weekly installments",
                    "description": "Synthetic household plan that reserves a camp seat after its deposit clears.",
                    "status": "active",
                    "customer_selectable": false,
                    "deposit_mode": "percentage",
                    "deposit_value": 25,
                    "remaining_installment_count": 3,
                    "interval_unit": "weeks",
                    "interval_count": 1,
                    "first_installment_delay_days": 1,
                    "final_due_days_before_start": 1,
                    "grace_period_days": 5,
                    "capacity_policy": "reserve_on_deposit",
                    "admission_policy": "active_plan_allowed",
                    "delinquency_policy": "manual_review",
                    "auto_collect_allowed": false,
                    "sort_order": 10,
                    "metadata": {
                      "audience": "household"
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_payment_plan_policy_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event payment-plan policy",
        "description": "Archive the policy without deleting its historical identity. Repeating DELETE against an already archived policy returns the archived representation.",
        "operationId": "archiveEventPaymentPlanPolicy",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "policy_id",
            "in": "path",
            "required": true,
            "description": "Opaque policy id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event payment-plan policy response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPaymentPlanPolicyEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000047",
                    "object": "event_payment_plan_policy",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "code": "FULL-DAY-DEPOSIT",
                    "name": "25% deposit plus three weekly installments",
                    "description": "Synthetic household plan that reserves a camp seat after its deposit clears.",
                    "status": "archived",
                    "customer_selectable": true,
                    "deposit_mode": "percentage",
                    "deposit_value": 25,
                    "remaining_installment_count": 3,
                    "interval_unit": "weeks",
                    "interval_count": 1,
                    "first_installment_delay_days": 1,
                    "final_due_days_before_start": 1,
                    "grace_period_days": 3,
                    "capacity_policy": "reserve_on_deposit",
                    "admission_policy": "active_plan_allowed",
                    "delinquency_policy": "manual_review",
                    "auto_collect_allowed": false,
                    "sort_order": 10,
                    "metadata": {
                      "audience": "household"
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_payment_plan_policy_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-participants": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event participants",
        "description": "List reusable attendees. Protected fields are omitted unless the key also has events:sensitive:read.",
        "operationId": "listEventParticipants",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event participants response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000009",
                      "object": "event_participant",
                      "customer_id": null,
                      "participant_type": "camper",
                      "status": "active",
                      "first_name": "Avery",
                      "last_name": "Example",
                      "preferred_name": "Avery",
                      "source_system": "example_import",
                      "external_id": "participant-demo-001",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "sensitive_fields_omitted": true
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participants",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event participant",
        "description": "Create a reusable attendee. A request containing email, phone, birth_date, accessibility_summary, or metadata additionally requires events:sensitive:write.",
        "operationId": "createEventParticipant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "participant_type": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "first_name": {
                    "type": "string"
                  },
                  "last_name": {
                    "type": "string"
                  },
                  "preferred_name": {
                    "type": "string"
                  },
                  "birth_date": {
                    "type": "string"
                  },
                  "metadata": {
                    "type": "object",
                    "properties": {
                      "school_grade": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "school_grade"
                    ],
                    "additionalProperties": false
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "participant_type",
                  "status",
                  "first_name",
                  "last_name",
                  "preferred_name",
                  "birth_date",
                  "metadata",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "participant_type": "camper",
                "status": "active",
                "first_name": "Avery",
                "last_name": "Example",
                "preferred_name": "Avery",
                "birth_date": "2015-04-10",
                "metadata": {
                  "school_grade": "5"
                },
                "source_system": "example_integration",
                "external_id": "participant-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event participant response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000009",
                    "object": "event_participant",
                    "customer_id": null,
                    "participant_type": "camper",
                    "status": "active",
                    "first_name": "Avery",
                    "last_name": "Example",
                    "preferred_name": "Avery",
                    "source_system": "example_import",
                    "external_id": "participant-demo-001",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "sensitive_fields_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-conditional-scopes": [
          {
            "scope": "events:sensitive:write",
            "when": "The body contains email, phone, birth_date, accessibility_summary, or metadata."
          }
        ]
      }
    },
    "/api/retail/v1/event-participants/{participant_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event participant",
        "description": "Retrieve a participant with explicit guardian relationships; sensitive participant fields require events:sensitive:read.",
        "operationId": "getEventParticipant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event participant response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000009",
                    "object": "event_participant",
                    "customer_id": null,
                    "participant_type": "camper",
                    "status": "active",
                    "first_name": "Avery",
                    "last_name": "Example",
                    "preferred_name": "Avery",
                    "source_system": "example_import",
                    "external_id": "participant-demo-001",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "sensitive_fields_omitted": true,
                    "relationships": {
                      "guardians": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-participants/10000000-0000-4000-8000-000000000009/guardians"
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event participant",
        "description": "Update participant core fields. A request touching email, phone, birth_date, accessibility_summary, or metadata additionally requires events:sensitive:write.",
        "operationId": "updateEventParticipant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "preferred_name": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "preferred_name"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "preferred_name": "Avery"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event participant response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000009",
                    "object": "event_participant",
                    "customer_id": null,
                    "participant_type": "camper",
                    "status": "active",
                    "first_name": "Avery",
                    "last_name": "Example",
                    "preferred_name": "Avery",
                    "source_system": "example_import",
                    "external_id": "participant-demo-001",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "sensitive_fields_omitted": true,
                    "relationships": {
                      "guardians": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-participants/10000000-0000-4000-8000-000000000009/guardians"
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-conditional-scopes": [
          {
            "scope": "events:sensitive:write",
            "when": "The body touches email, phone, birth_date, accessibility_summary, or metadata."
          }
        ]
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event participant",
        "description": "Archive an event participant",
        "operationId": "archiveEventParticipant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event participant response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000009",
                    "object": "event_participant",
                    "customer_id": null,
                    "participant_type": "camper",
                    "status": "archived",
                    "first_name": "Avery",
                    "last_name": "Example",
                    "preferred_name": "Avery",
                    "source_system": "example_import",
                    "external_id": "participant-demo-001",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "sensitive_fields_omitted": true,
                    "relationships": {
                      "guardians": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-participants/10000000-0000-4000-8000-000000000009/guardians"
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-participants/{participant_id}/guardians": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List participant guardians",
        "description": "Cursor-page explicit guardian relationships for the participant.",
        "operationId": "listEventParticipantGuardians",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List participant guardians response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantGuardianPage"
                },
                "example": {
                  "data": [
                    {
                      "object": "event_participant_guardian",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "guardian_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                      "relationship_label": "Parent/Guardian",
                      "is_primary": true,
                      "portal_visible": true,
                      "portal_authorized": true,
                      "can_manage_registration": true,
                      "can_receive_notifications": true,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_guardians",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Link a participant guardian",
        "description": "Link a participant guardian",
        "operationId": "createEventParticipantGuardian",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "guardian_customer_id": {
                    "type": "string"
                  },
                  "relationship_label": {
                    "type": "string"
                  },
                  "is_primary": {
                    "type": "boolean"
                  },
                  "portal_visible": {
                    "type": "boolean"
                  },
                  "portal_authorized": {
                    "type": "boolean"
                  },
                  "can_manage_registration": {
                    "type": "boolean"
                  },
                  "can_receive_notifications": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "guardian_customer_id",
                  "relationship_label",
                  "is_primary",
                  "portal_visible",
                  "portal_authorized",
                  "can_manage_registration",
                  "can_receive_notifications"
                ],
                "additionalProperties": false
              },
              "example": {
                "guardian_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                "relationship_label": "Parent/Guardian",
                "is_primary": true,
                "portal_visible": true,
                "portal_authorized": true,
                "can_manage_registration": true,
                "can_receive_notifications": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Link a participant guardian response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantGuardianEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_participant_guardian",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "guardian_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "relationship_label": "Parent/Guardian",
                    "is_primary": true,
                    "portal_visible": true,
                    "portal_authorized": true,
                    "can_manage_registration": true,
                    "can_receive_notifications": true,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_guardian_link",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-participants/{participant_id}/guardians/{guardian_customer_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a participant guardian link",
        "description": "Get a participant guardian link",
        "operationId": "getEventParticipantGuardian",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "guardian_customer_id",
            "in": "path",
            "required": true,
            "description": "Opaque guardian customer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a participant guardian link response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantGuardianEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_participant_guardian",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "guardian_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "relationship_label": "Parent/Guardian",
                    "is_primary": true,
                    "portal_visible": true,
                    "portal_authorized": true,
                    "can_manage_registration": true,
                    "can_receive_notifications": true,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_guardian",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update a participant guardian",
        "description": "Update a participant guardian",
        "operationId": "updateEventParticipantGuardian",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "guardian_customer_id",
            "in": "path",
            "required": true,
            "description": "Opaque guardian customer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "portal_authorized": {
                    "type": "boolean"
                  },
                  "can_manage_registration": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "portal_authorized",
                  "can_manage_registration"
                ],
                "additionalProperties": false
              },
              "example": {
                "portal_authorized": true,
                "can_manage_registration": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a participant guardian response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantGuardianEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_participant_guardian",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "guardian_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "relationship_label": "Parent/Guardian",
                    "is_primary": true,
                    "portal_visible": true,
                    "portal_authorized": true,
                    "can_manage_registration": true,
                    "can_receive_notifications": true,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_guardian_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Unlink a participant guardian",
        "description": "Unlink a participant guardian",
        "operationId": "deleteEventParticipantGuardian",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "guardian_customer_id",
            "in": "path",
            "required": true,
            "description": "Opaque guardian customer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-registration-forms": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event registration forms",
        "description": "List event registration forms",
        "operationId": "listEventRegistrationForms",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event registration forms response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationFormPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000020",
                      "object": "event_registration_form",
                      "form_key": "camp-registration",
                      "version_number": 1,
                      "name": "Camp registration details",
                      "status": "published",
                      "completion_scope": "participant",
                      "instructions_html": "<p>Complete once for each attendee.</p>",
                      "settings": {
                        "show_progress": true
                      },
                      "content_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_forms",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event registration form",
        "description": "Create a versioned form definition. Form answers are separate registration resources and are never public publication assets.",
        "operationId": "createEventRegistrationForm",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "form_key": {
                    "type": "string"
                  },
                  "version_number": {
                    "type": "integer"
                  },
                  "name": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "completion_scope": {
                    "type": "string"
                  },
                  "instructions_html": {
                    "type": "string"
                  },
                  "settings": {
                    "type": "object",
                    "properties": {
                      "show_progress": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "show_progress"
                    ],
                    "additionalProperties": false
                  },
                  "content_hash": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "form_key",
                  "version_number",
                  "name",
                  "status",
                  "completion_scope",
                  "instructions_html",
                  "settings",
                  "content_hash",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "form_key": "camp-registration",
                "version_number": 1,
                "name": "Camp registration details",
                "status": "published",
                "completion_scope": "participant",
                "instructions_html": "<p>Complete once for each attendee.</p>",
                "settings": {
                  "show_progress": true
                },
                "content_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                "source_system": "example_integration",
                "external_id": "registration-form-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event registration form response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationFormEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000020",
                    "object": "event_registration_form",
                    "form_key": "camp-registration",
                    "version_number": 1,
                    "name": "Camp registration details",
                    "status": "published",
                    "completion_scope": "participant",
                    "instructions_html": "<p>Complete once for each attendee.</p>",
                    "settings": {
                      "show_progress": true
                    },
                    "content_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_form_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-registration-forms/{form_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event registration form",
        "description": "Get an event registration form",
        "operationId": "getEventRegistrationForm",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "form_id",
            "in": "path",
            "required": true,
            "description": "Opaque form id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event registration form response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationFormEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000020",
                    "object": "event_registration_form",
                    "form_key": "camp-registration",
                    "version_number": 1,
                    "name": "Camp registration details",
                    "status": "published",
                    "completion_scope": "participant",
                    "instructions_html": "<p>Complete once for each attendee.</p>",
                    "settings": {
                      "show_progress": true
                    },
                    "content_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "questions": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-registration-forms/10000000-0000-4000-8000-000000000020/questions"
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_form",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event registration form",
        "description": "Update an event registration form",
        "operationId": "updateEventRegistrationForm",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "form_id",
            "in": "path",
            "required": true,
            "description": "Opaque form id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  },
                  "instructions_html": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "status",
                  "instructions_html"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "status": "published",
                "instructions_html": "<p>Complete once for each attendee before arrival.</p>"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event registration form response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationFormEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000020",
                    "object": "event_registration_form",
                    "form_key": "camp-registration",
                    "version_number": 1,
                    "name": "Camp registration details",
                    "status": "published",
                    "completion_scope": "participant",
                    "instructions_html": "<p>Complete once for each attendee.</p>",
                    "settings": {
                      "show_progress": true
                    },
                    "content_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_form_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Retire an event registration form",
        "description": "Retire an event registration form",
        "operationId": "retireEventRegistrationForm",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "form_id",
            "in": "path",
            "required": true,
            "description": "Opaque form id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Retire an event registration form response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationFormEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000020",
                    "object": "event_registration_form",
                    "form_key": "camp-registration",
                    "version_number": 1,
                    "name": "Camp registration details",
                    "status": "retired",
                    "completion_scope": "participant",
                    "instructions_html": "<p>Complete once for each attendee.</p>",
                    "settings": {
                      "show_progress": true
                    },
                    "content_hash": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_form_retire",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-registration-forms/{form_id}/questions": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event registration questions",
        "description": "List event registration questions",
        "operationId": "listEventRegistrationQuestions",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "form_id",
            "in": "path",
            "required": true,
            "description": "Opaque form id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event registration questions response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationQuestionPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000021",
                      "object": "event_registration_question",
                      "form_id": "10000000-0000-4000-8000-000000000020",
                      "question_key": "shirt_size",
                      "label": "T-shirt size",
                      "help_text": "Choose the size to prepare for this attendee.",
                      "response_scope": "participant",
                      "field_type": "single_select",
                      "options": [
                        {
                          "value": "youth_m",
                          "label": "Youth M"
                        },
                        {
                          "value": "youth_l",
                          "label": "Youth L"
                        }
                      ],
                      "required": true,
                      "conditional_logic": {},
                      "privacy_class": "standard",
                      "retention_days": 365,
                      "report_key": "merchandise.shirt_size",
                      "sort_order": 10,
                      "status": "active",
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_questions",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event registration question",
        "description": "Create an event registration question",
        "operationId": "createEventRegistrationQuestion",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "form_id",
            "in": "path",
            "required": true,
            "description": "Opaque form id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "question_key": {
                    "type": "string"
                  },
                  "label": {
                    "type": "string"
                  },
                  "help_text": {
                    "type": "string"
                  },
                  "response_scope": {
                    "type": "string"
                  },
                  "field_type": {
                    "type": "string"
                  },
                  "options": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "value": {
                          "type": "string"
                        },
                        "label": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "value",
                        "label"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": {
                    "type": "boolean"
                  },
                  "conditional_logic": {
                    "type": "object",
                    "properties": {},
                    "required": [],
                    "additionalProperties": false
                  },
                  "privacy_class": {
                    "type": "string"
                  },
                  "retention_days": {
                    "type": "integer"
                  },
                  "report_key": {
                    "type": "string"
                  },
                  "sort_order": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "question_key",
                  "label",
                  "help_text",
                  "response_scope",
                  "field_type",
                  "options",
                  "required",
                  "conditional_logic",
                  "privacy_class",
                  "retention_days",
                  "report_key",
                  "sort_order",
                  "status",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "question_key": "shirt_size",
                "label": "T-shirt size",
                "help_text": "Choose the size to prepare for this attendee.",
                "response_scope": "participant",
                "field_type": "single_select",
                "options": [
                  {
                    "value": "youth_m",
                    "label": "Youth M"
                  },
                  {
                    "value": "youth_l",
                    "label": "Youth L"
                  }
                ],
                "required": true,
                "conditional_logic": {},
                "privacy_class": "standard",
                "retention_days": 365,
                "report_key": "merchandise.shirt_size",
                "sort_order": 10,
                "status": "active",
                "source_system": "example_integration",
                "external_id": "registration-question-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event registration question response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationQuestionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000021",
                    "object": "event_registration_question",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "question_key": "shirt_size",
                    "label": "T-shirt size",
                    "help_text": "Choose the size to prepare for this attendee.",
                    "response_scope": "participant",
                    "field_type": "single_select",
                    "options": [
                      {
                        "value": "youth_m",
                        "label": "Youth M"
                      },
                      {
                        "value": "youth_l",
                        "label": "Youth L"
                      }
                    ],
                    "required": true,
                    "conditional_logic": {},
                    "privacy_class": "standard",
                    "retention_days": 365,
                    "report_key": "merchandise.shirt_size",
                    "sort_order": 10,
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_question_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-registration-questions/{question_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event registration question",
        "description": "Get an event registration question",
        "operationId": "getEventRegistrationQuestion",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "question_id",
            "in": "path",
            "required": true,
            "description": "Opaque question id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event registration question response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationQuestionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000021",
                    "object": "event_registration_question",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "question_key": "shirt_size",
                    "label": "T-shirt size",
                    "help_text": "Choose the size to prepare for this attendee.",
                    "response_scope": "participant",
                    "field_type": "single_select",
                    "options": [
                      {
                        "value": "youth_m",
                        "label": "Youth M"
                      },
                      {
                        "value": "youth_l",
                        "label": "Youth L"
                      }
                    ],
                    "required": true,
                    "conditional_logic": {},
                    "privacy_class": "standard",
                    "retention_days": 365,
                    "report_key": "merchandise.shirt_size",
                    "sort_order": 10,
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_question",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event registration question",
        "description": "Update an event registration question",
        "operationId": "updateEventRegistrationQuestion",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "question_id",
            "in": "path",
            "required": true,
            "description": "Opaque question id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "label": {
                    "type": "string"
                  },
                  "report_key": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "label",
                  "report_key"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "label": "Camper T-shirt size",
                "report_key": "merchandise.shirt_size"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event registration question response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationQuestionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000021",
                    "object": "event_registration_question",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "question_key": "shirt_size",
                    "label": "Camper T-shirt size",
                    "help_text": "Choose the size to prepare for this attendee.",
                    "response_scope": "participant",
                    "field_type": "single_select",
                    "options": [
                      {
                        "value": "youth_m",
                        "label": "Youth M"
                      },
                      {
                        "value": "youth_l",
                        "label": "Youth L"
                      }
                    ],
                    "required": true,
                    "conditional_logic": {},
                    "privacy_class": "standard",
                    "retention_days": 365,
                    "report_key": "merchandise.shirt_size",
                    "sort_order": 10,
                    "status": "active",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_question_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Deactivate an event registration question",
        "description": "Deactivate an event registration question",
        "operationId": "deactivateEventRegistrationQuestion",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "question_id",
            "in": "path",
            "required": true,
            "description": "Opaque question id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Deactivate an event registration question response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationQuestionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000021",
                    "object": "event_registration_question",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "question_key": "shirt_size",
                    "label": "T-shirt size",
                    "help_text": "Choose the size to prepare for this attendee.",
                    "response_scope": "participant",
                    "field_type": "single_select",
                    "options": [
                      {
                        "value": "youth_m",
                        "label": "Youth M"
                      },
                      {
                        "value": "youth_l",
                        "label": "Youth L"
                      }
                    ],
                    "required": true,
                    "conditional_logic": {},
                    "privacy_class": "standard",
                    "retention_days": 365,
                    "report_key": "merchandise.shirt_size",
                    "sort_order": 10,
                    "status": "inactive",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_question_deactivate",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/form-assignments": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event form assignments",
        "description": "List event form assignments",
        "operationId": "listEventFormAssignments",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event form assignments response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventFormAssignmentPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000022",
                      "object": "event_form_assignment",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "form_id": "10000000-0000-4000-8000-000000000020",
                      "stage": "registration",
                      "required": true,
                      "sort_order": 10,
                      "created_at": "2026-08-25T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_form_assignments",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Assign a registration form",
        "description": "Assign a registration form",
        "operationId": "createEventFormAssignment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "form_id": {
                    "type": "string"
                  },
                  "stage": {
                    "type": "string"
                  },
                  "required": {
                    "type": "boolean"
                  },
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "ticket_option_id",
                  "form_id",
                  "stage",
                  "required",
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "form_id": "10000000-0000-4000-8000-000000000020",
                "stage": "registration",
                "required": true,
                "sort_order": 10
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Assign a registration form response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventFormAssignmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000022",
                    "object": "event_form_assignment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "stage": "registration",
                    "required": true,
                    "sort_order": 10,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_form_assignment_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-form-assignments/{form_assignment_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a form assignment",
        "description": "Get a form assignment",
        "operationId": "getEventFormAssignment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "form_assignment_id",
            "in": "path",
            "required": true,
            "description": "Opaque form assignment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a form assignment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventFormAssignmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000022",
                    "object": "event_form_assignment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "stage": "registration",
                    "required": true,
                    "sort_order": 10,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_form_assignment",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update a form assignment",
        "description": "Update a form assignment",
        "operationId": "updateEventFormAssignment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "form_assignment_id",
            "in": "path",
            "required": true,
            "description": "Opaque form assignment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "stage": {
                    "type": "string"
                  },
                  "required": {
                    "type": "boolean"
                  },
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "stage",
                  "required",
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "stage": "attendee_portal",
                "required": true,
                "sort_order": 20
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a form assignment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventFormAssignmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000022",
                    "object": "event_form_assignment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "stage": "attendee_portal",
                    "required": true,
                    "sort_order": 20,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_form_assignment_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Delete a form assignment",
        "description": "Delete a form assignment",
        "operationId": "deleteEventFormAssignment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "form_assignment_id",
            "in": "path",
            "required": true,
            "description": "Opaque form assignment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-waivers": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event waivers",
        "description": "List event waivers",
        "operationId": "listEventWaivers",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event waivers response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000023",
                      "object": "event_waiver",
                      "waiver_key": "camp-participation",
                      "version_number": 1,
                      "title": "Synthetic camp participation agreement",
                      "content_html": "<p>Synthetic agreement content for API documentation only.</p>",
                      "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                      "status": "published",
                      "required": true,
                      "effective_at": "2026-08-25T13:00:00Z",
                      "expires_at": null,
                      "source_system": "centripos",
                      "external_id": null,
                      "created_at": "2026-08-25T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waivers",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event waiver",
        "description": "Create immutable versioned waiver content identified by its SHA-256 content hash.",
        "operationId": "createEventWaiver",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "waiver_key": {
                    "type": "string"
                  },
                  "version_number": {
                    "type": "integer"
                  },
                  "title": {
                    "type": "string"
                  },
                  "content_html": {
                    "type": "string"
                  },
                  "content_hash": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "required": {
                    "type": "boolean"
                  },
                  "effective_at": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "waiver_key",
                  "version_number",
                  "title",
                  "content_html",
                  "content_hash",
                  "status",
                  "required",
                  "effective_at",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "waiver_key": "camp-participation",
                "version_number": 1,
                "title": "Synthetic camp participation agreement",
                "content_html": "<p>Synthetic agreement content for API documentation only.</p>",
                "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                "status": "published",
                "required": true,
                "effective_at": "2026-08-25T13:00:00Z",
                "source_system": "example_integration",
                "external_id": "waiver-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event waiver response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000023",
                    "object": "event_waiver",
                    "waiver_key": "camp-participation",
                    "version_number": 1,
                    "title": "Synthetic camp participation agreement",
                    "content_html": "<p>Synthetic agreement content for API documentation only.</p>",
                    "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "status": "published",
                    "required": true,
                    "effective_at": "2026-08-25T13:00:00Z",
                    "expires_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-waivers/{waiver_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event waiver",
        "description": "Get an event waiver",
        "operationId": "getEventWaiver",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waiver_id",
            "in": "path",
            "required": true,
            "description": "Opaque waiver id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event waiver response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000023",
                    "object": "event_waiver",
                    "waiver_key": "camp-participation",
                    "version_number": 1,
                    "title": "Synthetic camp participation agreement",
                    "content_html": "<p>Synthetic agreement content for API documentation only.</p>",
                    "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "status": "published",
                    "required": true,
                    "effective_at": "2026-08-25T13:00:00Z",
                    "expires_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event waiver lifecycle",
        "description": "Update waiver lifecycle fields. Create a new waiver version for changed agreement content.",
        "operationId": "updateEventWaiver",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waiver_id",
            "in": "path",
            "required": true,
            "description": "Opaque waiver id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "required": {
                    "type": "boolean"
                  },
                  "effective_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "required",
                  "effective_at"
                ],
                "additionalProperties": false
              },
              "example": {
                "status": "published",
                "required": true,
                "effective_at": "2026-08-25T13:00:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event waiver lifecycle response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000023",
                    "object": "event_waiver",
                    "waiver_key": "camp-participation",
                    "version_number": 1,
                    "title": "Synthetic camp participation agreement",
                    "content_html": "<p>Synthetic agreement content for API documentation only.</p>",
                    "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "status": "published",
                    "required": true,
                    "effective_at": "2026-08-25T13:00:00Z",
                    "expires_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Retire an event waiver",
        "description": "Retire an event waiver",
        "operationId": "retireEventWaiver",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waiver_id",
            "in": "path",
            "required": true,
            "description": "Opaque waiver id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Retire an event waiver response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000023",
                    "object": "event_waiver",
                    "waiver_key": "camp-participation",
                    "version_number": 1,
                    "title": "Synthetic camp participation agreement",
                    "content_html": "<p>Synthetic agreement content for API documentation only.</p>",
                    "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "status": "retired",
                    "required": true,
                    "effective_at": "2026-08-25T13:00:00Z",
                    "expires_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_retire",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/waiver-assignments": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event waiver assignments",
        "description": "List event waiver assignments",
        "operationId": "listEventWaiverAssignments",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event waiver assignments response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverAssignmentPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000024",
                      "object": "event_waiver_assignment",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "waiver_id": "10000000-0000-4000-8000-000000000023",
                      "required": true,
                      "sort_order": 10,
                      "created_at": "2026-08-25T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_assignments",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Assign an event waiver",
        "description": "Assign an event waiver",
        "operationId": "createEventWaiverAssignment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "waiver_id": {
                    "type": "string"
                  },
                  "required": {
                    "type": "boolean"
                  },
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "ticket_option_id",
                  "waiver_id",
                  "required",
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "waiver_id": "10000000-0000-4000-8000-000000000023",
                "required": true,
                "sort_order": 10
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Assign an event waiver response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverAssignmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000024",
                    "object": "event_waiver_assignment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "waiver_id": "10000000-0000-4000-8000-000000000023",
                    "required": true,
                    "sort_order": 10,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_assignment_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-waiver-assignments/{waiver_assignment_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a waiver assignment",
        "description": "Get a waiver assignment",
        "operationId": "getEventWaiverAssignment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waiver_assignment_id",
            "in": "path",
            "required": true,
            "description": "Opaque waiver assignment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a waiver assignment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverAssignmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000024",
                    "object": "event_waiver_assignment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "waiver_id": "10000000-0000-4000-8000-000000000023",
                    "required": true,
                    "sort_order": 10,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_assignment",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update a waiver assignment",
        "description": "Update a waiver assignment",
        "operationId": "updateEventWaiverAssignment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waiver_assignment_id",
            "in": "path",
            "required": true,
            "description": "Opaque waiver assignment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "required": {
                    "type": "boolean"
                  },
                  "sort_order": {
                    "type": "integer"
                  }
                },
                "required": [
                  "required",
                  "sort_order"
                ],
                "additionalProperties": false
              },
              "example": {
                "required": true,
                "sort_order": 20
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a waiver assignment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverAssignmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000024",
                    "object": "event_waiver_assignment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "waiver_id": "10000000-0000-4000-8000-000000000023",
                    "required": true,
                    "sort_order": 20,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_assignment_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Delete a waiver assignment",
        "description": "Delete a waiver assignment",
        "operationId": "deleteEventWaiverAssignment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waiver_assignment_id",
            "in": "path",
            "required": true,
            "description": "Opaque waiver assignment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/events/{event_id}/registrations": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event registrations",
        "description": "List event registrations",
        "operationId": "listEventRegistrations",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "purchaser_customer_id",
            "in": "query",
            "required": false,
            "description": "Filter registrations by the opaque purchaser customer identifier.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event registrations response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000010",
                      "object": "event_registration",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "primary_participant_id": "10000000-0000-4000-8000-000000000009",
                      "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                      "sale_id": "30000000-0000-4000-8000-000000000001",
                      "sale_line_item_id": "30000000-0000-4000-8000-000000000002",
                      "registration_number": "REG-0000000421",
                      "status": "confirmed",
                      "seat_count": 1,
                      "amount_total": 595,
                      "currency": "USD",
                      "source_system": "centripos",
                      "external_id": null,
                      "registered_at": "2026-08-25T14:54:00Z",
                      "confirmed_at": "2026-08-25T15:00:00Z",
                      "cancelled_at": null,
                      "capacity_hold_expires_at": null,
                      "cancellation_reason": null,
                      "version": 2,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registrations",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event registration",
        "description": "Create a capacity-checked Pending registration and preserve purchaser, participant, ticket-option, sale, and integration identities. Confirmation is lifecycle-owned.",
        "operationId": "createEventRegistration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "primary_participant_id": {
                    "type": "string"
                  },
                  "purchaser_customer_id": {
                    "type": "string"
                  },
                  "seat_count": {
                    "type": "integer"
                  },
                  "amount_total": {
                    "type": "integer"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "ticket_option_id",
                  "primary_participant_id",
                  "purchaser_customer_id",
                  "seat_count",
                  "amount_total",
                  "currency",
                  "status",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "primary_participant_id": "10000000-0000-4000-8000-000000000009",
                "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                "seat_count": 1,
                "amount_total": 595,
                "currency": "USD",
                "status": "pending",
                "source_system": "example_integration",
                "external_id": "registration-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event registration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000010",
                    "object": "event_registration",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "primary_participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "sale_line_item_id": "30000000-0000-4000-8000-000000000002",
                    "registration_number": "REG-0000000421",
                    "status": "pending",
                    "seat_count": 1,
                    "amount_total": 595,
                    "currency": "USD",
                    "source_system": "centripos",
                    "external_id": null,
                    "registered_at": "2026-08-25T14:54:00Z",
                    "confirmed_at": null,
                    "cancelled_at": null,
                    "capacity_hold_expires_at": null,
                    "cancellation_reason": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event registration",
        "description": "Retrieve one bounded registration detail. Related participant, answer, ticket, attendance, portal, and requirement resources are represented by exact counts and canonical collection links rather than silently embedded unbounded arrays. Protected fields require their dedicated scopes.",
        "operationId": "getEventRegistration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event registration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000010",
                    "object": "event_registration",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "primary_participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "sale_line_item_id": "30000000-0000-4000-8000-000000000002",
                    "registration_number": "REG-0000000421",
                    "status": "confirmed",
                    "seat_count": 1,
                    "amount_total": 595,
                    "currency": "USD",
                    "source_system": "centripos",
                    "external_id": null,
                    "registered_at": "2026-08-25T14:54:00Z",
                    "confirmed_at": "2026-08-25T15:00:00Z",
                    "cancelled_at": null,
                    "capacity_hold_expires_at": null,
                    "cancellation_reason": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "primary_participant": {
                      "id": "10000000-0000-4000-8000-000000000009",
                      "object": "event_participant",
                      "customer_id": null,
                      "participant_type": "camper",
                      "status": "active",
                      "first_name": "Avery",
                      "last_name": "Example",
                      "preferred_name": "Avery",
                      "source_system": "example_import",
                      "external_id": "participant-demo-001",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "sensitive_fields_omitted": true
                    },
                    "sensitive_answers_omitted": true,
                    "attendance_evidence_omitted": false,
                    "completion": {
                      "forms_required": 1,
                      "forms_completed": 1,
                      "required_answers": 1,
                      "required_answers_completed": 1,
                      "waivers_required": 1,
                      "waivers_accepted": 1,
                      "is_complete": true
                    },
                    "relationships": {
                      "participants": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-registrations/10000000-0000-4000-8000-000000000010/participants"
                      },
                      "answers": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-registrations/10000000-0000-4000-8000-000000000010/answers",
                        "total_count": 2,
                        "omitted_count": 1,
                        "sensitive_fields_require_scope": "events:sensitive:read"
                      },
                      "tickets": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-registrations/10000000-0000-4000-8000-000000000010/tickets",
                        "required_scope": "events:credentials:read"
                      },
                      "checkins": {
                        "count": 1,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/checkins?registration_id=10000000-0000-4000-8000-000000000010",
                        "required_scope": "events:attendance:read"
                      },
                      "portal_access": {
                        "count": 1,
                        "collection": null
                      },
                      "requirements": {
                        "count": 2,
                        "collection": null
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event registration",
        "description": "Update external_id only, with optional optimistic version. Purchaser ownership, receipt and entitlement identity, amount, currency, status, participant, ticket option, seats, and capacity holds are lifecycle-owned and reject with 409 lifecycle_command_required.",
        "operationId": "updateEventRegistration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "external_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 240
                  }
                },
                "description": "Generic registration PATCH may change external_id only, with optional optimistic version. Purchaser ownership, entitlement, receipt identity, financial snapshots, status, participant, seats, and capacity holds are lifecycle-command owned and reject with lifecycle_command_required."
              },
              "example": {
                "version": 2,
                "external_id": "registration-demo-001"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event registration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000010",
                    "object": "event_registration",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "primary_participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "sale_line_item_id": "30000000-0000-4000-8000-000000000002",
                    "registration_number": "REG-0000000421",
                    "status": "confirmed",
                    "seat_count": 1,
                    "amount_total": 595,
                    "currency": "USD",
                    "source_system": "centripos",
                    "external_id": null,
                    "registered_at": "2026-08-25T14:54:00Z",
                    "confirmed_at": "2026-08-25T15:00:00Z",
                    "cancelled_at": null,
                    "capacity_hold_expires_at": null,
                    "cancellation_reason": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "primary_participant": {
                      "id": "10000000-0000-4000-8000-000000000009",
                      "object": "event_participant",
                      "customer_id": null,
                      "participant_type": "camper",
                      "status": "active",
                      "first_name": "Avery",
                      "last_name": "Example",
                      "preferred_name": "Avery",
                      "source_system": "example_import",
                      "external_id": "participant-demo-001",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "sensitive_fields_omitted": true
                    },
                    "sensitive_answers_omitted": true,
                    "attendance_evidence_omitted": false,
                    "completion": {
                      "forms_required": 1,
                      "forms_completed": 1,
                      "required_answers": 1,
                      "required_answers_completed": 1,
                      "waivers_required": 1,
                      "waivers_accepted": 1,
                      "is_complete": true
                    },
                    "relationships": {
                      "participants": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-registrations/10000000-0000-4000-8000-000000000010/participants"
                      },
                      "answers": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-registrations/10000000-0000-4000-8000-000000000010/answers",
                        "total_count": 2,
                        "omitted_count": 1,
                        "sensitive_fields_require_scope": "events:sensitive:read"
                      },
                      "tickets": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-registrations/10000000-0000-4000-8000-000000000010/tickets",
                        "required_scope": "events:credentials:read"
                      },
                      "checkins": {
                        "count": 1,
                        "collection": "/api/retail/v1/events/10000000-0000-4000-8000-000000000001/checkins?registration_id=10000000-0000-4000-8000-000000000010",
                        "required_scope": "events:attendance:read"
                      },
                      "portal_access": {
                        "count": 1,
                        "collection": null
                      },
                      "requirements": {
                        "count": 2,
                        "collection": null
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "description": "Purchaser ownership, receipt and entitlement identity, financial snapshots, status, participant, seats, and capacity holds are lifecycle-owned and reject generic PATCH.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                },
                "example": {
                  "error": {
                    "code": "lifecycle_command_required",
                    "message": "purchaser_customer_id is lifecycle-owned; use the dedicated receipt, workflow, assignment, transfer, confirmation, or cancellation command",
                    "request_id": "req_test_registration_lifecycle_command_required",
                    "details": []
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Cancel an event registration",
        "description": "Cancel the registration through the authoritative lifecycle command. A successful cancellation returns 204 with no response body.",
        "operationId": "cancelEventRegistration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/confirm": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Confirm an event registration",
        "description": "Idempotently confirm a non-receipt-backed Pending registration after its required purchaser and registration questions are complete. Receipt-backed confirmation remains owned by the payment lifecycle.",
        "operationId": "confirmEventRegistration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "expected_version": {
                    "type": "integer"
                  }
                },
                "required": [
                  "expected_version"
                ],
                "additionalProperties": false
              },
              "example": {
                "expected_version": 1
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Confirm an event registration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000010",
                    "object": "event_registration",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "primary_participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "sale_line_item_id": "30000000-0000-4000-8000-000000000002",
                    "registration_number": "REG-0000000421",
                    "status": "confirmed",
                    "seat_count": 1,
                    "amount_total": 595,
                    "currency": "USD",
                    "source_system": "centripos",
                    "external_id": null,
                    "registered_at": "2026-08-25T14:54:00Z",
                    "confirmed_at": "2026-08-25T15:00:00Z",
                    "cancelled_at": null,
                    "capacity_hold_expires_at": null,
                    "cancellation_reason": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_confirm",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/transfer": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Transfer an event registration",
        "description": "Atomically transfer the primary attendee, eligible tickets, selected or waitlisted occurrence enrollments, and active participant add-ons to one active participant while preserving registration and receipt identity.",
        "operationId": "transferEventRegistration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "participant_id": {
                    "type": "string"
                  },
                  "expected_version": {
                    "type": "integer"
                  }
                },
                "required": [
                  "participant_id",
                  "expected_version"
                ],
                "additionalProperties": false
              },
              "example": {
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "expected_version": 2
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Transfer an event registration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000010",
                    "object": "event_registration",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "primary_participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "sale_line_item_id": "30000000-0000-4000-8000-000000000002",
                    "registration_number": "REG-0000000421",
                    "status": "confirmed",
                    "seat_count": 1,
                    "amount_total": 595,
                    "currency": "USD",
                    "source_system": "centripos",
                    "external_id": null,
                    "registered_at": "2026-08-25T14:54:00Z",
                    "confirmed_at": "2026-08-25T15:00:00Z",
                    "cancelled_at": null,
                    "capacity_hold_expires_at": null,
                    "cancellation_reason": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "lifecycle_result": "transferred"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_transfer",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/assign-seat": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Assign one deferred registration seat",
        "description": "Atomically assign exactly one seat of a confirmed deferred group pass. The command creates or reuses a participant, links guardian authority when required, records answers and waiver evidence, validates occurrence selections, and splits a multi-seat pending credential into one attendee credential. identity_mode supports new_participant, purchaser_self, existing_customer, or existing_participant; raw participant or ticket PATCH cannot approximate this lifecycle.",
        "operationId": "assignEventRegistrationSeat",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "ticket_id": {
                    "type": "string"
                  },
                  "expected_version": {
                    "type": "integer"
                  },
                  "identity": {
                    "type": "object",
                    "properties": {
                      "identity_mode": {
                        "type": "string"
                      },
                      "participant_type": {
                        "type": "string"
                      },
                      "first_name": {
                        "type": "string"
                      },
                      "last_name": {
                        "type": "string"
                      },
                      "birth_date": {
                        "type": "string"
                      },
                      "guardian_customer_id": {
                        "type": "string"
                      },
                      "guardian_relationship_label": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "identity_mode",
                      "participant_type",
                      "first_name",
                      "last_name",
                      "birth_date",
                      "guardian_customer_id",
                      "guardian_relationship_label"
                    ],
                    "additionalProperties": false
                  },
                  "answers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "question_id": {
                          "type": "string"
                        },
                        "answer": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "question_id",
                        "answer"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "waivers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "waiver_id": {
                          "type": "string"
                        },
                        "content_hash": {
                          "type": "string"
                        },
                        "signer_name": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "waiver_id",
                        "content_hash",
                        "signer_name"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "occurrence_selections": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "occurrence_id": {
                          "type": "string"
                        },
                        "occurrence_instance_id": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "occurrence_id",
                        "occurrence_instance_id",
                        "status"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "ticket_id",
                  "expected_version",
                  "identity",
                  "answers",
                  "waivers",
                  "occurrence_selections"
                ],
                "additionalProperties": false
              },
              "example": {
                "ticket_id": "10000000-0000-4000-8000-000000000011",
                "expected_version": 2,
                "identity": {
                  "identity_mode": "new_participant",
                  "participant_type": "camper",
                  "first_name": "Avery",
                  "last_name": "Example",
                  "birth_date": "2015-04-10",
                  "guardian_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                  "guardian_relationship_label": "Parent/Guardian"
                },
                "answers": [
                  {
                    "question_id": "10000000-0000-4000-8000-000000000021",
                    "answer": "youth_m"
                  }
                ],
                "waivers": [
                  {
                    "waiver_id": "10000000-0000-4000-8000-000000000023",
                    "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "signer_name": "Synthetic Guardian"
                  }
                ],
                "occurrence_selections": [
                  {
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                    "status": "selected"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Assign one deferred registration seat response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationSeatAssignmentEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_registration_seat_assignment",
                    "registration": {
                      "id": "10000000-0000-4000-8000-000000000010",
                      "object": "event_registration",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "primary_participant_id": "10000000-0000-4000-8000-000000000009",
                      "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                      "sale_id": "30000000-0000-4000-8000-000000000001",
                      "sale_line_item_id": "30000000-0000-4000-8000-000000000002",
                      "registration_number": "REG-0000000421",
                      "status": "confirmed",
                      "seat_count": 1,
                      "amount_total": 595,
                      "currency": "USD",
                      "source_system": "centripos",
                      "external_id": null,
                      "registered_at": "2026-08-25T14:54:00Z",
                      "confirmed_at": "2026-08-25T15:00:00Z",
                      "cancelled_at": null,
                      "capacity_hold_expires_at": null,
                      "cancellation_reason": null,
                      "version": 2,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    },
                    "participant": {
                      "id": "10000000-0000-4000-8000-000000000009",
                      "object": "event_participant",
                      "customer_id": null,
                      "participant_type": "camper",
                      "status": "active",
                      "first_name": "Avery",
                      "last_name": "Example",
                      "preferred_name": "Avery",
                      "source_system": "example_import",
                      "external_id": "participant-demo-001",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "sensitive_fields_omitted": true,
                      "relationships": {
                        "guardians": {
                          "count": 1,
                          "collection": "/api/retail/v1/event-participants/10000000-0000-4000-8000-000000000009/guardians"
                        }
                      }
                    },
                    "ticket": {
                      "id": "10000000-0000-4000-8000-000000000011",
                      "object": "event_ticket",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "sequence_number": 1,
                      "seat_quantity": 1,
                      "status": "valid",
                      "source_system": "centripos",
                      "external_id": null,
                      "issued_at": "2026-08-25T15:00:00Z",
                      "expires_at": "2026-09-19T03:59:00Z",
                      "voided_at": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "credential_fields_omitted": true
                    },
                    "guardian_required": true,
                    "lifecycle_result": "assigned"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_seat_assignment",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-additional-required-scopes": [
          "events:credentials:write"
        ],
        "x-conditional-scopes": [
          {
            "scope": "events:sensitive:write",
            "when": "The identity contains protected participant fields or the body includes answers or waivers."
          }
        ]
      }
    },
    "/api/retail/v1/event-registration-payment-plans": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event registration payment plans",
        "description": "List read-only links between registrations and the authoritative receipt invoice plan. Both invoices:read and events:registrations:read are required. Monetary changes continue through existing receipt payment and invoice-plan commands.",
        "operationId": "listEventRegistrationPaymentPlans",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "registration_id",
            "in": "query",
            "required": false,
            "description": "Filter by registration id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "plan_id",
            "in": "query",
            "required": false,
            "description": "Filter by plan id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "policy_id",
            "in": "query",
            "required": false,
            "description": "Filter by policy id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "sale_id",
            "in": "query",
            "required": false,
            "description": "Filter by sale id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event registration payment plans response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationPaymentPlanPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000048",
                      "object": "event_registration_payment_plan",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "plan_id": "10000000-0000-4000-8000-000000000049",
                      "policy_id": "10000000-0000-4000-8000-000000000047",
                      "sale_id": "30000000-0000-4000-8000-000000000001",
                      "status": "active",
                      "deposit_amount_cents": 14875,
                      "scheduled_balance_cents": 44625,
                      "next_due_on": "2026-08-26",
                      "delinquent_since": null,
                      "completed_at": null,
                      "canceled_at": null,
                      "cancellation_reason": null,
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_payment_plans",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "invoices:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ],
        "x-additional-required-scopes": [
          "events:registrations:read"
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event receipt payment plan",
        "description": "Idempotently create the authoritative invoice and installment schedule for a tenant receipt that is already linked to at least one event registration and its matching event-ticket receipt line. Both events:registrations:write and invoices:write are required. HTTP 201 reports new work; a database-level replay may return 200. The response contains bounded, cancellation-reason-free registration links. This payment-adjacent command schedules the existing receipt balance; it never charges a saved method, creates a second event ledger, or marks a receipt or installment paid.",
        "operationId": "createEventRegistrationPaymentPlan",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "sale_id",
                  "starts_on",
                  "interval_unit",
                  "interval_count",
                  "installment_count"
                ],
                "properties": {
                  "sale_id": {
                    "type": "string",
                    "format": "uuid",
                    "description": "Authoritative tenant receipt linked to at least one event registration and its matching ticket receipt line."
                  },
                  "starts_on": {
                    "type": "string",
                    "format": "date"
                  },
                  "interval_unit": {
                    "type": "string",
                    "enum": [
                      "days",
                      "weeks",
                      "months"
                    ]
                  },
                  "interval_count": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 120
                  },
                  "installment_count": {
                    "type": "integer",
                    "minimum": 2,
                    "maximum": 120
                  },
                  "plan_name": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 160
                  }
                },
                "description": "Creates the authoritative invoice/installment plan for one event-backed receipt. It does not create a second event ledger, charge a card, or mark a receipt paid."
              },
              "example": {
                "sale_id": "30000000-0000-4000-8000-000000000001",
                "starts_on": "2026-08-26",
                "interval_unit": "weeks",
                "interval_count": 1,
                "installment_count": 3,
                "plan_name": "Robotics camp household plan"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Create an event receipt payment plan intermediate response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventReceiptPaymentPlanEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_receipt_payment_plan",
                    "plan_id": "10000000-0000-4000-8000-000000000049",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "invoice_id": "30000000-0000-4000-8000-000000000002",
                    "status": "active",
                    "receipt_status": "on_account",
                    "installment_count": 3,
                    "balance_cents": 44625,
                    "registration_payment_plan_count": 1,
                    "registration_payment_plans_truncated": false,
                    "registration_payment_plans": [
                      {
                        "id": "10000000-0000-4000-8000-000000000048",
                        "object": "event_registration_payment_plan",
                        "registration_id": "10000000-0000-4000-8000-000000000010",
                        "plan_id": "10000000-0000-4000-8000-000000000049",
                        "policy_id": "10000000-0000-4000-8000-000000000047",
                        "sale_id": "30000000-0000-4000-8000-000000000001",
                        "status": "active",
                        "deposit_amount_cents": 14875,
                        "scheduled_balance_cents": 44625,
                        "next_due_on": "2026-08-26",
                        "delinquent_since": null,
                        "completed_at": null,
                        "canceled_at": null,
                        "source_system": "centripos",
                        "external_id": null,
                        "version": 1,
                        "created_at": "2026-08-25T14:00:00Z",
                        "updated_at": "2026-08-25T15:00:00Z"
                      }
                    ],
                    "lifecycle_result": "created"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_receipt_payment_plan",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "201": {
            "description": "Create an event receipt payment plan response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventReceiptPaymentPlanEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_receipt_payment_plan",
                    "plan_id": "10000000-0000-4000-8000-000000000049",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "invoice_id": "30000000-0000-4000-8000-000000000002",
                    "status": "active",
                    "receipt_status": "on_account",
                    "installment_count": 3,
                    "balance_cents": 44625,
                    "registration_payment_plan_count": 1,
                    "registration_payment_plans_truncated": false,
                    "registration_payment_plans": [
                      {
                        "id": "10000000-0000-4000-8000-000000000048",
                        "object": "event_registration_payment_plan",
                        "registration_id": "10000000-0000-4000-8000-000000000010",
                        "plan_id": "10000000-0000-4000-8000-000000000049",
                        "policy_id": "10000000-0000-4000-8000-000000000047",
                        "sale_id": "30000000-0000-4000-8000-000000000001",
                        "status": "active",
                        "deposit_amount_cents": 14875,
                        "scheduled_balance_cents": 44625,
                        "next_due_on": "2026-08-26",
                        "delinquent_since": null,
                        "completed_at": null,
                        "canceled_at": null,
                        "source_system": "centripos",
                        "external_id": null,
                        "version": 1,
                        "created_at": "2026-08-25T14:00:00Z",
                        "updated_at": "2026-08-25T15:00:00Z"
                      }
                    ],
                    "lifecycle_result": "created"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_receipt_payment_plan",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-centripos-operation-class": "payment_adjacent",
        "x-additional-required-scopes": [
          "invoices:write"
        ]
      }
    },
    "/api/retail/v1/event-registration-payment-plans/{registration_payment_plan_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event registration payment plan",
        "description": "Retrieve the registration link, invoice billing plan, bounded installment schedule, safe policy snapshot, and cent-exact schedule totals. This resource is read only and requires both invoice and registration read scopes.",
        "operationId": "getEventRegistrationPaymentPlan",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_payment_plan_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration payment plan id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event registration payment plan response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationPaymentPlanEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000048",
                    "object": "event_registration_payment_plan",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "plan_id": "10000000-0000-4000-8000-000000000049",
                    "policy_id": "10000000-0000-4000-8000-000000000047",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "status": "active",
                    "deposit_amount_cents": 14875,
                    "scheduled_balance_cents": 44625,
                    "next_due_on": "2026-08-26",
                    "delinquent_since": null,
                    "completed_at": null,
                    "canceled_at": null,
                    "cancellation_reason": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "billing_plan": {
                      "id": "10000000-0000-4000-8000-000000000049",
                      "object": "invoice_billing_plan",
                      "invoice_sale_id": "30000000-0000-4000-8000-000000000001",
                      "name": "Robotics camp household plan",
                      "status": "active",
                      "currency_code": "USD",
                      "starts_on": "2026-08-26",
                      "ends_on": "2026-09-09",
                      "max_occurrences": 3,
                      "completed_occurrences": 0,
                      "next_action_on": "2026-08-26",
                      "auto_collect": false,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    },
                    "policy": {
                      "id": "10000000-0000-4000-8000-000000000047",
                      "object": "event_payment_plan_policy",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "code": "FULL-DAY-DEPOSIT",
                      "name": "25% deposit plus three weekly installments",
                      "description": "Synthetic household plan that reserves a camp seat after its deposit clears.",
                      "status": "active",
                      "customer_selectable": true,
                      "deposit_mode": "percentage",
                      "deposit_value": 25,
                      "remaining_installment_count": 3,
                      "interval_unit": "weeks",
                      "interval_count": 1,
                      "first_installment_delay_days": 1,
                      "final_due_days_before_start": 1,
                      "grace_period_days": 3,
                      "capacity_policy": "reserve_on_deposit",
                      "admission_policy": "active_plan_allowed",
                      "delinquency_policy": "manual_review",
                      "auto_collect_allowed": false,
                      "sort_order": 10,
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    },
                    "installments": [
                      {
                        "id": "10000000-0000-4000-8000-000000000050",
                        "object": "invoice_installment",
                        "sequence_no": 1,
                        "due_on": "2026-08-26",
                        "amount_cents": 14875,
                        "applied_amount_cents": 0,
                        "grace_expires_on": "2026-08-29",
                        "status": "scheduled",
                        "paid_at": null,
                        "created_at": "2026-08-25T14:00:00Z",
                        "updated_at": "2026-08-25T15:00:00Z"
                      },
                      {
                        "id": "10000000-0000-4000-8000-000000000051",
                        "object": "invoice_installment",
                        "sequence_no": 2,
                        "due_on": "2026-09-02",
                        "amount_cents": 14875,
                        "applied_amount_cents": 0,
                        "grace_expires_on": "2026-09-05",
                        "status": "scheduled",
                        "paid_at": null,
                        "created_at": "2026-08-25T14:00:00Z",
                        "updated_at": "2026-08-25T15:00:00Z"
                      },
                      {
                        "id": "10000000-0000-4000-8000-000000000052",
                        "object": "invoice_installment",
                        "sequence_no": 3,
                        "due_on": "2026-09-09",
                        "amount_cents": 14875,
                        "applied_amount_cents": 0,
                        "grace_expires_on": "2026-09-12",
                        "status": "scheduled",
                        "paid_at": null,
                        "created_at": "2026-08-25T14:00:00Z",
                        "updated_at": "2026-08-25T15:00:00Z"
                      }
                    ],
                    "totals": {
                      "scheduled_amount_cents": 44625,
                      "applied_amount_cents": 0,
                      "outstanding_amount_cents": 44625
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_payment_plan",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "invoices:read",
        "x-additional-required-scopes": [
          "events:registrations:read"
        ]
      }
    },
    "/api/retail/v1/event-registration-payment-plans/{registration_payment_plan_id}/pause": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Pause an event receipt payment plan",
        "description": "Idempotently pause the authoritative receipt plan. Both events:registrations:write and invoices:write are required. The optional reason is bounded to 1–1000 characters when supplied. The safe response omits cancellation_reason and reports requested_status, prior_status, and lifecycle_result. This command changes schedule lifecycle only; it neither records money nor authorizes automatic collection.",
        "operationId": "pauseEventRegistrationPaymentPlan",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_payment_plan_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration payment plan id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "reason": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "maxLength": 1000
                  }
                },
                "description": "Optional bounded staff audit reason. The command changes plan lifecycle state only and never records a payment."
              },
              "example": {
                "reason": "Household requested a temporary pause."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Pause an event receipt payment plan response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationPaymentPlanLifecycleEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000048",
                    "object": "event_registration_payment_plan",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "plan_id": "10000000-0000-4000-8000-000000000049",
                    "policy_id": "10000000-0000-4000-8000-000000000047",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "status": "paused",
                    "deposit_amount_cents": 14875,
                    "scheduled_balance_cents": 44625,
                    "next_due_on": "2026-08-26",
                    "delinquent_since": null,
                    "completed_at": null,
                    "canceled_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "requested_status": "paused",
                    "prior_status": "active",
                    "lifecycle_result": "changed"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_payment_plan_pause",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-centripos-operation-class": "payment_adjacent",
        "x-additional-required-scopes": [
          "invoices:write"
        ]
      }
    },
    "/api/retail/v1/event-registration-payment-plans/{registration_payment_plan_id}/resume": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Resume an event receipt payment plan",
        "description": "Idempotently resume the authoritative receipt plan. Both events:registrations:write and invoices:write are required. The response is cancellation-reason-free and reports requested_status, prior_status, and lifecycle_result. Resuming a schedule does not create consent to charge a card and does not mark any installment paid.",
        "operationId": "resumeEventRegistrationPaymentPlan",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_payment_plan_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration payment plan id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "reason": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "maxLength": 1000
                  }
                },
                "description": "Optional bounded staff audit reason. The command changes plan lifecycle state only and never records a payment."
              },
              "example": {
                "reason": "Household confirmed the remaining schedule."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resume an event receipt payment plan response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationPaymentPlanLifecycleEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000048",
                    "object": "event_registration_payment_plan",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "plan_id": "10000000-0000-4000-8000-000000000049",
                    "policy_id": "10000000-0000-4000-8000-000000000047",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "status": "active",
                    "deposit_amount_cents": 14875,
                    "scheduled_balance_cents": 44625,
                    "next_due_on": "2026-08-26",
                    "delinquent_since": null,
                    "completed_at": null,
                    "canceled_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "requested_status": "active",
                    "prior_status": "paused",
                    "lifecycle_result": "changed"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_payment_plan_resume",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-centripos-operation-class": "payment_adjacent",
        "x-additional-required-scopes": [
          "invoices:write"
        ]
      }
    },
    "/api/retail/v1/event-registration-payment-plans/{registration_payment_plan_id}/cancel": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Cancel an event receipt payment plan",
        "description": "Idempotently cancel the authoritative receipt plan while preserving receipt, payment, registration, and audit history. Both events:registrations:write and invoices:write are required. Cancellation changes plan lifecycle only: it does not refund, void, mark paid, or silently collect the remaining balance.",
        "operationId": "cancelEventRegistrationPaymentPlan",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_payment_plan_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration payment plan id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "reason": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "minLength": 1,
                    "maxLength": 1000
                  }
                },
                "description": "Optional bounded staff audit reason. The command changes plan lifecycle state only and never records a payment."
              },
              "example": {
                "reason": "Household ended the installment arrangement."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Cancel an event receipt payment plan response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationPaymentPlanLifecycleEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000048",
                    "object": "event_registration_payment_plan",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "plan_id": "10000000-0000-4000-8000-000000000049",
                    "policy_id": "10000000-0000-4000-8000-000000000047",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "status": "canceled",
                    "deposit_amount_cents": 14875,
                    "scheduled_balance_cents": 44625,
                    "next_due_on": "2026-08-26",
                    "delinquent_since": null,
                    "completed_at": null,
                    "canceled_at": "2026-08-25T15:00:00Z",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "requested_status": "canceled",
                    "prior_status": "active",
                    "lifecycle_result": "changed"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_payment_plan_cancel",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-centripos-operation-class": "payment_adjacent",
        "x-additional-required-scopes": [
          "invoices:write"
        ]
      }
    },
    "/api/retail/v1/event-registration-payment-plans/{registration_payment_plan_id}/send-customer-link": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event receipt customer payment link",
        "description": "Idempotently return a tenant-bound HTTPS CentriPOS receipt capability ready for the caller to deliver through an authorized channel. Both events:registrations:write and invoices:write are required. The response never exposes a raw token or cancellation reason. requested expires_minutes applies only when a new canonical link is needed; a reused live link retains its authoritative expires_at. A matching Idempotency-Key replay returns only the same unchanged still-live capability. Expiry, token rotation, plan completion or cancellation, remaining-balance drift, or installment amount/status drift fails closed; resolve the state and submit the intended current request with a new Idempotency-Key rather than accepting a stale capability. suggested_amount_cents is only a prefill on the ordinary receipt page, where the customer may choose that amount, the full balance, or another valid positive partial amount up to the balance. Returning a link does not send a message, charge a method, create consent, or mark anything paid.",
        "operationId": "sendEventRegistrationPaymentPlanCustomerLink",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_payment_plan_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration payment plan id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "installment_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "uuid",
                    "description": "Optional installment used to derive the suggested payment amount."
                  },
                  "expires_minutes": {
                    "type": "integer",
                    "minimum": 5,
                    "maximum": 10080,
                    "default": 60,
                    "description": "Requested lifetime only when a new canonical capability must be created. A reused live link keeps its existing expiry."
                  }
                },
                "description": "Returns a branded receipt capability ready for caller-controlled delivery. It does not send a message, charge a card, or mark any installment paid."
              },
              "example": {
                "installment_id": "10000000-0000-4000-8000-000000000050",
                "expires_minutes": 60
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Create an event receipt customer payment link response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationPaymentPlanCustomerLinkEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000048",
                    "object": "event_registration_payment_plan",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "plan_id": "10000000-0000-4000-8000-000000000049",
                    "policy_id": "10000000-0000-4000-8000-000000000047",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "status": "active",
                    "deposit_amount_cents": 14875,
                    "scheduled_balance_cents": 44625,
                    "next_due_on": "2026-08-26",
                    "delinquent_since": null,
                    "completed_at": null,
                    "canceled_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "customer_payment_link": {
                      "installment_id": "10000000-0000-4000-8000-000000000050",
                      "payment_url": "https://pos.getcentri.com/cart-40000000-0000-4000-8000-000000000001/receipt_test_capability?payment_amount=148.75",
                      "suggested_amount_cents": 14875,
                      "expires_at": "2026-08-25T16:00:00Z",
                      "link_reused": false,
                      "delivery_status": "ready_for_delivery"
                    },
                    "lifecycle_result": "created"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_payment_plan_customer_link",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-centripos-operation-class": "payment_adjacent",
        "x-additional-required-scopes": [
          "invoices:write"
        ]
      }
    },
    "/api/retail/v1/event-registration-payment-plans/{registration_payment_plan_id}/reinstate-admission": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Reinstate admission for a paid event receipt plan",
        "description": "Idempotently reinstate only registrations whose admission was explicitly released by the event payment-plan lifecycle. Both events:registrations:write and invoices:write are required, and the only request field is a nonblank 1–1000 character audit reason. The authoritative command requires a completed plan and enrollment, a current receipt balance of zero, and live capacity; it locks affected pools, selection groups, and physical seats before atomically confirming registrations, restoring preserved daypart or session occurrence enrollments and original available seat assignments, and restoring or issuing tickets. The response omits cancellation_reason and reports safe registrations_reinstated, occurrence_enrollments_reinstated, seats_reinstated, and tickets_issued counts. A matching Idempotency-Key replay returns lifecycle_result replayed and may return null counts rather than inventing work. It cannot record a payment.",
        "operationId": "reinstateEventRegistrationPaymentPlanAdmission",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_payment_plan_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration payment plan id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "reason"
                ],
                "properties": {
                  "reason": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 1000
                  }
                }
              },
              "example": {
                "reason": "Receipt paid in full; organizer verified remaining capacity."
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Reinstate admission for a paid event receipt plan response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationPaymentPlanAdmissionReinstatementEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000048",
                    "object": "event_registration_payment_plan",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "plan_id": "10000000-0000-4000-8000-000000000049",
                    "policy_id": "10000000-0000-4000-8000-000000000047",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "status": "completed",
                    "deposit_amount_cents": 14875,
                    "scheduled_balance_cents": 44625,
                    "next_due_on": "2026-08-26",
                    "delinquent_since": null,
                    "completed_at": null,
                    "canceled_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "admission_reinstatement": {
                      "lifecycle_result": "changed",
                      "registrations_reinstated": 1,
                      "occurrence_enrollments_reinstated": 3,
                      "seats_reinstated": 1,
                      "tickets_issued": 1
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_payment_plan_admission_reinstatement",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-centripos-operation-class": "payment_adjacent",
        "x-additional-required-scopes": [
          "invoices:write"
        ]
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/payment-plan": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get the payment plan for a registration",
        "description": "Retrieve the same read-only authoritative plan projection by registration ID. Both invoices:read and events:registrations:read are required. Sibling registrations can reference one shared receipt plan; integrations must deduplicate by plan_id or sale_id before totaling balances.",
        "operationId": "getEventRegistrationPaymentPlanForRegistration",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get the payment plan for a registration response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationPaymentPlanEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000048",
                    "object": "event_registration_payment_plan",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "plan_id": "10000000-0000-4000-8000-000000000049",
                    "policy_id": "10000000-0000-4000-8000-000000000047",
                    "sale_id": "30000000-0000-4000-8000-000000000001",
                    "status": "active",
                    "deposit_amount_cents": 14875,
                    "scheduled_balance_cents": 44625,
                    "next_due_on": "2026-08-26",
                    "delinquent_since": null,
                    "completed_at": null,
                    "canceled_at": null,
                    "cancellation_reason": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "billing_plan": {
                      "id": "10000000-0000-4000-8000-000000000049",
                      "object": "invoice_billing_plan",
                      "invoice_sale_id": "30000000-0000-4000-8000-000000000001",
                      "name": "Robotics camp household plan",
                      "status": "active",
                      "currency_code": "USD",
                      "starts_on": "2026-08-26",
                      "ends_on": "2026-09-09",
                      "max_occurrences": 3,
                      "completed_occurrences": 0,
                      "next_action_on": "2026-08-26",
                      "auto_collect": false,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    },
                    "policy": {
                      "id": "10000000-0000-4000-8000-000000000047",
                      "object": "event_payment_plan_policy",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "code": "FULL-DAY-DEPOSIT",
                      "name": "25% deposit plus three weekly installments",
                      "description": "Synthetic household plan that reserves a camp seat after its deposit clears.",
                      "status": "active",
                      "customer_selectable": true,
                      "deposit_mode": "percentage",
                      "deposit_value": 25,
                      "remaining_installment_count": 3,
                      "interval_unit": "weeks",
                      "interval_count": 1,
                      "first_installment_delay_days": 1,
                      "final_due_days_before_start": 1,
                      "grace_period_days": 3,
                      "capacity_policy": "reserve_on_deposit",
                      "admission_policy": "active_plan_allowed",
                      "delinquency_policy": "manual_review",
                      "auto_collect_allowed": false,
                      "sort_order": 10,
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    },
                    "installments": [
                      {
                        "id": "10000000-0000-4000-8000-000000000050",
                        "object": "invoice_installment",
                        "sequence_no": 1,
                        "due_on": "2026-08-26",
                        "amount_cents": 14875,
                        "applied_amount_cents": 0,
                        "grace_expires_on": "2026-08-29",
                        "status": "scheduled",
                        "paid_at": null,
                        "created_at": "2026-08-25T14:00:00Z",
                        "updated_at": "2026-08-25T15:00:00Z"
                      },
                      {
                        "id": "10000000-0000-4000-8000-000000000051",
                        "object": "invoice_installment",
                        "sequence_no": 2,
                        "due_on": "2026-09-02",
                        "amount_cents": 14875,
                        "applied_amount_cents": 0,
                        "grace_expires_on": "2026-09-05",
                        "status": "scheduled",
                        "paid_at": null,
                        "created_at": "2026-08-25T14:00:00Z",
                        "updated_at": "2026-08-25T15:00:00Z"
                      },
                      {
                        "id": "10000000-0000-4000-8000-000000000052",
                        "object": "invoice_installment",
                        "sequence_no": 3,
                        "due_on": "2026-09-09",
                        "amount_cents": 14875,
                        "applied_amount_cents": 0,
                        "grace_expires_on": "2026-09-12",
                        "status": "scheduled",
                        "paid_at": null,
                        "created_at": "2026-08-25T14:00:00Z",
                        "updated_at": "2026-08-25T15:00:00Z"
                      }
                    ],
                    "totals": {
                      "scheduled_amount_cents": 44625,
                      "applied_amount_cents": 0,
                      "outstanding_amount_cents": 44625
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_payment_plan_by_registration",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "invoices:read",
        "x-additional-required-scopes": [
          "events:registrations:read"
        ]
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/participants": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List registration participants",
        "description": "Cursor-page registration-to-participant links with reusable participant projections. Protected participant fields require events:sensitive:read.",
        "operationId": "listEventRegistrationParticipants",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List registration participants response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationParticipantPage"
                },
                "example": {
                  "data": [
                    {
                      "object": "event_registration_participant",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "role": "primary",
                      "seat_quantity": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "participant": {
                        "id": "10000000-0000-4000-8000-000000000009",
                        "object": "event_participant",
                        "customer_id": null,
                        "participant_type": "camper",
                        "status": "active",
                        "first_name": "Avery",
                        "last_name": "Example",
                        "preferred_name": "Avery",
                        "source_system": "example_import",
                        "external_id": "participant-demo-001",
                        "version": 1,
                        "created_at": "2026-08-25T14:00:00Z",
                        "updated_at": "2026-08-25T15:00:00Z",
                        "sensitive_fields_omitted": true
                      }
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_participants",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Link a registration participant",
        "description": "This generic mutation route is registered only to fail closed. Use assign-seat, transfer, or cancellation commands.",
        "operationId": "createEventRegistrationParticipant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "participant_id": {
                    "type": "string"
                  },
                  "role": {
                    "type": "string"
                  },
                  "seat_quantity": {
                    "type": "integer"
                  }
                },
                "required": [
                  "participant_id",
                  "role",
                  "seat_quantity"
                ],
                "additionalProperties": false
              },
              "example": {
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "role": "primary",
                "seat_quantity": 1
              }
            }
          }
        },
        "responses": {
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "description": "Registration participant links are lifecycle-owned. Use assign-seat, transfer, or cancellation commands.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                },
                "example": {
                  "error": {
                    "code": "lifecycle_command_required",
                    "message": "Registration participant links are lifecycle-owned; use assign-seat, transfer, or cancellation commands",
                    "request_id": "req_test_lifecycle_command_required",
                    "details": []
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-centripos-lifecycle-guarded": true
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/participants/{participant_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a registration participant link",
        "description": "Get a registration participant link",
        "operationId": "getEventRegistrationParticipant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a registration participant link response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationParticipantEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_registration_participant",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "role": "primary",
                    "seat_quantity": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "participant": {
                      "id": "10000000-0000-4000-8000-000000000009",
                      "object": "event_participant",
                      "customer_id": null,
                      "participant_type": "camper",
                      "status": "active",
                      "first_name": "Avery",
                      "last_name": "Example",
                      "preferred_name": "Avery",
                      "source_system": "example_import",
                      "external_id": "participant-demo-001",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "sensitive_fields_omitted": true
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_participant",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update a registration participant link",
        "description": "This generic mutation route is registered only to fail closed. Use assign-seat, transfer, or cancellation commands.",
        "operationId": "updateEventRegistrationParticipant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "role": {
                    "type": "string"
                  },
                  "seat_quantity": {
                    "type": "integer"
                  }
                },
                "required": [
                  "role",
                  "seat_quantity"
                ],
                "additionalProperties": false
              },
              "example": {
                "role": "attendee",
                "seat_quantity": 1
              }
            }
          }
        },
        "responses": {
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "description": "Registration participant links are lifecycle-owned. Use assign-seat, transfer, or cancellation commands.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                },
                "example": {
                  "error": {
                    "code": "lifecycle_command_required",
                    "message": "Registration participant links are lifecycle-owned; use assign-seat, transfer, or cancellation commands",
                    "request_id": "req_test_lifecycle_command_required",
                    "details": []
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-centripos-lifecycle-guarded": true
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Unlink a registration participant",
        "description": "This generic mutation route is registered only to fail closed. Use assign-seat, transfer, or cancellation commands.",
        "operationId": "deleteEventRegistrationParticipant",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "participant_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "description": "Registration participant links are lifecycle-owned. Use assign-seat, transfer, or cancellation commands.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                },
                "example": {
                  "error": {
                    "code": "lifecycle_command_required",
                    "message": "Registration participant links are lifecycle-owned; use assign-seat, transfer, or cancellation commands",
                    "request_id": "req_test_lifecycle_command_required",
                    "details": []
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-centripos-lifecycle-guarded": true
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/participant-addons": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List participant add-ons",
        "description": "List receipt-linked product or variant units assigned to attendees. Financial snapshots are omitted unless the same key also has reports:read.",
        "operationId": "listEventParticipantAddons",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List participant add-ons response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantAddonPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000037",
                      "object": "event_participant_addon",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "sale_line_item_id": "30000000-0000-4000-8000-000000000001",
                      "product_id": "20000000-0000-4000-8000-000000000002",
                      "variant_id": "20000000-0000-4000-8000-000000000003",
                      "quantity": 1,
                      "returned_quantity": 0,
                      "currency": "USD",
                      "status": "assigned",
                      "fulfilled_at": null,
                      "returned_at": null,
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "reporting_fields_omitted": true
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_addons",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ],
        "x-conditional-scopes": [
          {
            "scope": "reports:read",
            "when": "The caller needs unit_price_snapshot and line_revenue_snapshot."
          }
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create a participant add-on assignment",
        "description": "Assign an existing receipt line, ordinary product or variant, and positive quantity to a participant. Receipt financial fields are accepted for the immutable assignment snapshot and omitted from the response without reports:read.",
        "operationId": "createEventParticipantAddon",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "participant_id": {
                    "type": "string"
                  },
                  "sale_line_item_id": {
                    "type": "string"
                  },
                  "product_id": {
                    "type": "string"
                  },
                  "variant_id": {
                    "type": "string"
                  },
                  "quantity": {
                    "type": "integer"
                  },
                  "unit_price_snapshot": {
                    "type": "integer"
                  },
                  "line_revenue_snapshot": {
                    "type": "integer"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "participant_id",
                  "sale_line_item_id",
                  "product_id",
                  "variant_id",
                  "quantity",
                  "unit_price_snapshot",
                  "line_revenue_snapshot",
                  "currency",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "sale_line_item_id": "30000000-0000-4000-8000-000000000001",
                "product_id": "20000000-0000-4000-8000-000000000002",
                "variant_id": "20000000-0000-4000-8000-000000000003",
                "quantity": 1,
                "unit_price_snapshot": 20,
                "line_revenue_snapshot": 20,
                "currency": "USD",
                "source_system": "example_integration",
                "external_id": "participant-addon-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a participant add-on assignment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantAddonEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000037",
                    "object": "event_participant_addon",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "sale_line_item_id": "30000000-0000-4000-8000-000000000001",
                    "product_id": "20000000-0000-4000-8000-000000000002",
                    "variant_id": "20000000-0000-4000-8000-000000000003",
                    "quantity": 1,
                    "returned_quantity": 0,
                    "currency": "USD",
                    "status": "assigned",
                    "fulfilled_at": null,
                    "returned_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "reporting_fields_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_addon_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-conditional-scopes": [
          {
            "scope": "reports:read",
            "when": "The response should include unit_price_snapshot and line_revenue_snapshot."
          }
        ]
      }
    },
    "/api/retail/v1/event-participant-addons/{participant_addon_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a participant add-on",
        "description": "Get a participant add-on",
        "operationId": "getEventParticipantAddon",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_addon_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant addon id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a participant add-on response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantAddonEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000037",
                    "object": "event_participant_addon",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "sale_line_item_id": "30000000-0000-4000-8000-000000000001",
                    "product_id": "20000000-0000-4000-8000-000000000002",
                    "variant_id": "20000000-0000-4000-8000-000000000003",
                    "quantity": 1,
                    "returned_quantity": 0,
                    "currency": "USD",
                    "status": "assigned",
                    "fulfilled_at": null,
                    "returned_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "reporting_fields_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_addon",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read",
        "x-conditional-scopes": [
          {
            "scope": "reports:read",
            "when": "The caller needs unit_price_snapshot and line_revenue_snapshot."
          }
        ]
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update participant add-on fulfillment",
        "description": "Update only fulfillment status or external_id. Quantity, return, receipt line, product, variant, participant, and financial snapshots are lifecycle-owned and reject generic mutation.",
        "operationId": "updateEventParticipantAddon",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_addon_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant addon id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "fulfilled_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "fulfilled_at"
                ],
                "additionalProperties": false
              },
              "example": {
                "status": "fulfilled",
                "fulfilled_at": "2026-09-14T16:00:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update participant add-on fulfillment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantAddonEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000037",
                    "object": "event_participant_addon",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "sale_line_item_id": "30000000-0000-4000-8000-000000000001",
                    "product_id": "20000000-0000-4000-8000-000000000002",
                    "variant_id": "20000000-0000-4000-8000-000000000003",
                    "quantity": 1,
                    "returned_quantity": 0,
                    "currency": "USD",
                    "status": "fulfilled",
                    "fulfilled_at": "2026-09-14T16:00:00Z",
                    "returned_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "reporting_fields_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_addon_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Cancel a participant add-on assignment",
        "description": "Cancel the attendee assignment without rewriting receipt- or return-owned quantities.",
        "operationId": "cancelEventParticipantAddon",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "participant_addon_id",
            "in": "path",
            "required": true,
            "description": "Opaque participant addon id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Cancel a participant add-on assignment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventParticipantAddonEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000037",
                    "object": "event_participant_addon",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "sale_line_item_id": "30000000-0000-4000-8000-000000000001",
                    "product_id": "20000000-0000-4000-8000-000000000002",
                    "variant_id": "20000000-0000-4000-8000-000000000003",
                    "quantity": 1,
                    "returned_quantity": 0,
                    "currency": "USD",
                    "status": "cancelled",
                    "fulfilled_at": null,
                    "returned_at": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "reporting_fields_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_participant_addon_cancel",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/occurrence-enrollments": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List occurrence enrollments",
        "description": "Cursor-page participant-level selections for optional or required occurrence enrollment under one registration.",
        "operationId": "listEventOccurrenceEnrollments",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List occurrence enrollments response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceEnrollmentPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000028",
                      "object": "event_occurrence_enrollment",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "status": "selected",
                      "seat_quantity": 1,
                      "source_system": "example_integration",
                      "external_id": "occurrence-enrollment-demo-001",
                      "selected_at": "2026-08-25T15:05:00Z",
                      "waitlisted_at": null,
                      "cancelled_at": null,
                      "attended_at": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_enrollments",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Select an event occurrence",
        "description": "Select or waitlist an entitled registered participant for one occurrence. The database validates the registration, participant, ticket-option entitlement, and occurrence-level capacity atomically; attended state can be written only by accepted admission evidence.",
        "operationId": "createEventOccurrenceEnrollment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "occurrence_id": {
                    "type": "string"
                  },
                  "occurrence_instance_id": {
                    "type": "string"
                  },
                  "participant_id": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "seat_quantity": {
                    "type": "integer"
                  },
                  "selected_at": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "occurrence_id",
                  "occurrence_instance_id",
                  "participant_id",
                  "status",
                  "seat_quantity",
                  "selected_at",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "occurrence_id": "10000000-0000-4000-8000-000000000002",
                "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "status": "selected",
                "seat_quantity": 1,
                "selected_at": "2026-08-25T15:05:00Z",
                "source_system": "example_integration",
                "external_id": "occurrence-enrollment-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Select an event occurrence response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceEnrollmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000028",
                    "object": "event_occurrence_enrollment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "status": "selected",
                    "seat_quantity": 1,
                    "source_system": "example_integration",
                    "external_id": "occurrence-enrollment-demo-001",
                    "selected_at": "2026-08-25T15:05:00Z",
                    "waitlisted_at": null,
                    "cancelled_at": null,
                    "attended_at": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_enrollment_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-occurrence-enrollments/{occurrence_enrollment_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an occurrence enrollment",
        "description": "Get an occurrence enrollment",
        "operationId": "getEventOccurrenceEnrollment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_enrollment_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence enrollment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an occurrence enrollment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceEnrollmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000028",
                    "object": "event_occurrence_enrollment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "status": "selected",
                    "seat_quantity": 1,
                    "source_system": "example_integration",
                    "external_id": "occurrence-enrollment-demo-001",
                    "selected_at": "2026-08-25T15:05:00Z",
                    "waitlisted_at": null,
                    "cancelled_at": null,
                    "attended_at": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_enrollment",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an occurrence enrollment",
        "description": "Change a selection among selected, waitlisted, or cancelled, subject to entitlement and occurrence-capacity enforcement. The attended state remains server-derived from admission evidence.",
        "operationId": "updateEventOccurrenceEnrollment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_enrollment_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence enrollment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "status": {
                    "type": "string"
                  },
                  "seat_quantity": {
                    "type": "integer"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "status",
                  "seat_quantity",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "status": "selected",
                "seat_quantity": 1,
                "external_id": "occurrence-enrollment-demo-001"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an occurrence enrollment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceEnrollmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000028",
                    "object": "event_occurrence_enrollment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "status": "selected",
                    "seat_quantity": 1,
                    "source_system": "example_integration",
                    "external_id": "occurrence-enrollment-demo-001",
                    "selected_at": "2026-08-25T15:05:00Z",
                    "waitlisted_at": null,
                    "cancelled_at": null,
                    "attended_at": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_enrollment_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Cancel an occurrence enrollment",
        "description": "Cancel the selection while preserving its participant-level history.",
        "operationId": "cancelEventOccurrenceEnrollment",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "occurrence_enrollment_id",
            "in": "path",
            "required": true,
            "description": "Opaque occurrence enrollment id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Cancel an occurrence enrollment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventOccurrenceEnrollmentEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000028",
                    "object": "event_occurrence_enrollment",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "status": "cancelled",
                    "seat_quantity": 1,
                    "source_system": "example_integration",
                    "external_id": "occurrence-enrollment-demo-001",
                    "selected_at": "2026-08-25T15:05:00Z",
                    "waitlisted_at": null,
                    "cancelled_at": "2026-08-26T12:00:00Z",
                    "attended_at": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_occurrence_enrollment_cancel",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/answers": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List registration answers",
        "description": "Cursor-page visible standard answers. Protected rows are omitted without events:sensitive:read, but the server advances the underlying cursor even when a privacy-filtered page has no visible data.",
        "operationId": "listEventRegistrationAnswers",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List registration answers response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationAnswerPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000027",
                      "object": "event_registration_answer",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "form_id": "10000000-0000-4000-8000-000000000020",
                      "question_id": "10000000-0000-4000-8000-000000000021",
                      "question_key": "shirt_size",
                      "question_label_snapshot": "T-shirt size",
                      "answer": "youth_m",
                      "is_sensitive": false,
                      "source_system": "centripos",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_answers",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50,
                    "sensitive_answers_omitted": true
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create or replace a registration answer",
        "description": "Upsert one answer by registration, participant, and question key. is_sensitive is server-derived from the referenced question; an unresolved question fails safe as sensitive and requires events:sensitive:write.",
        "operationId": "createEventRegistrationAnswer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "question_key",
                  "answer"
                ],
                "properties": {
                  "participant_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "uuid"
                  },
                  "form_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "uuid"
                  },
                  "question_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "uuid"
                  },
                  "question_key": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 120
                  },
                  "question_label_snapshot": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 500
                  },
                  "answer": {},
                  "source_system": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80
                  }
                },
                "description": "is_sensitive is server-derived from the referenced question; an unresolved question is treated as sensitive."
              },
              "example": {
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "form_id": "10000000-0000-4000-8000-000000000020",
                "question_id": "10000000-0000-4000-8000-000000000021",
                "question_key": "shirt_size",
                "question_label_snapshot": "T-shirt size",
                "answer": "youth_m",
                "source_system": "example_integration"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create or replace a registration answer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationAnswerEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000027",
                    "object": "event_registration_answer",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "question_id": "10000000-0000-4000-8000-000000000021",
                    "question_key": "shirt_size",
                    "question_label_snapshot": "T-shirt size",
                    "answer": "youth_m",
                    "is_sensitive": false,
                    "source_system": "centripos",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_answer_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-conditional-scopes": [
          {
            "scope": "events:sensitive:write",
            "when": "The referenced question is protected or cannot be resolved."
          }
        ]
      }
    },
    "/api/retail/v1/event-registration-answers/{answer_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a registration answer",
        "description": "Standard answers are returned with the registration-read scope. Protected answers are redacted unless the key also has events:sensitive:read.",
        "operationId": "getEventRegistrationAnswer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "answer_id",
            "in": "path",
            "required": true,
            "description": "Opaque answer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a registration answer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationAnswerEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000027",
                    "object": "event_registration_answer",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "question_id": "10000000-0000-4000-8000-000000000021",
                    "question_key": "shirt_size",
                    "question_label_snapshot": "T-shirt size",
                    "answer": "youth_m",
                    "is_sensitive": false,
                    "source_system": "centripos",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_answer",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update a registration answer",
        "description": "Update an answer. A protected existing answer additionally requires events:sensitive:write.",
        "operationId": "updateEventRegistrationAnswer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "answer_id",
            "in": "path",
            "required": true,
            "description": "Opaque answer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "answer": {
                    "type": "string"
                  },
                  "question_label_snapshot": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "answer",
                  "question_label_snapshot"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "answer": "youth_l",
                "question_label_snapshot": "T-shirt size"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a registration answer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationAnswerEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000027",
                    "object": "event_registration_answer",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "question_id": "10000000-0000-4000-8000-000000000021",
                    "question_key": "shirt_size",
                    "question_label_snapshot": "T-shirt size",
                    "answer": "youth_l",
                    "is_sensitive": false,
                    "source_system": "centripos",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_answer_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-conditional-scopes": [
          {
            "scope": "events:sensitive:write",
            "when": "The existing answer is protected."
          }
        ]
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Delete a registration answer",
        "description": "Delete an answer. A protected existing answer additionally requires events:sensitive:write.",
        "operationId": "deleteEventRegistrationAnswer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "answer_id",
            "in": "path",
            "required": true,
            "description": "Opaque answer id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write",
        "x-conditional-scopes": [
          {
            "scope": "events:sensitive:write",
            "when": "The existing answer is protected."
          }
        ]
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/form-completions": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List registration form completions",
        "description": "List server-maintained completion state for each registration form assignment without exposing the underlying answer values.",
        "operationId": "listEventRegistrationFormCompletions",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List registration form completions response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationFormCompletionPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000039",
                      "object": "event_registration_form_completion",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "assignment_id": "10000000-0000-4000-8000-000000000022",
                      "form_id": "10000000-0000-4000-8000-000000000020",
                      "is_complete": true,
                      "completion_revision": 1,
                      "completed_at": "2026-08-25T14:58:00Z",
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_form_completions",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      }
    },
    "/api/retail/v1/event-registration-form-completions/{form_completion_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a registration form completion",
        "description": "Retrieve one server-maintained form-completion state; protected answers remain on separately scoped answer resources.",
        "operationId": "getEventRegistrationFormCompletion",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "form_completion_id",
            "in": "path",
            "required": true,
            "description": "Opaque form completion id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a registration form completion response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationFormCompletionEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000039",
                    "object": "event_registration_form_completion",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "assignment_id": "10000000-0000-4000-8000-000000000022",
                    "form_id": "10000000-0000-4000-8000-000000000020",
                    "is_complete": true,
                    "completion_revision": 1,
                    "completed_at": "2026-08-25T14:58:00Z",
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_registration_form_completion",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/tickets": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event tickets",
        "description": "List operational ticket records behind events:credentials:read. pending_assignment is unassigned and non-admissible; only participant-bound, unexpired valid or used tickets carry an active scan credential.",
        "operationId": "listEventTickets",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event tickets response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000011",
                      "object": "event_ticket",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "sequence_number": 1,
                      "seat_quantity": 1,
                      "status": "valid",
                      "source_system": "centripos",
                      "external_id": null,
                      "issued_at": "2026-08-25T15:00:00Z",
                      "expires_at": "2026-09-19T03:59:00Z",
                      "voided_at": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "credential_fields_omitted": true
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_tickets",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Issue an event ticket",
        "description": "Issue a server-generated, high-entropy ticket credential. The service derives ticket option, sequence, status, and credential fields from the registration lifecycle.",
        "operationId": "createEventTicket",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "participant_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "uuid"
                  },
                  "seat_quantity": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100000
                  },
                  "expires_at": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time"
                  },
                  "source_system": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 80
                  },
                  "external_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 240
                  }
                },
                "description": "The service derives ticket option, sequence, status, and credential fields from the registration lifecycle."
              },
              "example": {
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "seat_quantity": 1,
                "expires_at": "2026-09-19T03:59:00Z",
                "source_system": "example_integration",
                "external_id": "ticket-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Issue an event ticket response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000011",
                    "object": "event_ticket",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "sequence_number": 1,
                    "seat_quantity": 1,
                    "status": "valid",
                    "source_system": "centripos",
                    "external_id": null,
                    "issued_at": "2026-08-25T15:00:00Z",
                    "expires_at": "2026-09-19T03:59:00Z",
                    "voided_at": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "credential_fields_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:write"
      }
    },
    "/api/retail/v1/event-tickets/{ticket_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event ticket credential",
        "description": "Retrieve one operational ticket through the credential-scoped API. ticket_code is active only for a participant-bound, unexpired valid or used ticket; pending_assignment, voided, transferred, and expired records are non-admissible.",
        "operationId": "getEventTicket",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event ticket credential response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketCredentialEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000011",
                    "object": "event_ticket",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "sequence_number": 1,
                    "seat_quantity": 1,
                    "status": "valid",
                    "source_system": "centripos",
                    "external_id": null,
                    "issued_at": "2026-08-25T15:00:00Z",
                    "expires_at": "2026-09-19T03:59:00Z",
                    "voided_at": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "ticket_code": "DEMO_TICKET_8M4RX2"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event ticket",
        "description": "Update only expires_at or external_id with optional optimistic version. Participant, ticket option, status, seat quantity, and credential changes use assignment, transfer, or revocation lifecycle commands.",
        "operationId": "updateEventTicket",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "expires_at": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time"
                  },
                  "external_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 240
                  }
                },
                "description": "Participant assignment, ticket option, status, seat quantity, and credential fields are lifecycle-command owned."
              },
              "example": {
                "version": 1,
                "expires_at": "2026-09-19T03:59:00Z",
                "external_id": "ticket-demo-001"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event ticket response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventTicketEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000011",
                    "object": "event_ticket",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "sequence_number": 1,
                    "seat_quantity": 1,
                    "status": "valid",
                    "source_system": "centripos",
                    "external_id": null,
                    "issued_at": "2026-08-25T15:00:00Z",
                    "expires_at": "2026-09-19T03:59:00Z",
                    "voided_at": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "credential_fields_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_ticket_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Void an event ticket",
        "description": "Void a ticket transactionally while preserving its immutable audit identity and admission evidence. Success returns 204 with no response body.",
        "operationId": "voidEventTicket",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "ticket_id",
            "in": "path",
            "required": true,
            "description": "Opaque ticket id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:credentials:write"
      }
    },
    "/api/retail/v1/event-registrations/{registration_id}/waiver-acceptances": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List waiver acceptances",
        "description": "List immutable waiver evidence. Signer identity, request evidence, and signature references require the dedicated sensitive-read scope.",
        "operationId": "listEventWaiverAcceptances",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List waiver acceptances response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverAcceptancePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000025",
                      "object": "event_waiver_acceptance",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "waiver_id": "10000000-0000-4000-8000-000000000023",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "signer_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                      "guardian_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                      "signer_name": "Jordan Example",
                      "consented_at": "2026-08-25T15:00:00Z",
                      "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                      "ip_hash": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
                      "user_agent": "Synthetic API documentation client",
                      "signature_reference": "synthetic-signature-reference",
                      "source_system": "example_integration",
                      "external_id": "waiver-acceptance-demo-001",
                      "created_at": "2026-08-25T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_acceptances",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:sensitive:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Record a waiver acceptance",
        "description": "Record consent against the exact versioned waiver content hash. This operation requires both events:sensitive:write and events:registrations:write. The response redacts signer evidence unless the same key also has events:sensitive:read.",
        "operationId": "createEventWaiverAcceptance",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "registration_id",
            "in": "path",
            "required": true,
            "description": "Opaque registration id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "waiver_id": {
                    "type": "string"
                  },
                  "participant_id": {
                    "type": "string"
                  },
                  "signer_customer_id": {
                    "type": "string"
                  },
                  "guardian_customer_id": {
                    "type": "string"
                  },
                  "signer_name": {
                    "type": "string"
                  },
                  "consented_at": {
                    "type": "string"
                  },
                  "content_hash": {
                    "type": "string"
                  },
                  "ip_hash": {
                    "type": "string"
                  },
                  "user_agent": {
                    "type": "string"
                  },
                  "signature_reference": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "waiver_id",
                  "participant_id",
                  "signer_customer_id",
                  "guardian_customer_id",
                  "signer_name",
                  "consented_at",
                  "content_hash",
                  "ip_hash",
                  "user_agent",
                  "signature_reference",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "waiver_id": "10000000-0000-4000-8000-000000000023",
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "signer_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                "guardian_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                "signer_name": "Jordan Example",
                "consented_at": "2026-08-25T15:00:00Z",
                "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                "ip_hash": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
                "user_agent": "Synthetic API documentation client",
                "signature_reference": "synthetic-signature-reference",
                "source_system": "example_integration",
                "external_id": "waiver-acceptance-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record a waiver acceptance response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverAcceptanceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000025",
                    "object": "event_waiver_acceptance",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "waiver_id": "10000000-0000-4000-8000-000000000023",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "consented_at": "2026-08-25T15:00:00Z",
                    "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "source_system": "example_integration",
                    "external_id": "waiver-acceptance-demo-001",
                    "created_at": "2026-08-25T14:00:00Z",
                    "sensitive_fields_omitted": true
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_acceptance_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:sensitive:write",
        "x-additional-required-scopes": [
          "events:registrations:write"
        ]
      }
    },
    "/api/retail/v1/event-waiver-acceptances/{waiver_acceptance_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a waiver acceptance",
        "description": "Get a waiver acceptance",
        "operationId": "getEventWaiverAcceptance",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waiver_acceptance_id",
            "in": "path",
            "required": true,
            "description": "Opaque waiver acceptance id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a waiver acceptance response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaiverAcceptanceEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000025",
                    "object": "event_waiver_acceptance",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "waiver_id": "10000000-0000-4000-8000-000000000023",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "signer_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "guardian_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "signer_name": "Jordan Example",
                    "consented_at": "2026-08-25T15:00:00Z",
                    "content_hash": "bbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                    "ip_hash": "cccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccccc",
                    "user_agent": "Synthetic API documentation client",
                    "signature_reference": "synthetic-signature-reference",
                    "source_system": "example_integration",
                    "external_id": "waiver-acceptance-demo-001",
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waiver_acceptance",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:sensitive:read"
      }
    },
    "/api/retail/v1/events/{event_id}/checkins": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event check-ins",
        "description": "List event check-ins",
        "operationId": "listEventCheckins",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "occurrence_id",
            "in": "query",
            "required": false,
            "description": "Filter by one opaque event occurrence identifier.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event check-ins response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventCheckinPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000012",
                      "object": "event_checkin",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                      "registration_id": "10000000-0000-4000-8000-000000000010",
                      "ticket_id": "10000000-0000-4000-8000-000000000011",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "direction": "in",
                      "result": "accepted",
                      "admitted_seat_quantity": 1,
                      "method": "api",
                      "denial_reason": null,
                      "checked_in_at": "2026-09-14T12:51:00Z",
                      "actor_profile_id": null,
                      "device_id": "scanner-demo-01",
                      "source_system": "example_integration",
                      "external_id": "checkin-demo-001",
                      "metadata": {},
                      "created_at": "2026-09-14T12:51:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_checkins",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Record event attendance",
        "description": "Atomically validate offering, registration, exact ticket and participant, occurrence entitlement, required session enrollment, lifecycle, capacity, and duplicate direction. Accepted admission returns 201. Denied or duplicate admission still commits immutable evidence, then returns safe 409 event_admission_not_accepted without credential or denial detail. An override requires events:attendance:override and a nonblank override_reason.",
        "operationId": "createEventCheckin",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "occurrence_id": {
                    "type": "string"
                  },
                  "occurrence_instance_id": {
                    "type": "string"
                  },
                  "registration_id": {
                    "type": "string"
                  },
                  "ticket_id": {
                    "type": "string"
                  },
                  "participant_id": {
                    "type": "string"
                  },
                  "direction": {
                    "type": "string"
                  },
                  "method": {
                    "type": "string"
                  },
                  "checked_in_at": {
                    "type": "string"
                  },
                  "device_id": {
                    "type": "string"
                  },
                  "override": {
                    "type": "boolean"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "occurrence_id",
                  "occurrence_instance_id",
                  "registration_id",
                  "ticket_id",
                  "participant_id",
                  "direction",
                  "method",
                  "checked_in_at",
                  "device_id",
                  "override",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "occurrence_id": "10000000-0000-4000-8000-000000000002",
                "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                "registration_id": "10000000-0000-4000-8000-000000000010",
                "ticket_id": "10000000-0000-4000-8000-000000000011",
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "direction": "in",
                "method": "api",
                "checked_in_at": "2026-09-14T12:51:00Z",
                "device_id": "scanner-demo-01",
                "override": false,
                "source_system": "example_integration",
                "external_id": "checkin-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Record event attendance response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventCheckinEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000012",
                    "object": "event_checkin",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "ticket_id": "10000000-0000-4000-8000-000000000011",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "direction": "in",
                    "result": "accepted",
                    "admitted_seat_quantity": 1,
                    "method": "api",
                    "denial_reason": null,
                    "checked_in_at": "2026-09-14T12:51:00Z",
                    "actor_profile_id": null,
                    "device_id": "scanner-demo-01",
                    "source_system": "example_integration",
                    "external_id": "checkin-demo-001",
                    "metadata": {},
                    "created_at": "2026-09-14T12:51:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_checkin_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "description": "The denied or duplicate attempt was committed as append-only evidence, but admission was not accepted. Only safe evidence identifiers, result, direction, admitted quantity, and time are returned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                },
                "example": {
                  "error": {
                    "code": "event_admission_not_accepted",
                    "message": "The admission attempt was recorded but was not accepted",
                    "request_id": "req_test_event_admission_conflict",
                    "details": [
                      {
                        "object": "event_checkin",
                        "id": "10000000-0000-4000-8000-000000000041",
                        "offering_id": "10000000-0000-4000-8000-000000000001",
                        "occurrence_id": "10000000-0000-4000-8000-000000000002",
                        "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                        "registration_id": "10000000-0000-4000-8000-000000000010",
                        "ticket_id": "10000000-0000-4000-8000-000000000011",
                        "participant_id": "10000000-0000-4000-8000-000000000009",
                        "direction": "in",
                        "result": "duplicate",
                        "admitted_seat_quantity": 0,
                        "checked_in_at": "2026-09-14T12:52:00Z"
                      }
                    ]
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:write",
        "x-conditional-scopes": [
          {
            "scope": "events:attendance:override",
            "when": "The body sets override=true; override_reason must also be nonblank."
          }
        ]
      }
    },
    "/api/retail/v1/events/{event_id}/checkins/batch": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Synchronize an offline check-in batch",
        "description": "Synchronize 1–500 scanner attempts under one device. The batch is intentionally partial and always reports each item as accepted or denied through its safe checkin.result, or as an error; one denied item never rolls back accepted peers. Returned rows strip credentials and denial detail.",
        "operationId": "synchronizeEventCheckinBatch",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "device_id",
                  "scans"
                ],
                "properties": {
                  "device_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 240
                  },
                  "scans": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 500,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "required": [
                        "client_scan_id",
                        "registration_id",
                        "checked_in_at"
                      ],
                      "properties": {
                        "client_scan_id": {
                          "type": "string",
                          "minLength": 8,
                          "maxLength": 160,
                          "pattern": "^[A-Za-z0-9_.:-]{8,160}$"
                        },
                        "registration_id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "occurrence_id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "uuid"
                        },
                        "occurrence_instance_id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "uuid"
                        },
                        "ticket_id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "uuid"
                        },
                        "participant_id": {
                          "type": [
                            "string",
                            "null"
                          ],
                          "format": "uuid"
                        },
                        "direction": {
                          "type": "string",
                          "enum": [
                            "in",
                            "out",
                            "void"
                          ],
                          "default": "in"
                        },
                        "method": {
                          "type": "string",
                          "enum": [
                            "qr",
                            "barcode",
                            "manual",
                            "api",
                            "kiosk",
                            "import"
                          ],
                          "default": "kiosk"
                        },
                        "checked_in_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "device_id": {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 240
                        }
                      }
                    }
                  }
                }
              },
              "example": {
                "device_id": "scanner-demo-01",
                "scans": [
                  {
                    "client_scan_id": "scanner-demo-01:000042",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                    "ticket_id": "10000000-0000-4000-8000-000000000011",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "direction": "in",
                    "method": "kiosk",
                    "checked_in_at": "2026-09-14T12:51:00Z"
                  },
                  {
                    "client_scan_id": "scanner-demo-01:000043",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "occurrence_id": "10000000-0000-4000-8000-000000000003",
                    "direction": "in",
                    "method": "kiosk",
                    "checked_in_at": "2026-09-14T12:52:00Z"
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Synchronize an offline check-in batch response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventCheckinBatchEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_checkin_batch",
                    "submitted": 2,
                    "synchronized": 2,
                    "results": [
                      {
                        "client_scan_id": "scanner-demo-01:000042",
                        "synchronized": true,
                        "checkin": {
                          "object": "event_checkin",
                          "id": "10000000-0000-4000-8000-000000000012",
                          "offering_id": "10000000-0000-4000-8000-000000000001",
                          "occurrence_id": "10000000-0000-4000-8000-000000000002",
                          "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                          "registration_id": "10000000-0000-4000-8000-000000000010",
                          "ticket_id": "10000000-0000-4000-8000-000000000011",
                          "participant_id": "10000000-0000-4000-8000-000000000009",
                          "direction": "in",
                          "result": "accepted",
                          "admitted_seat_quantity": 1,
                          "checked_in_at": "2026-09-14T12:51:00Z"
                        }
                      },
                      {
                        "client_scan_id": "scanner-demo-01:000043",
                        "synchronized": true,
                        "checkin": {
                          "object": "event_checkin",
                          "id": "10000000-0000-4000-8000-000000000041",
                          "offering_id": "10000000-0000-4000-8000-000000000001",
                          "occurrence_id": "10000000-0000-4000-8000-000000000002",
                          "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                          "registration_id": "10000000-0000-4000-8000-000000000010",
                          "ticket_id": "10000000-0000-4000-8000-000000000011",
                          "participant_id": "10000000-0000-4000-8000-000000000009",
                          "direction": "in",
                          "result": "duplicate",
                          "admitted_seat_quantity": 0,
                          "checked_in_at": "2026-09-14T12:52:00Z"
                        }
                      }
                    ]
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_checkin_batch",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:write"
      }
    },
    "/api/retail/v1/event-checkins/{checkin_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event check-in",
        "description": "Get an event check-in",
        "operationId": "getEventCheckin",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "checkin_id",
            "in": "path",
            "required": true,
            "description": "Opaque checkin id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event check-in response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventCheckinEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000012",
                    "object": "event_checkin",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000002",
                    "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                    "registration_id": "10000000-0000-4000-8000-000000000010",
                    "ticket_id": "10000000-0000-4000-8000-000000000011",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "direction": "in",
                    "result": "accepted",
                    "admitted_seat_quantity": 1,
                    "method": "api",
                    "denial_reason": null,
                    "checked_in_at": "2026-09-14T12:51:00Z",
                    "actor_profile_id": null,
                    "device_id": "scanner-demo-01",
                    "source_system": "example_integration",
                    "external_id": "checkin-demo-001",
                    "metadata": {},
                    "created_at": "2026-09-14T12:51:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_checkin",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:attendance:read"
      }
    },
    "/api/retail/v1/events/{event_id}/waitlist": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event waitlist entries",
        "description": "List event waitlist entries",
        "operationId": "listEventWaitlistEntries",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event waitlist entries response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaitlistPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000013",
                      "object": "event_waitlist_entry",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": "10000000-0000-4000-8000-000000000003",
                      "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                      "requested_seats": 1,
                      "status": "offered",
                      "priority": 0,
                      "position": 7,
                      "offered_at": "2026-08-25T15:00:00Z",
                      "offer_expires_at": "2026-08-26T15:00:00Z",
                      "accepted_registration_id": null,
                      "source_system": "centripos",
                      "external_id": null,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waitlist",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event waitlist entry",
        "description": "Create an event waitlist entry",
        "operationId": "createEventWaitlistEntry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "occurrence_id": {
                    "type": "string"
                  },
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "participant_id": {
                    "type": "string"
                  },
                  "purchaser_customer_id": {
                    "type": "string"
                  },
                  "requested_seats": {
                    "type": "integer"
                  },
                  "priority": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "occurrence_id",
                  "ticket_option_id",
                  "participant_id",
                  "purchaser_customer_id",
                  "requested_seats",
                  "priority",
                  "status",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "occurrence_id": "10000000-0000-4000-8000-000000000003",
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                "requested_seats": 1,
                "priority": 0,
                "status": "waiting",
                "source_system": "example_integration",
                "external_id": "waitlist-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event waitlist entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaitlistEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000013",
                    "object": "event_waitlist_entry",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000003",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "requested_seats": 1,
                    "status": "offered",
                    "priority": 0,
                    "position": 7,
                    "offered_at": "2026-08-25T15:00:00Z",
                    "offer_expires_at": "2026-08-26T15:00:00Z",
                    "accepted_registration_id": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waitlist_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/events/{event_id}/waitlist/offer-next": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Offer the next waitlist entry",
        "description": "Use the atomic idempotency-wrapped database command to requeue expired offers, lock and claim one eligible waiting entry by priority then queue position, and prevent concurrent callers from offering the same row. The response meta and object surface lifecycle_result, including replay.",
        "operationId": "offerNextEventWaitlistEntry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "occurrence_id": {
                    "type": "string"
                  },
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "offer_expires_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "occurrence_id",
                  "ticket_option_id",
                  "offer_expires_at"
                ],
                "additionalProperties": false
              },
              "example": {
                "occurrence_id": "10000000-0000-4000-8000-000000000003",
                "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                "offer_expires_at": "2026-08-26T15:00:00Z"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Offer the next waitlist entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaitlistEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000013",
                    "object": "event_waitlist_entry",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000003",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "requested_seats": 1,
                    "status": "offered",
                    "priority": 0,
                    "position": 7,
                    "offered_at": "2026-08-25T15:00:00Z",
                    "offer_expires_at": "2026-08-26T15:00:00Z",
                    "accepted_registration_id": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "lifecycle_result": "offered"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waitlist_offer_next",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-waitlist/{waitlist_entry_id}/accept": {
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Accept an event waitlist offer",
        "description": "Atomically lock the offered row and every active reserved capacity pool, reject missing or expired reservations, consume the reservations, create one registration, and link it back to the waitlist entry. A pending acceptance receives a 24-hour capacity hold; a confirmed acceptance issues tickets immediately. Replaying an already accepted entry returns its linked registration.",
        "operationId": "acceptEventWaitlistOffer",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waitlist_entry_id",
            "in": "path",
            "required": true,
            "description": "Opaque waitlist entry id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "registration_status": {
                    "type": "string"
                  },
                  "amount_total": {
                    "type": "integer"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "registration_status",
                  "amount_total",
                  "currency",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "registration_status": "pending",
                "amount_total": 595,
                "currency": "USD",
                "source_system": "example_integration",
                "external_id": "waitlist-acceptance-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Accept an event waitlist offer response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventRegistrationEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000010",
                    "object": "event_registration",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "primary_participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "sale_id": null,
                    "sale_line_item_id": null,
                    "registration_number": "REG-0000000421",
                    "status": "pending",
                    "seat_count": 1,
                    "amount_total": 595,
                    "currency": "USD",
                    "source_system": "example_integration",
                    "external_id": "waitlist-acceptance-demo-001",
                    "registered_at": "2026-08-25T14:54:00Z",
                    "confirmed_at": null,
                    "cancelled_at": null,
                    "capacity_hold_expires_at": "2026-08-27T15:00:00Z",
                    "cancellation_reason": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waitlist_accept",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/event-waitlist/{waitlist_entry_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event waitlist entry",
        "description": "Get an event waitlist entry",
        "operationId": "getEventWaitlistEntry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waitlist_entry_id",
            "in": "path",
            "required": true,
            "description": "Opaque waitlist entry id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event waitlist entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaitlistEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000013",
                    "object": "event_waitlist_entry",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000003",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "requested_seats": 1,
                    "status": "offered",
                    "priority": 0,
                    "position": 7,
                    "offered_at": "2026-08-25T15:00:00Z",
                    "offer_expires_at": "2026-08-26T15:00:00Z",
                    "accepted_registration_id": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waitlist_entry",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event waitlist entry",
        "description": "Update queue fields and only waiting or cancelled status. Offer-next owns offered timestamps and expiry; accept owns accepted state and registration linkage.",
        "operationId": "updateEventWaitlistEntry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waitlist_entry_id",
            "in": "path",
            "required": true,
            "description": "Opaque waitlist entry id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                  "version": {
                    "type": "integer",
                    "minimum": 1
                  },
                  "occurrence_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "uuid"
                  },
                  "ticket_option_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "uuid"
                  },
                  "participant_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "uuid"
                  },
                  "purchaser_customer_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160
                  },
                  "requested_seats": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100000
                  },
                  "priority": {
                    "type": "integer",
                    "minimum": -1000000,
                    "maximum": 1000000
                  },
                  "status": {
                    "type": "string",
                    "enum": [
                      "waiting",
                      "cancelled"
                    ]
                  },
                  "external_id": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "maxLength": 240
                  }
                },
                "description": "Offer timestamps, expiry, offered state, acceptance, and accepted-registration linkage are owned by offer-next and accept."
              },
              "example": {
                "version": 1,
                "status": "waiting",
                "priority": 10,
                "external_id": "waitlist-demo-001"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event waitlist entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaitlistEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000013",
                    "object": "event_waitlist_entry",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000003",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "requested_seats": 1,
                    "status": "waiting",
                    "priority": 0,
                    "position": 7,
                    "offered_at": null,
                    "offer_expires_at": null,
                    "accepted_registration_id": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waitlist_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Cancel an event waitlist entry",
        "description": "Cancel an event waitlist entry",
        "operationId": "cancelEventWaitlistEntry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "waitlist_entry_id",
            "in": "path",
            "required": true,
            "description": "Opaque waitlist entry id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Cancel an event waitlist entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventWaitlistEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000013",
                    "object": "event_waitlist_entry",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": "10000000-0000-4000-8000-000000000003",
                    "ticket_option_id": "10000000-0000-4000-8000-000000000008",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "purchaser_customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "requested_seats": 1,
                    "status": "cancelled",
                    "priority": 0,
                    "position": 7,
                    "offered_at": "2026-08-25T15:00:00Z",
                    "offer_expires_at": "2026-08-26T15:00:00Z",
                    "accepted_registration_id": null,
                    "source_system": "centripos",
                    "external_id": null,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_waitlist_cancel",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:registrations:write"
      }
    },
    "/api/retail/v1/events/{event_id}/assets": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event assets",
        "description": "List event assets",
        "operationId": "listEventAssets",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event assets response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventAssetPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000014",
                      "object": "event_asset",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": null,
                      "asset_type": "document",
                      "title": "Synthetic family guide",
                      "alt_text": null,
                      "url": "https://downloads.example.test/events/synthetic-family-guide.pdf",
                      "mime_type": "application/pdf",
                      "byte_size": 184200,
                      "visibility": "public",
                      "is_public": true,
                      "sort_order": 20,
                      "metadata": {},
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_assets",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event asset",
        "description": "Create a public, attendees, or staff asset from an external HTTPS URL. Retail API writes reject Supabase project and Storage origins and never accept native bucket/path coordinates.",
        "operationId": "createEventAsset",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "event_id",
            "in": "path",
            "required": true,
            "description": "Opaque event id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "occurrence_id": {},
                  "asset_type": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  },
                  "mime_type": {
                    "type": "string"
                  },
                  "byte_size": {
                    "type": "integer"
                  },
                  "visibility": {
                    "type": "string"
                  },
                  "sort_order": {
                    "type": "integer"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "occurrence_id",
                  "asset_type",
                  "title",
                  "url",
                  "mime_type",
                  "byte_size",
                  "visibility",
                  "sort_order",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "occurrence_id": null,
                "asset_type": "document",
                "title": "Synthetic family guide",
                "url": "https://downloads.example.test/events/synthetic-family-guide.pdf",
                "mime_type": "application/pdf",
                "byte_size": 184200,
                "visibility": "public",
                "sort_order": 20,
                "source_system": "example_integration",
                "external_id": "asset-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event asset response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventAssetEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000014",
                    "object": "event_asset",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": null,
                    "asset_type": "document",
                    "title": "Synthetic family guide",
                    "alt_text": null,
                    "url": "https://downloads.example.test/events/synthetic-family-guide.pdf",
                    "mime_type": "application/pdf",
                    "byte_size": 184200,
                    "visibility": "public",
                    "is_public": true,
                    "sort_order": 20,
                    "metadata": {},
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_asset_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-assets/{asset_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event asset",
        "description": "Retrieve the supported asset projection without native Storage coordinates or Supabase project URLs.",
        "operationId": "getEventAsset",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "required": true,
            "description": "Opaque asset id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event asset response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventAssetEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000014",
                    "object": "event_asset",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": null,
                    "asset_type": "document",
                    "title": "Synthetic family guide",
                    "alt_text": null,
                    "url": "https://downloads.example.test/events/synthetic-family-guide.pdf",
                    "mime_type": "application/pdf",
                    "byte_size": 184200,
                    "visibility": "public",
                    "is_public": true,
                    "sort_order": 20,
                    "metadata": {},
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_asset",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event asset",
        "description": "Set visibility to public, attendees, or staff. Retail API URLs must be external HTTPS and cannot expose a Supabase origin; native private files use the manager upload flow and branded portal delivery. is_public is trigger-maintained compatibility state.",
        "operationId": "updateEventAsset",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "required": true,
            "description": "Opaque asset id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "title": {
                    "type": "string"
                  },
                  "visibility": {
                    "type": "string"
                  },
                  "url": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "title",
                  "visibility",
                  "url"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "title": "Updated synthetic family guide",
                "visibility": "attendees",
                "url": "https://downloads.example.test/events/synthetic-family-guide.pdf"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event asset response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventAssetEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000014",
                    "object": "event_asset",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "occurrence_id": null,
                    "asset_type": "document",
                    "title": "Synthetic family guide",
                    "alt_text": null,
                    "url": "https://downloads.example.test/events/synthetic-family-guide.pdf",
                    "mime_type": "application/pdf",
                    "byte_size": 184200,
                    "visibility": "attendees",
                    "is_public": false,
                    "sort_order": 20,
                    "metadata": {},
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_asset_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Delete an event asset",
        "description": "Delete an event asset",
        "operationId": "deleteEventAsset",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "asset_id",
            "in": "path",
            "required": true,
            "description": "Opaque asset id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-publication-feeds": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List event publication feeds",
        "description": "List event publication feeds",
        "operationId": "listEventPublicationFeeds",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 200,
              "default": 50
            }
          },
          {
            "name": "created_before",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor timestamp. Supply it only together with created_before_id from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "created_before_id",
            "in": "query",
            "required": false,
            "description": "Legacy composite cursor record ID. Supply it only together with created_before from the same preceding page; prefer opaque cursor.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List event publication feeds response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPublicationFeedPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000015",
                      "object": "event_publication_feed",
                      "slug": "northstar-learning-events",
                      "name": "Northstar Learning events",
                      "status": "published",
                      "visibility": "public",
                      "theme": {
                        "primary_color": "#3346d3",
                        "accent_color": "#f97316",
                        "card_style": "image"
                      },
                      "filters": {
                        "event_kinds": [
                          "camp",
                          "class",
                          "workshop"
                        ]
                      },
                      "seo": {
                        "title": "Northstar Learning events",
                        "description": "Synthetic camps, classes, and workshops."
                      },
                      "embed_settings": {
                        "layout": "grid",
                        "show_filters": true,
                        "show_calendar_action": true
                      },
                      "custom_domain": null,
                      "published_at": "2026-08-25T15:00:00Z",
                      "source_system": "centripos",
                      "external_id": null,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_publication_feeds",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read",
        "x-centripos-query-parameter-pairs": [
          [
            "created_before",
            "created_before_id"
          ]
        ]
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Create an event publication feed",
        "description": "Create an event publication feed",
        "operationId": "createEventPublicationFeed",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "visibility": {
                    "type": "string"
                  },
                  "theme": {
                    "type": "object",
                    "properties": {
                      "primary_color": {
                        "type": "string"
                      },
                      "accent_color": {
                        "type": "string"
                      },
                      "card_style": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "primary_color",
                      "accent_color",
                      "card_style"
                    ],
                    "additionalProperties": false
                  },
                  "filters": {
                    "type": "object",
                    "properties": {
                      "event_kinds": {
                        "type": "array",
                        "items": {
                          "type": "string"
                        }
                      }
                    },
                    "required": [
                      "event_kinds"
                    ],
                    "additionalProperties": false
                  },
                  "seo": {
                    "type": "object",
                    "properties": {
                      "title": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "title",
                      "description"
                    ],
                    "additionalProperties": false
                  },
                  "embed_settings": {
                    "type": "object",
                    "properties": {
                      "layout": {
                        "type": "string"
                      },
                      "show_filters": {
                        "type": "boolean"
                      },
                      "show_calendar_action": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "layout",
                      "show_filters",
                      "show_calendar_action"
                    ],
                    "additionalProperties": false
                  },
                  "offerings": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "offering_id": {
                          "type": "string"
                        },
                        "sort_order": {
                          "type": "integer"
                        },
                        "is_featured": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "offering_id",
                        "sort_order",
                        "is_featured"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "slug",
                  "name",
                  "status",
                  "visibility",
                  "theme",
                  "filters",
                  "seo",
                  "embed_settings",
                  "offerings",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "slug": "northstar-learning-events",
                "name": "Northstar Learning events",
                "status": "published",
                "visibility": "public",
                "theme": {
                  "primary_color": "#3346d3",
                  "accent_color": "#f97316",
                  "card_style": "image"
                },
                "filters": {
                  "event_kinds": [
                    "camp",
                    "class",
                    "workshop"
                  ]
                },
                "seo": {
                  "title": "Northstar Learning events",
                  "description": "Synthetic camps, classes, and workshops."
                },
                "embed_settings": {
                  "layout": "grid",
                  "show_filters": true,
                  "show_calendar_action": true
                },
                "offerings": [
                  {
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "sort_order": 10,
                    "is_featured": true
                  }
                ],
                "source_system": "example_integration",
                "external_id": "feed-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create an event publication feed response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPublicationFeedEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000015",
                    "object": "event_publication_feed",
                    "slug": "northstar-learning-events",
                    "name": "Northstar Learning events",
                    "status": "published",
                    "visibility": "public",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image"
                    },
                    "filters": {
                      "event_kinds": [
                        "camp",
                        "class",
                        "workshop"
                      ]
                    },
                    "seo": {
                      "title": "Northstar Learning events",
                      "description": "Synthetic camps, classes, and workshops."
                    },
                    "embed_settings": {
                      "layout": "grid",
                      "show_filters": true,
                      "show_calendar_action": true
                    },
                    "custom_domain": null,
                    "published_at": "2026-08-25T15:00:00Z",
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_publication_feed_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-publication-feeds/{feed_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get an event publication feed",
        "description": "Get an event publication feed",
        "operationId": "getEventPublicationFeed",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "feed_id",
            "in": "path",
            "required": true,
            "description": "Opaque feed id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get an event publication feed response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPublicationFeedEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000015",
                    "object": "event_publication_feed",
                    "slug": "northstar-learning-events",
                    "name": "Northstar Learning events",
                    "status": "published",
                    "visibility": "public",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image"
                    },
                    "filters": {
                      "event_kinds": [
                        "camp",
                        "class",
                        "workshop"
                      ]
                    },
                    "seo": {
                      "title": "Northstar Learning events",
                      "description": "Synthetic camps, classes, and workshops."
                    },
                    "embed_settings": {
                      "layout": "grid",
                      "show_filters": true,
                      "show_calendar_action": true
                    },
                    "custom_domain": null,
                    "published_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "offerings": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-publication-feeds/10000000-0000-4000-8000-000000000015/offerings"
                      }
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_publication_feed",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update an event publication feed",
        "description": "Update an event publication feed",
        "operationId": "updateEventPublicationFeed",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "feed_id",
            "in": "path",
            "required": true,
            "description": "Opaque feed id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  },
                  "offerings": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "offering_id": {
                          "type": "string"
                        },
                        "sort_order": {
                          "type": "integer"
                        },
                        "is_featured": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "offering_id",
                        "sort_order",
                        "is_featured"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "version",
                  "status",
                  "offerings"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 1,
                "status": "published",
                "offerings": [
                  {
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "sort_order": 10,
                    "is_featured": true
                  }
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update an event publication feed response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPublicationFeedEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000015",
                    "object": "event_publication_feed",
                    "slug": "northstar-learning-events",
                    "name": "Northstar Learning events",
                    "status": "published",
                    "visibility": "public",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image"
                    },
                    "filters": {
                      "event_kinds": [
                        "camp",
                        "class",
                        "workshop"
                      ]
                    },
                    "seo": {
                      "title": "Northstar Learning events",
                      "description": "Synthetic camps, classes, and workshops."
                    },
                    "embed_settings": {
                      "layout": "grid",
                      "show_filters": true,
                      "show_calendar_action": true
                    },
                    "custom_domain": null,
                    "published_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "offerings": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-publication-feeds/10000000-0000-4000-8000-000000000015/offerings"
                      }
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_publication_feed_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Archive an event publication feed",
        "description": "Archive an event publication feed",
        "operationId": "archiveEventPublicationFeed",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "feed_id",
            "in": "path",
            "required": true,
            "description": "Opaque feed id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Archive an event publication feed response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPublicationFeedEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000015",
                    "object": "event_publication_feed",
                    "slug": "northstar-learning-events",
                    "name": "Northstar Learning events",
                    "status": "archived",
                    "visibility": "public",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image"
                    },
                    "filters": {
                      "event_kinds": [
                        "camp",
                        "class",
                        "workshop"
                      ]
                    },
                    "seo": {
                      "title": "Northstar Learning events",
                      "description": "Synthetic camps, classes, and workshops."
                    },
                    "embed_settings": {
                      "layout": "grid",
                      "show_filters": true,
                      "show_calendar_action": true
                    },
                    "custom_domain": null,
                    "published_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "offerings": {
                        "count": 1,
                        "collection": "/api/retail/v1/event-publication-feeds/10000000-0000-4000-8000-000000000015/offerings"
                      }
                    },
                    "source_system": "centripos",
                    "external_id": null,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_publication_feed_archive",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-publication-feeds/{feed_id}/offerings": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List publication-feed offerings",
        "description": "Cursor-page deterministic offering memberships for one publication feed.",
        "operationId": "listEventPublicationFeedOfferings",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "feed_id",
            "in": "path",
            "required": true,
            "description": "Opaque feed id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List publication-feed offerings response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPublicationFeedOfferingPage"
                },
                "example": {
                  "data": [
                    {
                      "object": "event_publication_feed_offering",
                      "feed_id": "10000000-0000-4000-8000-000000000015",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "sort_order": 10,
                      "is_featured": true,
                      "created_at": "2026-08-25T14:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_publication_feed_offerings",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "post": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Add a publication-feed offering",
        "description": "Add one offering membership. The aggregate feed replace remains only a bounded convenience; page and mutate large membership sets through this collection.",
        "operationId": "createEventPublicationFeedOffering",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "feed_id",
            "in": "path",
            "required": true,
            "description": "Opaque feed id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "offering_id": {
                    "type": "string"
                  },
                  "sort_order": {
                    "type": "integer"
                  },
                  "is_featured": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "offering_id",
                  "sort_order",
                  "is_featured"
                ],
                "additionalProperties": false
              },
              "example": {
                "offering_id": "10000000-0000-4000-8000-000000000001",
                "sort_order": 10,
                "is_featured": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Add a publication-feed offering response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPublicationFeedOfferingEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_publication_feed_offering",
                    "feed_id": "10000000-0000-4000-8000-000000000015",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "sort_order": 10,
                    "is_featured": true,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_publication_feed_offering_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/event-publication-feeds/{feed_id}/offerings/{offering_id}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a publication-feed offering",
        "description": "Get a publication-feed offering",
        "operationId": "getEventPublicationFeedOffering",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "feed_id",
            "in": "path",
            "required": true,
            "description": "Opaque feed id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "offering_id",
            "in": "path",
            "required": true,
            "description": "Opaque offering id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a publication-feed offering response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPublicationFeedOfferingEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_publication_feed_offering",
                    "feed_id": "10000000-0000-4000-8000-000000000015",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "sort_order": 10,
                    "is_featured": true,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_publication_feed_offering",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:read"
      },
      "patch": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Update a publication-feed offering",
        "description": "Update a publication-feed offering",
        "operationId": "updateEventPublicationFeedOffering",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "feed_id",
            "in": "path",
            "required": true,
            "description": "Opaque feed id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "offering_id",
            "in": "path",
            "required": true,
            "description": "Opaque offering id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "sort_order": {
                    "type": "integer"
                  },
                  "is_featured": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "sort_order",
                  "is_featured"
                ],
                "additionalProperties": false
              },
              "example": {
                "sort_order": 20,
                "is_featured": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a publication-feed offering response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventPublicationFeedOfferingEnvelope"
                },
                "example": {
                  "data": {
                    "object": "event_publication_feed_offering",
                    "feed_id": "10000000-0000-4000-8000-000000000015",
                    "offering_id": "10000000-0000-4000-8000-000000000001",
                    "sort_order": 20,
                    "is_featured": false,
                    "created_at": "2026-08-25T14:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_event_publication_feed_offering_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      },
      "delete": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Remove a publication-feed offering",
        "description": "Remove one publication membership. Success returns 204 with no response body.",
        "operationId": "deleteEventPublicationFeedOffering",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "feed_id",
            "in": "path",
            "required": true,
            "description": "Opaque feed id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "offering_id",
            "in": "path",
            "required": true,
            "description": "Opaque offering id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "events:write"
      }
    },
    "/api/retail/v1/calendar/entries": {
      "get": {
        "tags": [
          "Company calendar"
        ],
        "summary": "List calendar entries",
        "description": "List calendar entries",
        "operationId": "listCalendarEntries",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          },
          {
            "name": "starts_after",
            "in": "query",
            "required": false,
            "description": "Return schedule records ending or starting at or after this RFC 3339 timestamp, as defined by the operation.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "starts_before",
            "in": "query",
            "required": false,
            "description": "Return schedule records starting before this RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "source_type",
            "in": "query",
            "required": false,
            "description": "Filter canonical calendar entries by source type.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Filter by the documented resource status.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List calendar entries response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEntryPage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000016",
                      "object": "calendar_entry",
                      "source_type": "event_occurrence",
                      "source_id": "10000000-0000-4000-8000-000000000002",
                      "calendar_type": "company",
                      "title": "Robotics discovery camp — morning",
                      "description": "Synthetic attendee-safe schedule description.",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "status": "confirmed",
                      "visibility": "attendees",
                      "location_details": {
                        "venue_name": "Northstar Learning Lab",
                        "city": "Sample City",
                        "region": "OH"
                      },
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "organizer_name": "Northstar Learning",
                      "organizer_email": "events@example.test",
                      "ical_uid": "synthetic-event-calendar-entry@calendar.centripos.com",
                      "source_system": "centripos",
                      "external_id": null,
                      "external_calendar_id": null,
                      "external_event_id": null,
                      "sync_status": "local",
                      "sync_error": null,
                      "last_synced_at": null,
                      "metadata": {},
                      "version": 2,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_calendar_entries",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:read"
      },
      "post": {
        "tags": [
          "Company calendar"
        ],
        "summary": "Create a calendar entry",
        "description": "Create a custom or external calendar entry. Event, delivery, and service projections are created by their source workflows.",
        "operationId": "createCalendarEntry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "source_type": {
                    "type": "string"
                  },
                  "source_id": {},
                  "calendar_type": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "starts_at": {
                    "type": "string"
                  },
                  "ends_at": {
                    "type": "string"
                  },
                  "timezone": {
                    "type": "string"
                  },
                  "all_day": {
                    "type": "boolean"
                  },
                  "status": {
                    "type": "string"
                  },
                  "visibility": {
                    "type": "string"
                  },
                  "location_details": {
                    "type": "object",
                    "properties": {
                      "venue_name": {
                        "type": "string"
                      },
                      "city": {
                        "type": "string"
                      },
                      "region": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "venue_name",
                      "city",
                      "region"
                    ],
                    "additionalProperties": false
                  },
                  "organizer_name": {
                    "type": "string"
                  },
                  "organizer_email": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "source_type",
                  "source_id",
                  "calendar_type",
                  "title",
                  "description",
                  "starts_at",
                  "ends_at",
                  "timezone",
                  "all_day",
                  "status",
                  "visibility",
                  "location_details",
                  "organizer_name",
                  "organizer_email",
                  "source_system",
                  "external_id"
                ],
                "additionalProperties": false
              },
              "example": {
                "source_type": "custom",
                "source_id": null,
                "calendar_type": "company",
                "title": "Synthetic staff briefing",
                "description": "Internal preparation for the event week.",
                "starts_at": "2026-09-14T13:00:00Z",
                "ends_at": "2026-09-14T16:00:00Z",
                "timezone": "America/New_York",
                "all_day": false,
                "status": "scheduled",
                "visibility": "staff",
                "location_details": {
                  "venue_name": "Northstar Learning Lab",
                  "city": "Sample City",
                  "region": "OH"
                },
                "organizer_name": "Northstar Learning",
                "organizer_email": "events@example.test",
                "source_system": "example_integration",
                "external_id": "calendar-demo-001"
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Create a calendar entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEntryEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000016",
                    "object": "calendar_entry",
                    "source_type": "custom",
                    "source_id": null,
                    "calendar_type": "company",
                    "title": "Synthetic staff briefing",
                    "description": "Internal preparation for the event week.",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "timezone": "America/New_York",
                    "all_day": false,
                    "status": "scheduled",
                    "visibility": "staff",
                    "location_details": {
                      "venue_name": "Northstar Learning Lab",
                      "city": "Sample City",
                      "region": "OH"
                    },
                    "recurrence_rule": "FREQ=DAILY;COUNT=5",
                    "organizer_name": "Northstar Learning",
                    "organizer_email": "events@example.test",
                    "ical_uid": "synthetic-custom-calendar-entry@calendar.centripos.com",
                    "source_system": "centripos",
                    "external_id": null,
                    "external_calendar_id": null,
                    "external_event_id": null,
                    "sync_status": "local",
                    "sync_error": null,
                    "last_synced_at": null,
                    "metadata": {},
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_calendar_entry_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:write"
      }
    },
    "/api/retail/v1/calendar/entries/{calendar_entry_id}": {
      "get": {
        "tags": [
          "Company calendar"
        ],
        "summary": "Get a calendar entry",
        "description": "Get a calendar entry",
        "operationId": "getCalendarEntry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "calendar_entry_id",
            "in": "path",
            "required": true,
            "description": "Opaque calendar entry id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a calendar entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEntryEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000016",
                    "object": "calendar_entry",
                    "source_type": "event_occurrence",
                    "source_id": "10000000-0000-4000-8000-000000000002",
                    "calendar_type": "company",
                    "title": "Robotics discovery camp — morning",
                    "description": "Synthetic attendee-safe schedule description.",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "timezone": "America/New_York",
                    "all_day": false,
                    "status": "confirmed",
                    "visibility": "attendees",
                    "location_details": {
                      "venue_name": "Northstar Learning Lab",
                      "city": "Sample City",
                      "region": "OH"
                    },
                    "recurrence_rule": "FREQ=DAILY;COUNT=5",
                    "organizer_name": "Northstar Learning",
                    "organizer_email": "events@example.test",
                    "ical_uid": "synthetic-event-calendar-entry@calendar.centripos.com",
                    "source_system": "centripos",
                    "external_id": null,
                    "external_calendar_id": null,
                    "external_event_id": null,
                    "sync_status": "local",
                    "sync_error": null,
                    "last_synced_at": null,
                    "metadata": {},
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "attendees": {
                        "count": 1,
                        "collection": "/api/retail/v1/calendar/entries/10000000-0000-4000-8000-000000000016/attendees"
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_calendar_entry",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:read"
      },
      "patch": {
        "tags": [
          "Company calendar"
        ],
        "summary": "Update a calendar entry",
        "description": "Update a custom or external calendar entry. Source-owned projections reject direct mutation with 409.",
        "operationId": "updateCalendarEntry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "calendar_entry_id",
            "in": "path",
            "required": true,
            "description": "Opaque calendar entry id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "version": {
                    "type": "integer"
                  },
                  "starts_at": {
                    "type": "string"
                  },
                  "ends_at": {
                    "type": "string"
                  },
                  "sync_status": {
                    "type": "string"
                  }
                },
                "required": [
                  "version",
                  "starts_at",
                  "ends_at",
                  "sync_status"
                ],
                "additionalProperties": false
              },
              "example": {
                "version": 2,
                "starts_at": "2026-09-14T14:00:00Z",
                "ends_at": "2026-09-14T17:00:00Z",
                "sync_status": "pending"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a calendar entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEntryEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000016",
                    "object": "calendar_entry",
                    "source_type": "custom",
                    "source_id": null,
                    "calendar_type": "company",
                    "title": "Synthetic staff briefing",
                    "description": "Internal preparation for the event week.",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "timezone": "America/New_York",
                    "all_day": false,
                    "status": "scheduled",
                    "visibility": "staff",
                    "location_details": {
                      "venue_name": "Northstar Learning Lab",
                      "city": "Sample City",
                      "region": "OH"
                    },
                    "recurrence_rule": "FREQ=DAILY;COUNT=5",
                    "organizer_name": "Northstar Learning",
                    "organizer_email": "events@example.test",
                    "ical_uid": "synthetic-custom-calendar-entry@calendar.centripos.com",
                    "source_system": "centripos",
                    "external_id": null,
                    "external_calendar_id": null,
                    "external_event_id": null,
                    "sync_status": "local",
                    "sync_error": null,
                    "last_synced_at": null,
                    "metadata": {},
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "attendees": {
                        "count": 0,
                        "collection": "/api/retail/v1/calendar/entries/10000000-0000-4000-8000-000000000016/attendees"
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_calendar_entry_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:write"
      },
      "delete": {
        "tags": [
          "Company calendar"
        ],
        "summary": "Cancel a calendar entry",
        "description": "Cancel a custom or external calendar entry. Cancel an event, delivery, or service projection through its source workflow.",
        "operationId": "cancelCalendarEntry",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "calendar_entry_id",
            "in": "path",
            "required": true,
            "description": "Opaque calendar entry id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Cancel a calendar entry response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEntryEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000016",
                    "object": "calendar_entry",
                    "source_type": "custom",
                    "source_id": null,
                    "calendar_type": "company",
                    "title": "Synthetic staff briefing",
                    "description": "Internal preparation for the event week.",
                    "starts_at": "2026-09-14T13:00:00Z",
                    "ends_at": "2026-09-14T16:00:00Z",
                    "timezone": "America/New_York",
                    "all_day": false,
                    "status": "cancelled",
                    "visibility": "staff",
                    "location_details": {
                      "venue_name": "Northstar Learning Lab",
                      "city": "Sample City",
                      "region": "OH"
                    },
                    "recurrence_rule": "FREQ=DAILY;COUNT=5",
                    "organizer_name": "Northstar Learning",
                    "organizer_email": "events@example.test",
                    "ical_uid": "synthetic-custom-calendar-entry@calendar.centripos.com",
                    "source_system": "centripos",
                    "external_id": null,
                    "external_calendar_id": null,
                    "external_event_id": null,
                    "sync_status": "local",
                    "sync_error": null,
                    "last_synced_at": null,
                    "metadata": {},
                    "version": 2,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z",
                    "relationships": {
                      "attendees": {
                        "count": 0,
                        "collection": "/api/retail/v1/calendar/entries/10000000-0000-4000-8000-000000000016/attendees"
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_calendar_entry_cancel",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:write"
      }
    },
    "/api/retail/v1/calendar/entries/{calendar_entry_id}/attendees": {
      "get": {
        "tags": [
          "Company calendar"
        ],
        "summary": "List calendar entry attendees",
        "description": "Cursor-page deterministic attendee memberships for one calendar entry.",
        "operationId": "listCalendarEntryAttendees",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "calendar_entry_id",
            "in": "path",
            "required": true,
            "description": "Opaque calendar entry id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List calendar entry attendees response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEntryAttendeePage"
                },
                "example": {
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000026",
                      "object": "calendar_entry_attendee",
                      "calendar_entry_id": "10000000-0000-4000-8000-000000000016",
                      "source_type": "custom",
                      "source_id": null,
                      "customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                      "participant_id": "10000000-0000-4000-8000-000000000009",
                      "email": null,
                      "display_name": "Avery Example",
                      "attendee_role": "required",
                      "response_status": "accepted",
                      "notify": true,
                      "version": 1,
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_calendar_entry_attendees",
                    "environment": "test",
                    "idempotency_result": "not_applicable",
                    "next_cursor": null,
                    "next_created_before": null,
                    "next_created_before_id": null,
                    "has_more": false,
                    "limit": 50
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:read"
      },
      "post": {
        "tags": [
          "Company calendar"
        ],
        "summary": "Add a calendar entry attendee",
        "description": "Add a calendar entry attendee",
        "operationId": "createCalendarEntryAttendee",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "calendar_entry_id",
            "in": "path",
            "required": true,
            "description": "Opaque calendar entry id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. Replays with the same normalized request return the original result.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer_id": {
                    "type": "string"
                  },
                  "participant_id": {
                    "type": "string"
                  },
                  "email": {},
                  "display_name": {
                    "type": "string"
                  },
                  "attendee_role": {
                    "type": "string"
                  },
                  "response_status": {
                    "type": "string"
                  },
                  "notify": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "customer_id",
                  "participant_id",
                  "email",
                  "display_name",
                  "attendee_role",
                  "response_status",
                  "notify"
                ],
                "additionalProperties": false
              },
              "example": {
                "customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                "participant_id": "10000000-0000-4000-8000-000000000009",
                "email": null,
                "display_name": "Avery Example",
                "attendee_role": "required",
                "response_status": "accepted",
                "notify": true
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Add a calendar entry attendee response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEntryAttendeeEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000026",
                    "object": "calendar_entry_attendee",
                    "calendar_entry_id": "10000000-0000-4000-8000-000000000016",
                    "source_type": "custom",
                    "source_id": null,
                    "customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "email": null,
                    "display_name": "Avery Example",
                    "attendee_role": "required",
                    "response_status": "accepted",
                    "notify": true,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_calendar_entry_attendee_create",
                    "environment": "test",
                    "idempotency_result": "created"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:write"
      }
    },
    "/api/retail/v1/calendar-entry-attendees/{calendar_attendee_id}": {
      "get": {
        "tags": [
          "Company calendar"
        ],
        "summary": "Get a calendar entry attendee",
        "description": "Get a calendar entry attendee",
        "operationId": "getCalendarEntryAttendee",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "calendar_attendee_id",
            "in": "path",
            "required": true,
            "description": "Opaque calendar attendee id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a calendar entry attendee response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEntryAttendeeEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000026",
                    "object": "calendar_entry_attendee",
                    "calendar_entry_id": "10000000-0000-4000-8000-000000000016",
                    "source_type": "custom",
                    "source_id": null,
                    "customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "email": null,
                    "display_name": "Avery Example",
                    "attendee_role": "required",
                    "response_status": "accepted",
                    "notify": true,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_calendar_entry_attendee",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:read"
      },
      "patch": {
        "tags": [
          "Company calendar"
        ],
        "summary": "Update a calendar entry attendee",
        "description": "Update a calendar entry attendee",
        "operationId": "updateCalendarEntryAttendee",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "calendar_attendee_id",
            "in": "path",
            "required": true,
            "description": "Opaque calendar attendee id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "response_status": {
                    "type": "string"
                  },
                  "notify": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "response_status",
                  "notify"
                ],
                "additionalProperties": false
              },
              "example": {
                "response_status": "tentative",
                "notify": true
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Update a calendar entry attendee response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarEntryAttendeeEnvelope"
                },
                "example": {
                  "data": {
                    "id": "10000000-0000-4000-8000-000000000026",
                    "object": "calendar_entry_attendee",
                    "calendar_entry_id": "10000000-0000-4000-8000-000000000016",
                    "source_type": "custom",
                    "source_id": null,
                    "customer_id": "cus_test_01J9TAYLORHOUSEHOLD",
                    "participant_id": "10000000-0000-4000-8000-000000000009",
                    "email": null,
                    "display_name": "Avery Example",
                    "attendee_role": "required",
                    "response_status": "tentative",
                    "notify": true,
                    "version": 1,
                    "created_at": "2026-08-25T14:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-24",
                    "request_id": "req_test_calendar_entry_attendee_update",
                    "environment": "test",
                    "idempotency_result": "not_applicable"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:write"
      },
      "delete": {
        "tags": [
          "Company calendar"
        ],
        "summary": "Delete a calendar entry attendee",
        "description": "Delete a calendar entry attendee",
        "operationId": "deleteCalendarEntryAttendee",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "calendar_attendee_id",
            "in": "path",
            "required": true,
            "description": "Opaque calendar attendee id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "204": {
            "description": "Successful request. No response body is returned."
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "calendar:write"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a public event feed",
        "description": "Read the browser-safe projection of one published tenant-qualified event feed.",
        "operationId": "getPublicEventFeed",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a public event feed response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventFeed"
                },
                "example": {
                  "api_version": "2026-08-25",
                  "feed": {
                    "id": "10000000-0000-4000-8000-000000000015",
                    "tenant_id": "40000000-0000-4000-8000-000000000001",
                    "slug": "northstar-learning-events",
                    "name": "Northstar Learning events",
                    "status": "published",
                    "visibility": "public",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image",
                      "hero_image_url": null,
                      "logo_url": null
                    },
                    "filters": {
                      "event_kinds": [
                        "camp",
                        "class",
                        "workshop"
                      ]
                    },
                    "seo": {
                      "title": "Northstar Learning events",
                      "description": "Synthetic camps, classes, and workshops."
                    },
                    "embed_settings": {
                      "layout": "grid",
                      "show_filters": true,
                      "show_calendar_action": true
                    },
                    "custom_domain": null,
                    "published_at": "2026-08-25T15:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "offerings": [
                    {
                      "id": "10000000-0000-4000-8000-000000000001",
                      "slug": "robotics-discovery-camp",
                      "name": "Robotics Discovery Camp",
                      "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
                      "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
                      "event_kind": "camp",
                      "delivery_format": "in_person",
                      "status": "published",
                      "visibility": "public",
                      "timezone": "America/New_York",
                      "venue_id": "10000000-0000-4000-8000-000000000041",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "venue": {
                        "id": "10000000-0000-4000-8000-000000000041",
                        "name": "Northstar Learning Lab",
                        "timezone": "America/New_York",
                        "address": {
                          "address_line_1": "100 Example Avenue",
                          "address_line_2": null,
                          "locality": "Sample City",
                          "administrative_area": "OH",
                          "postal_code": "43000",
                          "country_code": "US"
                        },
                        "latitude": 40.1,
                        "longitude": -82.9,
                        "map_url": "https://maps.example.test/place/northstar-learning-lab",
                        "website_url": "https://example.test/northstar-learning-lab",
                        "public_phone": "+1-555-010-0100",
                        "public_email": "events@example.test",
                        "arrival_instructions": "Use the signed visitor entrance.",
                        "accessibility_summary": "Step-free entrance and accessible seating are available."
                      },
                      "support_email": "events@example.test",
                      "support_phone": "+1-555-010-0100",
                      "registration_opens_at": "2026-08-25T13:00:00Z",
                      "registration_closes_at": "2026-09-13T23:59:00Z",
                      "minimum_age_months": 96,
                      "maximum_age_months": 156,
                      "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
                      "image_alt_text": "Synthetic robotics camp work table",
                      "theme": {
                        "primary_color": "#3346d3",
                        "accent_color": "#f97316",
                        "card_style": "image",
                        "hero_image_url": null,
                        "logo_url": null
                      },
                      "published_at": "2026-08-25T15:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "is_featured": true
                    }
                  ],
                  "occurrences": [
                    {
                      "id": "10000000-0000-4000-8000-000000000002",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_key": "camp-2026-09-14-am",
                      "name": "Morning camp",
                      "session_kind": "morning",
                      "enrollment_policy": "entitlement_only",
                      "status": "published",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_id": "10000000-0000-4000-8000-000000000041",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "venue": {
                        "id": "10000000-0000-4000-8000-000000000041",
                        "name": "Northstar Learning Lab",
                        "timezone": "America/New_York",
                        "address": {
                          "address_line_1": "100 Example Avenue",
                          "address_line_2": null,
                          "locality": "Sample City",
                          "administrative_area": "OH",
                          "postal_code": "43000",
                          "country_code": "US"
                        },
                        "latitude": 40.1,
                        "longitude": -82.9,
                        "map_url": "https://maps.example.test/place/northstar-learning-lab",
                        "website_url": "https://example.test/northstar-learning-lab",
                        "public_phone": "+1-555-010-0100",
                        "public_email": "events@example.test",
                        "arrival_instructions": "Use the signed visitor entrance.",
                        "accessibility_summary": "Step-free entrance and accessible seating are available."
                      },
                      "version": 2,
                      "updated_at": "2026-08-25T15:00:00Z"
                    },
                    {
                      "id": "10000000-0000-4000-8000-000000000040",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_key": "camp-2026-09-14-lunch",
                      "name": "Supervised lunch bridge",
                      "session_kind": "lunch_bridge",
                      "enrollment_policy": "entitlement_only",
                      "status": "published",
                      "starts_at": "2026-09-14T16:00:00Z",
                      "ends_at": "2026-09-14T17:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "version": 1,
                      "updated_at": "2026-08-25T15:00:00Z"
                    },
                    {
                      "id": "10000000-0000-4000-8000-000000000003",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_key": "camp-2026-09-14-pm",
                      "name": "Afternoon camp",
                      "session_kind": "afternoon",
                      "enrollment_policy": "entitlement_only",
                      "status": "published",
                      "starts_at": "2026-09-14T17:00:00Z",
                      "ends_at": "2026-09-14T20:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "version": 1,
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "exceptions": [
                    {
                      "id": "10000000-0000-4000-8000-000000000004",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "original_start_at": "2026-09-16T13:00:00Z",
                      "exception_type": "rescheduled",
                      "starts_at": "2026-09-16T14:00:00Z",
                      "ends_at": "2026-09-16T17:00:00Z",
                      "reason": "Synthetic venue schedule change",
                      "override_fields": {
                        "name": "Morning camp — updated time",
                        "venue_name": "Northstar Learning Lab",
                        "location_details": {
                          "city": "Sample City",
                          "region": "OH"
                        }
                      },
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "tickets": [
                    {
                      "id": "10000000-0000-4000-8000-000000000008",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "code": "FULL-DAY",
                      "label": "Full day",
                      "description": "Admission to morning, supervised lunch bridge, and afternoon camp sessions.",
                      "status": "active",
                      "sales_opens_at": "2026-08-25T13:00:00Z",
                      "sales_closes_at": "2026-09-13T23:59:00Z",
                      "minimum_per_order": 1,
                      "maximum_per_order": 4,
                      "seats_per_ticket": 1,
                      "assignment_policy": "at_checkout",
                      "assignment_deadline_at": null,
                      "sort_order": 30,
                      "checkout_status": "ready",
                      "purchase_url": "/store/northstar-learning/product/robotics-camp-full-day?eventTenant=40000000-0000-4000-8000-000000000001&eventFeed=northstar-learning-events&eventOffering=robotics-discovery-camp&eventTicketOption=10000000-0000-4000-8000-000000000008",
                      "registration_url": "/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/registration?ticket_option_id=10000000-0000-4000-8000-000000000008",
                      "price_amount": 595,
                      "currency": "USD"
                    }
                  ],
                  "assets": [
                    {
                      "id": "10000000-0000-4000-8000-000000000014",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": null,
                      "asset_type": "document",
                      "title": "Synthetic family guide",
                      "alt_text": null,
                      "url": "https://downloads.example.test/events/synthetic-family-guide.pdf",
                      "mime_type": "application/pdf",
                      "byte_size": 184200,
                      "is_public": true,
                      "sort_order": 20
                    }
                  ],
                  "occurrences_truncated": false,
                  "occurrences_next_cursor": null,
                  "occurrences_window": {
                    "start": "2026-08-25T00:00:00.000Z",
                    "end": "2028-08-25T00:00:00.000Z"
                  },
                  "links": {
                    "self": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events",
                    "feed": "https://pos.getcentri.com/events/feed/40000000-0000-4000-8000-000000000001/northstar-learning-events",
                    "calendar": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/calendar.ics",
                    "calendar_subscription": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/calendar-subscription.ics",
                    "occurrences": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/occurrences",
                    "embed": "https://pos.getcentri.com/events/embed/40000000-0000-4000-8000-000000000001/northstar-learning-events"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/offerings/{event_slug}": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a public event offering",
        "description": "Read one published offering within the tenant-qualified public feed projection.",
        "operationId": "getPublicEventOffering",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "event_slug",
            "in": "path",
            "required": true,
            "description": "Opaque event slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a public event offering response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventFeed"
                },
                "example": {
                  "api_version": "2026-08-25",
                  "feed": {
                    "id": "10000000-0000-4000-8000-000000000015",
                    "tenant_id": "40000000-0000-4000-8000-000000000001",
                    "slug": "northstar-learning-events",
                    "name": "Northstar Learning events",
                    "status": "published",
                    "visibility": "public",
                    "theme": {
                      "primary_color": "#3346d3",
                      "accent_color": "#f97316",
                      "card_style": "image",
                      "hero_image_url": null,
                      "logo_url": null
                    },
                    "filters": {
                      "event_kinds": [
                        "camp",
                        "class",
                        "workshop"
                      ]
                    },
                    "seo": {
                      "title": "Northstar Learning events",
                      "description": "Synthetic camps, classes, and workshops."
                    },
                    "embed_settings": {
                      "layout": "grid",
                      "show_filters": true,
                      "show_calendar_action": true
                    },
                    "custom_domain": null,
                    "published_at": "2026-08-25T15:00:00Z",
                    "updated_at": "2026-08-25T15:00:00Z"
                  },
                  "offerings": [
                    {
                      "id": "10000000-0000-4000-8000-000000000001",
                      "slug": "robotics-discovery-camp",
                      "name": "Robotics Discovery Camp",
                      "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
                      "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
                      "event_kind": "camp",
                      "delivery_format": "in_person",
                      "status": "published",
                      "visibility": "public",
                      "timezone": "America/New_York",
                      "venue_id": "10000000-0000-4000-8000-000000000041",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "venue": {
                        "id": "10000000-0000-4000-8000-000000000041",
                        "name": "Northstar Learning Lab",
                        "timezone": "America/New_York",
                        "address": {
                          "address_line_1": "100 Example Avenue",
                          "address_line_2": null,
                          "locality": "Sample City",
                          "administrative_area": "OH",
                          "postal_code": "43000",
                          "country_code": "US"
                        },
                        "latitude": 40.1,
                        "longitude": -82.9,
                        "map_url": "https://maps.example.test/place/northstar-learning-lab",
                        "website_url": "https://example.test/northstar-learning-lab",
                        "public_phone": "+1-555-010-0100",
                        "public_email": "events@example.test",
                        "arrival_instructions": "Use the signed visitor entrance.",
                        "accessibility_summary": "Step-free entrance and accessible seating are available."
                      },
                      "support_email": "events@example.test",
                      "support_phone": "+1-555-010-0100",
                      "registration_opens_at": "2026-08-25T13:00:00Z",
                      "registration_closes_at": "2026-09-13T23:59:00Z",
                      "minimum_age_months": 96,
                      "maximum_age_months": 156,
                      "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
                      "image_alt_text": "Synthetic robotics camp work table",
                      "theme": {
                        "primary_color": "#3346d3",
                        "accent_color": "#f97316",
                        "card_style": "image",
                        "hero_image_url": null,
                        "logo_url": null
                      },
                      "published_at": "2026-08-25T15:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z",
                      "is_featured": true
                    }
                  ],
                  "occurrences": [
                    {
                      "id": "10000000-0000-4000-8000-000000000002",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_key": "camp-2026-09-14-am",
                      "name": "Morning camp",
                      "session_kind": "morning",
                      "enrollment_policy": "entitlement_only",
                      "status": "published",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_id": "10000000-0000-4000-8000-000000000041",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "venue": {
                        "id": "10000000-0000-4000-8000-000000000041",
                        "name": "Northstar Learning Lab",
                        "timezone": "America/New_York",
                        "address": {
                          "address_line_1": "100 Example Avenue",
                          "address_line_2": null,
                          "locality": "Sample City",
                          "administrative_area": "OH",
                          "postal_code": "43000",
                          "country_code": "US"
                        },
                        "latitude": 40.1,
                        "longitude": -82.9,
                        "map_url": "https://maps.example.test/place/northstar-learning-lab",
                        "website_url": "https://example.test/northstar-learning-lab",
                        "public_phone": "+1-555-010-0100",
                        "public_email": "events@example.test",
                        "arrival_instructions": "Use the signed visitor entrance.",
                        "accessibility_summary": "Step-free entrance and accessible seating are available."
                      },
                      "version": 2,
                      "updated_at": "2026-08-25T15:00:00Z"
                    },
                    {
                      "id": "10000000-0000-4000-8000-000000000040",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_key": "camp-2026-09-14-lunch",
                      "name": "Supervised lunch bridge",
                      "session_kind": "lunch_bridge",
                      "enrollment_policy": "entitlement_only",
                      "status": "published",
                      "starts_at": "2026-09-14T16:00:00Z",
                      "ends_at": "2026-09-14T17:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "version": 1,
                      "updated_at": "2026-08-25T15:00:00Z"
                    },
                    {
                      "id": "10000000-0000-4000-8000-000000000003",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_key": "camp-2026-09-14-pm",
                      "name": "Afternoon camp",
                      "session_kind": "afternoon",
                      "enrollment_policy": "entitlement_only",
                      "status": "published",
                      "starts_at": "2026-09-14T17:00:00Z",
                      "ends_at": "2026-09-14T20:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "version": 1,
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "exceptions": [
                    {
                      "id": "10000000-0000-4000-8000-000000000004",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "original_start_at": "2026-09-16T13:00:00Z",
                      "exception_type": "rescheduled",
                      "starts_at": "2026-09-16T14:00:00Z",
                      "ends_at": "2026-09-16T17:00:00Z",
                      "reason": "Synthetic venue schedule change",
                      "override_fields": {
                        "name": "Morning camp — updated time",
                        "venue_name": "Northstar Learning Lab",
                        "location_details": {
                          "city": "Sample City",
                          "region": "OH"
                        }
                      },
                      "created_at": "2026-08-25T14:00:00Z",
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "tickets": [
                    {
                      "id": "10000000-0000-4000-8000-000000000008",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "code": "FULL-DAY",
                      "label": "Full day",
                      "description": "Admission to morning, supervised lunch bridge, and afternoon camp sessions.",
                      "status": "active",
                      "sales_opens_at": "2026-08-25T13:00:00Z",
                      "sales_closes_at": "2026-09-13T23:59:00Z",
                      "minimum_per_order": 1,
                      "maximum_per_order": 4,
                      "seats_per_ticket": 1,
                      "assignment_policy": "at_checkout",
                      "assignment_deadline_at": null,
                      "sort_order": 30,
                      "checkout_status": "ready",
                      "purchase_url": "/store/northstar-learning/product/robotics-camp-full-day?eventTenant=40000000-0000-4000-8000-000000000001&eventFeed=northstar-learning-events&eventOffering=robotics-discovery-camp&eventTicketOption=10000000-0000-4000-8000-000000000008",
                      "registration_url": "/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/registration?ticket_option_id=10000000-0000-4000-8000-000000000008",
                      "price_amount": 595,
                      "currency": "USD"
                    }
                  ],
                  "assets": [
                    {
                      "id": "10000000-0000-4000-8000-000000000014",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_id": null,
                      "asset_type": "document",
                      "title": "Synthetic family guide",
                      "alt_text": null,
                      "url": "https://downloads.example.test/events/synthetic-family-guide.pdf",
                      "mime_type": "application/pdf",
                      "byte_size": 184200,
                      "is_public": true,
                      "sort_order": 20
                    }
                  ],
                  "occurrences_truncated": false,
                  "occurrences_next_cursor": null,
                  "occurrences_window": {
                    "start": "2026-08-25T00:00:00.000Z",
                    "end": "2028-08-25T00:00:00.000Z"
                  },
                  "links": {
                    "self": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp",
                    "feed": "https://pos.getcentri.com/events/feed/40000000-0000-4000-8000-000000000001/northstar-learning-events",
                    "calendar": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/calendar.ics",
                    "calendar_subscription": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/calendar-subscription.ics",
                    "occurrences": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/occurrences",
                    "embed": "https://pos.getcentri.com/events/embed/40000000-0000-4000-8000-000000000001/northstar-learning-events"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/occurrences": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List public event occurrences",
        "description": "Page attendee-safe occurrences for the published feed inside a window of at most 732 days. This continuation keeps large conference discovery views bounded.",
        "operationId": "listPublicEventOccurrences",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "window_start",
            "in": "query",
            "required": false,
            "description": "Inclusive agenda window start as an RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "window_end",
            "in": "query",
            "required": false,
            "description": "Exclusive agenda window end as an RFC 3339 timestamp; the window may span at most 366 days.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 250,
              "default": 250
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List public event occurrences response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Link": {
                "description": "RFC 8288 rel=\"next\" URL while another occurrence page remains.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventOccurrencePage"
                },
                "example": {
                  "api_version": "2026-08-25",
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000002",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_key": "camp-2026-09-14-am",
                      "name": "Morning camp",
                      "session_kind": "morning",
                      "enrollment_policy": "entitlement_only",
                      "status": "published",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_id": "10000000-0000-4000-8000-000000000041",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "venue": {
                        "id": "10000000-0000-4000-8000-000000000041",
                        "name": "Northstar Learning Lab",
                        "timezone": "America/New_York",
                        "address": {
                          "address_line_1": "100 Example Avenue",
                          "address_line_2": null,
                          "locality": "Sample City",
                          "administrative_area": "OH",
                          "postal_code": "43000",
                          "country_code": "US"
                        },
                        "latitude": 40.1,
                        "longitude": -82.9,
                        "map_url": "https://maps.example.test/place/northstar-learning-lab",
                        "website_url": "https://example.test/northstar-learning-lab",
                        "public_phone": "+1-555-010-0100",
                        "public_email": "events@example.test",
                        "arrival_instructions": "Use the signed visitor entrance.",
                        "accessibility_summary": "Step-free entrance and accessible seating are available."
                      },
                      "version": 2,
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null,
                  "window": {
                    "start": "2026-08-25T00:00:00.000Z",
                    "end": "2028-08-25T00:00:00.000Z"
                  },
                  "links": {
                    "self": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/occurrences?window_start=2026-08-25T00%3A00%3A00.000Z&window_end=2028-08-25T00%3A00%3A00.000Z&limit=250",
                    "next": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/offerings/{event_slug}/occurrences": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List public offering occurrences",
        "description": "Page the same attendee-safe occurrence contract scoped to one published offering.",
        "operationId": "listPublicEventOfferingOccurrences",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "event_slug",
            "in": "path",
            "required": true,
            "description": "Opaque event slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "window_start",
            "in": "query",
            "required": false,
            "description": "Inclusive agenda window start as an RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "window_end",
            "in": "query",
            "required": false,
            "description": "Exclusive agenda window end as an RFC 3339 timestamp; the window may span at most 366 days.",
            "schema": {
              "type": "string",
              "format": "date-time"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 250,
              "default": 250
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List public offering occurrences response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Link": {
                "description": "RFC 8288 rel=\"next\" URL while another offering occurrence page remains.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventOccurrencePage"
                },
                "example": {
                  "api_version": "2026-08-25",
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000002",
                      "offering_id": "10000000-0000-4000-8000-000000000001",
                      "occurrence_key": "camp-2026-09-14-am",
                      "name": "Morning camp",
                      "session_kind": "morning",
                      "enrollment_policy": "entitlement_only",
                      "status": "published",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "all_day": false,
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_id": "10000000-0000-4000-8000-000000000041",
                      "venue_name": "Northstar Learning Lab",
                      "location_details": {
                        "address": "100 Example Avenue",
                        "city": "Sample City",
                        "region": "OH",
                        "postal_code": "43000"
                      },
                      "venue": {
                        "id": "10000000-0000-4000-8000-000000000041",
                        "name": "Northstar Learning Lab",
                        "timezone": "America/New_York",
                        "address": {
                          "address_line_1": "100 Example Avenue",
                          "address_line_2": null,
                          "locality": "Sample City",
                          "administrative_area": "OH",
                          "postal_code": "43000",
                          "country_code": "US"
                        },
                        "latitude": 40.1,
                        "longitude": -82.9,
                        "map_url": "https://maps.example.test/place/northstar-learning-lab",
                        "website_url": "https://example.test/northstar-learning-lab",
                        "public_phone": "+1-555-010-0100",
                        "public_email": "events@example.test",
                        "arrival_instructions": "Use the signed visitor entrance.",
                        "accessibility_summary": "Step-free entrance and accessible seating are available."
                      },
                      "version": 2,
                      "updated_at": "2026-08-25T15:00:00Z"
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null,
                  "window": {
                    "start": "2026-08-25T00:00:00.000Z",
                    "end": "2028-08-25T00:00:00.000Z"
                  },
                  "links": {
                    "self": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/occurrences?limit=250",
                    "next": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/offerings/{event_slug}/registration": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get public event registration bootstrap",
        "description": "Read the bounded registration bootstrap for one published ticket option, including ready/fail-closed checkout state, quantity bounds, assignment policy, safe field vocabulary, and links to the paged definition and agenda.",
        "operationId": "getPublicEventRegistrationBootstrap",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "event_slug",
            "in": "path",
            "required": true,
            "description": "Opaque event slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "ticket_option_id",
            "in": "query",
            "required": true,
            "description": "Opaque event ticket-option identifier within the published offering.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get public event registration bootstrap response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventRegistrationBootstrap"
                },
                "example": {
                  "api_version": "2026-08-25",
                  "tenant_id": "40000000-0000-4000-8000-000000000001",
                  "feed_id": "10000000-0000-4000-8000-000000000015",
                  "ticket_option_scope": "10000000-0000-4000-8000-000000000008",
                  "offering": {
                    "id": "10000000-0000-4000-8000-000000000001",
                    "slug": "robotics-discovery-camp",
                    "name": "Robotics Discovery Camp",
                    "timezone": "America/New_York",
                    "registration_opens_at": "2026-08-25T13:00:00Z",
                    "registration_closes_at": "2026-09-13T23:59:00Z",
                    "minimum_age_months": 96,
                    "maximum_age_months": 156
                  },
                  "ticket_option": {
                    "id": "10000000-0000-4000-8000-000000000008",
                    "code": "FULL-DAY",
                    "label": "Full day",
                    "description": "Admission to morning, supervised lunch bridge, and afternoon camp sessions.",
                    "product_id": "20000000-0000-4000-8000-000000000001",
                    "product_slug": "robotics-camp-full-day",
                    "product_name": "Robotics camp — full day",
                    "sku": "DEMO-CAMP-FULL",
                    "price_amount": 595,
                    "currency": "USD",
                    "minimum_per_order": 1,
                    "maximum_per_order": 4,
                    "seats_per_ticket": 1,
                    "assignment_policy": "at_checkout",
                    "assignment_deadline_at": null,
                    "sales_opens_at": "2026-08-25T13:00:00Z",
                    "sales_closes_at": "2026-09-13T23:59:00Z",
                    "remaining_seats": 6,
                    "maximum_purchasable_quantity": 4,
                    "checkout_status": "ready",
                    "purchase_url": "/store/northstar-learning/product/robotics-camp-full-day?eventTenant=40000000-0000-4000-8000-000000000001&eventFeed=northstar-learning-events&eventOffering=robotics-discovery-camp&eventTicketOption=10000000-0000-4000-8000-000000000008",
                    "registration_url": null,
                    "tenant_storefront_slug": "northstar-learning"
                  },
                  "definition_counts": {
                    "occurrence_entitlements": 3,
                    "selection_groups": 1,
                    "form_assignments": 1,
                    "questions": 1,
                    "waiver_assignments": 1,
                    "addons": 1
                  },
                  "definition_page": {
                    "resource": "registration_definitions",
                    "maximum_page_size": 100
                  },
                  "agenda": {
                    "resource": "agenda",
                    "maximum_page_size": 500
                  },
                  "checkout_extensions": {
                    "access_code_sets": [],
                    "physical_seating": {
                      "policy": "required",
                      "available_seat_count": 48,
                      "config_count": 1,
                      "seat_page": {
                        "default_page_size": 100,
                        "maximum_page_size": 250
                      },
                      "configs": [
                        {
                          "id": "10000000-0000-4000-8000-000000000042",
                          "occurrence_id": "10000000-0000-4000-8000-000000000002",
                          "occurrence_instance_id": "10000000-0000-4000-8000-000000000029",
                          "occurrence": {
                            "name": "Morning camp",
                            "starts_at": "2026-09-14T13:00:00Z",
                            "ends_at": "2026-09-14T16:00:00Z",
                            "timezone": "America/New_York"
                          },
                          "selection_mode": "reserved",
                          "hold_duration_seconds": 600,
                          "allow_accessible_companion_override": false,
                          "sales_closes_at": "2026-09-13T23:59:00Z",
                          "layout": {
                            "id": "10000000-0000-4000-8000-000000000047",
                            "name": "Northstar Lab seating",
                            "canvas_width": 1200,
                            "canvas_height": 800,
                            "background_asset_url": null
                          },
                          "venue": {
                            "id": "10000000-0000-4000-8000-000000000041",
                            "name": "Northstar Learning Lab",
                            "timezone": "America/New_York",
                            "address": {
                              "address_line_1": "100 Example Avenue",
                              "locality": "Sample City",
                              "administrative_area": "OH",
                              "postal_code": "43000",
                              "country_code": "US",
                              "latitude": 40.1,
                              "longitude": -82.9
                            }
                          },
                          "available_seat_count": 48
                        }
                      ]
                    }
                  },
                  "purchaser_fields": [
                    "first_name",
                    "last_name",
                    "email",
                    "phone"
                  ],
                  "participant_fields": [
                    "first_name",
                    "last_name",
                    "preferred_name",
                    "email",
                    "phone",
                    "birth_date",
                    "accessibility_summary"
                  ],
                  "guardian_fields": [
                    "relationship_label",
                    "portal_visible",
                    "portal_authorized",
                    "can_manage_registration",
                    "can_receive_notifications"
                  ],
                  "links": {
                    "self": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/registration?ticket_option_id=10000000-0000-4000-8000-000000000008",
                    "offering": "https://pos.getcentri.com/events/feed/40000000-0000-4000-8000-000000000001/northstar-learning-events/robotics-discovery-camp",
                    "registration_definition": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/registration-definition",
                    "agenda": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/agenda",
                    "registration_seats": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/registration-seats"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/offerings/{event_slug}/registration-definition": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List a public registration-definition page",
        "description": "Page the ticket’s bounded, anonymous-safe occurrence entitlements, selection groups and memberships, forms and questions, waivers, add-ons, and variants. Resource-specific identifier filters are repeatable query parameters.",
        "operationId": "listPublicEventRegistrationDefinition",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "event_slug",
            "in": "path",
            "required": true,
            "description": "Opaque event slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "ticket_option_id",
            "in": "query",
            "required": true,
            "description": "Opaque event ticket-option identifier within the published offering.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "resource",
            "in": "query",
            "required": true,
            "description": "Registration-definition resource page to return.",
            "schema": {
              "type": "string",
              "enum": [
                "occurrences",
                "selection_groups",
                "selection_group_occurrences",
                "forms",
                "questions",
                "waivers",
                "addons",
                "variants"
              ]
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "pattern": "^[A-Za-z0-9_-]+$"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 100
            }
          },
          {
            "name": "form_id",
            "in": "query",
            "required": false,
            "description": "One or more assigned form identifiers; required only for the questions resource.",
            "schema": {
              "type": "array",
              "maxItems": 100,
              "items": {
                "type": "string",
                "format": "uuid"
              }
            }
          },
          {
            "name": "product_id",
            "in": "query",
            "required": false,
            "description": "One or more assigned add-on product identifiers; required only for the variants resource.",
            "schema": {
              "type": "array",
              "maxItems": 100,
              "items": {
                "type": "string",
                "format": "uuid"
              }
            }
          },
          {
            "name": "selection_group_id",
            "in": "query",
            "required": false,
            "description": "One or more selection-group identifiers; required only for selection-group occurrences.",
            "schema": {
              "type": "array",
              "maxItems": 100,
              "items": {
                "type": "string",
                "format": "uuid"
              }
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List a public registration-definition page response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Link": {
                "description": "RFC 8288 rel=\"next\" URL when another definition page exists.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventRegistrationDefinitionPage"
                },
                "example": {
                  "api_version": "2026-08-25",
                  "resource": "occurrences",
                  "data": [
                    {
                      "id": "10000000-0000-4000-8000-000000000002",
                      "occurrence_key": "camp-2026-09-14-am",
                      "name": "Morning camp",
                      "session_kind": "morning",
                      "enrollment_policy": "entitlement_only",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_name": "Northstar Learning Lab",
                      "space_id": "10000000-0000-4000-8000-000000000030",
                      "sort_order": 10
                    },
                    {
                      "id": "10000000-0000-4000-8000-000000000040",
                      "occurrence_key": "camp-2026-09-14-lunch",
                      "name": "Supervised lunch bridge",
                      "session_kind": "lunch_bridge",
                      "enrollment_policy": "entitlement_only",
                      "starts_at": "2026-09-14T16:00:00Z",
                      "ends_at": "2026-09-14T17:00:00Z",
                      "timezone": "America/New_York",
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_name": "Northstar Learning Lab",
                      "space_id": "10000000-0000-4000-8000-000000000030",
                      "sort_order": 20
                    },
                    {
                      "id": "10000000-0000-4000-8000-000000000003",
                      "occurrence_key": "camp-2026-09-14-pm",
                      "name": "Afternoon camp",
                      "session_kind": "afternoon",
                      "enrollment_policy": "entitlement_only",
                      "starts_at": "2026-09-14T17:00:00Z",
                      "ends_at": "2026-09-14T20:00:00Z",
                      "timezone": "America/New_York",
                      "recurrence_rule": "FREQ=DAILY;COUNT=5",
                      "venue_name": "Northstar Learning Lab",
                      "space_id": "10000000-0000-4000-8000-000000000030",
                      "sort_order": 30
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null,
                  "page_byte_limit": 1500000,
                  "links": {
                    "self": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/registration-definition?ticket_option_id=10000000-0000-4000-8000-000000000008&resource=occurrences&limit=100",
                    "next": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "The bounded registration-definition page exceeds 1.5 MB.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/offerings/{event_slug}/registration-seats": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "List public registration seats",
        "description": "Page only currently available seats authorized for the published ticket and effective reusable venue. Safe section, row, accessibility, geometry, and pricing-zone fields are returned without holder, purchaser, registration, ticket, or inventory-internal data.",
        "operationId": "listPublicEventRegistrationSeats",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "event_slug",
            "in": "path",
            "required": true,
            "description": "Opaque event slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "ticket_option_id",
            "in": "query",
            "required": true,
            "description": "Opaque event ticket-option identifier within the published offering.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "seating_config_id",
            "in": "query",
            "required": false,
            "description": "Filter by seating config id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "section_id",
            "in": "query",
            "required": false,
            "description": "Filter by section id.",
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Filter by search.",
            "schema": {
              "type": "string",
              "maxLength": 80
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2000
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 250,
              "default": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List public registration seats response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Link": {
                "description": "RFC 8288 rel=\"next\" URL while another available-seat page remains.",
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventRegistrationSeatPage"
                },
                "example": {
                  "api_version": "2026-08-25",
                  "data": [
                    {
                      "seating_config_id": "10000000-0000-4000-8000-000000000042",
                      "id": "10000000-0000-4000-8000-000000000045",
                      "code": "A-01",
                      "label": "A1",
                      "section": {
                        "id": "10000000-0000-4000-8000-000000000043",
                        "name": "Main floor",
                        "color": "#3346d3",
                        "sort_order": 10
                      },
                      "row": {
                        "id": "10000000-0000-4000-8000-000000000044",
                        "label": "A",
                        "sort_order": 10
                      },
                      "x": 120,
                      "y": 160,
                      "rotation_degrees": 0,
                      "accessibility_type": "wheelchair",
                      "accessibility_notes": "Synthetic step-free position.",
                      "companion_group": "A-ACCESSIBLE-1",
                      "obstructed_view": false,
                      "pricing_zone": {
                        "id": "10000000-0000-4000-8000-000000000046",
                        "name": "Standard",
                        "color": "#f97316",
                        "sort_order": 10,
                        "price_adjustment": 0,
                        "currency": "USD",
                        "minimum_seats": 1,
                        "maximum_seats": 4
                      }
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null,
                  "page_byte_limit": 1500000,
                  "links": {
                    "self": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/registration-seats?ticket_option_id=10000000-0000-4000-8000-000000000008&seating_config_id=10000000-0000-4000-8000-000000000042&limit=100",
                    "next": null
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "The bounded available-seat page exceeds 1.5 MB.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/offerings/{event_slug}/agenda": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Get a public event agenda",
        "description": "Read up to 500 concrete agenda instances inside a window of at most 366 days, with optional track, space, and ticket entitlement filters. Supply both cursor fields together for the next page.",
        "operationId": "getPublicEventAgenda",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "event_slug",
            "in": "path",
            "required": true,
            "description": "Opaque event slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "window_start",
            "in": "query",
            "required": false,
            "description": "Inclusive agenda window start as an RFC 3339 timestamp.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "window_end",
            "in": "query",
            "required": false,
            "description": "Exclusive agenda window end as an RFC 3339 timestamp; the window may span at most 366 days.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500,
              "default": 100
            }
          },
          {
            "name": "after_starts_at",
            "in": "query",
            "required": false,
            "description": "Agenda cursor timestamp; supply together with after_instance_id.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "after_instance_id",
            "in": "query",
            "required": false,
            "description": "Agenda cursor instance identifier; supply together with after_starts_at.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "track_id",
            "in": "query",
            "required": false,
            "description": "Filter the public agenda to one active event track.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "space_id",
            "in": "query",
            "required": false,
            "description": "Filter the public agenda to one active event space.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "ticket_option_id",
            "in": "query",
            "required": false,
            "description": "Opaque event ticket-option identifier within the published offering.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get a public event agenda response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventAgendaPage"
                },
                "example": {
                  "api_version": "2026-08-25",
                  "items": [
                    {
                      "instance_id": "10000000-0000-4000-8000-000000000029",
                      "instance_key": "i_2eb330438a5137b15d3d8f0b2ff4bd5e9bbc2a3f2db213e7",
                      "original_start_at": "2026-09-14T13:00:00Z",
                      "starts_at": "2026-09-14T13:00:00Z",
                      "ends_at": "2026-09-14T16:00:00Z",
                      "timezone": "America/New_York",
                      "status": "scheduled",
                      "occurrence_id": "10000000-0000-4000-8000-000000000002",
                      "occurrence_key": "camp-2026-09-14-am",
                      "name": "Morning camp",
                      "session_kind": "morning",
                      "enrollment_policy": "entitlement_only",
                      "all_day": false,
                      "venue_name": "Northstar Learning Lab",
                      "space": {
                        "id": "10000000-0000-4000-8000-000000000030",
                        "code": "LAB-A",
                        "name": "Robotics Lab A",
                        "venue_name": "Northstar Learning Lab",
                        "capacity": 24
                      },
                      "tracks": [
                        {
                          "id": "10000000-0000-4000-8000-000000000031",
                          "code": "ROBOTICS",
                          "name": "Robotics",
                          "description": "Synthetic conference and camp robotics sessions.",
                          "color": "#3346d3"
                        }
                      ],
                      "selection_group_ids": [
                        "10000000-0000-4000-8000-000000000035"
                      ],
                      "stakeholders": [
                        {
                          "role": "instructor",
                          "role_label": "Morning lead instructor",
                          "person": {
                            "id": "10000000-0000-4000-8000-000000000032",
                            "display_name": "Jordan Example",
                            "title": "Lead instructor",
                            "bio_html": "<p>Synthetic instructor profile for documentation.</p>",
                            "photo_url": "https://pos.getcentri.com/media/events/synthetic/jordan-example.webp"
                          },
                          "organization": null
                        }
                      ]
                    }
                  ],
                  "has_more": false,
                  "next_cursor": null,
                  "links": {
                    "self": "https://pos.getcentri.com/api/events/40000000-0000-4000-8000-000000000001/northstar-learning-events/offerings/robotics-discovery-camp/agenda"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "The public agenda page exceeds its 2 MiB response bound.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public",
        "x-centripos-query-parameter-pairs": [
          [
            "after_starts_at",
            "after_instance_id"
          ]
        ]
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/calendar.ics": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Download a public event calendar",
        "description": "Download the attendee-safe iCalendar projection for published occurrences in one tenant-qualified feed. Recurring series use stable UIDs and RRULE; cancelled instances use EXDATE; cancelled, rescheduled, or modified overrides use RECURRENCE-ID components. The default single file is bounded to 5,000 occurrences, 10,000 exceptions, and 8 MiB; a 413 calendar_export_requires_pagination response provides first_page and page_size_maximum, after which clients use page_size 1–500, opaque cursor, Link rel=\"next\", and X-CentriPOS-Calendar-Partial.",
        "operationId": "getPublicEventCalendar",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "description": "Maximum iCalendar items to return, from 1 through 500. Supply page_size when using cursor.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Download a public event calendar response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Link": {
                "description": "RFC 8288 rel=\"next\" URL while another calendar page remains.",
                "schema": {
                  "type": "string"
                }
              },
              "X-CentriPOS-Next-Cursor": {
                "description": "Opaque cursor for the next calendar page.",
                "schema": {
                  "type": "string"
                }
              },
              "X-CentriPOS-Calendar-Partial": {
                "description": "true until the final paged calendar response.",
                "schema": {
                  "type": "boolean"
                }
              }
            },
            "content": {
              "text/calendar; charset=utf-8": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventCalendar"
                },
                "example": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//CentriPOS//Scheduled Offerings//EN\r\nCALSCALE:GREGORIAN\r\nMETHOD:PUBLISH\r\nBEGIN:VEVENT\r\nUID:evt-10000000-0000-4000-8000-000000000001-10000000-0000-4000-8000-000000000002@pos.getcentri.com\r\nDTSTART:20260914T190000Z\r\nDTEND:20260914T201500Z\r\nRRULE:FREQ=WEEKLY;COUNT=8;BYDAY=MO\r\nEXDATE:20261012T190000Z\r\nSUMMARY:Robotics Afterschool Series\r\nEND:VEVENT\r\nBEGIN:VEVENT\r\nUID:evt-10000000-0000-4000-8000-000000000001-10000000-0000-4000-8000-000000000002@pos.getcentri.com\r\nRECURRENCE-ID:20261019T190000Z\r\nDTSTART:20261020T190000Z\r\nDTEND:20261020T201500Z\r\nSUMMARY:Robotics Afterschool Series · rescheduled\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "The single calendar exceeds 5,000 occurrences, 10,000 exceptions, or 8 MiB; the 413 calendar_export_requires_pagination response provides first_page and page_size_maximum.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                },
                "example": {
                  "error": {
                    "code": "calendar_export_requires_pagination",
                    "message": "The calendar export exceeds the single-file safety bound.",
                    "request_id": "req_test_calendar_pagination",
                    "details": [
                      {
                        "first_page": "/api/events/{tenant_id}/{feed_slug}/calendar.ics?page_size=500",
                        "page_size_maximum": 500,
                        "continuation": "Follow Link rel=\"next\" until X-CentriPOS-Calendar-Partial is false."
                      }
                    ]
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/offerings/{event_slug}/calendar.ics": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Download a public offering calendar",
        "description": "Download the same attendee-safe iCalendar contract scoped to one published offering. A normal request returns the complete bounded file; an oversized export returns 413 calendar_export_requires_pagination with first_page and page_size_maximum. Continue with page_size 1–500 and the opaque cursor, Link rel=\"next\", X-CentriPOS-Next-Cursor, and X-CentriPOS-Calendar-Partial headers.",
        "operationId": "getPublicEventOfferingCalendar",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "event_slug",
            "in": "path",
            "required": true,
            "description": "Opaque event slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "description": "Maximum iCalendar items to return, from 1 through 500. Supply page_size when using cursor.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 500
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "Opaque cursor returned as next_cursor by the preceding page; do not construct or alter it.",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 4096
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Download a public offering calendar response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Link": {
                "description": "RFC 8288 rel=\"next\" URL while another offering-calendar page remains.",
                "schema": {
                  "type": "string"
                }
              },
              "X-CentriPOS-Next-Cursor": {
                "description": "Opaque cursor for the next offering-calendar page.",
                "schema": {
                  "type": "string"
                }
              },
              "X-CentriPOS-Calendar-Partial": {
                "description": "true until the final paged offering-calendar response.",
                "schema": {
                  "type": "boolean"
                }
              }
            },
            "content": {
              "text/calendar; charset=utf-8": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventOfferingCalendar"
                },
                "example": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//CentriPOS//Scheduled Offerings//EN\r\nCALSCALE:GREGORIAN\r\nMETHOD:PUBLISH\r\nBEGIN:VEVENT\r\nUID:evt-10000000-0000-4000-8000-000000000001-10000000-0000-4000-8000-000000000002@pos.getcentri.com\r\nDTSTART:20260914T130000Z\r\nDTEND:20260914T160000Z\r\nSUMMARY:Robotics Discovery Camp — morning\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "The single offering calendar exceeds 5,000 occurrences, 10,000 exceptions, or 8 MiB; the 413 calendar_export_requires_pagination response provides first_page and page_size_maximum.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                },
                "example": {
                  "error": {
                    "code": "calendar_export_requires_pagination",
                    "message": "The calendar export exceeds the single-file safety bound.",
                    "request_id": "req_test_calendar_pagination",
                    "details": [
                      {
                        "first_page": "/api/events/{tenant_id}/{feed_slug}/offerings/{event_slug}/calendar.ics?page_size=500",
                        "page_size_maximum": 500,
                        "continuation": "Follow Link rel=\"next\" until X-CentriPOS-Calendar-Partial is false."
                      }
                    ]
                  }
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/calendar-subscription.ics": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Subscribe to a public event calendar",
        "description": "Return one stable, bounded rolling attendee-safe calendar for Apple Calendar and webcal subscribers. Unlike the complete snapshot export, this route accepts no pagination parameters and refreshes the same branded URL.",
        "operationId": "subscribePublicEventCalendar",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Subscribe to a public event calendar response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "X-CentriPOS-Calendar-Partial": {
                "description": "true when the bounded rolling window was compacted to stay within the response limit.",
                "schema": {
                  "type": "boolean"
                }
              },
              "X-CentriPOS-Calendar-Window-Start": {
                "description": "Inclusive start of the rolling subscription window.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "X-CentriPOS-Calendar-Window-End": {
                "description": "Exclusive end of the rolling subscription window.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "X-CentriPOS-Calendar-Item-Count": {
                "description": "Number of occurrence definitions included in this refresh.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "text/calendar; charset=utf-8": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventCalendarSubscription"
                },
                "example": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//CentriPOS//Scheduled Offerings//EN\r\nCALSCALE:GREGORIAN\r\nMETHOD:PUBLISH\r\nX-WR-CALNAME:Northstar Learning events\r\nBEGIN:VEVENT\r\nUID:evt-10000000-0000-4000-8000-000000000001-10000000-0000-4000-8000-000000000002@pos.getcentri.com\r\nDTSTART:20260914T130000Z\r\nDTEND:20260914T160000Z\r\nSUMMARY:Robotics Discovery Camp — morning\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/events/{tenant_id}/{feed_slug}/offerings/{event_slug}/calendar-subscription.ics": {
      "get": {
        "tags": [
          "Events & scheduled offerings"
        ],
        "summary": "Subscribe to a public offering calendar",
        "description": "Return the rolling subscription contract scoped to one published offering. The stable URL is suitable for Apple Calendar or webcal refreshes and does not expose participant, registration, ticket, access-code, or seat-holder data.",
        "operationId": "subscribePublicEventOfferingCalendar",
        "security": [],
        "parameters": [
          {
            "name": "tenant_id",
            "in": "path",
            "required": true,
            "description": "Opaque tenant id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "feed_slug",
            "in": "path",
            "required": true,
            "description": "Opaque feed slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "event_slug",
            "in": "path",
            "required": true,
            "description": "Opaque event slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Subscribe to a public offering calendar response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "X-CentriPOS-Calendar-Partial": {
                "description": "true when the bounded rolling offering window was compacted to stay within the response limit.",
                "schema": {
                  "type": "boolean"
                }
              },
              "X-CentriPOS-Calendar-Window-Start": {
                "description": "Inclusive start of the rolling subscription window.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "X-CentriPOS-Calendar-Window-End": {
                "description": "Exclusive end of the rolling subscription window.",
                "schema": {
                  "type": "string",
                  "format": "date-time"
                }
              },
              "X-CentriPOS-Calendar-Item-Count": {
                "description": "Number of occurrence definitions included in this refresh.",
                "schema": {
                  "type": "integer"
                }
              }
            },
            "content": {
              "text/calendar; charset=utf-8": {
                "schema": {
                  "$ref": "#/components/schemas/PublicEventOfferingCalendarSubscription"
                },
                "example": "BEGIN:VCALENDAR\r\nVERSION:2.0\r\nPRODID:-//CentriPOS//Scheduled Offerings//EN\r\nCALSCALE:GREGORIAN\r\nMETHOD:PUBLISH\r\nX-WR-CALNAME:Robotics Discovery Camp\r\nBEGIN:VEVENT\r\nUID:evt-10000000-0000-4000-8000-000000000001-10000000-0000-4000-8000-000000000002@pos.getcentri.com\r\nDTSTART:20260914T130000Z\r\nDTEND:20260914T160000Z\r\nSUMMARY:Robotics Discovery Camp — morning\r\nEND:VEVENT\r\nEND:VCALENDAR\r\n"
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/storefront/v1/{storefront_slug}": {
      "get": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Get storefront feed",
        "description": "Read one merchant-published browser-safe storefront projection.",
        "operationId": "public_storefront_feed",
        "security": [],
        "parameters": [
          {
            "name": "storefront_slug",
            "in": "path",
            "required": true,
            "description": "Opaque storefront slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get storefront feed response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StorefrontEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "storefront": {
                    "slug": "northstar-sleep-demo",
                    "name": "Northstar Home & Sleep"
                  },
                  "catalog": {
                    "products": [
                      {
                        "id": "prd_test_01J9HARBOR12",
                        "handle": "harbor-12-hybrid-mattress",
                        "name": "Harbor 12-inch Hybrid Mattress",
                        "brand": {
                          "id": "brd_test_northstar",
                          "name": "Northstar Sleep"
                        },
                        "status": "active",
                        "sellable": true,
                        "online_backorder_policy": {
                          "mode": "allow_notify",
                          "max_backorder_quantity": 2,
                          "eta_days": 10,
                          "customer_message": "Available on backorder. Estimated fulfillment in 10 days."
                        },
                        "description": "A balanced hybrid with responsive support and a quilted comfort surface.",
                        "category": {
                          "id": "cat_test_mattresses",
                          "name": "Mattresses",
                          "slug": "mattresses"
                        },
                        "tags": [
                          {
                            "id": "tag_test_hybrid",
                            "name": "Hybrid",
                            "slug": "hybrid"
                          }
                        ],
                        "variants": [
                          {
                            "id": "var_test_01J9HARBORQUEEN",
                            "name": "Queen / Medium",
                            "sku": "DEMO-HBR-Q-MED",
                            "barcode": "000000000001",
                            "price": {
                              "amount": 1699,
                              "currency": "USD"
                            },
                            "options": [
                              {
                                "name": "Size",
                                "value": "Queen"
                              },
                              {
                                "name": "Feel",
                                "value": "Medium"
                              }
                            ],
                            "inventory": {
                              "tracked": true,
                              "available": 6,
                              "reserved": 1,
                              "incoming": 4
                            },
                            "online_backorder_policy": {
                              "mode": "inherit",
                              "max_backorder_quantity": null,
                              "eta_days": null,
                              "customer_message": null
                            }
                          }
                        ],
                        "custom_fields": {
                          "price_area": [
                            {
                              "key": "warranty_years",
                              "label": "Warranty",
                              "value": 15,
                              "value_type": "number"
                            }
                          ],
                          "description": [
                            {
                              "key": "construction",
                              "label": "Construction",
                              "value": "Hybrid",
                              "value_type": "text"
                            }
                          ],
                          "specifications": [
                            {
                              "key": "profile_height",
                              "label": "Profile height",
                              "value": 12,
                              "unit": "in",
                              "value_type": "number"
                            },
                            {
                              "key": "firmness_level",
                              "label": "Firmness level",
                              "value": 6,
                              "value_type": "number"
                            }
                          ]
                        },
                        "media": [
                          {
                            "id": "med_test_01J9HARBORFRONT",
                            "type": "image",
                            "role": "primary",
                            "alt": "Synthetic Harbor mattress product render",
                            "url": "https://pos.getcentri.com/media/product/demo/harbor-12-front.webp"
                          }
                        ],
                        "created_at": "2026-07-14T16:03:11Z",
                        "updated_at": "2026-08-22T19:45:02Z"
                      }
                    ]
                  },
                  "links": {
                    "self": "https://pos.getcentri.com/api/storefront/v1/northstar-sleep-demo"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/storefront/v1/{storefront_slug}/catalog": {
      "get": {
        "tags": [
          "Public storefront"
        ],
        "summary": "List published catalog",
        "description": "Read published products, variants, taxonomy, filters, facets, and approved commerce fields.",
        "operationId": "public_storefront_catalog",
        "security": [],
        "parameters": [
          {
            "name": "storefront_slug",
            "in": "path",
            "required": true,
            "description": "Opaque storefront slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "search",
            "in": "query",
            "required": false,
            "description": "Filter by search.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "category",
            "in": "query",
            "required": false,
            "description": "Filter by category.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "brand",
            "in": "query",
            "required": false,
            "description": "Filter by brand.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "tag",
            "in": "query",
            "required": false,
            "description": "Filter by tag.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "min_price",
            "in": "query",
            "required": false,
            "description": "Filter by min price.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "max_price",
            "in": "query",
            "required": false,
            "description": "Filter by max price.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "in_stock",
            "in": "query",
            "required": false,
            "description": "Filter by in stock.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "description": "Filter by page.",
            "schema": {
              "type": "string",
              "maxLength": 512
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximum records to return. The contract default is 50 and maximum is 100.",
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "default": 50
            }
          }
        ],
        "responses": {
          "200": {
            "description": "List published catalog response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StorefrontCatalogEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": [
                    {
                      "id": "prd_test_01J9HARBOR12",
                      "handle": "harbor-12-hybrid-mattress",
                      "name": "Harbor 12-inch Hybrid Mattress",
                      "brand": {
                        "id": "brd_test_northstar",
                        "name": "Northstar Sleep"
                      },
                      "status": "active",
                      "sellable": true,
                      "online_backorder_policy": {
                        "mode": "allow_notify",
                        "max_backorder_quantity": 2,
                        "eta_days": 10,
                        "customer_message": "Available on backorder. Estimated fulfillment in 10 days."
                      },
                      "description": "A balanced hybrid with responsive support and a quilted comfort surface.",
                      "category": {
                        "id": "cat_test_mattresses",
                        "name": "Mattresses",
                        "slug": "mattresses"
                      },
                      "tags": [
                        {
                          "id": "tag_test_hybrid",
                          "name": "Hybrid",
                          "slug": "hybrid"
                        }
                      ],
                      "variants": [
                        {
                          "id": "var_test_01J9HARBORQUEEN",
                          "name": "Queen / Medium",
                          "sku": "DEMO-HBR-Q-MED",
                          "barcode": "000000000001",
                          "price": {
                            "amount": 1699,
                            "currency": "USD"
                          },
                          "options": [
                            {
                              "name": "Size",
                              "value": "Queen"
                            },
                            {
                              "name": "Feel",
                              "value": "Medium"
                            }
                          ],
                          "inventory": {
                            "tracked": true,
                            "available": 6,
                            "reserved": 1,
                            "incoming": 4
                          },
                          "online_backorder_policy": {
                            "mode": "inherit",
                            "max_backorder_quantity": null,
                            "eta_days": null,
                            "customer_message": null
                          }
                        }
                      ],
                      "custom_fields": {
                        "price_area": [
                          {
                            "key": "warranty_years",
                            "label": "Warranty",
                            "value": 15,
                            "value_type": "number"
                          }
                        ],
                        "description": [
                          {
                            "key": "construction",
                            "label": "Construction",
                            "value": "Hybrid",
                            "value_type": "text"
                          }
                        ],
                        "specifications": [
                          {
                            "key": "profile_height",
                            "label": "Profile height",
                            "value": 12,
                            "unit": "in",
                            "value_type": "number"
                          },
                          {
                            "key": "firmness_level",
                            "label": "Firmness level",
                            "value": 6,
                            "value_type": "number"
                          }
                        ]
                      },
                      "media": [
                        {
                          "id": "med_test_01J9HARBORFRONT",
                          "type": "image",
                          "role": "primary",
                          "alt": "Synthetic Harbor mattress product render",
                          "url": "https://pos.getcentri.com/media/product/demo/harbor-12-front.webp"
                        }
                      ],
                      "created_at": "2026-07-14T16:03:11Z",
                      "updated_at": "2026-08-22T19:45:02Z"
                    }
                  ],
                  "pagination": {
                    "page": 1,
                    "limit": 24,
                    "total": 1
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/storefront/v1/{storefront_slug}/products/{product_slug}": {
      "get": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Get published product",
        "description": "Read one published product addressed by its customer-facing slug.",
        "operationId": "public_storefront_product",
        "security": [],
        "parameters": [
          {
            "name": "storefront_slug",
            "in": "path",
            "required": true,
            "description": "Opaque storefront slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          },
          {
            "name": "product_slug",
            "in": "path",
            "required": true,
            "description": "Opaque product slug. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "minLength": 3,
              "maxLength": 160
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get published product response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "$ref": "#/components/headers/ApiVersion"
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StorefrontProductEnvelope"
                },
                "example": {
                  "api_version": "2026-08-24",
                  "data": {
                    "id": "prd_test_01J9HARBOR12",
                    "handle": "harbor-12-hybrid-mattress",
                    "name": "Harbor 12-inch Hybrid Mattress",
                    "brand": {
                      "id": "brd_test_northstar",
                      "name": "Northstar Sleep"
                    },
                    "status": "active",
                    "sellable": true,
                    "online_backorder_policy": {
                      "mode": "allow_notify",
                      "max_backorder_quantity": 2,
                      "eta_days": 10,
                      "customer_message": "Available on backorder. Estimated fulfillment in 10 days."
                    },
                    "description": "A balanced hybrid with responsive support and a quilted comfort surface.",
                    "category": {
                      "id": "cat_test_mattresses",
                      "name": "Mattresses",
                      "slug": "mattresses"
                    },
                    "tags": [
                      {
                        "id": "tag_test_hybrid",
                        "name": "Hybrid",
                        "slug": "hybrid"
                      }
                    ],
                    "variants": [
                      {
                        "id": "var_test_01J9HARBORQUEEN",
                        "name": "Queen / Medium",
                        "sku": "DEMO-HBR-Q-MED",
                        "barcode": "000000000001",
                        "price": {
                          "amount": 1699,
                          "currency": "USD"
                        },
                        "options": [
                          {
                            "name": "Size",
                            "value": "Queen"
                          },
                          {
                            "name": "Feel",
                            "value": "Medium"
                          }
                        ],
                        "inventory": {
                          "tracked": true,
                          "available": 6,
                          "reserved": 1,
                          "incoming": 4
                        },
                        "online_backorder_policy": {
                          "mode": "inherit",
                          "max_backorder_quantity": null,
                          "eta_days": null,
                          "customer_message": null
                        }
                      }
                    ],
                    "custom_fields": {
                      "price_area": [
                        {
                          "key": "warranty_years",
                          "label": "Warranty",
                          "value": 15,
                          "value_type": "number"
                        }
                      ],
                      "description": [
                        {
                          "key": "construction",
                          "label": "Construction",
                          "value": "Hybrid",
                          "value_type": "text"
                        }
                      ],
                      "specifications": [
                        {
                          "key": "profile_height",
                          "label": "Profile height",
                          "value": 12,
                          "unit": "in",
                          "value_type": "number"
                        },
                        {
                          "key": "firmness_level",
                          "label": "Firmness level",
                          "value": 6,
                          "value_type": "number"
                        }
                      ]
                    },
                    "media": [
                      {
                        "id": "med_test_01J9HARBORFRONT",
                        "type": "image",
                        "role": "primary",
                        "alt": "Synthetic Harbor mattress product render",
                        "url": "https://pos.getcentri.com/media/product/demo/harbor-12-front.webp"
                      }
                    ],
                    "created_at": "2026-07-14T16:03:11Z",
                    "updated_at": "2026-08-22T19:45:02Z"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "live",
        "x-required-scope": "Public"
      }
    },
    "/api/retail/v1/storefront/resolve": {
      "get": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Resolve certified storefront checkout",
        "description": "Resolve checkout capabilities from the tenant-bound credential. The caller cannot select a tenant, data plane, hostname, or storefront slug. Certified server integration only; activation is bound to the approved tenant and API client.",
        "operationId": "certified_storefront_resolve",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [],
        "responses": {
          "200": {
            "description": "Resolve certified storefront checkout response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "description": "Date-pinned certified storefront contract version.",
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertifiedStorefrontResolveEnvelope"
                },
                "example": {
                  "data": {
                    "tenant_name": "Northstar Home & Sleep",
                    "storefront": {
                      "slug": "northstar-sleep-demo",
                      "store_name": "Northstar Home & Sleep",
                      "store_description": "Synthetic storefront used only for documentation.",
                      "primary_color": "#16324f",
                      "accent_color": "#d08b3e",
                      "seo_title": "Northstar Home & Sleep",
                      "seo_description": "Synthetic sleep products.",
                      "logo_url": null,
                      "hero_image_url": null,
                      "custom_css": null,
                      "is_published": true
                    },
                    "checkout": {
                      "pickup_locations": [],
                      "delivery_methods": [],
                      "shipping_methods": [],
                      "gateway": null,
                      "financing": [],
                      "fulfillment_available": {
                        "pickup": false,
                        "local_delivery": false,
                        "shipping": false
                      },
                      "shipping_schedule": {
                        "mode": "open_ended",
                        "date_intent": "ship_on"
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-31",
                    "environment": "test",
                    "request_id": "req_test_storefront_resolve"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "certified-live",
        "x-required-scope": "storefront:read",
        "x-centripos-certification": {
          "required": true,
          "activation": "tenant-and-client-bound",
          "browser_secret_allowed": false
        }
      }
    },
    "/api/retail/v1/storefront/quotes": {
      "post": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Create authoritative storefront quote",
        "description": "Reprice inventory, address eligibility, promotions, tax, shipping or delivery fees, and line-level fulfillment on CentriPOS servers. Cart methods are the intersection of every line; split packages are not supported. Requires Idempotency-Key. Retry only with the byte-identical raw JSON request body; any byte difference conflicts. Stored replays carry Idempotency-Replayed: true. Client prices, tax, fees, inventory, promotions, and fulfillment eligibility are never authoritative.",
        "operationId": "certified_storefront_quote",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. A retry replays only when its raw JSON request body is byte-identical; any byte difference conflicts.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 200,
              "pattern": "^[A-Za-z0-9._:-]{16,200}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "items",
                  "customer",
                  "fulfillment_type"
                ],
                "properties": {
                  "items": {
                    "type": "array",
                    "minItems": 1,
                    "maxItems": 50,
                    "items": {
                      "type": "object",
                      "additionalProperties": false,
                      "required": [
                        "product_id",
                        "quantity"
                      ],
                      "properties": {
                        "product_id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "variant_id": {
                          "type": "string",
                          "format": "uuid"
                        },
                        "quantity": {
                          "type": "integer",
                          "minimum": 1,
                          "maximum": 99
                        }
                      }
                    }
                  },
                  "customer": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "firstName",
                      "email"
                    ],
                    "properties": {
                      "firstName": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "lastName": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "email": {
                        "type": "string",
                        "format": "email",
                        "maxLength": 254
                      },
                      "phone": {
                        "type": "string",
                        "maxLength": 40
                      },
                      "address": {
                        "type": "string",
                        "maxLength": 200
                      },
                      "city": {
                        "type": "string",
                        "maxLength": 100
                      },
                      "state": {
                        "type": "string",
                        "maxLength": 64
                      },
                      "zip": {
                        "type": "string",
                        "maxLength": 20
                      }
                    }
                  },
                  "fulfillment_type": {
                    "type": "string",
                    "enum": [
                      "pickup",
                      "local_delivery",
                      "shipping"
                    ]
                  },
                  "fulfillment_date": {
                    "type": "string",
                    "format": "date"
                  },
                  "fulfillment_time": {
                    "type": "string",
                    "maxLength": 64
                  },
                  "promotion_code": {
                    "type": "string",
                    "maxLength": 64,
                    "pattern": "^[A-Za-z0-9_-]*$"
                  },
                  "shipping_method_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "delivery_method_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "pickup_location_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "shipping_address": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [
                      "address",
                      "city",
                      "state",
                      "zip"
                    ],
                    "properties": {
                      "address": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 200
                      },
                      "city": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "state": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 64
                      },
                      "zip": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 20
                      }
                    }
                  }
                },
                "allOf": [
                  {
                    "if": {
                      "properties": {
                        "fulfillment_type": {
                          "const": "shipping"
                        }
                      }
                    },
                    "then": {
                      "required": [
                        "shipping_method_id",
                        "shipping_address"
                      ],
                      "not": {
                        "anyOf": [
                          {
                            "required": [
                              "delivery_method_id"
                            ]
                          },
                          {
                            "required": [
                              "pickup_location_id"
                            ]
                          }
                        ]
                      }
                    }
                  },
                  {
                    "if": {
                      "properties": {
                        "fulfillment_type": {
                          "const": "local_delivery"
                        }
                      }
                    },
                    "then": {
                      "required": [
                        "delivery_method_id",
                        "shipping_address",
                        "fulfillment_date"
                      ],
                      "not": {
                        "anyOf": [
                          {
                            "required": [
                              "shipping_method_id"
                            ]
                          },
                          {
                            "required": [
                              "pickup_location_id"
                            ]
                          }
                        ]
                      }
                    }
                  },
                  {
                    "if": {
                      "properties": {
                        "fulfillment_type": {
                          "const": "pickup"
                        }
                      }
                    },
                    "then": {
                      "required": [
                        "pickup_location_id",
                        "fulfillment_date"
                      ],
                      "not": {
                        "anyOf": [
                          {
                            "required": [
                              "shipping_method_id"
                            ]
                          },
                          {
                            "required": [
                              "delivery_method_id"
                            ]
                          },
                          {
                            "required": [
                              "shipping_address"
                            ]
                          }
                        ]
                      }
                    }
                  },
                  {
                    "if": {
                      "properties": {
                        "fulfillment_time": {
                          "minLength": 1
                        }
                      },
                      "required": [
                        "fulfillment_time"
                      ]
                    },
                    "then": {
                      "required": [
                        "fulfillment_date"
                      ]
                    }
                  }
                ]
              },
              "example": {
                "items": [
                  {
                    "product_id": "11111111-1111-4111-8111-111111111111",
                    "variant_id": "22222222-2222-4222-8222-222222222222",
                    "quantity": 2
                  }
                ],
                "customer": {
                  "firstName": "Alex",
                  "lastName": "Morgan",
                  "email": "alex.morgan@example.test",
                  "phone": "+1-555-010-0184",
                  "address": "100 Example Street",
                  "city": "Sample City",
                  "state": "IL",
                  "zip": "60000"
                },
                "fulfillment_type": "shipping",
                "shipping_method_id": "33333333-3333-4333-8333-333333333333",
                "shipping_address": {
                  "address": "100 Example Street",
                  "city": "Sample City",
                  "state": "IL",
                  "zip": "60000"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Create authoritative storefront quote response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "description": "Date-pinned certified storefront contract version.",
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Idempotency-Replayed": {
                "description": "Present with value true only when CentriPOS returns the stored response for a byte-identical idempotent replay.",
                "schema": {
                  "type": "string",
                  "const": "true"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertifiedStorefrontQuoteEnvelope"
                },
                "example": {
                  "data": {
                    "quote": {
                      "id": "44444444-4444-4444-8444-444444444444",
                      "status": "open",
                      "items": [
                        {
                          "product_id": "11111111-1111-4111-8111-111111111111",
                          "variant_id": "22222222-2222-4222-8222-222222222222",
                          "name": "Synthetic Boxed Mattress",
                          "variant_name": "Queen",
                          "sku": "SYN-BOX-Q",
                          "quantity": 2,
                          "unit_price": 799,
                          "original_unit_price": null,
                          "price_source": {
                            "type": "catalog"
                          },
                          "line_total": 1598,
                          "shipping_fee": 100,
                          "fulfillment": {
                            "packaging": "boxed",
                            "allowed_methods": [
                              "pickup",
                              "local_delivery",
                              "shipping"
                            ],
                            "nationwide_shipping": {
                              "available": true,
                              "pricing_type": "flat",
                              "fee": 50,
                              "region": "continental_us"
                            }
                          },
                          "fulfillment_badges": [
                            "Ships in a Box",
                            "Nationwide Shipping — $50",
                            "Local delivery",
                            "Pickup"
                          ],
                          "tax_rate": 0.075,
                          "tax_amount": 119.84,
                          "inventory": {
                            "state": "reserved",
                            "reserved_quantity": 2,
                            "backorder_quantity": 0,
                            "policy": null,
                            "eta_date": null,
                            "customer_notice": false,
                            "customer_message": null
                          }
                        }
                      ],
                      "fulfillment": {
                        "type": "shipping",
                        "shipping_method_id": "33333333-3333-4333-8333-333333333333",
                        "method_name": "Synthetic ground shipping",
                        "date": null,
                        "time": null,
                        "shipping_address": {
                          "address": "100 Example Street",
                          "city": "Sample City",
                          "state": "IL",
                          "zip": "60000"
                        }
                      },
                      "subtotal": 1598,
                      "discount_total": 0,
                      "promotions": [],
                      "promotion_code": null,
                      "shipping_total": 100,
                      "tax_total": 119.84,
                      "total": 1817.84,
                      "inventory": {
                        "has_backorders": false,
                        "backorder_quantity": 0
                      },
                      "expires_at": "2026-08-25T16:15:00Z"
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-31",
                    "environment": "test",
                    "request_id": "req_test_storefront_quote"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "certified-live",
        "x-required-scope": "checkout:write",
        "x-centripos-certification": {
          "required": true,
          "activation": "tenant-and-client-bound",
          "browser_secret_allowed": false
        },
        "x-idempotency-required": true
      }
    },
    "/api/retail/v1/storefront/checkouts/{quote_id}/prepare": {
      "post": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Prepare storefront order",
        "description": "Prepare one order and return the exact prepared-sale public card tokenization and 3DS configuration resolved from its processor register scope. The response exposes browser-safe public keys only, never processor security keys, credentials, posted capabilities, or raw payment data. Requires Idempotency-Key and an active per-tenant checkout certification. Retry only with the byte-identical raw JSON request body; stored replays carry Idempotency-Replayed: true.",
        "operationId": "certified_storefront_prepare",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Opaque quote id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "44444444-4444-4444-8444-444444444444"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. A retry replays only when its raw JSON request body is byte-identical; any byte difference conflicts.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 200,
              "pattern": "^[A-Za-z0-9._:-]{16,200}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [],
                "properties": {}
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Prepare storefront order response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "description": "Date-pinned certified storefront contract version.",
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Idempotency-Replayed": {
                "description": "Present with value true only when CentriPOS returns the stored response for a byte-identical idempotent replay.",
                "schema": {
                  "type": "string",
                  "const": "true"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/CertifiedStorefrontOrderEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "type": "object",
                          "required": [
                            "payment_configuration"
                          ]
                        }
                      }
                    }
                  ]
                },
                "example": {
                  "data": {
                    "id": "55555555-5555-4555-8555-555555555555",
                    "object": "storefront_order",
                    "order_number": "WEB-TEST-10482",
                    "status": "pending",
                    "payment_status": "pending",
                    "total": 1817.84,
                    "fulfillment": {
                      "type": "shipping",
                      "date": null,
                      "delivery_method_id": null,
                      "pickup_location_id": null,
                      "shipping_method_id": "33333333-3333-4333-8333-333333333333"
                    },
                    "totals": {
                      "subtotal": 1598,
                      "shipping": 100,
                      "tax": 119.84,
                      "total": 1817.84
                    },
                    "inventory": [
                      {
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "variant_id": "22222222-2222-4222-8222-222222222222",
                        "state": "reserved",
                        "reserved_quantity": 2,
                        "backorder_quantity": 0
                      }
                    ],
                    "items": [
                      {
                        "id": "66666666-6666-4666-8666-666666666666",
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "variant_id": "22222222-2222-4222-8222-222222222222",
                        "name": "Synthetic Boxed Mattress",
                        "variant_name": "Queen",
                        "sku": "SYN-BOX-Q",
                        "quantity": 2,
                        "unit_price": 799,
                        "line_total": 1598,
                        "fulfillment": {
                          "type": "shipping",
                          "status": "unfulfilled",
                          "date": null,
                          "shipping_method_id": "33333333-3333-4333-8333-333333333333",
                          "delivery_method_id": null,
                          "pickup_location_id": null
                        },
                        "inventory_commitment": {
                          "state": "reserved",
                          "reserved_quantity": 2,
                          "backorder_quantity": 0,
                          "eta_date": null,
                          "customer_message": null
                        }
                      }
                    ],
                    "created_at": "2026-08-25T15:45:00Z",
                    "updated_at": "2026-08-25T15:45:00Z",
                    "payment_configuration": {
                      "card": {
                        "provider": "centripay_gateway",
                        "is_connected": true,
                        "tokenization_key": "synthetic_public_collectjs_key",
                        "three_ds_tokenization_key": "synthetic_public_3ds_key",
                        "three_ds_enabled": true
                      }
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-31",
                    "environment": "test",
                    "request_id": "req_test_storefront_prepare"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "certified-live",
        "x-required-scope": "checkout:write",
        "x-centripos-certification": {
          "required": true,
          "activation": "tenant-and-client-bound",
          "browser_secret_allowed": false
        },
        "x-idempotency-required": true
      }
    },
    "/api/retail/v1/storefront/checkouts/{quote_id}/payments/card": {
      "post": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Handoff certified card payment",
        "description": "Submit only an opaque token from the certified payment surface plus bounded 3DS evidence. PAN, CVV, reusable credentials, and raw processor responses are prohibited. An already completed order may add operation-specific meta.replayed; gateway request replay is signaled only by Idempotency-Replayed: true. Requires Idempotency-Key. Retry only with the byte-identical raw JSON request body; stored replays carry Idempotency-Replayed: true. Card data must be tokenized by the certified browser payment surface and never pass through the website server.",
        "operationId": "certified_storefront_card",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Opaque quote id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "44444444-4444-4444-8444-444444444444"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. A retry replays only when its raw JSON request body is byte-identical; any byte difference conflicts.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 200,
              "pattern": "^[A-Za-z0-9._:-]{16,200}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "payment_token"
                ],
                "properties": {
                  "payment_token": {
                    "type": "string",
                    "minLength": 10,
                    "maxLength": 4096,
                    "pattern": "^[A-Za-z0-9._~-]+$",
                    "not": {
                      "pattern": "^(?:[\\s._~-]*\\d){12,19}[\\s._~-]*$"
                    },
                    "description": "Opaque token from the certified payment surface; never PAN or CVV."
                  },
                  "three_ds": {
                    "type": "object",
                    "additionalProperties": false,
                    "required": [],
                    "properties": {
                      "cavv": {
                        "type": "string",
                        "maxLength": 4096
                      },
                      "eci": {
                        "type": "string",
                        "maxLength": 4096
                      },
                      "xid": {
                        "type": "string",
                        "maxLength": 4096
                      },
                      "cardholder_auth": {
                        "type": "string",
                        "maxLength": 4096
                      },
                      "three_ds_version": {
                        "type": "string",
                        "maxLength": 4096
                      },
                      "directory_server_id": {
                        "type": "string",
                        "maxLength": 4096
                      }
                    }
                  }
                }
              },
              "example": {
                "payment_token": "tok_test_01J9OPAQUEPAYMENT42",
                "three_ds": {
                  "cavv": "cavv_test_01J9",
                  "eci": "05",
                  "xid": "xid_test_01J9CHECKOUT42",
                  "cardholder_auth": "authenticated",
                  "three_ds_version": "2.2.0",
                  "directory_server_id": "ds_test_01J9CHECKOUT42"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Handoff certified card payment response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "description": "Date-pinned certified storefront contract version.",
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Idempotency-Replayed": {
                "description": "Present with value true only when CentriPOS returns the stored response for a byte-identical idempotent replay.",
                "schema": {
                  "type": "string",
                  "const": "true"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/CertifiedStorefrontOrderEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "type": "object",
                          "not": {
                            "anyOf": [
                              {
                                "required": [
                                  "payment_configuration"
                                ]
                              }
                            ]
                          }
                        }
                      }
                    }
                  ]
                },
                "example": {
                  "data": {
                    "id": "55555555-5555-4555-8555-555555555555",
                    "object": "storefront_order",
                    "order_number": "WEB-TEST-10482",
                    "status": "paid",
                    "payment_status": "paid",
                    "total": 1817.84,
                    "fulfillment": {
                      "type": "shipping",
                      "date": null,
                      "delivery_method_id": null,
                      "pickup_location_id": null,
                      "shipping_method_id": "33333333-3333-4333-8333-333333333333"
                    },
                    "totals": {
                      "subtotal": 1598,
                      "shipping": 100,
                      "tax": 119.84,
                      "total": 1817.84
                    },
                    "inventory": [
                      {
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "variant_id": "22222222-2222-4222-8222-222222222222",
                        "state": "committed",
                        "reserved_quantity": 2,
                        "backorder_quantity": 0
                      }
                    ],
                    "items": [
                      {
                        "id": "66666666-6666-4666-8666-666666666666",
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "variant_id": "22222222-2222-4222-8222-222222222222",
                        "name": "Synthetic Boxed Mattress",
                        "variant_name": "Queen",
                        "sku": "SYN-BOX-Q",
                        "quantity": 2,
                        "unit_price": 799,
                        "line_total": 1598,
                        "fulfillment": {
                          "type": "shipping",
                          "status": "unfulfilled",
                          "date": null,
                          "shipping_method_id": "33333333-3333-4333-8333-333333333333",
                          "delivery_method_id": null,
                          "pickup_location_id": null
                        },
                        "inventory_commitment": {
                          "state": "reserved",
                          "reserved_quantity": 2,
                          "backorder_quantity": 0,
                          "eta_date": null,
                          "customer_message": null
                        }
                      }
                    ],
                    "created_at": "2026-08-25T15:45:00Z",
                    "updated_at": "2026-08-25T15:52:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-31",
                    "environment": "test",
                    "request_id": "req_test_storefront_order"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "certified-live",
        "x-required-scope": "checkout:write",
        "x-centripos-certification": {
          "required": true,
          "activation": "tenant-and-client-bound",
          "browser_secret_allowed": false
        },
        "x-idempotency-required": true
      }
    },
    "/api/retail/v1/storefront/checkouts/{quote_id}/financing/paytomorrow": {
      "post": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Initiate PayTomorrow financing",
        "description": "Initiate the certified PayTomorrow handoff from the prepared authoritative quote; CentriPOS owns provider state and quote totals. Requires Idempotency-Key and tenant-certified financing configuration. Retry only with the byte-identical raw JSON request body; stored replays carry Idempotency-Replayed: true. A tenant without an active provider configuration receives an explicit unavailable response.",
        "operationId": "certified_storefront_paytomorrow",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Opaque quote id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "44444444-4444-4444-8444-444444444444"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. A retry replays only when its raw JSON request body is byte-identical; any byte difference conflicts.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 200,
              "pattern": "^[A-Za-z0-9._:-]{16,200}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [],
                "properties": {}
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Initiate PayTomorrow financing response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "description": "Date-pinned certified storefront contract version.",
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Idempotency-Replayed": {
                "description": "Present with value true only when CentriPOS returns the stored response for a byte-identical idempotent replay.",
                "schema": {
                  "type": "string",
                  "const": "true"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertifiedStorefrontFinancingEnvelope"
                },
                "example": {
                  "data": {
                    "provider": "paytomorrow",
                    "financing_application_id": "finapp_test_01J9CHECKOUT42",
                    "redirect_url": "https://financing.example.test/applications/finapp_test_01J9CHECKOUT42",
                    "status": "pending",
                    "replayed": false,
                    "order": {
                      "id": "55555555-5555-4555-8555-555555555555",
                      "object": "storefront_order",
                      "order_number": "WEB-TEST-10482",
                      "status": "pending",
                      "payment_status": "processing",
                      "total": 1817.84,
                      "fulfillment": {
                        "type": "shipping",
                        "date": null,
                        "delivery_method_id": null,
                        "pickup_location_id": null,
                        "shipping_method_id": "33333333-3333-4333-8333-333333333333"
                      },
                      "totals": {
                        "subtotal": 1598,
                        "shipping": 100,
                        "tax": 119.84,
                        "total": 1817.84
                      },
                      "inventory": [
                        {
                          "product_id": "11111111-1111-4111-8111-111111111111",
                          "variant_id": "22222222-2222-4222-8222-222222222222",
                          "state": "reserved",
                          "reserved_quantity": 2,
                          "backorder_quantity": 0
                        }
                      ],
                      "items": [
                        {
                          "id": "66666666-6666-4666-8666-666666666666",
                          "product_id": "11111111-1111-4111-8111-111111111111",
                          "variant_id": "22222222-2222-4222-8222-222222222222",
                          "name": "Synthetic Boxed Mattress",
                          "variant_name": "Queen",
                          "sku": "SYN-BOX-Q",
                          "quantity": 2,
                          "unit_price": 799,
                          "line_total": 1598,
                          "fulfillment": {
                            "type": "shipping",
                            "status": "unfulfilled",
                            "date": null,
                            "shipping_method_id": "33333333-3333-4333-8333-333333333333",
                            "delivery_method_id": null,
                            "pickup_location_id": null
                          },
                          "inventory_commitment": {
                            "state": "reserved",
                            "reserved_quantity": 2,
                            "backorder_quantity": 0,
                            "eta_date": null,
                            "customer_message": null
                          }
                        }
                      ],
                      "created_at": "2026-08-25T15:45:00Z",
                      "updated_at": "2026-08-25T15:48:00Z"
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-31",
                    "environment": "test",
                    "request_id": "req_test_storefront_financing"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "certified-live",
        "x-required-scope": "checkout:write",
        "x-centripos-certification": {
          "required": true,
          "activation": "tenant-and-client-bound",
          "browser_secret_allowed": false
        },
        "x-idempotency-required": true
      }
    },
    "/api/retail/v1/storefront/checkouts/{quote_id}/finalize": {
      "post": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Finalize storefront order",
        "description": "Finalize the prepared order only after CentriPOS validates the persisted certified payment or financing state against the authoritative quote. Requires Idempotency-Key. Retry only with the byte-identical raw JSON request body; stored replays carry Idempotency-Replayed: true and cannot duplicate the sale.",
        "operationId": "certified_storefront_finalize",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "quote_id",
            "in": "path",
            "required": true,
            "description": "Opaque quote id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "44444444-4444-4444-8444-444444444444"
            }
          },
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. A retry replays only when its raw JSON request body is byte-identical; any byte difference conflicts.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 200,
              "pattern": "^[A-Za-z0-9._:-]{16,200}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [],
                "properties": {}
              },
              "example": {}
            }
          }
        },
        "responses": {
          "200": {
            "description": "Finalize storefront order response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "description": "Date-pinned certified storefront contract version.",
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Idempotency-Replayed": {
                "description": "Present with value true only when CentriPOS returns the stored response for a byte-identical idempotent replay.",
                "schema": {
                  "type": "string",
                  "const": "true"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/CertifiedStorefrontOrderEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "type": "object",
                          "not": {
                            "anyOf": [
                              {
                                "required": [
                                  "payment_configuration"
                                ]
                              }
                            ]
                          }
                        }
                      }
                    }
                  ]
                },
                "example": {
                  "data": {
                    "id": "55555555-5555-4555-8555-555555555555",
                    "object": "storefront_order",
                    "order_number": "WEB-TEST-10482",
                    "status": "paid",
                    "payment_status": "paid",
                    "total": 1817.84,
                    "fulfillment": {
                      "type": "shipping",
                      "date": null,
                      "delivery_method_id": null,
                      "pickup_location_id": null,
                      "shipping_method_id": "33333333-3333-4333-8333-333333333333"
                    },
                    "totals": {
                      "subtotal": 1598,
                      "shipping": 100,
                      "tax": 119.84,
                      "total": 1817.84
                    },
                    "inventory": [
                      {
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "variant_id": "22222222-2222-4222-8222-222222222222",
                        "state": "committed",
                        "reserved_quantity": 2,
                        "backorder_quantity": 0
                      }
                    ],
                    "items": [
                      {
                        "id": "66666666-6666-4666-8666-666666666666",
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "variant_id": "22222222-2222-4222-8222-222222222222",
                        "name": "Synthetic Boxed Mattress",
                        "variant_name": "Queen",
                        "sku": "SYN-BOX-Q",
                        "quantity": 2,
                        "unit_price": 799,
                        "line_total": 1598,
                        "fulfillment": {
                          "type": "shipping",
                          "status": "unfulfilled",
                          "date": null,
                          "shipping_method_id": "33333333-3333-4333-8333-333333333333",
                          "delivery_method_id": null,
                          "pickup_location_id": null
                        },
                        "inventory_commitment": {
                          "state": "reserved",
                          "reserved_quantity": 2,
                          "backorder_quantity": 0,
                          "eta_date": null,
                          "customer_message": null
                        }
                      }
                    ],
                    "created_at": "2026-08-25T15:45:00Z",
                    "updated_at": "2026-08-25T15:52:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-31",
                    "environment": "test",
                    "request_id": "req_test_storefront_order"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "certified-live",
        "x-required-scope": "checkout:write",
        "x-centripos-certification": {
          "required": true,
          "activation": "tenant-and-client-bound",
          "browser_secret_allowed": false
        },
        "x-idempotency-required": true
      }
    },
    "/api/retail/v1/storefront/orders/{order_id}": {
      "get": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Get storefront order status",
        "description": "Read the credential-bound order, payment, totals, line fulfillment, and common cart fulfillment status. payment_status distinguishes pending, processing, reconciliation_required, and paid without exposing processor state. Certified server integration only; the credential cannot read another tenant or data plane.",
        "operationId": "certified_storefront_order",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "order_id",
            "in": "path",
            "required": true,
            "description": "Opaque order id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "55555555-5555-4555-8555-555555555555"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Get storefront order status response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "description": "Date-pinned certified storefront contract version.",
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/CertifiedStorefrontOrderEnvelope"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "type": "object",
                          "not": {
                            "anyOf": [
                              {
                                "required": [
                                  "payment_configuration"
                                ]
                              }
                            ]
                          }
                        }
                      }
                    }
                  ]
                },
                "example": {
                  "data": {
                    "id": "55555555-5555-4555-8555-555555555555",
                    "object": "storefront_order",
                    "order_number": "WEB-TEST-10482",
                    "status": "pending",
                    "payment_status": "reconciliation_required",
                    "total": 1817.84,
                    "fulfillment": {
                      "type": "shipping",
                      "date": null,
                      "delivery_method_id": null,
                      "pickup_location_id": null,
                      "shipping_method_id": "33333333-3333-4333-8333-333333333333"
                    },
                    "totals": {
                      "subtotal": 1598,
                      "shipping": 100,
                      "tax": 119.84,
                      "total": 1817.84
                    },
                    "inventory": [
                      {
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "variant_id": "22222222-2222-4222-8222-222222222222",
                        "state": "reserved",
                        "reserved_quantity": 2,
                        "backorder_quantity": 0
                      }
                    ],
                    "items": [
                      {
                        "id": "66666666-6666-4666-8666-666666666666",
                        "product_id": "11111111-1111-4111-8111-111111111111",
                        "variant_id": "22222222-2222-4222-8222-222222222222",
                        "name": "Synthetic Boxed Mattress",
                        "variant_name": "Queen",
                        "sku": "SYN-BOX-Q",
                        "quantity": 2,
                        "unit_price": 799,
                        "line_total": 1598,
                        "fulfillment": {
                          "type": "shipping",
                          "status": "unfulfilled",
                          "date": null,
                          "shipping_method_id": "33333333-3333-4333-8333-333333333333",
                          "delivery_method_id": null,
                          "pickup_location_id": null
                        },
                        "inventory_commitment": {
                          "state": "reserved",
                          "reserved_quantity": 2,
                          "backorder_quantity": 0,
                          "eta_date": null,
                          "customer_message": null
                        }
                      }
                    ],
                    "created_at": "2026-08-25T15:45:00Z",
                    "updated_at": "2026-08-25T15:50:00Z"
                  },
                  "meta": {
                    "api_version": "2026-08-31",
                    "environment": "test",
                    "request_id": "req_test_storefront_order_status"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "certified-live",
        "x-required-scope": "orders:read",
        "x-centripos-certification": {
          "required": true,
          "activation": "tenant-and-client-bound",
          "browser_secret_allowed": false
        }
      }
    },
    "/api/retail/v1/invoices/{invoice_id}/attachment-packet": {
      "get": {
        "tags": [
          "Invoicing"
        ],
        "summary": "Download invoice attachment packet",
        "description": "Export the saved active attachments for one sale-linked invoice as a binary PDF, newest attachment first. PDF pages retain their order; PNG and JPEG attachments are centered on letter pages. The invoice, sale, attachment records and storage paths remain tenant-bound. Reviewed local November source registers this export; deployment and tenant entitlement were not verified. Requires a sale-linked invoice and existing saved attachments. A missing invoice returns 404; absent or invalid attachments return 409. This response is application/pdf, not a JSON envelope. GET does not require an Idempotency-Key.",
        "operationId": "downloadInvoiceAttachmentPacket",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "invoice_id",
            "in": "path",
            "required": true,
            "description": "Opaque invoice id. Tenant and data-plane identifiers are never accepted.",
            "schema": {
              "type": "string",
              "format": "uuid",
              "example": "77777777-7777-4777-8777-777777777777"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Download invoice attachment packet response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Content-Disposition": {
                "description": "Attachment disposition with the sanitized packet filename.",
                "schema": {
                  "type": "string",
                  "example": "attachment; filename=\"SYN-10482.pdf\""
                }
              },
              "X-CentriPOS-Packet-Version": {
                "description": "SHA-256 of the returned PDF bytes.",
                "schema": {
                  "type": "string",
                  "pattern": "^[a-f0-9]{64}$"
                }
              }
            },
            "content": {
              "application/pdf": {
                "schema": {
                  "$ref": "#/components/schemas/InvoiceAttachmentPacket"
                },
                "example": "%PDF — SYNTHETIC DOCUMENTATION PLACEHOLDER. A successful request returns PDF bytes; this text is not a usable PDF."
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "413": {
            "description": "packet_too_large: more than 100 attachments, more than 25 MiB of input or output bytes, or more than 1000 PDF pages.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            }
          },
          "422": {
            "description": "unsupported_packet_attachment or unreadable_packet_attachment: an attachment is unsupported, encrypted, corrupt, or unreadable. Download the affected attachment separately.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorEnvelope"
                }
              }
            }
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "authenticated-live",
        "x-required-scope": "invoices:read",
        "x-centripos-operation-class": "export",
        "x-centripos-source-verification": {
          "basis": "local-source-only",
          "snapshot": "November checkout 4e2cc74bf0db16aa5b5e8969f2e6e5372c244a1a",
          "deployment_verified": false
        }
      }
    },
    "/api/retail/v1/storefront/addresses/autocomplete": {
      "post": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Suggest a storefront delivery address",
        "description": "Return up to five US address suggestions in English through the protected address service. Only input is accepted; caller-selected tenant, host, provider credentials, countries or language are rejected. A suggestion is not a fulfillment eligibility decision; create an authoritative quote with the chosen address. Registered in reviewed local November source; deployment, address-service configuration and tenant certification were not verified. Requires the separately certified checkout entitlement, storefront:read and Idempotency-Key despite being a read-class POST. Retry with byte-identical raw JSON; changed bytes conflict. Address-service failure returns sanitized 503 address_service_unavailable.",
        "operationId": "autocompleteCertifiedStorefrontAddress",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. A retry replays only when its raw JSON request body is byte-identical; any byte difference conflicts.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 200,
              "pattern": "^[A-Za-z0-9._:-]{16,200}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "input"
                ],
                "properties": {
                  "input": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 160,
                    "description": "Nonempty trimmed address text without control characters. Fewer than three characters returns no suggestions."
                  }
                }
              },
              "example": {
                "input": "100 Example"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Suggest a storefront delivery address response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Idempotency-Replayed": {
                "description": "Present and true only for a stored replay.",
                "schema": {
                  "type": "boolean"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertifiedStorefrontAddressSuggestionsEnvelope"
                },
                "example": {
                  "data": {
                    "suggestions": [
                      {
                        "place_id": "place_test_01J9EXAMPLE",
                        "label": "100 Example Street, Sample City, IL, USA",
                        "main_text": "100 Example Street",
                        "secondary_text": "Sample City, IL, USA"
                      }
                    ]
                  },
                  "meta": {
                    "api_version": "2026-08-31",
                    "environment": "test",
                    "request_id": "req_test_address_suggestions"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "certified-live",
        "x-required-scope": "storefront:read",
        "x-centripos-operation-class": "read",
        "x-centripos-source-verification": {
          "basis": "local-source-only",
          "snapshot": "November checkout 4e2cc74bf0db16aa5b5e8969f2e6e5372c244a1a",
          "deployment_verified": false
        },
        "x-centripos-certification": "Requires separate tenant and API-client checkout certification.",
        "x-idempotency-required": true
      }
    },
    "/api/retail/v1/storefront/addresses/details": {
      "post": {
        "tags": [
          "Public storefront"
        ],
        "summary": "Resolve a selected storefront address",
        "description": "Resolve the selected place_id into the bounded street address, city, uppercase state and ZIP projection. Only place_id is accepted. The result is address data, not approval of delivery, pricing, tax or a checkout total; submit it to the authoritative storefront quote workflow. Registered in reviewed local November source; deployment, address-service configuration and tenant certification were not verified. Requires the separately certified checkout entitlement, storefront:read and Idempotency-Key despite being a read-class POST. Retry with byte-identical raw JSON; changed bytes conflict. Address-service failure returns sanitized 503 address_service_unavailable.",
        "operationId": "getCertifiedStorefrontAddressDetails",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "parameters": [
          {
            "name": "Idempotency-Key",
            "in": "header",
            "required": true,
            "description": "Unique caller-generated key. A retry replays only when its raw JSON request body is byte-identical; any byte difference conflicts.",
            "schema": {
              "type": "string",
              "minLength": 16,
              "maxLength": 200,
              "pattern": "^[A-Za-z0-9._:-]{16,200}$"
            }
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "additionalProperties": false,
                "required": [
                  "place_id"
                ],
                "properties": {
                  "place_id": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 256,
                    "description": "Nonempty trimmed provider place identifier from a suggestion, without control characters."
                  }
                }
              },
              "example": {
                "place_id": "place_test_01J9EXAMPLE"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Resolve a selected storefront address response.",
            "headers": {
              "X-Request-ID": {
                "$ref": "#/components/headers/RequestId"
              },
              "X-CentriPOS-API-Version": {
                "schema": {
                  "type": "string",
                  "const": "2026-08-31"
                }
              },
              "X-RateLimit-Limit": {
                "$ref": "#/components/headers/RateLimit"
              },
              "X-RateLimit-Remaining": {
                "$ref": "#/components/headers/RateRemaining"
              },
              "Idempotency-Replayed": {
                "description": "Present and true only for a stored replay.",
                "schema": {
                  "type": "boolean"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertifiedStorefrontAddressEnvelope"
                },
                "example": {
                  "data": {
                    "address": {
                      "address": "100 Example Street",
                      "city": "Sample City",
                      "state": "IL",
                      "zip": "60000"
                    }
                  },
                  "meta": {
                    "api_version": "2026-08-31",
                    "environment": "test",
                    "request_id": "req_test_address_details"
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/BadRequest"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "403": {
            "$ref": "#/components/responses/Forbidden"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "409": {
            "$ref": "#/components/responses/Conflict"
          },
          "429": {
            "$ref": "#/components/responses/RateLimited"
          },
          "503": {
            "$ref": "#/components/responses/Unavailable"
          }
        },
        "x-centripos-status": "certified-live",
        "x-required-scope": "storefront:read",
        "x-centripos-operation-class": "read",
        "x-centripos-source-verification": {
          "basis": "local-source-only",
          "snapshot": "November checkout 4e2cc74bf0db16aa5b5e8969f2e6e5372c244a1a",
          "deployment_verified": false
        },
        "x-centripos-certification": "Requires separate tenant and API-client checkout certification.",
        "x-idempotency-required": true
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "CentriPOS restricted key",
        "description": "Use a tenant-bound cp_test_ or cp_live_ key from a server-side secret store. The raw secret is shown once and is never sent in a URL."
      }
    },
    "headers": {
      "RequestId": {
        "description": "Safe request correlation identifier.",
        "schema": {
          "type": "string"
        }
      },
      "ApiVersion": {
        "description": "Date-pinned contract version.",
        "schema": {
          "type": "string",
          "example": "2026-08-24"
        }
      },
      "RateLimit": {
        "description": "Request budget for this credential and operation class.",
        "schema": {
          "type": "integer"
        }
      },
      "RateRemaining": {
        "description": "Remaining requests in the current window.",
        "schema": {
          "type": "integer"
        }
      }
    },
    "responses": {
      "BadRequest": {
        "description": "Invalid request shape or parameter.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        }
      },
      "Unauthorized": {
        "description": "Missing, malformed, expired, or revoked credential.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        }
      },
      "Forbidden": {
        "description": "Credential is valid but lacks the required scope or tenant policy.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        }
      },
      "NotFound": {
        "description": "Resource was not found in the credential-bound tenant and environment.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        }
      },
      "Conflict": {
        "description": "State, version, sandbox, or idempotency conflict.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        }
      },
      "RateLimited": {
        "description": "Rate limit exceeded.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        },
        "headers": {
          "Retry-After": {
            "schema": {
              "type": "integer"
            }
          }
        }
      },
      "Unavailable": {
        "description": "Private API is not enabled or an approved dependency is unavailable.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ErrorEnvelope"
            }
          }
        }
      }
    },
    "schemas": {
      "SalePage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "status",
                "name",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {
                "type": "string"
              },
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list sales response projection."
      },
      "SaleEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "status",
              "name",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "replayed": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "key",
                  "replayed"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "request_id",
              "environment",
              "idempotency"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create a sale response projection."
      },
      "ResourceEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "status",
              "name",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "replayed": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "key",
                  "replayed"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "request_id",
              "environment",
              "idempotency"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted complete a sale response projection."
      },
      "ReceiptEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "receipt_number": {
                "type": "string"
              },
              "sale_id": {
                "type": "string"
              },
              "sale_number": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "issued_at": {
                "type": "string"
              },
              "merchant": {
                "type": "object",
                "properties": {
                  "display_name": {
                    "type": "string"
                  },
                  "location": {
                    "type": "object",
                    "properties": {
                      "name": {
                        "type": "string"
                      },
                      "address": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "name",
                      "address"
                    ],
                    "additionalProperties": false
                  },
                  "phone": {
                    "type": "string"
                  },
                  "tax_identifier_display": {
                    "type": "string"
                  }
                },
                "required": [
                  "display_name",
                  "location",
                  "phone",
                  "tax_identifier_display"
                ],
                "additionalProperties": false
              },
              "customer": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "display_name": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "display_name",
                  "email"
                ],
                "additionalProperties": false
              },
              "cashier": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "display_name": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "display_name"
                ],
                "additionalProperties": false
              },
              "line_items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "sort_order": {
                      "type": "integer"
                    },
                    "quantity": {
                      "type": "integer"
                    },
                    "product": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "brand": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "brand"
                      ],
                      "additionalProperties": false
                    },
                    "variant": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "sku": {
                          "type": "string"
                        },
                        "options": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string"
                              },
                              "value": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "name",
                              "value"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "sku",
                        "options"
                      ],
                      "additionalProperties": false
                    },
                    "unit_price": {
                      "type": "integer"
                    },
                    "quantity_price": {
                      "type": "integer"
                    },
                    "discount_total": {
                      "type": "integer"
                    },
                    "tax_total": {
                      "type": "number"
                    },
                    "line_total": {
                      "type": "number"
                    },
                    "discounts": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "type": {
                            "type": "string"
                          },
                          "amount": {
                            "type": "integer"
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "type",
                          "amount"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "tax_lines": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "rate": {
                            "type": "number"
                          },
                          "taxable_amount": {
                            "type": "integer"
                          },
                          "amount": {
                            "type": "number"
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "rate",
                          "taxable_amount",
                          "amount"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "fulfillment": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        },
                        "location": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "code": {
                              "type": "string"
                            },
                            "timezone": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "name",
                            "code",
                            "timezone"
                          ],
                          "additionalProperties": false
                        },
                        "promised_at": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "type",
                        "status",
                        "location",
                        "promised_at"
                      ],
                      "additionalProperties": false
                    },
                    "inventory_commitment": {
                      "type": "object",
                      "properties": {
                        "state": {
                          "type": "string"
                        },
                        "reserved_quantity": {
                          "type": "integer"
                        },
                        "backorder_quantity": {
                          "type": "integer"
                        },
                        "policy": {
                          "type": "string"
                        },
                        "eta_date": {
                          "type": "string"
                        },
                        "customer_message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "state",
                        "reserved_quantity",
                        "backorder_quantity",
                        "policy",
                        "eta_date",
                        "customer_message"
                      ],
                      "additionalProperties": false
                    },
                    "backorder": {
                      "type": "object",
                      "properties": {
                        "object": {
                          "type": "string"
                        },
                        "id": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        },
                        "requested_quantity": {
                          "type": "integer"
                        },
                        "initially_reserved_quantity": {
                          "type": "integer"
                        },
                        "backorder_quantity": {
                          "type": "integer"
                        },
                        "allocated_quantity": {
                          "type": "integer"
                        },
                        "remaining_quantity": {
                          "type": "integer"
                        },
                        "policy": {
                          "type": "string"
                        },
                        "eta_date": {
                          "type": "string"
                        },
                        "customer_message": {
                          "type": "string"
                        },
                        "allocated_at": {},
                        "fulfilled_at": {},
                        "cancelled_at": {},
                        "created_at": {
                          "type": "string"
                        },
                        "updated_at": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "object",
                        "id",
                        "status",
                        "requested_quantity",
                        "initially_reserved_quantity",
                        "backorder_quantity",
                        "allocated_quantity",
                        "remaining_quantity",
                        "policy",
                        "eta_date",
                        "customer_message",
                        "allocated_at",
                        "fulfilled_at",
                        "cancelled_at",
                        "created_at",
                        "updated_at"
                      ],
                      "additionalProperties": false
                    },
                    "warranty": {
                      "type": "object",
                      "properties": {
                        "term_years": {
                          "type": "integer"
                        },
                        "registered": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "term_years",
                        "registered"
                      ],
                      "additionalProperties": false
                    },
                    "note": {}
                  },
                  "required": [
                    "id",
                    "sort_order",
                    "quantity",
                    "product",
                    "variant",
                    "unit_price",
                    "quantity_price",
                    "discount_total",
                    "tax_total",
                    "line_total",
                    "discounts",
                    "tax_lines",
                    "fulfillment",
                    "inventory_commitment",
                    "backorder",
                    "warranty",
                    "note"
                  ],
                  "additionalProperties": false
                }
              },
              "tenders": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "number"
                    },
                    "status": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "type",
                    "label",
                    "amount",
                    "status"
                  ],
                  "additionalProperties": false
                }
              },
              "totals": {
                "type": "object",
                "properties": {
                  "subtotal": {
                    "type": "integer"
                  },
                  "discount_total": {
                    "type": "integer"
                  },
                  "shipping_total": {
                    "type": "integer"
                  },
                  "tax_total": {
                    "type": "number"
                  },
                  "total": {
                    "type": "number"
                  },
                  "amount_paid": {
                    "type": "number"
                  },
                  "balance_due": {
                    "type": "integer"
                  },
                  "change_given": {
                    "type": "integer"
                  }
                },
                "required": [
                  "subtotal",
                  "discount_total",
                  "shipping_total",
                  "tax_total",
                  "total",
                  "amount_paid",
                  "balance_due",
                  "change_given"
                ],
                "additionalProperties": false
              },
              "tax_summary": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "rate": {
                      "type": "number"
                    },
                    "taxable_amount": {
                      "type": "integer"
                    },
                    "amount": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "name",
                    "rate",
                    "taxable_amount",
                    "amount"
                  ],
                  "additionalProperties": false
                }
              },
              "fulfillment_summary": {
                "type": "string"
              },
              "return_summary": {
                "type": "object",
                "properties": {
                  "returnable_until": {
                    "type": "string"
                  },
                  "returned_total": {
                    "type": "integer"
                  }
                },
                "required": [
                  "returnable_until",
                  "returned_total"
                ],
                "additionalProperties": false
              },
              "links": {
                "type": "object",
                "properties": {
                  "self": {
                    "type": "string"
                  },
                  "sale": {
                    "type": "string"
                  },
                  "document": {
                    "type": "string"
                  }
                },
                "required": [
                  "self",
                  "sale",
                  "document"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "id",
              "receipt_number",
              "sale_id",
              "sale_number",
              "status",
              "issued_at",
              "merchant",
              "customer",
              "cashier",
              "line_items",
              "tenders",
              "totals",
              "tax_summary",
              "fulfillment_summary",
              "return_summary",
              "links"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get receipt data response projection."
      },
      "DocumentEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "content_type": {
                "type": "string"
              },
              "expires_at": {
                "type": "string"
              },
              "download_url": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "content_type",
              "expires_at",
              "download_url"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted download receipt document response projection."
      },
      "ProductPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "status",
                "name",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {
                "type": "string"
              },
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list products response projection."
      },
      "ProductEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "status",
              "name",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "replayed": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "key",
                  "replayed"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "request_id",
              "environment",
              "idempotency"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create a product response projection."
      },
      "InventoryLevelPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "location": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string"
                    },
                    "timezone": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "code",
                    "timezone"
                  ],
                  "additionalProperties": false
                },
                "product": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name"
                  ],
                  "additionalProperties": false
                },
                "variant": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "sku": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "sku",
                    "name"
                  ],
                  "additionalProperties": false
                },
                "on_hand": {
                  "type": "integer"
                },
                "reserved": {
                  "type": "integer"
                },
                "available": {
                  "type": "integer"
                },
                "incoming": {
                  "type": "integer"
                },
                "reorder_point": {
                  "type": "integer"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "location",
                "product",
                "variant",
                "on_hand",
                "reserved",
                "available",
                "incoming",
                "reorder_point",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list inventory stock response projection."
      },
      "InventoryLevelsEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string"
              },
              "product": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "sku": {
                    "type": "string"
                  },
                  "track_inventory": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "id",
                  "name",
                  "sku",
                  "track_inventory"
                ],
                "additionalProperties": false
              },
              "inventory_model": {
                "type": "string"
              },
              "locations": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "location": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "internal_name": {
                          "type": "string"
                        },
                        "type": {
                          "type": "string"
                        },
                        "is_active": {
                          "type": "boolean"
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "internal_name",
                        "type",
                        "is_active"
                      ],
                      "additionalProperties": false
                    },
                    "unassigned_product_level": {
                      "type": "object",
                      "properties": {
                        "id": {},
                        "stock_on_hand": {
                          "type": "integer"
                        },
                        "reserved_quantity": {
                          "type": "integer"
                        },
                        "inventory_reserved_quantity": {
                          "type": "integer"
                        },
                        "commerce_reserved_quantity": {
                          "type": "integer"
                        },
                        "available_quantity": {
                          "type": "integer"
                        },
                        "reorder_point": {},
                        "reorder_quantity": {},
                        "updated_at": {}
                      },
                      "required": [
                        "id",
                        "stock_on_hand",
                        "reserved_quantity",
                        "inventory_reserved_quantity",
                        "commerce_reserved_quantity",
                        "available_quantity",
                        "reorder_point",
                        "reorder_quantity",
                        "updated_at"
                      ],
                      "additionalProperties": false
                    },
                    "variants": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "object": {
                            "type": "string"
                          },
                          "stock_type": {
                            "type": "string"
                          },
                          "location_id": {
                            "type": "string"
                          },
                          "product_id": {
                            "type": "string"
                          },
                          "variant_id": {
                            "type": "string"
                          },
                          "variant_name": {
                            "type": "string"
                          },
                          "sku": {
                            "type": "string"
                          },
                          "attributes": {
                            "type": "object",
                            "properties": {
                              "Size": {
                                "type": "string"
                              },
                              "Feel": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "Size",
                              "Feel"
                            ],
                            "additionalProperties": false
                          },
                          "variant_enabled": {
                            "type": "boolean"
                          },
                          "stock_on_hand": {
                            "type": "integer"
                          },
                          "reserved_quantity": {
                            "type": "integer"
                          },
                          "inventory_reserved_quantity": {
                            "type": "integer"
                          },
                          "commerce_reserved_quantity": {
                            "type": "integer"
                          },
                          "available_quantity": {
                            "type": "integer"
                          },
                          "reorder_point": {
                            "type": "integer"
                          },
                          "reorder_quantity": {
                            "type": "integer"
                          },
                          "updated_at": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "object",
                          "stock_type",
                          "location_id",
                          "product_id",
                          "variant_id",
                          "variant_name",
                          "sku",
                          "attributes",
                          "variant_enabled",
                          "stock_on_hand",
                          "reserved_quantity",
                          "inventory_reserved_quantity",
                          "commerce_reserved_quantity",
                          "available_quantity",
                          "reorder_point",
                          "reorder_quantity",
                          "updated_at"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "variant_totals": {
                      "type": "object",
                      "properties": {
                        "stock_on_hand": {
                          "type": "integer"
                        },
                        "reserved_quantity": {
                          "type": "integer"
                        },
                        "available_quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "stock_on_hand",
                        "reserved_quantity",
                        "available_quantity"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "location",
                    "unassigned_product_level",
                    "variants",
                    "variant_totals"
                  ],
                  "additionalProperties": false
                }
              },
              "totals": {
                "type": "object",
                "properties": {
                  "variants": {
                    "type": "object",
                    "properties": {
                      "stock_on_hand": {
                        "type": "integer"
                      },
                      "reserved_quantity": {
                        "type": "integer"
                      },
                      "available_quantity": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "stock_on_hand",
                      "reserved_quantity",
                      "available_quantity"
                    ],
                    "additionalProperties": false
                  },
                  "unassigned_product_level": {
                    "type": "object",
                    "properties": {
                      "stock_on_hand": {
                        "type": "integer"
                      },
                      "reserved_quantity": {
                        "type": "integer"
                      },
                      "available_quantity": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "stock_on_hand",
                      "reserved_quantity",
                      "available_quantity"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "variants",
                  "unassigned_product_level"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "object",
              "product",
              "inventory_model",
              "locations",
              "totals"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get authoritative product inventory levels response projection."
      },
      "InventoryLevelEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "location": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  },
                  "timezone": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "name",
                  "code",
                  "timezone"
                ],
                "additionalProperties": false
              },
              "product": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "name"
                ],
                "additionalProperties": false
              },
              "variant": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "sku": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "sku",
                  "name"
                ],
                "additionalProperties": false
              },
              "on_hand": {
                "type": "integer"
              },
              "reserved": {
                "type": "integer"
              },
              "available": {
                "type": "integer"
              },
              "incoming": {
                "type": "integer"
              },
              "reorder_point": {
                "type": "integer"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "location",
              "product",
              "variant",
              "on_hand",
              "reserved",
              "available",
              "incoming",
              "reorder_point",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get one inventory level response projection."
      },
      "CustomerPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "status",
                "name",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {
                "type": "string"
              },
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list customers response projection."
      },
      "CustomerEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "status",
              "name",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string"
                  },
                  "replayed": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "key",
                  "replayed"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "request_id",
              "environment",
              "idempotency"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create a customer response projection."
      },
      "InvoicePage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "invoice_number": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "customer_id": {
                  "type": "string"
                },
                "customer_name": {
                  "type": "string"
                },
                "customer_email": {
                  "type": "string"
                },
                "sale_id": {
                  "type": "string"
                },
                "totals": {
                  "type": "object",
                  "properties": {
                    "subtotal": {
                      "type": "integer"
                    },
                    "tax": {
                      "type": "number"
                    },
                    "total": {
                      "type": "number"
                    },
                    "amount_paid": {
                      "type": "integer"
                    },
                    "balance_due": {
                      "type": "number"
                    }
                  },
                  "required": [
                    "subtotal",
                    "tax",
                    "total",
                    "amount_paid",
                    "balance_due"
                  ],
                  "additionalProperties": false
                },
                "notes": {
                  "type": "string"
                },
                "issued_at": {
                  "type": "string"
                },
                "due_date": {
                  "type": "string"
                },
                "paid_at": {},
                "line_items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "quantity": {
                        "type": "integer"
                      },
                      "unit_price": {
                        "type": "integer"
                      },
                      "amount": {
                        "type": "integer"
                      },
                      "sort_order": {
                        "type": "integer"
                      },
                      "created_at": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "description",
                      "quantity",
                      "unit_price",
                      "amount",
                      "sort_order",
                      "created_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "payments": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "amount": {
                        "type": "integer"
                      },
                      "payment_type_id": {
                        "type": "string"
                      },
                      "notes": {
                        "type": "string"
                      },
                      "created_at": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "amount",
                      "payment_type_id",
                      "notes",
                      "created_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "project_links": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "project_id": {
                        "type": "string"
                      },
                      "invoice_id": {
                        "type": "string"
                      },
                      "created_at": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "project_id",
                      "invoice_id",
                      "created_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "invoice_number",
                "status",
                "customer_id",
                "customer_name",
                "customer_email",
                "sale_id",
                "totals",
                "notes",
                "issued_at",
                "due_date",
                "paid_at",
                "line_items",
                "payments",
                "project_links",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list invoices response projection."
      },
      "InvoiceEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "invoice_number": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "customer_id": {
                "type": "string"
              },
              "customer_name": {
                "type": "string"
              },
              "customer_email": {
                "type": "string"
              },
              "sale_id": {
                "type": "string"
              },
              "totals": {
                "type": "object",
                "properties": {
                  "subtotal": {
                    "type": "integer"
                  },
                  "tax": {
                    "type": "number"
                  },
                  "total": {
                    "type": "number"
                  },
                  "amount_paid": {
                    "type": "integer"
                  },
                  "balance_due": {
                    "type": "number"
                  }
                },
                "required": [
                  "subtotal",
                  "tax",
                  "total",
                  "amount_paid",
                  "balance_due"
                ],
                "additionalProperties": false
              },
              "notes": {
                "type": "string"
              },
              "issued_at": {
                "type": "string"
              },
              "due_date": {
                "type": "string"
              },
              "paid_at": {},
              "line_items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "quantity": {
                      "type": "integer"
                    },
                    "unit_price": {
                      "type": "integer"
                    },
                    "amount": {
                      "type": "integer"
                    },
                    "sort_order": {
                      "type": "integer"
                    },
                    "created_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "description",
                    "quantity",
                    "unit_price",
                    "amount",
                    "sort_order",
                    "created_at"
                  ],
                  "additionalProperties": false
                }
              },
              "payments": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "amount": {
                      "type": "integer"
                    },
                    "payment_type_id": {
                      "type": "string"
                    },
                    "notes": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "amount",
                    "payment_type_id",
                    "notes",
                    "created_at"
                  ],
                  "additionalProperties": false
                }
              },
              "project_links": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "project_id": {
                      "type": "string"
                    },
                    "invoice_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "project_id",
                    "invoice_id",
                    "created_at"
                  ],
                  "additionalProperties": false
                }
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "invoice_number",
              "status",
              "customer_id",
              "customer_name",
              "customer_email",
              "sale_id",
              "totals",
              "notes",
              "issued_at",
              "due_date",
              "paid_at",
              "line_items",
              "payments",
              "project_links",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get a complete invoice response projection."
      },
      "ServiceTicketPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "ticket_number": {
                  "type": "string"
                },
                "ticket_type": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "priority": {
                  "type": "string"
                },
                "lifecycle_stage": {
                  "type": "string"
                },
                "origin_channel": {
                  "type": "string"
                },
                "customer": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "phone": {
                      "type": "string"
                    },
                    "email": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "phone",
                    "email"
                  ],
                  "additionalProperties": false
                },
                "service_address": {
                  "type": "object",
                  "properties": {
                    "street": {
                      "type": "string"
                    },
                    "street_2": {},
                    "city": {
                      "type": "string"
                    },
                    "state": {
                      "type": "string"
                    },
                    "postal_code": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "street",
                    "street_2",
                    "city",
                    "state",
                    "postal_code"
                  ],
                  "additionalProperties": false
                },
                "location_id": {
                  "type": "string"
                },
                "product_id": {
                  "type": "string"
                },
                "variant_id": {
                  "type": "string"
                },
                "linked_sale_id": {
                  "type": "string"
                },
                "converted_sale_id": {},
                "assigned_profile_id": {
                  "type": "string"
                },
                "assigned_team_function": {
                  "type": "string"
                },
                "project_id": {
                  "type": "string"
                },
                "work_item_id": {
                  "type": "string"
                },
                "warranty": {
                  "type": "object",
                  "properties": {
                    "provider": {
                      "type": "string"
                    },
                    "claim_number": {}
                  },
                  "required": [
                    "provider",
                    "claim_number"
                  ],
                  "additionalProperties": false
                },
                "billing": {
                  "type": "object",
                  "properties": {
                    "billable": {
                      "type": "boolean"
                    },
                    "estimated_charge": {
                      "type": "integer"
                    },
                    "approved_charge": {
                      "type": "integer"
                    },
                    "charge_status": {
                      "type": "string"
                    },
                    "quote_status": {
                      "type": "string"
                    },
                    "quote_total": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "billable",
                    "estimated_charge",
                    "approved_charge",
                    "charge_status",
                    "quote_status",
                    "quote_total"
                  ],
                  "additionalProperties": false
                },
                "work_order_status": {
                  "type": "string"
                },
                "summary": {
                  "type": "string"
                },
                "details": {
                  "type": "string"
                },
                "requested_resolution": {
                  "type": "string"
                },
                "customer_concern": {},
                "resolution_summary": {},
                "scheduled_at": {
                  "type": "string"
                },
                "next_follow_up_at": {
                  "type": "string"
                },
                "completed_at": {},
                "closed_at": {},
                "visits": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "object": {
                        "type": "string"
                      },
                      "service_ticket_id": {
                        "type": "string"
                      },
                      "visit_type": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string"
                      },
                      "assigned_profile_id": {
                        "type": "string"
                      },
                      "scheduled_start": {
                        "type": "string"
                      },
                      "scheduled_end": {
                        "type": "string"
                      },
                      "en_route_at": {},
                      "arrived_at": {},
                      "departed_at": {},
                      "completed_at": {},
                      "address": {
                        "type": "object",
                        "properties": {
                          "line1": {
                            "type": "string"
                          },
                          "city": {
                            "type": "string"
                          },
                          "region": {
                            "type": "string"
                          },
                          "postal_code": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "line1",
                          "city",
                          "region",
                          "postal_code"
                        ],
                        "additionalProperties": false
                      },
                      "customer_present": {
                        "type": "boolean"
                      },
                      "sentiment": {},
                      "billable": {
                        "type": "boolean"
                      },
                      "notes": {
                        "type": "string"
                      },
                      "technician_notes": {},
                      "customer_notes": {
                        "type": "string"
                      },
                      "checklist": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "label": {
                              "type": "string"
                            },
                            "is_complete": {
                              "type": "boolean"
                            },
                            "completed_by": {},
                            "completed_at": {},
                            "sort_order": {
                              "type": "integer"
                            }
                          },
                          "required": [
                            "id",
                            "label",
                            "is_complete",
                            "completed_by",
                            "completed_at",
                            "sort_order"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "created_at": {
                        "type": "string"
                      },
                      "updated_at": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "object",
                      "service_ticket_id",
                      "visit_type",
                      "status",
                      "assigned_profile_id",
                      "scheduled_start",
                      "scheduled_end",
                      "en_route_at",
                      "arrived_at",
                      "departed_at",
                      "completed_at",
                      "address",
                      "customer_present",
                      "sentiment",
                      "billable",
                      "notes",
                      "technician_notes",
                      "customer_notes",
                      "checklist",
                      "created_at",
                      "updated_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "product_id": {
                        "type": "string"
                      },
                      "variant_id": {
                        "type": "string"
                      },
                      "product_name": {
                        "type": "string"
                      },
                      "variant_name": {
                        "type": "string"
                      },
                      "sku": {
                        "type": "string"
                      },
                      "item_kind": {
                        "type": "string"
                      },
                      "allocation_status": {
                        "type": "string"
                      },
                      "quantity": {
                        "type": "integer"
                      },
                      "unit_price": {
                        "type": "integer"
                      },
                      "line_total": {
                        "type": "integer"
                      },
                      "note": {},
                      "sort_order": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "id",
                      "product_id",
                      "variant_id",
                      "product_name",
                      "variant_name",
                      "sku",
                      "item_kind",
                      "allocation_status",
                      "quantity",
                      "unit_price",
                      "line_total",
                      "note",
                      "sort_order"
                    ],
                    "additionalProperties": false
                  }
                },
                "charges": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "charge_type": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "quantity": {
                        "type": "integer"
                      },
                      "unit_rate": {
                        "type": "integer"
                      },
                      "amount": {
                        "type": "integer"
                      },
                      "status": {
                        "type": "string"
                      },
                      "invoice_id": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "charge_type",
                      "description",
                      "quantity",
                      "unit_rate",
                      "amount",
                      "status",
                      "invoice_id"
                    ],
                    "additionalProperties": false
                  }
                },
                "time_entries": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "profile_id": {
                        "type": "string"
                      },
                      "entry_type": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string"
                      },
                      "minutes": {
                        "type": "integer"
                      },
                      "billable": {
                        "type": "boolean"
                      },
                      "hourly_rate": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "id",
                      "profile_id",
                      "entry_type",
                      "status",
                      "minutes",
                      "billable",
                      "hourly_rate"
                    ],
                    "additionalProperties": false
                  }
                },
                "warranty_claim": {},
                "events": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "event_type": {
                        "type": "string"
                      },
                      "actor_profile_id": {
                        "type": "string"
                      },
                      "note": {
                        "type": "string"
                      },
                      "created_at": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "event_type",
                      "actor_profile_id",
                      "note",
                      "created_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "ticket_number",
                "ticket_type",
                "status",
                "priority",
                "lifecycle_stage",
                "origin_channel",
                "customer",
                "service_address",
                "location_id",
                "product_id",
                "variant_id",
                "linked_sale_id",
                "converted_sale_id",
                "assigned_profile_id",
                "assigned_team_function",
                "project_id",
                "work_item_id",
                "warranty",
                "billing",
                "work_order_status",
                "summary",
                "details",
                "requested_resolution",
                "customer_concern",
                "resolution_summary",
                "scheduled_at",
                "next_follow_up_at",
                "completed_at",
                "closed_at",
                "visits",
                "items",
                "charges",
                "time_entries",
                "warranty_claim",
                "events",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list service tickets response projection."
      },
      "ServiceTicketEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "ticket_number": {
                "type": "string"
              },
              "ticket_type": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "priority": {
                "type": "string"
              },
              "lifecycle_stage": {
                "type": "string"
              },
              "origin_channel": {
                "type": "string"
              },
              "customer": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "phone": {
                    "type": "string"
                  },
                  "email": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "name",
                  "phone",
                  "email"
                ],
                "additionalProperties": false
              },
              "service_address": {
                "type": "object",
                "properties": {
                  "street": {
                    "type": "string"
                  },
                  "street_2": {},
                  "city": {
                    "type": "string"
                  },
                  "state": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  }
                },
                "required": [
                  "street",
                  "street_2",
                  "city",
                  "state",
                  "postal_code"
                ],
                "additionalProperties": false
              },
              "location_id": {
                "type": "string"
              },
              "product_id": {
                "type": "string"
              },
              "variant_id": {
                "type": "string"
              },
              "linked_sale_id": {
                "type": "string"
              },
              "converted_sale_id": {},
              "assigned_profile_id": {
                "type": "string"
              },
              "assigned_team_function": {
                "type": "string"
              },
              "project_id": {
                "type": "string"
              },
              "work_item_id": {
                "type": "string"
              },
              "warranty": {
                "type": "object",
                "properties": {
                  "provider": {
                    "type": "string"
                  },
                  "claim_number": {}
                },
                "required": [
                  "provider",
                  "claim_number"
                ],
                "additionalProperties": false
              },
              "billing": {
                "type": "object",
                "properties": {
                  "billable": {
                    "type": "boolean"
                  },
                  "estimated_charge": {
                    "type": "integer"
                  },
                  "approved_charge": {
                    "type": "integer"
                  },
                  "charge_status": {
                    "type": "string"
                  },
                  "quote_status": {
                    "type": "string"
                  },
                  "quote_total": {
                    "type": "integer"
                  }
                },
                "required": [
                  "billable",
                  "estimated_charge",
                  "approved_charge",
                  "charge_status",
                  "quote_status",
                  "quote_total"
                ],
                "additionalProperties": false
              },
              "work_order_status": {
                "type": "string"
              },
              "summary": {
                "type": "string"
              },
              "details": {
                "type": "string"
              },
              "requested_resolution": {
                "type": "string"
              },
              "customer_concern": {},
              "resolution_summary": {},
              "scheduled_at": {
                "type": "string"
              },
              "next_follow_up_at": {
                "type": "string"
              },
              "completed_at": {},
              "closed_at": {},
              "visits": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "service_ticket_id": {
                      "type": "string"
                    },
                    "visit_type": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "assigned_profile_id": {
                      "type": "string"
                    },
                    "scheduled_start": {
                      "type": "string"
                    },
                    "scheduled_end": {
                      "type": "string"
                    },
                    "en_route_at": {},
                    "arrived_at": {},
                    "departed_at": {},
                    "completed_at": {},
                    "address": {
                      "type": "object",
                      "properties": {
                        "line1": {
                          "type": "string"
                        },
                        "city": {
                          "type": "string"
                        },
                        "region": {
                          "type": "string"
                        },
                        "postal_code": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "line1",
                        "city",
                        "region",
                        "postal_code"
                      ],
                      "additionalProperties": false
                    },
                    "customer_present": {
                      "type": "boolean"
                    },
                    "sentiment": {},
                    "billable": {
                      "type": "boolean"
                    },
                    "notes": {
                      "type": "string"
                    },
                    "technician_notes": {},
                    "customer_notes": {
                      "type": "string"
                    },
                    "checklist": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "is_complete": {
                            "type": "boolean"
                          },
                          "completed_by": {},
                          "completed_at": {},
                          "sort_order": {
                            "type": "integer"
                          }
                        },
                        "required": [
                          "id",
                          "label",
                          "is_complete",
                          "completed_by",
                          "completed_at",
                          "sort_order"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "updated_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "object",
                    "service_ticket_id",
                    "visit_type",
                    "status",
                    "assigned_profile_id",
                    "scheduled_start",
                    "scheduled_end",
                    "en_route_at",
                    "arrived_at",
                    "departed_at",
                    "completed_at",
                    "address",
                    "customer_present",
                    "sentiment",
                    "billable",
                    "notes",
                    "technician_notes",
                    "customer_notes",
                    "checklist",
                    "created_at",
                    "updated_at"
                  ],
                  "additionalProperties": false
                }
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "variant_id": {
                      "type": "string"
                    },
                    "product_name": {
                      "type": "string"
                    },
                    "variant_name": {
                      "type": "string"
                    },
                    "sku": {
                      "type": "string"
                    },
                    "item_kind": {
                      "type": "string"
                    },
                    "allocation_status": {
                      "type": "string"
                    },
                    "quantity": {
                      "type": "integer"
                    },
                    "unit_price": {
                      "type": "integer"
                    },
                    "line_total": {
                      "type": "integer"
                    },
                    "note": {},
                    "sort_order": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "product_id",
                    "variant_id",
                    "product_name",
                    "variant_name",
                    "sku",
                    "item_kind",
                    "allocation_status",
                    "quantity",
                    "unit_price",
                    "line_total",
                    "note",
                    "sort_order"
                  ],
                  "additionalProperties": false
                }
              },
              "charges": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "charge_type": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "quantity": {
                      "type": "integer"
                    },
                    "unit_rate": {
                      "type": "integer"
                    },
                    "amount": {
                      "type": "integer"
                    },
                    "status": {
                      "type": "string"
                    },
                    "invoice_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "charge_type",
                    "description",
                    "quantity",
                    "unit_rate",
                    "amount",
                    "status",
                    "invoice_id"
                  ],
                  "additionalProperties": false
                }
              },
              "time_entries": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "profile_id": {
                      "type": "string"
                    },
                    "entry_type": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "minutes": {
                      "type": "integer"
                    },
                    "billable": {
                      "type": "boolean"
                    },
                    "hourly_rate": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "profile_id",
                    "entry_type",
                    "status",
                    "minutes",
                    "billable",
                    "hourly_rate"
                  ],
                  "additionalProperties": false
                }
              },
              "warranty_claim": {},
              "events": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "event_type": {
                      "type": "string"
                    },
                    "actor_profile_id": {
                      "type": "string"
                    },
                    "note": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "event_type",
                    "actor_profile_id",
                    "note",
                    "created_at"
                  ],
                  "additionalProperties": false
                }
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "ticket_number",
              "ticket_type",
              "status",
              "priority",
              "lifecycle_stage",
              "origin_channel",
              "customer",
              "service_address",
              "location_id",
              "product_id",
              "variant_id",
              "linked_sale_id",
              "converted_sale_id",
              "assigned_profile_id",
              "assigned_team_function",
              "project_id",
              "work_item_id",
              "warranty",
              "billing",
              "work_order_status",
              "summary",
              "details",
              "requested_resolution",
              "customer_concern",
              "resolution_summary",
              "scheduled_at",
              "next_follow_up_at",
              "completed_at",
              "closed_at",
              "visits",
              "items",
              "charges",
              "time_entries",
              "warranty_claim",
              "events",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get a complete service ticket response projection."
      },
      "ServiceVisitPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "service_ticket_id": {
                  "type": "string"
                },
                "visit_type": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "assigned_profile_id": {
                  "type": "string"
                },
                "scheduled_start": {
                  "type": "string"
                },
                "scheduled_end": {
                  "type": "string"
                },
                "en_route_at": {},
                "arrived_at": {},
                "departed_at": {},
                "completed_at": {},
                "address": {
                  "type": "object",
                  "properties": {
                    "line1": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "postal_code": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "line1",
                    "city",
                    "region",
                    "postal_code"
                  ],
                  "additionalProperties": false
                },
                "customer_present": {
                  "type": "boolean"
                },
                "sentiment": {},
                "billable": {
                  "type": "boolean"
                },
                "notes": {
                  "type": "string"
                },
                "technician_notes": {},
                "customer_notes": {
                  "type": "string"
                },
                "checklist": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "label": {
                        "type": "string"
                      },
                      "is_complete": {
                        "type": "boolean"
                      },
                      "completed_by": {},
                      "completed_at": {},
                      "sort_order": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "id",
                      "label",
                      "is_complete",
                      "completed_by",
                      "completed_at",
                      "sort_order"
                    ],
                    "additionalProperties": false
                  }
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "service_ticket_id",
                "visit_type",
                "status",
                "assigned_profile_id",
                "scheduled_start",
                "scheduled_end",
                "en_route_at",
                "arrived_at",
                "departed_at",
                "completed_at",
                "address",
                "customer_present",
                "sentiment",
                "billable",
                "notes",
                "technician_notes",
                "customer_notes",
                "checklist",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list service visits response projection."
      },
      "ServiceVisitEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "service_ticket_id": {
                "type": "string"
              },
              "visit_type": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "assigned_profile_id": {
                "type": "string"
              },
              "scheduled_start": {
                "type": "string"
              },
              "scheduled_end": {
                "type": "string"
              },
              "en_route_at": {},
              "arrived_at": {},
              "departed_at": {},
              "completed_at": {},
              "address": {
                "type": "object",
                "properties": {
                  "line1": {
                    "type": "string"
                  },
                  "city": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  }
                },
                "required": [
                  "line1",
                  "city",
                  "region",
                  "postal_code"
                ],
                "additionalProperties": false
              },
              "customer_present": {
                "type": "boolean"
              },
              "sentiment": {},
              "billable": {
                "type": "boolean"
              },
              "notes": {
                "type": "string"
              },
              "technician_notes": {},
              "customer_notes": {
                "type": "string"
              },
              "checklist": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "is_complete": {
                      "type": "boolean"
                    },
                    "completed_by": {},
                    "completed_at": {},
                    "sort_order": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "label",
                    "is_complete",
                    "completed_by",
                    "completed_at",
                    "sort_order"
                  ],
                  "additionalProperties": false
                }
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "service_ticket_id",
              "visit_type",
              "status",
              "assigned_profile_id",
              "scheduled_start",
              "scheduled_end",
              "en_route_at",
              "arrived_at",
              "departed_at",
              "completed_at",
              "address",
              "customer_present",
              "sentiment",
              "billable",
              "notes",
              "technician_notes",
              "customer_notes",
              "checklist",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get a service visit response projection."
      },
      "ProjectPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "project_number": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "project_type": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "health": {
                  "type": "string"
                },
                "location_id": {
                  "type": "string"
                },
                "engagement_id": {},
                "template_id": {
                  "type": "string"
                },
                "customer_id": {
                  "type": "string"
                },
                "linked_sale_id": {
                  "type": "string"
                },
                "owner_profile_id": {
                  "type": "string"
                },
                "start_on": {
                  "type": "string"
                },
                "due_on": {
                  "type": "string"
                },
                "completed_at": {},
                "boards": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "is_default": {
                        "type": "boolean"
                      },
                      "sort_order": {
                        "type": "integer"
                      },
                      "columns": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "status_key": {
                              "type": "string"
                            },
                            "sort_order": {
                              "type": "integer"
                            },
                            "wip_limit": {},
                            "is_done": {
                              "type": "boolean"
                            }
                          },
                          "required": [
                            "id",
                            "name",
                            "status_key",
                            "sort_order",
                            "wip_limit",
                            "is_done"
                          ],
                          "additionalProperties": false
                        }
                      }
                    },
                    "required": [
                      "id",
                      "name",
                      "is_default",
                      "sort_order",
                      "columns"
                    ],
                    "additionalProperties": false
                  }
                },
                "milestones": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string"
                      },
                      "owner_profile_id": {
                        "type": "string"
                      },
                      "due_on": {
                        "type": "string"
                      },
                      "completed_at": {},
                      "sort_order": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "id",
                      "title",
                      "status",
                      "owner_profile_id",
                      "due_on",
                      "completed_at",
                      "sort_order"
                    ],
                    "additionalProperties": false
                  }
                },
                "work_items": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "object": {
                        "type": "string"
                      },
                      "project_id": {
                        "type": "string"
                      },
                      "board_id": {
                        "type": "string"
                      },
                      "column_id": {
                        "type": "string"
                      },
                      "milestone_id": {
                        "type": "string"
                      },
                      "parent_item_id": {},
                      "item_number": {
                        "type": "string"
                      },
                      "item_type": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string"
                      },
                      "priority": {
                        "type": "string"
                      },
                      "assigned_profile_id": {
                        "type": "string"
                      },
                      "start_on": {
                        "type": "string"
                      },
                      "due_at": {
                        "type": "string"
                      },
                      "completed_at": {},
                      "estimated_minutes": {
                        "type": "integer"
                      },
                      "actual_minutes": {},
                      "recurrence_rule": {},
                      "sort_order": {
                        "type": "integer"
                      },
                      "checklist": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "title": {
                              "type": "string"
                            },
                            "is_complete": {
                              "type": "boolean"
                            },
                            "sort_order": {
                              "type": "integer"
                            }
                          },
                          "required": [
                            "id",
                            "title",
                            "is_complete",
                            "sort_order"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "dependencies": {
                        "type": "array",
                        "items": {}
                      },
                      "comments": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "body": {
                              "type": "string"
                            },
                            "author_profile_id": {
                              "type": "string"
                            },
                            "created_at": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "id",
                            "body",
                            "author_profile_id",
                            "created_at"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "approvals": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "status": {
                              "type": "string"
                            },
                            "request_note": {
                              "type": "string"
                            },
                            "decision_note": {},
                            "decided_at": {}
                          },
                          "required": [
                            "id",
                            "status",
                            "request_note",
                            "decision_note",
                            "decided_at"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "created_at": {
                        "type": "string"
                      },
                      "updated_at": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "object",
                      "project_id",
                      "board_id",
                      "column_id",
                      "milestone_id",
                      "parent_item_id",
                      "item_number",
                      "item_type",
                      "title",
                      "description",
                      "status",
                      "priority",
                      "assigned_profile_id",
                      "start_on",
                      "due_at",
                      "completed_at",
                      "estimated_minutes",
                      "actual_minutes",
                      "recurrence_rule",
                      "sort_order",
                      "checklist",
                      "dependencies",
                      "comments",
                      "approvals",
                      "created_at",
                      "updated_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "comments": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "body": {
                        "type": "string"
                      },
                      "author_profile_id": {
                        "type": "string"
                      },
                      "created_at": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "body",
                      "author_profile_id",
                      "created_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "contact_links": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "contact_id": {
                        "type": "string"
                      },
                      "role": {
                        "type": "string"
                      },
                      "is_primary": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "id",
                      "contact_id",
                      "role",
                      "is_primary"
                    ],
                    "additionalProperties": false
                  }
                },
                "invoice_links": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "invoice_id": {
                        "type": "string"
                      },
                      "created_at": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "invoice_id",
                      "created_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "project_number",
                "name",
                "description",
                "project_type",
                "status",
                "health",
                "location_id",
                "engagement_id",
                "template_id",
                "customer_id",
                "linked_sale_id",
                "owner_profile_id",
                "start_on",
                "due_on",
                "completed_at",
                "boards",
                "milestones",
                "work_items",
                "comments",
                "contact_links",
                "invoice_links",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list projects response projection."
      },
      "ProjectEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "project_number": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "project_type": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "health": {
                "type": "string"
              },
              "location_id": {
                "type": "string"
              },
              "engagement_id": {},
              "template_id": {
                "type": "string"
              },
              "customer_id": {
                "type": "string"
              },
              "linked_sale_id": {
                "type": "string"
              },
              "owner_profile_id": {
                "type": "string"
              },
              "start_on": {
                "type": "string"
              },
              "due_on": {
                "type": "string"
              },
              "completed_at": {},
              "boards": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "is_default": {
                      "type": "boolean"
                    },
                    "sort_order": {
                      "type": "integer"
                    },
                    "columns": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "status_key": {
                            "type": "string"
                          },
                          "sort_order": {
                            "type": "integer"
                          },
                          "wip_limit": {},
                          "is_done": {
                            "type": "boolean"
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "status_key",
                          "sort_order",
                          "wip_limit",
                          "is_done"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "is_default",
                    "sort_order",
                    "columns"
                  ],
                  "additionalProperties": false
                }
              },
              "milestones": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "owner_profile_id": {
                      "type": "string"
                    },
                    "due_on": {
                      "type": "string"
                    },
                    "completed_at": {},
                    "sort_order": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "title",
                    "status",
                    "owner_profile_id",
                    "due_on",
                    "completed_at",
                    "sort_order"
                  ],
                  "additionalProperties": false
                }
              },
              "work_items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "project_id": {
                      "type": "string"
                    },
                    "board_id": {
                      "type": "string"
                    },
                    "column_id": {
                      "type": "string"
                    },
                    "milestone_id": {
                      "type": "string"
                    },
                    "parent_item_id": {},
                    "item_number": {
                      "type": "string"
                    },
                    "item_type": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "priority": {
                      "type": "string"
                    },
                    "assigned_profile_id": {
                      "type": "string"
                    },
                    "start_on": {
                      "type": "string"
                    },
                    "due_at": {
                      "type": "string"
                    },
                    "completed_at": {},
                    "estimated_minutes": {
                      "type": "integer"
                    },
                    "actual_minutes": {},
                    "recurrence_rule": {},
                    "sort_order": {
                      "type": "integer"
                    },
                    "checklist": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "is_complete": {
                            "type": "boolean"
                          },
                          "sort_order": {
                            "type": "integer"
                          }
                        },
                        "required": [
                          "id",
                          "title",
                          "is_complete",
                          "sort_order"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "dependencies": {
                      "type": "array",
                      "items": {}
                    },
                    "comments": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "body": {
                            "type": "string"
                          },
                          "author_profile_id": {
                            "type": "string"
                          },
                          "created_at": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "body",
                          "author_profile_id",
                          "created_at"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "approvals": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "status": {
                            "type": "string"
                          },
                          "request_note": {
                            "type": "string"
                          },
                          "decision_note": {},
                          "decided_at": {}
                        },
                        "required": [
                          "id",
                          "status",
                          "request_note",
                          "decision_note",
                          "decided_at"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "updated_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "object",
                    "project_id",
                    "board_id",
                    "column_id",
                    "milestone_id",
                    "parent_item_id",
                    "item_number",
                    "item_type",
                    "title",
                    "description",
                    "status",
                    "priority",
                    "assigned_profile_id",
                    "start_on",
                    "due_at",
                    "completed_at",
                    "estimated_minutes",
                    "actual_minutes",
                    "recurrence_rule",
                    "sort_order",
                    "checklist",
                    "dependencies",
                    "comments",
                    "approvals",
                    "created_at",
                    "updated_at"
                  ],
                  "additionalProperties": false
                }
              },
              "comments": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "body": {
                      "type": "string"
                    },
                    "author_profile_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "body",
                    "author_profile_id",
                    "created_at"
                  ],
                  "additionalProperties": false
                }
              },
              "contact_links": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "contact_id": {
                      "type": "string"
                    },
                    "role": {
                      "type": "string"
                    },
                    "is_primary": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "contact_id",
                    "role",
                    "is_primary"
                  ],
                  "additionalProperties": false
                }
              },
              "invoice_links": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "invoice_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "invoice_id",
                    "created_at"
                  ],
                  "additionalProperties": false
                }
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "project_number",
              "name",
              "description",
              "project_type",
              "status",
              "health",
              "location_id",
              "engagement_id",
              "template_id",
              "customer_id",
              "linked_sale_id",
              "owner_profile_id",
              "start_on",
              "due_on",
              "completed_at",
              "boards",
              "milestones",
              "work_items",
              "comments",
              "contact_links",
              "invoice_links",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get a complete project response projection."
      },
      "WorkItemPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "project_id": {
                  "type": "string"
                },
                "board_id": {
                  "type": "string"
                },
                "column_id": {
                  "type": "string"
                },
                "milestone_id": {
                  "type": "string"
                },
                "parent_item_id": {},
                "item_number": {
                  "type": "string"
                },
                "item_type": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "priority": {
                  "type": "string"
                },
                "assigned_profile_id": {
                  "type": "string"
                },
                "start_on": {
                  "type": "string"
                },
                "due_at": {
                  "type": "string"
                },
                "completed_at": {},
                "estimated_minutes": {
                  "type": "integer"
                },
                "actual_minutes": {},
                "recurrence_rule": {},
                "sort_order": {
                  "type": "integer"
                },
                "checklist": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "title": {
                        "type": "string"
                      },
                      "is_complete": {
                        "type": "boolean"
                      },
                      "sort_order": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "id",
                      "title",
                      "is_complete",
                      "sort_order"
                    ],
                    "additionalProperties": false
                  }
                },
                "dependencies": {
                  "type": "array",
                  "items": {}
                },
                "comments": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "body": {
                        "type": "string"
                      },
                      "author_profile_id": {
                        "type": "string"
                      },
                      "created_at": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "body",
                      "author_profile_id",
                      "created_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "approvals": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "status": {
                        "type": "string"
                      },
                      "request_note": {
                        "type": "string"
                      },
                      "decision_note": {},
                      "decided_at": {}
                    },
                    "required": [
                      "id",
                      "status",
                      "request_note",
                      "decision_note",
                      "decided_at"
                    ],
                    "additionalProperties": false
                  }
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "project_id",
                "board_id",
                "column_id",
                "milestone_id",
                "parent_item_id",
                "item_number",
                "item_type",
                "title",
                "description",
                "status",
                "priority",
                "assigned_profile_id",
                "start_on",
                "due_at",
                "completed_at",
                "estimated_minutes",
                "actual_minutes",
                "recurrence_rule",
                "sort_order",
                "checklist",
                "dependencies",
                "comments",
                "approvals",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list project work items response projection."
      },
      "WorkItemEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "project_id": {
                "type": "string"
              },
              "board_id": {
                "type": "string"
              },
              "column_id": {
                "type": "string"
              },
              "milestone_id": {
                "type": "string"
              },
              "parent_item_id": {},
              "item_number": {
                "type": "string"
              },
              "item_type": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "priority": {
                "type": "string"
              },
              "assigned_profile_id": {
                "type": "string"
              },
              "start_on": {
                "type": "string"
              },
              "due_at": {
                "type": "string"
              },
              "completed_at": {},
              "estimated_minutes": {
                "type": "integer"
              },
              "actual_minutes": {},
              "recurrence_rule": {},
              "sort_order": {
                "type": "integer"
              },
              "checklist": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "is_complete": {
                      "type": "boolean"
                    },
                    "sort_order": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "title",
                    "is_complete",
                    "sort_order"
                  ],
                  "additionalProperties": false
                }
              },
              "dependencies": {
                "type": "array",
                "items": {}
              },
              "comments": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "body": {
                      "type": "string"
                    },
                    "author_profile_id": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "body",
                    "author_profile_id",
                    "created_at"
                  ],
                  "additionalProperties": false
                }
              },
              "approvals": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "request_note": {
                      "type": "string"
                    },
                    "decision_note": {},
                    "decided_at": {}
                  },
                  "required": [
                    "id",
                    "status",
                    "request_note",
                    "decision_note",
                    "decided_at"
                  ],
                  "additionalProperties": false
                }
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "project_id",
              "board_id",
              "column_id",
              "milestone_id",
              "parent_item_id",
              "item_number",
              "item_type",
              "title",
              "description",
              "status",
              "priority",
              "assigned_profile_id",
              "start_on",
              "due_at",
              "completed_at",
              "estimated_minutes",
              "actual_minutes",
              "recurrence_rule",
              "sort_order",
              "checklist",
              "dependencies",
              "comments",
              "approvals",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get a complete work item response projection."
      },
      "WebhookEventPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "type": {
                  "type": "string"
                },
                "api_version": {
                  "type": "string"
                },
                "created_at": {
                  "type": "string"
                },
                "data": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "object": {
                          "type": "string"
                        },
                        "slug": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "short_description": {
                          "type": "string"
                        },
                        "description_html": {
                          "type": "string"
                        },
                        "event_kind": {
                          "type": "string"
                        },
                        "delivery_format": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        },
                        "visibility": {
                          "type": "string"
                        },
                        "timezone": {
                          "type": "string"
                        },
                        "venue_id": {},
                        "venue_name": {
                          "type": "string"
                        },
                        "support_email": {
                          "type": "string"
                        },
                        "support_phone": {
                          "type": "string"
                        },
                        "registration_opens_at": {
                          "type": "string"
                        },
                        "registration_closes_at": {
                          "type": "string"
                        },
                        "minimum_age_months": {
                          "type": "integer"
                        },
                        "maximum_age_months": {
                          "type": "integer"
                        },
                        "primary_image_url": {
                          "type": "string"
                        },
                        "image_alt_text": {
                          "type": "string"
                        },
                        "canonical_public_url": {},
                        "registration_url": {},
                        "redirect_url": {},
                        "redirect_status_code": {},
                        "redirect_expires_at": {},
                        "source_system": {
                          "type": "string"
                        },
                        "external_id": {},
                        "version": {
                          "type": "integer"
                        },
                        "published_at": {
                          "type": "string"
                        },
                        "created_at": {
                          "type": "string"
                        },
                        "updated_at": {
                          "type": "string"
                        },
                        "changed_fields": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "resource_url": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "object",
                        "slug",
                        "name",
                        "short_description",
                        "description_html",
                        "event_kind",
                        "delivery_format",
                        "status",
                        "visibility",
                        "timezone",
                        "venue_id",
                        "venue_name",
                        "support_email",
                        "support_phone",
                        "registration_opens_at",
                        "registration_closes_at",
                        "minimum_age_months",
                        "maximum_age_months",
                        "primary_image_url",
                        "image_alt_text",
                        "canonical_public_url",
                        "registration_url",
                        "redirect_url",
                        "redirect_status_code",
                        "redirect_expires_at",
                        "source_system",
                        "external_id",
                        "version",
                        "published_at",
                        "created_at",
                        "updated_at",
                        "changed_fields",
                        "resource_url"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "object"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "id",
                "type",
                "api_version",
                "created_at",
                "data"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "next_cursor": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "next_cursor",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              }
            },
            "required": [
              "request_id",
              "environment"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list webhook events response projection."
      },
      "EventPlatformResourceEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "resource_path": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "status",
              "resource_path"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted validate event publication response projection."
      },
      "EventPlatformResourcePage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "resource_path": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "status",
                "resource_path"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event venues response projection."
      },
      "EventTicketProductPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "sku": {
                  "type": "string"
                },
                "barcode": {},
                "brand_id": {},
                "product_type": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "online_description": {
                  "type": "string"
                },
                "retail_price": {
                  "type": "integer"
                },
                "recommended_retail_price": {},
                "track_inventory": {
                  "type": "boolean"
                },
                "has_serial_numbers": {
                  "type": "boolean"
                },
                "is_active": {
                  "type": "boolean"
                },
                "sell_pos": {
                  "type": "boolean"
                },
                "sell_online": {
                  "type": "boolean"
                },
                "publish_status": {
                  "type": "string"
                },
                "online_backorder_policy": {
                  "type": "object",
                  "properties": {
                    "mode": {
                      "type": "string"
                    },
                    "max_backorder_quantity": {},
                    "eta_days": {},
                    "customer_message": {}
                  },
                  "required": [
                    "mode",
                    "max_backorder_quantity",
                    "eta_days",
                    "customer_message"
                  ],
                  "additionalProperties": false
                },
                "channel_status": {},
                "sold_status": {},
                "dimensions": {
                  "type": "object",
                  "properties": {
                    "length": {},
                    "width": {},
                    "height": {},
                    "unit": {},
                    "weight": {},
                    "weight_unit": {}
                  },
                  "required": [
                    "length",
                    "width",
                    "height",
                    "unit",
                    "weight",
                    "weight_unit"
                  ],
                  "additionalProperties": false
                },
                "seo": {
                  "type": "object",
                  "properties": {
                    "slug": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "slug",
                    "title",
                    "description"
                  ],
                  "additionalProperties": false
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                },
                "fulfillment_medium": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "name",
                "sku",
                "barcode",
                "brand_id",
                "product_type",
                "description",
                "online_description",
                "retail_price",
                "recommended_retail_price",
                "track_inventory",
                "has_serial_numbers",
                "is_active",
                "sell_pos",
                "sell_online",
                "publish_status",
                "online_backorder_policy",
                "channel_status",
                "sold_status",
                "dimensions",
                "seo",
                "created_at",
                "updated_at",
                "fulfillment_medium"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              },
              "next_cursor": {}
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "has_more",
              "limit",
              "next_cursor"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event-ticket products response projection."
      },
      "EventTicketProductEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "sku": {
                "type": "string"
              },
              "barcode": {},
              "brand_id": {},
              "product_type": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "online_description": {
                "type": "string"
              },
              "retail_price": {
                "type": "integer"
              },
              "recommended_retail_price": {},
              "track_inventory": {
                "type": "boolean"
              },
              "has_serial_numbers": {
                "type": "boolean"
              },
              "is_active": {
                "type": "boolean"
              },
              "sell_pos": {
                "type": "boolean"
              },
              "sell_online": {
                "type": "boolean"
              },
              "publish_status": {
                "type": "string"
              },
              "online_backorder_policy": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string"
                  },
                  "max_backorder_quantity": {},
                  "eta_days": {},
                  "customer_message": {}
                },
                "required": [
                  "mode",
                  "max_backorder_quantity",
                  "eta_days",
                  "customer_message"
                ],
                "additionalProperties": false
              },
              "channel_status": {},
              "sold_status": {},
              "dimensions": {
                "type": "object",
                "properties": {
                  "length": {},
                  "width": {},
                  "height": {},
                  "unit": {},
                  "weight": {},
                  "weight_unit": {}
                },
                "required": [
                  "length",
                  "width",
                  "height",
                  "unit",
                  "weight",
                  "weight_unit"
                ],
                "additionalProperties": false
              },
              "seo": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "title": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  }
                },
                "required": [
                  "slug",
                  "title",
                  "description"
                ],
                "additionalProperties": false
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "fulfillment_medium": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "name",
              "sku",
              "barcode",
              "brand_id",
              "product_type",
              "description",
              "online_description",
              "retail_price",
              "recommended_retail_price",
              "track_inventory",
              "has_serial_numbers",
              "is_active",
              "sell_pos",
              "sell_online",
              "publish_status",
              "online_backorder_policy",
              "channel_status",
              "sold_status",
              "dimensions",
              "seo",
              "created_at",
              "updated_at",
              "fulfillment_medium"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event-ticket product response projection."
      },
      "EventOfferingPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "slug": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "short_description": {
                  "type": "string"
                },
                "description_html": {
                  "type": "string"
                },
                "event_kind": {
                  "type": "string"
                },
                "delivery_format": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "visibility": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "venue_name": {
                  "type": "string"
                },
                "location_details": {
                  "type": "object",
                  "properties": {
                    "address": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "postal_code": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "address",
                    "city",
                    "region",
                    "postal_code"
                  ],
                  "additionalProperties": false
                },
                "online_meeting_url": {},
                "support_email": {
                  "type": "string"
                },
                "support_phone": {
                  "type": "string"
                },
                "registration_opens_at": {
                  "type": "string"
                },
                "registration_closes_at": {
                  "type": "string"
                },
                "minimum_age_months": {
                  "type": "integer"
                },
                "maximum_age_months": {
                  "type": "integer"
                },
                "primary_image_url": {
                  "type": "string"
                },
                "image_alt_text": {
                  "type": "string"
                },
                "theme": {
                  "type": "object",
                  "properties": {
                    "primary_color": {
                      "type": "string"
                    },
                    "accent_color": {
                      "type": "string"
                    },
                    "card_style": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "primary_color",
                    "accent_color",
                    "card_style"
                  ],
                  "additionalProperties": false
                },
                "portal_settings": {
                  "type": "object",
                  "properties": {
                    "show_schedule": {
                      "type": "boolean"
                    },
                    "show_tickets": {
                      "type": "boolean"
                    },
                    "show_calendar_download": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "show_schedule",
                    "show_tickets",
                    "show_calendar_download"
                  ],
                  "additionalProperties": false
                },
                "metadata": {
                  "type": "object",
                  "properties": {
                    "reporting_program": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "reporting_program"
                  ],
                  "additionalProperties": false
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "published_at": {
                  "type": "string"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "slug",
                "name",
                "short_description",
                "description_html",
                "event_kind",
                "delivery_format",
                "status",
                "visibility",
                "timezone",
                "venue_name",
                "location_details",
                "online_meeting_url",
                "support_email",
                "support_phone",
                "registration_opens_at",
                "registration_closes_at",
                "minimum_age_months",
                "maximum_age_months",
                "primary_image_url",
                "image_alt_text",
                "theme",
                "portal_settings",
                "metadata",
                "source_system",
                "external_id",
                "version",
                "published_at",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event offerings response projection."
      },
      "EventOfferingEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "short_description": {
                "type": "string"
              },
              "description_html": {
                "type": "string"
              },
              "event_kind": {
                "type": "string"
              },
              "delivery_format": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "visibility": {
                "type": "string"
              },
              "timezone": {
                "type": "string"
              },
              "venue_name": {
                "type": "string"
              },
              "location_details": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string"
                  },
                  "city": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  }
                },
                "required": [
                  "address",
                  "city",
                  "region",
                  "postal_code"
                ],
                "additionalProperties": false
              },
              "online_meeting_url": {},
              "support_email": {
                "type": "string"
              },
              "support_phone": {
                "type": "string"
              },
              "registration_opens_at": {
                "type": "string"
              },
              "registration_closes_at": {
                "type": "string"
              },
              "minimum_age_months": {
                "type": "integer"
              },
              "maximum_age_months": {
                "type": "integer"
              },
              "primary_image_url": {
                "type": "string"
              },
              "image_alt_text": {
                "type": "string"
              },
              "theme": {
                "type": "object",
                "properties": {
                  "primary_color": {
                    "type": "string"
                  },
                  "accent_color": {
                    "type": "string"
                  },
                  "card_style": {
                    "type": "string"
                  }
                },
                "required": [
                  "primary_color",
                  "accent_color",
                  "card_style"
                ],
                "additionalProperties": false
              },
              "portal_settings": {
                "type": "object",
                "properties": {
                  "show_schedule": {
                    "type": "boolean"
                  },
                  "show_tickets": {
                    "type": "boolean"
                  },
                  "show_calendar_download": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "show_schedule",
                  "show_tickets",
                  "show_calendar_download"
                ],
                "additionalProperties": false
              },
              "metadata": {
                "type": "object",
                "properties": {
                  "reporting_program": {
                    "type": "string"
                  }
                },
                "required": [
                  "reporting_program"
                ],
                "additionalProperties": false
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "published_at": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "slug",
              "name",
              "short_description",
              "description_html",
              "event_kind",
              "delivery_format",
              "status",
              "visibility",
              "timezone",
              "venue_name",
              "location_details",
              "online_meeting_url",
              "support_email",
              "support_phone",
              "registration_opens_at",
              "registration_closes_at",
              "minimum_age_months",
              "maximum_age_months",
              "primary_image_url",
              "image_alt_text",
              "theme",
              "portal_settings",
              "metadata",
              "source_system",
              "external_id",
              "version",
              "published_at",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event offering response projection."
      },
      "EventOfferingReportEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string"
              },
              "generated_at": {
                "type": "string"
              },
              "tenant_id": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "ticket_options": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "ticket_option_id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "registrations": {
                      "type": "integer"
                    },
                    "seats": {
                      "type": "integer"
                    },
                    "gross": {
                      "type": "integer"
                    },
                    "cancelled": {
                      "type": "integer"
                    },
                    "refunded": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "ticket_option_id",
                    "label",
                    "registrations",
                    "seats",
                    "gross",
                    "cancelled",
                    "refunded"
                  ],
                  "additionalProperties": false
                }
              },
              "participant_repeat": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "segment": {
                      "type": "string"
                    },
                    "participants": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "segment",
                    "participants"
                  ],
                  "additionalProperties": false
                }
              },
              "age_bands": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "band": {
                      "type": "string"
                    },
                    "participants": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "band",
                    "participants"
                  ],
                  "additionalProperties": false
                }
              },
              "attendance": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "segment": {
                      "type": "string"
                    },
                    "registrations": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "segment",
                    "registrations"
                  ],
                  "additionalProperties": false
                }
              },
              "registration_lifecycle": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "registrations": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "status",
                    "registrations"
                  ],
                  "additionalProperties": false
                }
              },
              "waitlist": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string"
                    },
                    "entries": {
                      "type": "integer"
                    },
                    "requested_seats": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "status",
                    "entries",
                    "requested_seats"
                  ],
                  "additionalProperties": false
                }
              },
              "capacity": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "pool_id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "capacity": {
                      "type": "integer"
                    },
                    "overbook_allowance": {
                      "type": "integer"
                    },
                    "booked_units": {
                      "type": "integer"
                    },
                    "utilization_percent": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "pool_id",
                    "name",
                    "capacity",
                    "overbook_allowance",
                    "booked_units",
                    "utilization_percent"
                  ],
                  "additionalProperties": false
                }
              },
              "addons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "product_id": {
                      "type": "string"
                    },
                    "product_name": {
                      "type": "string"
                    },
                    "variant_id": {
                      "type": "string"
                    },
                    "variant_name": {
                      "type": "string"
                    },
                    "assigned_units": {
                      "type": "integer"
                    },
                    "returned_units": {
                      "type": "integer"
                    },
                    "gross_revenue": {
                      "type": "integer"
                    },
                    "net_revenue": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "product_id",
                    "product_name",
                    "variant_id",
                    "variant_name",
                    "assigned_units",
                    "returned_units",
                    "gross_revenue",
                    "net_revenue"
                  ],
                  "additionalProperties": false
                }
              },
              "sessions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "occurrence_id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "instance_id": {
                      "type": "string"
                    },
                    "starts_at": {
                      "type": "string"
                    },
                    "selected": {
                      "type": "integer"
                    },
                    "attended": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "occurrence_id",
                    "name",
                    "instance_id",
                    "starts_at",
                    "selected",
                    "attended"
                  ],
                  "additionalProperties": false
                }
              },
              "tracks": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "track_id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "sessions": {
                      "type": "integer"
                    },
                    "enrollments": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "track_id",
                    "name",
                    "sessions",
                    "enrollments"
                  ],
                  "additionalProperties": false
                }
              },
              "stakeholders": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "role": {
                      "type": "string"
                    },
                    "display_name": {
                      "type": "string"
                    },
                    "occurrence_id": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "role",
                    "display_name",
                    "occurrence_id"
                  ],
                  "additionalProperties": false
                }
              },
              "reported_answers": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "report_key": {
                      "type": "string"
                    },
                    "value": {
                      "type": "string"
                    },
                    "responses": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "report_key",
                    "value",
                    "responses"
                  ],
                  "additionalProperties": false
                }
              },
              "financial_summary": {
                "type": "object",
                "properties": {
                  "gross_registration_amount": {
                    "type": "integer"
                  },
                  "receipt_line_gross": {
                    "type": "integer"
                  },
                  "discount_amount": {
                    "type": "integer"
                  },
                  "refunded_registration_amount": {
                    "type": "integer"
                  },
                  "net_registration_amount": {
                    "type": "integer"
                  }
                },
                "required": [
                  "gross_registration_amount",
                  "receipt_line_gross",
                  "discount_amount",
                  "refunded_registration_amount",
                  "net_registration_amount"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "object",
              "generated_at",
              "tenant_id",
              "offering_id",
              "ticket_options",
              "participant_repeat",
              "age_bands",
              "attendance",
              "registration_lifecycle",
              "waitlist",
              "capacity",
              "addons",
              "sessions",
              "tracks",
              "stakeholders",
              "reported_answers",
              "financial_summary"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "response_byte_limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "response_byte_limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get an event offering report response projection."
      },
      "EventSpacePage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "code": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "venue_name": {
                  "type": "string"
                },
                "capacity": {
                  "type": "integer"
                },
                "location_details": {
                  "type": "object",
                  "properties": {
                    "floor": {
                      "type": "string"
                    },
                    "room": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "floor",
                    "room"
                  ],
                  "additionalProperties": false
                },
                "status": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "code",
                "name",
                "venue_name",
                "capacity",
                "location_details",
                "status",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event spaces response projection."
      },
      "EventSpaceEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "venue_name": {
                "type": "string"
              },
              "capacity": {
                "type": "integer"
              },
              "location_details": {
                "type": "object",
                "properties": {
                  "floor": {
                    "type": "string"
                  },
                  "room": {
                    "type": "string"
                  }
                },
                "required": [
                  "floor",
                  "room"
                ],
                "additionalProperties": false
              },
              "status": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "code",
              "name",
              "venue_name",
              "capacity",
              "location_details",
              "status",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event space response projection."
      },
      "EventTrackPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "code": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "color": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "code",
                "name",
                "description",
                "color",
                "status",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event tracks response projection."
      },
      "EventTrackEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "color": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "code",
              "name",
              "description",
              "color",
              "status",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event track response projection."
      },
      "EventPersonPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "display_name": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "bio_html": {
                  "type": "string"
                },
                "photo_url": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                },
                "customer_reference_omitted": {
                  "type": "boolean"
                }
              },
              "required": [
                "id",
                "object",
                "display_name",
                "title",
                "bio_html",
                "photo_url",
                "status",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at",
                "customer_reference_omitted"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event people response projection."
      },
      "EventPersonEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "display_name": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "bio_html": {
                "type": "string"
              },
              "photo_url": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "customer_reference_omitted": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "object",
              "display_name",
              "title",
              "bio_html",
              "photo_url",
              "status",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at",
              "customer_reference_omitted"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event person response projection."
      },
      "EventOrganizationPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "organization_type": {
                  "type": "string"
                },
                "description_html": {
                  "type": "string"
                },
                "website_url": {
                  "type": "string"
                },
                "logo_url": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "name",
                "organization_type",
                "description_html",
                "website_url",
                "logo_url",
                "status",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event organizations response projection."
      },
      "EventOrganizationEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "organization_type": {
                "type": "string"
              },
              "description_html": {
                "type": "string"
              },
              "website_url": {
                "type": "string"
              },
              "logo_url": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "name",
              "organization_type",
              "description_html",
              "website_url",
              "logo_url",
              "status",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event organization response projection."
      },
      "EventStakeholderPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "person_id": {
                  "type": "string"
                },
                "organization_id": {},
                "role": {
                  "type": "string"
                },
                "role_label": {
                  "type": "string"
                },
                "is_public": {
                  "type": "boolean"
                },
                "sort_order": {
                  "type": "integer"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "occurrence_id",
                "person_id",
                "organization_id",
                "role",
                "role_label",
                "is_public",
                "sort_order",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event stakeholders response projection."
      },
      "EventStakeholderEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "occurrence_id": {
                "type": "string"
              },
              "person_id": {
                "type": "string"
              },
              "organization_id": {},
              "role": {
                "type": "string"
              },
              "role_label": {
                "type": "string"
              },
              "is_public": {
                "type": "boolean"
              },
              "sort_order": {
                "type": "integer"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "occurrence_id",
              "person_id",
              "organization_id",
              "role",
              "role_label",
              "is_public",
              "sort_order",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event stakeholder response projection."
      },
      "EventSelectionGroupPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "ticket_option_id": {
                  "type": "string"
                },
                "code": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "minimum_selections": {
                  "type": "integer"
                },
                "maximum_selections": {
                  "type": "integer"
                },
                "conflict_policy": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "sort_order": {
                  "type": "integer"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "ticket_option_id",
                "code",
                "name",
                "description",
                "minimum_selections",
                "maximum_selections",
                "conflict_policy",
                "status",
                "sort_order",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event selection groups response projection."
      },
      "EventSelectionGroupEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "ticket_option_id": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "minimum_selections": {
                "type": "integer"
              },
              "maximum_selections": {
                "type": "integer"
              },
              "conflict_policy": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "sort_order": {
                "type": "integer"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "ticket_option_id",
              "code",
              "name",
              "description",
              "minimum_selections",
              "maximum_selections",
              "conflict_policy",
              "status",
              "sort_order",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event selection group response projection."
      },
      "EventSelectionGroupOccurrencePage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "object": {
                  "type": "string"
                },
                "selection_group_id": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "sort_order": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                }
              },
              "required": [
                "object",
                "selection_group_id",
                "occurrence_id",
                "sort_order",
                "created_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              },
              "next_cursor": {}
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "has_more",
              "limit",
              "next_cursor"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list selection-group occurrences response projection."
      },
      "EventSelectionGroupOccurrenceEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string"
              },
              "selection_group_id": {
                "type": "string"
              },
              "occurrence_id": {
                "type": "string"
              },
              "sort_order": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              }
            },
            "required": [
              "object",
              "selection_group_id",
              "occurrence_id",
              "sort_order",
              "created_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted add an occurrence to a selection group response projection."
      },
      "EventAddonOptionPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "ticket_option_id": {},
                "product_id": {
                  "type": "string"
                },
                "variant_id": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "minimum_per_participant": {
                  "type": "integer"
                },
                "maximum_per_participant": {
                  "type": "integer"
                },
                "required": {
                  "type": "boolean"
                },
                "status": {
                  "type": "string"
                },
                "sort_order": {
                  "type": "integer"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "ticket_option_id",
                "product_id",
                "variant_id",
                "label",
                "description",
                "minimum_per_participant",
                "maximum_per_participant",
                "required",
                "status",
                "sort_order",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event add-on options response projection."
      },
      "EventAddonOptionEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "ticket_option_id": {},
              "product_id": {
                "type": "string"
              },
              "variant_id": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "minimum_per_participant": {
                "type": "integer"
              },
              "maximum_per_participant": {
                "type": "integer"
              },
              "required": {
                "type": "boolean"
              },
              "status": {
                "type": "string"
              },
              "sort_order": {
                "type": "integer"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "ticket_option_id",
              "product_id",
              "variant_id",
              "label",
              "description",
              "minimum_per_participant",
              "maximum_per_participant",
              "required",
              "status",
              "sort_order",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event add-on option response projection."
      },
      "EventOccurrencePage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_key": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "session_kind": {
                  "type": "string"
                },
                "enrollment_policy": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "all_day": {
                  "type": "boolean"
                },
                "recurrence_rule": {
                  "type": "string"
                },
                "recurrence_until": {
                  "type": "string"
                },
                "venue_name": {
                  "type": "string"
                },
                "location_details": {
                  "type": "object",
                  "properties": {
                    "address": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "postal_code": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "address",
                    "city",
                    "region",
                    "postal_code"
                  ],
                  "additionalProperties": false
                },
                "online_meeting_url": {},
                "attendee_instructions": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "occurrence_key",
                "name",
                "session_kind",
                "enrollment_policy",
                "status",
                "starts_at",
                "ends_at",
                "timezone",
                "all_day",
                "recurrence_rule",
                "recurrence_until",
                "venue_name",
                "location_details",
                "online_meeting_url",
                "attendee_instructions",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event occurrences response projection."
      },
      "EventOccurrenceEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "occurrence_key": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "session_kind": {
                "type": "string"
              },
              "enrollment_policy": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "starts_at": {
                "type": "string"
              },
              "ends_at": {
                "type": "string"
              },
              "timezone": {
                "type": "string"
              },
              "all_day": {
                "type": "boolean"
              },
              "recurrence_rule": {
                "type": "string"
              },
              "recurrence_until": {
                "type": "string"
              },
              "venue_name": {
                "type": "string"
              },
              "location_details": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string"
                  },
                  "city": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string"
                  },
                  "postal_code": {
                    "type": "string"
                  }
                },
                "required": [
                  "address",
                  "city",
                  "region",
                  "postal_code"
                ],
                "additionalProperties": false
              },
              "online_meeting_url": {},
              "attendee_instructions": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "occurrence_key",
              "name",
              "session_kind",
              "enrollment_policy",
              "status",
              "starts_at",
              "ends_at",
              "timezone",
              "all_day",
              "recurrence_rule",
              "recurrence_until",
              "venue_name",
              "location_details",
              "online_meeting_url",
              "attendee_instructions",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event occurrence response projection."
      },
      "EventOccurrenceSeriesReconciliationEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "reconciliation_id": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "staged_count": {
                "type": "integer"
              },
              "version": {
                "type": "integer"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "reconciliation_id",
              "status",
              "staged_count",
              "version",
              "idempotency_result"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted reconcile a recurring occurrence series response projection."
      },
      "EventOccurrenceExceptionPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "original_start_at": {
                  "type": "string"
                },
                "exception_type": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "override_fields": {
                  "type": "object",
                  "properties": {
                    "attendee_instructions": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "attendee_instructions"
                  ],
                  "additionalProperties": false
                },
                "reason": {
                  "type": "string"
                },
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "occurrence_id",
                "original_start_at",
                "exception_type",
                "starts_at",
                "ends_at",
                "override_fields",
                "reason",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list occurrence exceptions response projection."
      },
      "EventOccurrenceExceptionEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "occurrence_id": {
                "type": "string"
              },
              "original_start_at": {
                "type": "string"
              },
              "exception_type": {
                "type": "string"
              },
              "starts_at": {
                "type": "string"
              },
              "ends_at": {
                "type": "string"
              },
              "override_fields": {
                "type": "object",
                "properties": {
                  "attendee_instructions": {
                    "type": "string"
                  }
                },
                "required": [
                  "attendee_instructions"
                ],
                "additionalProperties": false
              },
              "reason": {
                "type": "string"
              },
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "occurrence_id",
              "original_start_at",
              "exception_type",
              "starts_at",
              "ends_at",
              "override_fields",
              "reason",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an occurrence exception response projection."
      },
      "EventOccurrenceInstancePage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "exception_id": {},
                "instance_key": {
                  "type": "string"
                },
                "original_start_at": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {
                  "type": "string"
                },
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "occurrence_id",
                "exception_id",
                "instance_key",
                "original_start_at",
                "starts_at",
                "ends_at",
                "timezone",
                "status",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              },
              "next_cursor": {}
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "has_more",
              "limit",
              "next_cursor"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list concrete occurrence instances response projection."
      },
      "EventOccurrenceInstanceListEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "exception_id": {},
                "instance_key": {
                  "type": "string"
                },
                "original_start_at": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {
                  "type": "string"
                },
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "occurrence_id",
                "exception_id",
                "instance_key",
                "original_start_at",
                "starts_at",
                "ends_at",
                "timezone",
                "status",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted materialize concrete occurrence instances response projection."
      },
      "EventOccurrenceInstanceEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "occurrence_id": {
                "type": "string"
              },
              "exception_id": {},
              "instance_key": {
                "type": "string"
              },
              "original_start_at": {
                "type": "string"
              },
              "starts_at": {
                "type": "string"
              },
              "ends_at": {
                "type": "string"
              },
              "timezone": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {
                "type": "string"
              },
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "occurrence_id",
              "exception_id",
              "instance_key",
              "original_start_at",
              "starts_at",
              "ends_at",
              "timezone",
              "status",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get a concrete occurrence instance response projection."
      },
      "EventOccurrenceTrackPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "object": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "track_id": {
                  "type": "string"
                },
                "sort_order": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                }
              },
              "required": [
                "object",
                "occurrence_id",
                "track_id",
                "sort_order",
                "created_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              },
              "next_cursor": {}
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "has_more",
              "limit",
              "next_cursor"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list occurrence tracks response projection."
      },
      "EventOccurrenceTrackEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string"
              },
              "occurrence_id": {
                "type": "string"
              },
              "track_id": {
                "type": "string"
              },
              "sort_order": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              }
            },
            "required": [
              "object",
              "occurrence_id",
              "track_id",
              "sort_order",
              "created_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted add a track to an occurrence response projection."
      },
      "EventCapacityPoolPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "code": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "capacity": {
                  "type": "integer"
                },
                "overbook_allowance": {
                  "type": "integer"
                },
                "waitlist_enabled": {
                  "type": "boolean"
                },
                "status": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "occurrence_id",
                "code",
                "name",
                "capacity",
                "overbook_allowance",
                "waitlist_enabled",
                "status",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event capacity pools response projection."
      },
      "EventCapacityPoolEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "occurrence_id": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "capacity": {
                "type": "integer"
              },
              "overbook_allowance": {
                "type": "integer"
              },
              "waitlist_enabled": {
                "type": "boolean"
              },
              "status": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "occurrence_id",
              "code",
              "name",
              "capacity",
              "overbook_allowance",
              "waitlist_enabled",
              "status",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event capacity pool response projection."
      },
      "EventTicketOptionPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "product_id": {
                  "type": "string"
                },
                "code": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "sales_opens_at": {
                  "type": "string"
                },
                "sales_closes_at": {
                  "type": "string"
                },
                "minimum_per_order": {
                  "type": "integer"
                },
                "maximum_per_order": {
                  "type": "integer"
                },
                "seats_per_ticket": {
                  "type": "integer"
                },
                "assignment_policy": {
                  "type": "string"
                },
                "assignment_deadline_at": {},
                "sort_order": {
                  "type": "integer"
                },
                "eligibility_rules": {
                  "type": "object",
                  "properties": {
                    "minimum_age_months": {
                      "type": "integer"
                    },
                    "maximum_age_months": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "minimum_age_months",
                    "maximum_age_months"
                  ],
                  "additionalProperties": false
                },
                "portal_settings": {
                  "type": "object",
                  "properties": {
                    "show_schedule": {
                      "type": "boolean"
                    },
                    "show_ticket": {
                      "type": "boolean"
                    },
                    "calendar_download": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "show_schedule",
                    "show_ticket",
                    "calendar_download"
                  ],
                  "additionalProperties": false
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "product_id",
                "code",
                "label",
                "description",
                "status",
                "sales_opens_at",
                "sales_closes_at",
                "minimum_per_order",
                "maximum_per_order",
                "seats_per_ticket",
                "assignment_policy",
                "assignment_deadline_at",
                "sort_order",
                "eligibility_rules",
                "portal_settings",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event ticket options response projection."
      },
      "EventTicketOptionEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "product_id": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "sales_opens_at": {
                "type": "string"
              },
              "sales_closes_at": {
                "type": "string"
              },
              "minimum_per_order": {
                "type": "integer"
              },
              "maximum_per_order": {
                "type": "integer"
              },
              "seats_per_ticket": {
                "type": "integer"
              },
              "assignment_policy": {
                "type": "string"
              },
              "assignment_deadline_at": {},
              "sort_order": {
                "type": "integer"
              },
              "eligibility_rules": {
                "type": "object",
                "properties": {
                  "minimum_age_months": {
                    "type": "integer"
                  },
                  "maximum_age_months": {
                    "type": "integer"
                  }
                },
                "required": [
                  "minimum_age_months",
                  "maximum_age_months"
                ],
                "additionalProperties": false
              },
              "portal_settings": {
                "type": "object",
                "properties": {
                  "show_schedule": {
                    "type": "boolean"
                  },
                  "show_ticket": {
                    "type": "boolean"
                  },
                  "calendar_download": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "show_schedule",
                  "show_ticket",
                  "calendar_download"
                ],
                "additionalProperties": false
              },
              "relationships": {
                "type": "object",
                "properties": {
                  "occurrences": {
                    "type": "object",
                    "properties": {
                      "count": {
                        "type": "integer"
                      },
                      "collection": {},
                      "note": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "count",
                      "collection",
                      "note"
                    ],
                    "additionalProperties": false
                  },
                  "capacity_allocations": {
                    "type": "object",
                    "properties": {
                      "count": {
                        "type": "integer"
                      },
                      "collection": {},
                      "note": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "count",
                      "collection",
                      "note"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "occurrences",
                  "capacity_allocations"
                ],
                "additionalProperties": false
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "product_id",
              "code",
              "label",
              "description",
              "status",
              "sales_opens_at",
              "sales_closes_at",
              "minimum_per_order",
              "maximum_per_order",
              "seats_per_ticket",
              "assignment_policy",
              "assignment_deadline_at",
              "sort_order",
              "eligibility_rules",
              "portal_settings",
              "relationships",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event ticket option response projection."
      },
      "EventPaymentPlanPolicyPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "ticket_option_id": {
                  "type": "string"
                },
                "code": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "customer_selectable": {
                  "type": "boolean"
                },
                "deposit_mode": {
                  "type": "string"
                },
                "deposit_value": {
                  "type": "integer"
                },
                "remaining_installment_count": {
                  "type": "integer"
                },
                "interval_unit": {
                  "type": "string"
                },
                "interval_count": {
                  "type": "integer"
                },
                "first_installment_delay_days": {
                  "type": "integer"
                },
                "final_due_days_before_start": {
                  "type": "integer"
                },
                "grace_period_days": {
                  "type": "integer"
                },
                "capacity_policy": {
                  "type": "string"
                },
                "admission_policy": {
                  "type": "string"
                },
                "delinquency_policy": {
                  "type": "string"
                },
                "auto_collect_allowed": {
                  "type": "boolean"
                },
                "sort_order": {
                  "type": "integer"
                },
                "metadata": {
                  "type": "object",
                  "properties": {
                    "audience": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "audience"
                  ],
                  "additionalProperties": false
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "ticket_option_id",
                "code",
                "name",
                "description",
                "status",
                "customer_selectable",
                "deposit_mode",
                "deposit_value",
                "remaining_installment_count",
                "interval_unit",
                "interval_count",
                "first_installment_delay_days",
                "final_due_days_before_start",
                "grace_period_days",
                "capacity_policy",
                "admission_policy",
                "delinquency_policy",
                "auto_collect_allowed",
                "sort_order",
                "metadata",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event payment-plan policies response projection."
      },
      "EventPaymentPlanPolicyEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "ticket_option_id": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "customer_selectable": {
                "type": "boolean"
              },
              "deposit_mode": {
                "type": "string"
              },
              "deposit_value": {
                "type": "integer"
              },
              "remaining_installment_count": {
                "type": "integer"
              },
              "interval_unit": {
                "type": "string"
              },
              "interval_count": {
                "type": "integer"
              },
              "first_installment_delay_days": {
                "type": "integer"
              },
              "final_due_days_before_start": {
                "type": "integer"
              },
              "grace_period_days": {
                "type": "integer"
              },
              "capacity_policy": {
                "type": "string"
              },
              "admission_policy": {
                "type": "string"
              },
              "delinquency_policy": {
                "type": "string"
              },
              "auto_collect_allowed": {
                "type": "boolean"
              },
              "sort_order": {
                "type": "integer"
              },
              "metadata": {
                "type": "object",
                "properties": {
                  "audience": {
                    "type": "string"
                  }
                },
                "required": [
                  "audience"
                ],
                "additionalProperties": false
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "ticket_option_id",
              "code",
              "name",
              "description",
              "status",
              "customer_selectable",
              "deposit_mode",
              "deposit_value",
              "remaining_installment_count",
              "interval_unit",
              "interval_count",
              "first_installment_delay_days",
              "final_due_days_before_start",
              "grace_period_days",
              "capacity_policy",
              "admission_policy",
              "delinquency_policy",
              "auto_collect_allowed",
              "sort_order",
              "metadata",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event payment-plan policy response projection."
      },
      "EventParticipantPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "customer_id": {},
                "participant_type": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "first_name": {
                  "type": "string"
                },
                "last_name": {
                  "type": "string"
                },
                "preferred_name": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {
                  "type": "string"
                },
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                },
                "sensitive_fields_omitted": {
                  "type": "boolean"
                }
              },
              "required": [
                "id",
                "object",
                "customer_id",
                "participant_type",
                "status",
                "first_name",
                "last_name",
                "preferred_name",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at",
                "sensitive_fields_omitted"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event participants response projection."
      },
      "EventParticipantEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "customer_id": {},
              "participant_type": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "first_name": {
                "type": "string"
              },
              "last_name": {
                "type": "string"
              },
              "preferred_name": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {
                "type": "string"
              },
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "sensitive_fields_omitted": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "object",
              "customer_id",
              "participant_type",
              "status",
              "first_name",
              "last_name",
              "preferred_name",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at",
              "sensitive_fields_omitted"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event participant response projection."
      },
      "EventParticipantGuardianPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "object": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "guardian_customer_id": {
                  "type": "string"
                },
                "relationship_label": {
                  "type": "string"
                },
                "is_primary": {
                  "type": "boolean"
                },
                "portal_visible": {
                  "type": "boolean"
                },
                "portal_authorized": {
                  "type": "boolean"
                },
                "can_manage_registration": {
                  "type": "boolean"
                },
                "can_receive_notifications": {
                  "type": "boolean"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "object",
                "participant_id",
                "guardian_customer_id",
                "relationship_label",
                "is_primary",
                "portal_visible",
                "portal_authorized",
                "can_manage_registration",
                "can_receive_notifications",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list participant guardians response projection."
      },
      "EventParticipantGuardianEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "guardian_customer_id": {
                "type": "string"
              },
              "relationship_label": {
                "type": "string"
              },
              "is_primary": {
                "type": "boolean"
              },
              "portal_visible": {
                "type": "boolean"
              },
              "portal_authorized": {
                "type": "boolean"
              },
              "can_manage_registration": {
                "type": "boolean"
              },
              "can_receive_notifications": {
                "type": "boolean"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "object",
              "participant_id",
              "guardian_customer_id",
              "relationship_label",
              "is_primary",
              "portal_visible",
              "portal_authorized",
              "can_manage_registration",
              "can_receive_notifications",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted link a participant guardian response projection."
      },
      "EventRegistrationFormPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "form_key": {
                  "type": "string"
                },
                "version_number": {
                  "type": "integer"
                },
                "name": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "completion_scope": {
                  "type": "string"
                },
                "instructions_html": {
                  "type": "string"
                },
                "settings": {
                  "type": "object",
                  "properties": {
                    "show_progress": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "show_progress"
                  ],
                  "additionalProperties": false
                },
                "content_hash": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "form_key",
                "version_number",
                "name",
                "status",
                "completion_scope",
                "instructions_html",
                "settings",
                "content_hash",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event registration forms response projection."
      },
      "EventRegistrationFormEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "form_key": {
                "type": "string"
              },
              "version_number": {
                "type": "integer"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "completion_scope": {
                "type": "string"
              },
              "instructions_html": {
                "type": "string"
              },
              "settings": {
                "type": "object",
                "properties": {
                  "show_progress": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "show_progress"
                ],
                "additionalProperties": false
              },
              "content_hash": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "form_key",
              "version_number",
              "name",
              "status",
              "completion_scope",
              "instructions_html",
              "settings",
              "content_hash",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event registration form response projection."
      },
      "EventRegistrationQuestionPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "form_id": {
                  "type": "string"
                },
                "question_key": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "help_text": {
                  "type": "string"
                },
                "response_scope": {
                  "type": "string"
                },
                "field_type": {
                  "type": "string"
                },
                "options": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "value": {
                        "type": "string"
                      },
                      "label": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "value",
                      "label"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": {
                  "type": "boolean"
                },
                "conditional_logic": {
                  "type": "object",
                  "properties": {},
                  "required": [],
                  "additionalProperties": false
                },
                "privacy_class": {
                  "type": "string"
                },
                "retention_days": {
                  "type": "integer"
                },
                "report_key": {
                  "type": "string"
                },
                "sort_order": {
                  "type": "integer"
                },
                "status": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "form_id",
                "question_key",
                "label",
                "help_text",
                "response_scope",
                "field_type",
                "options",
                "required",
                "conditional_logic",
                "privacy_class",
                "retention_days",
                "report_key",
                "sort_order",
                "status",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event registration questions response projection."
      },
      "EventRegistrationQuestionEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "form_id": {
                "type": "string"
              },
              "question_key": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "help_text": {
                "type": "string"
              },
              "response_scope": {
                "type": "string"
              },
              "field_type": {
                "type": "string"
              },
              "options": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "value",
                    "label"
                  ],
                  "additionalProperties": false
                }
              },
              "required": {
                "type": "boolean"
              },
              "conditional_logic": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              },
              "privacy_class": {
                "type": "string"
              },
              "retention_days": {
                "type": "integer"
              },
              "report_key": {
                "type": "string"
              },
              "sort_order": {
                "type": "integer"
              },
              "status": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "form_id",
              "question_key",
              "label",
              "help_text",
              "response_scope",
              "field_type",
              "options",
              "required",
              "conditional_logic",
              "privacy_class",
              "retention_days",
              "report_key",
              "sort_order",
              "status",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event registration question response projection."
      },
      "EventFormAssignmentPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "ticket_option_id": {
                  "type": "string"
                },
                "form_id": {
                  "type": "string"
                },
                "stage": {
                  "type": "string"
                },
                "required": {
                  "type": "boolean"
                },
                "sort_order": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "ticket_option_id",
                "form_id",
                "stage",
                "required",
                "sort_order",
                "created_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event form assignments response projection."
      },
      "EventFormAssignmentEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "ticket_option_id": {
                "type": "string"
              },
              "form_id": {
                "type": "string"
              },
              "stage": {
                "type": "string"
              },
              "required": {
                "type": "boolean"
              },
              "sort_order": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "ticket_option_id",
              "form_id",
              "stage",
              "required",
              "sort_order",
              "created_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted assign a registration form response projection."
      },
      "EventWaiverPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "waiver_key": {
                  "type": "string"
                },
                "version_number": {
                  "type": "integer"
                },
                "title": {
                  "type": "string"
                },
                "content_html": {
                  "type": "string"
                },
                "content_hash": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "required": {
                  "type": "boolean"
                },
                "effective_at": {
                  "type": "string"
                },
                "expires_at": {},
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "created_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "waiver_key",
                "version_number",
                "title",
                "content_html",
                "content_hash",
                "status",
                "required",
                "effective_at",
                "expires_at",
                "source_system",
                "external_id",
                "created_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event waivers response projection."
      },
      "EventWaiverEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "waiver_key": {
                "type": "string"
              },
              "version_number": {
                "type": "integer"
              },
              "title": {
                "type": "string"
              },
              "content_html": {
                "type": "string"
              },
              "content_hash": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "required": {
                "type": "boolean"
              },
              "effective_at": {
                "type": "string"
              },
              "expires_at": {},
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "created_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "waiver_key",
              "version_number",
              "title",
              "content_html",
              "content_hash",
              "status",
              "required",
              "effective_at",
              "expires_at",
              "source_system",
              "external_id",
              "created_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event waiver response projection."
      },
      "EventWaiverAssignmentPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "ticket_option_id": {
                  "type": "string"
                },
                "waiver_id": {
                  "type": "string"
                },
                "required": {
                  "type": "boolean"
                },
                "sort_order": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "ticket_option_id",
                "waiver_id",
                "required",
                "sort_order",
                "created_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event waiver assignments response projection."
      },
      "EventWaiverAssignmentEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "ticket_option_id": {
                "type": "string"
              },
              "waiver_id": {
                "type": "string"
              },
              "required": {
                "type": "boolean"
              },
              "sort_order": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "ticket_option_id",
              "waiver_id",
              "required",
              "sort_order",
              "created_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted assign an event waiver response projection."
      },
      "EventRegistrationPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "ticket_option_id": {
                  "type": "string"
                },
                "primary_participant_id": {
                  "type": "string"
                },
                "purchaser_customer_id": {
                  "type": "string"
                },
                "sale_id": {
                  "type": "string"
                },
                "sale_line_item_id": {
                  "type": "string"
                },
                "registration_number": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "seat_count": {
                  "type": "integer"
                },
                "amount_total": {
                  "type": "integer"
                },
                "currency": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "registered_at": {
                  "type": "string"
                },
                "confirmed_at": {
                  "type": "string"
                },
                "cancelled_at": {},
                "capacity_hold_expires_at": {},
                "cancellation_reason": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "ticket_option_id",
                "primary_participant_id",
                "purchaser_customer_id",
                "sale_id",
                "sale_line_item_id",
                "registration_number",
                "status",
                "seat_count",
                "amount_total",
                "currency",
                "source_system",
                "external_id",
                "registered_at",
                "confirmed_at",
                "cancelled_at",
                "capacity_hold_expires_at",
                "cancellation_reason",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event registrations response projection."
      },
      "EventRegistrationEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "ticket_option_id": {
                "type": "string"
              },
              "primary_participant_id": {
                "type": "string"
              },
              "purchaser_customer_id": {
                "type": "string"
              },
              "sale_id": {
                "type": "string"
              },
              "sale_line_item_id": {
                "type": "string"
              },
              "registration_number": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "seat_count": {
                "type": "integer"
              },
              "amount_total": {
                "type": "integer"
              },
              "currency": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "registered_at": {
                "type": "string"
              },
              "confirmed_at": {},
              "cancelled_at": {},
              "capacity_hold_expires_at": {},
              "cancellation_reason": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "ticket_option_id",
              "primary_participant_id",
              "purchaser_customer_id",
              "sale_id",
              "sale_line_item_id",
              "registration_number",
              "status",
              "seat_count",
              "amount_total",
              "currency",
              "source_system",
              "external_id",
              "registered_at",
              "confirmed_at",
              "cancelled_at",
              "capacity_hold_expires_at",
              "cancellation_reason",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event registration response projection."
      },
      "EventRegistrationSeatAssignmentEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string"
              },
              "registration": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "object": {
                    "type": "string"
                  },
                  "offering_id": {
                    "type": "string"
                  },
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "primary_participant_id": {
                    "type": "string"
                  },
                  "purchaser_customer_id": {
                    "type": "string"
                  },
                  "sale_id": {
                    "type": "string"
                  },
                  "sale_line_item_id": {
                    "type": "string"
                  },
                  "registration_number": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "seat_count": {
                    "type": "integer"
                  },
                  "amount_total": {
                    "type": "integer"
                  },
                  "currency": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {},
                  "registered_at": {
                    "type": "string"
                  },
                  "confirmed_at": {
                    "type": "string"
                  },
                  "cancelled_at": {},
                  "capacity_hold_expires_at": {},
                  "cancellation_reason": {},
                  "version": {
                    "type": "integer"
                  },
                  "created_at": {
                    "type": "string"
                  },
                  "updated_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "object",
                  "offering_id",
                  "ticket_option_id",
                  "primary_participant_id",
                  "purchaser_customer_id",
                  "sale_id",
                  "sale_line_item_id",
                  "registration_number",
                  "status",
                  "seat_count",
                  "amount_total",
                  "currency",
                  "source_system",
                  "external_id",
                  "registered_at",
                  "confirmed_at",
                  "cancelled_at",
                  "capacity_hold_expires_at",
                  "cancellation_reason",
                  "version",
                  "created_at",
                  "updated_at"
                ],
                "additionalProperties": false
              },
              "participant": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "object": {
                    "type": "string"
                  },
                  "customer_id": {},
                  "participant_type": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "first_name": {
                    "type": "string"
                  },
                  "last_name": {
                    "type": "string"
                  },
                  "preferred_name": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {
                    "type": "string"
                  },
                  "version": {
                    "type": "integer"
                  },
                  "created_at": {
                    "type": "string"
                  },
                  "updated_at": {
                    "type": "string"
                  },
                  "sensitive_fields_omitted": {
                    "type": "boolean"
                  },
                  "relationships": {
                    "type": "object",
                    "properties": {
                      "guardians": {
                        "type": "object",
                        "properties": {
                          "count": {
                            "type": "integer"
                          },
                          "collection": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "count",
                          "collection"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "guardians"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "id",
                  "object",
                  "customer_id",
                  "participant_type",
                  "status",
                  "first_name",
                  "last_name",
                  "preferred_name",
                  "source_system",
                  "external_id",
                  "version",
                  "created_at",
                  "updated_at",
                  "sensitive_fields_omitted",
                  "relationships"
                ],
                "additionalProperties": false
              },
              "ticket": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "object": {
                    "type": "string"
                  },
                  "registration_id": {
                    "type": "string"
                  },
                  "participant_id": {
                    "type": "string"
                  },
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "sequence_number": {
                    "type": "integer"
                  },
                  "seat_quantity": {
                    "type": "integer"
                  },
                  "status": {
                    "type": "string"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {},
                  "issued_at": {
                    "type": "string"
                  },
                  "expires_at": {
                    "type": "string"
                  },
                  "voided_at": {},
                  "version": {
                    "type": "integer"
                  },
                  "created_at": {
                    "type": "string"
                  },
                  "updated_at": {
                    "type": "string"
                  },
                  "credential_fields_omitted": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "id",
                  "object",
                  "registration_id",
                  "participant_id",
                  "ticket_option_id",
                  "sequence_number",
                  "seat_quantity",
                  "status",
                  "source_system",
                  "external_id",
                  "issued_at",
                  "expires_at",
                  "voided_at",
                  "version",
                  "created_at",
                  "updated_at",
                  "credential_fields_omitted"
                ],
                "additionalProperties": false
              },
              "guardian_required": {
                "type": "boolean"
              },
              "lifecycle_result": {
                "type": "string"
              }
            },
            "required": [
              "object",
              "registration",
              "participant",
              "ticket",
              "guardian_required",
              "lifecycle_result"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted assign one deferred registration seat response projection."
      },
      "EventRegistrationPaymentPlanPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "registration_id": {
                  "type": "string"
                },
                "plan_id": {
                  "type": "string"
                },
                "policy_id": {
                  "type": "string"
                },
                "sale_id": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "deposit_amount_cents": {
                  "type": "integer"
                },
                "scheduled_balance_cents": {
                  "type": "integer"
                },
                "next_due_on": {
                  "type": "string"
                },
                "delinquent_since": {},
                "completed_at": {},
                "canceled_at": {},
                "cancellation_reason": {},
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "registration_id",
                "plan_id",
                "policy_id",
                "sale_id",
                "status",
                "deposit_amount_cents",
                "scheduled_balance_cents",
                "next_due_on",
                "delinquent_since",
                "completed_at",
                "canceled_at",
                "cancellation_reason",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event registration payment plans response projection."
      },
      "EventReceiptPaymentPlanEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string"
              },
              "plan_id": {
                "type": "string",
                "format": "uuid"
              },
              "sale_id": {
                "type": "string",
                "format": "uuid"
              },
              "invoice_id": {
                "type": "string",
                "format": "uuid"
              },
              "status": {
                "type": "string"
              },
              "receipt_status": {
                "type": "string"
              },
              "installment_count": {
                "type": "integer",
                "minimum": 0
              },
              "balance_cents": {
                "type": "integer",
                "minimum": 0
              },
              "registration_payment_plan_count": {
                "type": "integer",
                "minimum": 0
              },
              "registration_payment_plans_truncated": {
                "type": "boolean"
              },
              "registration_payment_plans": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "registration_id": {
                      "type": "string"
                    },
                    "plan_id": {
                      "type": "string"
                    },
                    "policy_id": {
                      "type": "string"
                    },
                    "sale_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "deposit_amount_cents": {
                      "type": "integer"
                    },
                    "scheduled_balance_cents": {
                      "type": "integer"
                    },
                    "next_due_on": {
                      "type": "string"
                    },
                    "delinquent_since": {},
                    "completed_at": {},
                    "canceled_at": {},
                    "source_system": {
                      "type": "string"
                    },
                    "external_id": {},
                    "version": {
                      "type": "integer"
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "updated_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "object",
                    "registration_id",
                    "plan_id",
                    "policy_id",
                    "sale_id",
                    "status",
                    "deposit_amount_cents",
                    "scheduled_balance_cents",
                    "next_due_on",
                    "delinquent_since",
                    "completed_at",
                    "canceled_at",
                    "source_system",
                    "external_id",
                    "version",
                    "created_at",
                    "updated_at"
                  ],
                  "additionalProperties": false
                }
              },
              "lifecycle_result": {
                "type": "string"
              }
            },
            "required": [
              "object",
              "plan_id",
              "sale_id",
              "invoice_id",
              "status",
              "receipt_status",
              "installment_count",
              "balance_cents",
              "registration_payment_plan_count",
              "registration_payment_plans_truncated",
              "registration_payment_plans",
              "lifecycle_result"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event receipt payment plan response projection."
      },
      "EventRegistrationPaymentPlanEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "plan_id": {
                "type": "string"
              },
              "policy_id": {
                "type": "string"
              },
              "sale_id": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "deposit_amount_cents": {
                "type": "integer"
              },
              "scheduled_balance_cents": {
                "type": "integer"
              },
              "next_due_on": {
                "type": "string"
              },
              "delinquent_since": {},
              "completed_at": {},
              "canceled_at": {},
              "cancellation_reason": {},
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "billing_plan": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "object": {
                    "type": "string"
                  },
                  "invoice_sale_id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "currency_code": {
                    "type": "string"
                  },
                  "starts_on": {
                    "type": "string"
                  },
                  "ends_on": {
                    "type": "string"
                  },
                  "max_occurrences": {
                    "type": "integer"
                  },
                  "completed_occurrences": {
                    "type": "integer"
                  },
                  "next_action_on": {
                    "type": "string"
                  },
                  "auto_collect": {
                    "type": "boolean"
                  },
                  "created_at": {
                    "type": "string"
                  },
                  "updated_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "object",
                  "invoice_sale_id",
                  "name",
                  "status",
                  "currency_code",
                  "starts_on",
                  "ends_on",
                  "max_occurrences",
                  "completed_occurrences",
                  "next_action_on",
                  "auto_collect",
                  "created_at",
                  "updated_at"
                ],
                "additionalProperties": false
              },
              "policy": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "object": {
                    "type": "string"
                  },
                  "offering_id": {
                    "type": "string"
                  },
                  "ticket_option_id": {
                    "type": "string"
                  },
                  "code": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "customer_selectable": {
                    "type": "boolean"
                  },
                  "deposit_mode": {
                    "type": "string"
                  },
                  "deposit_value": {
                    "type": "integer"
                  },
                  "remaining_installment_count": {
                    "type": "integer"
                  },
                  "interval_unit": {
                    "type": "string"
                  },
                  "interval_count": {
                    "type": "integer"
                  },
                  "first_installment_delay_days": {
                    "type": "integer"
                  },
                  "final_due_days_before_start": {
                    "type": "integer"
                  },
                  "grace_period_days": {
                    "type": "integer"
                  },
                  "capacity_policy": {
                    "type": "string"
                  },
                  "admission_policy": {
                    "type": "string"
                  },
                  "delinquency_policy": {
                    "type": "string"
                  },
                  "auto_collect_allowed": {
                    "type": "boolean"
                  },
                  "sort_order": {
                    "type": "integer"
                  },
                  "source_system": {
                    "type": "string"
                  },
                  "external_id": {},
                  "version": {
                    "type": "integer"
                  },
                  "created_at": {
                    "type": "string"
                  },
                  "updated_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "object",
                  "offering_id",
                  "ticket_option_id",
                  "code",
                  "name",
                  "description",
                  "status",
                  "customer_selectable",
                  "deposit_mode",
                  "deposit_value",
                  "remaining_installment_count",
                  "interval_unit",
                  "interval_count",
                  "first_installment_delay_days",
                  "final_due_days_before_start",
                  "grace_period_days",
                  "capacity_policy",
                  "admission_policy",
                  "delinquency_policy",
                  "auto_collect_allowed",
                  "sort_order",
                  "source_system",
                  "external_id",
                  "version",
                  "created_at",
                  "updated_at"
                ],
                "additionalProperties": false
              },
              "installments": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "sequence_no": {
                      "type": "integer"
                    },
                    "due_on": {
                      "type": "string"
                    },
                    "amount_cents": {
                      "type": "integer"
                    },
                    "applied_amount_cents": {
                      "type": "integer"
                    },
                    "grace_expires_on": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "paid_at": {},
                    "created_at": {
                      "type": "string"
                    },
                    "updated_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "object",
                    "sequence_no",
                    "due_on",
                    "amount_cents",
                    "applied_amount_cents",
                    "grace_expires_on",
                    "status",
                    "paid_at",
                    "created_at",
                    "updated_at"
                  ],
                  "additionalProperties": false
                }
              },
              "totals": {
                "type": "object",
                "properties": {
                  "scheduled_amount_cents": {
                    "type": "integer"
                  },
                  "applied_amount_cents": {
                    "type": "integer"
                  },
                  "outstanding_amount_cents": {
                    "type": "integer"
                  }
                },
                "required": [
                  "scheduled_amount_cents",
                  "applied_amount_cents",
                  "outstanding_amount_cents"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "id",
              "object",
              "registration_id",
              "plan_id",
              "policy_id",
              "sale_id",
              "status",
              "deposit_amount_cents",
              "scheduled_balance_cents",
              "next_due_on",
              "delinquent_since",
              "completed_at",
              "canceled_at",
              "cancellation_reason",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at",
              "billing_plan",
              "policy",
              "installments",
              "totals"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get an event registration payment plan response projection."
      },
      "EventRegistrationPaymentPlanLifecycleEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "plan_id": {
                "type": "string"
              },
              "policy_id": {
                "type": "string"
              },
              "sale_id": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "deposit_amount_cents": {
                "type": "integer"
              },
              "scheduled_balance_cents": {
                "type": "integer"
              },
              "next_due_on": {
                "type": "string"
              },
              "delinquent_since": {},
              "completed_at": {},
              "canceled_at": {},
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "requested_status": {
                "type": "string"
              },
              "prior_status": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Authoritative state before the command; null when a replay has no new transition to report."
              },
              "lifecycle_result": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "registration_id",
              "plan_id",
              "policy_id",
              "sale_id",
              "status",
              "deposit_amount_cents",
              "scheduled_balance_cents",
              "next_due_on",
              "delinquent_since",
              "completed_at",
              "canceled_at",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at",
              "requested_status",
              "prior_status",
              "lifecycle_result"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted pause an event receipt payment plan response projection."
      },
      "EventRegistrationPaymentPlanCustomerLinkEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "plan_id": {
                "type": "string"
              },
              "policy_id": {
                "type": "string"
              },
              "sale_id": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "deposit_amount_cents": {
                "type": "integer"
              },
              "scheduled_balance_cents": {
                "type": "integer"
              },
              "next_due_on": {
                "type": "string"
              },
              "delinquent_since": {},
              "completed_at": {},
              "canceled_at": {},
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "customer_payment_link": {
                "type": "object",
                "properties": {
                  "installment_id": {
                    "type": "string",
                    "format": "uuid"
                  },
                  "payment_url": {
                    "type": "string",
                    "format": "uri",
                    "description": "Tenant-bound HTTPS pos.getcentri.com receipt capability. Treat it as a secret and deliver it only through an authorized channel."
                  },
                  "suggested_amount_cents": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Receipt-page prefill only; it is not a charge or a forced payment amount."
                  },
                  "expires_at": {
                    "type": "string",
                    "format": "date-time",
                    "description": "Canonical expiry returned by the server, including when an existing live capability is reused."
                  },
                  "link_reused": {
                    "type": "boolean"
                  },
                  "delivery_status": {
                    "type": "string",
                    "enum": [
                      "ready_for_delivery"
                    ],
                    "description": "The caller may deliver the capability; this response does not itself send a message."
                  }
                },
                "required": [
                  "installment_id",
                  "payment_url",
                  "suggested_amount_cents",
                  "expires_at",
                  "link_reused",
                  "delivery_status"
                ],
                "additionalProperties": false
              },
              "lifecycle_result": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "registration_id",
              "plan_id",
              "policy_id",
              "sale_id",
              "status",
              "deposit_amount_cents",
              "scheduled_balance_cents",
              "next_due_on",
              "delinquent_since",
              "completed_at",
              "canceled_at",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at",
              "customer_payment_link",
              "lifecycle_result"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event receipt customer payment link response projection."
      },
      "EventRegistrationPaymentPlanAdmissionReinstatementEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "plan_id": {
                "type": "string"
              },
              "policy_id": {
                "type": "string"
              },
              "sale_id": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "deposit_amount_cents": {
                "type": "integer"
              },
              "scheduled_balance_cents": {
                "type": "integer"
              },
              "next_due_on": {
                "type": "string"
              },
              "delinquent_since": {},
              "completed_at": {},
              "canceled_at": {},
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "admission_reinstatement": {
                "type": "object",
                "properties": {
                  "lifecycle_result": {
                    "type": "string"
                  },
                  "registrations_reinstated": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0,
                    "description": "Safe count returned for a changed command; null on an idempotent replay that performed no new work."
                  },
                  "occurrence_enrollments_reinstated": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0,
                    "description": "Safe count returned for a changed command; null on an idempotent replay that performed no new work."
                  },
                  "seats_reinstated": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0,
                    "description": "Safe count returned for a changed command; null on an idempotent replay that performed no new work."
                  },
                  "tickets_issued": {
                    "type": [
                      "integer",
                      "null"
                    ],
                    "minimum": 0,
                    "description": "Safe count returned for a changed command; null on an idempotent replay that performed no new work."
                  }
                },
                "required": [
                  "lifecycle_result",
                  "registrations_reinstated",
                  "occurrence_enrollments_reinstated",
                  "seats_reinstated",
                  "tickets_issued"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "id",
              "object",
              "registration_id",
              "plan_id",
              "policy_id",
              "sale_id",
              "status",
              "deposit_amount_cents",
              "scheduled_balance_cents",
              "next_due_on",
              "delinquent_since",
              "completed_at",
              "canceled_at",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at",
              "admission_reinstatement"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted reinstate admission for a paid event receipt plan response projection."
      },
      "EventRegistrationParticipantPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "object": {
                  "type": "string"
                },
                "registration_id": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "role": {
                  "type": "string"
                },
                "seat_quantity": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "participant": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "customer_id": {},
                    "participant_type": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "first_name": {
                      "type": "string"
                    },
                    "last_name": {
                      "type": "string"
                    },
                    "preferred_name": {
                      "type": "string"
                    },
                    "source_system": {
                      "type": "string"
                    },
                    "external_id": {
                      "type": "string"
                    },
                    "version": {
                      "type": "integer"
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "updated_at": {
                      "type": "string"
                    },
                    "sensitive_fields_omitted": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "id",
                    "object",
                    "customer_id",
                    "participant_type",
                    "status",
                    "first_name",
                    "last_name",
                    "preferred_name",
                    "source_system",
                    "external_id",
                    "version",
                    "created_at",
                    "updated_at",
                    "sensitive_fields_omitted"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "object",
                "registration_id",
                "participant_id",
                "role",
                "seat_quantity",
                "created_at",
                "participant"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list registration participants response projection."
      },
      "EventRegistrationParticipantEnvelope": {
        "type": "object",
        "properties": {
          "error": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "details": {
                "type": "array",
                "items": {}
              }
            },
            "required": [
              "code",
              "message",
              "request_id",
              "details"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "error"
        ],
        "additionalProperties": false,
        "description": "Whitelisted link a registration participant response projection."
      },
      "EventParticipantAddonPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "registration_id": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "sale_line_item_id": {
                  "type": "string"
                },
                "product_id": {
                  "type": "string"
                },
                "variant_id": {
                  "type": "string"
                },
                "quantity": {
                  "type": "integer"
                },
                "returned_quantity": {
                  "type": "integer"
                },
                "currency": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "fulfilled_at": {},
                "returned_at": {},
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                },
                "reporting_fields_omitted": {
                  "type": "boolean"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "registration_id",
                "participant_id",
                "sale_line_item_id",
                "product_id",
                "variant_id",
                "quantity",
                "returned_quantity",
                "currency",
                "status",
                "fulfilled_at",
                "returned_at",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at",
                "reporting_fields_omitted"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list participant add-ons response projection."
      },
      "EventParticipantAddonEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "sale_line_item_id": {
                "type": "string"
              },
              "product_id": {
                "type": "string"
              },
              "variant_id": {
                "type": "string"
              },
              "quantity": {
                "type": "integer"
              },
              "returned_quantity": {
                "type": "integer"
              },
              "currency": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "fulfilled_at": {},
              "returned_at": {},
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "reporting_fields_omitted": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "registration_id",
              "participant_id",
              "sale_line_item_id",
              "product_id",
              "variant_id",
              "quantity",
              "returned_quantity",
              "currency",
              "status",
              "fulfilled_at",
              "returned_at",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at",
              "reporting_fields_omitted"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create a participant add-on assignment response projection."
      },
      "EventOccurrenceEnrollmentPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "occurrence_instance_id": {
                  "type": "string"
                },
                "registration_id": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "seat_quantity": {
                  "type": "integer"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {
                  "type": "string"
                },
                "selected_at": {
                  "type": "string"
                },
                "waitlisted_at": {},
                "cancelled_at": {},
                "attended_at": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "occurrence_id",
                "occurrence_instance_id",
                "registration_id",
                "participant_id",
                "status",
                "seat_quantity",
                "source_system",
                "external_id",
                "selected_at",
                "waitlisted_at",
                "cancelled_at",
                "attended_at",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list occurrence enrollments response projection."
      },
      "EventOccurrenceEnrollmentEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "occurrence_id": {
                "type": "string"
              },
              "occurrence_instance_id": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "seat_quantity": {
                "type": "integer"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {
                "type": "string"
              },
              "selected_at": {
                "type": "string"
              },
              "waitlisted_at": {},
              "cancelled_at": {},
              "attended_at": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "occurrence_id",
              "occurrence_instance_id",
              "registration_id",
              "participant_id",
              "status",
              "seat_quantity",
              "source_system",
              "external_id",
              "selected_at",
              "waitlisted_at",
              "cancelled_at",
              "attended_at",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted select an event occurrence response projection."
      },
      "EventRegistrationAnswerPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "registration_id": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "form_id": {
                  "type": "string"
                },
                "question_id": {
                  "type": "string"
                },
                "question_key": {
                  "type": "string"
                },
                "question_label_snapshot": {
                  "type": "string"
                },
                "answer": {
                  "type": "string"
                },
                "is_sensitive": {
                  "type": "boolean"
                },
                "source_system": {
                  "type": "string"
                },
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "registration_id",
                "participant_id",
                "form_id",
                "question_id",
                "question_key",
                "question_label_snapshot",
                "answer",
                "is_sensitive",
                "source_system",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              },
              "sensitive_answers_omitted": {
                "type": "boolean"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit",
              "sensitive_answers_omitted"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list registration answers response projection."
      },
      "EventRegistrationAnswerEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "form_id": {
                "type": "string"
              },
              "question_id": {
                "type": "string"
              },
              "question_key": {
                "type": "string"
              },
              "question_label_snapshot": {
                "type": "string"
              },
              "answer": {
                "type": "string"
              },
              "is_sensitive": {
                "type": "boolean"
              },
              "source_system": {
                "type": "string"
              },
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "registration_id",
              "participant_id",
              "form_id",
              "question_id",
              "question_key",
              "question_label_snapshot",
              "answer",
              "is_sensitive",
              "source_system",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create or replace a registration answer response projection."
      },
      "EventRegistrationFormCompletionPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "registration_id": {
                  "type": "string"
                },
                "assignment_id": {
                  "type": "string"
                },
                "form_id": {
                  "type": "string"
                },
                "is_complete": {
                  "type": "boolean"
                },
                "completion_revision": {
                  "type": "integer"
                },
                "completed_at": {
                  "type": "string"
                },
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "registration_id",
                "assignment_id",
                "form_id",
                "is_complete",
                "completion_revision",
                "completed_at",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list registration form completions response projection."
      },
      "EventRegistrationFormCompletionEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "assignment_id": {
                "type": "string"
              },
              "form_id": {
                "type": "string"
              },
              "is_complete": {
                "type": "boolean"
              },
              "completion_revision": {
                "type": "integer"
              },
              "completed_at": {
                "type": "string"
              },
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "registration_id",
              "assignment_id",
              "form_id",
              "is_complete",
              "completion_revision",
              "completed_at",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get a registration form completion response projection."
      },
      "EventTicketPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "registration_id": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "ticket_option_id": {
                  "type": "string"
                },
                "sequence_number": {
                  "type": "integer"
                },
                "seat_quantity": {
                  "type": "integer"
                },
                "status": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "issued_at": {
                  "type": "string"
                },
                "expires_at": {
                  "type": "string"
                },
                "voided_at": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                },
                "credential_fields_omitted": {
                  "type": "boolean"
                }
              },
              "required": [
                "id",
                "object",
                "registration_id",
                "participant_id",
                "ticket_option_id",
                "sequence_number",
                "seat_quantity",
                "status",
                "source_system",
                "external_id",
                "issued_at",
                "expires_at",
                "voided_at",
                "version",
                "created_at",
                "updated_at",
                "credential_fields_omitted"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event tickets response projection."
      },
      "EventTicketEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "ticket_option_id": {
                "type": "string"
              },
              "sequence_number": {
                "type": "integer"
              },
              "seat_quantity": {
                "type": "integer"
              },
              "status": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "issued_at": {
                "type": "string"
              },
              "expires_at": {
                "type": "string"
              },
              "voided_at": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "credential_fields_omitted": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "object",
              "registration_id",
              "participant_id",
              "ticket_option_id",
              "sequence_number",
              "seat_quantity",
              "status",
              "source_system",
              "external_id",
              "issued_at",
              "expires_at",
              "voided_at",
              "version",
              "created_at",
              "updated_at",
              "credential_fields_omitted"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted issue an event ticket response projection."
      },
      "EventTicketCredentialEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "ticket_option_id": {
                "type": "string"
              },
              "sequence_number": {
                "type": "integer"
              },
              "seat_quantity": {
                "type": "integer"
              },
              "status": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "issued_at": {
                "type": "string"
              },
              "expires_at": {
                "type": "string"
              },
              "voided_at": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "ticket_code": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "registration_id",
              "participant_id",
              "ticket_option_id",
              "sequence_number",
              "seat_quantity",
              "status",
              "source_system",
              "external_id",
              "issued_at",
              "expires_at",
              "voided_at",
              "version",
              "created_at",
              "updated_at",
              "ticket_code"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get an event ticket credential response projection."
      },
      "EventWaiverAcceptancePage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "registration_id": {
                  "type": "string"
                },
                "waiver_id": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "signer_customer_id": {
                  "type": "string"
                },
                "guardian_customer_id": {
                  "type": "string"
                },
                "signer_name": {
                  "type": "string"
                },
                "consented_at": {
                  "type": "string"
                },
                "content_hash": {
                  "type": "string"
                },
                "ip_hash": {
                  "type": "string"
                },
                "user_agent": {
                  "type": "string"
                },
                "signature_reference": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {
                  "type": "string"
                },
                "created_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "registration_id",
                "waiver_id",
                "participant_id",
                "signer_customer_id",
                "guardian_customer_id",
                "signer_name",
                "consented_at",
                "content_hash",
                "ip_hash",
                "user_agent",
                "signature_reference",
                "source_system",
                "external_id",
                "created_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list waiver acceptances response projection."
      },
      "EventWaiverAcceptanceEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "waiver_id": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "consented_at": {
                "type": "string"
              },
              "content_hash": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {
                "type": "string"
              },
              "created_at": {
                "type": "string"
              },
              "sensitive_fields_omitted": {
                "type": "boolean"
              }
            },
            "required": [
              "id",
              "object",
              "registration_id",
              "waiver_id",
              "participant_id",
              "consented_at",
              "content_hash",
              "source_system",
              "external_id",
              "created_at",
              "sensitive_fields_omitted"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted record a waiver acceptance response projection."
      },
      "EventCheckinPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "occurrence_instance_id": {
                  "type": "string"
                },
                "registration_id": {
                  "type": "string"
                },
                "ticket_id": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "direction": {
                  "type": "string"
                },
                "result": {
                  "type": "string"
                },
                "admitted_seat_quantity": {
                  "type": "integer"
                },
                "method": {
                  "type": "string"
                },
                "denial_reason": {},
                "checked_in_at": {
                  "type": "string"
                },
                "actor_profile_id": {},
                "device_id": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {
                  "type": "string"
                },
                "metadata": {
                  "type": "object",
                  "properties": {},
                  "required": [],
                  "additionalProperties": false
                },
                "created_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "occurrence_id",
                "occurrence_instance_id",
                "registration_id",
                "ticket_id",
                "participant_id",
                "direction",
                "result",
                "admitted_seat_quantity",
                "method",
                "denial_reason",
                "checked_in_at",
                "actor_profile_id",
                "device_id",
                "source_system",
                "external_id",
                "metadata",
                "created_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event check-ins response projection."
      },
      "EventCheckinEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "occurrence_id": {
                "type": "string"
              },
              "occurrence_instance_id": {
                "type": "string"
              },
              "registration_id": {
                "type": "string"
              },
              "ticket_id": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "direction": {
                "type": "string"
              },
              "result": {
                "type": "string"
              },
              "admitted_seat_quantity": {
                "type": "integer"
              },
              "method": {
                "type": "string"
              },
              "denial_reason": {},
              "checked_in_at": {
                "type": "string"
              },
              "actor_profile_id": {},
              "device_id": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {
                "type": "string"
              },
              "metadata": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              },
              "created_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "occurrence_id",
              "occurrence_instance_id",
              "registration_id",
              "ticket_id",
              "participant_id",
              "direction",
              "result",
              "admitted_seat_quantity",
              "method",
              "denial_reason",
              "checked_in_at",
              "actor_profile_id",
              "device_id",
              "source_system",
              "external_id",
              "metadata",
              "created_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted record event attendance response projection."
      },
      "EventCheckinBatchEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string"
              },
              "submitted": {
                "type": "integer"
              },
              "synchronized": {
                "type": "integer"
              },
              "results": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "client_scan_id": {
                      "type": "string"
                    },
                    "synchronized": {
                      "type": "boolean"
                    },
                    "checkin": {
                      "type": "object",
                      "properties": {
                        "object": {
                          "type": "string"
                        },
                        "id": {
                          "type": "string"
                        },
                        "offering_id": {
                          "type": "string"
                        },
                        "occurrence_id": {
                          "type": "string"
                        },
                        "occurrence_instance_id": {
                          "type": "string"
                        },
                        "registration_id": {
                          "type": "string"
                        },
                        "ticket_id": {
                          "type": "string"
                        },
                        "participant_id": {
                          "type": "string"
                        },
                        "direction": {
                          "type": "string"
                        },
                        "result": {
                          "type": "string"
                        },
                        "admitted_seat_quantity": {
                          "type": "integer"
                        },
                        "checked_in_at": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "object",
                        "id",
                        "offering_id",
                        "occurrence_id",
                        "occurrence_instance_id",
                        "registration_id",
                        "ticket_id",
                        "participant_id",
                        "direction",
                        "result",
                        "admitted_seat_quantity",
                        "checked_in_at"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "client_scan_id",
                    "synchronized",
                    "checkin"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "object",
              "submitted",
              "synchronized",
              "results"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted synchronize an offline check-in batch response projection."
      },
      "EventWaitlistPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "ticket_option_id": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "purchaser_customer_id": {
                  "type": "string"
                },
                "requested_seats": {
                  "type": "integer"
                },
                "status": {
                  "type": "string"
                },
                "priority": {
                  "type": "integer"
                },
                "position": {
                  "type": "integer"
                },
                "offered_at": {
                  "type": "string"
                },
                "offer_expires_at": {
                  "type": "string"
                },
                "accepted_registration_id": {},
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "occurrence_id",
                "ticket_option_id",
                "participant_id",
                "purchaser_customer_id",
                "requested_seats",
                "status",
                "priority",
                "position",
                "offered_at",
                "offer_expires_at",
                "accepted_registration_id",
                "source_system",
                "external_id",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event waitlist entries response projection."
      },
      "EventWaitlistEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "occurrence_id": {
                "type": "string"
              },
              "ticket_option_id": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "purchaser_customer_id": {
                "type": "string"
              },
              "requested_seats": {
                "type": "integer"
              },
              "status": {
                "type": "string"
              },
              "priority": {
                "type": "integer"
              },
              "position": {
                "type": "integer"
              },
              "offered_at": {
                "type": "string"
              },
              "offer_expires_at": {
                "type": "string"
              },
              "accepted_registration_id": {},
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "occurrence_id",
              "ticket_option_id",
              "participant_id",
              "purchaser_customer_id",
              "requested_seats",
              "status",
              "priority",
              "position",
              "offered_at",
              "offer_expires_at",
              "accepted_registration_id",
              "source_system",
              "external_id",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event waitlist entry response projection."
      },
      "EventAssetPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_id": {},
                "asset_type": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "alt_text": {},
                "url": {
                  "type": "string"
                },
                "mime_type": {
                  "type": "string"
                },
                "byte_size": {
                  "type": "integer"
                },
                "visibility": {
                  "type": "string"
                },
                "is_public": {
                  "type": "boolean"
                },
                "sort_order": {
                  "type": "integer"
                },
                "metadata": {
                  "type": "object",
                  "properties": {},
                  "required": [],
                  "additionalProperties": false
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "offering_id",
                "occurrence_id",
                "asset_type",
                "title",
                "alt_text",
                "url",
                "mime_type",
                "byte_size",
                "visibility",
                "is_public",
                "sort_order",
                "metadata",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event assets response projection."
      },
      "EventAssetEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "occurrence_id": {},
              "asset_type": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "alt_text": {},
              "url": {
                "type": "string"
              },
              "mime_type": {
                "type": "string"
              },
              "byte_size": {
                "type": "integer"
              },
              "visibility": {
                "type": "string"
              },
              "is_public": {
                "type": "boolean"
              },
              "sort_order": {
                "type": "integer"
              },
              "metadata": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "offering_id",
              "occurrence_id",
              "asset_type",
              "title",
              "alt_text",
              "url",
              "mime_type",
              "byte_size",
              "visibility",
              "is_public",
              "sort_order",
              "metadata",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event asset response projection."
      },
      "EventPublicationFeedPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "slug": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "visibility": {
                  "type": "string"
                },
                "theme": {
                  "type": "object",
                  "properties": {
                    "primary_color": {
                      "type": "string"
                    },
                    "accent_color": {
                      "type": "string"
                    },
                    "card_style": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "primary_color",
                    "accent_color",
                    "card_style"
                  ],
                  "additionalProperties": false
                },
                "filters": {
                  "type": "object",
                  "properties": {
                    "event_kinds": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  },
                  "required": [
                    "event_kinds"
                  ],
                  "additionalProperties": false
                },
                "seo": {
                  "type": "object",
                  "properties": {
                    "title": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "title",
                    "description"
                  ],
                  "additionalProperties": false
                },
                "embed_settings": {
                  "type": "object",
                  "properties": {
                    "layout": {
                      "type": "string"
                    },
                    "show_filters": {
                      "type": "boolean"
                    },
                    "show_calendar_action": {
                      "type": "boolean"
                    }
                  },
                  "required": [
                    "layout",
                    "show_filters",
                    "show_calendar_action"
                  ],
                  "additionalProperties": false
                },
                "custom_domain": {},
                "published_at": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "slug",
                "name",
                "status",
                "visibility",
                "theme",
                "filters",
                "seo",
                "embed_settings",
                "custom_domain",
                "published_at",
                "source_system",
                "external_id",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list event publication feeds response projection."
      },
      "EventPublicationFeedEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "visibility": {
                "type": "string"
              },
              "theme": {
                "type": "object",
                "properties": {
                  "primary_color": {
                    "type": "string"
                  },
                  "accent_color": {
                    "type": "string"
                  },
                  "card_style": {
                    "type": "string"
                  }
                },
                "required": [
                  "primary_color",
                  "accent_color",
                  "card_style"
                ],
                "additionalProperties": false
              },
              "filters": {
                "type": "object",
                "properties": {
                  "event_kinds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "event_kinds"
                ],
                "additionalProperties": false
              },
              "seo": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  }
                },
                "required": [
                  "title",
                  "description"
                ],
                "additionalProperties": false
              },
              "embed_settings": {
                "type": "object",
                "properties": {
                  "layout": {
                    "type": "string"
                  },
                  "show_filters": {
                    "type": "boolean"
                  },
                  "show_calendar_action": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "layout",
                  "show_filters",
                  "show_calendar_action"
                ],
                "additionalProperties": false
              },
              "custom_domain": {},
              "published_at": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "slug",
              "name",
              "status",
              "visibility",
              "theme",
              "filters",
              "seo",
              "embed_settings",
              "custom_domain",
              "published_at",
              "source_system",
              "external_id",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create an event publication feed response projection."
      },
      "EventPublicationFeedOfferingPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "object": {
                  "type": "string"
                },
                "feed_id": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "sort_order": {
                  "type": "integer"
                },
                "is_featured": {
                  "type": "boolean"
                },
                "created_at": {
                  "type": "string"
                }
              },
              "required": [
                "object",
                "feed_id",
                "offering_id",
                "sort_order",
                "is_featured",
                "created_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list publication-feed offerings response projection."
      },
      "EventPublicationFeedOfferingEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "object": {
                "type": "string"
              },
              "feed_id": {
                "type": "string"
              },
              "offering_id": {
                "type": "string"
              },
              "sort_order": {
                "type": "integer"
              },
              "is_featured": {
                "type": "boolean"
              },
              "created_at": {
                "type": "string"
              }
            },
            "required": [
              "object",
              "feed_id",
              "offering_id",
              "sort_order",
              "is_featured",
              "created_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted add a publication-feed offering response projection."
      },
      "CalendarEntryPage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "source_type": {
                  "type": "string"
                },
                "source_id": {
                  "type": "string"
                },
                "calendar_type": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "all_day": {
                  "type": "boolean"
                },
                "status": {
                  "type": "string"
                },
                "visibility": {
                  "type": "string"
                },
                "location_details": {
                  "type": "object",
                  "properties": {
                    "venue_name": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "venue_name",
                    "city",
                    "region"
                  ],
                  "additionalProperties": false
                },
                "recurrence_rule": {
                  "type": "string"
                },
                "organizer_name": {
                  "type": "string"
                },
                "organizer_email": {
                  "type": "string"
                },
                "ical_uid": {
                  "type": "string"
                },
                "source_system": {
                  "type": "string"
                },
                "external_id": {},
                "external_calendar_id": {},
                "external_event_id": {},
                "sync_status": {
                  "type": "string"
                },
                "sync_error": {},
                "last_synced_at": {},
                "metadata": {
                  "type": "object",
                  "properties": {},
                  "required": [],
                  "additionalProperties": false
                },
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "source_type",
                "source_id",
                "calendar_type",
                "title",
                "description",
                "starts_at",
                "ends_at",
                "timezone",
                "all_day",
                "status",
                "visibility",
                "location_details",
                "recurrence_rule",
                "organizer_name",
                "organizer_email",
                "ical_uid",
                "source_system",
                "external_id",
                "external_calendar_id",
                "external_event_id",
                "sync_status",
                "sync_error",
                "last_synced_at",
                "metadata",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list calendar entries response projection."
      },
      "CalendarEntryEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "source_type": {
                "type": "string"
              },
              "source_id": {},
              "calendar_type": {
                "type": "string"
              },
              "title": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "starts_at": {
                "type": "string"
              },
              "ends_at": {
                "type": "string"
              },
              "timezone": {
                "type": "string"
              },
              "all_day": {
                "type": "boolean"
              },
              "status": {
                "type": "string"
              },
              "visibility": {
                "type": "string"
              },
              "location_details": {
                "type": "object",
                "properties": {
                  "venue_name": {
                    "type": "string"
                  },
                  "city": {
                    "type": "string"
                  },
                  "region": {
                    "type": "string"
                  }
                },
                "required": [
                  "venue_name",
                  "city",
                  "region"
                ],
                "additionalProperties": false
              },
              "recurrence_rule": {
                "type": "string"
              },
              "organizer_name": {
                "type": "string"
              },
              "organizer_email": {
                "type": "string"
              },
              "ical_uid": {
                "type": "string"
              },
              "source_system": {
                "type": "string"
              },
              "external_id": {},
              "external_calendar_id": {},
              "external_event_id": {},
              "sync_status": {
                "type": "string"
              },
              "sync_error": {},
              "last_synced_at": {},
              "metadata": {
                "type": "object",
                "properties": {},
                "required": [],
                "additionalProperties": false
              },
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "source_type",
              "source_id",
              "calendar_type",
              "title",
              "description",
              "starts_at",
              "ends_at",
              "timezone",
              "all_day",
              "status",
              "visibility",
              "location_details",
              "recurrence_rule",
              "organizer_name",
              "organizer_email",
              "ical_uid",
              "source_system",
              "external_id",
              "external_calendar_id",
              "external_event_id",
              "sync_status",
              "sync_error",
              "last_synced_at",
              "metadata",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create a calendar entry response projection."
      },
      "CalendarEntryAttendeePage": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "object": {
                  "type": "string"
                },
                "calendar_entry_id": {
                  "type": "string"
                },
                "source_type": {
                  "type": "string"
                },
                "source_id": {},
                "customer_id": {
                  "type": "string"
                },
                "participant_id": {
                  "type": "string"
                },
                "email": {},
                "display_name": {
                  "type": "string"
                },
                "attendee_role": {
                  "type": "string"
                },
                "response_status": {
                  "type": "string"
                },
                "notify": {
                  "type": "boolean"
                },
                "version": {
                  "type": "integer"
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "object",
                "calendar_entry_id",
                "source_type",
                "source_id",
                "customer_id",
                "participant_id",
                "email",
                "display_name",
                "attendee_role",
                "response_status",
                "notify",
                "version",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              },
              "next_cursor": {},
              "next_created_before": {},
              "next_created_before_id": {},
              "has_more": {
                "type": "boolean"
              },
              "limit": {
                "type": "integer"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result",
              "next_cursor",
              "next_created_before",
              "next_created_before_id",
              "has_more",
              "limit"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list calendar entry attendees response projection."
      },
      "CalendarEntryAttendeeEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "calendar_entry_id": {
                "type": "string"
              },
              "source_type": {
                "type": "string"
              },
              "source_id": {},
              "customer_id": {
                "type": "string"
              },
              "participant_id": {
                "type": "string"
              },
              "email": {},
              "display_name": {
                "type": "string"
              },
              "attendee_role": {
                "type": "string"
              },
              "response_status": {
                "type": "string"
              },
              "notify": {
                "type": "boolean"
              },
              "version": {
                "type": "integer"
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "object",
              "calendar_entry_id",
              "source_type",
              "source_id",
              "customer_id",
              "participant_id",
              "email",
              "display_name",
              "attendee_role",
              "response_status",
              "notify",
              "version",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "idempotency_result": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "request_id",
              "environment",
              "idempotency_result"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted add a calendar entry attendee response projection."
      },
      "PublicEventFeed": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "feed": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "tenant_id": {
                "type": "string"
              },
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "visibility": {
                "type": "string"
              },
              "theme": {
                "type": "object",
                "properties": {
                  "primary_color": {
                    "type": "string"
                  },
                  "accent_color": {
                    "type": "string"
                  },
                  "card_style": {
                    "type": "string"
                  },
                  "hero_image_url": {},
                  "logo_url": {}
                },
                "required": [
                  "primary_color",
                  "accent_color",
                  "card_style",
                  "hero_image_url",
                  "logo_url"
                ],
                "additionalProperties": false
              },
              "filters": {
                "type": "object",
                "properties": {
                  "event_kinds": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                },
                "required": [
                  "event_kinds"
                ],
                "additionalProperties": false
              },
              "seo": {
                "type": "object",
                "properties": {
                  "title": {
                    "type": "string"
                  },
                  "description": {
                    "type": "string"
                  }
                },
                "required": [
                  "title",
                  "description"
                ],
                "additionalProperties": false
              },
              "embed_settings": {
                "type": "object",
                "properties": {
                  "layout": {
                    "type": "string"
                  },
                  "show_filters": {
                    "type": "boolean"
                  },
                  "show_calendar_action": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "layout",
                  "show_filters",
                  "show_calendar_action"
                ],
                "additionalProperties": false
              },
              "custom_domain": {},
              "published_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "tenant_id",
              "slug",
              "name",
              "status",
              "visibility",
              "theme",
              "filters",
              "seo",
              "embed_settings",
              "custom_domain",
              "published_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "offerings": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "slug": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "short_description": {
                  "type": "string"
                },
                "description_html": {
                  "type": "string"
                },
                "event_kind": {
                  "type": "string"
                },
                "delivery_format": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "visibility": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "venue_id": {
                  "type": "string"
                },
                "venue_name": {
                  "type": "string"
                },
                "location_details": {
                  "type": "object",
                  "properties": {
                    "address": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "postal_code": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "address",
                    "city",
                    "region",
                    "postal_code"
                  ],
                  "additionalProperties": false
                },
                "venue": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "timezone": {
                      "type": "string"
                    },
                    "address": {
                      "type": "object",
                      "properties": {
                        "address_line_1": {
                          "type": "string"
                        },
                        "address_line_2": {},
                        "locality": {
                          "type": "string"
                        },
                        "administrative_area": {
                          "type": "string"
                        },
                        "postal_code": {
                          "type": "string"
                        },
                        "country_code": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "address_line_1",
                        "address_line_2",
                        "locality",
                        "administrative_area",
                        "postal_code",
                        "country_code"
                      ],
                      "additionalProperties": false
                    },
                    "latitude": {
                      "type": "number"
                    },
                    "longitude": {
                      "type": "number"
                    },
                    "map_url": {
                      "type": "string"
                    },
                    "website_url": {
                      "type": "string"
                    },
                    "public_phone": {
                      "type": "string"
                    },
                    "public_email": {
                      "type": "string"
                    },
                    "arrival_instructions": {
                      "type": "string"
                    },
                    "accessibility_summary": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "timezone",
                    "address",
                    "latitude",
                    "longitude",
                    "map_url",
                    "website_url",
                    "public_phone",
                    "public_email",
                    "arrival_instructions",
                    "accessibility_summary"
                  ],
                  "additionalProperties": false
                },
                "support_email": {
                  "type": "string"
                },
                "support_phone": {
                  "type": "string"
                },
                "registration_opens_at": {
                  "type": "string"
                },
                "registration_closes_at": {
                  "type": "string"
                },
                "minimum_age_months": {
                  "type": "integer"
                },
                "maximum_age_months": {
                  "type": "integer"
                },
                "primary_image_url": {
                  "type": "string"
                },
                "image_alt_text": {
                  "type": "string"
                },
                "theme": {
                  "type": "object",
                  "properties": {
                    "primary_color": {
                      "type": "string"
                    },
                    "accent_color": {
                      "type": "string"
                    },
                    "card_style": {
                      "type": "string"
                    },
                    "hero_image_url": {},
                    "logo_url": {}
                  },
                  "required": [
                    "primary_color",
                    "accent_color",
                    "card_style",
                    "hero_image_url",
                    "logo_url"
                  ],
                  "additionalProperties": false
                },
                "published_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                },
                "is_featured": {
                  "type": "boolean"
                }
              },
              "required": [
                "id",
                "slug",
                "name",
                "short_description",
                "description_html",
                "event_kind",
                "delivery_format",
                "status",
                "visibility",
                "timezone",
                "venue_id",
                "venue_name",
                "location_details",
                "venue",
                "support_email",
                "support_phone",
                "registration_opens_at",
                "registration_closes_at",
                "minimum_age_months",
                "maximum_age_months",
                "primary_image_url",
                "image_alt_text",
                "theme",
                "published_at",
                "updated_at",
                "is_featured"
              ],
              "additionalProperties": false
            }
          },
          "occurrences": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_key": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "session_kind": {
                  "type": "string"
                },
                "enrollment_policy": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "all_day": {
                  "type": "boolean"
                },
                "recurrence_rule": {
                  "type": "string"
                },
                "venue_id": {
                  "type": "string"
                },
                "venue_name": {
                  "type": "string"
                },
                "location_details": {
                  "type": "object",
                  "properties": {
                    "address": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "postal_code": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "address",
                    "city",
                    "region",
                    "postal_code"
                  ],
                  "additionalProperties": false
                },
                "venue": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "timezone": {
                      "type": "string"
                    },
                    "address": {
                      "type": "object",
                      "properties": {
                        "address_line_1": {
                          "type": "string"
                        },
                        "address_line_2": {},
                        "locality": {
                          "type": "string"
                        },
                        "administrative_area": {
                          "type": "string"
                        },
                        "postal_code": {
                          "type": "string"
                        },
                        "country_code": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "address_line_1",
                        "address_line_2",
                        "locality",
                        "administrative_area",
                        "postal_code",
                        "country_code"
                      ],
                      "additionalProperties": false
                    },
                    "latitude": {
                      "type": "number"
                    },
                    "longitude": {
                      "type": "number"
                    },
                    "map_url": {
                      "type": "string"
                    },
                    "website_url": {
                      "type": "string"
                    },
                    "public_phone": {
                      "type": "string"
                    },
                    "public_email": {
                      "type": "string"
                    },
                    "arrival_instructions": {
                      "type": "string"
                    },
                    "accessibility_summary": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "timezone",
                    "address",
                    "latitude",
                    "longitude",
                    "map_url",
                    "website_url",
                    "public_phone",
                    "public_email",
                    "arrival_instructions",
                    "accessibility_summary"
                  ],
                  "additionalProperties": false
                },
                "version": {
                  "type": "integer"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "offering_id",
                "occurrence_key",
                "name",
                "session_kind",
                "enrollment_policy",
                "status",
                "starts_at",
                "ends_at",
                "timezone",
                "all_day",
                "recurrence_rule",
                "venue_id",
                "venue_name",
                "location_details",
                "venue",
                "version",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "exceptions": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "original_start_at": {
                  "type": "string"
                },
                "exception_type": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "reason": {
                  "type": "string"
                },
                "override_fields": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "type": "string"
                    },
                    "venue_name": {
                      "type": "string"
                    },
                    "location_details": {
                      "type": "object",
                      "properties": {
                        "city": {
                          "type": "string"
                        },
                        "region": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "city",
                        "region"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "name",
                    "venue_name",
                    "location_details"
                  ],
                  "additionalProperties": false
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "occurrence_id",
                "original_start_at",
                "exception_type",
                "starts_at",
                "ends_at",
                "reason",
                "override_fields",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "tickets": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "code": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "description": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "sales_opens_at": {
                  "type": "string"
                },
                "sales_closes_at": {
                  "type": "string"
                },
                "minimum_per_order": {
                  "type": "integer"
                },
                "maximum_per_order": {
                  "type": "integer"
                },
                "seats_per_ticket": {
                  "type": "integer"
                },
                "assignment_policy": {
                  "type": "string"
                },
                "assignment_deadline_at": {},
                "sort_order": {
                  "type": "integer"
                },
                "checkout_status": {
                  "type": "string"
                },
                "purchase_url": {
                  "type": "string"
                },
                "registration_url": {
                  "type": "string"
                },
                "price_amount": {
                  "type": "integer"
                },
                "currency": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "offering_id",
                "code",
                "label",
                "description",
                "status",
                "sales_opens_at",
                "sales_closes_at",
                "minimum_per_order",
                "maximum_per_order",
                "seats_per_ticket",
                "assignment_policy",
                "assignment_deadline_at",
                "sort_order",
                "checkout_status",
                "purchase_url",
                "registration_url",
                "price_amount",
                "currency"
              ],
              "additionalProperties": false
            }
          },
          "assets": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_id": {},
                "asset_type": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "alt_text": {},
                "url": {
                  "type": "string"
                },
                "mime_type": {
                  "type": "string"
                },
                "byte_size": {
                  "type": "integer"
                },
                "is_public": {
                  "type": "boolean"
                },
                "sort_order": {
                  "type": "integer"
                }
              },
              "required": [
                "id",
                "offering_id",
                "occurrence_id",
                "asset_type",
                "title",
                "alt_text",
                "url",
                "mime_type",
                "byte_size",
                "is_public",
                "sort_order"
              ],
              "additionalProperties": false
            }
          },
          "occurrences_truncated": {
            "type": "boolean"
          },
          "occurrences_next_cursor": {},
          "occurrences_window": {
            "type": "object",
            "properties": {
              "start": {
                "type": "string"
              },
              "end": {
                "type": "string"
              }
            },
            "required": [
              "start",
              "end"
            ],
            "additionalProperties": false
          },
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string"
              },
              "feed": {
                "type": "string"
              },
              "calendar": {
                "type": "string"
              },
              "calendar_subscription": {
                "type": "string"
              },
              "occurrences": {
                "type": "string"
              },
              "embed": {
                "type": "string"
              }
            },
            "required": [
              "self",
              "feed",
              "calendar",
              "calendar_subscription",
              "occurrences",
              "embed"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "feed",
          "offerings",
          "occurrences",
          "exceptions",
          "tickets",
          "assets",
          "occurrences_truncated",
          "occurrences_next_cursor",
          "occurrences_window",
          "links"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get a public event feed response projection."
      },
      "PublicEventOccurrencePage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "offering_id": {
                  "type": "string"
                },
                "occurrence_key": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "session_kind": {
                  "type": "string"
                },
                "enrollment_policy": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "all_day": {
                  "type": "boolean"
                },
                "recurrence_rule": {
                  "type": "string"
                },
                "venue_id": {
                  "type": "string"
                },
                "venue_name": {
                  "type": "string"
                },
                "location_details": {
                  "type": "object",
                  "properties": {
                    "address": {
                      "type": "string"
                    },
                    "city": {
                      "type": "string"
                    },
                    "region": {
                      "type": "string"
                    },
                    "postal_code": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "address",
                    "city",
                    "region",
                    "postal_code"
                  ],
                  "additionalProperties": false
                },
                "venue": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "timezone": {
                      "type": "string"
                    },
                    "address": {
                      "type": "object",
                      "properties": {
                        "address_line_1": {
                          "type": "string"
                        },
                        "address_line_2": {},
                        "locality": {
                          "type": "string"
                        },
                        "administrative_area": {
                          "type": "string"
                        },
                        "postal_code": {
                          "type": "string"
                        },
                        "country_code": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "address_line_1",
                        "address_line_2",
                        "locality",
                        "administrative_area",
                        "postal_code",
                        "country_code"
                      ],
                      "additionalProperties": false
                    },
                    "latitude": {
                      "type": "number"
                    },
                    "longitude": {
                      "type": "number"
                    },
                    "map_url": {
                      "type": "string"
                    },
                    "website_url": {
                      "type": "string"
                    },
                    "public_phone": {
                      "type": "string"
                    },
                    "public_email": {
                      "type": "string"
                    },
                    "arrival_instructions": {
                      "type": "string"
                    },
                    "accessibility_summary": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "timezone",
                    "address",
                    "latitude",
                    "longitude",
                    "map_url",
                    "website_url",
                    "public_phone",
                    "public_email",
                    "arrival_instructions",
                    "accessibility_summary"
                  ],
                  "additionalProperties": false
                },
                "version": {
                  "type": "integer"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "offering_id",
                "occurrence_key",
                "name",
                "session_kind",
                "enrollment_policy",
                "status",
                "starts_at",
                "ends_at",
                "timezone",
                "all_day",
                "recurrence_rule",
                "venue_id",
                "venue_name",
                "location_details",
                "venue",
                "version",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {},
          "window": {
            "type": "object",
            "properties": {
              "start": {
                "type": "string"
              },
              "end": {
                "type": "string"
              }
            },
            "required": [
              "start",
              "end"
            ],
            "additionalProperties": false
          },
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string"
              },
              "next": {}
            },
            "required": [
              "self",
              "next"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "has_more",
          "next_cursor",
          "window",
          "links"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list public event occurrences response projection."
      },
      "PublicEventRegistrationBootstrap": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "tenant_id": {
            "type": "string"
          },
          "feed_id": {
            "type": "string"
          },
          "ticket_option_scope": {
            "type": "string"
          },
          "offering": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "timezone": {
                "type": "string"
              },
              "registration_opens_at": {
                "type": "string"
              },
              "registration_closes_at": {
                "type": "string"
              },
              "minimum_age_months": {
                "type": "integer"
              },
              "maximum_age_months": {
                "type": "integer"
              }
            },
            "required": [
              "id",
              "slug",
              "name",
              "timezone",
              "registration_opens_at",
              "registration_closes_at",
              "minimum_age_months",
              "maximum_age_months"
            ],
            "additionalProperties": false
          },
          "ticket_option": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "code": {
                "type": "string"
              },
              "label": {
                "type": "string"
              },
              "description": {
                "type": "string"
              },
              "product_id": {
                "type": "string"
              },
              "product_slug": {
                "type": "string"
              },
              "product_name": {
                "type": "string"
              },
              "sku": {
                "type": "string"
              },
              "price_amount": {
                "type": "integer"
              },
              "currency": {
                "type": "string"
              },
              "minimum_per_order": {
                "type": "integer"
              },
              "maximum_per_order": {
                "type": "integer"
              },
              "seats_per_ticket": {
                "type": "integer"
              },
              "assignment_policy": {
                "type": "string"
              },
              "assignment_deadline_at": {},
              "sales_opens_at": {
                "type": "string"
              },
              "sales_closes_at": {
                "type": "string"
              },
              "remaining_seats": {
                "type": "integer"
              },
              "maximum_purchasable_quantity": {
                "type": "integer"
              },
              "checkout_status": {
                "type": "string"
              },
              "purchase_url": {
                "type": "string"
              },
              "registration_url": {},
              "tenant_storefront_slug": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "code",
              "label",
              "description",
              "product_id",
              "product_slug",
              "product_name",
              "sku",
              "price_amount",
              "currency",
              "minimum_per_order",
              "maximum_per_order",
              "seats_per_ticket",
              "assignment_policy",
              "assignment_deadline_at",
              "sales_opens_at",
              "sales_closes_at",
              "remaining_seats",
              "maximum_purchasable_quantity",
              "checkout_status",
              "purchase_url",
              "registration_url",
              "tenant_storefront_slug"
            ],
            "additionalProperties": false
          },
          "definition_counts": {
            "type": "object",
            "properties": {
              "occurrence_entitlements": {
                "type": "integer"
              },
              "selection_groups": {
                "type": "integer"
              },
              "form_assignments": {
                "type": "integer"
              },
              "questions": {
                "type": "integer"
              },
              "waiver_assignments": {
                "type": "integer"
              },
              "addons": {
                "type": "integer"
              }
            },
            "required": [
              "occurrence_entitlements",
              "selection_groups",
              "form_assignments",
              "questions",
              "waiver_assignments",
              "addons"
            ],
            "additionalProperties": false
          },
          "definition_page": {
            "type": "object",
            "properties": {
              "resource": {
                "type": "string"
              },
              "maximum_page_size": {
                "type": "integer"
              }
            },
            "required": [
              "resource",
              "maximum_page_size"
            ],
            "additionalProperties": false
          },
          "agenda": {
            "type": "object",
            "properties": {
              "resource": {
                "type": "string"
              },
              "maximum_page_size": {
                "type": "integer"
              }
            },
            "required": [
              "resource",
              "maximum_page_size"
            ],
            "additionalProperties": false
          },
          "checkout_extensions": {
            "type": "object",
            "properties": {
              "access_code_sets": {
                "type": "array",
                "items": {}
              },
              "physical_seating": {
                "type": "object",
                "properties": {
                  "policy": {
                    "type": "string"
                  },
                  "available_seat_count": {
                    "type": "integer"
                  },
                  "config_count": {
                    "type": "integer"
                  },
                  "seat_page": {
                    "type": "object",
                    "properties": {
                      "default_page_size": {
                        "type": "integer"
                      },
                      "maximum_page_size": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "default_page_size",
                      "maximum_page_size"
                    ],
                    "additionalProperties": false
                  },
                  "configs": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "occurrence_id": {
                          "type": "string"
                        },
                        "occurrence_instance_id": {
                          "type": "string"
                        },
                        "occurrence": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "starts_at": {
                              "type": "string"
                            },
                            "ends_at": {
                              "type": "string"
                            },
                            "timezone": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "name",
                            "starts_at",
                            "ends_at",
                            "timezone"
                          ],
                          "additionalProperties": false
                        },
                        "selection_mode": {
                          "type": "string"
                        },
                        "hold_duration_seconds": {
                          "type": "integer"
                        },
                        "allow_accessible_companion_override": {
                          "type": "boolean"
                        },
                        "sales_closes_at": {
                          "type": "string"
                        },
                        "layout": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "canvas_width": {
                              "type": "integer"
                            },
                            "canvas_height": {
                              "type": "integer"
                            },
                            "background_asset_url": {}
                          },
                          "required": [
                            "id",
                            "name",
                            "canvas_width",
                            "canvas_height",
                            "background_asset_url"
                          ],
                          "additionalProperties": false
                        },
                        "venue": {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string"
                            },
                            "name": {
                              "type": "string"
                            },
                            "timezone": {
                              "type": "string"
                            },
                            "address": {
                              "type": "object",
                              "properties": {
                                "address_line_1": {
                                  "type": "string"
                                },
                                "locality": {
                                  "type": "string"
                                },
                                "administrative_area": {
                                  "type": "string"
                                },
                                "postal_code": {
                                  "type": "string"
                                },
                                "country_code": {
                                  "type": "string"
                                },
                                "latitude": {
                                  "type": "number"
                                },
                                "longitude": {
                                  "type": "number"
                                }
                              },
                              "required": [
                                "address_line_1",
                                "locality",
                                "administrative_area",
                                "postal_code",
                                "country_code",
                                "latitude",
                                "longitude"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "id",
                            "name",
                            "timezone",
                            "address"
                          ],
                          "additionalProperties": false
                        },
                        "available_seat_count": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "id",
                        "occurrence_id",
                        "occurrence_instance_id",
                        "occurrence",
                        "selection_mode",
                        "hold_duration_seconds",
                        "allow_accessible_companion_override",
                        "sales_closes_at",
                        "layout",
                        "venue",
                        "available_seat_count"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "policy",
                  "available_seat_count",
                  "config_count",
                  "seat_page",
                  "configs"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "access_code_sets",
              "physical_seating"
            ],
            "additionalProperties": false
          },
          "purchaser_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "participant_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "guardian_fields": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string"
              },
              "offering": {
                "type": "string"
              },
              "registration_definition": {
                "type": "string"
              },
              "agenda": {
                "type": "string"
              },
              "registration_seats": {
                "type": "string"
              }
            },
            "required": [
              "self",
              "offering",
              "registration_definition",
              "agenda",
              "registration_seats"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "tenant_id",
          "feed_id",
          "ticket_option_scope",
          "offering",
          "ticket_option",
          "definition_counts",
          "definition_page",
          "agenda",
          "checkout_extensions",
          "purchaser_fields",
          "participant_fields",
          "guardian_fields",
          "links"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get public event registration bootstrap response projection."
      },
      "PublicEventRegistrationDefinitionPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "resource": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "occurrence_key": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "session_kind": {
                  "type": "string"
                },
                "enrollment_policy": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "recurrence_rule": {
                  "type": "string"
                },
                "venue_name": {
                  "type": "string"
                },
                "space_id": {
                  "type": "string"
                },
                "sort_order": {
                  "type": "integer"
                }
              },
              "required": [
                "id",
                "occurrence_key",
                "name",
                "session_kind",
                "enrollment_policy",
                "starts_at",
                "ends_at",
                "timezone",
                "recurrence_rule",
                "venue_name",
                "space_id",
                "sort_order"
              ],
              "additionalProperties": false
            }
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {},
          "page_byte_limit": {
            "type": "integer"
          },
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string"
              },
              "next": {}
            },
            "required": [
              "self",
              "next"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "resource",
          "data",
          "has_more",
          "next_cursor",
          "page_byte_limit",
          "links"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list a public registration-definition page response projection."
      },
      "PublicEventRegistrationSeatPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "seating_config_id": {
                  "type": "string"
                },
                "id": {
                  "type": "string"
                },
                "code": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "section": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "color": {
                      "type": "string"
                    },
                    "sort_order": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "color",
                    "sort_order"
                  ],
                  "additionalProperties": false
                },
                "row": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "sort_order": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "label",
                    "sort_order"
                  ],
                  "additionalProperties": false
                },
                "x": {
                  "type": "integer"
                },
                "y": {
                  "type": "integer"
                },
                "rotation_degrees": {
                  "type": "integer"
                },
                "accessibility_type": {
                  "type": "string"
                },
                "accessibility_notes": {
                  "type": "string"
                },
                "companion_group": {
                  "type": "string"
                },
                "obstructed_view": {
                  "type": "boolean"
                },
                "pricing_zone": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "color": {
                      "type": "string"
                    },
                    "sort_order": {
                      "type": "integer"
                    },
                    "price_adjustment": {
                      "type": "integer"
                    },
                    "currency": {
                      "type": "string"
                    },
                    "minimum_seats": {
                      "type": "integer"
                    },
                    "maximum_seats": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "color",
                    "sort_order",
                    "price_adjustment",
                    "currency",
                    "minimum_seats",
                    "maximum_seats"
                  ],
                  "additionalProperties": false
                }
              },
              "required": [
                "seating_config_id",
                "id",
                "code",
                "label",
                "section",
                "row",
                "x",
                "y",
                "rotation_degrees",
                "accessibility_type",
                "accessibility_notes",
                "companion_group",
                "obstructed_view",
                "pricing_zone"
              ],
              "additionalProperties": false
            }
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {},
          "page_byte_limit": {
            "type": "integer"
          },
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string"
              },
              "next": {}
            },
            "required": [
              "self",
              "next"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "has_more",
          "next_cursor",
          "page_byte_limit",
          "links"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list public registration seats response projection."
      },
      "PublicEventAgendaPage": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "items": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "instance_id": {
                  "type": "string"
                },
                "instance_key": {
                  "type": "string"
                },
                "original_start_at": {
                  "type": "string"
                },
                "starts_at": {
                  "type": "string"
                },
                "ends_at": {
                  "type": "string"
                },
                "timezone": {
                  "type": "string"
                },
                "status": {
                  "type": "string"
                },
                "occurrence_id": {
                  "type": "string"
                },
                "occurrence_key": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "session_kind": {
                  "type": "string"
                },
                "enrollment_policy": {
                  "type": "string"
                },
                "all_day": {
                  "type": "boolean"
                },
                "venue_name": {
                  "type": "string"
                },
                "space": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "code": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "venue_name": {
                      "type": "string"
                    },
                    "capacity": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "id",
                    "code",
                    "name",
                    "venue_name",
                    "capacity"
                  ],
                  "additionalProperties": false
                },
                "tracks": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "code": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "description": {
                        "type": "string"
                      },
                      "color": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "code",
                      "name",
                      "description",
                      "color"
                    ],
                    "additionalProperties": false
                  }
                },
                "selection_group_ids": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "stakeholders": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "role": {
                        "type": "string"
                      },
                      "role_label": {
                        "type": "string"
                      },
                      "person": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "display_name": {
                            "type": "string"
                          },
                          "title": {
                            "type": "string"
                          },
                          "bio_html": {
                            "type": "string"
                          },
                          "photo_url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "display_name",
                          "title",
                          "bio_html",
                          "photo_url"
                        ],
                        "additionalProperties": false
                      },
                      "organization": {}
                    },
                    "required": [
                      "role",
                      "role_label",
                      "person",
                      "organization"
                    ],
                    "additionalProperties": false
                  }
                }
              },
              "required": [
                "instance_id",
                "instance_key",
                "original_start_at",
                "starts_at",
                "ends_at",
                "timezone",
                "status",
                "occurrence_id",
                "occurrence_key",
                "name",
                "session_kind",
                "enrollment_policy",
                "all_day",
                "venue_name",
                "space",
                "tracks",
                "selection_group_ids",
                "stakeholders"
              ],
              "additionalProperties": false
            }
          },
          "has_more": {
            "type": "boolean"
          },
          "next_cursor": {},
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string"
              }
            },
            "required": [
              "self"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "items",
          "has_more",
          "next_cursor",
          "links"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get a public event agenda response projection."
      },
      "PublicEventCalendar": {
        "type": "string",
        "description": "Whitelisted download a public event calendar response projection."
      },
      "PublicEventOfferingCalendar": {
        "type": "string",
        "description": "Whitelisted download a public offering calendar response projection."
      },
      "PublicEventCalendarSubscription": {
        "type": "string",
        "description": "Whitelisted subscribe to a public event calendar response projection."
      },
      "PublicEventOfferingCalendarSubscription": {
        "type": "string",
        "description": "Whitelisted subscribe to a public offering calendar response projection."
      },
      "StorefrontEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "storefront": {
            "type": "object",
            "properties": {
              "slug": {
                "type": "string"
              },
              "name": {
                "type": "string"
              }
            },
            "required": [
              "slug",
              "name"
            ],
            "additionalProperties": false
          },
          "catalog": {
            "type": "object",
            "properties": {
              "products": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "handle": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "brand": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name"
                      ],
                      "additionalProperties": false
                    },
                    "status": {
                      "type": "string"
                    },
                    "sellable": {
                      "type": "boolean"
                    },
                    "online_backorder_policy": {
                      "type": "object",
                      "properties": {
                        "mode": {
                          "type": "string"
                        },
                        "max_backorder_quantity": {
                          "type": "integer"
                        },
                        "eta_days": {
                          "type": "integer"
                        },
                        "customer_message": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "mode",
                        "max_backorder_quantity",
                        "eta_days",
                        "customer_message"
                      ],
                      "additionalProperties": false
                    },
                    "description": {
                      "type": "string"
                    },
                    "category": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "slug": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "id",
                        "name",
                        "slug"
                      ],
                      "additionalProperties": false
                    },
                    "tags": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "slug": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "slug"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "variants": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "name": {
                            "type": "string"
                          },
                          "sku": {
                            "type": "string"
                          },
                          "barcode": {
                            "type": "string"
                          },
                          "price": {
                            "type": "object",
                            "properties": {
                              "amount": {
                                "type": "integer"
                              },
                              "currency": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "amount",
                              "currency"
                            ],
                            "additionalProperties": false
                          },
                          "options": {
                            "type": "array",
                            "items": {
                              "type": "object",
                              "properties": {
                                "name": {
                                  "type": "string"
                                },
                                "value": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "name",
                                "value"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "inventory": {
                            "type": "object",
                            "properties": {
                              "tracked": {
                                "type": "boolean"
                              },
                              "available": {
                                "type": "integer"
                              },
                              "reserved": {
                                "type": "integer"
                              },
                              "incoming": {
                                "type": "integer"
                              }
                            },
                            "required": [
                              "tracked",
                              "available",
                              "reserved",
                              "incoming"
                            ],
                            "additionalProperties": false
                          },
                          "online_backorder_policy": {
                            "type": "object",
                            "properties": {
                              "mode": {
                                "type": "string"
                              },
                              "max_backorder_quantity": {},
                              "eta_days": {},
                              "customer_message": {}
                            },
                            "required": [
                              "mode",
                              "max_backorder_quantity",
                              "eta_days",
                              "customer_message"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "id",
                          "name",
                          "sku",
                          "barcode",
                          "price",
                          "options",
                          "inventory",
                          "online_backorder_policy"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "custom_fields": {
                      "type": "object",
                      "properties": {
                        "price_area": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string"
                              },
                              "label": {
                                "type": "string"
                              },
                              "value": {
                                "type": "integer"
                              },
                              "value_type": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "key",
                              "label",
                              "value",
                              "value_type"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "description": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string"
                              },
                              "label": {
                                "type": "string"
                              },
                              "value": {
                                "type": "string"
                              },
                              "value_type": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "key",
                              "label",
                              "value",
                              "value_type"
                            ],
                            "additionalProperties": false
                          }
                        },
                        "specifications": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "key": {
                                "type": "string"
                              },
                              "label": {
                                "type": "string"
                              },
                              "value": {
                                "type": "integer"
                              },
                              "unit": {
                                "type": "string"
                              },
                              "value_type": {
                                "type": "string"
                              }
                            },
                            "required": [
                              "key",
                              "label",
                              "value",
                              "unit",
                              "value_type"
                            ],
                            "additionalProperties": false
                          }
                        }
                      },
                      "required": [
                        "price_area",
                        "description",
                        "specifications"
                      ],
                      "additionalProperties": false
                    },
                    "media": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string"
                          },
                          "type": {
                            "type": "string"
                          },
                          "role": {
                            "type": "string"
                          },
                          "alt": {
                            "type": "string"
                          },
                          "url": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "id",
                          "type",
                          "role",
                          "alt",
                          "url"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "updated_at": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "handle",
                    "name",
                    "brand",
                    "status",
                    "sellable",
                    "online_backorder_policy",
                    "description",
                    "category",
                    "tags",
                    "variants",
                    "custom_fields",
                    "media",
                    "created_at",
                    "updated_at"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "products"
            ],
            "additionalProperties": false
          },
          "links": {
            "type": "object",
            "properties": {
              "self": {
                "type": "string"
              }
            },
            "required": [
              "self"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "storefront",
          "catalog",
          "links"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get storefront feed response projection."
      },
      "StorefrontCatalogEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "handle": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "brand": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name"
                  ],
                  "additionalProperties": false
                },
                "status": {
                  "type": "string"
                },
                "sellable": {
                  "type": "boolean"
                },
                "online_backorder_policy": {
                  "type": "object",
                  "properties": {
                    "mode": {
                      "type": "string"
                    },
                    "max_backorder_quantity": {
                      "type": "integer"
                    },
                    "eta_days": {
                      "type": "integer"
                    },
                    "customer_message": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "mode",
                    "max_backorder_quantity",
                    "eta_days",
                    "customer_message"
                  ],
                  "additionalProperties": false
                },
                "description": {
                  "type": "string"
                },
                "category": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "slug": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "slug"
                  ],
                  "additionalProperties": false
                },
                "tags": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "slug": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "name",
                      "slug"
                    ],
                    "additionalProperties": false
                  }
                },
                "variants": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "sku": {
                        "type": "string"
                      },
                      "barcode": {
                        "type": "string"
                      },
                      "price": {
                        "type": "object",
                        "properties": {
                          "amount": {
                            "type": "integer"
                          },
                          "currency": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "amount",
                          "currency"
                        ],
                        "additionalProperties": false
                      },
                      "options": {
                        "type": "array",
                        "items": {
                          "type": "object",
                          "properties": {
                            "name": {
                              "type": "string"
                            },
                            "value": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "name",
                            "value"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "inventory": {
                        "type": "object",
                        "properties": {
                          "tracked": {
                            "type": "boolean"
                          },
                          "available": {
                            "type": "integer"
                          },
                          "reserved": {
                            "type": "integer"
                          },
                          "incoming": {
                            "type": "integer"
                          }
                        },
                        "required": [
                          "tracked",
                          "available",
                          "reserved",
                          "incoming"
                        ],
                        "additionalProperties": false
                      },
                      "online_backorder_policy": {
                        "type": "object",
                        "properties": {
                          "mode": {
                            "type": "string"
                          },
                          "max_backorder_quantity": {},
                          "eta_days": {},
                          "customer_message": {}
                        },
                        "required": [
                          "mode",
                          "max_backorder_quantity",
                          "eta_days",
                          "customer_message"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "id",
                      "name",
                      "sku",
                      "barcode",
                      "price",
                      "options",
                      "inventory",
                      "online_backorder_policy"
                    ],
                    "additionalProperties": false
                  }
                },
                "custom_fields": {
                  "type": "object",
                  "properties": {
                    "price_area": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "value": {
                            "type": "integer"
                          },
                          "value_type": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "key",
                          "label",
                          "value",
                          "value_type"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "description": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "value": {
                            "type": "string"
                          },
                          "value_type": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "key",
                          "label",
                          "value",
                          "value_type"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "specifications": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "key": {
                            "type": "string"
                          },
                          "label": {
                            "type": "string"
                          },
                          "value": {
                            "type": "integer"
                          },
                          "unit": {
                            "type": "string"
                          },
                          "value_type": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "key",
                          "label",
                          "value",
                          "unit",
                          "value_type"
                        ],
                        "additionalProperties": false
                      }
                    }
                  },
                  "required": [
                    "price_area",
                    "description",
                    "specifications"
                  ],
                  "additionalProperties": false
                },
                "media": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "id": {
                        "type": "string"
                      },
                      "type": {
                        "type": "string"
                      },
                      "role": {
                        "type": "string"
                      },
                      "alt": {
                        "type": "string"
                      },
                      "url": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "id",
                      "type",
                      "role",
                      "alt",
                      "url"
                    ],
                    "additionalProperties": false
                  }
                },
                "created_at": {
                  "type": "string"
                },
                "updated_at": {
                  "type": "string"
                }
              },
              "required": [
                "id",
                "handle",
                "name",
                "brand",
                "status",
                "sellable",
                "online_backorder_policy",
                "description",
                "category",
                "tags",
                "variants",
                "custom_fields",
                "media",
                "created_at",
                "updated_at"
              ],
              "additionalProperties": false
            }
          },
          "pagination": {
            "type": "object",
            "properties": {
              "page": {
                "type": "integer"
              },
              "limit": {
                "type": "integer"
              },
              "total": {
                "type": "integer"
              }
            },
            "required": [
              "page",
              "limit",
              "total"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data",
          "pagination"
        ],
        "additionalProperties": false,
        "description": "Whitelisted list published catalog response projection."
      },
      "StorefrontProductEnvelope": {
        "type": "object",
        "properties": {
          "api_version": {
            "type": "string"
          },
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "handle": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "brand": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "name"
                ],
                "additionalProperties": false
              },
              "status": {
                "type": "string"
              },
              "sellable": {
                "type": "boolean"
              },
              "online_backorder_policy": {
                "type": "object",
                "properties": {
                  "mode": {
                    "type": "string"
                  },
                  "max_backorder_quantity": {
                    "type": "integer"
                  },
                  "eta_days": {
                    "type": "integer"
                  },
                  "customer_message": {
                    "type": "string"
                  }
                },
                "required": [
                  "mode",
                  "max_backorder_quantity",
                  "eta_days",
                  "customer_message"
                ],
                "additionalProperties": false
              },
              "description": {
                "type": "string"
              },
              "category": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "name": {
                    "type": "string"
                  },
                  "slug": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "name",
                  "slug"
                ],
                "additionalProperties": false
              },
              "tags": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "slug": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "slug"
                  ],
                  "additionalProperties": false
                }
              },
              "variants": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "sku": {
                      "type": "string"
                    },
                    "barcode": {
                      "type": "string"
                    },
                    "price": {
                      "type": "object",
                      "properties": {
                        "amount": {
                          "type": "integer"
                        },
                        "currency": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "amount",
                        "currency"
                      ],
                      "additionalProperties": false
                    },
                    "options": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "type": "string"
                          },
                          "value": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "name",
                          "value"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "inventory": {
                      "type": "object",
                      "properties": {
                        "tracked": {
                          "type": "boolean"
                        },
                        "available": {
                          "type": "integer"
                        },
                        "reserved": {
                          "type": "integer"
                        },
                        "incoming": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "tracked",
                        "available",
                        "reserved",
                        "incoming"
                      ],
                      "additionalProperties": false
                    },
                    "online_backorder_policy": {
                      "type": "object",
                      "properties": {
                        "mode": {
                          "type": "string"
                        },
                        "max_backorder_quantity": {},
                        "eta_days": {},
                        "customer_message": {}
                      },
                      "required": [
                        "mode",
                        "max_backorder_quantity",
                        "eta_days",
                        "customer_message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "id",
                    "name",
                    "sku",
                    "barcode",
                    "price",
                    "options",
                    "inventory",
                    "online_backorder_policy"
                  ],
                  "additionalProperties": false
                }
              },
              "custom_fields": {
                "type": "object",
                "properties": {
                  "price_area": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "key": {
                          "type": "string"
                        },
                        "label": {
                          "type": "string"
                        },
                        "value": {
                          "type": "integer"
                        },
                        "value_type": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "key",
                        "label",
                        "value",
                        "value_type"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "description": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "key": {
                          "type": "string"
                        },
                        "label": {
                          "type": "string"
                        },
                        "value": {
                          "type": "string"
                        },
                        "value_type": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "key",
                        "label",
                        "value",
                        "value_type"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "specifications": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "key": {
                          "type": "string"
                        },
                        "label": {
                          "type": "string"
                        },
                        "value": {
                          "type": "integer"
                        },
                        "unit": {
                          "type": "string"
                        },
                        "value_type": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "key",
                        "label",
                        "value",
                        "unit",
                        "value_type"
                      ],
                      "additionalProperties": false
                    }
                  }
                },
                "required": [
                  "price_area",
                  "description",
                  "specifications"
                ],
                "additionalProperties": false
              },
              "media": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    },
                    "role": {
                      "type": "string"
                    },
                    "alt": {
                      "type": "string"
                    },
                    "url": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "id",
                    "type",
                    "role",
                    "alt",
                    "url"
                  ],
                  "additionalProperties": false
                }
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              }
            },
            "required": [
              "id",
              "handle",
              "name",
              "brand",
              "status",
              "sellable",
              "online_backorder_policy",
              "description",
              "category",
              "tags",
              "variants",
              "custom_fields",
              "media",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "api_version",
          "data"
        ],
        "additionalProperties": false,
        "description": "Whitelisted get published product response projection."
      },
      "CertifiedStorefrontResolveEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "tenant_name": {
                "type": "string"
              },
              "storefront": {
                "type": "object",
                "properties": {
                  "slug": {
                    "type": "string"
                  },
                  "store_name": {
                    "type": "string"
                  },
                  "store_description": {
                    "type": "string"
                  },
                  "primary_color": {
                    "type": "string"
                  },
                  "accent_color": {
                    "type": "string"
                  },
                  "seo_title": {
                    "type": "string"
                  },
                  "seo_description": {
                    "type": "string"
                  },
                  "logo_url": {},
                  "hero_image_url": {},
                  "custom_css": {},
                  "is_published": {
                    "type": "boolean"
                  }
                },
                "required": [
                  "slug",
                  "store_name",
                  "store_description",
                  "primary_color",
                  "accent_color",
                  "seo_title",
                  "seo_description",
                  "logo_url",
                  "hero_image_url",
                  "custom_css",
                  "is_published"
                ],
                "additionalProperties": false
              },
              "checkout": {
                "type": "object",
                "properties": {
                  "pickup_locations": {
                    "type": "array",
                    "items": {}
                  },
                  "delivery_methods": {
                    "type": "array",
                    "items": {}
                  },
                  "shipping_methods": {
                    "type": "array",
                    "items": {}
                  },
                  "gateway": {},
                  "financing": {
                    "type": "array",
                    "items": {}
                  },
                  "fulfillment_available": {
                    "type": "object",
                    "properties": {
                      "pickup": {
                        "type": "boolean"
                      },
                      "local_delivery": {
                        "type": "boolean"
                      },
                      "shipping": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "pickup",
                      "local_delivery",
                      "shipping"
                    ],
                    "additionalProperties": false
                  },
                  "shipping_schedule": {
                    "type": "object",
                    "properties": {
                      "mode": {
                        "type": "string"
                      },
                      "date_intent": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "mode",
                      "date_intent"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "pickup_locations",
                  "delivery_methods",
                  "shipping_methods",
                  "gateway",
                  "financing",
                  "fulfillment_available",
                  "shipping_schedule"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "tenant_name",
              "storefront",
              "checkout"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string",
                "const": "2026-08-31"
              },
              "environment": {
                "type": "string",
                "enum": [
                  "test",
                  "live"
                ]
              },
              "request_id": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "environment",
              "request_id"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted resolve certified storefront checkout response projection."
      },
      "CertifiedStorefrontQuoteEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "quote": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "product_id": {
                          "type": "string"
                        },
                        "variant_id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "variant_name": {
                          "type": "string"
                        },
                        "sku": {
                          "type": "string"
                        },
                        "quantity": {
                          "type": "integer"
                        },
                        "unit_price": {
                          "type": "integer"
                        },
                        "original_unit_price": {},
                        "price_source": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string"
                            }
                          },
                          "required": [
                            "type"
                          ],
                          "additionalProperties": false
                        },
                        "line_total": {
                          "type": "integer"
                        },
                        "shipping_fee": {
                          "type": "integer"
                        },
                        "fulfillment": {
                          "type": "object",
                          "properties": {
                            "packaging": {
                              "type": "string"
                            },
                            "allowed_methods": {
                              "type": "array",
                              "items": {
                                "type": "string"
                              }
                            },
                            "nationwide_shipping": {
                              "type": "object",
                              "properties": {
                                "available": {
                                  "type": "boolean"
                                },
                                "pricing_type": {
                                  "type": "string"
                                },
                                "fee": {
                                  "type": "integer"
                                },
                                "region": {
                                  "type": "string"
                                }
                              },
                              "required": [
                                "available",
                                "pricing_type",
                                "fee",
                                "region"
                              ],
                              "additionalProperties": false
                            }
                          },
                          "required": [
                            "packaging",
                            "allowed_methods",
                            "nationwide_shipping"
                          ],
                          "additionalProperties": false
                        },
                        "fulfillment_badges": {
                          "type": "array",
                          "items": {
                            "type": "string"
                          }
                        },
                        "tax_rate": {
                          "type": "number"
                        },
                        "tax_amount": {
                          "type": "number"
                        },
                        "inventory": {
                          "type": "object",
                          "properties": {
                            "state": {
                              "type": "string"
                            },
                            "reserved_quantity": {
                              "type": "integer"
                            },
                            "backorder_quantity": {
                              "type": "integer"
                            },
                            "policy": {},
                            "eta_date": {},
                            "customer_notice": {
                              "type": "boolean"
                            },
                            "customer_message": {}
                          },
                          "required": [
                            "state",
                            "reserved_quantity",
                            "backorder_quantity",
                            "policy",
                            "eta_date",
                            "customer_notice",
                            "customer_message"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "product_id",
                        "variant_id",
                        "name",
                        "variant_name",
                        "sku",
                        "quantity",
                        "unit_price",
                        "original_unit_price",
                        "price_source",
                        "line_total",
                        "shipping_fee",
                        "fulfillment",
                        "fulfillment_badges",
                        "tax_rate",
                        "tax_amount",
                        "inventory"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "fulfillment": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "shipping_method_id": {
                        "type": "string"
                      },
                      "method_name": {
                        "type": "string"
                      },
                      "date": {},
                      "time": {},
                      "shipping_address": {
                        "type": "object",
                        "properties": {
                          "address": {
                            "type": "string"
                          },
                          "city": {
                            "type": "string"
                          },
                          "state": {
                            "type": "string"
                          },
                          "zip": {
                            "type": "string"
                          }
                        },
                        "required": [
                          "address",
                          "city",
                          "state",
                          "zip"
                        ],
                        "additionalProperties": false
                      }
                    },
                    "required": [
                      "type",
                      "shipping_method_id",
                      "method_name",
                      "date",
                      "time",
                      "shipping_address"
                    ],
                    "additionalProperties": false
                  },
                  "subtotal": {
                    "type": "integer"
                  },
                  "discount_total": {
                    "type": "integer"
                  },
                  "promotions": {
                    "type": "array",
                    "items": {}
                  },
                  "promotion_code": {},
                  "shipping_total": {
                    "type": "integer"
                  },
                  "tax_total": {
                    "type": "number"
                  },
                  "total": {
                    "type": "number"
                  },
                  "inventory": {
                    "type": "object",
                    "properties": {
                      "has_backorders": {
                        "type": "boolean"
                      },
                      "backorder_quantity": {
                        "type": "integer"
                      }
                    },
                    "required": [
                      "has_backorders",
                      "backorder_quantity"
                    ],
                    "additionalProperties": false
                  },
                  "expires_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "status",
                  "items",
                  "fulfillment",
                  "subtotal",
                  "discount_total",
                  "promotions",
                  "promotion_code",
                  "shipping_total",
                  "tax_total",
                  "total",
                  "inventory",
                  "expires_at"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "quote"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string",
                "const": "2026-08-31"
              },
              "environment": {
                "type": "string",
                "enum": [
                  "test",
                  "live"
                ]
              },
              "request_id": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "environment",
              "request_id"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted create authoritative storefront quote response projection."
      },
      "CertifiedStorefrontOrderEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "object": {
                "type": "string"
              },
              "order_number": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "payment_status": {
                "type": "string",
                "enum": [
                  "pending",
                  "processing",
                  "reconciliation_required",
                  "paid"
                ],
                "description": "Authoritative payment lifecycle. reconciliation_required means a provider-approved or captured payment is durably claimed but the CentriPOS order still requires safe reconciliation."
              },
              "total": {
                "type": "number"
              },
              "fulfillment": {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string"
                  },
                  "date": {},
                  "delivery_method_id": {},
                  "pickup_location_id": {},
                  "shipping_method_id": {
                    "type": "string"
                  }
                },
                "required": [
                  "type",
                  "date",
                  "delivery_method_id",
                  "pickup_location_id",
                  "shipping_method_id"
                ],
                "additionalProperties": false
              },
              "totals": {
                "type": "object",
                "properties": {
                  "subtotal": {
                    "type": "integer"
                  },
                  "shipping": {
                    "type": "integer"
                  },
                  "tax": {
                    "type": "number"
                  },
                  "total": {
                    "type": "number"
                  }
                },
                "required": [
                  "subtotal",
                  "shipping",
                  "tax",
                  "total"
                ],
                "additionalProperties": false
              },
              "inventory": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "product_id": {
                      "type": "string"
                    },
                    "variant_id": {
                      "type": "string"
                    },
                    "state": {
                      "type": "string"
                    },
                    "reserved_quantity": {
                      "type": "integer"
                    },
                    "backorder_quantity": {
                      "type": "integer"
                    }
                  },
                  "required": [
                    "product_id",
                    "variant_id",
                    "state",
                    "reserved_quantity",
                    "backorder_quantity"
                  ],
                  "additionalProperties": false
                }
              },
              "items": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "product_id": {
                      "type": "string"
                    },
                    "variant_id": {
                      "type": "string"
                    },
                    "name": {
                      "type": "string"
                    },
                    "variant_name": {
                      "type": "string"
                    },
                    "sku": {
                      "type": "string"
                    },
                    "quantity": {
                      "type": "integer"
                    },
                    "unit_price": {
                      "type": "integer"
                    },
                    "line_total": {
                      "type": "integer"
                    },
                    "fulfillment": {
                      "type": "object",
                      "properties": {
                        "type": {
                          "type": "string"
                        },
                        "status": {
                          "type": "string"
                        },
                        "date": {},
                        "shipping_method_id": {
                          "type": "string"
                        },
                        "delivery_method_id": {},
                        "pickup_location_id": {}
                      },
                      "required": [
                        "type",
                        "status",
                        "date",
                        "shipping_method_id",
                        "delivery_method_id",
                        "pickup_location_id"
                      ],
                      "additionalProperties": false
                    },
                    "inventory_commitment": {
                      "type": "object",
                      "properties": {
                        "state": {
                          "type": "string"
                        },
                        "reserved_quantity": {
                          "type": "integer"
                        },
                        "backorder_quantity": {
                          "type": "integer"
                        },
                        "eta_date": {},
                        "customer_message": {}
                      },
                      "required": [
                        "state",
                        "reserved_quantity",
                        "backorder_quantity",
                        "eta_date",
                        "customer_message"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "id",
                    "product_id",
                    "variant_id",
                    "name",
                    "variant_name",
                    "sku",
                    "quantity",
                    "unit_price",
                    "line_total",
                    "fulfillment",
                    "inventory_commitment"
                  ],
                  "additionalProperties": false
                }
              },
              "created_at": {
                "type": "string"
              },
              "updated_at": {
                "type": "string"
              },
              "payment_configuration": {
                "type": "object",
                "properties": {
                  "card": {
                    "type": "object",
                    "properties": {
                      "provider": {
                        "type": "string",
                        "const": "centripay_gateway"
                      },
                      "is_connected": {
                        "type": "boolean",
                        "const": true
                      },
                      "tokenization_key": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 4096,
                        "description": "Browser-safe public Collect.js tokenization key resolved for the prepared sale. This is not a processor security key."
                      },
                      "three_ds_tokenization_key": {
                        "type": [
                          "string",
                          "null"
                        ],
                        "minLength": 1,
                        "maxLength": 4096,
                        "description": "Optional browser-safe public 3DS tokenization/authentication key for the prepared sale."
                      },
                      "three_ds_enabled": {
                        "type": "boolean"
                      }
                    },
                    "required": [
                      "provider",
                      "is_connected",
                      "tokenization_key",
                      "three_ds_tokenization_key",
                      "three_ds_enabled"
                    ],
                    "additionalProperties": false
                  }
                },
                "required": [
                  "card"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "id",
              "object",
              "order_number",
              "status",
              "payment_status",
              "total",
              "fulfillment",
              "totals",
              "inventory",
              "items",
              "created_at",
              "updated_at"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string",
                "const": "2026-08-31"
              },
              "environment": {
                "type": "string",
                "enum": [
                  "test",
                  "live"
                ]
              },
              "request_id": {
                "type": "string"
              },
              "replayed": {
                "type": "boolean",
                "description": "Optional operation-specific signal that card capture found and safely returned an already completed order. Gateway idempotency replay is signaled separately by Idempotency-Replayed: true."
              }
            },
            "required": [
              "api_version",
              "environment",
              "request_id"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted prepare storefront order response projection."
      },
      "CertifiedStorefrontFinancingEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "provider": {
                "type": "string"
              },
              "financing_application_id": {
                "type": "string"
              },
              "redirect_url": {
                "type": "string"
              },
              "status": {
                "type": "string"
              },
              "replayed": {
                "type": "boolean"
              },
              "order": {
                "type": "object",
                "properties": {
                  "id": {
                    "type": "string"
                  },
                  "object": {
                    "type": "string"
                  },
                  "order_number": {
                    "type": "string"
                  },
                  "status": {
                    "type": "string"
                  },
                  "payment_status": {
                    "type": "string",
                    "enum": [
                      "pending",
                      "processing",
                      "reconciliation_required",
                      "paid"
                    ],
                    "description": "Authoritative payment lifecycle. reconciliation_required means a provider-approved or captured payment is durably claimed but the CentriPOS order still requires safe reconciliation."
                  },
                  "total": {
                    "type": "number"
                  },
                  "fulfillment": {
                    "type": "object",
                    "properties": {
                      "type": {
                        "type": "string"
                      },
                      "date": {},
                      "delivery_method_id": {},
                      "pickup_location_id": {},
                      "shipping_method_id": {
                        "type": "string"
                      }
                    },
                    "required": [
                      "type",
                      "date",
                      "delivery_method_id",
                      "pickup_location_id",
                      "shipping_method_id"
                    ],
                    "additionalProperties": false
                  },
                  "totals": {
                    "type": "object",
                    "properties": {
                      "subtotal": {
                        "type": "integer"
                      },
                      "shipping": {
                        "type": "integer"
                      },
                      "tax": {
                        "type": "number"
                      },
                      "total": {
                        "type": "number"
                      }
                    },
                    "required": [
                      "subtotal",
                      "shipping",
                      "tax",
                      "total"
                    ],
                    "additionalProperties": false
                  },
                  "inventory": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "product_id": {
                          "type": "string"
                        },
                        "variant_id": {
                          "type": "string"
                        },
                        "state": {
                          "type": "string"
                        },
                        "reserved_quantity": {
                          "type": "integer"
                        },
                        "backorder_quantity": {
                          "type": "integer"
                        }
                      },
                      "required": [
                        "product_id",
                        "variant_id",
                        "state",
                        "reserved_quantity",
                        "backorder_quantity"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string"
                        },
                        "product_id": {
                          "type": "string"
                        },
                        "variant_id": {
                          "type": "string"
                        },
                        "name": {
                          "type": "string"
                        },
                        "variant_name": {
                          "type": "string"
                        },
                        "sku": {
                          "type": "string"
                        },
                        "quantity": {
                          "type": "integer"
                        },
                        "unit_price": {
                          "type": "integer"
                        },
                        "line_total": {
                          "type": "integer"
                        },
                        "fulfillment": {
                          "type": "object",
                          "properties": {
                            "type": {
                              "type": "string"
                            },
                            "status": {
                              "type": "string"
                            },
                            "date": {},
                            "shipping_method_id": {
                              "type": "string"
                            },
                            "delivery_method_id": {},
                            "pickup_location_id": {}
                          },
                          "required": [
                            "type",
                            "status",
                            "date",
                            "shipping_method_id",
                            "delivery_method_id",
                            "pickup_location_id"
                          ],
                          "additionalProperties": false
                        },
                        "inventory_commitment": {
                          "type": "object",
                          "properties": {
                            "state": {
                              "type": "string"
                            },
                            "reserved_quantity": {
                              "type": "integer"
                            },
                            "backorder_quantity": {
                              "type": "integer"
                            },
                            "eta_date": {},
                            "customer_message": {}
                          },
                          "required": [
                            "state",
                            "reserved_quantity",
                            "backorder_quantity",
                            "eta_date",
                            "customer_message"
                          ],
                          "additionalProperties": false
                        }
                      },
                      "required": [
                        "id",
                        "product_id",
                        "variant_id",
                        "name",
                        "variant_name",
                        "sku",
                        "quantity",
                        "unit_price",
                        "line_total",
                        "fulfillment",
                        "inventory_commitment"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "created_at": {
                    "type": "string"
                  },
                  "updated_at": {
                    "type": "string"
                  }
                },
                "required": [
                  "id",
                  "object",
                  "order_number",
                  "status",
                  "payment_status",
                  "total",
                  "fulfillment",
                  "totals",
                  "inventory",
                  "items",
                  "created_at",
                  "updated_at"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "provider",
              "financing_application_id",
              "redirect_url",
              "status",
              "replayed",
              "order"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string",
                "const": "2026-08-31"
              },
              "environment": {
                "type": "string",
                "enum": [
                  "test",
                  "live"
                ]
              },
              "request_id": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "environment",
              "request_id"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted initiate paytomorrow financing response projection."
      },
      "InvoiceAttachmentPacket": {
        "type": "string",
        "format": "binary",
        "description": "Whitelisted download invoice attachment packet response projection."
      },
      "CertifiedStorefrontAddressSuggestionsEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "suggestions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "place_id": {
                      "type": "string"
                    },
                    "label": {
                      "type": "string"
                    },
                    "main_text": {
                      "type": "string"
                    },
                    "secondary_text": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "place_id",
                    "label",
                    "main_text",
                    "secondary_text"
                  ],
                  "additionalProperties": false
                }
              }
            },
            "required": [
              "suggestions"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "environment",
              "request_id"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted suggest a storefront delivery address response projection."
      },
      "CertifiedStorefrontAddressEnvelope": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "address": {
                "type": "object",
                "properties": {
                  "address": {
                    "type": "string"
                  },
                  "city": {
                    "type": "string"
                  },
                  "state": {
                    "type": "string"
                  },
                  "zip": {
                    "type": "string"
                  }
                },
                "required": [
                  "address",
                  "city",
                  "state",
                  "zip"
                ],
                "additionalProperties": false
              }
            },
            "required": [
              "address"
            ],
            "additionalProperties": false
          },
          "meta": {
            "type": "object",
            "properties": {
              "api_version": {
                "type": "string"
              },
              "environment": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            },
            "required": [
              "api_version",
              "environment",
              "request_id"
            ],
            "additionalProperties": false
          }
        },
        "required": [
          "data",
          "meta"
        ],
        "additionalProperties": false,
        "description": "Whitelisted resolve a selected storefront address response projection."
      },
      "ErrorEnvelope": {
        "type": "object",
        "required": [
          "error"
        ],
        "additionalProperties": false,
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "code",
              "message",
              "request_id",
              "details"
            ],
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string",
                "example": "insufficient_scope"
              },
              "message": {
                "type": "string",
                "example": "This operation requires sales:read."
              },
              "request_id": {
                "type": "string",
                "example": "req_test_01J9EXAMPLE"
              },
              "details": {
                "type": "array",
                "items": {}
              }
            }
          }
        }
      }
    }
  },
  "x-centripos-contract-status": {
    "public_storefront": "live",
    "private_retail_reads": "authenticated-live-for-entitled-tenants",
    "private_retail_mutations": "operation-specific; event and calendar operations marked authenticated-live are enabled, all others remain controlled-rollout",
    "example_data": "synthetic-only",
    "certified_storefront_checkout": "certified-live-for-approved-tenant-and-client"
  },
  "x-centripos-commerce-backorders": {
    "policy_precedence": [
      "variant",
      "product",
      "tenant"
    ],
    "modes": [
      "deny",
      "allow_notify",
      "allow"
    ],
    "inventory_semantics": "Physical storefront availability and policy-approved purchasability are separate server-authoritative fields.",
    "reservation_semantics": "A quote reserves available physical stock first and snapshots any approved shortage as a durable backorder commitment.",
    "sale_line_snapshot": [
      "state",
      "reserved_quantity",
      "backorder_quantity",
      "policy",
      "eta_date",
      "customer_message"
    ],
    "events": [
      "commerce_backorder.created",
      "commerce_backorder.updated"
    ],
    "event_payload_boundary": "Signed safe projections contain no payment credentials; retrieve the current supported sale resource with a separately scoped key when additional current fields are needed."
  },
  "x-centripos-event-webhooks": {
    "status": "operational only for entitled tenants with active subscriptions and corresponding resource-read scopes",
    "event_types": [
      "event_offering.created",
      "event_offering.updated",
      "event_offering.deleted",
      "event_occurrence.created",
      "event_occurrence.updated",
      "event_occurrence.deleted",
      "event_occurrence_instance.created",
      "event_occurrence_instance.updated",
      "event_occurrence_instance.deleted",
      "event_occurrence_exception.created",
      "event_occurrence_exception.updated",
      "event_occurrence_exception.deleted",
      "event_capacity_pool.created",
      "event_capacity_pool.updated",
      "event_capacity_pool.deleted",
      "event_ticket_option.created",
      "event_ticket_option.updated",
      "event_ticket_option.deleted",
      "event_payment_plan_policy.created",
      "event_payment_plan_policy.updated",
      "event_payment_plan_policy.archived",
      "event_space.created",
      "event_space.updated",
      "event_space.deleted",
      "event_track.created",
      "event_track.updated",
      "event_track.deleted",
      "event_occurrence_track.created",
      "event_occurrence_track.updated",
      "event_occurrence_track.deleted",
      "event_person.created",
      "event_person.updated",
      "event_person.deleted",
      "event_organization.created",
      "event_organization.updated",
      "event_organization.deleted",
      "event_stakeholder_role.created",
      "event_stakeholder_role.updated",
      "event_stakeholder_role.deleted",
      "event_selection_group.created",
      "event_selection_group.updated",
      "event_selection_group.deleted",
      "event_selection_group_occurrence.created",
      "event_selection_group_occurrence.updated",
      "event_selection_group_occurrence.deleted",
      "event_addon_option.created",
      "event_addon_option.updated",
      "event_addon_option.deleted",
      "event_participant.created",
      "event_participant.updated",
      "event_participant.deleted",
      "event_participant_guardian.created",
      "event_participant_guardian.updated",
      "event_participant_guardian.deleted",
      "event_participant_addon.created",
      "event_participant_addon.updated",
      "event_participant_addon.deleted",
      "event_occurrence_enrollment.created",
      "event_occurrence_enrollment.updated",
      "event_occurrence_enrollment.deleted",
      "event_registration.created",
      "event_registration.updated",
      "event_registration.deleted",
      "event_registration_payment_plan.activated",
      "event_registration_payment_plan.paused",
      "event_registration_payment_plan.resumed",
      "event_registration_payment_plan.delinquent",
      "event_registration_payment_plan.completed",
      "event_registration_payment_plan.canceled",
      "event_registration_payment_plan.admission_reinstated",
      "event_ticket.created",
      "event_ticket.updated",
      "event_ticket.deleted",
      "event_checkin.created",
      "event_waitlist_entry.created",
      "event_waitlist_entry.updated",
      "event_waitlist_entry.deleted",
      "event_asset.created",
      "event_asset.updated",
      "event_asset.deleted",
      "event_publication_feed.created",
      "event_publication_feed.updated",
      "event_publication_feed.deleted",
      "event_registration_form.created",
      "event_registration_form.updated",
      "event_registration_form.deleted",
      "event_offering_form_assignment.created",
      "event_offering_form_assignment.updated",
      "event_offering_form_assignment.deleted",
      "event_registration_form_completion.created",
      "event_registration_form_completion.updated",
      "event_registration_question.created",
      "event_registration_question.updated",
      "event_registration_question.deleted",
      "event_waiver.created",
      "event_waiver.updated",
      "event_waiver.deleted",
      "event_offering_waiver_assignment.created",
      "event_offering_waiver_assignment.updated",
      "event_offering_waiver_assignment.deleted",
      "event_waiver_acceptance.created",
      "event_venue.created",
      "event_venue.updated",
      "event_venue.deleted",
      "event_ticket_preset.created",
      "event_ticket_preset.updated",
      "event_ticket_preset.deleted",
      "event_purchase_rule_set.created",
      "event_purchase_rule_set.updated",
      "event_purchase_rule_set.deleted",
      "event_purchase_rule_group.created",
      "event_purchase_rule_group.updated",
      "event_purchase_rule_group.deleted",
      "event_purchase_rule_condition.created",
      "event_purchase_rule_condition.updated",
      "event_purchase_rule_condition.deleted",
      "event_purchase_rule_action.created",
      "event_purchase_rule_action.updated",
      "event_purchase_rule_action.deleted",
      "event_scanner_device.created",
      "event_scanner_device.updated",
      "event_scanner_device.deleted",
      "event_scanner_sync_batch.created",
      "event_ticket_delivery_settings.created",
      "event_ticket_delivery_settings.updated",
      "event_ticket_artifact.created",
      "event_ticket_artifact.updated",
      "event_ticket_artifact.deleted",
      "event_venue_layout.created",
      "event_venue_layout.updated",
      "event_venue_layout.deleted",
      "event_seating_section.created",
      "event_seating_section.updated",
      "event_seating_section.deleted",
      "event_seating_row.created",
      "event_seating_row.updated",
      "event_seating_row.deleted",
      "event_seat.created",
      "event_seat.updated",
      "event_seat.deleted",
      "event_seating_pricing_zone.created",
      "event_seating_pricing_zone.updated",
      "event_seating_pricing_zone.deleted",
      "event_seating_zone_seat.created",
      "event_seating_zone_seat.deleted",
      "event_occurrence_seating_config.created",
      "event_occurrence_seating_config.updated",
      "event_occurrence_seating_config.deleted",
      "event_ticket_seating_zone_rule.created",
      "event_ticket_seating_zone_rule.updated",
      "event_ticket_seating_zone_rule.deleted",
      "event_seat_hold.created",
      "event_seat_hold.updated",
      "event_seat_hold.deleted",
      "event_seat_assignment.created",
      "event_seat_assignment.updated",
      "event_seat_assignment.deleted",
      "event_seat_inventory_event.created",
      "event_access_code_set.created",
      "event_access_code_set.updated",
      "event_access_code_set.deleted",
      "event_access_code.created",
      "event_access_code.updated",
      "event_access_code.deleted",
      "event_access_code_reservation.created",
      "event_access_code_reservation.updated",
      "event_access_code_reservation.deleted",
      "event_registration_intent_physical_seat.created",
      "event_registration_intent_physical_seat.updated",
      "event_registration_intent_physical_seat.deleted",
      "calendar_entry.created",
      "calendar_entry.updated",
      "calendar_entry.deleted",
      "calendar_entry_attendee.created",
      "calendar_entry_attendee.updated",
      "calendar_entry_attendee.deleted"
    ],
    "envelope": [
      "id",
      "type",
      "api_version",
      "created_at",
      "data.object"
    ],
    "object_contract": [
      "id",
      "object",
      "complete allowed scalar safe projection",
      "changed_fields when supplied",
      "resource_url when the object has a Retail API item route"
    ],
    "subscription_authorization": "Creating or updating a subscription requires webhooks:write plus every corresponding resource-read scope listed below.",
    "required_scope_by_object_type": {
      "event_offering": "events:read",
      "event_occurrence": "events:read",
      "event_occurrence_instance": "events:read",
      "event_occurrence_exception": "events:read",
      "event_capacity_pool": "events:read",
      "event_ticket_option": "events:read",
      "event_payment_plan_policy": "events:read",
      "event_space": "events:read",
      "event_track": "events:read",
      "event_occurrence_track": "events:read",
      "event_person": "events:read",
      "event_organization": "events:read",
      "event_stakeholder_role": "events:read",
      "event_selection_group": "events:read",
      "event_selection_group_occurrence": "events:read",
      "event_addon_option": "events:read",
      "event_participant": "events:registrations:read",
      "event_participant_guardian": "events:registrations:read",
      "event_participant_addon": "events:registrations:read",
      "event_occurrence_enrollment": "events:registrations:read",
      "event_registration": "events:registrations:read",
      "event_registration_payment_plan": "invoices:read",
      "event_ticket": "events:credentials:read",
      "event_checkin": "events:attendance:read",
      "event_waitlist_entry": "events:registrations:read",
      "event_asset": "events:read",
      "event_publication_feed": "events:read",
      "event_registration_form": "events:read",
      "event_offering_form_assignment": "events:read",
      "event_registration_form_completion": "events:registrations:read",
      "event_registration_question": "events:read",
      "event_waiver": "events:read",
      "event_offering_waiver_assignment": "events:read",
      "event_waiver_acceptance": "events:registrations:read",
      "event_venue": "events:read",
      "event_ticket_preset": "events:read",
      "event_purchase_rule_set": "events:read",
      "event_purchase_rule_group": "events:read",
      "event_purchase_rule_condition": "events:read",
      "event_purchase_rule_action": "events:read",
      "event_scanner_device": "events:attendance:read",
      "event_scanner_sync_batch": "events:attendance:read",
      "event_ticket_delivery_settings": "events:credentials:read",
      "event_ticket_artifact": "events:credentials:read",
      "event_venue_layout": "events:read",
      "event_seating_section": "events:read",
      "event_seating_row": "events:read",
      "event_seat": "events:read",
      "event_seating_pricing_zone": "events:read",
      "event_seating_zone_seat": "events:read",
      "event_occurrence_seating_config": "events:read",
      "event_ticket_seating_zone_rule": "events:read",
      "event_seat_hold": "events:registrations:read",
      "event_seat_assignment": "events:registrations:read",
      "event_seat_inventory_event": "events:registrations:read",
      "event_access_code_set": "events:read",
      "event_access_code": "events:credentials:read",
      "event_access_code_reservation": "events:registrations:read",
      "event_registration_intent_physical_seat": "events:registrations:read",
      "calendar_entry": "calendar:read",
      "calendar_entry_attendee": "calendar:read"
    },
    "safe_snapshot_fields": {
      "event_offering": [
        "slug",
        "name",
        "short_description",
        "description_html",
        "event_kind",
        "delivery_format",
        "status",
        "visibility",
        "timezone",
        "venue_id",
        "venue_name",
        "support_email",
        "support_phone",
        "registration_opens_at",
        "registration_closes_at",
        "minimum_age_months",
        "maximum_age_months",
        "primary_image_url",
        "image_alt_text",
        "canonical_public_url",
        "registration_url",
        "redirect_url",
        "redirect_status_code",
        "redirect_expires_at",
        "source_system",
        "external_id",
        "version",
        "published_at",
        "created_at",
        "updated_at"
      ],
      "event_occurrence": [
        "offering_id",
        "occurrence_key",
        "name",
        "session_kind",
        "enrollment_policy",
        "status",
        "starts_at",
        "ends_at",
        "timezone",
        "all_day",
        "recurrence_rule",
        "recurrence_until",
        "venue_id",
        "venue_name",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_occurrence_instance": [
        "offering_id",
        "occurrence_id",
        "exception_id",
        "instance_key",
        "original_start_at",
        "starts_at",
        "ends_at",
        "timezone",
        "status",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_occurrence_exception": [
        "occurrence_id",
        "original_start_at",
        "exception_type",
        "starts_at",
        "ends_at",
        "reason",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_capacity_pool": [
        "offering_id",
        "occurrence_id",
        "code",
        "name",
        "capacity",
        "overbook_allowance",
        "notification_threshold_percent",
        "waitlist_enabled",
        "status",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_ticket_option": [
        "offering_id",
        "product_id",
        "ticket_preset_id",
        "ticket_preset_version",
        "code",
        "label",
        "description",
        "status",
        "sales_opens_at",
        "sales_closes_at",
        "minimum_per_order",
        "maximum_per_order",
        "seats_per_ticket",
        "sort_order",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_payment_plan_policy": [
        "offering_id",
        "ticket_option_id",
        "code",
        "name",
        "description",
        "status",
        "customer_selectable",
        "deposit_mode",
        "deposit_value",
        "remaining_installment_count",
        "interval_unit",
        "interval_count",
        "first_installment_delay_days",
        "final_due_days_before_start",
        "grace_period_days",
        "capacity_policy",
        "admission_policy",
        "delinquency_policy",
        "auto_collect_allowed",
        "sort_order",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_space": [
        "offering_id",
        "code",
        "name",
        "venue_name",
        "capacity",
        "status",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_track": [
        "offering_id",
        "code",
        "name",
        "description",
        "color",
        "status",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_occurrence_track": [
        "occurrence_id",
        "track_id",
        "sort_order",
        "created_at"
      ],
      "event_person": [
        "display_name",
        "title",
        "bio_html",
        "photo_url",
        "status",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_organization": [
        "name",
        "organization_type",
        "description_html",
        "website_url",
        "logo_url",
        "status",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_stakeholder_role": [
        "offering_id",
        "occurrence_id",
        "person_id",
        "organization_id",
        "role",
        "role_label",
        "is_public",
        "sort_order",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_selection_group": [
        "offering_id",
        "ticket_option_id",
        "code",
        "name",
        "description",
        "minimum_selections",
        "maximum_selections",
        "conflict_policy",
        "status",
        "sort_order",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_selection_group_occurrence": [
        "selection_group_id",
        "occurrence_id",
        "sort_order",
        "created_at"
      ],
      "event_addon_option": [
        "offering_id",
        "ticket_option_id",
        "product_id",
        "variant_id",
        "label",
        "description",
        "minimum_per_participant",
        "maximum_per_participant",
        "required",
        "status",
        "sort_order",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_participant": [
        "participant_type",
        "status",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_participant_guardian": [
        "participant_id",
        "is_primary",
        "portal_visible",
        "portal_authorized",
        "can_manage_registration",
        "can_receive_notifications",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_participant_addon": [
        "offering_id",
        "registration_id",
        "participant_id",
        "product_id",
        "variant_id",
        "quantity",
        "returned_quantity",
        "status",
        "fulfilled_at",
        "returned_at",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_occurrence_enrollment": [
        "offering_id",
        "occurrence_id",
        "occurrence_instance_id",
        "registration_id",
        "participant_id",
        "status",
        "seat_quantity",
        "source_system",
        "external_id",
        "selected_at",
        "waitlisted_at",
        "cancelled_at",
        "attended_at",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_registration": [
        "offering_id",
        "ticket_option_id",
        "primary_participant_id",
        "registration_number",
        "status",
        "seat_count",
        "amount_total",
        "currency",
        "source_system",
        "external_id",
        "registered_at",
        "confirmed_at",
        "cancelled_at",
        "capacity_hold_expires_at",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_registration_payment_plan": [
        "registration_id",
        "plan_id",
        "policy_id",
        "sale_id",
        "status",
        "deposit_amount_cents",
        "scheduled_balance_cents",
        "next_due_on",
        "delinquent_since",
        "completed_at",
        "canceled_at",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_ticket": [
        "registration_id",
        "participant_id",
        "ticket_option_id",
        "sequence_number",
        "seat_quantity",
        "status",
        "source_system",
        "external_id",
        "issued_at",
        "expires_at",
        "voided_at",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_checkin": [
        "offering_id",
        "occurrence_id",
        "occurrence_instance_id",
        "registration_id",
        "ticket_id",
        "participant_id",
        "direction",
        "result",
        "admitted_seat_quantity",
        "method",
        "checked_in_at",
        "source_system",
        "external_id",
        "created_at"
      ],
      "event_waitlist_entry": [
        "offering_id",
        "occurrence_id",
        "ticket_option_id",
        "participant_id",
        "requested_seats",
        "status",
        "priority",
        "position",
        "offered_at",
        "offer_expires_at",
        "accepted_registration_id",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_asset": [
        "offering_id",
        "occurrence_id",
        "asset_type",
        "title",
        "alt_text",
        "url",
        "mime_type",
        "byte_size",
        "visibility",
        "sort_order",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_publication_feed": [
        "slug",
        "name",
        "status",
        "visibility",
        "custom_domain",
        "source_system",
        "external_id",
        "version",
        "published_at",
        "created_at",
        "updated_at"
      ],
      "event_registration_form": [
        "form_key",
        "version_number",
        "name",
        "status",
        "completion_scope",
        "instructions_html",
        "content_hash",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_offering_form_assignment": [
        "offering_id",
        "ticket_option_id",
        "form_id",
        "stage",
        "required",
        "sort_order",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_registration_form_completion": [
        "registration_id",
        "assignment_id",
        "form_id",
        "is_complete",
        "completion_revision",
        "completed_at",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_registration_question": [
        "form_id",
        "question_key",
        "label",
        "help_text",
        "response_scope",
        "field_type",
        "required",
        "privacy_class",
        "retention_days",
        "report_key",
        "sort_order",
        "status",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_waiver": [
        "waiver_key",
        "version_number",
        "title",
        "status",
        "required",
        "effective_at",
        "expires_at",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_offering_waiver_assignment": [
        "offering_id",
        "ticket_option_id",
        "waiver_id",
        "required",
        "sort_order",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_waiver_acceptance": [
        "registration_id",
        "waiver_id",
        "participant_id",
        "consented_at",
        "source_system",
        "external_id",
        "created_at"
      ],
      "event_venue": [
        "slug",
        "name",
        "status",
        "timezone",
        "address_line_1",
        "address_line_2",
        "locality",
        "administrative_area",
        "postal_code",
        "country_code",
        "latitude",
        "longitude",
        "map_url",
        "map_provider",
        "map_place_id",
        "public_phone",
        "public_email",
        "website_url",
        "source_system",
        "external_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_ticket_preset": [
        "code",
        "name",
        "description",
        "status",
        "default_label",
        "default_description",
        "default_price",
        "currency",
        "minimum_per_order",
        "maximum_per_order",
        "seats_per_ticket",
        "assignment_policy",
        "admission_policy",
        "inventory_mode",
        "default_capacity",
        "sales_opens_offset_seconds",
        "sales_closes_offset_seconds",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_purchase_rule_set": [
        "offering_id",
        "ticket_option_id",
        "code",
        "name",
        "description",
        "status",
        "priority",
        "stop_processing",
        "effective_from",
        "effective_until",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_purchase_rule_group": [
        "rule_set_id",
        "parent_group_id",
        "match_mode",
        "negate",
        "sort_order",
        "label",
        "created_at",
        "updated_at"
      ],
      "event_purchase_rule_condition": [
        "rule_set_id",
        "group_id",
        "field_key",
        "operator",
        "sort_order",
        "label",
        "created_at",
        "updated_at"
      ],
      "event_purchase_rule_action": [
        "rule_set_id",
        "action_type",
        "message",
        "sort_order",
        "created_at",
        "updated_at"
      ],
      "event_scanner_device": [
        "display_name",
        "status",
        "created_by_profile_id",
        "last_manifest_at",
        "last_sync_at",
        "last_seen_at",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_scanner_sync_batch": [
        "device_id",
        "offering_id",
        "occurrence_id",
        "occurrence_instance_id",
        "client_batch_id",
        "submitted_count",
        "synchronized_count",
        "accepted_count",
        "duplicate_count",
        "denied_count",
        "failed_count",
        "synced_by_profile_id",
        "synchronized_at",
        "created_at"
      ],
      "event_ticket_delivery_settings": [
        "tenant_id",
        "issuer_name",
        "support_url",
        "logo_url",
        "icon_url",
        "foreground_color",
        "background_color",
        "label_color",
        "pdf_enabled",
        "apple_wallet_enabled",
        "google_wallet_enabled",
        "apple_configuration_state",
        "google_configuration_state",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_ticket_artifact": [
        "ticket_id",
        "artifact_type",
        "status",
        "branded_path",
        "content_hash",
        "generated_at",
        "expires_at",
        "revoked_at",
        "failure_code",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_venue_layout": [
        "venue_id",
        "code",
        "name",
        "description",
        "layout_kind",
        "status",
        "canvas_width",
        "canvas_height",
        "background_asset_url",
        "published_at",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_seating_section": [
        "layout_id",
        "code",
        "name",
        "color",
        "sort_order",
        "entry_notes",
        "status",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_seating_row": [
        "layout_id",
        "section_id",
        "code",
        "label",
        "sort_order",
        "status",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_seat": [
        "layout_id",
        "section_id",
        "row_id",
        "code",
        "label",
        "sort_order",
        "x",
        "y",
        "rotation_degrees",
        "accessibility_type",
        "companion_group",
        "obstructed_view",
        "status",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_seating_pricing_zone": [
        "layout_id",
        "code",
        "name",
        "description",
        "color",
        "sort_order",
        "status",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_seating_zone_seat": [
        "pricing_zone_id",
        "seat_id",
        "created_at"
      ],
      "event_occurrence_seating_config": [
        "offering_id",
        "occurrence_id",
        "occurrence_instance_id",
        "layout_id",
        "selection_mode",
        "status",
        "hold_duration_seconds",
        "allow_accessible_companion_override",
        "sales_opens_at",
        "sales_closes_at",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_ticket_seating_zone_rule": [
        "seating_config_id",
        "ticket_option_id",
        "pricing_zone_id",
        "price_adjustment",
        "currency",
        "minimum_seats",
        "maximum_seats",
        "status",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_seat_hold": [
        "seating_config_id",
        "hold_group_id",
        "seat_id",
        "pricing_zone_id",
        "ticket_option_id",
        "registration_id",
        "client_reference",
        "status",
        "expires_at",
        "converted_at",
        "released_at",
        "created_by_profile_id",
        "created_at"
      ],
      "event_seat_assignment": [
        "seating_config_id",
        "seat_id",
        "pricing_zone_id",
        "hold_id",
        "ticket_id",
        "registration_id",
        "participant_id",
        "status",
        "assignment_source",
        "assigned_at",
        "released_at",
        "release_reason",
        "assigned_by_profile_id",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_seat_inventory_event": [
        "seating_config_id",
        "seat_id",
        "hold_id",
        "assignment_id",
        "event_type",
        "actor_profile_id",
        "source_system",
        "occurred_at",
        "created_at"
      ],
      "event_access_code_set": [
        "offering_id",
        "ticket_option_id",
        "code",
        "name",
        "description",
        "status",
        "starts_at",
        "ends_at",
        "max_redemptions",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_access_code": [
        "code_set_id",
        "key_version",
        "code_hint",
        "label",
        "status",
        "max_redemptions",
        "starts_at",
        "ends_at",
        "version",
        "created_at",
        "updated_at"
      ],
      "event_access_code_reservation": [
        "code_set_id",
        "quote_id",
        "order_id",
        "quantity",
        "status",
        "expires_at",
        "confirmed_at",
        "created_at"
      ],
      "event_registration_intent_physical_seat": [
        "quote_id",
        "intent_id",
        "unit_index",
        "seating_config_id",
        "hold_group_id",
        "hold_id",
        "seat_id",
        "registration_id",
        "ticket_id",
        "status",
        "assigned_at",
        "created_at"
      ],
      "calendar_entry": [
        "source_type",
        "source_id",
        "calendar_type",
        "title",
        "starts_at",
        "ends_at",
        "timezone",
        "all_day",
        "status",
        "visibility",
        "recurrence_rule",
        "ical_uid",
        "source_system",
        "external_id",
        "sync_status",
        "version",
        "created_at",
        "updated_at"
      ],
      "calendar_entry_attendee": [
        "calendar_entry_id",
        "source_type",
        "source_id",
        "participant_id",
        "attendee_role",
        "response_status",
        "notify",
        "version",
        "created_at",
        "updated_at"
      ]
    },
    "deleted_resource_contract": "Identity-only tombstone: id, object, optional changed_fields, and resource_url.",
    "never_embedded": [
      "arbitrary JSON metadata",
      "registration form answers",
      "medical or accessibility details",
      "waiver signature evidence",
      "ticket credentials",
      "payment data",
      "portal secrets",
      "native Storage bucket or path coordinates",
      "Supabase project URLs",
      "admission denial detail"
    ],
    "signature_headers": [
      "CentriPOS-API-Version",
      "CentriPOS-Delivery-ID",
      "CentriPOS-Event",
      "CentriPOS-Signature"
    ],
    "signature_input": "HMAC-SHA256 over <timestamp>.<exact raw JSON body>; header format t=<timestamp>,v1=<hex>.",
    "retry_policy": "Six total attempts with bounded exponential backoff and jitter; 2xx is success.",
    "examples": {
      "event_offering_updated": {
        "id": "50000000-0000-4000-8000-000000000001",
        "type": "event_offering.updated",
        "api_version": "2026-08-24",
        "created_at": "2026-08-25T15:00:00Z",
        "data": {
          "object": {
            "id": "10000000-0000-4000-8000-000000000001",
            "object": "event_offering",
            "slug": "robotics-discovery-camp",
            "name": "Robotics Discovery Camp",
            "short_description": "A synthetic five-day morning, afternoon, or full-day camp.",
            "description_html": "<p>Build, code, test, and take home a small demonstration project.</p>",
            "event_kind": "camp",
            "delivery_format": "in_person",
            "status": "published",
            "visibility": "public",
            "timezone": "America/New_York",
            "venue_id": null,
            "venue_name": "Northstar Learning Lab",
            "support_email": "events@example.test",
            "support_phone": "+1-555-010-0100",
            "registration_opens_at": "2026-08-25T13:00:00Z",
            "registration_closes_at": "2026-09-13T23:59:00Z",
            "minimum_age_months": 96,
            "maximum_age_months": 156,
            "primary_image_url": "https://pos.getcentri.com/media/events/synthetic/robotics-camp.webp",
            "image_alt_text": "Synthetic robotics camp work table",
            "canonical_public_url": null,
            "registration_url": null,
            "redirect_url": null,
            "redirect_status_code": null,
            "redirect_expires_at": null,
            "source_system": "centripos",
            "external_id": null,
            "version": 3,
            "published_at": "2026-08-25T15:00:00Z",
            "created_at": "2026-08-25T14:00:00Z",
            "updated_at": "2026-08-25T15:00:00Z",
            "changed_fields": [
              "registration_closes_at",
              "updated_at"
            ],
            "resource_url": "https://pos.getcentri.com/api/retail/v1/events/10000000-0000-4000-8000-000000000001"
          }
        }
      },
      "event_registration_updated": {
        "id": "50000000-0000-4000-8000-000000000003",
        "type": "event_registration.updated",
        "api_version": "2026-08-24",
        "created_at": "2026-08-25T15:00:00Z",
        "data": {
          "object": {
            "id": "10000000-0000-4000-8000-000000000010",
            "object": "event_registration",
            "offering_id": "10000000-0000-4000-8000-000000000001",
            "ticket_option_id": "10000000-0000-4000-8000-000000000008",
            "primary_participant_id": "10000000-0000-4000-8000-000000000009",
            "registration_number": "REG-0000000421",
            "status": "confirmed",
            "seat_count": 1,
            "amount_total": 595,
            "currency": "USD",
            "source_system": "centripos",
            "external_id": null,
            "registered_at": "2026-08-25T14:54:00Z",
            "confirmed_at": "2026-08-25T15:00:00Z",
            "cancelled_at": null,
            "capacity_hold_expires_at": null,
            "version": 2,
            "created_at": "2026-08-25T14:00:00Z",
            "updated_at": "2026-08-25T15:00:00Z",
            "changed_fields": [
              "primary_participant_id",
              "updated_at"
            ],
            "resource_url": "https://pos.getcentri.com/api/retail/v1/event-registrations/10000000-0000-4000-8000-000000000010"
          }
        }
      },
      "calendar_entry_updated": {
        "id": "50000000-0000-4000-8000-000000000002",
        "type": "calendar_entry.updated",
        "api_version": "2026-08-24",
        "created_at": "2026-08-25T15:00:00Z",
        "data": {
          "object": {
            "id": "10000000-0000-4000-8000-000000000016",
            "object": "calendar_entry",
            "source_type": "event_occurrence",
            "source_id": "10000000-0000-4000-8000-000000000002",
            "calendar_type": "company",
            "title": "Robotics discovery camp — morning",
            "starts_at": "2026-09-14T13:00:00Z",
            "ends_at": "2026-09-14T16:00:00Z",
            "timezone": "America/New_York",
            "all_day": false,
            "status": "confirmed",
            "visibility": "attendees",
            "recurrence_rule": "FREQ=DAILY;COUNT=5",
            "ical_uid": "synthetic-event-calendar-entry@calendar.centripos.com",
            "source_system": "centripos",
            "external_id": null,
            "sync_status": "local",
            "version": 2,
            "created_at": "2026-08-25T14:00:00Z",
            "updated_at": "2026-08-25T15:00:00Z",
            "changed_fields": [
              "starts_at",
              "ends_at",
              "updated_at"
            ],
            "resource_url": "https://pos.getcentri.com/api/retail/v1/calendar/entries/10000000-0000-4000-8000-000000000016"
          }
        }
      },
      "event_ticket_deleted": {
        "id": "50000000-0000-4000-8000-000000000004",
        "type": "event_ticket.deleted",
        "api_version": "2026-08-24",
        "created_at": "2026-08-25T15:00:00Z",
        "data": {
          "object": {
            "id": "10000000-0000-4000-8000-000000000011",
            "object": "event_ticket",
            "changed_fields": [
              "status",
              "voided_at",
              "updated_at"
            ],
            "resource_url": "https://pos.getcentri.com/api/retail/v1/event-tickets/10000000-0000-4000-8000-000000000011"
          }
        }
      }
    }
  },
  "x-centripos-event-ticket-lifecycle": {
    "statuses": [
      "pending_assignment",
      "valid",
      "used",
      "voided",
      "transferred",
      "expired"
    ],
    "pending_assignment": "Unassigned and non-admissible; no active credential is exposed.",
    "active_credential": "Only a participant-bound, unexpired valid or used ticket may expose an active scan credential to an authorized viewer.",
    "generic_patch": [
      "expires_at",
      "external_id",
      "version"
    ],
    "lifecycle_commands": "Participant, ticket option, status, seat quantity, assignment, transfer, and revocation remain command-owned."
  },
  "x-centripos-event-registration-lifecycle": {
    "create_status": "pending only",
    "generic_patch": [
      "external_id",
      "version"
    ],
    "protected_fields": [
      "offering_id",
      "ticket_option_id",
      "primary_participant_id",
      "purchaser_customer_id",
      "sale_id",
      "sale_line_item_id",
      "status",
      "seat_count",
      "amount_total",
      "currency",
      "capacity_hold_expires_at"
    ],
    "protected_field_result": "409 lifecycle_command_required; use the authoritative receipt, workflow, assignment, transfer, confirmation, or cancellation command.",
    "participant_link_mutations": "Generic POST, PATCH, and DELETE are registered to return 409 lifecycle_command_required.",
    "delete_result": "204 No Content after authoritative cancellation."
  },
  "x-centripos-event-payment-plan-lifecycle": {
    "read_scopes": [
      "invoices:read",
      "events:registrations:read"
    ],
    "write_scopes": [
      "events:registrations:write",
      "invoices:write"
    ],
    "operation_class": "payment_adjacent",
    "idempotency": "Every lifecycle POST requires Idempotency-Key; a retry of the same normalized request returns the original result.",
    "commands": [
      "create",
      "pause",
      "resume",
      "cancel",
      "send-customer-link",
      "reinstate-admission"
    ],
    "no_mark_paid": "No event payment-plan route marks an installment or receipt paid. Money is recorded only through authoritative completed receipt tenders.",
    "no_automatic_charge": "Creating or resuming a schedule does not authorize an automatic card charge; separate supported method consent is required.",
    "customer_link": "send-customer-link returns a tenant-bound branded receipt capability ready for authorized caller delivery. It does not send, charge, or mark paid; the suggested amount is only a prefill and the returned canonical expiry is authoritative. An Idempotency-Key replay returns only the same unchanged still-live capability; expiry, rotation, plan completion/cancellation, balance drift, or installment drift fails closed and a current request requires a new key."
  },
  "x-centripos-customer-portal-events": {
    "registration_paging": "Use before_registered_at and before_registration_id as an atomic pair; default 25, maximum 100.",
    "resource_paging": "Each child resource uses independent limit/after_id keyset paging with a maximum of 100.",
    "resources": [
      "participants",
      "tickets",
      "agenda",
      "schedule",
      "assets",
      "requirements",
      "assignment_forms",
      "assignment_questions",
      "assignment_waivers",
      "assignment_groups",
      "assignment_group_occurrences",
      "assignment_sessions"
    ],
    "assignment_identity_modes": [
      "purchaser_self",
      "new_participant"
    ],
    "assignment_body_maximum_bytes": 262144,
    "attendee_asset_delivery": "Authorized public+attendees assets use a branded five-minute /account-portal-event-asset/<capability>/<assetId> URL; Storage coordinates are never returned."
  },
  "x-centripos-storefront-checkout": {
    "authority": [
      "inventory",
      "address_eligibility",
      "promotions",
      "tax",
      "shipping_and_delivery_fees",
      "line_fulfillment"
    ],
    "mixed_cart_policy": "common-method-intersection",
    "split_packages_supported": false,
    "payment_boundary": "Opaque tokenized card or certified financing evidence only; raw PAN, CVV, reusable credentials, and raw processor responses are prohibited.",
    "idempotency_body_match": "byte-identical-raw-json",
    "shipping_fee_semantics": "Product flat nationwide shipping fees are multiplied by purchased line quantity."
  }
}
