Aura Historia · Schema

PersonalizedProductListingDetailsData

Canonical Product detail with optional user-specific state.

CompanyAntiquesMarketplaceSearchSoftware-as-a-Service

Properties

Name Type Description
item object
userState object 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.
View JSON Schema on GitHub

JSON Schema

aura-historia-com-personalized-product-listing-details-data-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-personalized-product-listing-details-data-schema.json",
  "title": "PersonalizedProductListingDetailsData",
  "description": "Canonical Product detail with optional user-specific state.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aura-historia-com-watchlist-api-openapi.yml#/components/schemas/PersonalizedProductListingDetailsData",
  "type": "object",
  "required": [
    "item"
  ],
  "properties": {
    "item": {
      "$ref": "#/$defs/ProductListingDetailsData"
    },
    "userState": {
      "allOf": [
        {
          "$ref": "#/$defs/ProductListingUserStateData"
        }
      ],
      "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."
    }
  },
  "$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."
    },
    "DeliveryAssessmentCharge": {
      "oneOf": [
        {
          "$ref": "#/$defs/ShippingPriceDataFixed"
        },
        {
          "$ref": "#/$defs/ShippingPriceDataFrom"
        },
        {
          "$ref": "#/$defs/ShippingPriceDataEstimatedRange"
        }
      ],
      "description": "Arithmetic advertised charge in source currency for its explicit basis and count; never a quote or landed cost. Omitted unless every count its basis needs is known, so browsing calculates none."
    },
    "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."
    },
    "DeliveryAssessmentGeography": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "referenceRelease"
      ],
      "properties": {
        "referenceRelease": {
          "type": "string",
          "enum": [
            "iso-codes-4.20.1"
          ]
        },
        "country": {
          "type": "string",
          "pattern": "^[A-Z]{2}$"
        },
        "subdivision": {
          "type": "string"
        },
        "postalCode": {
          "type": "string"
        }
      },
      "description": "Minimal effective destination area facts. Absent facts are omitted; no street, coordinates, address identity or provider evidence is returned."
    },
    "DeliveryAssessmentOption": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "service"
      ],
      "properties": {
        "service": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "eligibility": {
          "$ref": "#/$defs/DeliveryAssessmentEligibility"
        },
        "requiredInputs": {
          "$ref": "#/$defs/DeliveryAssessmentRequiredInputs"
        },
        "explanations": {
          "$ref": "#/$defs/DeliveryAssessmentExplanations"
        },
        "rate": {
          "$ref": "#/$defs/ListingShippingRateData"
        },
        "charge": {
          "$ref": "#/$defs/DeliveryAssessmentCharge"
        }
      },
      "description": "A service of the destination's selected zone whose conditions do not definitely exclude it, identified by its code with a copy of its advertised rate. Inputs and explanations cover only its own applicability."
    },
    "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"
    },
    "ListingShippingApplicabilityData": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "class": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "variants": {
          "type": "array",
          "minItems": 1,
          "maxItems": 64,
          "items": {
            "type": "string",
            "minLength": 1,
            "maxLength": 128
          }
        },
        "quantity": {
          "$ref": "#/$defs/ShippingQuantityData"
        },
        "threshold": {
          "$ref": "#/$defs/ShippingThresholdData"
        }
      },
      "description": "Asserted conditions, all of which must hold. Omitted for unconditional rules."
    },
    "ListingShippingCollectionArrangementData": {
      "oneOf": [
        {
          "$ref": "#/$defs/ShippingCollectionArrangementDataByAppointment"
        },
        {
          "$ref": "#/$defs/ShippingCollectionArrangementDataContactToArrange"
        },
        {
          "$ref": "#/$defs/ListingShippingCollectionArrangementDataWindow"
        }
      ]
    },
    "ListingShippingCollectionArrangementDataWindow": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind",
        "duration"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "WINDOW"
          ]
        },
        "duration": {
          "$ref": "#/$defs/ListingShippingTimeData"
        }
      }
    },
    "ListingShippingCollectionData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "dependency"
      ],
      "properties": {
        "applicability": {
          "$ref": "#/$defs/ListingShippingApplicabilityData"
        },
        "dependency": {
          "type": "string",
          "enum": [
            "INDEPENDENT",
            "SHIPPING"
          ]
        },
        "eligibility": {
          "$ref": "#/$defs/DeliveryAssessmentEligibility"
        },
        "arrangement": {
          "$ref": "#/$defs/ListingShippingCollectionArrangementData"
        }
      },
      "description": "Collection sites are never disclosed; a referenced location does not authorize publishing its address."
    },
    "ListingShippingCoverageData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "reference_release",
        "completeness",
        "zones"
      ],
      "properties": {
        "reference_release": {
          "type": "string",
          "enum": [
            "iso-codes-4.20.1"
          ]
        },
        "completeness": {
          "type": "string",
          "enum": [
            "PARTIAL",
            "COMPLETE"
          ]
        },
        "applicability": {
          "$ref": "#/$defs/ListingShippingApplicabilityData"
        },
        "exclusions": {
          "type": "array",
          "minItems": 1,
          "maxItems": 64,
          "items": {
            "$ref": "#/$defs/ShippingAreaData"
          }
        },
        "zones": {
          "type": "array",
          "maxItems": 64,
          "items": {
            "$ref": "#/$defs/ListingShippingZoneData"
          }
        }
      },
      "description": "Exclusions precede zones. The dispatch origin is never disclosed."
    },
    "ListingShippingDetailData": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "description": "Destination-independent shipping of a single listing read, shared by every viewer: the summary fields and effective advertised terms. Terms are omitted when none resolve; the summary then explains why. Omitted when nothing is asserted or the listing is hidden/withdrawn. Display conversion uses persisted browsing FX, never historical sale-observation FX. Missing snapshot or unavailable FX reads return 503; invalid snapshot, missing required quote or overflow return 500. Currency and query predicates isolate anonymous caches; credential-bearing responses and errors remain private, no-store.",
      "properties": {
        "eligibility": {
          "$ref": "#/$defs/DeliveryAssessmentEligibility"
        },
        "requiredInputs": {
          "$ref": "#/$defs/DeliveryAssessmentRequiredInputs"
        },
        "explanations": {
          "$ref": "#/$defs/DeliveryAssessmentExplanations"
        },
        "terms": {
          "$ref": "#/$defs/ListingShippingTermsData"
        },
        "display": {
          "$ref": "#/$defs/ShippingDisplayData"
        }
      }
    },
    "ListingShippingLeadTimesData": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "handling": {
          "$ref": "#/$defs/ListingShippingTimeData"
        },
        "transit": {
          "$ref": "#/$defs/ListingShippingTimeData"
        },
        "total": {
          "$ref": "#/$defs/ListingShippingTimeData"
        }
      },
      "description": "Independent duration assertions; never computed dates."
    },
    "ListingShippingPolicyData": {
      "oneOf": [
        {
          "$ref": "#/$defs/ShippingPolicyDataProhibited"
        },
        {
          "$ref": "#/$defs/ListingShippingPolicyDataCoverage"
        }
      ]
    },
    "ListingShippingPolicyDataCoverage": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "kind",
        "coverage"
      ],
      "properties": {
        "kind": {
          "type": "string",
          "enum": [
            "COVERAGE"
          ]
        },
        "coverage": {
          "$ref": "#/$defs/ListingShippingCoverageData"
        }
      }
    },
    "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"
        }
      }
    },
    "ListingShippingRateData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "price"
      ],
      "properties": {
        "price": {
          "$ref": "#/$defs/ListingShippingPriceData"
        },
        "display_price": {
          "allOf": [
            {
              "$ref": "#/$defs/ListingShippingPriceData"
            }
          ],
          "description": "Requested-currency value of a fixed, from or range amount advertised in another currency; price keeps the source value. Valued by the enclosing display."
        },
        "basis": {
          "type": "string",
          "enum": [
            "PER_ITEM",
            "PER_LOT",
            "PER_SHIPMENT",
            "PER_SELLER_ORDER"
          ]
        },
        "qualifying_scope": {
          "type": "string",
          "enum": [
            "ITEM",
            "LOT",
            "SHIPMENT",
            "SELLER_ORDER"
          ]
        },
        "components": {
          "type": "object",
          "minProperties": 1,
          "additionalProperties": {
            "type": "string",
            "enum": [
              "INCLUDED",
              "EXCLUDED"
            ]
          },
          "description": "Keys: TRANSPORT, PACKING, INSURANCE, HANDLING, INSTALLATION, IMPORT_DUTY, TAX. Absence is no inclusion assertion."
        }
      }
    },
    "ListingShippingServiceData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "code"
      ],
      "properties": {
        "code": {
          "type": "string",
          "minLength": 1,
          "maxLength": 128
        },
        "applicability": {
          "$ref": "#/$defs/ListingShippingApplicabilityData"
        },
        "eligibility": {
          "$ref": "#/$defs/DeliveryAssessmentEligibility"
        },
        "rate": {
          "$ref": "#/$defs/ListingShippingRateData"
        },
        "lead_times": {
          "$ref": "#/$defs/ListingShippingLeadTimesData"
        },
        "features": {
          "type": "array",
          "minItems": 1,
          "uniqueItems": true,
          "items": {
            "type": "string",
            "enum": [
              "TRACKING",
              "INSURED",
              "WHITE_GLOVE",
              "INSTALLATION",
              "PACKING"
            ]
          }
        },
        "arranger": {
          "$ref": "#/$defs/ShippingActorData"
        },
        "performer": {
          "$ref": "#/$defs/ShippingActorData"
        }
      }
    },
    "ListingShippingTermsData": {
      "type": "object",
      "additionalProperties": false,
      "minProperties": 1,
      "properties": {
        "shipping": {
          "$ref": "#/$defs/ListingShippingPolicyData"
        },
        "collection": {
          "$ref": "#/$defs/ListingShippingCollectionData"
        }
      },
      "description": "Public read projection of effective advertised terms. Unlike the strict AdvertisedDeliveryTermsData protocol used by management and imports, it carries no schema marker and omits absent assertions and empty optional collections. This contract supplies no quote."
    },
    "ListingShippingTimeData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "minimum",
        "maximum",
        "unit"
      ],
      "properties": {
        "minimum": {
          "type": "integer",
          "minimum": 0,
          "maximum": 4294967295
        },
        "maximum": {
          "type": "integer",
          "minimum": 0,
          "maximum": 4294967295
        },
        "unit": {
          "type": "string",
          "enum": [
            "HOURS",
            "DAYS",
            "WEEKS"
          ]
        },
        "basis": {
          "type": "string",
          "enum": [
            "CALENDAR",
            "BUSINESS"
          ]
        },
        "trigger": {
          "type": "string",
          "enum": [
            "ORDER",
            "ORDER_CONFIRMATION",
            "PAYMENT",
            "DISPATCH",
            "READY_FOR_COLLECTION"
          ]
        }
      }
    },
    "ListingShippingZoneData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "areas",
        "services"
      ],
      "properties": {
        "areas": {
          "type": "array",
          "minItems": 1,
          "maxItems": 64,
          "items": {
            "$ref": "#/$defs/ShippingAreaData"
          }
        },
        "applicability": {
          "$ref": "#/$defs/ListingShippingApplicabilityData"
        },
        "services": {
          "type": "array",
          "minItems": 1,
          "maxItems": 64,
          "items": {
            "$ref": "#/$defs/ListingShippingServiceData"
          }
        }
      },
      "description": "Zones are ordered; the first matching zone applies and service codes are unique within it."
    },
    "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"
          }
        }
      }
    },
    "PersonalizedShippingDetailData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "destination"
      ],
      "description": "Assessment of a single listing for the authenticated owner's selected browsing destination. Omitted under the same conditions as PersonalizedShippingSummaryData. Destination facts include submitted assertions and compatible permitted unexpired derived evidence. Browsing infers no quantity, variant, shipment/order count or qualifying amount. This enrichment does not filter or reorder results.",
      "properties": {
        "destination": {
          "$ref": "#/$defs/DeliveryAssessmentGeography"
        },
        "attribution": {
          "$ref": "#/$defs/DeliveryAssessmentAttribution"
        },
        "eligibility": {
          "$ref": "#/$defs/DeliveryAssessmentEligibility"
        },
        "requiredInputs": {
          "$ref": "#/$defs/DeliveryAssessmentRequiredInputs"
        },
        "explanations": {
          "$ref": "#/$defs/DeliveryAssessmentExplanations"
        },
        "options": {
          "type": "array",
          "minItems": 1,
          "maxItems": 64,
          "items": {
            "$ref": "#/$defs/DeliveryAssessmentOption"
          }
        },
        "collection": {
          "$ref": "#/$defs/DeliveryAssessmentSummaryData"
        },
        "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
        }
      }
    },
    "ProductListingDetailsData": {
      "type": "object",
      "description": "Canonical ProductListing detail inside a personalized response wrapper.",
      "required": [
        "productListingId",
        "eventId",
        "source",
        "sourceListingId",
        "pricing",
        "availability",
        "lifecycle",
        "url",
        "viewUrl",
        "images",
        "auction",
        "lot",
        "created",
        "updated"
      ],
      "properties": {
        "shipping": {
          "$ref": "#/$defs/ListingShippingDetailData"
        },
        "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/Prod

# --- truncated at 32 KB (54 KB total) ---
# Full source: https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-personalized-product-listing-details-data-schema.json

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/aura-historia-com-personalized-product-listing-details-data"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.