@voyant-travel/openapi 0.2.6 → 0.3.0

package/spec/framework-openapi.json

@@ -43812,6 +43812,42 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Referenced resource pool or resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Resource pool member already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -44163,6 +44199,24 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Referenced resource pool not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -44707,7 +44761,7 @@
             }
           },
           "404": {
-            "description": "Resource requirement not found",
+            "description": "Resource requirement or referenced resource pool not found",
             "content": {
               "application/json": {
                 "schema": {
@@ -45072,6 +45126,24 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Referenced resource pool not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -45616,7 +45688,7 @@
             }
           },
           "404": {
-            "description": "Resource allocation not found",
+            "description": "Resource allocation or referenced resource pool not found",
             "content": {
               "application/json": {
                 "schema": {
@@ -46041,6 +46113,24 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Referenced resource pool or resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -46662,7 +46752,7 @@
             }
           },
           "404": {
-            "description": "Resource slot assignment not found",
+            "description": "Resource slot assignment or referenced resource pool/resource not found",
             "content": {
               "application/json": {
                 "schema": {
@@ -46998,6 +47088,24 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Referenced resource not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -47520,7 +47628,7 @@
             }
           },
           "404": {
-            "description": "Resource closeout not found",
+            "description": "Resource closeout or referenced resource not found",
             "content": {
               "application/json": {
                 "schema": {
@@ -76650,6 +76758,39 @@
                   "active": {
                     "type": "boolean",
                     "default": true
+                  },
+                  "sourceKind": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "minLength": 1
+                  },
+                  "sourceConnectionId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "minLength": 1
+                  },
+                  "pushBookings": {
+                    "type": "boolean",
+                    "default": true
+                  },
+                  "pushAvailability": {
+                    "type": "boolean",
+                    "default": true
+                  },
+                  "pushContent": {
+                    "type": "boolean",
+                    "default": true
+                  },
+                  "policy": {
+                    "type": [
+                      "object",
+                      "null"
+                    ],
+                    "additionalProperties": {}
                   }
                 },
                 "required": [
@@ -76843,8 +76984,37 @@
                         ]
                       },
                       "active": {
-                        "type": "boolean",
-                        "default": true
+                        "type": "boolean"
+                      },
+                      "sourceKind": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "minLength": 1
+                      },
+                      "sourceConnectionId": {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "minLength": 1
+                      },
+                      "pushBookings": {
+                        "type": "boolean"
+                      },
+                      "pushAvailability": {
+                        "type": "boolean"
+                      },
+                      "pushContent": {
+                        "type": "boolean"
+                      },
+                      "policy": {
+                        "type": [
+                          "object",
+                          "null"
+                        ],
+                        "additionalProperties": {}
                       }
                     }
                   }
@@ -77311,8 +77481,37 @@
                     ]
                   },
                   "active": {
-                    "type": "boolean",
-                    "default": true
+                    "type": "boolean"
+                  },
+                  "sourceKind": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "minLength": 1
+                  },
+                  "sourceConnectionId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "minLength": 1
+                  },
+                  "pushBookings": {
+                    "type": "boolean"
+                  },
+                  "pushAvailability": {
+                    "type": "boolean"
+                  },
+                  "pushContent": {
+                    "type": "boolean"
+                  },
+                  "policy": {
+                    "type": [
+                      "object",
+                      "null"
+                    ],
+                    "additionalProperties": {}
                   }
                 }
               }
@@ -77938,6 +78137,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "duplicate_channel_booking_link",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -128722,6 +128939,34 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Active promotional offer slug or code already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "requestId": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -129723,6 +129968,34 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Active promotional offer slug or code already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "requestId": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       },
@@ -165634,6 +165907,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Booking item mutations are not allowed for this booking",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -166118,6 +166409,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Booking item mutations are not allowed for this booking",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       },
@@ -166176,6 +166485,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Booking item mutations are not allowed for this booking",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -166396,6 +166723,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Booking item mutations are not allowed for this booking",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -166464,6 +166809,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Booking item mutations are not allowed for this booking",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -171033,7 +171396,7 @@
         ],
         "responses": {
           "200": {
-            "description": "A booking by id (PII redacted unless reveal-authorized)",
+            "description": "A booking by id with its bookings-owned child collections (items, travelers, documents); PII redacted unless reveal-authorized",
             "content": {
               "application/json": {
                 "schema": {
@@ -171309,6 +171672,386 @@
                         },
                         "updatedAt": {
                           "type": "string"
+                        },
+                        "items": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "id": {
+                                "type": "string"
+                              },
+                              "bookingId": {
+                                "type": "string"
+                              },
+                              "title": {
+                                "type": "string"
+                              },
+                              "description": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "itemType": {
+                                "type": "string",
+                                "enum": [
+                                  "unit",
+                                  "extra",
+                                  "service",
+                                  "fee",
+                                  "tax",
+                                  "discount",
+                                  "adjustment",
+                                  "accommodation",
+                                  "transport",
+                                  "other"
+                                ]
+                              },
+                              "status": {
+                                "type": "string",
+                                "enum": [
+                                  "draft",
+                                  "on_hold",
+                                  "confirmed",
+                                  "cancelled",
+                                  "expired",
+                                  "fulfilled"
+                                ]
+                              },
+                              "serviceDate": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "startsAt": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "endsAt": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "quantity": {
+                                "type": "integer"
+                              },
+                              "sellCurrency": {
+                                "type": "string"
+                              },
+                              "unitSellAmountCents": {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              "totalSellAmountCents": {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              "costCurrency": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "unitCostAmountCents": {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              "totalCostAmountCents": {
+                                "type": [
+                                  "integer",
+                                  "null"
+                                ]
+                              },
+                              "notes": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "productId": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "optionId": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "optionUnitId": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "pricingCategoryId": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "availabilitySlotId": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "productNameSnapshot": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "optionNameSnapshot": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "unitNameSnapshot": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "departureLabelSnapshot": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "sourceSnapshotId": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "sourceOfferId": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "metadata": {
+                                "type": [
+                                  "object",
+                                  "null"
+                                ],
+                                "additionalProperties": {}
+                              },
+                              "createdAt": {
+                                "type": "string"
+                              },
+                              "updatedAt": {
+                                "type": "string"
+                              }
+                            },
+                            "required": [
+                              "id",
+                              "bookingId",
+                              "title",
+                              "description",
+                              "itemType",
+                              "status",
+                              "serviceDate",
+                              "startsAt",
+                              "endsAt",
+                              "quantity",
+                              "sellCurrency",
+                              "unitSellAmountCents",
+                              "totalSellAmountCents",
+                              "costCurrency",
+                              "unitCostAmountCents",
+                              "totalCostAmountCents",
+                              "notes",
+                              "productId",
+                              "optionId",
+                              "optionUnitId",
+                              "pricingCategoryId",
+                              "availabilitySlotId",
+                              "productNameSnapshot",
+                              "optionNameSnapshot",
+                              "unitNameSnapshot",
+                              "departureLabelSnapshot",
+                              "sourceSnapshotId",
+                              "sourceOfferId",
+                              "metadata",
+                              "createdAt",
+                              "updatedAt"
+                            ]
+                          }
+                        },
+                        "travelers": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "id": {
+                                "type": "string"
+                              },
+                              "bookingId": {
+                                "type": "string"
+                              },
+                              "participantType": {
+                                "type": "string",
+                                "enum": [
+                                  "traveler",
+                                  "occupant",
+                                  "other"
+                                ]
+                              },
+                              "travelerCategory": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ],
+                                "enum": [
+                                  "adult",
+                                  "child",
+                                  "infant",
+                                  "senior",
+                                  "other",
+                                  null
+                                ]
+                              },
+                              "firstName": {
+                                "type": "string"
+                              },
+                              "lastName": {
+                                "type": "string"
+                              },
+                              "email": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "phone": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "preferredLanguage": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "specialRequests": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "isPrimary": {
+                                "type": "boolean"
+                              },
+                              "notes": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "createdAt": {
+                                "type": "string"
+                              },
+                              "updatedAt": {
+                                "type": "string"
+                              }
+                            },
+                            "required": [
+                              "id",
+                              "bookingId",
+                              "participantType",
+                              "travelerCategory",
+                              "firstName",
+                              "lastName",
+                              "email",
+                              "phone",
+                              "preferredLanguage",
+                              "specialRequests",
+                              "isPrimary",
+                              "notes",
+                              "createdAt",
+                              "updatedAt"
+                            ]
+                          }
+                        },
+                        "documents": {
+                          "type": "array",
+                          "items": {
+                            "type": "object",
+                            "properties": {
+                              "id": {
+                                "type": "string"
+                              },
+                              "bookingId": {
+                                "type": "string"
+                              },
+                              "travelerId": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "type": {
+                                "type": "string",
+                                "enum": [
+                                  "visa",
+                                  "insurance",
+                                  "health",
+                                  "passport_copy",
+                                  "other"
+                                ]
+                              },
+                              "fileName": {
+                                "type": "string"
+                              },
+                              "fileUrl": {
+                                "type": "string"
+                              },
+                              "expiresAt": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "notes": {
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
+                              },
+                              "createdAt": {
+                                "type": "string"
+                              }
+                            },
+                            "required": [
+                              "id",
+                              "bookingId",
+                              "travelerId",
+                              "type",
+                              "fileName",
+                              "fileUrl",
+                              "expiresAt",
+                              "notes",
+                              "createdAt"
+                            ]
+                          }
                         }
                       },
                       "required": [
@@ -171356,7 +172099,10 @@
                         "paidAt",
                         "redeemedAt",
                         "createdAt",
-                        "updatedAt"
+                        "updatedAt",
+                        "items",
+                        "travelers",
+                        "documents"
                       ]
                     }
                   },
@@ -185426,7 +186172,7 @@
                   },
                   "amountCents": {
                     "type": "integer",
-                    "minimum": 0
+                    "minimum": 1
                   },
                   "provider": {
                     "type": [
@@ -186148,7 +186894,7 @@
                   },
                   "amountCents": {
                     "type": "integer",
-                    "minimum": 0
+                    "minimum": 1
                   },
                   "provider": {
                     "type": [
@@ -186661,7 +187407,7 @@
                   },
                   "amountCents": {
                     "type": "integer",
-                    "minimum": 0
+                    "minimum": 1
                   },
                   "provider": {
                     "type": [
@@ -187011,7 +187757,7 @@
                   },
                   "amountCents": {
                     "type": "integer",
-                    "minimum": 0
+                    "minimum": 1
                   },
                   "provider": {
                     "type": [
@@ -192018,6 +192764,32 @@
               }
             }
           },
+          "400": {
+            "description": "invalid_request: guarantee state does not allow deletion",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
+                    }
+                  },
+                  "required": [
+                    "error",
+                    "code"
+                  ]
+                }
+              }
+            }
+          },
           "404": {
             "description": "Booking guarantee not found",
             "content": {
@@ -192204,238 +192976,240 @@
                     "maxLength": 3
                   },
                   "amountCents": {
-                    "type": "integer"
-                  },
-                  "rateBasisPoints": {
-                    "type": [
-                      "integer",
-                      "null"
-                    ],
-                    "minimum": 0
-                  },
-                  "includedInPrice": {
-                    "type": "boolean",
-                    "default": false
-                  },
-                  "remittanceParty": {
-                    "type": [
-                      "string",
-                      "null"
-                    ],
-                    "maxLength": 255
-                  },
-                  "sortOrder": {
                     "type": "integer",
-                    "minimum": 0,
-                    "default": 0
-                  }
-                },
-                "required": [
-                  "name",
-                  "currency",
-                  "amountCents"
-                ]
-              }
-            }
-          }
-        },
-        "responses": {
-          "201": {
-            "description": "The created tax line",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "data": {
-                      "type": "object",
-                      "properties": {
-                        "id": {
-                          "type": "string"
-                        },
-                        "bookingItemId": {
-                          "type": "string"
-                        },
-                        "code": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "name": {
-                          "type": "string"
-                        },
-                        "jurisdiction": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "scope": {
-                          "type": "string",
-                          "enum": [
-                            "included",
-                            "excluded",
-                            "withheld"
-                          ]
-                        },
-                        "currency": {
-                          "type": "string"
-                        },
-                        "amountCents": {
-                          "type": "integer"
-                        },
-                        "rateBasisPoints": {
-                          "type": [
-                            "integer",
-                            "null"
-                          ]
-                        },
-                        "includedInPrice": {
-                          "type": "boolean"
-                        },
-                        "remittanceParty": {
-                          "type": [
-                            "string",
-                            "null"
-                          ]
-                        },
-                        "sortOrder": {
-                          "type": "integer"
-                        },
-                        "createdAt": {
-                          "type": "string"
-                        },
-                        "updatedAt": {
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "id",
-                        "bookingItemId",
-                        "code",
-                        "name",
-                        "jurisdiction",
-                        "scope",
-                        "currency",
-                        "amountCents",
-                        "rateBasisPoints",
-                        "includedInPrice",
-                        "remittanceParty",
-                        "sortOrder",
-                        "createdAt",
-                        "updatedAt"
-                      ]
-                    }
-                  },
-                  "required": [
-                    "data"
-                  ]
-                }
-              }
-            }
-          },
-          "400": {
-            "description": "invalid_request: request body failed validation",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          },
-          "404": {
-            "description": "Booking item not found",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "object",
-                  "properties": {
-                    "error": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "error"
-                  ]
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/admin/finance/booking-items/{bookingItemId}/tax-lines/{taxLineId}": {
-      "patch": {
-        "parameters": [
-          {
-            "schema": {
-              "type": "string"
-            },
-            "required": true,
-            "name": "bookingItemId",
-            "in": "path"
-          },
-          {
-            "schema": {
-              "type": "string"
-            },
-            "required": true,
-            "name": "taxLineId",
-            "in": "path"
-          }
-        ],
-        "requestBody": {
-          "required": true,
-          "content": {
-            "application/json": {
-              "schema": {
-                "type": "object",
-                "properties": {
-                  "code": {
-                    "type": [
-                      "string",
-                      "null"
-                    ],
-                    "maxLength": 100
-                  },
-                  "name": {
-                    "type": "string",
-                    "minLength": 1,
-                    "maxLength": 255
-                  },
-                  "jurisdiction": {
-                    "type": [
-                      "string",
-                      "null"
-                    ],
-                    "maxLength": 255
-                  },
-                  "scope": {
-                    "type": "string",
-                    "enum": [
-                      "included",
-                      "excluded",
-                      "withheld"
-                    ],
-                    "default": "excluded"
-                  },
-                  "currency": {
-                    "type": "string",
-                    "minLength": 3,
-                    "maxLength": 3
-                  },
-                  "amountCents": {
-                    "type": "integer"
+                    "minimum": 0
+                  },
+                  "rateBasisPoints": {
+                    "type": [
+                      "integer",
+                      "null"
+                    ],
+                    "minimum": 0
+                  },
+                  "includedInPrice": {
+                    "type": "boolean",
+                    "default": false
+                  },
+                  "remittanceParty": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "maxLength": 255
+                  },
+                  "sortOrder": {
+                    "type": "integer",
+                    "minimum": 0,
+                    "default": 0
+                  }
+                },
+                "required": [
+                  "name",
+                  "currency",
+                  "amountCents"
+                ]
+              }
+            }
+          }
+        },
+        "responses": {
+          "201": {
+            "description": "The created tax line",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": "object",
+                      "properties": {
+                        "id": {
+                          "type": "string"
+                        },
+                        "bookingItemId": {
+                          "type": "string"
+                        },
+                        "code": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "name": {
+                          "type": "string"
+                        },
+                        "jurisdiction": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "scope": {
+                          "type": "string",
+                          "enum": [
+                            "included",
+                            "excluded",
+                            "withheld"
+                          ]
+                        },
+                        "currency": {
+                          "type": "string"
+                        },
+                        "amountCents": {
+                          "type": "integer"
+                        },
+                        "rateBasisPoints": {
+                          "type": [
+                            "integer",
+                            "null"
+                          ]
+                        },
+                        "includedInPrice": {
+                          "type": "boolean"
+                        },
+                        "remittanceParty": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "sortOrder": {
+                          "type": "integer"
+                        },
+                        "createdAt": {
+                          "type": "string"
+                        },
+                        "updatedAt": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "bookingItemId",
+                        "code",
+                        "name",
+                        "jurisdiction",
+                        "scope",
+                        "currency",
+                        "amountCents",
+                        "rateBasisPoints",
+                        "includedInPrice",
+                        "remittanceParty",
+                        "sortOrder",
+                        "createdAt",
+                        "updatedAt"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "invalid_request: request body failed validation",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Booking item not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/admin/finance/booking-items/{bookingItemId}/tax-lines/{taxLineId}": {
+      "patch": {
+        "parameters": [
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "name": "bookingItemId",
+            "in": "path"
+          },
+          {
+            "schema": {
+              "type": "string"
+            },
+            "required": true,
+            "name": "taxLineId",
+            "in": "path"
+          }
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "code": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "maxLength": 100
+                  },
+                  "name": {
+                    "type": "string",
+                    "minLength": 1,
+                    "maxLength": 255
+                  },
+                  "jurisdiction": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "maxLength": 255
+                  },
+                  "scope": {
+                    "type": "string",
+                    "enum": [
+                      "included",
+                      "excluded",
+                      "withheld"
+                    ],
+                    "default": "excluded"
+                  },
+                  "currency": {
+                    "type": "string",
+                    "minLength": 3,
+                    "maxLength": 3
+                  },
+                  "amountCents": {
+                    "type": "integer",
+                    "minimum": 0
                   },
                   "rateBasisPoints": {
                     "type": [
@@ -192855,7 +193629,8 @@
                     "type": [
                       "integer",
                       "null"
-                    ]
+                    ],
+                    "minimum": 0
                   },
                   "rateBasisPoints": {
                     "type": [
@@ -193032,10 +193807,18 @@
                   "properties": {
                     "error": {
                       "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
                     }
                   },
                   "required": [
-                    "error"
+                    "error",
+                    "code"
                   ]
                 }
               }
@@ -193114,8 +193897,7 @@
                       "fixed",
                       "markup",
                       "net"
-                    ],
-                    "default": "percentage"
+                    ]
                   },
                   "currency": {
                     "type": [
@@ -193129,7 +193911,8 @@
                     "type": [
                       "integer",
                       "null"
-                    ]
+                    ],
+                    "minimum": 0
                   },
                   "rateBasisPoints": {
                     "type": [
@@ -193146,8 +193929,7 @@
                       "payable",
                       "paid",
                       "void"
-                    ],
-                    "default": "pending"
+                    ]
                   },
                   "payableAt": {
                     "type": [
@@ -193303,10 +194085,18 @@
                   "properties": {
                     "error": {
                       "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    },
+                    "details": {
+                      "type": "object",
+                      "additionalProperties": {}
                     }
                   },
                   "required": [
-                    "error"
+                    "error",
+                    "code"
                   ]
                 }
               }
@@ -194200,6 +194990,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "The payment conflicts with the invoice state (e.g. overpayment)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       },
@@ -194962,6 +195770,28 @@
                 }
               }
             }
+          },
+          "422": {
+            "description": "supplier payment payable invariant failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error",
+                    "code"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -195269,6 +196099,28 @@
                 }
               }
             }
+          },
+          "422": {
+            "description": "supplier payment payable invariant failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error",
+                    "code"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -196086,6 +196938,42 @@
                 }
               }
             }
+          },
+          "404": {
+            "description": "Booking, person, or organization reference not found",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
+          },
+          "409": {
+            "description": "Invoice number already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -196117,6 +197005,13 @@
                     "type": "string",
                     "minLength": 1
                   },
+                  "convertedFromInvoiceId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ],
+                    "minLength": 1
+                  },
                   "issueDate": {
                     "type": "string",
                     "minLength": 1
@@ -197612,6 +198507,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Invoice number already exists",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       },
@@ -200068,6 +200981,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Credit note would exceed the invoice balance due",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -200286,6 +201217,24 @@
                 }
               }
             }
+          },
+          "409": {
+            "description": "Credit note would exceed the invoice balance due",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -202618,7 +203567,7 @@
                       "null"
                     ],
                     "minimum": 0,
-                    "maximum": 10000
+                    "maximum": 100
                   },
                   "description": {
                     "type": [
@@ -202942,7 +203891,7 @@
                       "null"
                     ],
                     "minimum": 0,
-                    "maximum": 10000
+                    "maximum": 100
                   },
                   "description": {
                     "type": [
@@ -208032,18 +208981,36 @@
                               "id": {
                                 "type": "string"
                               },
+                              "source": {
+                                "type": "string",
+                                "enum": [
+                                  "payment",
+                                  "voucher_redemption"
+                                ],
+                                "default": "payment"
+                              },
                               "invoiceId": {
-                                "type": "string"
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
                               },
                               "invoiceNumber": {
-                                "type": "string"
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
                               },
                               "invoiceType": {
-                                "type": "string",
+                                "type": [
+                                  "string",
+                                  "null"
+                                ],
                                 "enum": [
                                   "invoice",
                                   "proforma",
-                                  "credit_note"
+                                  "credit_note",
+                                  null
                                 ]
                               },
                               "status": {
@@ -210407,6 +211374,27 @@
                 }
               }
             }
+          },
+          "422": {
+            "description": "Supplier invoice payable invariant failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       },
@@ -210959,6 +211947,27 @@
                 }
               }
             }
+          },
+          "422": {
+            "description": "Supplier invoice payable invariant failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       },
@@ -211556,7 +212565,7 @@
             }
           },
           "422": {
-            "description": "Edit would over-allocate a surviving whole-invoice allocation (§6.1)",
+            "description": "Supplier invoice payable or allocation invariant failed",
             "content": {
               "application/json": {
                 "schema": {
@@ -212789,6 +213798,27 @@
                 }
               }
             }
+          },
+          "422": {
+            "description": "supplier invoice payable invariant failed",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "error": {
+                      "type": "string"
+                    },
+                    "code": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "error"
+                  ]
+                }
+              }
+            }
           }
         }
       }
@@ -214712,18 +215742,36 @@
                               "id": {
                                 "type": "string"
                               },
+                              "source": {
+                                "type": "string",
+                                "enum": [
+                                  "payment",
+                                  "voucher_redemption"
+                                ],
+                                "default": "payment"
+                              },
                               "invoiceId": {
-                                "type": "string"
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
                               },
                               "invoiceNumber": {
-                                "type": "string"
+                                "type": [
+                                  "string",
+                                  "null"
+                                ]
                               },
                               "invoiceType": {
-                                "type": "string",
+                                "type": [
+                                  "string",
+                                  "null"
+                                ],
                                 "enum": [
                                   "invoice",
                                   "proforma",
-                                  "credit_note"
+                                  "credit_note",
+                                  null
                                 ]
                               },
                               "status": {
@@ -220526,14 +221574,12 @@
                   },
                   "separator": {
                     "type": "string",
-                    "maxLength": 5,
-                    "default": ""
+                    "maxLength": 5
                   },
                   "padLength": {
                     "type": "integer",
                     "minimum": 0,
-                    "maximum": 12,
-                    "default": 4
+                    "maximum": 12
                   },
                   "resetStrategy": {
                     "type": "string",
@@ -220541,8 +221587,7 @@
                       "never",
                       "annual",
                       "monthly"
-                    ],
-                    "default": "never"
+                    ]
                   },
                   "scope": {
                     "type": "string",
@@ -220552,12 +221597,10 @@
                       "partner",
                       "channel",
                       "other"
-                    ],
-                    "default": "customer"
+                    ]
                   },
                   "isDefault": {
-                    "type": "boolean",
-                    "default": false
+                    "type": "boolean"
                   },
                   "externalProvider": {
                     "type": [
@@ -220576,8 +221619,7 @@
                     "maxLength": 100
                   },
                   "active": {
-                    "type": "boolean",
-                    "default": true
+                    "type": "boolean"
                   }
                 }
               }
@@ -276216,6 +277258,1398 @@
           }
         }
       }
+    },
+    "/v1/admin/settings/operator-profile": {
+      "get": {
+        "responses": {
+          "200": {
+            "description": "The operator profile",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "id": {
+                          "type": "string"
+                        },
+                        "name": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "legalName": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "vatId": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "registrationNumber": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "address": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "phone": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "website": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "license": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "licenseAuthority": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "signatoryName": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "signatoryRole": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "createdAt": {
+                          "type": "string"
+                        },
+                        "updatedAt": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "name",
+                        "legalName",
+                        "vatId",
+                        "registrationNumber",
+                        "address",
+                        "phone",
+                        "email",
+                        "website",
+                        "license",
+                        "licenseAuthority",
+                        "signatoryName",
+                        "signatoryRole",
+                        "createdAt",
+                        "updatedAt"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      },
+      "patch": {
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "legalName": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "vatId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "registrationNumber": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "address": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "phone": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "email": {
+                    "anyOf": [
+                      {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "email"
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          ""
+                        ]
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "website": {
+                    "anyOf": [
+                      {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "uri"
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          ""
+                        ]
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "license": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "licenseAuthority": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "signatoryName": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "signatoryRole": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The updated operator profile",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "id": {
+                          "type": "string"
+                        },
+                        "name": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "legalName": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "vatId": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "registrationNumber": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "address": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "phone": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "website": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "license": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "licenseAuthority": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "signatoryName": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "signatoryRole": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "createdAt": {
+                          "type": "string"
+                        },
+                        "updatedAt": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "name",
+                        "legalName",
+                        "vatId",
+                        "registrationNumber",
+                        "address",
+                        "phone",
+                        "email",
+                        "website",
+                        "license",
+                        "licenseAuthority",
+                        "signatoryName",
+                        "signatoryRole",
+                        "createdAt",
+                        "updatedAt"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/admin/settings/operator-payment-instructions": {
+      "get": {
+        "responses": {
+          "200": {
+            "description": "The operator payment instructions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "id": {
+                          "type": "string"
+                        },
+                        "bankTransferBeneficiary": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "iban": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "bank": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "notes": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "createdAt": {
+                          "type": "string"
+                        },
+                        "updatedAt": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "bankTransferBeneficiary",
+                        "iban",
+                        "bank",
+                        "notes",
+                        "createdAt",
+                        "updatedAt"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      },
+      "patch": {
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "bankTransferBeneficiary": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "iban": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "bank": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "notes": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The updated operator payment instructions",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "id": {
+                          "type": "string"
+                        },
+                        "bankTransferBeneficiary": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "iban": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "bank": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "notes": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "createdAt": {
+                          "type": "string"
+                        },
+                        "updatedAt": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "bankTransferBeneficiary",
+                        "iban",
+                        "bank",
+                        "notes",
+                        "createdAt",
+                        "updatedAt"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/admin/settings/operator-payment-defaults": {
+      "get": {
+        "responses": {
+          "200": {
+            "description": "The operator payment defaults",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "id": {
+                          "type": "string"
+                        },
+                        "customerPaymentPolicy": {},
+                        "bookingCheckoutUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "invoicePayUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "createdAt": {
+                          "type": "string"
+                        },
+                        "updatedAt": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "bookingCheckoutUrlTemplate",
+                        "invoicePayUrlTemplate",
+                        "createdAt",
+                        "updatedAt"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      },
+      "patch": {
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "customerPaymentPolicy": {
+                    "type": [
+                      "object",
+                      "null"
+                    ],
+                    "properties": {
+                      "deposit": {
+                        "type": "object",
+                        "properties": {
+                          "kind": {
+                            "type": "string",
+                            "enum": [
+                              "none",
+                              "percent",
+                              "fixed_cents"
+                            ]
+                          },
+                          "percent": {
+                            "type": "number",
+                            "minimum": 0,
+                            "maximum": 100
+                          },
+                          "amountCents": {
+                            "type": "integer",
+                            "minimum": 0
+                          }
+                        },
+                        "required": [
+                          "kind"
+                        ]
+                      },
+                      "minDaysBeforeDepartureForDeposit": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
+                      "balanceDueDaysBeforeDeparture": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
+                      "balanceDueMinDaysFromNow": {
+                        "type": "integer",
+                        "minimum": 0
+                      }
+                    },
+                    "required": [
+                      "deposit",
+                      "minDaysBeforeDepartureForDeposit",
+                      "balanceDueDaysBeforeDeparture",
+                      "balanceDueMinDaysFromNow"
+                    ]
+                  },
+                  "bookingCheckoutUrlTemplate": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "invoicePayUrlTemplate": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The updated operator payment defaults",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "id": {
+                          "type": "string"
+                        },
+                        "customerPaymentPolicy": {},
+                        "bookingCheckoutUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "invoicePayUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "createdAt": {
+                          "type": "string"
+                        },
+                        "updatedAt": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "id",
+                        "bookingCheckoutUrlTemplate",
+                        "invoicePayUrlTemplate",
+                        "createdAt",
+                        "updatedAt"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/public/operator-profile": {
+      "get": {
+        "responses": {
+          "200": {
+            "description": "The public operator profile (null when unset)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "name": {
+                          "type": "string"
+                        },
+                        "legalName": {
+                          "type": "string"
+                        },
+                        "address": {
+                          "type": "string"
+                        },
+                        "phone": {
+                          "type": "string"
+                        },
+                        "email": {
+                          "type": "string"
+                        },
+                        "website": {
+                          "type": "string"
+                        },
+                        "license": {
+                          "type": "string"
+                        },
+                        "licenseAuthority": {
+                          "type": "string"
+                        },
+                        "customerPaymentPolicy": {},
+                        "bookingCheckoutUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "invoicePayUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "legalName",
+                        "address",
+                        "phone",
+                        "email",
+                        "website",
+                        "license",
+                        "licenseAuthority",
+                        "bookingCheckoutUrlTemplate",
+                        "invoicePayUrlTemplate"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/admin/settings/operator": {
+      "get": {
+        "responses": {
+          "200": {
+            "description": "The combined operator settings",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "id": {
+                          "type": "string"
+                        },
+                        "name": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "legalName": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "vatId": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "registrationNumber": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "address": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "phone": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "website": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "license": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "licenseAuthority": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "signatoryName": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "signatoryRole": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "createdAt": {
+                          "type": "string"
+                        },
+                        "updatedAt": {
+                          "type": "string"
+                        },
+                        "bankTransferBeneficiary": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "iban": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "bank": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "notes": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "customerPaymentPolicy": {},
+                        "bookingCheckoutUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "invoicePayUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "bankTransferBeneficiary",
+                        "iban",
+                        "bank",
+                        "notes",
+                        "bookingCheckoutUrlTemplate",
+                        "invoicePayUrlTemplate"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      },
+      "patch": {
+        "requestBody": {
+          "required": true,
+          "content": {
+            "application/json": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "legalName": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "vatId": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "registrationNumber": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "address": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "phone": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "email": {
+                    "anyOf": [
+                      {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "email"
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          ""
+                        ]
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "website": {
+                    "anyOf": [
+                      {
+                        "type": [
+                          "string",
+                          "null"
+                        ],
+                        "format": "uri"
+                      },
+                      {
+                        "type": "string",
+                        "enum": [
+                          ""
+                        ]
+                      },
+                      {
+                        "type": "null"
+                      }
+                    ]
+                  },
+                  "license": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "licenseAuthority": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "signatoryName": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "signatoryRole": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "bankTransferBeneficiary": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "iban": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "bank": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "notes": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "customerPaymentPolicy": {
+                    "type": [
+                      "object",
+                      "null"
+                    ],
+                    "properties": {
+                      "deposit": {
+                        "type": "object",
+                        "properties": {
+                          "kind": {
+                            "type": "string",
+                            "enum": [
+                              "none",
+                              "percent",
+                              "fixed_cents"
+                            ]
+                          },
+                          "percent": {
+                            "type": "number",
+                            "minimum": 0,
+                            "maximum": 100
+                          },
+                          "amountCents": {
+                            "type": "integer",
+                            "minimum": 0
+                          }
+                        },
+                        "required": [
+                          "kind"
+                        ]
+                      },
+                      "minDaysBeforeDepartureForDeposit": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
+                      "balanceDueDaysBeforeDeparture": {
+                        "type": "integer",
+                        "minimum": 0
+                      },
+                      "balanceDueMinDaysFromNow": {
+                        "type": "integer",
+                        "minimum": 0
+                      }
+                    },
+                    "required": [
+                      "deposit",
+                      "minDaysBeforeDepartureForDeposit",
+                      "balanceDueDaysBeforeDeparture",
+                      "balanceDueMinDaysFromNow"
+                    ]
+                  },
+                  "bookingCheckoutUrlTemplate": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "invoicePayUrlTemplate": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "The updated combined operator settings",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "id": {
+                          "type": "string"
+                        },
+                        "name": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "legalName": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "vatId": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "registrationNumber": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "address": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "phone": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "email": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "website": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "license": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "licenseAuthority": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "signatoryName": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "signatoryRole": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "createdAt": {
+                          "type": "string"
+                        },
+                        "updatedAt": {
+                          "type": "string"
+                        },
+                        "bankTransferBeneficiary": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "iban": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "bank": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "notes": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "customerPaymentPolicy": {},
+                        "bookingCheckoutUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "invoicePayUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "bankTransferBeneficiary",
+                        "iban",
+                        "bank",
+                        "notes",
+                        "bookingCheckoutUrlTemplate",
+                        "invoicePayUrlTemplate"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    "/v1/public/settings/operator": {
+      "get": {
+        "responses": {
+          "200": {
+            "description": "The public operator settings (null when unset)",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "object",
+                  "properties": {
+                    "data": {
+                      "type": [
+                        "object",
+                        "null"
+                      ],
+                      "properties": {
+                        "name": {
+                          "type": "string"
+                        },
+                        "legalName": {
+                          "type": "string"
+                        },
+                        "address": {
+                          "type": "string"
+                        },
+                        "phone": {
+                          "type": "string"
+                        },
+                        "email": {
+                          "type": "string"
+                        },
+                        "website": {
+                          "type": "string"
+                        },
+                        "license": {
+                          "type": "string"
+                        },
+                        "licenseAuthority": {
+                          "type": "string"
+                        },
+                        "customerPaymentPolicy": {},
+                        "bookingCheckoutUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        },
+                        "invoicePayUrlTemplate": {
+                          "type": [
+                            "string",
+                            "null"
+                          ]
+                        }
+                      },
+                      "required": [
+                        "name",
+                        "legalName",
+                        "address",
+                        "phone",
+                        "email",
+                        "website",
+                        "license",
+                        "licenseAuthority",
+                        "bookingCheckoutUrlTemplate",
+                        "invoicePayUrlTemplate"
+                      ]
+                    }
+                  },
+                  "required": [
+                    "data"
+                  ]
+                }
+              }
+            }
+          }
+        }
+      }
     }
   },
   "webhooks": {}