{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-public-auction-catalogue-data-schema.json",
  "title": "PublicAuctionCatalogueData",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aura-historia-com-auctions-api-openapi.yml#/components/schemas/PublicAuctionCatalogueData",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "items",
    "pageSize"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/PersonalizedProductListingCollectionDetailsData"
      }
    },
    "pageSize": {
      "type": "integer",
      "format": "int64",
      "minimum": 1,
      "maximum": 100
    },
    "searchAfter": {
      "allOf": [
        {
          "$ref": "#/$defs/PublicAuctionCatalogueCursorData"
        }
      ],
      "description": "Omitted on the terminal page. Send the complete JSON value as the `searchAfter` query parameter."
    }
  },
  "$defs": {
    "AuctionFormatData": {
      "type": "string",
      "enum": [
        "LIVE",
        "TIMED"
      ]
    },
    "AuctionReportedStatusData": {
      "type": "string",
      "enum": [
        "SCHEDULED",
        "IN_PROGRESS",
        "ENDED",
        "POSTPONED",
        "CANCELLED"
      ]
    },
    "AuctionScheduleData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "biddingOpens",
        "liveStarts",
        "lotsBeginClosing",
        "scheduledEnd"
      ],
      "properties": {
        "biddingOpens": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "liveStarts": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "lotsBeginClosing": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "scheduledEnd": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        }
      }
    },
    "AuctionSummaryData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "auctionId",
        "schedule"
      ],
      "description": "Safe current parent Auction presentation included by PostgreSQL full-detail ProductListing reads.",
      "properties": {
        "auctionId": {
          "type": "string",
          "description": "Strict `auc_` UUIDv7 TypeID."
        },
        "name": {
          "allOf": [
            {
              "$ref": "#/$defs/LocalizedTextData"
            }
          ]
        },
        "format": {
          "allOf": [
            {
              "$ref": "#/$defs/AuctionFormatData"
            }
          ]
        },
        "reportedStatus": {
          "allOf": [
            {
              "$ref": "#/$defs/AuctionReportedStatusData"
            }
          ]
        },
        "schedule": {
          "$ref": "#/$defs/AuctionScheduleData"
        }
      }
    },
    "ContentPolicyData": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "decision"
          ],
          "properties": {
            "decision": {
              "type": "string",
              "enum": [
                "ALLOWED"
              ]
            }
          }
        },
        {
          "type": "object",
          "required": [
            "decision",
            "category"
          ],
          "properties": {
            "decision": {
              "type": "string",
              "enum": [
                "REQUIRES_CONSENT"
              ]
            },
            "category": {
              "type": "string",
              "enum": [
                "NAZI_GERMANY"
              ]
            }
          }
        }
      ],
      "description": "Listing-level content decision. This schema is used only when the listing has an assessment."
    },
    "ContentVisibilityUserStateData": {
      "type": "object",
      "description": "Stored viewer preference used when presenting unassessed or sensitive listing content.",
      "required": [
        "showUnassessedOrSensitiveContent"
      ],
      "properties": {
        "showUnassessedOrSensitiveContent": {
          "type": "boolean",
          "description": "Whether unassessed or sensitive content may be shown to this viewer."
        }
      }
    },
    "CurrencyData": {
      "type": "string",
      "enum": [
        "EUR",
        "GBP",
        "USD",
        "AUD",
        "CAD",
        "NZD",
        "CNY",
        "BRL",
        "PLN",
        "TRY",
        "JPY",
        "CZK",
        "RUB",
        "AED",
        "SAR",
        "HKD",
        "SGD",
        "CHF",
        "ZAR",
        "SEK",
        "DKK",
        "NOK",
        "KRW",
        "INR",
        "TWD",
        "HUF",
        "RON",
        "MXN",
        "THB",
        "ARS"
      ],
      "description": "Supported currencies (ISO 4217 codes):\n- EUR: Euro\n- GBP: British Pound\n- USD: US Dollar\n- AUD: Australian Dollar\n- CAD: Canadian Dollar\n- NZD: New Zealand Dollar\n- CNY: Chinese Yuan\n- BRL: Brazilian Real\n- PLN: Polish Złoty\n- TRY: Turkish Lira\n- JPY: Japanese Yen\n- CZK: Czech Koruna\n- RUB: Russian Ruble\n- AED: UAE Dirham\n- SAR: Saudi Riyal\n- HKD: Hong Kong Dollar\n- SGD: Singapore Dollar\n- CHF: Swiss Franc\n- ZAR: South African Rand\n- SEK: Swedish Krona\n- DKK: Danish Krone\n- NOK: Norwegian Krone\n- KRW: South Korean Won\n- INR: Indian Rupee\n- TWD: New Taiwan Dollar\n- HUF: Hungarian Forint\n- RON: Romanian Leu\n- MXN: Mexican Peso\n- THB: Thai Baht\n- ARS: Argentine Peso (2 minor-unit decimal places)\n",
      "default": "EUR"
    },
    "DeliveryAssessmentAttribution": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "provider",
        "attributionUrl"
      ],
      "properties": {
        "provider": {
          "type": "string"
        },
        "attributionUrl": {
          "type": "string"
        }
      },
      "description": "Required attribution of geographic provider evidence behind the assessed destination."
    },
    "DeliveryAssessmentEligibility": {
      "type": "string",
      "enum": [
        "OFFERED",
        "NOT_OFFERED",
        "SUBJECT_TO_CONFIRMATION"
      ],
      "description": "Assessed eligibility. Omitted eligibility means unknown or unasserted; only NOT_OFFERED is an established negative."
    },
    "DeliveryAssessmentExplanationDataCode": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "code"
      ],
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "INCOMPLETE_COVERAGE",
            "UNRESOLVED_TERMS",
            "SHIPPING_UNDETERMINED",
            "NOT_ASSERTED"
          ]
        }
      },
      "description": "INCOMPLETE_COVERAGE means partial coverage neither includes nor excludes the destination or service. UNRESOLVED_TERMS means seller-side origin/class facts, areas or dependencies cannot be interpreted conservatively. SHIPPING_UNDETERMINED means collection depends on undetermined shipping. NOT_ASSERTED means applicable terms assert no eligibility."
    },
    "DeliveryAssessmentExplanationDataQualifyingAmountRequired": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "code",
        "scope"
      ],
      "properties": {
        "code": {
          "type": "string",
          "enum": [
            "QUALIFYING_AMOUNT_REQUIRED"
          ]
        },
        "scope": {
          "type": "string",
          "enum": [
            "ITEM",
            "LOT",
            "SHIPMENT",
            "SELLER_ORDER"
          ]
        }
      },
      "description": "A condition depends on a qualifying amount at this scope, which browsing never supplies."
    },
    "DeliveryAssessmentExplanations": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {
        "oneOf": [
          {
            "$ref": "#/$defs/DeliveryAssessmentExplanationDataQualifyingAmountRequired"
          },
          {
            "$ref": "#/$defs/DeliveryAssessmentExplanationDataCode"
          }
        ]
      },
      "description": "Bounded explanation of an undetermined outcome, derived from the assessment rather than a raw reason trace. Present only when eligibility is omitted."
    },
    "DeliveryAssessmentRequiredInputs": {
      "type": "array",
      "minItems": 1,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "DESTINATION",
          "DESTINATION_COUNTRY",
          "DESTINATION_SUBDIVISION",
          "POSTAL_CODE",
          "QUANTITY",
          "LOTS",
          "SHIPMENTS",
          "SELLER_ORDERS",
          "VARIANT"
        ]
      },
      "description": "Caller-suppliable inputs whose absence leaves eligibility undetermined. Present only when eligibility is omitted."
    },
    "DeliveryAssessmentSummaryData": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "eligibility": {
          "$ref": "#/$defs/DeliveryAssessmentEligibility"
        },
        "requiredInputs": {
          "$ref": "#/$defs/DeliveryAssessmentRequiredInputs"
        },
        "explanations": {
          "$ref": "#/$defs/DeliveryAssessmentExplanations"
        }
      },
      "description": "Assessed collection outcome. Omitted when collection is unasserted. Collection can remain offered when shipping is prohibited."
    },
    "LanguageData": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "fr",
        "es",
        "it",
        "zh",
        "pt",
        "pl",
        "tr",
        "nl",
        "cs",
        "ja",
        "ru",
        "ar"
      ],
      "description": "Supported language codes (ISO 639-1 canonical values):\n- de: German (includes de-DE, de-AT, de-CH, de-LU, de-LI)\n- en: English (includes en-US, en-GB, en-AU, en-CA, en-NZ, and backend-specific accepted alias en_IE)\n- fr: French (includes fr-FR, fr-CA, fr-BE, fr-CH, fr-LU)\n- es: Spanish (includes es-ES, es-MX, es-AR, es-CO, es-CL, es-PE, es-VE)\n- it: Italian (includes it-IT, it-CH)\n- zh: Chinese (Simplified) (includes zh-CN, zh-Hans)\n- pt: Portuguese (includes pt-PT, pt-BR)\n- pl: Polish (includes pl-PL)\n- tr: Turkish (includes tr-TR)\n- nl: Dutch (includes nl-NL, nl-BE)\n- cs: Czech (includes cs-CZ)\n- ja: Japanese (includes ja-JP)\n- ru: Russian (includes ru-RU)\n- ar: Arabic (includes ar-SA, ar-EG, ar-AE)\n\n`de`, `en`, `fr`, `es`, and `it` are fully supported localization/translation-target languages.\n`zh`, `pt`, `pl`, `tr`, `nl`, `cs`, `ja`, `ru`, and `ar` are ingestion-only languages:\nthey can appear in stored/native content and are accepted anywhere `LanguageData` is used,\nbut backend-generated translations and fallback localized strings are not produced in these languages.\n",
      "default": "en"
    },
    "ListingAvailabilityData": {
      "type": "string",
      "enum": [
        "AVAILABLE",
        "IN_STOCK",
        "LIMITED_AVAILABILITY",
        "BACK_ORDER",
        "MADE_TO_ORDER",
        "PRE_ORDER",
        "PRE_SALE",
        "UNAVAILABLE",
        "RESERVED",
        "OUT_OF_STOCK",
        "SOLD_OUT"
      ],
      "description": "Current reliable source assertion of listing purchase availability. Omitted or `null` means Aura has no reliable current assertion."
    },
    "ListingLifecycleData": {
      "type": "string",
      "enum": [
        "ACTIVE",
        "WITHDRAWN"
      ],
      "description": "Source-catalog membership of a ProductListing:\n- ACTIVE: The listing is currently offered by its authoritative source.\n- WITHDRAWN: The listing is retained for history but is no longer offered.\n"
    },
    "ListingShippingPriceData": {
      "oneOf": [
        {
          "$ref": "#/$defs/ListingShippingPriceDataFree"
        },
        {
          "$ref": "#/$defs/ShippingPriceDataFixed"
        },
        {
          "$ref": "#/$defs/ShippingPriceDataFrom"
        },
        {
          "$ref": "#/$defs/ShippingPriceDataEstimatedRange"
        },
        {
          "$ref": "#/$defs/ListingShippingPriceDataExternallyCalculated"
        },
        {
          "$ref": "#/$defs/ListingShippingPriceDataOnRequest"
        }
      ],
      "description": "Every advertised price kind. On-request and externally calculated prices stay explicit; an omitted currency is unasserted."
    },
    "ListingShippingPriceDataExternallyCalculated": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "EXTERNALLY_CALCULATED"
          ]
        },
        "currency": {
          "$ref": "#/$defs/ShippingCurrencyCode"
        }
      }
    },
    "ListingShippingPriceDataFree": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "FREE"
          ]
        },
        "currency": {
          "$ref": "#/$defs/ShippingCurrencyCode"
        }
      }
    },
    "ListingShippingPriceDataOnRequest": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "ON_REQUEST"
          ]
        },
        "currency": {
          "$ref": "#/$defs/ShippingCurrencyCode"
        }
      }
    },
    "ListingShippingSummaryData": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "description": "Bounded destination-independent shipping of a collection item, shared by every viewer. Its size never grows with the advertised policy: it contains no terms, zones, service lists, per-zone conversions or management metadata. Omitted when nothing is asserted or the listing is hidden/withdrawn; omission is not a no-shipping assertion. Current PostgreSQL state is used even when indexed membership lags. Invalid shipping dependencies return 500 SHIPPING_STORAGE_ERROR; unavailable shipping reads return 503 SHIPPING_TEMPORARILY_UNAVAILABLE.",
      "properties": {
        "eligibility": {
          "$ref": "#/$defs/DeliveryAssessmentEligibility"
        },
        "requiredInputs": {
          "$ref": "#/$defs/DeliveryAssessmentRequiredInputs"
        },
        "explanations": {
          "$ref": "#/$defs/DeliveryAssessmentExplanations"
        },
        "collection": {
          "$ref": "#/$defs/DeliveryAssessmentSummaryData"
        }
      }
    },
    "LocalizedTextData": {
      "type": "object",
      "description": "Text content with language information",
      "required": [
        "text",
        "language"
      ],
      "properties": {
        "text": {
          "type": "string",
          "description": "The text content"
        },
        "language": {
          "$ref": "#/$defs/LanguageData"
        }
      }
    },
    "NotificationUserStateData": {
      "type": "object",
      "description": "Unseen notification IDs for this product, ordered newest first.",
      "required": [
        "unseenNotificationIds"
      ],
      "properties": {
        "unseenNotificationIds": {
          "type": "array",
          "description": "Every unseen Notification ID for this product. Empty when none exist.",
          "default": [],
          "items": {
            "type": "string"
          }
        }
      }
    },
    "PersonalizedProductListingCollectionDetailsData": {
      "type": "object",
      "description": "Canonical Product detail in a collection, with optional user-specific state and bounded shipping.",
      "required": [
        "item"
      ],
      "properties": {
        "item": {
          "$ref": "#/$defs/ProductListingCollectionDetailsData"
        },
        "userState": {
          "allOf": [
            {
              "$ref": "#/$defs/ProductListingCollectionUserStateData"
            }
          ],
          "description": "Present only for a valid user or delegated-user bearer token. A delegated token receives only the sections its read scopes permit and no `userState` when none applies."
        }
      }
    },
    "PersonalizedShippingSummaryData": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "description": "Bounded assessment of a collection item for the authenticated owner's selected browsing destination, without echoing it. Omitted when nothing is assessed, no destination is selected, delegated personalization lacks users:read, or the listing is hidden/withdrawn. Owning addresses alone selects none. Authenticated responses are never cached.",
      "properties": {
        "eligibility": {
          "$ref": "#/$defs/DeliveryAssessmentEligibility"
        },
        "requiredInputs": {
          "$ref": "#/$defs/DeliveryAssessmentRequiredInputs"
        },
        "explanations": {
          "$ref": "#/$defs/DeliveryAssessmentExplanations"
        },
        "pricePreview": {
          "$ref": "#/$defs/ShippingPricePreviewData"
        },
        "collection": {
          "$ref": "#/$defs/DeliveryAssessmentSummaryData"
        },
        "attribution": {
          "$ref": "#/$defs/DeliveryAssessmentAttribution"
        },
        "display": {
          "$ref": "#/$defs/ShippingDisplayData"
        }
      }
    },
    "PriceData": {
      "type": "object",
      "description": "Price information with currency",
      "required": [
        "currency",
        "amount"
      ],
      "properties": {
        "currency": {
          "$ref": "#/$defs/CurrencyData"
        },
        "amount": {
          "type": "integer",
          "description": "Price amount in minor currency units (e.g., cents for most supported currencies, whole yen for JPY)",
          "minimum": 0
        }
      }
    },
    "ProductListingCollectionDetailsData": {
      "type": "object",
      "description": "Canonical ProductListing detail inside a collection (watchlist, saved-search matches and auction catalogue). Identical to ProductListingDetailsData except that shipping is the bounded collection summary.",
      "required": [
        "productListingId",
        "eventId",
        "source",
        "sourceListingId",
        "pricing",
        "availability",
        "lifecycle",
        "url",
        "viewUrl",
        "images",
        "auction",
        "lot",
        "created",
        "updated"
      ],
      "properties": {
        "shipping": {
          "$ref": "#/$defs/ListingShippingSummaryData"
        },
        "productListingId": {
          "type": "string"
        },
        "productListingTitleSlugId": {
          "type": "string",
          "minLength": 8,
          "maxLength": 120,
          "pattern": "^[a-z0-9]+(-[a-z0-9]+)*-[0-9a-f]{6}$",
          "description": "Immutable Aura-owned public locator. Omitted when the listing is redacted as hidden."
        },
        "eventId": {
          "type": "string"
        },
        "source": {
          "$ref": "#/$defs/ProductListingSourceData"
        },
        "sourceListingId": {
          "type": "string"
        },
        "productTitle": {
          "allOf": [
            {
              "$ref": "#/$defs/LocalizedTextData"
            }
          ],
          "description": "Original normalized title. Styled letters and digits are presented as ordinary text, emoji and ornamental symbols are removed and truncation ellipses remain stable; titles stored before a normalization change, including legacy trailing whitespace, are presented in current normalized form."
        },
        "productDescription": {
          "allOf": [
            {
              "$ref": "#/$defs/LocalizedTextData"
            }
          ]
        },
        "title": {
          "allOf": [
            {
              "$ref": "#/$defs/LocalizedTextData"
            }
          ]
        },
        "description": {
          "allOf": [
            {
              "$ref": "#/$defs/LocalizedTextData"
            }
          ]
        },
        "pricing": {
          "type": "object",
          "required": [
            "source",
            "display",
            "valuation"
          ],
          "properties": {
            "source": {
              "$ref": "#/$defs/ProductListingPricingData"
            },
            "display": {
              "$ref": "#/$defs/ProductListingPricingData"
            },
            "valuation": {
              "$ref": "#/$defs/ProductListingPricingValuationData"
            }
          }
        },
        "availability": {
          "anyOf": [
            {
              "$ref": "#/$defs/ListingAvailabilityData"
            },
            {
              "type": [
                "object",
                "null"
              ],
              "enum": [
                null
              ]
            }
          ]
        },
        "lifecycle": {
          "$ref": "#/$defs/ListingLifecycleData"
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "viewUrl": {
          "type": "string",
          "format": "uri"
        },
        "images": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/ProductListingImageData"
          }
        },
        "contentPolicy": {
          "anyOf": [
            {
              "$ref": "#/$defs/ContentPolicyData"
            },
            {
              "type": [
                "object",
                "null"
              ],
              "enum": [
                null
              ]
            }
          ]
        },
        "auction": {
          "anyOf": [
            {
              "$ref": "#/$defs/AuctionSummaryData"
            },
            {
              "type": [
                "object",
                "null"
              ],
              "enum": [
                null
              ]
            }
          ],
          "description": "Current parent Auction presentation from the joined PostgreSQL detail read. Null when the listing has no parent Auction."
        },
        "lot": {
          "anyOf": [
            {
              "$ref": "#/$defs/ProductListingLotData"
            },
            {
              "type": [
                "object",
                "null"
              ],
              "enum": [
                null
              ]
            }
          ],
          "description": "Listing-owned lot facts. Null when the listing has no lot facts."
        },
        "created": {
          "type": "string",
          "format": "date-time"
        },
        "updated": {
          "type": "string",
          "format": "date-time",
          "description": "Time of the last committed change to listing-owned state, including enrichment (translations, embedding, geography, shipping summary, content assessment and delivery evidence). Strictly increasing per listing, with each new value at millisecond precision; FX changes and response-time composition do not advance it."
        }
      }
    },
    "ProductListingCollectionUserStateData": {
      "type": "object",
      "description": "ProductListingUserStateData for collection items; `shipping` is the bounded collection summary.",
      "properties": {
        "shipping": {
          "$ref": "#/$defs/PersonalizedShippingSummaryData"
        },
        "watchlist": {
          "$ref": "#/$defs/WatchlistUserStateData"
        },
        "contentVisibility": {
          "$ref": "#/$defs/ContentVisibilityUserStateData"
        },
        "notification": {
          "$ref": "#/$defs/NotificationUserStateData"
        },
        "searchFilter": {
          "$ref": "#/$defs/SearchFilterUserStateData"
        }
      }
    },
    "ProductListingImageData": {
      "type": "object",
      "description": "Product image after viewer-specific presentation.",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri",
          "description": "URL to the product image, or `null` when it is not shown to this viewer."
        }
      }
    },
    "ProductListingLotData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "lotNumber",
        "cataloguePosition",
        "biddingOpens",
        "scheduledCloses",
        "reportedClosedAt"
      ],
      "description": "Listing-owned lot facts. These facts may exist without a parent Auction.",
      "properties": {
        "lotNumber": {
          "type": [
            "string",
            "null"
          ]
        },
        "cataloguePosition": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64",
          "minimum": 1,
          "maximum": 4294967295
        },
        "biddingOpens": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "scheduledCloses": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "reportedClosedAt": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        }
      }
    },
    "ProductListingPriceData": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "type",
            "currency",
            "amount"
          ],
          "additionalProperties": false,
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "MONETARY"
              ]
            },
            "currency": {
              "$ref": "#/$defs/CurrencyData"
            },
            "amount": {
              "type": "integer",
              "minimum": 0
            }
          }
        },
        {
          "type": "object",
          "required": [
            "type"
          ],
          "additionalProperties": false,
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "ON_REQUEST"
              ]
            }
          }
        }
      ]
    },
    "ProductListingPricingData": {
      "type": "object",
      "properties": {
        "price": {
          "allOf": [
            {
              "$ref": "#/$defs/ProductListingPriceData"
            }
          ]
        },
        "priceEstimateMin": {
          "allOf": [
            {
              "$ref": "#/$defs/PriceData"
            }
          ]
        },
        "priceEstimateMax": {
          "allOf": [
            {
              "$ref": "#/$defs/PriceData"
            }
          ]
        }
      }
    },
    "ProductListingPricingValuationData": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "type",
            "fxRateId",
            "capturedAt"
          ],
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "CURRENT"
              ]
            },
            "fxRateId": {
              "type": "string"
            },
            "capturedAt": {
              "type": "string",
              "format": "date-time"
            }
          }
        },
        {
          "type": "object",
          "required": [
            "type",
            "fxRateId",
            "capturedAt",
            "observedAt"
          ],
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "SALE_OBSERVATION"
              ]
            },
            "fxRateId": {
              "type": "string"
            },
            "capturedAt": {
              "type": "string",
              "format": "date-time"
            },
            "observedAt": {
              "type": "string",
              "format": "date-time"
            }
          }
        }
      ]
    },
    "ProductListingSourceData": {
      "type": "object",
      "description": "ListingSource presentation hydrated for a ProductListing response.",
      "required": [
        "listingSourceId",
        "name",
        "slugId"
      ],
      "properties": {
        "listingSourceId": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "slugId": {
          "type": "string"
        }
      }
    },
    "PublicAuctionCatalogueCursorData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "auctionId",
        "cataloguePosition",
        "productListingId"
      ],
      "properties": {
        "auctionId": {
          "type": "string"
        },
        "cataloguePosition": {
          "type": [
            "integer",
            "null"
          ],
          "format": "int64",
          "minimum": 1
        },
        "productListingId": {
          "type": "string"
        }
      }
    },
    "SearchFilterUserStateData": {
      "type": "object",
      "description": "User's saved-search-filter match state for a product.\nWhen `matched` is `true`, at least one of the user's saved search filters matched this product.\n`userSearchFilterId`, `userSearchFilterName`, and `matchFeedback` are only\npresent when `matched` is `true`.\nDefaults to `matched: false` when the user has no saved search filters or none of them matched.\nWhen `hidden` is `true`, the match exceeds the user's monthly search-filter match quota and the\nproduct data is anonymized (valid synthetic object IDs, placeholder title, unknown enums, nulled timestamps).\nOnly matches ranked beyond the quota (by ascending match creation time) are hidden;\nthe first N matches (where N is the user's tier quota) remain fully visible.\n",
      "required": [
        "matched",
        "hidden"
      ],
      "properties": {
        "shippingMatchValuation": {
          "allOf": [
            {
              "$ref": "#/$defs/ShippingMatchValuationData"
            }
          ],
          "description": "Present on saved-filter match listing responses when the match used an explicit FX shipping maximum."
        },
        "matched": {
          "type": "boolean",
          "description": "Whether any of the user's saved search filters matched this product. Defaults to `false`.",
          "default": false
        },
        "hidden": {
          "type": "boolean",
          "description": "Whether this match is hidden because the user has exceeded their monthly search-filter match quota.\nWhen `true`, the product data in the response is anonymized: object-ID fields are replaced with valid synthetic IDs using their documented prefixes,\nthe title becomes a language-specific placeholder, enum fields are set to their unknown variants, optional fields are omitted, and\ntimestamps are set to the Unix epoch.\nDefaults to `false`.\n",
          "default": false
        },
        "userSearchFilterId": {
          "type": "string",
          "description": "The ID of the saved search filter that matched this product.\nPresent only when `matched` is `true`; omitted otherwise.\n"
        },
        "userSearchFilterName": {
          "type": "string",
          "description": "The user-defined name of the saved search filter that matched this product.\nPresent only when `matched` is `true`; omitted otherwise.\n"
        },
        "matchFeedback": {
          "type": "boolean",
          "description": "Optional feedback previously recorded by the authenticated user for this saved-search match.\nPresent only when `matched` is `true` and feedback has been explicitly stored for the match.\n`true` marks the match as relevant, `false` marks it as not relevant.\n"
        }
      }
    },
    "ShippingCurrencyCode": {
      "type": "string",
      "enum": [
        "EUR",
        "GBP",
        "USD",
        "AUD",
        "CAD",
        "NZD",
        "CNY",
        "BRL",
        "PLN",
        "TRY",
        "JPY",
        "CZK",
        "RUB",
        "AED",
        "SAR",
        "HKD",
        "SGD",
        "CHF",
        "ZAR",
        "SEK",
        "DKK",
        "NOK",
        "KRW",
        "INR",
        "TWD",
        "HUF",
        "RON",
        "MXN",
        "THB",
        "ARS"
      ]
    },
    "ShippingDisplayData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "currency",
        "fxRateId",
        "capturedAt"
      ],
      "description": "Valuation of every requested-currency value in this shipping object, from the persisted browsing FX snapshot (pinned for search continuation). Present only when a value was converted; same-currency reads omit it. HalfUp rounding uses currency minor-unit exponents.",
      "properties": {
        "currency": {
          "$ref": "#/$defs/CurrencyData"
        },
        "fxRateId": {
          "type": "string"
        },
        "capturedAt": {
          "type": "string",
          "format": "date-time"
        }
      }
    },
    "ShippingMatchValuationData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "interpretation",
        "fxRateId",
        "capturedAt",
        "maximumPerItem"
      ],
      "description": "Immutable shipping FX evaluation basis, separate from historical sale/asking-price valuation. Later captures, destination edits and filter edits do not rewrite it.",
      "properties": {
        "interpretation": {
          "type": "string",
          "enum": [
            "WHOLE_COUNTRY_PER_ITEM_FX_V1"
          ]
        },
        "fxRateId": {
          "type": "string"
        },
        "capturedAt": {
          "type": "string",
          "format": "date-time"
        },
        "maximumPerItem": {
          "type": "object",
          "additionalProperties": false,
          "required": [
            "amount",
            "currency"
          ],
          "properties": {
            "amount": {
              "type": "integer",
              "format": "int64",
              "minimum": 0,
              "maximum": 9223372036854775807
            },
            "currency": {
              "$ref": "#/$defs/CurrencyData"
            }
          }
        }
      }
    },
    "ShippingMoneyData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "amount_minor",
        "currency"
      ],
      "properties": {
        "amount_minor": {
          "type": "integer",
          "minimum": 0,
          "maximum": 18446744073709551615
        },
        "currency": {
          "$ref": "#/$defs/ShippingCurrencyCode"
        }
      },
      "description": "Advertised amount in currency minor units; never an authorized quote or checkout total."
    },
    "ShippingPriceDataEstimatedRange": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind",
        "minimum",
        "maximum"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "ESTIMATED_RANGE"
          ]
        },
        "minimum": {
          "$ref": "#/$defs/ShippingMoneyData"
        },
        "maximum": {
          "$ref": "#/$defs/ShippingMoneyData"
        }
      }
    },
    "ShippingPriceDataFixed": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind",
        "amount"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "FIXED"
          ]
        },
        "amount": {
          "$ref": "#/$defs/ShippingMoneyData"
        }
      }
    },
    "ShippingPriceDataFrom": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind",
        "amount"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "FROM"
          ]
        },
        "amount": {
          "$ref": "#/$defs/ShippingMoneyData"
        }
      }
    },
    "ShippingPricePreviewData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "service",
        "basis",
        "price"
      ],
      "properties": {
        "service": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "basis": {
          "type": "string",
          "enum": [
            "PER_ITEM",
            "PER_LOT",
            "PER_SHIPMENT",
            "PER_SELLER_ORDER"
          ]
        },
        "price": {
          "$ref": "#/$defs/ListingShippingPriceData"
        }
      },
      "description": "One advertised rate of a service establishing the summarized eligibility in the destination's selected zone, in the requested currency when its amount is convertible. Services with undetermined conditions never supply it. Several candidates are compared only with one basis and exact fixed or known-currency free prices in one currency: the lowest wins, then the first advertised; otherwise it is omitted. It implies no purchase quantity, total, quote or global cheapest rate."
    },
    "WatchlistUserStateData": {
      "type": "object",
      "description": "Watchlist-specific user state for a product",
      "required": [
        "watching",
        "notifications"
      ],
      "properties": {
        "watching": {
          "type": "boolean",
          "description": "Whether the product is on the user's watchlist"
        },
        "notifications": {
          "type": "boolean",
          "description": "Whether notifications are enabled for this watchlist product"
        }
      }
    }
  }
}