{ "openapi": "3.1.0", "info": { "title": "Voyant Operator API", "version": "0.0.0", "description": "Generated from the composed operator app. Do not edit by hand." }, "servers": [ { "url": "/", "description": "This deployment (same origin)" } ], "components": { "schemas": { "CatalogSearchFilter": { "anyOf": [ { "type": "object", "properties": { "kind": { "type": "string", "enum": ["eq"] }, "field": { "type": "string", "minLength": 1 }, "value": { "anyOf": [ { "type": "string" }, { "type": "number" }, { "type": "boolean" } ] } }, "required": ["kind", "field", "value"] }, { "type": "object", "properties": { "kind": { "type": "string", "enum": ["in"] }, "field": { "type": "string", "minLength": 1 }, "values": { "type": "array", "items": { "anyOf": [ { "type": "string" }, { "type": "number" } ] } } }, "required": ["kind", "field", "values"] }, { "type": "object", "properties": { "kind": { "type": "string", "enum": ["range"] }, "field": { "type": "string", "minLength": 1 }, "gte": { "type": "number" }, "lte": { "type": "number" } }, "required": ["kind", "field"] }, { "type": "object", "properties": { "kind": { "type": "string", "enum": ["and"] }, "clauses": { "type": "array", "items": { "$ref": "#/components/schemas/CatalogSearchFilter" } } }, "required": ["kind", "clauses"] }, { "type": "object", "properties": { "kind": { "type": "string", "enum": ["or"] }, "clauses": { "type": "array", "items": { "$ref": "#/components/schemas/CatalogSearchFilter" } } }, "required": ["kind", "clauses"] } ] } }, "parameters": {} }, "paths": { "/v1/admin/bookings/pricing-preview": { "post": { "requestBody": { "required": true, "description": "Pricing preview selection", "content": { "application/json": { "schema": { "type": "object", "properties": { "productId": { "type": "string", "minLength": 1 }, "optionId": { "type": ["string", "null"] }, "catalogId": { "type": ["string", "null"] } }, "required": ["productId"] } } } }, "responses": { "200": { "description": "A resolved pricing snapshot", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": {}, "additionalProperties": {} } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Pricing unavailable for this selection", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsPricingPreview", "summary": "POST /v1/admin/bookings/pricing-preview", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/aggregates": { "get": { "parameters": [ { "schema": { "type": "string", "format": "date-time" }, "required": false, "name": "from", "in": "query" }, { "schema": { "type": "string", "format": "date-time" }, "required": false, "name": "to", "in": "query" }, { "schema": { "type": ["integer", "null"], "minimum": 0, "maximum": 20, "default": 8 }, "required": false, "name": "upcomingLimit", "in": "query" } ], "responses": { "200": { "description": "Pre-aggregated dashboard metrics", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "total": { "type": "integer" }, "totalPax": { "type": "integer" }, "countsByStatus": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "count": { "type": "integer" } }, "required": ["status", "count"] } }, "monthlyCounts": { "type": "array", "items": { "type": "object", "properties": { "yearMonth": { "type": "string" }, "count": { "type": "integer" } }, "required": ["yearMonth", "count"] } }, "monthlyRevenue": { "type": "array", "items": { "type": "object", "properties": { "yearMonth": { "type": "string" }, "currency": { "type": "string" }, "sellAmountCents": { "type": "integer" } }, "required": ["yearMonth", "currency", "sellAmountCents"] } }, "upcomingDepartures": { "type": "object", "properties": { "count": { "type": "integer" }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": ["string", "null"] }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "sellCurrency": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] } }, "required": [ "id", "bookingNumber", "status", "startDate", "endDate", "pax", "sellCurrency", "sellAmountCents" ] } } }, "required": ["count", "items"] } }, "required": [ "total", "totalPax", "countsByStatus", "monthlyCounts", "monthlyRevenue", "upcomingDepartures" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsAggregates", "summary": "GET /v1/admin/bookings/aggregates", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/overview": { "get": { "parameters": [ { "schema": { "type": "string", "minLength": 1, "maxLength": 50 }, "required": false, "name": "bookingId", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 50 }, "required": false, "name": "bookingNumber", "in": "query" }, { "schema": { "type": "string", "minLength": 1, "maxLength": 50 }, "required": false, "name": "bookingCode", "in": "query" }, { "schema": { "type": "string", "format": "email" }, "required": false, "name": "email", "in": "query" } ], "responses": { "200": { "description": "An internal/admin booking overview", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "bookingId": { "type": "string" }, "bookingNumber": { "type": "string" }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "sellCurrency": { "type": "string" }, "sellAmountCents": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "travelers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "participantType": { "type": "string", "enum": ["traveler", "occupant", "other"] }, "firstName": { "type": "string" }, "lastName": { "type": "string" }, "isPrimary": { "type": "boolean" } }, "required": [ "id", "participantType", "firstName", "lastName", "isPrimary" ] } }, "items": { "type": "array", "items": { "type": "object", "properties": { "id": { "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"] }, "travelerLinks": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "travelerId": { "type": "string" }, "role": { "type": "string", "enum": ["traveler", "occupant", "beneficiary", "other"] }, "isPrimary": { "type": "boolean" } }, "required": ["id", "travelerId", "role", "isPrimary"] } }, "details": {} }, "required": [ "id", "title", "description", "itemType", "status", "serviceDate", "startsAt", "endsAt", "quantity", "sellCurrency", "unitSellAmountCents", "totalSellAmountCents", "costCurrency", "unitCostAmountCents", "totalCostAmountCents", "notes", "productId", "optionId", "optionUnitId", "pricingCategoryId", "travelerLinks" ] } }, "documents": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "travelerId": { "type": ["string", "null"] }, "type": { "type": "string", "enum": ["visa", "insurance", "health", "passport_copy", "other"] }, "fileName": { "type": "string" }, "fileUrl": { "type": "string" } }, "required": ["id", "travelerId", "type", "fileName", "fileUrl"] } }, "fulfillments": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingItemId": { "type": ["string", "null"] }, "travelerId": { "type": ["string", "null"] }, "fulfillmentType": { "type": "string", "enum": [ "service_voucher", "ticket", "pdf", "qr_code", "barcode", "mobile", "other" ] }, "deliveryChannel": { "type": "string", "enum": ["download", "email", "api", "wallet", "other"] }, "status": { "type": "string", "enum": ["pending", "issued", "reissued", "revoked", "failed"] }, "artifactUrl": { "type": ["string", "null"] } }, "required": [ "id", "bookingItemId", "travelerId", "fulfillmentType", "deliveryChannel", "status", "artifactUrl" ] } } }, "required": [ "bookingId", "bookingNumber", "status", "sellCurrency", "sellAmountCents", "startDate", "endDate", "pax", "confirmedAt", "cancelledAt", "completedAt", "travelers", "items", "documents", "fulfillments" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking overview not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsOverview", "summary": "GET /v1/admin/bookings/overview", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/sharing-groups": { "get": { "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "required": true, "name": "slotId", "in": "query" } ], "responses": { "200": { "description": "Sharing groups for a slot", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "label": { "type": "string" }, "occupancy": { "type": "integer" }, "roomTypeId": { "type": ["string", "null"] }, "bookingIds": { "type": "array", "items": { "type": "string" } } }, "required": ["id", "label", "occupancy", "roomTypeId", "bookingIds"] } } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsSharingGroups", "summary": "GET /v1/admin/bookings/sharing-groups", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/sharing-groups/{groupId}/travelers": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "groupId", "in": "path" }, { "schema": { "type": "string", "minLength": 1 }, "required": true, "name": "slotId", "in": "query" } ], "responses": { "200": { "description": "Travelers in a sharing group (PII redacted unless reveal-authorized)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingNumber": { "type": "string" } }, "required": ["id", "bookingId", "bookingNumber"], "additionalProperties": {} } } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsSharingGroupsByGroupIdTravelers", "summary": "GET /v1/admin/bookings/sharing-groups/{groupId}/travelers", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/allocations": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Booking allocations", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": "string" }, "productId": { "type": ["string", "null"] }, "optionId": { "type": ["string", "null"] }, "optionUnitId": { "type": ["string", "null"] }, "pricingCategoryId": { "type": ["string", "null"] }, "availabilitySlotId": { "type": ["string", "null"] }, "quantity": { "type": "integer" }, "allocationType": { "type": "string", "enum": ["unit", "pickup", "resource"] }, "status": { "type": "string", "enum": [ "held", "confirmed", "released", "expired", "cancelled", "fulfilled" ] }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "releasedAt": { "type": ["string", "null"] }, "metadata": { "type": ["object", "null"], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "productId", "optionId", "optionUnitId", "pricingCategoryId", "availabilitySlotId", "quantity", "allocationType", "status", "holdExpiresAt", "confirmedAt", "releasedAt", "metadata", "createdAt", "updatedAt" ] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdAllocations", "summary": "GET /v1/admin/bookings/{id}/allocations", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/activity": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Booking activity log", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "actorId": { "type": ["string", "null"] }, "activityType": { "type": "string", "enum": [ "booking_created", "booking_reserved", "booking_converted", "booking_confirmed", "booking_started", "booking_completed", "hold_extended", "hold_expired", "status_change", "status_overridden", "item_update", "allocation_released", "fulfillment_issued", "fulfillment_updated", "redemption_recorded", "supplier_update", "traveler_update", "note_added", "system_action" ] }, "description": { "type": "string" }, "metadata": { "type": ["object", "null"], "additionalProperties": {} }, "createdAt": { "type": "string" } }, "required": [ "id", "bookingId", "actorId", "activityType", "description", "metadata", "createdAt" ] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdActivity", "summary": "GET /v1/admin/bookings/{id}/activity", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/group": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Shared-room group membership for this booking (or null)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": ["object", "null"], "properties": { "id": { "type": "string" }, "membership": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "bookingId": { "type": "string" } }, "required": ["id", "groupId", "bookingId"], "additionalProperties": {} } }, "required": ["id", "membership"], "additionalProperties": {} } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdGroup", "summary": "GET /v1/admin/bookings/{id}/group", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/expire-stale": { "post": { "requestBody": { "required": false, "description": "Expire-stale cutoff", "content": { "application/json": { "schema": { "type": "object", "properties": { "before": { "type": ["string", "null"], "format": "date-time" }, "note": { "type": ["string", "null"] } } } } } }, "responses": { "200": { "description": "Stale-hold expiry sweep result", "content": { "application/json": { "schema": { "type": "object", "properties": { "expiredIds": { "type": "array", "items": { "type": "string" } }, "count": { "type": "integer" }, "cutoff": { "type": "string" } }, "required": ["expiredIds", "count", "cutoff"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsExpireStale", "summary": "POST /v1/admin/bookings/expire-stale", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/confirm": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": false, "description": "Confirm options", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": ["string", "null"] }, "suppressNotifications": { "type": "boolean" } } } } } }, "responses": { "200": { "description": "The confirmed booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "202": { "description": "approval_required — an action approval was requested", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": {} } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Hold expired / invalid transition / approval idempotency conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdConfirm", "summary": "POST /v1/admin/bookings/{id}/confirm", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/extend-hold": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Hold extension input", "content": { "application/json": { "schema": { "type": "object", "properties": { "holdMinutes": { "type": "integer", "exclusiveMinimum": 0, "maximum": 1440 }, "holdExpiresAt": { "type": ["string", "null"], "format": "date-time" } } } } } }, "responses": { "200": { "description": "The booking with an extended hold", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Hold expired / invalid transition", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdExtendHold", "summary": "POST /v1/admin/bookings/{id}/extend-hold", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/expire": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": false, "description": "Expire options", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": ["string", "null"] } } } } } }, "responses": { "200": { "description": "The expired booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "202": { "description": "approval_required — an action approval was requested", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": {} } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Invalid transition / approval idempotency conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdExpire", "summary": "POST /v1/admin/bookings/{id}/expire", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/cancel": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": false, "description": "Cancel options", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": ["string", "null"] } } } } } }, "responses": { "200": { "description": "The cancelled booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "202": { "description": "approval_required — an action approval was requested", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": {} } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Invalid transition / approval idempotency conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdCancel", "summary": "POST /v1/admin/bookings/{id}/cancel", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/start": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": false, "description": "Start options", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": ["string", "null"] } } } } } }, "responses": { "200": { "description": "The in-progress booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "202": { "description": "approval_required — an action approval was requested", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": {} } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Invalid transition / approval idempotency conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdStart", "summary": "POST /v1/admin/bookings/{id}/start", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/complete": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": false, "description": "Complete options", "content": { "application/json": { "schema": { "type": "object", "properties": { "note": { "type": ["string", "null"] } } } } } }, "responses": { "200": { "description": "The completed booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "202": { "description": "approval_required — an action approval was requested", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": {} } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Invalid transition / approval idempotency conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdComplete", "summary": "POST /v1/admin/bookings/{id}/complete", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/override-status": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Status override input", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 }, "note": { "type": ["string", "null"] }, "suppressNotifications": { "type": "boolean" }, "suppressLifecycleEvents": { "type": "boolean" } }, "required": ["status", "reason"] } } } }, "responses": { "200": { "description": "The booking with overridden status", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "202": { "description": "approval_required — an action approval was requested", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": {} } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Approval idempotency conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdOverrideStatus", "summary": "POST /v1/admin/bookings/{id}/override-status", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/action-ledger": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string", "format": "date-time" }, "required": false, "name": "cursorOccurredAt", "in": "query" }, { "schema": { "type": "string", "minLength": 1 }, "required": false, "name": "cursorId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 199 }, "required": false, "name": "limit", "in": "query" } ], "responses": { "200": { "description": "Booking-scoped action timeline", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "additionalProperties": {} } }, "travelers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "firstName": { "type": ["string", "null"] }, "lastName": { "type": ["string", "null"] } }, "required": ["id", "firstName", "lastName"] } }, "pageInfo": { "type": "object", "properties": { "nextCursor": { "type": ["object", "null"], "properties": { "occurredAt": { "type": "string" }, "id": { "type": "string" } }, "required": ["occurredAt", "id"] } }, "required": ["nextCursor"] } }, "required": ["data", "travelers", "pageInfo"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsByIdActionLedger", "summary": "GET /v1/admin/bookings/{id}/action-ledger", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/action-approvals/{approvalId}/decide": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "approvalId", "in": "path" } ], "requestBody": { "required": true, "description": "Approval decision", "content": { "application/json": { "schema": { "type": "object", "properties": { "status": { "type": "string", "enum": ["approved", "denied"] } }, "required": ["status"] } } } }, "responses": { "200": { "description": "The approval decision result", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "approval": { "type": "object", "additionalProperties": {} }, "decisionAction": { "type": "object", "additionalProperties": {} } }, "required": ["approval", "decisionAction"] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "401": { "description": "Unauthorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Action approval not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Action approval is not a booking status approval / already decided", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "500": { "description": "Unhandled action approval validation failure", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdActionApprovalsByApprovalIdDecide", "summary": "POST /v1/admin/bookings/{id}/action-approvals/{approvalId}/decide", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/travelers": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Booking travelers (PII redacted unless reveal-authorized)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "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" ] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdTravelers", "summary": "GET /v1/admin/bookings/{id}/travelers", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Traveler to create", "content": { "application/json": { "schema": { "type": "object", "properties": { "firstName": { "type": "string", "minLength": 1, "maxLength": 255 }, "lastName": { "type": "string", "minLength": 1, "maxLength": 255 }, "email": { "type": ["string", "null"], "format": "email" }, "phone": { "type": ["string", "null"], "maxLength": 50 }, "preferredLanguage": { "type": ["string", "null"], "maxLength": 35 }, "specialRequests": { "type": ["string", "null"] }, "travelerCategory": { "type": ["string", "null"], "enum": ["adult", "child", "infant", "senior", "other", null] }, "isPrimary": { "type": ["boolean", "null"] }, "notes": { "type": ["string", "null"] } }, "required": ["firstName", "lastName"] } } } }, "responses": { "201": { "description": "The created traveler", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "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" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdTravelers", "summary": "POST /v1/admin/bookings/{id}/travelers", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/travelers/{travelerId}/reveal": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "travelerId", "in": "path" } ], "responses": { "200": { "description": "The traveler with decrypted travel details", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "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" }, "travelDetails": {} }, "required": [ "id", "bookingId", "participantType", "travelerCategory", "firstName", "lastName", "email", "phone", "preferredLanguage", "specialRequests", "isPrimary", "notes", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "500": { "description": "Booking PII encryption is not configured", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsByIdTravelersByTravelerIdReveal", "summary": "GET /v1/admin/bookings/{id}/travelers/{travelerId}/reveal", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/travelers/{travelerId}/travel-details": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "travelerId", "in": "path" } ], "responses": { "200": { "description": "The traveler's decrypted travel details", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": {} } } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Traveler or travel details not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "500": { "description": "Booking PII encryption is not configured", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsByIdTravelersByTravelerIdTravelDetails", "summary": "GET /v1/admin/bookings/{id}/travelers/{travelerId}/travel-details", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "travelerId", "in": "path" } ], "requestBody": { "required": true, "description": "Travel details to upsert", "content": { "application/json": { "schema": { "type": "object", "properties": { "nationality": { "type": ["string", "null"], "maxLength": 100 }, "documentType": { "type": ["string", "null"], "enum": ["passport", "id_card", "driver_license", "visa", "other", null] }, "documentNumber": { "type": ["string", "null"], "maxLength": 255 }, "documentExpiry": { "type": ["string", "null"] }, "documentIssuingCountry": { "type": ["string", "null"], "maxLength": 255 }, "documentIssuingAuthority": { "type": ["string", "null"], "maxLength": 255 }, "documentPersonDocumentId": { "type": ["string", "null"] }, "dateOfBirth": { "type": ["string", "null"] }, "dietaryRequirements": { "type": ["string", "null"] }, "accessibilityNeeds": { "type": ["string", "null"] }, "isLeadTraveler": { "type": ["boolean", "null"] }, "sharingGroupId": { "type": ["string", "null"], "maxLength": 255 }, "roomTypeId": { "type": ["string", "null"], "maxLength": 255 }, "bedPreference": { "type": ["string", "null"], "enum": ["single", "twin", "double", "no-preference", null] }, "allocations": { "type": "object", "additionalProperties": { "type": "string" } } } } } } }, "responses": { "200": { "description": "The upserted travel details", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": {} } } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "500": { "description": "Booking PII encryption is not configured", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "patchAdminBookingsByIdTravelersByTravelerIdTravelDetails", "summary": "PATCH /v1/admin/bookings/{id}/travelers/{travelerId}/travel-details", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "travelerId", "in": "path" } ], "responses": { "200": { "description": "The travel details were deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" } }, "required": ["success"] } } } }, "403": { "description": "Forbidden", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Traveler or travel details not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "500": { "description": "Booking PII encryption is not configured", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "deleteAdminBookingsByIdTravelersByTravelerIdTravelDetails", "summary": "DELETE /v1/admin/bookings/{id}/travelers/{travelerId}/travel-details", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/travelers/with-travel-details": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Traveler with encrypted travel details", "content": { "application/json": { "schema": { "type": "object", "properties": { "personId": { "type": ["string", "null"] }, "participantType": { "type": "string", "enum": ["traveler", "occupant", "other"], "default": "traveler" }, "travelerCategory": { "type": ["string", "null"], "enum": ["adult", "child", "infant", "senior", "other", null] }, "firstName": { "type": "string", "minLength": 1, "maxLength": 255 }, "lastName": { "type": "string", "minLength": 1, "maxLength": 255 }, "email": { "type": ["string", "null"], "format": "email" }, "phone": { "type": ["string", "null"], "maxLength": 50 }, "preferredLanguage": { "type": ["string", "null"], "maxLength": 35 }, "specialRequests": { "type": ["string", "null"] }, "isPrimary": { "type": "boolean", "default": false }, "notes": { "type": ["string", "null"] }, "nationality": { "type": ["string", "null"], "maxLength": 100 }, "documentType": { "type": ["string", "null"], "enum": ["passport", "id_card", "driver_license", "visa", "other", null] }, "documentNumber": { "type": ["string", "null"], "maxLength": 255 }, "documentExpiry": { "type": ["string", "null"] }, "documentIssuingCountry": { "type": ["string", "null"], "maxLength": 255 }, "documentIssuingAuthority": { "type": ["string", "null"], "maxLength": 255 }, "documentPersonDocumentId": { "type": ["string", "null"] }, "dateOfBirth": { "type": ["string", "null"] }, "dietaryRequirements": { "type": ["string", "null"] }, "accessibilityNeeds": { "type": ["string", "null"] }, "isLeadTraveler": { "type": ["boolean", "null"] }, "sharingGroupId": { "type": ["string", "null"], "maxLength": 255 }, "roomTypeId": { "type": ["string", "null"], "maxLength": 255 }, "bedPreference": { "type": ["string", "null"], "enum": ["single", "twin", "double", "no-preference", null] }, "allocations": { "type": "object", "additionalProperties": { "type": "string" } } }, "required": ["firstName", "lastName"] } } } }, "responses": { "201": { "description": "The created traveler with travel details", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": {} } } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "500": { "description": "Booking PII encryption is not configured", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdTravelersWithTravelDetails", "summary": "POST /v1/admin/bookings/{id}/travelers/with-travel-details", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/travelers/{travelerId}/with-travel-details": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "travelerId", "in": "path" } ], "requestBody": { "required": false, "description": "Traveler + travel details update", "content": { "application/json": { "schema": { "type": "object", "properties": { "personId": { "type": ["string", "null"] }, "participantType": { "type": "string", "enum": ["traveler", "occupant", "other"], "default": "traveler" }, "travelerCategory": { "type": ["string", "null"], "enum": ["adult", "child", "infant", "senior", "other", null] }, "firstName": { "type": "string", "minLength": 1, "maxLength": 255 }, "lastName": { "type": "string", "minLength": 1, "maxLength": 255 }, "email": { "type": ["string", "null"], "format": "email" }, "phone": { "type": ["string", "null"], "maxLength": 50 }, "preferredLanguage": { "type": ["string", "null"], "maxLength": 35 }, "specialRequests": { "type": ["string", "null"] }, "isPrimary": { "type": "boolean", "default": false }, "notes": { "type": ["string", "null"] }, "nationality": { "type": ["string", "null"], "maxLength": 100 }, "documentType": { "type": ["string", "null"], "enum": ["passport", "id_card", "driver_license", "visa", "other", null] }, "documentNumber": { "type": ["string", "null"], "maxLength": 255 }, "documentExpiry": { "type": ["string", "null"] }, "documentIssuingCountry": { "type": ["string", "null"], "maxLength": 255 }, "documentIssuingAuthority": { "type": ["string", "null"], "maxLength": 255 }, "documentPersonDocumentId": { "type": ["string", "null"] }, "dateOfBirth": { "type": ["string", "null"] }, "dietaryRequirements": { "type": ["string", "null"] }, "accessibilityNeeds": { "type": ["string", "null"] }, "isLeadTraveler": { "type": ["boolean", "null"] }, "sharingGroupId": { "type": ["string", "null"], "maxLength": 255 }, "roomTypeId": { "type": ["string", "null"], "maxLength": 255 }, "bedPreference": { "type": ["string", "null"], "enum": ["single", "twin", "double", "no-preference", null] }, "allocations": { "type": "object", "additionalProperties": { "type": "string" } } } } } } }, "responses": { "200": { "description": "The updated traveler with travel details", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": {} } } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "500": { "description": "Booking PII encryption is not configured", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "patchAdminBookingsByIdTravelersByTravelerIdWithTravelDetails", "summary": "PATCH /v1/admin/bookings/{id}/travelers/{travelerId}/with-travel-details", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/travelers/{travelerId}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "travelerId", "in": "path" } ], "requestBody": { "required": false, "description": "Partial traveler update", "content": { "application/json": { "schema": { "type": "object", "properties": { "firstName": { "type": "string", "minLength": 1, "maxLength": 255 }, "lastName": { "type": "string", "minLength": 1, "maxLength": 255 }, "email": { "type": ["string", "null"], "format": "email" }, "phone": { "type": ["string", "null"], "maxLength": 50 }, "preferredLanguage": { "type": ["string", "null"], "maxLength": 35 }, "specialRequests": { "type": ["string", "null"] }, "travelerCategory": { "type": ["string", "null"], "enum": ["adult", "child", "infant", "senior", "other", null] }, "isPrimary": { "type": ["boolean", "null"] }, "notes": { "type": ["string", "null"] } } } } } }, "responses": { "200": { "description": "The updated traveler", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "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" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "patchAdminBookingsByIdTravelersByTravelerId", "summary": "PATCH /v1/admin/bookings/{id}/travelers/{travelerId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "travelerId", "in": "path" } ], "responses": { "200": { "description": "The traveler was deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" } }, "required": ["success"] } } } }, "404": { "description": "Traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "deleteAdminBookingsByIdTravelersByTravelerId", "summary": "DELETE /v1/admin/bookings/{id}/travelers/{travelerId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/items": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Booking items", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "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" ] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdItems", "summary": "GET /v1/admin/bookings/{id}/items", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Booking item to add", "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 255 }, "description": { "type": ["string", "null"] }, "itemType": { "type": "string", "enum": [ "unit", "extra", "service", "fee", "tax", "discount", "adjustment", "accommodation", "transport", "other" ], "default": "unit" }, "status": { "type": "string", "enum": ["draft", "on_hold", "confirmed", "cancelled", "expired", "fulfilled"], "default": "draft" }, "serviceDate": { "type": ["string", "null"] }, "startsAt": { "type": ["string", "null"] }, "endsAt": { "type": ["string", "null"] }, "quantity": { "type": "integer", "exclusiveMinimum": 0, "default": 1 }, "sellCurrency": { "type": "string", "minLength": 3, "maxLength": 3 }, "unitSellAmountCents": { "type": ["integer", "null"] }, "totalSellAmountCents": { "type": ["integer", "null"] }, "costCurrency": { "type": ["string", "null"], "minLength": 3, "maxLength": 3 }, "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": {} } }, "required": ["title", "sellCurrency"] } } } }, "responses": { "201": { "description": "The created booking item", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "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" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Booking item mutations are not allowed for this booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdItems", "summary": "POST /v1/admin/bookings/{id}/items", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/items/{itemId}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "itemId", "in": "path" } ], "requestBody": { "required": false, "description": "Partial booking item update", "content": { "application/json": { "schema": { "type": "object", "properties": { "title": { "type": "string", "minLength": 1, "maxLength": 255 }, "description": { "type": ["string", "null"] }, "itemType": { "type": "string", "enum": [ "unit", "extra", "service", "fee", "tax", "discount", "adjustment", "accommodation", "transport", "other" ], "default": "unit" }, "status": { "type": "string", "enum": ["draft", "on_hold", "confirmed", "cancelled", "expired", "fulfilled"], "default": "draft" }, "serviceDate": { "type": ["string", "null"] }, "startsAt": { "type": ["string", "null"] }, "endsAt": { "type": ["string", "null"] }, "quantity": { "type": "integer", "exclusiveMinimum": 0, "default": 1 }, "sellCurrency": { "type": "string", "minLength": 3, "maxLength": 3 }, "unitSellAmountCents": { "type": ["integer", "null"] }, "totalSellAmountCents": { "type": ["integer", "null"] }, "costCurrency": { "type": ["string", "null"], "minLength": 3, "maxLength": 3 }, "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": {} } } } } } }, "responses": { "200": { "description": "The updated booking item", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "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" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input 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"] } } } }, "409": { "description": "Booking item mutations are not allowed for this booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "patchAdminBookingsByIdItemsByItemId", "summary": "PATCH /v1/admin/bookings/{id}/items/{itemId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "itemId", "in": "path" } ], "responses": { "200": { "description": "The booking item was deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" } }, "required": ["success"] } } } }, "404": { "description": "Booking item not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Booking item mutations are not allowed for this booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "deleteAdminBookingsByIdItemsByItemId", "summary": "DELETE /v1/admin/bookings/{id}/items/{itemId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/items/{itemId}/travelers": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "itemId", "in": "path" } ], "responses": { "200": { "description": "Booking item travelers", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingItemId": { "type": "string" }, "travelerId": { "type": "string" }, "role": { "type": "string", "enum": ["traveler", "occupant", "beneficiary", "other"] }, "isPrimary": { "type": "boolean" }, "createdAt": { "type": "string" } }, "required": [ "id", "bookingItemId", "travelerId", "role", "isPrimary", "createdAt" ] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdItemsByItemIdTravelers", "summary": "GET /v1/admin/bookings/{id}/items/{itemId}/travelers", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "itemId", "in": "path" } ], "requestBody": { "required": true, "description": "Traveler to link to item", "content": { "application/json": { "schema": { "type": "object", "properties": { "travelerId": { "type": "string", "minLength": 1 }, "role": { "type": "string", "enum": ["traveler", "occupant", "beneficiary", "other"], "default": "traveler" }, "isPrimary": { "type": "boolean", "default": false } } } } } }, "responses": { "201": { "description": "The created item-traveler link", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingItemId": { "type": "string" }, "travelerId": { "type": "string" }, "role": { "type": "string", "enum": ["traveler", "occupant", "beneficiary", "other"] }, "isPrimary": { "type": "boolean" }, "createdAt": { "type": "string" } }, "required": [ "id", "bookingItemId", "travelerId", "role", "isPrimary", "createdAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking item or traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Booking item mutations are not allowed for this booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdItemsByItemIdTravelers", "summary": "POST /v1/admin/bookings/{id}/items/{itemId}/travelers", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/items/{itemId}/travelers/{linkId}": { "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "itemId", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "linkId", "in": "path" } ], "responses": { "200": { "description": "The item-traveler link was removed", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" } }, "required": ["success"] } } } }, "404": { "description": "Booking item or item-traveler link not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "Booking item mutations are not allowed for this booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "deleteAdminBookingsByIdItemsByItemIdTravelersByLinkId", "summary": "DELETE /v1/admin/bookings/{id}/items/{itemId}/travelers/{linkId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/supplier-statuses": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Booking supplier statuses", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "supplierServiceId": { "type": ["string", "null"] }, "supplierId": { "type": ["string", "null"] }, "serviceName": { "type": "string" }, "status": { "type": "string", "enum": ["pending", "confirmed", "rejected", "cancelled"] }, "supplierReference": { "type": ["string", "null"] }, "costCurrency": { "type": "string" }, "costAmountCents": { "type": "integer" }, "supplierInvoiceLineId": { "type": ["string", "null"] }, "notes": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "supplierServiceId", "supplierId", "serviceName", "status", "supplierReference", "costCurrency", "costAmountCents", "supplierInvoiceLineId", "notes", "confirmedAt", "createdAt", "updatedAt" ] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdSupplierStatuses", "summary": "GET /v1/admin/bookings/{id}/supplier-statuses", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Supplier status to create", "content": { "application/json": { "schema": { "type": "object", "properties": { "supplierServiceId": { "type": ["string", "null"] }, "serviceName": { "type": "string", "minLength": 1, "maxLength": 255 }, "status": { "type": "string", "enum": ["pending", "confirmed", "rejected", "cancelled"], "default": "pending" }, "supplierReference": { "type": ["string", "null"], "maxLength": 255 }, "costCurrency": { "type": "string", "minLength": 3, "maxLength": 3 }, "costAmountCents": { "type": "integer", "minimum": 0 }, "notes": { "type": ["string", "null"] } }, "required": ["serviceName", "costCurrency", "costAmountCents"] } } } }, "responses": { "201": { "description": "The created supplier status", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "supplierServiceId": { "type": ["string", "null"] }, "supplierId": { "type": ["string", "null"] }, "serviceName": { "type": "string" }, "status": { "type": "string", "enum": ["pending", "confirmed", "rejected", "cancelled"] }, "supplierReference": { "type": ["string", "null"] }, "costCurrency": { "type": "string" }, "costAmountCents": { "type": "integer" }, "supplierInvoiceLineId": { "type": ["string", "null"] }, "notes": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "supplierServiceId", "supplierId", "serviceName", "status", "supplierReference", "costCurrency", "costAmountCents", "supplierInvoiceLineId", "notes", "confirmedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdSupplierStatuses", "summary": "POST /v1/admin/bookings/{id}/supplier-statuses", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/supplier-statuses/{statusId}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "statusId", "in": "path" } ], "requestBody": { "required": false, "description": "Partial supplier status update", "content": { "application/json": { "schema": { "type": "object", "properties": { "supplierServiceId": { "type": ["string", "null"] }, "serviceName": { "type": "string", "minLength": 1, "maxLength": 255 }, "status": { "type": "string", "enum": ["pending", "confirmed", "rejected", "cancelled"], "default": "pending" }, "supplierReference": { "type": ["string", "null"], "maxLength": 255 }, "costCurrency": { "type": "string", "minLength": 3, "maxLength": 3 }, "costAmountCents": { "type": "integer", "minimum": 0 }, "notes": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] } } } } } }, "responses": { "200": { "description": "The updated supplier status", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "supplierServiceId": { "type": ["string", "null"] }, "supplierId": { "type": ["string", "null"] }, "serviceName": { "type": "string" }, "status": { "type": "string", "enum": ["pending", "confirmed", "rejected", "cancelled"] }, "supplierReference": { "type": ["string", "null"] }, "costCurrency": { "type": "string" }, "costAmountCents": { "type": "integer" }, "supplierInvoiceLineId": { "type": ["string", "null"] }, "notes": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "supplierServiceId", "supplierId", "serviceName", "status", "supplierReference", "costCurrency", "costAmountCents", "supplierInvoiceLineId", "notes", "confirmedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Supplier status not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "patchAdminBookingsByIdSupplierStatusesByStatusId", "summary": "PATCH /v1/admin/bookings/{id}/supplier-statuses/{statusId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/fulfillments": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Booking fulfillments", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": ["string", "null"] }, "travelerId": { "type": ["string", "null"] }, "fulfillmentType": { "type": "string", "enum": [ "service_voucher", "ticket", "pdf", "qr_code", "barcode", "mobile", "other" ] }, "deliveryChannel": { "type": "string", "enum": ["download", "email", "api", "wallet", "other"] }, "status": { "type": "string", "enum": ["pending", "issued", "reissued", "revoked", "failed"] }, "artifactUrl": { "type": ["string", "null"] }, "payload": { "type": ["object", "null"], "additionalProperties": {} }, "issuedAt": { "type": ["string", "null"] }, "revokedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "travelerId", "fulfillmentType", "deliveryChannel", "status", "artifactUrl", "payload", "issuedAt", "revokedAt", "createdAt", "updatedAt" ] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdFulfillments", "summary": "GET /v1/admin/bookings/{id}/fulfillments", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Fulfillment to issue", "content": { "application/json": { "schema": { "type": "object", "properties": { "bookingItemId": { "type": ["string", "null"] }, "travelerId": { "type": ["string", "null"] }, "fulfillmentType": { "type": "string", "enum": [ "service_voucher", "ticket", "pdf", "qr_code", "barcode", "mobile", "other" ] }, "deliveryChannel": { "type": "string", "enum": ["download", "email", "api", "wallet", "other"] }, "status": { "type": "string", "enum": ["pending", "issued", "reissued", "revoked", "failed"], "default": "issued" }, "artifactUrl": { "type": ["string", "null"], "format": "uri" }, "payload": { "type": ["object", "null"], "additionalProperties": {} }, "issuedAt": { "type": ["string", "null"], "format": "date-time" }, "revokedAt": { "type": ["string", "null"], "format": "date-time" } }, "required": ["fulfillmentType", "deliveryChannel"] } } } }, "responses": { "201": { "description": "The issued fulfillment", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": ["string", "null"] }, "travelerId": { "type": ["string", "null"] }, "fulfillmentType": { "type": "string", "enum": [ "service_voucher", "ticket", "pdf", "qr_code", "barcode", "mobile", "other" ] }, "deliveryChannel": { "type": "string", "enum": ["download", "email", "api", "wallet", "other"] }, "status": { "type": "string", "enum": ["pending", "issued", "reissued", "revoked", "failed"] }, "artifactUrl": { "type": ["string", "null"] }, "payload": { "type": ["object", "null"], "additionalProperties": {} }, "issuedAt": { "type": ["string", "null"] }, "revokedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "travelerId", "fulfillmentType", "deliveryChannel", "status", "artifactUrl", "payload", "issuedAt", "revokedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking, item, or traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdFulfillments", "summary": "POST /v1/admin/bookings/{id}/fulfillments", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/fulfillments/{fulfillmentId}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "fulfillmentId", "in": "path" } ], "requestBody": { "required": false, "description": "Partial fulfillment update", "content": { "application/json": { "schema": { "type": "object", "properties": { "bookingItemId": { "type": ["string", "null"] }, "travelerId": { "type": ["string", "null"] }, "fulfillmentType": { "type": "string", "enum": [ "service_voucher", "ticket", "pdf", "qr_code", "barcode", "mobile", "other" ] }, "deliveryChannel": { "type": "string", "enum": ["download", "email", "api", "wallet", "other"] }, "status": { "type": "string", "enum": ["pending", "issued", "reissued", "revoked", "failed"], "default": "issued" }, "artifactUrl": { "type": ["string", "null"], "format": "uri" }, "payload": { "type": ["object", "null"], "additionalProperties": {} }, "issuedAt": { "type": ["string", "null"], "format": "date-time" }, "revokedAt": { "type": ["string", "null"], "format": "date-time" } } } } } }, "responses": { "200": { "description": "The updated fulfillment", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": ["string", "null"] }, "travelerId": { "type": ["string", "null"] }, "fulfillmentType": { "type": "string", "enum": [ "service_voucher", "ticket", "pdf", "qr_code", "barcode", "mobile", "other" ] }, "deliveryChannel": { "type": "string", "enum": ["download", "email", "api", "wallet", "other"] }, "status": { "type": "string", "enum": ["pending", "issued", "reissued", "revoked", "failed"] }, "artifactUrl": { "type": ["string", "null"] }, "payload": { "type": ["object", "null"], "additionalProperties": {} }, "issuedAt": { "type": ["string", "null"] }, "revokedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "travelerId", "fulfillmentType", "deliveryChannel", "status", "artifactUrl", "payload", "issuedAt", "revokedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Fulfillment, item, or traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "patchAdminBookingsByIdFulfillmentsByFulfillmentId", "summary": "PATCH /v1/admin/bookings/{id}/fulfillments/{fulfillmentId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/redemptions": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Booking redemption events", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": ["string", "null"] }, "travelerId": { "type": ["string", "null"] }, "redeemedAt": { "type": "string" }, "redeemedBy": { "type": ["string", "null"] }, "location": { "type": ["string", "null"] }, "method": { "type": "string", "enum": ["manual", "scan", "api", "other"] }, "metadata": { "type": ["object", "null"], "additionalProperties": {} }, "createdAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "travelerId", "redeemedAt", "redeemedBy", "location", "method", "metadata", "createdAt" ] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdRedemptions", "summary": "GET /v1/admin/bookings/{id}/redemptions", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Redemption to record", "content": { "application/json": { "schema": { "type": "object", "properties": { "bookingItemId": { "type": ["string", "null"] }, "travelerId": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"], "format": "date-time" }, "redeemedBy": { "type": ["string", "null"], "maxLength": 255 }, "location": { "type": ["string", "null"], "maxLength": 500 }, "method": { "type": "string", "enum": ["manual", "scan", "api", "other"], "default": "manual" }, "metadata": { "type": ["object", "null"], "additionalProperties": {} } } } } } }, "responses": { "201": { "description": "The recorded redemption event", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "bookingItemId": { "type": ["string", "null"] }, "travelerId": { "type": ["string", "null"] }, "redeemedAt": { "type": "string" }, "redeemedBy": { "type": ["string", "null"] }, "location": { "type": ["string", "null"] }, "method": { "type": "string", "enum": ["manual", "scan", "api", "other"] }, "metadata": { "type": ["object", "null"], "additionalProperties": {} }, "createdAt": { "type": "string" } }, "required": [ "id", "bookingId", "bookingItemId", "travelerId", "redeemedAt", "redeemedBy", "location", "method", "metadata", "createdAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking, item, or traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdRedemptions", "summary": "POST /v1/admin/bookings/{id}/redemptions", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/notes": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Booking notes", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "authorId": { "type": "string" }, "content": { "type": "string" }, "createdAt": { "type": "string" } }, "required": ["id", "bookingId", "authorId", "content", "createdAt"] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsByIdNotes", "summary": "GET /v1/admin/bookings/{id}/notes", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Note to add", "content": { "application/json": { "schema": { "type": "object", "properties": { "content": { "type": "string", "minLength": 1, "maxLength": 10000 } }, "required": ["content"] } } } }, "responses": { "201": { "description": "The created note", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "authorId": { "type": "string" }, "content": { "type": "string" }, "createdAt": { "type": "string" } }, "required": ["id", "bookingId", "authorId", "content", "createdAt"] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdNotes", "summary": "POST /v1/admin/bookings/{id}/notes", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/notes/{noteId}": { "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "noteId", "in": "path" } ], "requestBody": { "required": true, "description": "Note edit", "content": { "application/json": { "schema": { "type": "object", "properties": { "content": { "type": "string", "minLength": 1, "maxLength": 10000 } }, "required": ["content"] } } } }, "responses": { "200": { "description": "The updated note", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "authorId": { "type": "string" }, "content": { "type": "string" }, "createdAt": { "type": "string" } }, "required": ["id", "bookingId", "authorId", "content", "createdAt"] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Note not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "patchAdminBookingsByIdNotesByNoteId", "summary": "PATCH /v1/admin/bookings/{id}/notes/{noteId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "noteId", "in": "path" } ], "responses": { "200": { "description": "The note was deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" } }, "required": ["success"] } } } }, "404": { "description": "Note not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "deleteAdminBookingsByIdNotesByNoteId", "summary": "DELETE /v1/admin/bookings/{id}/notes/{noteId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/documents": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Booking documents", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "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": ["data"] } } } } }, "operationId": "getAdminBookingsByIdDocuments", "summary": "GET /v1/admin/bookings/{id}/documents", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Document to add", "content": { "application/json": { "schema": { "type": "object", "properties": { "travelerId": { "type": ["string", "null"] }, "type": { "type": "string", "enum": ["visa", "insurance", "health", "passport_copy", "other"] }, "fileName": { "type": "string", "minLength": 1, "maxLength": 500 }, "fileUrl": { "type": "string", "format": "uri" }, "expiresAt": { "type": ["string", "null"] }, "notes": { "type": ["string", "null"] } }, "required": ["type", "fileName", "fileUrl"] } } } }, "responses": { "201": { "description": "The created document", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "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": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByIdDocuments", "summary": "POST /v1/admin/bookings/{id}/documents", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}/documents/{documentId}": { "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "documentId", "in": "path" } ], "responses": { "200": { "description": "The document was deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" } }, "required": ["success"] } } } }, "404": { "description": "Document not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "deleteAdminBookingsByIdDocumentsByDocumentId", "summary": "DELETE /v1/admin/bookings/{id}/documents/{documentId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/groups": { "get": { "parameters": [ { "schema": { "type": "string", "enum": ["shared_room", "cruise_party", "other"] }, "required": false, "name": "kind", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "optionUnitId", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 200, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": ["integer", "null"], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" } ], "responses": { "200": { "description": "Paginated booking groups", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": ["shared_room", "cruise_party", "other"] }, "label": { "type": "string" }, "primaryBookingId": { "type": ["string", "null"] }, "productId": { "type": ["string", "null"] }, "optionUnitId": { "type": ["string", "null"] }, "metadata": { "type": ["object", "null"], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "kind", "label", "primaryBookingId", "productId", "optionUnitId", "metadata", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": ["data", "total", "limit", "offset"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsGroups", "summary": "GET /v1/admin/bookings/groups", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "requestBody": { "required": true, "description": "Booking group", "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string", "enum": ["shared_room", "cruise_party", "other"], "default": "shared_room" }, "label": { "type": "string", "minLength": 1, "maxLength": 500 }, "primaryBookingId": { "type": ["string", "null"] }, "productId": { "type": ["string", "null"] }, "optionUnitId": { "type": ["string", "null"] }, "metadata": { "type": ["object", "null"], "additionalProperties": {} } }, "required": ["label"] } } } }, "responses": { "201": { "description": "The created booking group", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": ["shared_room", "cruise_party", "other"] }, "label": { "type": "string" }, "primaryBookingId": { "type": ["string", "null"] }, "productId": { "type": ["string", "null"] }, "optionUnitId": { "type": ["string", "null"] }, "metadata": { "type": ["object", "null"], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "kind", "label", "primaryBookingId", "productId", "optionUnitId", "metadata", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsGroups", "summary": "POST /v1/admin/bookings/groups", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/groups/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A booking group with its members", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": ["shared_room", "cruise_party", "other"] }, "label": { "type": "string" }, "primaryBookingId": { "type": ["string", "null"] }, "productId": { "type": ["string", "null"] }, "optionUnitId": { "type": ["string", "null"] }, "metadata": { "type": ["object", "null"], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "members": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "bookingId": { "type": "string" }, "role": { "type": "string", "enum": ["primary", "shared"] }, "createdAt": { "type": "string" } }, "required": ["id", "groupId", "bookingId", "role", "createdAt"] } } }, "required": [ "id", "kind", "label", "primaryBookingId", "productId", "optionUnitId", "metadata", "createdAt", "updatedAt", "members" ] } }, "required": ["data"] } } } }, "404": { "description": "Booking group not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsGroupsById", "summary": "GET /v1/admin/bookings/groups/{id}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": false, "description": "Partial booking group update", "content": { "application/json": { "schema": { "type": "object", "properties": { "kind": { "type": "string", "enum": ["shared_room", "cruise_party", "other"], "default": "shared_room" }, "label": { "type": "string", "minLength": 1, "maxLength": 500 }, "primaryBookingId": { "type": ["string", "null"] }, "productId": { "type": ["string", "null"] }, "optionUnitId": { "type": ["string", "null"] }, "metadata": { "type": ["object", "null"], "additionalProperties": {} } } } } } }, "responses": { "200": { "description": "The updated booking group", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "kind": { "type": "string", "enum": ["shared_room", "cruise_party", "other"] }, "label": { "type": "string" }, "primaryBookingId": { "type": ["string", "null"] }, "productId": { "type": ["string", "null"] }, "optionUnitId": { "type": ["string", "null"] }, "metadata": { "type": ["object", "null"], "additionalProperties": {} }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "kind", "label", "primaryBookingId", "productId", "optionUnitId", "metadata", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking group not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "patchAdminBookingsGroupsById", "summary": "PATCH /v1/admin/bookings/groups/{id}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "The booking group was deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" } }, "required": ["success"] } } } }, "404": { "description": "Booking group not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "deleteAdminBookingsGroupsById", "summary": "DELETE /v1/admin/bookings/groups/{id}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/groups/{id}/members": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "The booking group members", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "bookingId": { "type": "string" }, "role": { "type": "string", "enum": ["primary", "shared"] }, "createdAt": { "type": "string" } }, "required": ["id", "groupId", "bookingId", "role", "createdAt"] } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsGroupsByIdMembers", "summary": "GET /v1/admin/bookings/groups/{id}/members", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": true, "description": "Booking group member to add", "content": { "application/json": { "schema": { "type": "object", "properties": { "bookingId": { "type": "string", "minLength": 1 }, "role": { "type": "string", "enum": ["primary", "shared"], "default": "shared" } }, "required": ["bookingId"] } } } }, "responses": { "201": { "description": "The added booking group member", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "groupId": { "type": "string" }, "bookingId": { "type": "string" }, "role": { "type": "string", "enum": ["primary", "shared"] }, "createdAt": { "type": "string" } }, "required": ["id", "groupId", "bookingId", "role", "createdAt"] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking group or booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "409": { "description": "already_in_group — the booking already belongs to a group", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentGroupId": { "type": "string" } }, "required": ["error", "currentGroupId"] } } } } }, "operationId": "postAdminBookingsGroupsByIdMembers", "summary": "POST /v1/admin/bookings/groups/{id}/members", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/groups/{id}/members/{bookingId}": { "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "bookingId", "in": "path" } ], "responses": { "200": { "description": "The membership was removed", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" } }, "required": ["success"] } } } }, "404": { "description": "Membership not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "deleteAdminBookingsGroupsByIdMembersByBookingId", "summary": "DELETE /v1/admin/bookings/groups/{id}/members/{bookingId}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/groups/{id}/travelers": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "Travelers across the group's member bookings", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" } }, "required": ["id", "bookingId"], "additionalProperties": {} } } }, "required": ["data"] } } } } }, "operationId": "getAdminBookingsGroupsByIdTravelers", "summary": "GET /v1/admin/bookings/groups/{id}/travelers", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings": { "get": { "parameters": [ { "schema": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "required": false, "name": "status", "in": "query" }, { "schema": { "anyOf": [ { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, { "type": "array", "items": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] } } ] }, "required": false, "name": "excludeStatuses", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "search", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "optionId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "availabilitySlotId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "supplierId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "productCategoryId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "personId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "organizationId", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "dateFrom", "in": "query" }, { "schema": { "type": "string" }, "required": false, "name": "dateTo", "in": "query" }, { "schema": { "type": ["integer", "null"], "minimum": 0 }, "required": false, "name": "paxMin", "in": "query" }, { "schema": { "type": ["integer", "null"], "minimum": 0 }, "required": false, "name": "paxMax", "in": "query" }, { "schema": { "type": "string", "enum": [ "bookingNumber", "status", "sellAmount", "pax", "startDate", "endDate", "createdAt" ], "default": "createdAt" }, "required": false, "name": "sortBy", "in": "query" }, { "schema": { "type": "string", "enum": ["asc", "desc"], "default": "desc" }, "required": false, "name": "sortDir", "in": "query" }, { "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 }, "required": false, "name": "limit", "in": "query" }, { "schema": { "type": ["integer", "null"], "minimum": 0, "default": 0 }, "required": false, "name": "offset", "in": "query" } ], "responses": { "200": { "description": "Paginated bookings (PII redacted unless reveal-authorized)", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt" ] } }, "total": { "type": "integer" }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": ["data", "total", "limit", "offset"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookings", "summary": "GET /v1/admin/bookings", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{id}": { "get": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "A booking by id with its bookings-owned child collections (items, travelers, documents); PII redacted unless reveal-authorized", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "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": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt", "items", "travelers", "documents" ] } }, "required": ["data"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "getAdminBookingsById", "summary": "GET /v1/admin/bookings/{id}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "patch": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "requestBody": { "required": false, "description": "Partial booking update", "content": { "application/json": { "schema": { "type": "object", "properties": { "bookingNumber": { "type": "string", "minLength": 1, "maxLength": 50 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ], "default": "draft" }, "personId": { "type": ["string", "null"], "pattern": "^pers_[0-9a-hjkmnp-tv-z]{26}$" }, "organizationId": { "type": ["string", "null"], "pattern": "^org_[0-9a-hjkmnp-tv-z]{26}$" }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ], "default": "manual" }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"], "maxLength": 35 }, "contactFirstName": { "type": ["string", "null"], "maxLength": 255 }, "contactLastName": { "type": ["string", "null"], "maxLength": 255 }, "contactPartyType": { "type": ["string", "null"], "enum": ["individual", "company", null] }, "contactTaxId": { "type": ["string", "null"], "maxLength": 100 }, "contactEmail": { "type": ["string", "null"], "format": "email" }, "contactPhone": { "type": ["string", "null"], "maxLength": 50 }, "contactPreferredLanguage": { "type": ["string", "null"], "maxLength": 35 }, "contactCountry": { "type": ["string", "null"], "maxLength": 100 }, "contactRegion": { "type": ["string", "null"], "maxLength": 255 }, "contactCity": { "type": ["string", "null"], "maxLength": 255 }, "contactAddressLine1": { "type": ["string", "null"], "maxLength": 255 }, "contactAddressLine2": { "type": ["string", "null"], "maxLength": 255 }, "contactPostalCode": { "type": ["string", "null"], "maxLength": 50 }, "sellCurrency": { "type": "string", "minLength": 3, "maxLength": 3 }, "baseCurrency": { "type": ["string", "null"], "minLength": 3, "maxLength": 3 }, "sellAmountCents": { "type": ["integer", "null"], "minimum": 0 }, "baseSellAmountCents": { "type": ["integer", "null"], "minimum": 0 }, "costAmountCents": { "type": ["integer", "null"], "minimum": 0 }, "baseCostAmountCents": { "type": ["integer", "null"], "minimum": 0 }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"], "exclusiveMinimum": 0 }, "internalNotes": { "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" ] }, "priceOverride": { "type": ["object", "null"], "properties": { "isManual": { "type": "boolean", "enum": [true] }, "originalAmountCents": { "type": ["integer", "null"], "minimum": 0 }, "overriddenAmountCents": { "type": "integer", "minimum": 0 }, "currency": { "type": "string", "minLength": 3, "maxLength": 3 }, "reason": { "type": "string", "minLength": 1, "maxLength": 1000 }, "overriddenBy": { "type": "string", "minLength": 1 }, "overriddenAt": { "type": "string", "format": "date-time" } }, "required": [ "isManual", "originalAmountCents", "overriddenAmountCents", "currency", "reason", "overriddenBy", "overriddenAt" ] }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"], "format": "date-time" }, "confirmedAt": { "type": ["string", "null"], "format": "date-time" }, "expiredAt": { "type": ["string", "null"], "format": "date-time" }, "cancelledAt": { "type": ["string", "null"], "format": "date-time" }, "completedAt": { "type": ["string", "null"], "format": "date-time" }, "redeemedAt": { "type": ["string", "null"], "format": "date-time" } } } } } }, "responses": { "200": { "description": "The updated booking", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "status": { "type": "string", "enum": [ "draft", "on_hold", "awaiting_payment", "confirmed", "in_progress", "completed", "expired", "cancelled" ] }, "personId": { "type": ["string", "null"] }, "organizationId": { "type": ["string", "null"] }, "sourceType": { "type": "string", "enum": [ "direct", "manual", "affiliate", "ota", "reseller", "api_partner", "internal" ] }, "externalBookingRef": { "type": ["string", "null"] }, "communicationLanguage": { "type": ["string", "null"] }, "contactFirstName": { "type": ["string", "null"] }, "contactLastName": { "type": ["string", "null"] }, "contactPartyType": { "type": ["string", "null"] }, "contactTaxId": { "type": ["string", "null"] }, "contactEmail": { "type": ["string", "null"] }, "contactPhone": { "type": ["string", "null"] }, "contactPreferredLanguage": { "type": ["string", "null"] }, "contactCountry": { "type": ["string", "null"] }, "contactRegion": { "type": ["string", "null"] }, "contactCity": { "type": ["string", "null"] }, "contactAddressLine1": { "type": ["string", "null"] }, "contactAddressLine2": { "type": ["string", "null"] }, "contactPostalCode": { "type": ["string", "null"] }, "sellCurrency": { "type": "string" }, "baseCurrency": { "type": ["string", "null"] }, "fxRateSetId": { "type": ["string", "null"] }, "sellAmountCents": { "type": ["integer", "null"] }, "baseSellAmountCents": { "type": ["integer", "null"] }, "costAmountCents": { "type": ["integer", "null"] }, "baseCostAmountCents": { "type": ["integer", "null"] }, "marginPercent": { "type": ["integer", "null"] }, "startDate": { "type": ["string", "null"] }, "endDate": { "type": ["string", "null"] }, "pax": { "type": ["integer", "null"] }, "internalNotes": { "type": ["string", "null"] }, "customerPaymentPolicy": {}, "priceOverride": { "type": ["object", "null"], "additionalProperties": {} }, "customFields": { "type": "object", "additionalProperties": {} }, "holdExpiresAt": { "type": ["string", "null"] }, "confirmedAt": { "type": ["string", "null"] }, "expiredAt": { "type": ["string", "null"] }, "cancelledAt": { "type": ["string", "null"] }, "completedAt": { "type": ["string", "null"] }, "awaitingPaymentAt": { "type": ["string", "null"] }, "paidAt": { "type": ["string", "null"] }, "redeemedAt": { "type": ["string", "null"] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" } }, "required": [ "id", "bookingNumber", "revision", "status", "personId", "organizationId", "sourceType", "externalBookingRef", "communicationLanguage", "contactFirstName", "contactLastName", "contactPartyType", "contactTaxId", "contactEmail", "contactPhone", "contactPreferredLanguage", "contactCountry", "contactRegion", "contactCity", "contactAddressLine1", "contactAddressLine2", "contactPostalCode", "sellCurrency", "baseCurrency", "fxRateSetId", "sellAmountCents", "baseSellAmountCents", "costAmountCents", "baseCostAmountCents", "marginPercent", "startDate", "endDate", "pax", "internalNotes", "priceOverride", "customFields", "holdExpiresAt", "confirmedAt", "expiredAt", "cancelledAt", "completedAt", "awaitingPaymentAt", "paidAt", "redeemedAt", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request — request input failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "patchAdminBookingsById", "summary": "PATCH /v1/admin/bookings/{id}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" }, "delete": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "id", "in": "path" } ], "responses": { "200": { "description": "The booking was deleted", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" } }, "required": ["success"] } } } }, "404": { "description": "Booking not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "deleteAdminBookingsById", "summary": "DELETE /v1/admin/bookings/{id}", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{bookingId}/rebuild-tax-lines": { "post": { "parameters": [ { "schema": { "type": "string", "minLength": 1 }, "required": true, "name": "bookingId", "in": "path" } ], "responses": { "200": { "description": "Booking item tax lines were rebuilt from catalog snapshots", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "rebuilt": { "type": "number" }, "itemsWithoutSnapshot": { "type": "number" } }, "required": ["rebuilt", "itemsWithoutSnapshot"] } }, "required": ["data"] } } } }, "400": { "description": "invalid_request: route params failed validation", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByBookingIdRebuildTaxLines", "summary": "POST /v1/admin/bookings/{bookingId}/rebuild-tax-lines", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{bookingId}/payment-schedule/regenerate": { "post": { "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "bookingId", "in": "path" } ], "responses": { "200": { "description": "Regenerated payment schedule + resolved booking policy + cascade source", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "schedule": { "type": "array", "items": {} }, "bookingPolicy": { "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" ] }, "cascadeSource": { "type": "string", "enum": ["booking", "listing", "category", "supplier", "operator_default"] } }, "required": ["schedule", "bookingPolicy", "cascadeSource"] } }, "required": ["data"] } } } }, "400": { "description": "Missing booking id or invalid payment-policy override body", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" } }, "required": ["error"] } } } } }, "operationId": "postAdminBookingsByBookingIdPaymentScheduleRegenerate", "summary": "POST /v1/admin/bookings/{bookingId}/payment-schedule/regenerate", "tags": ["bookings"], "x-voyant-module": "bookings", "x-voyant-surface": "admin" } }, "/v1/admin/bookings/{bookingId}/amendments/traveler-corrections/preview": { "post": { "x-voyant-api-id": "@voyant-travel/bookings#api.admin", "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "bookingId", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "travelerId": { "type": "string", "minLength": 1 }, "expectedBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "reason": { "type": "string", "minLength": 1, "maxLength": 2000 }, "patch": { "type": "object", "properties": { "firstName": { "type": "string", "minLength": 1, "maxLength": 255 }, "lastName": { "type": "string", "minLength": 1, "maxLength": 255 }, "email": { "type": ["string", "null"], "format": "email" }, "phone": { "type": ["string", "null"], "maxLength": 50 }, "preferredLanguage": { "type": ["string", "null"], "maxLength": 35 } }, "additionalProperties": false } }, "required": ["travelerId", "expectedBookingRevision", "reason", "patch"] } } } }, "responses": { "200": { "description": "Idempotent or no-op preview", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": ["ok"] }, "amendment": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "travelerId": { "type": "string" }, "kind": { "type": "string", "enum": ["traveler_correction"] }, "status": { "type": "string", "enum": ["proposed", "accepted", "applied", "rejected", "failed"] }, "baseBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "resultBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "acceptanceRequired": { "type": "boolean" }, "policyDecisions": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "version": { "type": "string" }, "decision": { "type": "string", "enum": ["allowed", "acceptance_required"] }, "reason": { "type": "string" } }, "required": ["code", "version", "decision", "reason"] } }, "priceDelta": { "type": "object", "properties": { "amountCents": { "type": "number", "enum": [0] }, "currency": { "type": "string" } }, "required": ["amountCents", "currency"] }, "effects": { "type": "object", "properties": { "finance": { "type": "string", "enum": ["not_required"] }, "legal": { "type": "string", "enum": ["not_required"] }, "documents": { "type": "string", "enum": ["not_required"] }, "fulfillment": { "type": "string", "enum": ["not_required"] }, "supplier": { "type": "string", "enum": ["not_required"] } }, "required": [ "finance", "legal", "documents", "fulfillment", "supplier" ] }, "nextActions": { "type": "array", "items": { "type": "string", "enum": ["accept", "apply"] } }, "requestedBy": { "type": ["string", "null"] }, "requestedActor": { "type": "string", "enum": ["customer", "staff", "partner", "system"] }, "reason": { "type": "string" }, "acceptedAt": { "type": ["string", "null"] }, "acceptedBy": { "type": ["string", "null"] }, "acceptedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "appliedAt": { "type": ["string", "null"] }, "appliedBy": { "type": ["string", "null"] }, "appliedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "revisions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "amendmentId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "role": { "type": "string", "enum": ["before", "proposed_after"] }, "snapshot": { "type": "object", "properties": { "bookingId": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "travelers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "personId": { "type": ["string", "null"] }, "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"] }, "isPrimary": { "type": "boolean" } }, "required": [ "id", "personId", "participantType", "travelerCategory", "firstName", "lastName", "email", "phone", "preferredLanguage", "isPrimary" ] } } }, "required": [ "bookingId", "bookingNumber", "revision", "travelers" ] }, "changedFields": { "type": "array", "items": { "type": "string" } }, "authorizedBy": { "type": ["string", "null"] }, "reason": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "amendmentId", "bookingId", "bookingRevision", "role", "snapshot", "changedFields", "authorizedBy", "reason", "createdAt" ] } } }, "required": [ "id", "bookingId", "travelerId", "kind", "status", "baseBookingRevision", "resultBookingRevision", "acceptanceRequired", "policyDecisions", "priceDelta", "effects", "nextActions", "requestedBy", "requestedActor", "reason", "acceptedAt", "acceptedBy", "acceptedActor", "appliedAt", "appliedBy", "appliedActor", "createdAt", "updatedAt" ] } }, "required": ["status", "amendment"] }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["no_op"] }, "bookingId": { "type": "string" }, "travelerId": { "type": "string" }, "bookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["status", "bookingId", "travelerId", "bookingRevision"] }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["not_found"] } }, "required": ["status"] }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["idempotency_conflict"] } }, "required": ["status"] }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["stale_revision"] }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["status", "currentBookingRevision"] } ] } }, "required": ["data"] } } } }, "201": { "description": "Traveler correction preview", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "oneOf": [ { "type": "object", "properties": { "status": { "type": "string", "enum": ["ok"] }, "amendment": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "travelerId": { "type": "string" }, "kind": { "type": "string", "enum": ["traveler_correction"] }, "status": { "type": "string", "enum": ["proposed", "accepted", "applied", "rejected", "failed"] }, "baseBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "resultBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "acceptanceRequired": { "type": "boolean" }, "policyDecisions": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "version": { "type": "string" }, "decision": { "type": "string", "enum": ["allowed", "acceptance_required"] }, "reason": { "type": "string" } }, "required": ["code", "version", "decision", "reason"] } }, "priceDelta": { "type": "object", "properties": { "amountCents": { "type": "number", "enum": [0] }, "currency": { "type": "string" } }, "required": ["amountCents", "currency"] }, "effects": { "type": "object", "properties": { "finance": { "type": "string", "enum": ["not_required"] }, "legal": { "type": "string", "enum": ["not_required"] }, "documents": { "type": "string", "enum": ["not_required"] }, "fulfillment": { "type": "string", "enum": ["not_required"] }, "supplier": { "type": "string", "enum": ["not_required"] } }, "required": [ "finance", "legal", "documents", "fulfillment", "supplier" ] }, "nextActions": { "type": "array", "items": { "type": "string", "enum": ["accept", "apply"] } }, "requestedBy": { "type": ["string", "null"] }, "requestedActor": { "type": "string", "enum": ["customer", "staff", "partner", "system"] }, "reason": { "type": "string" }, "acceptedAt": { "type": ["string", "null"] }, "acceptedBy": { "type": ["string", "null"] }, "acceptedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "appliedAt": { "type": ["string", "null"] }, "appliedBy": { "type": ["string", "null"] }, "appliedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "revisions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "amendmentId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "role": { "type": "string", "enum": ["before", "proposed_after"] }, "snapshot": { "type": "object", "properties": { "bookingId": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "travelers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "personId": { "type": ["string", "null"] }, "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"] }, "isPrimary": { "type": "boolean" } }, "required": [ "id", "personId", "participantType", "travelerCategory", "firstName", "lastName", "email", "phone", "preferredLanguage", "isPrimary" ] } } }, "required": [ "bookingId", "bookingNumber", "revision", "travelers" ] }, "changedFields": { "type": "array", "items": { "type": "string" } }, "authorizedBy": { "type": ["string", "null"] }, "reason": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "amendmentId", "bookingId", "bookingRevision", "role", "snapshot", "changedFields", "authorizedBy", "reason", "createdAt" ] } } }, "required": [ "id", "bookingId", "travelerId", "kind", "status", "baseBookingRevision", "resultBookingRevision", "acceptanceRequired", "policyDecisions", "priceDelta", "effects", "nextActions", "requestedBy", "requestedActor", "reason", "acceptedAt", "acceptedBy", "acceptedActor", "appliedAt", "appliedBy", "appliedActor", "createdAt", "updatedAt" ] } }, "required": ["status", "amendment"] }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["no_op"] }, "bookingId": { "type": "string" }, "travelerId": { "type": "string" }, "bookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["status", "bookingId", "travelerId", "bookingRevision"] }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["not_found"] } }, "required": ["status"] }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["idempotency_conflict"] } }, "required": ["status"] }, { "type": "object", "properties": { "status": { "type": "string", "enum": ["stale_revision"] }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["status", "currentBookingRevision"] } ] } }, "required": ["data"] } } } }, "400": { "description": "Missing or invalid Idempotency-Key header", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } }, "404": { "description": "Booking or traveler not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } }, "409": { "description": "Revision or idempotency conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } } } } }, "/v1/admin/bookings/{bookingId}/amendments": { "get": { "x-voyant-api-id": "@voyant-travel/bookings#api.admin", "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "bookingId", "in": "path" } ], "responses": { "200": { "description": "Booking Amendment history", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "travelerId": { "type": "string" }, "kind": { "type": "string", "enum": ["traveler_correction"] }, "status": { "type": "string", "enum": ["proposed", "accepted", "applied", "rejected", "failed"] }, "baseBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "resultBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "acceptanceRequired": { "type": "boolean" }, "policyDecisions": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "version": { "type": "string" }, "decision": { "type": "string", "enum": ["allowed", "acceptance_required"] }, "reason": { "type": "string" } }, "required": ["code", "version", "decision", "reason"] } }, "priceDelta": { "type": "object", "properties": { "amountCents": { "type": "number", "enum": [0] }, "currency": { "type": "string" } }, "required": ["amountCents", "currency"] }, "effects": { "type": "object", "properties": { "finance": { "type": "string", "enum": ["not_required"] }, "legal": { "type": "string", "enum": ["not_required"] }, "documents": { "type": "string", "enum": ["not_required"] }, "fulfillment": { "type": "string", "enum": ["not_required"] }, "supplier": { "type": "string", "enum": ["not_required"] } }, "required": ["finance", "legal", "documents", "fulfillment", "supplier"] }, "nextActions": { "type": "array", "items": { "type": "string", "enum": ["accept", "apply"] } }, "requestedBy": { "type": ["string", "null"] }, "requestedActor": { "type": "string", "enum": ["customer", "staff", "partner", "system"] }, "reason": { "type": "string" }, "acceptedAt": { "type": ["string", "null"] }, "acceptedBy": { "type": ["string", "null"] }, "acceptedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "appliedAt": { "type": ["string", "null"] }, "appliedBy": { "type": ["string", "null"] }, "appliedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "revisions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "amendmentId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "role": { "type": "string", "enum": ["before", "proposed_after"] }, "snapshot": { "type": "object", "properties": { "bookingId": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "travelers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "personId": { "type": ["string", "null"] }, "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"] }, "isPrimary": { "type": "boolean" } }, "required": [ "id", "personId", "participantType", "travelerCategory", "firstName", "lastName", "email", "phone", "preferredLanguage", "isPrimary" ] } } }, "required": [ "bookingId", "bookingNumber", "revision", "travelers" ] }, "changedFields": { "type": "array", "items": { "type": "string" } }, "authorizedBy": { "type": ["string", "null"] }, "reason": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "amendmentId", "bookingId", "bookingRevision", "role", "snapshot", "changedFields", "authorizedBy", "reason", "createdAt" ] } } }, "required": [ "id", "bookingId", "travelerId", "kind", "status", "baseBookingRevision", "resultBookingRevision", "acceptanceRequired", "policyDecisions", "priceDelta", "effects", "nextActions", "requestedBy", "requestedActor", "reason", "acceptedAt", "acceptedBy", "acceptedActor", "appliedAt", "appliedBy", "appliedActor", "createdAt", "updatedAt" ] } } }, "required": ["data"] } } } } } } }, "/v1/admin/bookings/{bookingId}/amendments/{amendmentId}": { "get": { "x-voyant-api-id": "@voyant-travel/bookings#api.admin", "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "bookingId", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "amendmentId", "in": "path" } ], "responses": { "200": { "description": "Booking Amendment", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "travelerId": { "type": "string" }, "kind": { "type": "string", "enum": ["traveler_correction"] }, "status": { "type": "string", "enum": ["proposed", "accepted", "applied", "rejected", "failed"] }, "baseBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "resultBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "acceptanceRequired": { "type": "boolean" }, "policyDecisions": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "version": { "type": "string" }, "decision": { "type": "string", "enum": ["allowed", "acceptance_required"] }, "reason": { "type": "string" } }, "required": ["code", "version", "decision", "reason"] } }, "priceDelta": { "type": "object", "properties": { "amountCents": { "type": "number", "enum": [0] }, "currency": { "type": "string" } }, "required": ["amountCents", "currency"] }, "effects": { "type": "object", "properties": { "finance": { "type": "string", "enum": ["not_required"] }, "legal": { "type": "string", "enum": ["not_required"] }, "documents": { "type": "string", "enum": ["not_required"] }, "fulfillment": { "type": "string", "enum": ["not_required"] }, "supplier": { "type": "string", "enum": ["not_required"] } }, "required": ["finance", "legal", "documents", "fulfillment", "supplier"] }, "nextActions": { "type": "array", "items": { "type": "string", "enum": ["accept", "apply"] } }, "requestedBy": { "type": ["string", "null"] }, "requestedActor": { "type": "string", "enum": ["customer", "staff", "partner", "system"] }, "reason": { "type": "string" }, "acceptedAt": { "type": ["string", "null"] }, "acceptedBy": { "type": ["string", "null"] }, "acceptedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "appliedAt": { "type": ["string", "null"] }, "appliedBy": { "type": ["string", "null"] }, "appliedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "revisions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "amendmentId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "role": { "type": "string", "enum": ["before", "proposed_after"] }, "snapshot": { "type": "object", "properties": { "bookingId": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "travelers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "personId": { "type": ["string", "null"] }, "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"] }, "isPrimary": { "type": "boolean" } }, "required": [ "id", "personId", "participantType", "travelerCategory", "firstName", "lastName", "email", "phone", "preferredLanguage", "isPrimary" ] } } }, "required": ["bookingId", "bookingNumber", "revision", "travelers"] }, "changedFields": { "type": "array", "items": { "type": "string" } }, "authorizedBy": { "type": ["string", "null"] }, "reason": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "amendmentId", "bookingId", "bookingRevision", "role", "snapshot", "changedFields", "authorizedBy", "reason", "createdAt" ] } } }, "required": [ "id", "bookingId", "travelerId", "kind", "status", "baseBookingRevision", "resultBookingRevision", "acceptanceRequired", "policyDecisions", "priceDelta", "effects", "nextActions", "requestedBy", "requestedActor", "reason", "acceptedAt", "acceptedBy", "acceptedActor", "appliedAt", "appliedBy", "appliedActor", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "404": { "description": "Booking Amendment not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } } } } }, "/v1/admin/bookings/{bookingId}/amendments/{amendmentId}/accept": { "post": { "x-voyant-api-id": "@voyant-travel/bookings#api.admin", "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "bookingId", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "amendmentId", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "proposedRevisionId": { "type": "string", "minLength": 1 } }, "required": ["proposedRevisionId"] } } } }, "responses": { "200": { "description": "Accepted Booking Amendment", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "travelerId": { "type": "string" }, "kind": { "type": "string", "enum": ["traveler_correction"] }, "status": { "type": "string", "enum": ["proposed", "accepted", "applied", "rejected", "failed"] }, "baseBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "resultBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "acceptanceRequired": { "type": "boolean" }, "policyDecisions": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "version": { "type": "string" }, "decision": { "type": "string", "enum": ["allowed", "acceptance_required"] }, "reason": { "type": "string" } }, "required": ["code", "version", "decision", "reason"] } }, "priceDelta": { "type": "object", "properties": { "amountCents": { "type": "number", "enum": [0] }, "currency": { "type": "string" } }, "required": ["amountCents", "currency"] }, "effects": { "type": "object", "properties": { "finance": { "type": "string", "enum": ["not_required"] }, "legal": { "type": "string", "enum": ["not_required"] }, "documents": { "type": "string", "enum": ["not_required"] }, "fulfillment": { "type": "string", "enum": ["not_required"] }, "supplier": { "type": "string", "enum": ["not_required"] } }, "required": ["finance", "legal", "documents", "fulfillment", "supplier"] }, "nextActions": { "type": "array", "items": { "type": "string", "enum": ["accept", "apply"] } }, "requestedBy": { "type": ["string", "null"] }, "requestedActor": { "type": "string", "enum": ["customer", "staff", "partner", "system"] }, "reason": { "type": "string" }, "acceptedAt": { "type": ["string", "null"] }, "acceptedBy": { "type": ["string", "null"] }, "acceptedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "appliedAt": { "type": ["string", "null"] }, "appliedBy": { "type": ["string", "null"] }, "appliedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "revisions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "amendmentId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "role": { "type": "string", "enum": ["before", "proposed_after"] }, "snapshot": { "type": "object", "properties": { "bookingId": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "travelers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "personId": { "type": ["string", "null"] }, "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"] }, "isPrimary": { "type": "boolean" } }, "required": [ "id", "personId", "participantType", "travelerCategory", "firstName", "lastName", "email", "phone", "preferredLanguage", "isPrimary" ] } } }, "required": ["bookingId", "bookingNumber", "revision", "travelers"] }, "changedFields": { "type": "array", "items": { "type": "string" } }, "authorizedBy": { "type": ["string", "null"] }, "reason": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "amendmentId", "bookingId", "bookingRevision", "role", "snapshot", "changedFields", "authorizedBy", "reason", "createdAt" ] } } }, "required": [ "id", "bookingId", "travelerId", "kind", "status", "baseBookingRevision", "resultBookingRevision", "acceptanceRequired", "policyDecisions", "priceDelta", "effects", "nextActions", "requestedBy", "requestedActor", "reason", "acceptedAt", "acceptedBy", "acceptedActor", "appliedAt", "appliedBy", "appliedActor", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "Missing or invalid Idempotency-Key header", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } }, "404": { "description": "Booking Amendment not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } }, "409": { "description": "Acceptance conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } } } } }, "/v1/admin/bookings/{bookingId}/amendments/{amendmentId}/apply": { "post": { "x-voyant-api-id": "@voyant-travel/bookings#api.admin", "parameters": [ { "schema": { "type": "string" }, "required": true, "name": "bookingId", "in": "path" }, { "schema": { "type": "string" }, "required": true, "name": "amendmentId", "in": "path" } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "expectedBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "proposedRevisionId": { "type": "string", "minLength": 1 } }, "required": ["expectedBookingRevision", "proposedRevisionId"] } } } }, "responses": { "200": { "description": "Applied Booking Amendment", "content": { "application/json": { "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "bookingId": { "type": "string" }, "travelerId": { "type": "string" }, "kind": { "type": "string", "enum": ["traveler_correction"] }, "status": { "type": "string", "enum": ["proposed", "accepted", "applied", "rejected", "failed"] }, "baseBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "resultBookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "acceptanceRequired": { "type": "boolean" }, "policyDecisions": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "version": { "type": "string" }, "decision": { "type": "string", "enum": ["allowed", "acceptance_required"] }, "reason": { "type": "string" } }, "required": ["code", "version", "decision", "reason"] } }, "priceDelta": { "type": "object", "properties": { "amountCents": { "type": "number", "enum": [0] }, "currency": { "type": "string" } }, "required": ["amountCents", "currency"] }, "effects": { "type": "object", "properties": { "finance": { "type": "string", "enum": ["not_required"] }, "legal": { "type": "string", "enum": ["not_required"] }, "documents": { "type": "string", "enum": ["not_required"] }, "fulfillment": { "type": "string", "enum": ["not_required"] }, "supplier": { "type": "string", "enum": ["not_required"] } }, "required": ["finance", "legal", "documents", "fulfillment", "supplier"] }, "nextActions": { "type": "array", "items": { "type": "string", "enum": ["accept", "apply"] } }, "requestedBy": { "type": ["string", "null"] }, "requestedActor": { "type": "string", "enum": ["customer", "staff", "partner", "system"] }, "reason": { "type": "string" }, "acceptedAt": { "type": ["string", "null"] }, "acceptedBy": { "type": ["string", "null"] }, "acceptedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "appliedAt": { "type": ["string", "null"] }, "appliedBy": { "type": ["string", "null"] }, "appliedActor": { "type": ["string", "null"], "enum": ["customer", "staff", "partner", "system", null] }, "createdAt": { "type": "string" }, "updatedAt": { "type": "string" }, "revisions": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "amendmentId": { "type": "string" }, "bookingId": { "type": "string" }, "bookingRevision": { "type": "integer", "exclusiveMinimum": 0 }, "role": { "type": "string", "enum": ["before", "proposed_after"] }, "snapshot": { "type": "object", "properties": { "bookingId": { "type": "string" }, "bookingNumber": { "type": "string" }, "revision": { "type": "integer", "exclusiveMinimum": 0 }, "travelers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "personId": { "type": ["string", "null"] }, "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"] }, "isPrimary": { "type": "boolean" } }, "required": [ "id", "personId", "participantType", "travelerCategory", "firstName", "lastName", "email", "phone", "preferredLanguage", "isPrimary" ] } } }, "required": ["bookingId", "bookingNumber", "revision", "travelers"] }, "changedFields": { "type": "array", "items": { "type": "string" } }, "authorizedBy": { "type": ["string", "null"] }, "reason": { "type": "string" }, "createdAt": { "type": "string" } }, "required": [ "id", "amendmentId", "bookingId", "bookingRevision", "role", "snapshot", "changedFields", "authorizedBy", "reason", "createdAt" ] } } }, "required": [ "id", "bookingId", "travelerId", "kind", "status", "baseBookingRevision", "resultBookingRevision", "acceptanceRequired", "policyDecisions", "priceDelta", "effects", "nextActions", "requestedBy", "requestedActor", "reason", "acceptedAt", "acceptedBy", "acceptedActor", "appliedAt", "appliedBy", "appliedActor", "createdAt", "updatedAt" ] } }, "required": ["data"] } } } }, "400": { "description": "Missing or invalid Idempotency-Key header", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } }, "404": { "description": "Booking Amendment not found", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } }, "409": { "description": "Apply conflict", "content": { "application/json": { "schema": { "type": "object", "properties": { "error": { "type": "string" }, "currentBookingRevision": { "type": "integer", "exclusiveMinimum": 0 } }, "required": ["error"] } } } } } } } }, "webhooks": {} }