Endpoints: 76,849MCP servers: 32,728Payout addresses: 3,825Paid calls: 6,148Letters: 84Defects: 3,890counted 2 min ago
teppi

Server definition

Hash
sha256:531b4fd74c121214acb9c19e576f45045b987438b8fcb96b500c30b953835b5b
What it is
What a remote MCP server returned when asked what it offers: 37 tools

The blob, as servednamed by its sha256

{ "instructions": "Aura Historia is a discovery service, not a seller: each listing, auction and provider belongs to the provider that offers it, and buying, bidding and questions happen on the provider's page. Listing facts are copies of what the provider published; tell people to confirm price and availability there.", "tools": [ { "description": "Add a listing to the signed-in user's watchlist by productListingId so they can follow it and, with notifications on (the default), hear about changes. A listing already on the watchlist returns CONFLICT; subscription tier limits apply.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "notifications": { "description": "Whether to be notified about changes to the listing (default true).", "type": [ "boolean", "null" ] }, "productListingId": { "description": "ID of the listing (`pl_…`) to add.", "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "productListingId" ], "title": "AddInput", "type": "object" }, "name": "addWatchlistProduct", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "created": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "notifications": { "type": "boolean" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "state": { "enum": [ "ACTIVE", "INACTIVE_BY_USER", "INACTIVE_BY_RESTRICTED_PLAN" ], "type": "string" }, "updated": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "userId": { "pattern": "^usr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userId", "productListingId", "notifications", "state" ], "title": "WatchlistEntryData", "type": "object" } }, { "description": "Save a new private address with a label and its location in the signed-in user's address book; Aura Historia resolves the location for shipping estimates. Each call creates a new address, so repeating a call that timed out can create a duplicate.", "inputSchema": { "$defs": { "GeographyData": { "additionalProperties": false, "properties": { "addressText": { "description": "Free-text address; address-book entries require it.", "type": [ "string", "null" ] }, "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": [ "string", "null" ] }, "postalCode": { "description": "Postal code.", "type": [ "string", "null" ] }, "referenceRelease": { "description": "Version of the ISO 3166 code list the codes come from; `iso-codes-4.20.1` is the only accepted value.", "type": "string" }, "subdivision": { "description": "ISO 3166-2 subdivision code.", "type": [ "string", "null" ] } }, "required": [ "referenceRelease" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "geography": { "allOf": [ { "$ref": "#/$defs/GeographyData" }, { "properties": { "addressText": { "description": "Free-text address; required for address-book entries.", "maxLength": 4096, "minLength": 1, "type": "string" } }, "required": [ "addressText" ], "type": "object" } ], "description": "Where the address is: the reference release, the address text (required) and optionally country, subdivision and postal code.", "type": "object" }, "label": { "description": "Name of the address in the address book.", "type": "string" } }, "required": [ "label", "geography" ], "title": "CreateData", "type": "object" }, "name": "createUserAddress", "outputSchema": { "$defs": { "AddressAttributionData": { "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "AddressResolutionData": { "properties": { "attribution": { "anyOf": [ { "$ref": "#/$defs/AddressAttributionData" }, { "type": "null" } ] }, "derived": { "anyOf": [ { "$ref": "#/$defs/DerivedData" }, { "type": "null" } ] }, "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "DerivedData": { "properties": { "geography": { "anyOf": [ { "$ref": "#/$defs/GeographyData" }, { "type": "null" } ] }, "position": { "anyOf": [ { "$ref": "#/$defs/PositionData" }, { "type": "null" } ] } }, "type": "object" }, "GeographyData": { "additionalProperties": false, "properties": { "addressText": { "description": "Free-text address; address-book entries require it.", "type": [ "string", "null" ] }, "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": [ "string", "null" ] }, "postalCode": { "description": "Postal code.", "type": [ "string", "null" ] }, "referenceRelease": { "description": "Version of the ISO 3166 code list the codes come from; `iso-codes-4.20.1` is the only accepted value.", "type": "string" }, "subdivision": { "description": "ISO 3166-2 subdivision code.", "type": [ "string", "null" ] } }, "required": [ "referenceRelease" ], "type": "object" }, "PositionData": { "additionalProperties": false, "properties": { "accuracyMetres": { "format": "double", "type": [ "number", "null" ] }, "latitudeDegrees": { "format": "double", "type": "number" }, "longitudeDegrees": { "format": "double", "type": "number" }, "precision": { "type": "string" } }, "required": [ "latitudeDegrees", "longitudeDegrees", "precision" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "addressId": { "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "geography": { "allOf": [ { "$ref": "#/$defs/GeographyData" }, { "properties": { "addressText": { "description": "Free-text address; required for address-book entries.", "maxLength": 4096, "minLength": 1, "type": "string" } }, "required": [ "addressText" ], "type": "object" } ] }, "inputRevision": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "label": { "type": "string" }, "preferred": { "type": "boolean" }, "resolution": { "$ref": "#/$defs/AddressResolutionData" }, "version": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "addressId", "label", "geography", "inputRevision", "version", "preferred", "resolution" ], "title": "AddressData", "type": "object" } }, { "description": "Save a listing search for the signed-in user. Aura Historia matches new listings against it in the background and, with notifications on (the default), notifies the user, so matches appear later. Subscription tier limits apply. Each call creates a new saved search, so repeating a call that timed out can create a duplicate. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$defs": { "AcceptShippingDestinationData": { "description": "Optional acceptance guard. The submitted country must equal the authorized address or\npreference's asserted country. Neither the reference nor provider evidence is retained.", "oneOf": [ { "additionalProperties": false, "description": "Compare with the country of one of the user's saved addresses.", "properties": { "addressId": { "description": "ID of the saved address (`uaddr_…`).", "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "kind": { "const": "ADDRESS", "description": "Selects this variant; always `ADDRESS` here.", "type": "string" } }, "required": [ "kind", "addressId" ], "type": "object" }, { "additionalProperties": false, "description": "Compare with the country of the user's stored browsing destination.", "properties": { "kind": { "const": "PREFERENCE", "description": "Selects this variant; always `PREFERENCE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "AmountData": { "additionalProperties": false, "properties": { "amount": { "description": "Amount as an integer in the currency's minor unit (EUR cents; JPY whole yen).", "format": "uint64", "maximum": 9223372036854776000, "minimum": 0, "type": "integer" }, "currency": { "description": "ISO 4217 code of the currency the amount is in.", "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "DateRangeSchema": { "properties": { "max": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "End of the range, as an ISO 8601 date-time with offset." }, "min": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "Start of the range, as an ISO 8601 date-time with offset." } }, "type": "object" }, "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No destination country.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "A destination country.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY", "description": "Selects this variant; always `COUNTRY` here.", "type": "string" } }, "required": [ "kind", "country" ], "type": "object" } ] }, "GeographicSearchData": { "additionalProperties": false, "properties": { "countries": { "description": "ISO 3166-1 alpha-2 country codes, at most 100; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" }, "distanceOrder": { "description": "Order results by distance from `origin`, `ASC` (nearest first) or `DESC`; requires `origin`.", "type": [ "string", "null" ] }, "mode": { "description": "Which locations count when measuring distance: `STRICT` (default) only exact premises, `APPROXIMATE` also street, locality and representative points; `APPROXIMATE` needs `origin` with `radius` or `distanceOrder`.", "type": [ "string", "null" ] }, "origin": { "anyOf": [ { "$ref": "#/$defs/OriginData" }, { "type": "null" } ], "description": "Point that `radius` and `distanceOrder` measure from; required by either of them." }, "radius": { "anyOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Distance in `unit`; greater than 0.", "type": "number" }, "unit": { "description": "Unit of `amount`: one of MILES, YARDS, FEET, INCHES, KILOMETERS, METERS, CENTIMETERS, MILLIMETERS, NAUTICAL_MILES.", "type": "string" } }, "required": [ "amount", "unit" ], "type": "object" }, { "type": "null" } ], "description": "Only listings within this distance of `origin`, at most 20,000 km." }, "subdivisions": { "description": "ISO 3166-2 subdivision codes, at most 100, that belong to `countries` when those are given; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "NumberRangeSchema": { "properties": { "max": { "description": "Highest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "min": { "description": "Lowest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "OriginData": { "additionalProperties": false, "properties": { "latitude": { "description": "Latitude in decimal degrees.", "format": "double", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees.", "format": "double", "type": "number" } }, "required": [ "latitude", "longitude" ], "type": "object" }, "ProductListingSearchData": { "properties": { "auctionId": { "description": "Only listings that belong to these auctions, given as auction IDs (`auc_…`).", "items": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "availability": { "anyOf": [ { "items": { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings in one of these exact availability states; combined with `orderability`, a listing must satisfy both." }, "created": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's creation time, as ISO 8601 date-times with offset; both bounds inclusive." }, "currency": { "default": "EUR", "description": "Currency prices are returned in and `price` is interpreted in, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "enhancedSearchDescription": { "description": "Optional natural-language description that refines the ranking of `productQuery` results. Only effective together with `productQuery`; on its own it returns unranked, unrelated results.", "type": [ "string", "null" ] }, "excludeListingSourceId": { "description": "Leave out listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "excludeProductListingId": { "description": "Listing IDs (`pl_…`) to leave out of the results.", "items": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "geography": { "anyOf": [ { "$ref": "#/$defs/GeographicSearchData" }, { "type": "null" } ], "description": "Where listings are located, by country, subdivision or distance from a point; every member given must hold." }, "includeUnspecifiedAvailability": { "description": "Also include listings that state no availability (default false).", "type": [ "boolean", "null" ] }, "language": { "default": "en", "description": "Language of the returned listing text and of the titles `productQuery` is matched against, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "listingSourceId": { "description": "Only listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "lotBiddingOpens": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the time bidding on the lot opens, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "lotScheduledCloses": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the lot's scheduled closing time, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "orderability": { "anyOf": [ { "items": { "enum": [ "ORDERABLE_NOW", "ORDERABLE_CONDITIONALLY", "NOT_ORDERABLE" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings whose availability falls into one of these orderability groups; combined with `availability`, a listing must satisfy both." }, "price": { "anyOf": [ { "$ref": "#/$defs/NumberRangeSchema" }, { "type": "null" } ], "description": "Price range in the request's `currency`, with both bounds inclusive. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "productQuery": { "description": "Keyword phrases matched against listing titles; every word of one phrase must match, and a listing matches when any phrase does.", "items": { "minLength": 1, "type": "string" }, "type": "array" }, "shipping": { "anyOf": [ { "$ref": "#/$defs/ShippingSearchData" }, { "type": "null" } ], "description": "Only listings whose advertised shipping terms meet these conditions for a destination country; every member given must hold." }, "updated": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's last update time, as ISO 8601 date-times with offset; both bounds inclusive." } }, "type": "object" }, "ShippingSearchData": { "additionalProperties": false, "properties": { "collectionOffered": { "description": "Only listings that offer collection in person; the only shipping condition that works without a destination country.", "type": "boolean" }, "destination": { "anyOf": [ { "$ref": "#/$defs/DestinationData" }, { "type": "null" } ], "description": "Country the listing must ship to, as `{\"kind\":\"COUNTRY\",\"country\":\"DE\"}`; `{\"kind\":\"NONE\"}` sets no destination." }, "interpretation": { "description": "`WHOLE_COUNTRY_PER_ITEM_V1` (default) or `WHOLE_COUNTRY_PER_ITEM_FX_V1`, which values `maximumPerItem` in its own currency at the request's exchange rates and requires `maximumPerItem`.", "type": [ "string", "null" ] }, "maximumPerItem": { "anyOf": [ { "$ref": "#/$defs/AmountData" }, { "type": "null" } ], "description": "Highest acceptable shipping price per item, in the amount's own currency; requires a `destination` country. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "referenceRelease": { "description": "Version of the ISO 3166 code list the country code comes from; `iso-codes-4.20.1` is the only accepted value and the default.", "type": [ "string", "null" ] }, "service": { "description": "Shipping service code the terms must include, as free text of at most 128 characters; requires a `destination` country.", "type": [ "string", "null" ] } }, "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "acceptShippingDestination": { "anyOf": [ { "$ref": "#/$defs/AcceptShippingDestinationData" }, { "type": "null" } ], "description": "Optional guard confirming the shipping destination: the filter's shipping country must equal the country of the referenced address or browsing preference." }, "name": { "description": "Name of the saved search, at most 255 characters (longer names are cut off).", "type": "string" }, "notifications": { "default": true, "description": "Whether matches trigger notifications (default true).", "type": "boolean" }, "search": { "$ref": "#/$defs/ProductListingSearchData", "description": "Criteria a listing must meet to match this saved search; the members are those of the listing search.", "type": "object" } }, "required": [ "name", "search" ], "title": "CreateArguments", "type": "object" }, "name": "createUserSearchFilter", "outputSchema": { "$defs": { "AmountData": { "additionalProperties": false, "properties": { "amount": { "description": "Amount as an integer in the currency's minor unit (EUR cents; JPY whole yen).", "format": "uint64", "maximum": 9223372036854776000, "minimum": 0, "type": "integer" }, "currency": { "description": "ISO 4217 code of the currency the amount is in.", "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "DateRangeSchema": { "properties": { "max": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "End of the range, as an ISO 8601 date-time with offset." }, "min": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "Start of the range, as an ISO 8601 date-time with offset." } }, "required": [ "min", "max" ], "type": "object" }, "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No destination country.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "A destination country.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY", "description": "Selects this variant; always `COUNTRY` here.", "type": "string" } }, "required": [ "kind", "country" ], "type": "object" } ] }, "GeographicSearchData": { "additionalProperties": false, "properties": { "countries": { "description": "ISO 3166-1 alpha-2 country codes, at most 100; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" }, "distanceOrder": { "description": "Order results by distance from `origin`, `ASC` (nearest first) or `DESC`; requires `origin`.", "type": [ "string", "null" ] }, "mode": { "description": "Which locations count when measuring distance: `STRICT` (default) only exact premises, `APPROXIMATE` also street, locality and representative points; `APPROXIMATE` needs `origin` with `radius` or `distanceOrder`.", "type": [ "string", "null" ] }, "origin": { "anyOf": [ { "$ref": "#/$defs/OriginData" }, { "type": "null" } ], "description": "Point that `radius` and `distanceOrder` measure from; required by either of them." }, "radius": { "anyOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Distance in `unit`; greater than 0.", "type": "number" }, "unit": { "description": "Unit of `amount`: one of MILES, YARDS, FEET, INCHES, KILOMETERS, METERS, CENTIMETERS, MILLIMETERS, NAUTICAL_MILES.", "type": "string" } }, "required": [ "amount", "unit" ], "type": "object" }, { "type": "null" } ], "description": "Only listings within this distance of `origin`, at most 20,000 km." }, "subdivisions": { "description": "ISO 3166-2 subdivision codes, at most 100, that belong to `countries` when those are given; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "NumberRangeSchema": { "properties": { "max": { "description": "Highest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "min": { "description": "Lowest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "min", "max" ], "type": "object" }, "OriginData": { "additionalProperties": false, "properties": { "latitude": { "description": "Latitude in decimal degrees.", "format": "double", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees.", "format": "double", "type": "number" } }, "required": [ "latitude", "longitude" ], "type": "object" }, "ProductListingSearchData": { "properties": { "auctionId": { "description": "Only listings that belong to these auctions, given as auction IDs (`auc_…`).", "items": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "availability": { "anyOf": [ { "items": { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings in one of these exact availability states; combined with `orderability`, a listing must satisfy both." }, "created": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's creation time, as ISO 8601 date-times with offset; both bounds inclusive." }, "currency": { "default": "EUR", "description": "Currency prices are returned in and `price` is interpreted in, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "enhancedSearchDescription": { "description": "Optional natural-language description that refines the ranking of `productQuery` results. Only effective together with `productQuery`; on its own it returns unranked, unrelated results.", "type": [ "string", "null" ] }, "excludeListingSourceId": { "description": "Leave out listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "excludeProductListingId": { "description": "Listing IDs (`pl_…`) to leave out of the results.", "items": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "geography": { "anyOf": [ { "$ref": "#/$defs/GeographicSearchData" }, { "type": "null" } ], "description": "Where listings are located, by country, subdivision or distance from a point; every member given must hold." }, "includeUnspecifiedAvailability": { "description": "Also include listings that state no availability (default false).", "type": [ "boolean", "null" ] }, "language": { "default": "en", "description": "Language of the returned listing text and of the titles `productQuery` is matched against, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "listingSourceId": { "description": "Only listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "lotBiddingOpens": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the time bidding on the lot opens, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "lotScheduledCloses": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the lot's scheduled closing time, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "orderability": { "anyOf": [ { "items": { "enum": [ "ORDERABLE_NOW", "ORDERABLE_CONDITIONALLY", "NOT_ORDERABLE" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings whose availability falls into one of these orderability groups; combined with `availability`, a listing must satisfy both." }, "price": { "anyOf": [ { "$ref": "#/$defs/NumberRangeSchema" }, { "type": "null" } ], "description": "Price range in the request's `currency`, with both bounds inclusive. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "productQuery": { "description": "Keyword phrases matched against listing titles; every word of one phrase must match, and a listing matches when any phrase does.", "items": { "minLength": 1, "type": "string" }, "type": "array" }, "shipping": { "anyOf": [ { "$ref": "#/$defs/ShippingSearchData" }, { "type": "null" } ], "description": "Only listings whose advertised shipping terms meet these conditions for a destination country; every member given must hold." }, "updated": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's last update time, as ISO 8601 date-times with offset; both bounds inclusive." } }, "required": [ "language", "currency" ], "type": "object" }, "PublicListingSourceData": { "properties": { "image": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] }, "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "listingSourceSlugId": { "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ], "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared." }, "viewLink": { "anyOf": [ { "$ref": "#/$defs/ViewLinkData" }, { "type": "null" } ], "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "listingSourceId", "listingSourceSlugId", "name", "operator" ], "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "ShippingSearchData": { "additionalProperties": false, "properties": { "collectionOffered": { "description": "Only listings that offer collection in person; the only shipping condition that works without a destination country.", "type": "boolean" }, "destination": { "anyOf": [ { "$ref": "#/$defs/DestinationData" }, { "type": "null" } ], "description": "Country the listing must ship to, as `{\"kind\":\"COUNTRY\",\"country\":\"DE\"}`; `{\"kind\":\"NONE\"}` sets no destination." }, "interpretation": { "description": "`WHOLE_COUNTRY_PER_ITEM_V1` (default) or `WHOLE_COUNTRY_PER_ITEM_FX_V1`, which values `maximumPerItem` in its own currency at the request's exchange rates and requires `maximumPerItem`.", "type": [ "string", "null" ] }, "maximumPerItem": { "anyOf": [ { "$ref": "#/$defs/AmountData" }, { "type": "null" } ], "description": "Highest acceptable shipping price per item, in the amount's own currency; requires a `destination` country. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "referenceRelease": { "description": "Version of the ISO 3166 code list the country code comes from; `iso-codes-4.20.1` is the only accepted value and the default.", "type": [ "string", "null" ] }, "service": { "description": "Shipping service code the terms must include, as free text of at most 128 characters; requires a `destination` country.", "type": [ "string", "null" ] } }, "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "created": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "listingSources": { "description": "Public cards of the ListingSources that `search.listingSourceId` and `search.excludeListingSourceId` reference, one per ID, ordered by `listingSourceId`. A source referenced by both lists appears once. An ID whose source no longer exists stays in `search` but has no card. Read-only.", "items": { "$ref": "#/$defs/PublicListingSourceData" }, "type": "array" }, "name": { "type": "string" }, "notifications": { "type": "boolean" }, "search": { "$ref": "#/$defs/ProductListingSearchData" }, "state": { "enum": [ "ACTIVE", "INACTIVE_BY_USER", "INACTIVE_BY_RESTRICTED_PLAN" ], "type": "string" }, "updated": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "userId": { "pattern": "^usr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "userSearchFilterId": { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userId", "userSearchFilterId", "name", "notifications", "state", "search", "listingSources" ], "title": "SearchFilterData", "type": "object" } }, { "description": "Permanently delete one of the signed-in user's notifications by notificationId. Returns an empty object; an unknown ID returns NOT_FOUND.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "notificationId": { "description": "ID of the notification (`ntf_…`).", "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "notificationId" ], "title": "NotificationArguments", "type": "object" }, "name": "deleteNotification", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Structured result of a bodyless business outcome: an empty object rather than `null`,\nbecause tool results never carry JSON `null` members.", "title": "Completed", "type": "object" } }, { "description": "Permanently delete every notification of the signed-in user, including those beyond the listed page. Takes no arguments. Returns an empty object.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "title": "EmptyArguments", "type": "object" }, "name": "deleteNotifications", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Structured result of a bodyless business outcome: an empty object rather than `null`,\nbecause tool results never carry JSON `null` members.", "title": "Completed", "type": "object" } }, { "description": "Permanently delete one of the signed-in user's saved addresses. expectedVersion must equal its current version. If the address is the browsing destination, that destination is cleared too. Returns an empty object.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "addressId": { "description": "ID of the saved address (`uaddr_…`).", "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "expectedVersion": { "description": "Current version from the last read; a stale version returns CONFLICT.", "format": "uint64", "maximum": 9223372036854776000, "minimum": 1, "type": "integer" } }, "required": [ "addressId", "expectedVersion" ], "title": "DeleteAddressArguments", "type": "object" }, "name": "deleteUserAddress", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Structured result of a bodyless business outcome: an empty object rather than `null`,\nbecause tool results never carry JSON `null` members.", "title": "Completed", "type": "object" } }, { "description": "Permanently delete one of the signed-in user's saved searches. Returns an empty object; an unknown ID returns NOT_FOUND.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "userSearchFilterId": { "description": "ID of the saved search (`sf_…`).", "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userSearchFilterId" ], "title": "FilterArguments", "type": "object" }, "name": "deleteUserSearchFilter", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Structured result of a bodyless business outcome: an empty object rather than `null`,\nbecause tool results never carry JSON `null` members.", "title": "Completed", "type": "object" } }, { "description": "Remove a listing from the signed-in user's watchlist by productListingId. Returns an empty object; a listing that is not on the watchlist returns NOT_FOUND, also after an earlier call removed it.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "productListingId": { "description": "ID of the listing (`pl_…`).", "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "productListingId" ], "title": "RemoveInput", "type": "object" }, "name": "deleteWatchlistProduct", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Structured result of a bodyless business outcome: an empty object rather than `null`,\nbecause tool results never carry JSON `null` members.", "title": "Completed", "type": "object" } }, { "description": "Get one auction by its auctionId: name, provider, format, schedule, reported status, reported and visible lot counts, and the link to its catalogue at the provider. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "auctionId": { "description": "ID of the auction (`auc_…`).", "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "auctionId" ], "title": "AuctionArguments", "type": "object" }, "name": "getAuction", "outputSchema": { "$defs": { "AuctionScheduleResponseData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "liveStarts": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "lotsBeginClosing": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledEnd": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "PublicSourceData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "catalogueUrl": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] }, "format": { "anyOf": [ { "enum": [ "LIVE", "TIMED" ], "type": "string" }, { "type": "null" } ] }, "listingSource": { "$ref": "#/$defs/PublicSourceData" }, "name": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "reportedLotCount": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": [ "integer", "null" ] }, "reportedStatus": { "anyOf": [ { "enum": [ "SCHEDULED", "IN_PROGRESS", "ENDED", "POSTPONED", "CANCELLED" ], "type": "string" }, { "type": "null" } ] }, "schedule": { "$ref": "#/$defs/AuctionScheduleResponseData" }, "viewLink": { "anyOf": [ { "$ref": "#/$defs/ViewLinkData" }, { "type": "null" } ], "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." }, "visibleListingCount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "auctionId", "listingSource", "schedule", "visibleListingCount" ], "title": "PublicAuctionData", "type": "object" } }, { "description": "List the lots of one auction by its auctionId in catalogue order, as listings in the requested language and currency with shipping details. Pass the returned searchAfter object as a JSON string to get the next page. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "auctionId": { "description": "ID of the auction (`auc_…`).", "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "currency": { "default": "EUR", "description": "Currency of the returned prices, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "language": { "default": "en", "description": "Language of the returned listing text, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "pageSize": { "description": "Number of lots per page, from 1 to 100 (default 21); values outside that range are clamped.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "searchAfter": { "description": "Continuation from the previous page: its `searchAfter` object serialized as a JSON string, passed back exactly as returned.", "type": [ "string", "null" ] } }, "required": [ "auctionId" ], "title": "CatalogueArguments", "type": "object" }, "name": "getAuctionCatalogue", "outputSchema": { "$defs": { "AuctionScheduleData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "liveStarts": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "lotsBeginClosing": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledEnd": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "AuctionSummaryData": { "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "format": { "type": [ "string", "null" ] }, "name": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "reportedStatus": { "type": [ "string", "null" ] }, "schedule": { "$ref": "#/$defs/AuctionScheduleData" } }, "required": [ "auctionId", "schedule" ], "type": "object" }, "CatalogueCursorData": { "additionalProperties": false, "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "cataloguePosition": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": [ "integer", "null" ] }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "auctionId", "productListingId" ], "type": "object" }, "ContentPolicyData": { "oneOf": [ { "properties": { "decision": { "const": "ALLOWED", "type": "string" } }, "required": [ "decision" ], "type": "object" }, { "properties": { "category": { "type": "string" }, "decision": { "const": "REQUIRES_CONSENT", "type": "string" } }, "required": [ "decision", "category" ], "type": "object" } ] }, "ContentVisibilityUserStateData": { "properties": { "showUnassessedOrSensitiveContent": { "type": "boolean" } }, "required": [ "showUnassessedOrSensitiveContent" ], "type": "object" }, "DeliveryAssessmentAttribution": { "description": "Attribution required by the geographic evidence behind the assessed destination.", "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "DeliveryAssessmentExplanation": { "description": "Why eligibility remains undetermined beyond missing caller inputs.", "oneOf": [ { "description": "Partial coverage neither includes nor excludes the destination or service.", "properties": { "code": { "const": "INCOMPLETE_COVERAGE", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "A condition depends on a qualifying amount at this scope, which browsing never supplies.", "properties": { "code": { "const": "QUALIFYING_AMOUNT_REQUIRED", "type": "string" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "code", "scope" ], "type": "object" }, { "description": "Advertised terms or their seller-side facts cannot be interpreted conservatively.", "properties": { "code": { "const": "UNRESOLVED_TERMS", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "Collection depends on shipping eligibility, which remains undetermined.", "properties": { "code": { "const": "SHIPPING_UNDETERMINED", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "The applicable advertised terms assert no eligibility.", "properties": { "code": { "const": "NOT_ASSERTED", "type": "string" } }, "required": [ "code" ], "type": "object" } ] }, "DeliveryAssessmentRequiredInput": { "description": "Inputs a caller can supply whose absence leaves eligibility undetermined.", "enum": [ "DESTINATION", "DESTINATION_COUNTRY", "DESTINATION_SUBDIVISION", "POSTAL_CODE", "QUANTITY", "LOTS", "SHIPMENTS", "SELLER_ORDERS", "VARIANT" ], "type": "string" }, "DeliveryAssessmentSummaryData": { "description": "Assessed eligibility, or the inputs and explanations leaving it undetermined. Omitted\neligibility means unknown or unasserted; only an explicit `NOT_OFFERED` is a negative.", "minProperties": 1, "properties": { "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingShippingPriceData": { "description": "Every advertised price kind. On-request and externally calculated prices stay explicit\nrather than becoming an absent or zero price.", "oneOf": [ { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "FREE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "EXTERNALLY_CALCULATED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "ListingShippingSummaryData": { "description": "Destination-independent summary shared by every viewer of a collection item.", "minProperties": 1, "properties": { "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingSourceSummaryData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" }, "ListingTextData": { "description": "A listing text as the source published it and as shown for the requested language.", "properties": { "localized": { "$ref": "#/$defs/LocalizedTextData", "description": "Text to show for the requested language. Chosen from the translations and the original in\nthe order requested language, `en`, `de`, then any other language, so it can be the\noriginal itself. Always present; compare its `language` with `original.language` to tell\nwhether the text was translated." }, "original": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ], "description": "Text as the source published it, normalized: styled letters and digits are presented as\nordinary text, emoji and ornamental symbols are removed and truncation ellipses remain\nstable. Omitted where the response does not carry the original, such as search and\nsimilar-listing summaries and notification payloads." } }, "required": [ "localized" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "NotificationUserStateData": { "properties": { "unseenNotificationIds": { "items": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" } }, "required": [ "unseenNotificationIds" ], "type": "object" }, "PersonalizedData": { "properties": { "item": { "$ref": "#/$defs/ProductListingDetailsData" }, "userState": { "anyOf": [ { "$ref": "#/$defs/ProductListingUserStateData" }, { "type": "null" } ] } }, "required": [ "item" ], "type": "object" }, "PersonalizedShippingSummaryData": { "description": "Assessment for the caller's selected browsing destination, without echoing it.", "minProperties": 1, "properties": { "attribution": { "$ref": "#/$defs/DeliveryAssessmentAttribution" }, "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "pricePreview": { "$ref": "#/$defs/ShippingPricePreviewData" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "PriceData": { "description": "A monetary amount in the currency's minor units.", "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "currency", "amount" ], "type": "object" }, "ProductListingDetailsData": { "description": "`Shipping` and `Images` follow the response purpose: complete by default, bounded in collections.", "properties": { "auction": { "anyOf": [ { "$ref": "#/$defs/AuctionSummaryData" }, { "type": "null" } ] }, "availability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "contentPolicy": { "anyOf": [ { "$ref": "#/$defs/ContentPolicyData" }, { "type": "null" } ] }, "created": { "format": "date-time", "type": "string" }, "eventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ProductListingImageData" }, { "type": "null" } ] }, "lifecycle": { "enum": [ "ACTIVE", "WITHDRAWN" ], "type": "string" }, "lot": { "anyOf": [ { "$ref": "#/$defs/ProductListingLotData" }, { "type": "null" } ] }, "pricing": { "$ref": "#/$defs/ProductListingPricingPresentationData" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": [ "string", "null" ] }, "shipping": { "$ref": "#/$defs/ListingShippingSummaryData" }, "source": { "$ref": "#/$defs/ListingSourceSummaryData" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "updated": { "format": "date-time", "type": "string" }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "eventId", "source", "sourceListingId", "pricing", "lifecycle", "url", "viewLink", "created", "updated" ], "type": "object" }, "ProductListingImageData": { "properties": { "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingLotData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "cataloguePosition": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": [ "integer", "null" ] }, "lotNumber": { "type": [ "string", "null" ] }, "reportedClosedAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledCloses": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPriceData": { "oneOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "ProductListingPricingData": { "properties": { "price": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "priceEstimateMax": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] }, "priceEstimateMin": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPricingPresentationData": { "properties": { "display": { "$ref": "#/$defs/ProductListingPricingData" }, "source": { "$ref": "#/$defs/ProductListingPricingData" }, "valuation": { "$ref": "#/$defs/ProductListingPricingValuationData" } }, "required": [ "source", "display", "valuation" ], "type": "object" }, "ProductListingPricingValuationData": { "oneOf": [ { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": { "const": "CURRENT", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt" ], "type": "object" }, { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "observedAt": { "format": "date-time", "type": "string" }, "type": { "const": "SALE_OBSERVATION", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt", "observedAt" ], "type": "object" } ] }, "ProductListingUserStateData": { "properties": { "contentVisibility": { "anyOf": [ { "$ref": "#/$defs/ContentVisibilityUserStateData" }, { "type": "null" } ] }, "notification": { "anyOf": [ { "$ref": "#/$defs/NotificationUserStateData" }, { "type": "null" } ] }, "searchFilter": { "anyOf": [ { "$ref": "#/$defs/SearchFilterUserStateData" }, { "type": "null" } ] }, "shipping": { "$ref": "#/$defs/PersonalizedShippingSummaryData" }, "watchlist": { "anyOf": [ { "$ref": "#/$defs/WatchlistUserStateData" }, { "type": "null" } ] } }, "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "SearchFilterUserStateData": { "properties": { "hidden": { "type": "boolean" }, "matchFeedback": { "type": [ "boolean", "null" ] }, "matched": { "type": "boolean" }, "shippingMatchValuation": { "anyOf": [ { "$ref": "#/$defs/ShippingMatchValuationData" }, { "type": "null" } ] }, "userSearchFilterId": { "anyOf": [ { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "userSearchFilterName": { "type": [ "string", "null" ] } }, "required": [ "matched", "hidden" ], "type": "object" }, "ShippingDisplayData": { "description": "Shared valuation of the requested-currency values in one shipping object. Present only\nwhen a value was actually converted; HalfUp rounding uses currency minor-unit exponents.", "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "currency": { "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" ], "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "currency", "fxRateId", "capturedAt" ], "type": "object" }, "ShippingMatchMaximumData": { "properties": { "amount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "ShippingMatchValuationData": { "properties": { "capturedAt": { "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "interpretation": { "type": "string" }, "maximumPerItem": { "$ref": "#/$defs/ShippingMatchMaximumData" } }, "required": [ "interpretation", "fxRateId", "capturedAt", "maximumPerItem" ], "type": "object" }, "ShippingMoneyData": { "description": "Advertised amount in currency minor units; never an authorized quote or checkout total.", "properties": { "amount_minor": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount_minor", "currency" ], "type": "object" }, "ShippingPricePreviewData": { "description": "One advertised rate of an applicable service in the requested currency where convertible.\nIt identifies its service and charge basis and never claims a quantity or total.", "properties": { "basis": { "enum": [ "PER_ITEM", "PER_LOT", "PER_SHIPMENT", "PER_SELLER_ORDER" ], "type": "string" }, "price": { "$ref": "#/$defs/ListingShippingPriceData" }, "service": { "type": "string" } }, "required": [ "service", "basis", "price" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" }, "WatchlistUserStateData": { "properties": { "notifications": { "type": "boolean" }, "watching": { "type": "boolean" } }, "required": [ "watching", "notifications" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "items": { "items": { "$ref": "#/$defs/PersonalizedData" }, "type": "array" }, "pageSize": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "searchAfter": { "anyOf": [ { "$ref": "#/$defs/CatalogueCursorData" }, { "type": "null" } ] } }, "required": [ "items", "pageSize" ], "title": "CatalogueData", "type": "object" } }, { "description": "Get the destination Aura Historia uses to estimate shipping while the signed-in user browses: NONE, one of their saved addresses (ADDRESS) or a country with an optional postal code (COUNTRY_POSTAL), with its version.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "title": "OwnAccountArguments", "type": "object" }, "name": "getBrowsingDestination", "outputSchema": { "$defs": { "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No browsing destination.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "One of the user's saved addresses.", "properties": { "addressId": { "description": "ID of the saved address (`uaddr_…`).", "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "kind": { "const": "ADDRESS", "description": "Selects this variant; always `ADDRESS` here.", "type": "string" } }, "required": [ "kind", "addressId" ], "type": "object" }, { "additionalProperties": false, "description": "A country, optionally with a postal code.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY_POSTAL", "description": "Selects this variant; always `COUNTRY_POSTAL` here.", "type": "string" }, "postalCode": { "description": "Postal code within the country.", "type": [ "string", "null" ] } }, "required": [ "kind", "country" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "destination": { "$ref": "#/$defs/DestinationData" }, "version": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "version", "destination" ], "title": "DestinationResponse", "type": "object" } }, { "description": "Get the full details of one listing by its productListingId: text, prices, images, provider, availability, auction and shipping, in the requested language and currency. Use it when the user wants more than a search result shows. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Existing presentation query used by listing detail and similarity reads.", "properties": { "currency": { "default": "EUR", "description": "Currency of the returned prices, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "language": { "default": "en", "description": "Language of the returned listing text, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "productListingId": { "description": "ID of the listing (`pl_…`).", "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "productListingId" ], "title": "ListingInput", "type": "object" }, "name": "getProductListing", "outputSchema": { "$defs": { "AuctionScheduleData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "liveStarts": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "lotsBeginClosing": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledEnd": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "AuctionSummaryData": { "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "format": { "type": [ "string", "null" ] }, "name": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "reportedStatus": { "type": [ "string", "null" ] }, "schedule": { "$ref": "#/$defs/AuctionScheduleData" } }, "required": [ "auctionId", "schedule" ], "type": "object" }, "ContentPolicyData": { "oneOf": [ { "properties": { "decision": { "const": "ALLOWED", "type": "string" } }, "required": [ "decision" ], "type": "object" }, { "properties": { "category": { "type": "string" }, "decision": { "const": "REQUIRES_CONSENT", "type": "string" } }, "required": [ "decision", "category" ], "type": "object" } ] }, "ContentVisibilityUserStateData": { "properties": { "showUnassessedOrSensitiveContent": { "type": "boolean" } }, "required": [ "showUnassessedOrSensitiveContent" ], "type": "object" }, "DeliveryAssessmentAttribution": { "description": "Attribution required by the geographic evidence behind the assessed destination.", "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "DeliveryAssessmentCharge": { "description": "Arithmetic advertised charge for an explicit basis and count; never a quote or landed cost.", "oneOf": [ { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" } ] }, "DeliveryAssessmentExplanation": { "description": "Why eligibility remains undetermined beyond missing caller inputs.", "oneOf": [ { "description": "Partial coverage neither includes nor excludes the destination or service.", "properties": { "code": { "const": "INCOMPLETE_COVERAGE", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "A condition depends on a qualifying amount at this scope, which browsing never supplies.", "properties": { "code": { "const": "QUALIFYING_AMOUNT_REQUIRED", "type": "string" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "code", "scope" ], "type": "object" }, { "description": "Advertised terms or their seller-side facts cannot be interpreted conservatively.", "properties": { "code": { "const": "UNRESOLVED_TERMS", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "Collection depends on shipping eligibility, which remains undetermined.", "properties": { "code": { "const": "SHIPPING_UNDETERMINED", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "The applicable advertised terms assert no eligibility.", "properties": { "code": { "const": "NOT_ASSERTED", "type": "string" } }, "required": [ "code" ], "type": "object" } ] }, "DeliveryAssessmentGeography": { "description": "Minimal area facts: no street, coordinates, address identity or provider evidence.", "properties": { "country": { "pattern": "^[A-Z]{2}$", "type": "string" }, "postalCode": { "type": "string" }, "referenceRelease": { "enum": [ "iso-codes-4.20.1" ], "type": "string" }, "subdivision": { "type": "string" } }, "required": [ "referenceRelease" ], "type": "object" }, "DeliveryAssessmentOption": { "description": "An assessed service of the destination's zone, identified by its code and advertised rate.\nA charge appears only when browsing supplied every count its basis needs.", "minProperties": 1, "properties": { "charge": { "$ref": "#/$defs/DeliveryAssessmentCharge" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "rate": { "$ref": "#/$defs/ListingShippingRateData" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true }, "service": { "type": "string" } }, "required": [ "service" ], "type": "object" }, "DeliveryAssessmentRequiredInput": { "description": "Inputs a caller can supply whose absence leaves eligibility undetermined.", "enum": [ "DESTINATION", "DESTINATION_COUNTRY", "DESTINATION_SUBDIVISION", "POSTAL_CODE", "QUANTITY", "LOTS", "SHIPMENTS", "SELLER_ORDERS", "VARIANT" ], "type": "string" }, "DeliveryAssessmentSummaryData": { "description": "Assessed eligibility, or the inputs and explanations leaving it undetermined. Omitted\neligibility means unknown or unasserted; only an explicit `NOT_OFFERED` is a negative.", "minProperties": 1, "properties": { "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingShippingApplicabilityData": { "description": "Present only when at least one condition is asserted; every asserted condition must hold.", "minProperties": 1, "properties": { "class": { "type": "string" }, "quantity": { "$ref": "#/$defs/ShippingQuantityData" }, "threshold": { "$ref": "#/$defs/ShippingThresholdData" }, "variants": { "items": { "type": "string" }, "maxItems": 64, "minItems": 1, "type": "array" } }, "type": "object" }, "ListingShippingCollectionArrangementData": { "oneOf": [ { "properties": { "kind": { "const": "BY_APPOINTMENT", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "CONTACT_TO_ARRANGE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "duration": { "$ref": "#/$defs/ListingShippingTimeData" }, "kind": { "const": "WINDOW", "type": "string" } }, "required": [ "kind", "duration" ], "type": "object" } ] }, "ListingShippingCollectionData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "arrangement": { "$ref": "#/$defs/ListingShippingCollectionArrangementData" }, "dependency": { "enum": [ "INDEPENDENT", "SHIPPING" ], "type": "string" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" } }, "required": [ "dependency" ], "type": "object" }, "ListingShippingCoverageData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "completeness": { "enum": [ "PARTIAL", "COMPLETE" ], "type": "string" }, "exclusions": { "items": { "$ref": "#/$defs/ShippingAreaData" }, "maxItems": 64, "minItems": 1, "type": "array" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" }, "zones": { "description": "Ordered; the first zone matching a destination applies.", "items": { "$ref": "#/$defs/ListingShippingZoneData" }, "maxItems": 64, "type": "array" } }, "required": [ "reference_release", "completeness", "zones" ], "type": "object" }, "ListingShippingDetailData": { "description": "Effective public terms shared by every viewer of the listing; omitted when unasserted.\nTerms that cannot be resolved leave only the explanation of the undetermined outcome.", "minProperties": 1, "properties": { "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true }, "terms": { "$ref": "#/$defs/ListingShippingTermsData" } }, "type": "object" }, "ListingShippingLeadTimesData": { "minProperties": 1, "properties": { "handling": { "$ref": "#/$defs/ListingShippingTimeData" }, "total": { "$ref": "#/$defs/ListingShippingTimeData" }, "transit": { "$ref": "#/$defs/ListingShippingTimeData" } }, "type": "object" }, "ListingShippingPolicyData": { "oneOf": [ { "properties": { "kind": { "const": "PROHIBITED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "coverage": { "$ref": "#/$defs/ListingShippingCoverageData" }, "kind": { "const": "COVERAGE", "type": "string" } }, "required": [ "kind", "coverage" ], "type": "object" } ] }, "ListingShippingPriceData": { "description": "Every advertised price kind. On-request and externally calculated prices stay explicit\nrather than becoming an absent or zero price.", "oneOf": [ { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "FREE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "EXTERNALLY_CALCULATED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "ListingShippingRateData": { "description": "An advertised rate. `display_price` is the requested-currency value of an amount\nadvertised in another currency; `price` always keeps the advertised source value.", "properties": { "basis": { "enum": [ "PER_ITEM", "PER_LOT", "PER_SHIPMENT", "PER_SELLER_ORDER" ], "type": "string" }, "components": { "additionalProperties": { "enum": [ "INCLUDED", "EXCLUDED" ], "type": "string" }, "minProperties": 1, "propertyNames": { "enum": [ "TRANSPORT", "PACKING", "INSURANCE", "HANDLING", "INSTALLATION", "IMPORT_DUTY", "TAX" ], "type": "string" }, "type": "object" }, "display_price": { "$ref": "#/$defs/ListingShippingPriceData" }, "price": { "$ref": "#/$defs/ListingShippingPriceData" }, "qualifying_scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "price" ], "type": "object" }, "ListingShippingServiceData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "arranger": { "$ref": "#/$defs/ShippingActorData" }, "code": { "type": "string" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "features": { "items": { "enum": [ "TRACKING", "INSURED", "WHITE_GLOVE", "INSTALLATION", "PACKING" ], "type": "string" }, "minItems": 1, "type": "array", "uniqueItems": true }, "lead_times": { "$ref": "#/$defs/ListingShippingLeadTimesData" }, "performer": { "$ref": "#/$defs/ShippingActorData" }, "rate": { "$ref": "#/$defs/ListingShippingRateData" } }, "required": [ "code" ], "type": "object" }, "ListingShippingTermsData": { "minProperties": 1, "properties": { "collection": { "$ref": "#/$defs/ListingShippingCollectionData" }, "shipping": { "$ref": "#/$defs/ListingShippingPolicyData" } }, "type": "object" }, "ListingShippingTimeData": { "properties": { "basis": { "enum": [ "CALENDAR", "BUSINESS" ], "type": "string" }, "maximum": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": "integer" }, "minimum": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": "integer" }, "trigger": { "enum": [ "ORDER", "ORDER_CONFIRMATION", "PAYMENT", "DISPATCH", "READY_FOR_COLLECTION" ], "type": "string" }, "unit": { "enum": [ "HOURS", "DAYS", "WEEKS" ], "type": "string" } }, "required": [ "minimum", "maximum", "unit" ], "type": "object" }, "ListingShippingZoneData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "areas": { "items": { "$ref": "#/$defs/ShippingAreaData" }, "maxItems": 64, "minItems": 1, "type": "array" }, "services": { "items": { "$ref": "#/$defs/ListingShippingServiceData" }, "maxItems": 64, "minItems": 1, "type": "array" } }, "required": [ "areas", "services" ], "type": "object" }, "ListingSourceSummaryData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" }, "ListingTextData": { "description": "A listing text as the source published it and as shown for the requested language.", "properties": { "localized": { "$ref": "#/$defs/LocalizedTextData", "description": "Text to show for the requested language. Chosen from the translations and the original in\nthe order requested language, `en`, `de`, then any other language, so it can be the\noriginal itself. Always present; compare its `language` with `original.language` to tell\nwhether the text was translated." }, "original": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ], "description": "Text as the source published it, normalized: styled letters and digits are presented as\nordinary text, emoji and ornamental symbols are removed and truncation ellipses remain\nstable. Omitted where the response does not carry the original, such as search and\nsimilar-listing summaries and notification payloads." } }, "required": [ "localized" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "NotificationUserStateData": { "properties": { "unseenNotificationIds": { "items": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" } }, "required": [ "unseenNotificationIds" ], "type": "object" }, "PersonalizedShippingDetailData": { "description": "Assessment for the caller's selected browsing destination.", "minProperties": 1, "properties": { "attribution": { "$ref": "#/$defs/DeliveryAssessmentAttribution" }, "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "destination": { "$ref": "#/$defs/DeliveryAssessmentGeography" }, "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "options": { "items": { "$ref": "#/$defs/DeliveryAssessmentOption" }, "maxItems": 64, "minItems": 1, "type": "array" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "required": [ "destination" ], "type": "object" }, "PriceData": { "description": "A monetary amount in the currency's minor units.", "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "currency", "amount" ], "type": "object" }, "ProductListingDetailsData": { "description": "`Shipping` and `Images` follow the response purpose: complete by default, bounded in collections.", "properties": { "auction": { "anyOf": [ { "$ref": "#/$defs/AuctionSummaryData" }, { "type": "null" } ] }, "availability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "contentPolicy": { "anyOf": [ { "$ref": "#/$defs/ContentPolicyData" }, { "type": "null" } ] }, "created": { "format": "date-time", "type": "string" }, "eventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "images": { "items": { "$ref": "#/$defs/ProductListingImageData" }, "type": "array" }, "lifecycle": { "enum": [ "ACTIVE", "WITHDRAWN" ], "type": "string" }, "lot": { "anyOf": [ { "$ref": "#/$defs/ProductListingLotData" }, { "type": "null" } ] }, "pricing": { "$ref": "#/$defs/ProductListingPricingPresentationData" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": [ "string", "null" ] }, "shipping": { "$ref": "#/$defs/ListingShippingDetailData" }, "source": { "$ref": "#/$defs/ListingSourceSummaryData" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "updated": { "format": "date-time", "type": "string" }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "eventId", "source", "sourceListingId", "pricing", "lifecycle", "url", "viewLink", "images", "created", "updated" ], "type": "object" }, "ProductListingImageData": { "properties": { "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingLotData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "cataloguePosition": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": [ "integer", "null" ] }, "lotNumber": { "type": [ "string", "null" ] }, "reportedClosedAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledCloses": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPriceData": { "oneOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "ProductListingPricingData": { "properties": { "price": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "priceEstimateMax": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] }, "priceEstimateMin": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPricingPresentationData": { "properties": { "display": { "$ref": "#/$defs/ProductListingPricingData" }, "source": { "$ref": "#/$defs/ProductListingPricingData" }, "valuation": { "$ref": "#/$defs/ProductListingPricingValuationData" } }, "required": [ "source", "display", "valuation" ], "type": "object" }, "ProductListingPricingValuationData": { "oneOf": [ { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": { "const": "CURRENT", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt" ], "type": "object" }, { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "observedAt": { "format": "date-time", "type": "string" }, "type": { "const": "SALE_OBSERVATION", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt", "observedAt" ], "type": "object" } ] }, "ProductListingUserStateData": { "properties": { "contentVisibility": { "anyOf": [ { "$ref": "#/$defs/ContentVisibilityUserStateData" }, { "type": "null" } ] }, "notification": { "anyOf": [ { "$ref": "#/$defs/NotificationUserStateData" }, { "type": "null" } ] }, "searchFilter": { "anyOf": [ { "$ref": "#/$defs/SearchFilterUserStateData" }, { "type": "null" } ] }, "shipping": { "$ref": "#/$defs/PersonalizedShippingDetailData" }, "watchlist": { "anyOf": [ { "$ref": "#/$defs/WatchlistUserStateData" }, { "type": "null" } ] } }, "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "SearchFilterUserStateData": { "properties": { "hidden": { "type": "boolean" }, "matchFeedback": { "type": [ "boolean", "null" ] }, "matched": { "type": "boolean" }, "shippingMatchValuation": { "anyOf": [ { "$ref": "#/$defs/ShippingMatchValuationData" }, { "type": "null" } ] }, "userSearchFilterId": { "anyOf": [ { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "userSearchFilterName": { "type": [ "string", "null" ] } }, "required": [ "matched", "hidden" ], "type": "object" }, "ShippingActorData": { "oneOf": [ { "properties": { "kind": { "const": "LISTING_SOURCE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "BUYER", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "PARTY", "type": "string" }, "party_id": { "pattern": "^pty_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "kind", "party_id" ], "type": "object" } ] }, "ShippingAreaData": { "oneOf": [ { "properties": { "kind": { "const": "ANYWHERE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "DOMESTIC", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "code": { "type": "string" }, "kind": { "const": "COUNTRY", "type": "string" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" } }, "required": [ "kind", "code", "reference_release" ], "type": "object" }, { "properties": { "code": { "type": "string" }, "kind": { "const": "SUBDIVISION", "type": "string" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" } }, "required": [ "kind", "code", "reference_release" ], "type": "object" }, { "properties": { "country": { "type": "string" }, "form": { "$ref": "#/$defs/ShippingPostalFormData" }, "kind": { "const": "POSTAL", "type": "string" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" }, "version": { "enum": [ "POSTAL_RULE_V1" ], "type": "string" } }, "required": [ "kind", "version", "country", "reference_release", "form" ], "type": "object" }, { "properties": { "assertion": { "type": "string" }, "kind": { "const": "UNRESOLVED", "type": "string" } }, "required": [ "kind", "assertion" ], "type": "object" } ] }, "ShippingDisplayData": { "description": "Shared valuation of the requested-currency values in one shipping object. Present only\nwhen a value was actually converted; HalfUp rounding uses currency minor-unit exponents.", "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "currency": { "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" ], "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "currency", "fxRateId", "capturedAt" ], "type": "object" }, "ShippingMatchMaximumData": { "properties": { "amount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "ShippingMatchValuationData": { "properties": { "capturedAt": { "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "interpretation": { "type": "string" }, "maximumPerItem": { "$ref": "#/$defs/ShippingMatchMaximumData" } }, "required": [ "interpretation", "fxRateId", "capturedAt", "maximumPerItem" ], "type": "object" }, "ShippingMoneyData": { "description": "Advertised amount in currency minor units; never an authorized quote or checkout total.", "properties": { "amount_minor": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount_minor", "currency" ], "type": "object" }, "ShippingPostalFormData": { "oneOf": [ { "properties": { "code": { "type": "string" }, "kind": { "const": "EXACT", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" }, { "properties": { "kind": { "const": "GERMAN_PREFIX", "type": "string" }, "prefix": { "type": "string" } }, "required": [ "kind", "prefix" ], "type": "object" }, { "properties": { "first": { "type": "string" }, "kind": { "const": "GERMAN_RANGE", "type": "string" }, "last": { "type": "string" } }, "required": [ "kind", "first", "last" ], "type": "object" } ] }, "ShippingQuantityData": { "properties": { "maximum": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 1, "type": "integer" }, "minimum": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 1, "type": "integer" } }, "required": [ "minimum", "maximum" ], "type": "object" }, "ShippingThresholdData": { "properties": { "minimum": { "$ref": "#/$defs/ShippingMoneyData" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "minimum", "scope" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" }, "WatchlistUserStateData": { "properties": { "notifications": { "type": "boolean" }, "watching": { "type": "boolean" } }, "required": [ "watching", "notifications" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "item": { "$ref": "#/$defs/ProductListingDetailsData" }, "userState": { "anyOf": [ { "$ref": "#/$defs/ProductListingUserStateData" }, { "type": "null" } ] } }, "required": [ "item" ], "title": "PersonalizedData", "type": "object" } }, { "description": "Get the full details of one listing by its productListingTitleSlugId, the last segment of an Aura Historia listing page URL (/products/{slug}). Returns the same details as the lookup by productListingId. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Existing presentation query used by listing detail and similarity reads.", "properties": { "currency": { "default": "EUR", "description": "Currency of the returned prices, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "language": { "default": "en", "description": "Language of the returned listing text, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "productListingTitleSlugId": { "description": "Slug ID of the listing, the last segment of an Aura Historia listing page URL.", "maxLength": 120, "pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*-[0-9a-f]{6}$", "type": "string" } }, "required": [ "productListingTitleSlugId" ], "title": "SlugInput", "type": "object" }, "name": "getProductListingByTitleSlug", "outputSchema": { "$defs": { "AuctionScheduleData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "liveStarts": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "lotsBeginClosing": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledEnd": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "AuctionSummaryData": { "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "format": { "type": [ "string", "null" ] }, "name": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "reportedStatus": { "type": [ "string", "null" ] }, "schedule": { "$ref": "#/$defs/AuctionScheduleData" } }, "required": [ "auctionId", "schedule" ], "type": "object" }, "ContentPolicyData": { "oneOf": [ { "properties": { "decision": { "const": "ALLOWED", "type": "string" } }, "required": [ "decision" ], "type": "object" }, { "properties": { "category": { "type": "string" }, "decision": { "const": "REQUIRES_CONSENT", "type": "string" } }, "required": [ "decision", "category" ], "type": "object" } ] }, "ContentVisibilityUserStateData": { "properties": { "showUnassessedOrSensitiveContent": { "type": "boolean" } }, "required": [ "showUnassessedOrSensitiveContent" ], "type": "object" }, "DeliveryAssessmentAttribution": { "description": "Attribution required by the geographic evidence behind the assessed destination.", "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "DeliveryAssessmentCharge": { "description": "Arithmetic advertised charge for an explicit basis and count; never a quote or landed cost.", "oneOf": [ { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" } ] }, "DeliveryAssessmentExplanation": { "description": "Why eligibility remains undetermined beyond missing caller inputs.", "oneOf": [ { "description": "Partial coverage neither includes nor excludes the destination or service.", "properties": { "code": { "const": "INCOMPLETE_COVERAGE", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "A condition depends on a qualifying amount at this scope, which browsing never supplies.", "properties": { "code": { "const": "QUALIFYING_AMOUNT_REQUIRED", "type": "string" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "code", "scope" ], "type": "object" }, { "description": "Advertised terms or their seller-side facts cannot be interpreted conservatively.", "properties": { "code": { "const": "UNRESOLVED_TERMS", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "Collection depends on shipping eligibility, which remains undetermined.", "properties": { "code": { "const": "SHIPPING_UNDETERMINED", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "The applicable advertised terms assert no eligibility.", "properties": { "code": { "const": "NOT_ASSERTED", "type": "string" } }, "required": [ "code" ], "type": "object" } ] }, "DeliveryAssessmentGeography": { "description": "Minimal area facts: no street, coordinates, address identity or provider evidence.", "properties": { "country": { "pattern": "^[A-Z]{2}$", "type": "string" }, "postalCode": { "type": "string" }, "referenceRelease": { "enum": [ "iso-codes-4.20.1" ], "type": "string" }, "subdivision": { "type": "string" } }, "required": [ "referenceRelease" ], "type": "object" }, "DeliveryAssessmentOption": { "description": "An assessed service of the destination's zone, identified by its code and advertised rate.\nA charge appears only when browsing supplied every count its basis needs.", "minProperties": 1, "properties": { "charge": { "$ref": "#/$defs/DeliveryAssessmentCharge" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "rate": { "$ref": "#/$defs/ListingShippingRateData" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true }, "service": { "type": "string" } }, "required": [ "service" ], "type": "object" }, "DeliveryAssessmentRequiredInput": { "description": "Inputs a caller can supply whose absence leaves eligibility undetermined.", "enum": [ "DESTINATION", "DESTINATION_COUNTRY", "DESTINATION_SUBDIVISION", "POSTAL_CODE", "QUANTITY", "LOTS", "SHIPMENTS", "SELLER_ORDERS", "VARIANT" ], "type": "string" }, "DeliveryAssessmentSummaryData": { "description": "Assessed eligibility, or the inputs and explanations leaving it undetermined. Omitted\neligibility means unknown or unasserted; only an explicit `NOT_OFFERED` is a negative.", "minProperties": 1, "properties": { "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingShippingApplicabilityData": { "description": "Present only when at least one condition is asserted; every asserted condition must hold.", "minProperties": 1, "properties": { "class": { "type": "string" }, "quantity": { "$ref": "#/$defs/ShippingQuantityData" }, "threshold": { "$ref": "#/$defs/ShippingThresholdData" }, "variants": { "items": { "type": "string" }, "maxItems": 64, "minItems": 1, "type": "array" } }, "type": "object" }, "ListingShippingCollectionArrangementData": { "oneOf": [ { "properties": { "kind": { "const": "BY_APPOINTMENT", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "CONTACT_TO_ARRANGE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "duration": { "$ref": "#/$defs/ListingShippingTimeData" }, "kind": { "const": "WINDOW", "type": "string" } }, "required": [ "kind", "duration" ], "type": "object" } ] }, "ListingShippingCollectionData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "arrangement": { "$ref": "#/$defs/ListingShippingCollectionArrangementData" }, "dependency": { "enum": [ "INDEPENDENT", "SHIPPING" ], "type": "string" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" } }, "required": [ "dependency" ], "type": "object" }, "ListingShippingCoverageData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "completeness": { "enum": [ "PARTIAL", "COMPLETE" ], "type": "string" }, "exclusions": { "items": { "$ref": "#/$defs/ShippingAreaData" }, "maxItems": 64, "minItems": 1, "type": "array" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" }, "zones": { "description": "Ordered; the first zone matching a destination applies.", "items": { "$ref": "#/$defs/ListingShippingZoneData" }, "maxItems": 64, "type": "array" } }, "required": [ "reference_release", "completeness", "zones" ], "type": "object" }, "ListingShippingDetailData": { "description": "Effective public terms shared by every viewer of the listing; omitted when unasserted.\nTerms that cannot be resolved leave only the explanation of the undetermined outcome.", "minProperties": 1, "properties": { "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true }, "terms": { "$ref": "#/$defs/ListingShippingTermsData" } }, "type": "object" }, "ListingShippingLeadTimesData": { "minProperties": 1, "properties": { "handling": { "$ref": "#/$defs/ListingShippingTimeData" }, "total": { "$ref": "#/$defs/ListingShippingTimeData" }, "transit": { "$ref": "#/$defs/ListingShippingTimeData" } }, "type": "object" }, "ListingShippingPolicyData": { "oneOf": [ { "properties": { "kind": { "const": "PROHIBITED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "coverage": { "$ref": "#/$defs/ListingShippingCoverageData" }, "kind": { "const": "COVERAGE", "type": "string" } }, "required": [ "kind", "coverage" ], "type": "object" } ] }, "ListingShippingPriceData": { "description": "Every advertised price kind. On-request and externally calculated prices stay explicit\nrather than becoming an absent or zero price.", "oneOf": [ { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "FREE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "EXTERNALLY_CALCULATED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "ListingShippingRateData": { "description": "An advertised rate. `display_price` is the requested-currency value of an amount\nadvertised in another currency; `price` always keeps the advertised source value.", "properties": { "basis": { "enum": [ "PER_ITEM", "PER_LOT", "PER_SHIPMENT", "PER_SELLER_ORDER" ], "type": "string" }, "components": { "additionalProperties": { "enum": [ "INCLUDED", "EXCLUDED" ], "type": "string" }, "minProperties": 1, "propertyNames": { "enum": [ "TRANSPORT", "PACKING", "INSURANCE", "HANDLING", "INSTALLATION", "IMPORT_DUTY", "TAX" ], "type": "string" }, "type": "object" }, "display_price": { "$ref": "#/$defs/ListingShippingPriceData" }, "price": { "$ref": "#/$defs/ListingShippingPriceData" }, "qualifying_scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "price" ], "type": "object" }, "ListingShippingServiceData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "arranger": { "$ref": "#/$defs/ShippingActorData" }, "code": { "type": "string" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "features": { "items": { "enum": [ "TRACKING", "INSURED", "WHITE_GLOVE", "INSTALLATION", "PACKING" ], "type": "string" }, "minItems": 1, "type": "array", "uniqueItems": true }, "lead_times": { "$ref": "#/$defs/ListingShippingLeadTimesData" }, "performer": { "$ref": "#/$defs/ShippingActorData" }, "rate": { "$ref": "#/$defs/ListingShippingRateData" } }, "required": [ "code" ], "type": "object" }, "ListingShippingTermsData": { "minProperties": 1, "properties": { "collection": { "$ref": "#/$defs/ListingShippingCollectionData" }, "shipping": { "$ref": "#/$defs/ListingShippingPolicyData" } }, "type": "object" }, "ListingShippingTimeData": { "properties": { "basis": { "enum": [ "CALENDAR", "BUSINESS" ], "type": "string" }, "maximum": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": "integer" }, "minimum": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": "integer" }, "trigger": { "enum": [ "ORDER", "ORDER_CONFIRMATION", "PAYMENT", "DISPATCH", "READY_FOR_COLLECTION" ], "type": "string" }, "unit": { "enum": [ "HOURS", "DAYS", "WEEKS" ], "type": "string" } }, "required": [ "minimum", "maximum", "unit" ], "type": "object" }, "ListingShippingZoneData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "areas": { "items": { "$ref": "#/$defs/ShippingAreaData" }, "maxItems": 64, "minItems": 1, "type": "array" }, "services": { "items": { "$ref": "#/$defs/ListingShippingServiceData" }, "maxItems": 64, "minItems": 1, "type": "array" } }, "required": [ "areas", "services" ], "type": "object" }, "ListingSourceSummaryData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" }, "ListingTextData": { "description": "A listing text as the source published it and as shown for the requested language.", "properties": { "localized": { "$ref": "#/$defs/LocalizedTextData", "description": "Text to show for the requested language. Chosen from the translations and the original in\nthe order requested language, `en`, `de`, then any other language, so it can be the\noriginal itself. Always present; compare its `language` with `original.language` to tell\nwhether the text was translated." }, "original": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ], "description": "Text as the source published it, normalized: styled letters and digits are presented as\nordinary text, emoji and ornamental symbols are removed and truncation ellipses remain\nstable. Omitted where the response does not carry the original, such as search and\nsimilar-listing summaries and notification payloads." } }, "required": [ "localized" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "NotificationUserStateData": { "properties": { "unseenNotificationIds": { "items": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" } }, "required": [ "unseenNotificationIds" ], "type": "object" }, "PersonalizedShippingDetailData": { "description": "Assessment for the caller's selected browsing destination.", "minProperties": 1, "properties": { "attribution": { "$ref": "#/$defs/DeliveryAssessmentAttribution" }, "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "destination": { "$ref": "#/$defs/DeliveryAssessmentGeography" }, "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "options": { "items": { "$ref": "#/$defs/DeliveryAssessmentOption" }, "maxItems": 64, "minItems": 1, "type": "array" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "required": [ "destination" ], "type": "object" }, "PriceData": { "description": "A monetary amount in the currency's minor units.", "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "currency", "amount" ], "type": "object" }, "ProductListingDetailsData": { "description": "`Shipping` and `Images` follow the response purpose: complete by default, bounded in collections.", "properties": { "auction": { "anyOf": [ { "$ref": "#/$defs/AuctionSummaryData" }, { "type": "null" } ] }, "availability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "contentPolicy": { "anyOf": [ { "$ref": "#/$defs/ContentPolicyData" }, { "type": "null" } ] }, "created": { "format": "date-time", "type": "string" }, "eventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "images": { "items": { "$ref": "#/$defs/ProductListingImageData" }, "type": "array" }, "lifecycle": { "enum": [ "ACTIVE", "WITHDRAWN" ], "type": "string" }, "lot": { "anyOf": [ { "$ref": "#/$defs/ProductListingLotData" }, { "type": "null" } ] }, "pricing": { "$ref": "#/$defs/ProductListingPricingPresentationData" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": [ "string", "null" ] }, "shipping": { "$ref": "#/$defs/ListingShippingDetailData" }, "source": { "$ref": "#/$defs/ListingSourceSummaryData" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "updated": { "format": "date-time", "type": "string" }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "eventId", "source", "sourceListingId", "pricing", "lifecycle", "url", "viewLink", "images", "created", "updated" ], "type": "object" }, "ProductListingImageData": { "properties": { "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingLotData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "cataloguePosition": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": [ "integer", "null" ] }, "lotNumber": { "type": [ "string", "null" ] }, "reportedClosedAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledCloses": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPriceData": { "oneOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "ProductListingPricingData": { "properties": { "price": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "priceEstimateMax": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] }, "priceEstimateMin": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPricingPresentationData": { "properties": { "display": { "$ref": "#/$defs/ProductListingPricingData" }, "source": { "$ref": "#/$defs/ProductListingPricingData" }, "valuation": { "$ref": "#/$defs/ProductListingPricingValuationData" } }, "required": [ "source", "display", "valuation" ], "type": "object" }, "ProductListingPricingValuationData": { "oneOf": [ { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": { "const": "CURRENT", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt" ], "type": "object" }, { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "observedAt": { "format": "date-time", "type": "string" }, "type": { "const": "SALE_OBSERVATION", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt", "observedAt" ], "type": "object" } ] }, "ProductListingUserStateData": { "properties": { "contentVisibility": { "anyOf": [ { "$ref": "#/$defs/ContentVisibilityUserStateData" }, { "type": "null" } ] }, "notification": { "anyOf": [ { "$ref": "#/$defs/NotificationUserStateData" }, { "type": "null" } ] }, "searchFilter": { "anyOf": [ { "$ref": "#/$defs/SearchFilterUserStateData" }, { "type": "null" } ] }, "shipping": { "$ref": "#/$defs/PersonalizedShippingDetailData" }, "watchlist": { "anyOf": [ { "$ref": "#/$defs/WatchlistUserStateData" }, { "type": "null" } ] } }, "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "SearchFilterUserStateData": { "properties": { "hidden": { "type": "boolean" }, "matchFeedback": { "type": [ "boolean", "null" ] }, "matched": { "type": "boolean" }, "shippingMatchValuation": { "anyOf": [ { "$ref": "#/$defs/ShippingMatchValuationData" }, { "type": "null" } ] }, "userSearchFilterId": { "anyOf": [ { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "userSearchFilterName": { "type": [ "string", "null" ] } }, "required": [ "matched", "hidden" ], "type": "object" }, "ShippingActorData": { "oneOf": [ { "properties": { "kind": { "const": "LISTING_SOURCE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "BUYER", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "PARTY", "type": "string" }, "party_id": { "pattern": "^pty_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "kind", "party_id" ], "type": "object" } ] }, "ShippingAreaData": { "oneOf": [ { "properties": { "kind": { "const": "ANYWHERE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "DOMESTIC", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "code": { "type": "string" }, "kind": { "const": "COUNTRY", "type": "string" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" } }, "required": [ "kind", "code", "reference_release" ], "type": "object" }, { "properties": { "code": { "type": "string" }, "kind": { "const": "SUBDIVISION", "type": "string" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" } }, "required": [ "kind", "code", "reference_release" ], "type": "object" }, { "properties": { "country": { "type": "string" }, "form": { "$ref": "#/$defs/ShippingPostalFormData" }, "kind": { "const": "POSTAL", "type": "string" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" }, "version": { "enum": [ "POSTAL_RULE_V1" ], "type": "string" } }, "required": [ "kind", "version", "country", "reference_release", "form" ], "type": "object" }, { "properties": { "assertion": { "type": "string" }, "kind": { "const": "UNRESOLVED", "type": "string" } }, "required": [ "kind", "assertion" ], "type": "object" } ] }, "ShippingDisplayData": { "description": "Shared valuation of the requested-currency values in one shipping object. Present only\nwhen a value was actually converted; HalfUp rounding uses currency minor-unit exponents.", "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "currency": { "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" ], "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "currency", "fxRateId", "capturedAt" ], "type": "object" }, "ShippingMatchMaximumData": { "properties": { "amount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "ShippingMatchValuationData": { "properties": { "capturedAt": { "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "interpretation": { "type": "string" }, "maximumPerItem": { "$ref": "#/$defs/ShippingMatchMaximumData" } }, "required": [ "interpretation", "fxRateId", "capturedAt", "maximumPerItem" ], "type": "object" }, "ShippingMoneyData": { "description": "Advertised amount in currency minor units; never an authorized quote or checkout total.", "properties": { "amount_minor": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount_minor", "currency" ], "type": "object" }, "ShippingPostalFormData": { "oneOf": [ { "properties": { "code": { "type": "string" }, "kind": { "const": "EXACT", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" }, { "properties": { "kind": { "const": "GERMAN_PREFIX", "type": "string" }, "prefix": { "type": "string" } }, "required": [ "kind", "prefix" ], "type": "object" }, { "properties": { "first": { "type": "string" }, "kind": { "const": "GERMAN_RANGE", "type": "string" }, "last": { "type": "string" } }, "required": [ "kind", "first", "last" ], "type": "object" } ] }, "ShippingQuantityData": { "properties": { "maximum": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 1, "type": "integer" }, "minimum": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 1, "type": "integer" } }, "required": [ "minimum", "maximum" ], "type": "object" }, "ShippingThresholdData": { "properties": { "minimum": { "$ref": "#/$defs/ShippingMoneyData" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "minimum", "scope" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" }, "WatchlistUserStateData": { "properties": { "notifications": { "type": "boolean" }, "watching": { "type": "boolean" } }, "required": [ "watching", "notifications" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "item": { "$ref": "#/$defs/ProductListingDetailsData" }, "userState": { "anyOf": [ { "$ref": "#/$defs/ProductListingUserStateData" }, { "type": "null" } ] } }, "required": [ "item" ], "title": "PersonalizedData", "type": "object" } }, { "description": "Get the complete history of one listing by its productListingId: when it was first seen and every recorded change, in event order. Use it for questions about price development or past changes. With currency, each price is also converted at the exchange rate of its event. Returns every event in one result; a history too large for one response fails instead of being truncated. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Existing optional REST history presentation query, reused by MCP arguments.", "properties": { "currency": { "anyOf": [ { "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" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Currency to also show each price in, converted at the exchange rate of its event, as an ISO 4217 code; without it only the source prices are returned." }, "productListingId": { "description": "ID of the listing (`pl_…`).", "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "productListingId" ], "title": "HistoryInput", "type": "object" }, "name": "getProductListingHistory", "outputSchema": { "$defs": { "ListingSaleObservationHistoryData": { "properties": { "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "observedAt": { "format": "date-time", "type": "string" } }, "required": [ "observedAt", "fxRateId" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "ProductListingAuctionData": { "properties": { "auctionId": { "anyOf": [ { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "cataloguePosition": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": [ "integer", "null" ] }, "lotNumber": { "type": [ "string", "null" ] }, "reportedClosedAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledCloses": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingChangedHistoryData": { "properties": { "changes": { "items": { "$ref": "#/$defs/ProductListingHistoryChangeData" }, "type": "array" } }, "required": [ "changes" ], "type": "object" }, "ProductListingDiscoveryHistoryData": { "properties": { "auction": { "anyOf": [ { "$ref": "#/$defs/ProductListingAuctionData" }, { "type": "null" } ] }, "availability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "imageCount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "pricing": { "$ref": "#/$defs/ProductListingPricingData" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "url": { "format": "uri", "type": "string" } }, "required": [ "listingSourceId", "sourceListingId", "pricing", "url", "imageCount" ], "type": "object" }, "ProductListingHistoryChangeData": { "oneOf": [ { "properties": { "current": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "previous": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "type": { "const": "TITLE_CHANGED", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "type": { "const": "DESCRIPTION_CHANGED", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "type": { "const": "DELIVERY_CHANGED", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "current": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceData" }, { "type": "null" } ] }, "previous": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceData" }, { "type": "null" } ] }, "type": { "const": "MAIN_PRICE_CHANGED", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "current": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceData2" }, { "type": "null" } ] }, "previous": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceData2" }, { "type": "null" } ] }, "type": { "const": "MINIMUM_ESTIMATE_CHANGED", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "current": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceData2" }, { "type": "null" } ] }, "previous": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceData2" }, { "type": "null" } ] }, "type": { "const": "MAXIMUM_ESTIMATE_CHANGED", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "current": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "previous": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "type": { "const": "AVAILABILITY_CHANGED", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "current": { "format": "uri", "type": "string" }, "previous": { "format": "uri", "type": "string" }, "type": { "const": "URL_CHANGED", "type": "string" } }, "required": [ "type", "previous", "current" ], "type": "object" }, { "properties": { "currentCount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "previousCount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "type": { "const": "IMAGES_CHANGED", "type": "string" } }, "required": [ "type", "previousCount", "currentCount" ], "type": "object" }, { "properties": { "current": { "anyOf": [ { "$ref": "#/$defs/ProductListingAuctionData" }, { "type": "null" } ] }, "previous": { "anyOf": [ { "$ref": "#/$defs/ProductListingAuctionData" }, { "type": "null" } ] }, "type": { "const": "AUCTION_CHANGED", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "previousAvailability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "type": { "const": "WITHDRAWN", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "type": { "const": "RESTORED", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "observation": { "$ref": "#/$defs/ListingSaleObservationHistoryData" }, "type": { "const": "SALE_OBSERVED", "type": "string" } }, "required": [ "type", "observation" ], "type": "object" }, { "properties": { "observation": { "$ref": "#/$defs/ListingSaleObservationHistoryData" }, "type": { "const": "SALE_OBSERVATION_RETRACTED", "type": "string" } }, "required": [ "type", "observation" ], "type": "object" } ] }, "ProductListingHistoryEntryData": { "properties": { "eventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "eventType": { "type": "string" }, "payload": { "$ref": "#/$defs/ProductListingHistoryPayloadData" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "timestamp": { "format": "date-time", "type": "string" } }, "required": [ "eventType", "productListingId", "eventId", "payload", "timestamp" ], "type": "object" }, "ProductListingHistoryPayloadData": { "anyOf": [ { "$ref": "#/$defs/ProductListingDiscoveryHistoryData" }, { "$ref": "#/$defs/ProductListingChangedHistoryData" } ] }, "ProductListingHistoryPriceData": { "oneOf": [ { "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ], "properties": { "display": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceDisplayData" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingHistoryPriceData2": { "description": "A monetary amount in the currency's minor units.", "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "display": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceDisplayData" }, { "type": "null" } ] } }, "required": [ "currency", "amount" ], "type": "object" }, "ProductListingHistoryPriceDisplayData": { "description": "A monetary amount in the currency's minor units.", "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "capturedAt": { "format": "date-time", "type": "string" }, "currency": { "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" ], "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "currency", "amount", "fxRateId", "capturedAt" ], "type": "object" }, "ProductListingPricingData": { "properties": { "price": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceData" }, { "type": "null" } ] }, "priceEstimateMax": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceData2" }, { "type": "null" } ] }, "priceEstimateMin": { "anyOf": [ { "$ref": "#/$defs/ProductListingHistoryPriceData2" }, { "type": "null" } ] } }, "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "description": "Object envelope required by legacy MCP output schemas for arrays and scalars.\nThe inner value is the shared API response type without remapping or field dropping.", "properties": { "result": { "items": { "$ref": "#/$defs/ProductListingHistoryEntryData" }, "type": "array" } }, "required": [ "result" ], "title": "ToolOutput", "type": "object" } }, { "description": "Get the public profile of one provider (a dealer, auction house, marketplace or auction platform) by its listingSourceSlugId, the last segment of an Aura Historia provider page URL (/shops/{slug}): name, operator, website and image. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "listingSourceSlugId": { "description": "Slug ID of the provider, the last segment of an Aura Historia provider page URL.", "type": "string" } }, "required": [ "listingSourceSlugId" ], "title": "GetPublicListingSourceBySlugData", "type": "object" }, "name": "getPublicListingSourceBySlug", "outputSchema": { "$defs": { "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "image": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] }, "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "listingSourceSlugId": { "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ], "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared." }, "viewLink": { "anyOf": [ { "$ref": "#/$defs/ViewLinkData" }, { "type": "null" } ], "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "listingSourceId", "listingSourceSlugId", "name", "operator" ], "title": "PublicListingSourceData", "type": "object" } }, { "description": "Get the latest calculated statistics of the Aura Historia catalogue: live listings, listings added in the last seven days, countries, languages and indexed providers by type, with the time they were calculated. Takes no arguments.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "title": "OverviewArguments", "type": "object" }, "name": "getPublicOverview", "outputSchema": { "$defs": { "SourcesIndexedByTypeData": { "description": "`sourcesIndexed` split by ListingSource type; the values sum to `sourcesIndexed`.", "properties": { "auctionHouses": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "auctionPlatforms": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "dealers": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "marketplaces": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "dealers", "auctionHouses", "marketplaces", "auctionPlatforms" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "asOf": { "format": "date-time", "type": "string" }, "countries": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "languages": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "liveObjects": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "newObjectsLast7Days": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "sourcesIndexed": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "sourcesIndexedByType": { "$ref": "#/$defs/SourcesIndexedByTypeData" } }, "required": [ "asOf", "sourcesIndexed", "sourcesIndexedByType", "liveObjects", "countries", "languages", "newObjectsLast7Days" ], "title": "PublicOverviewData", "type": "object" } }, { "description": "Find listings similar to one listing, identified by its productListingId. Returns up to `size` neighbours (default 20; values outside 1 to 50 are clamped) in the requested language and currency. EMBEDDING_PENDING means the listing is not yet prepared for comparison and a later call can succeed; READY with an empty list means nothing similar was found. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Existing presentation query used by listing detail and similarity reads.", "properties": { "currency": { "default": "EUR", "description": "Currency of the returned prices, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "language": { "default": "en", "description": "Language of the returned listing text, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "productListingId": { "description": "ID of the listing (`pl_…`).", "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "size": { "description": "Number of similar listings to return, from 1 to 50 (default 20); values outside that range are clamped.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "productListingId" ], "title": "SimilarInput", "type": "object" }, "name": "getSimilarProductListings", "outputSchema": { "$defs": { "ContentPolicyData": { "oneOf": [ { "properties": { "decision": { "const": "ALLOWED", "type": "string" } }, "required": [ "decision" ], "type": "object" }, { "properties": { "category": { "type": "string" }, "decision": { "const": "REQUIRES_CONSENT", "type": "string" } }, "required": [ "decision", "category" ], "type": "object" } ] }, "ContentVisibilityUserStateData": { "properties": { "showUnassessedOrSensitiveContent": { "type": "boolean" } }, "required": [ "showUnassessedOrSensitiveContent" ], "type": "object" }, "DeliveryAssessmentAttribution": { "description": "Attribution required by the geographic evidence behind the assessed destination.", "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "DeliveryAssessmentExplanation": { "description": "Why eligibility remains undetermined beyond missing caller inputs.", "oneOf": [ { "description": "Partial coverage neither includes nor excludes the destination or service.", "properties": { "code": { "const": "INCOMPLETE_COVERAGE", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "A condition depends on a qualifying amount at this scope, which browsing never supplies.", "properties": { "code": { "const": "QUALIFYING_AMOUNT_REQUIRED", "type": "string" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "code", "scope" ], "type": "object" }, { "description": "Advertised terms or their seller-side facts cannot be interpreted conservatively.", "properties": { "code": { "const": "UNRESOLVED_TERMS", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "Collection depends on shipping eligibility, which remains undetermined.", "properties": { "code": { "const": "SHIPPING_UNDETERMINED", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "The applicable advertised terms assert no eligibility.", "properties": { "code": { "const": "NOT_ASSERTED", "type": "string" } }, "required": [ "code" ], "type": "object" } ] }, "DeliveryAssessmentRequiredInput": { "description": "Inputs a caller can supply whose absence leaves eligibility undetermined.", "enum": [ "DESTINATION", "DESTINATION_COUNTRY", "DESTINATION_SUBDIVISION", "POSTAL_CODE", "QUANTITY", "LOTS", "SHIPMENTS", "SELLER_ORDERS", "VARIANT" ], "type": "string" }, "DeliveryAssessmentSummaryData": { "description": "Assessed eligibility, or the inputs and explanations leaving it undetermined. Omitted\neligibility means unknown or unasserted; only an explicit `NOT_OFFERED` is a negative.", "minProperties": 1, "properties": { "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingGeographyData": { "properties": { "basis": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "distanceKm": { "format": "double", "type": [ "number", "null" ] }, "locationId": { "pattern": "^ploc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "point": { "anyOf": [ { "$ref": "#/$defs/OriginData" }, { "type": "null" } ] }, "precision": { "type": [ "string", "null" ] }, "referenceRelease": { "type": "string" }, "subdivision": { "type": [ "string", "null" ] } }, "required": [ "locationId", "basis", "referenceRelease" ], "type": "object" }, "ListingShippingPriceData": { "description": "Every advertised price kind. On-request and externally calculated prices stay explicit\nrather than becoming an absent or zero price.", "oneOf": [ { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "FREE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "EXTERNALLY_CALCULATED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "ListingShippingSummaryData": { "description": "Destination-independent summary shared by every viewer of a collection item.", "minProperties": 1, "properties": { "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingSourceSummaryData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" }, "ListingTextData": { "description": "A listing text as the source published it and as shown for the requested language.", "properties": { "localized": { "$ref": "#/$defs/LocalizedTextData", "description": "Text to show for the requested language. Chosen from the translations and the original in\nthe order requested language, `en`, `de`, then any other language, so it can be the\noriginal itself. Always present; compare its `language` with `original.language` to tell\nwhether the text was translated." }, "original": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ], "description": "Text as the source published it, normalized: styled letters and digits are presented as\nordinary text, emoji and ornamental symbols are removed and truncation ellipses remain\nstable. Omitted where the response does not carry the original, such as search and\nsimilar-listing summaries and notification payloads." } }, "required": [ "localized" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "NotificationUserStateData": { "properties": { "unseenNotificationIds": { "items": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" } }, "required": [ "unseenNotificationIds" ], "type": "object" }, "OriginData": { "additionalProperties": false, "properties": { "latitude": { "description": "Latitude in decimal degrees.", "format": "double", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees.", "format": "double", "type": "number" } }, "required": [ "latitude", "longitude" ], "type": "object" }, "PersonalizedData": { "properties": { "item": { "$ref": "#/$defs/ProductListingSummaryData" }, "userState": { "anyOf": [ { "$ref": "#/$defs/ProductListingUserStateData" }, { "type": "null" } ] } }, "required": [ "item" ], "type": "object" }, "PersonalizedShippingSummaryData": { "description": "Assessment for the caller's selected browsing destination, without echoing it.", "minProperties": 1, "properties": { "attribution": { "$ref": "#/$defs/DeliveryAssessmentAttribution" }, "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "pricePreview": { "$ref": "#/$defs/ShippingPricePreviewData" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ProductListingImageData": { "properties": { "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPriceData": { "oneOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "ProductListingSummaryData": { "properties": { "auctionId": { "anyOf": [ { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "availability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "contentPolicy": { "anyOf": [ { "$ref": "#/$defs/ContentPolicyData" }, { "type": "null" } ] }, "displayPrice": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "eventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "geography": { "anyOf": [ { "$ref": "#/$defs/ListingGeographyData" }, { "type": "null" } ] }, "image": { "anyOf": [ { "$ref": "#/$defs/ProductListingImageData" }, { "type": "null" } ] }, "lifecycle": { "enum": [ "ACTIVE", "WITHDRAWN" ], "type": "string" }, "priceValuation": { "$ref": "#/$defs/ProductListingSummaryPriceValuationData" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": [ "string", "null" ] }, "shipping": { "$ref": "#/$defs/ListingShippingSummaryData" }, "source": { "$ref": "#/$defs/ListingSourceSummaryData" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "updated": { "format": "date-time", "type": "string" }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "eventId", "source", "sourceListingId", "priceValuation", "lifecycle", "url", "viewLink", "updated" ], "type": "object" }, "ProductListingSummaryPriceValuationData": { "oneOf": [ { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": { "const": "CURRENT", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt" ], "type": "object" }, { "properties": { "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "observedAt": { "format": "date-time", "type": "string" }, "type": { "const": "SALE_OBSERVATION", "type": "string" } }, "required": [ "type", "fxRateId", "observedAt" ], "type": "object" } ] }, "ProductListingUserStateData": { "properties": { "contentVisibility": { "anyOf": [ { "$ref": "#/$defs/ContentVisibilityUserStateData" }, { "type": "null" } ] }, "notification": { "anyOf": [ { "$ref": "#/$defs/NotificationUserStateData" }, { "type": "null" } ] }, "searchFilter": { "anyOf": [ { "$ref": "#/$defs/SearchFilterUserStateData" }, { "type": "null" } ] }, "shipping": { "$ref": "#/$defs/PersonalizedShippingSummaryData" }, "watchlist": { "anyOf": [ { "$ref": "#/$defs/WatchlistUserStateData" }, { "type": "null" } ] } }, "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "SearchFilterUserStateData": { "properties": { "hidden": { "type": "boolean" }, "matchFeedback": { "type": [ "boolean", "null" ] }, "matched": { "type": "boolean" }, "shippingMatchValuation": { "anyOf": [ { "$ref": "#/$defs/ShippingMatchValuationData" }, { "type": "null" } ] }, "userSearchFilterId": { "anyOf": [ { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "userSearchFilterName": { "type": [ "string", "null" ] } }, "required": [ "matched", "hidden" ], "type": "object" }, "ShippingDisplayData": { "description": "Shared valuation of the requested-currency values in one shipping object. Present only\nwhen a value was actually converted; HalfUp rounding uses currency minor-unit exponents.", "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "currency": { "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" ], "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "currency", "fxRateId", "capturedAt" ], "type": "object" }, "ShippingMatchMaximumData": { "properties": { "amount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "ShippingMatchValuationData": { "properties": { "capturedAt": { "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "interpretation": { "type": "string" }, "maximumPerItem": { "$ref": "#/$defs/ShippingMatchMaximumData" } }, "required": [ "interpretation", "fxRateId", "capturedAt", "maximumPerItem" ], "type": "object" }, "ShippingMoneyData": { "description": "Advertised amount in currency minor units; never an authorized quote or checkout total.", "properties": { "amount_minor": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount_minor", "currency" ], "type": "object" }, "ShippingPricePreviewData": { "description": "One advertised rate of an applicable service in the requested currency where convertible.\nIt identifies its service and charge basis and never claims a quantity or total.", "properties": { "basis": { "enum": [ "PER_ITEM", "PER_LOT", "PER_SHIPMENT", "PER_SELLER_ORDER" ], "type": "string" }, "price": { "$ref": "#/$defs/ListingShippingPriceData" }, "service": { "type": "string" } }, "required": [ "service", "basis", "price" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" }, "WatchlistUserStateData": { "properties": { "notifications": { "type": "boolean" }, "watching": { "type": "boolean" } }, "required": [ "watching", "notifications" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "description": "The REST pending response has no body. MCP needs an explicit result distinct from\na completed computation with zero neighbors.", "oneOf": [ { "properties": { "status": { "const": "EMBEDDING_PENDING", "type": "string" } }, "required": [ "status" ], "type": "object" }, { "properties": { "items": { "items": { "$ref": "#/$defs/PersonalizedData" }, "type": "array" }, "status": { "const": "READY", "type": "string" } }, "required": [ "status", "items" ], "type": "object" } ], "title": "SimilarOutput", "type": "object" } }, { "description": "Get the signed-in user's Aura Historia account: email, name, language, currency and measurement unit, content preference, marketing consent, subscription tier and role.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "title": "OwnAccountArguments", "type": "object" }, "name": "getUserAccount", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "currency": { "anyOf": [ { "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" ], "type": "string" }, { "type": "null" } ] }, "email": { "type": "string" }, "firstName": { "type": [ "string", "null" ] }, "language": { "anyOf": [ { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, { "type": "null" } ] }, "lastName": { "type": [ "string", "null" ] }, "marketingEmailConsent": { "type": "boolean" }, "measurementUnit": { "anyOf": [ { "enum": [ "METRIC", "IMPERIAL" ], "type": "string" }, { "type": "null" } ] }, "role": { "enum": [ "USER", "ADMIN" ], "type": "string" }, "showUnassessedOrSensitiveContent": { "type": "boolean" }, "tier": { "enum": [ "FREE", "PRO", "ULTIMATE" ], "type": "string" }, "userId": { "pattern": "^usr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userId", "email", "showUnassessedOrSensitiveContent", "marketingEmailConsent", "tier", "role" ], "title": "OwnUserData", "type": "object" } }, { "description": "Get one of the signed-in user's saved addresses by addressId, with its resolved location and the attribution of the geocoding provider.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "addressId": { "description": "ID of the saved address (`uaddr_…`).", "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "addressId" ], "title": "AddressArguments", "type": "object" }, "name": "getUserAddress", "outputSchema": { "$defs": { "AddressAttributionData": { "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "AddressResolutionData": { "properties": { "attribution": { "anyOf": [ { "$ref": "#/$defs/AddressAttributionData" }, { "type": "null" } ] }, "derived": { "anyOf": [ { "$ref": "#/$defs/DerivedData" }, { "type": "null" } ] }, "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "DerivedData": { "properties": { "geography": { "anyOf": [ { "$ref": "#/$defs/GeographyData" }, { "type": "null" } ] }, "position": { "anyOf": [ { "$ref": "#/$defs/PositionData" }, { "type": "null" } ] } }, "type": "object" }, "GeographyData": { "additionalProperties": false, "properties": { "addressText": { "description": "Free-text address; address-book entries require it.", "type": [ "string", "null" ] }, "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": [ "string", "null" ] }, "postalCode": { "description": "Postal code.", "type": [ "string", "null" ] }, "referenceRelease": { "description": "Version of the ISO 3166 code list the codes come from; `iso-codes-4.20.1` is the only accepted value.", "type": "string" }, "subdivision": { "description": "ISO 3166-2 subdivision code.", "type": [ "string", "null" ] } }, "required": [ "referenceRelease" ], "type": "object" }, "PositionData": { "additionalProperties": false, "properties": { "accuracyMetres": { "format": "double", "type": [ "number", "null" ] }, "latitudeDegrees": { "format": "double", "type": "number" }, "longitudeDegrees": { "format": "double", "type": "number" }, "precision": { "type": "string" } }, "required": [ "latitudeDegrees", "longitudeDegrees", "precision" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "addressId": { "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "geography": { "allOf": [ { "$ref": "#/$defs/GeographyData" }, { "properties": { "addressText": { "description": "Free-text address; required for address-book entries.", "maxLength": 4096, "minLength": 1, "type": "string" } }, "required": [ "addressText" ], "type": "object" } ] }, "inputRevision": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "label": { "type": "string" }, "preferred": { "type": "boolean" }, "resolution": { "$ref": "#/$defs/AddressResolutionData" }, "version": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "addressId", "label", "geography", "inputRevision", "version", "preferred", "resolution" ], "title": "AddressData", "type": "object" } }, { "description": "Get one of the signed-in user's saved searches by userSearchFilterId, with its criteria, state and notification settings. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "userSearchFilterId": { "description": "ID of the saved search (`sf_…`).", "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userSearchFilterId" ], "title": "FilterArguments", "type": "object" }, "name": "getUserSearchFilter", "outputSchema": { "$defs": { "AmountData": { "additionalProperties": false, "properties": { "amount": { "description": "Amount as an integer in the currency's minor unit (EUR cents; JPY whole yen).", "format": "uint64", "maximum": 9223372036854776000, "minimum": 0, "type": "integer" }, "currency": { "description": "ISO 4217 code of the currency the amount is in.", "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "DateRangeSchema": { "properties": { "max": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "End of the range, as an ISO 8601 date-time with offset." }, "min": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "Start of the range, as an ISO 8601 date-time with offset." } }, "required": [ "min", "max" ], "type": "object" }, "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No destination country.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "A destination country.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY", "description": "Selects this variant; always `COUNTRY` here.", "type": "string" } }, "required": [ "kind", "country" ], "type": "object" } ] }, "GeographicSearchData": { "additionalProperties": false, "properties": { "countries": { "description": "ISO 3166-1 alpha-2 country codes, at most 100; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" }, "distanceOrder": { "description": "Order results by distance from `origin`, `ASC` (nearest first) or `DESC`; requires `origin`.", "type": [ "string", "null" ] }, "mode": { "description": "Which locations count when measuring distance: `STRICT` (default) only exact premises, `APPROXIMATE` also street, locality and representative points; `APPROXIMATE` needs `origin` with `radius` or `distanceOrder`.", "type": [ "string", "null" ] }, "origin": { "anyOf": [ { "$ref": "#/$defs/OriginData" }, { "type": "null" } ], "description": "Point that `radius` and `distanceOrder` measure from; required by either of them." }, "radius": { "anyOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Distance in `unit`; greater than 0.", "type": "number" }, "unit": { "description": "Unit of `amount`: one of MILES, YARDS, FEET, INCHES, KILOMETERS, METERS, CENTIMETERS, MILLIMETERS, NAUTICAL_MILES.", "type": "string" } }, "required": [ "amount", "unit" ], "type": "object" }, { "type": "null" } ], "description": "Only listings within this distance of `origin`, at most 20,000 km." }, "subdivisions": { "description": "ISO 3166-2 subdivision codes, at most 100, that belong to `countries` when those are given; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "NumberRangeSchema": { "properties": { "max": { "description": "Highest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "min": { "description": "Lowest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "min", "max" ], "type": "object" }, "OriginData": { "additionalProperties": false, "properties": { "latitude": { "description": "Latitude in decimal degrees.", "format": "double", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees.", "format": "double", "type": "number" } }, "required": [ "latitude", "longitude" ], "type": "object" }, "ProductListingSearchData": { "properties": { "auctionId": { "description": "Only listings that belong to these auctions, given as auction IDs (`auc_…`).", "items": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "availability": { "anyOf": [ { "items": { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings in one of these exact availability states; combined with `orderability`, a listing must satisfy both." }, "created": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's creation time, as ISO 8601 date-times with offset; both bounds inclusive." }, "currency": { "default": "EUR", "description": "Currency prices are returned in and `price` is interpreted in, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "enhancedSearchDescription": { "description": "Optional natural-language description that refines the ranking of `productQuery` results. Only effective together with `productQuery`; on its own it returns unranked, unrelated results.", "type": [ "string", "null" ] }, "excludeListingSourceId": { "description": "Leave out listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "excludeProductListingId": { "description": "Listing IDs (`pl_…`) to leave out of the results.", "items": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "geography": { "anyOf": [ { "$ref": "#/$defs/GeographicSearchData" }, { "type": "null" } ], "description": "Where listings are located, by country, subdivision or distance from a point; every member given must hold." }, "includeUnspecifiedAvailability": { "description": "Also include listings that state no availability (default false).", "type": [ "boolean", "null" ] }, "language": { "default": "en", "description": "Language of the returned listing text and of the titles `productQuery` is matched against, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "listingSourceId": { "description": "Only listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "lotBiddingOpens": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the time bidding on the lot opens, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "lotScheduledCloses": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the lot's scheduled closing time, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "orderability": { "anyOf": [ { "items": { "enum": [ "ORDERABLE_NOW", "ORDERABLE_CONDITIONALLY", "NOT_ORDERABLE" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings whose availability falls into one of these orderability groups; combined with `availability`, a listing must satisfy both." }, "price": { "anyOf": [ { "$ref": "#/$defs/NumberRangeSchema" }, { "type": "null" } ], "description": "Price range in the request's `currency`, with both bounds inclusive. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "productQuery": { "description": "Keyword phrases matched against listing titles; every word of one phrase must match, and a listing matches when any phrase does.", "items": { "minLength": 1, "type": "string" }, "type": "array" }, "shipping": { "anyOf": [ { "$ref": "#/$defs/ShippingSearchData" }, { "type": "null" } ], "description": "Only listings whose advertised shipping terms meet these conditions for a destination country; every member given must hold." }, "updated": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's last update time, as ISO 8601 date-times with offset; both bounds inclusive." } }, "required": [ "language", "currency" ], "type": "object" }, "PublicListingSourceData": { "properties": { "image": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] }, "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "listingSourceSlugId": { "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ], "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared." }, "viewLink": { "anyOf": [ { "$ref": "#/$defs/ViewLinkData" }, { "type": "null" } ], "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "listingSourceId", "listingSourceSlugId", "name", "operator" ], "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "ShippingSearchData": { "additionalProperties": false, "properties": { "collectionOffered": { "description": "Only listings that offer collection in person; the only shipping condition that works without a destination country.", "type": "boolean" }, "destination": { "anyOf": [ { "$ref": "#/$defs/DestinationData" }, { "type": "null" } ], "description": "Country the listing must ship to, as `{\"kind\":\"COUNTRY\",\"country\":\"DE\"}`; `{\"kind\":\"NONE\"}` sets no destination." }, "interpretation": { "description": "`WHOLE_COUNTRY_PER_ITEM_V1` (default) or `WHOLE_COUNTRY_PER_ITEM_FX_V1`, which values `maximumPerItem` in its own currency at the request's exchange rates and requires `maximumPerItem`.", "type": [ "string", "null" ] }, "maximumPerItem": { "anyOf": [ { "$ref": "#/$defs/AmountData" }, { "type": "null" } ], "description": "Highest acceptable shipping price per item, in the amount's own currency; requires a `destination` country. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "referenceRelease": { "description": "Version of the ISO 3166 code list the country code comes from; `iso-codes-4.20.1` is the only accepted value and the default.", "type": [ "string", "null" ] }, "service": { "description": "Shipping service code the terms must include, as free text of at most 128 characters; requires a `destination` country.", "type": [ "string", "null" ] } }, "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "created": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "listingSources": { "description": "Public cards of the ListingSources that `search.listingSourceId` and `search.excludeListingSourceId` reference, one per ID, ordered by `listingSourceId`. A source referenced by both lists appears once. An ID whose source no longer exists stays in `search` but has no card. Read-only.", "items": { "$ref": "#/$defs/PublicListingSourceData" }, "type": "array" }, "name": { "type": "string" }, "notifications": { "type": "boolean" }, "search": { "$ref": "#/$defs/ProductListingSearchData" }, "state": { "enum": [ "ACTIVE", "INACTIVE_BY_USER", "INACTIVE_BY_RESTRICTED_PLAN" ], "type": "string" }, "updated": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "userId": { "pattern": "^usr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "userSearchFilterId": { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userId", "userSearchFilterId", "name", "notifications", "state", "search", "listingSources" ], "title": "SearchFilterData", "type": "object" } }, { "description": "List all of the signed-in user's saved searches with their criteria, state and notification settings. Takes no arguments. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "title": "EmptyArguments", "type": "object" }, "name": "getUserSearchFilters", "outputSchema": { "$defs": { "AmountData": { "additionalProperties": false, "properties": { "amount": { "description": "Amount as an integer in the currency's minor unit (EUR cents; JPY whole yen).", "format": "uint64", "maximum": 9223372036854776000, "minimum": 0, "type": "integer" }, "currency": { "description": "ISO 4217 code of the currency the amount is in.", "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "DateRangeSchema": { "properties": { "max": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "End of the range, as an ISO 8601 date-time with offset." }, "min": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "Start of the range, as an ISO 8601 date-time with offset." } }, "required": [ "min", "max" ], "type": "object" }, "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No destination country.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "A destination country.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY", "description": "Selects this variant; always `COUNTRY` here.", "type": "string" } }, "required": [ "kind", "country" ], "type": "object" } ] }, "GeographicSearchData": { "additionalProperties": false, "properties": { "countries": { "description": "ISO 3166-1 alpha-2 country codes, at most 100; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" }, "distanceOrder": { "description": "Order results by distance from `origin`, `ASC` (nearest first) or `DESC`; requires `origin`.", "type": [ "string", "null" ] }, "mode": { "description": "Which locations count when measuring distance: `STRICT` (default) only exact premises, `APPROXIMATE` also street, locality and representative points; `APPROXIMATE` needs `origin` with `radius` or `distanceOrder`.", "type": [ "string", "null" ] }, "origin": { "anyOf": [ { "$ref": "#/$defs/OriginData" }, { "type": "null" } ], "description": "Point that `radius` and `distanceOrder` measure from; required by either of them." }, "radius": { "anyOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Distance in `unit`; greater than 0.", "type": "number" }, "unit": { "description": "Unit of `amount`: one of MILES, YARDS, FEET, INCHES, KILOMETERS, METERS, CENTIMETERS, MILLIMETERS, NAUTICAL_MILES.", "type": "string" } }, "required": [ "amount", "unit" ], "type": "object" }, { "type": "null" } ], "description": "Only listings within this distance of `origin`, at most 20,000 km." }, "subdivisions": { "description": "ISO 3166-2 subdivision codes, at most 100, that belong to `countries` when those are given; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "NumberRangeSchema": { "properties": { "max": { "description": "Highest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "min": { "description": "Lowest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "min", "max" ], "type": "object" }, "OriginData": { "additionalProperties": false, "properties": { "latitude": { "description": "Latitude in decimal degrees.", "format": "double", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees.", "format": "double", "type": "number" } }, "required": [ "latitude", "longitude" ], "type": "object" }, "ProductListingSearchData": { "properties": { "auctionId": { "description": "Only listings that belong to these auctions, given as auction IDs (`auc_…`).", "items": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "availability": { "anyOf": [ { "items": { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings in one of these exact availability states; combined with `orderability`, a listing must satisfy both." }, "created": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's creation time, as ISO 8601 date-times with offset; both bounds inclusive." }, "currency": { "default": "EUR", "description": "Currency prices are returned in and `price` is interpreted in, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "enhancedSearchDescription": { "description": "Optional natural-language description that refines the ranking of `productQuery` results. Only effective together with `productQuery`; on its own it returns unranked, unrelated results.", "type": [ "string", "null" ] }, "excludeListingSourceId": { "description": "Leave out listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "excludeProductListingId": { "description": "Listing IDs (`pl_…`) to leave out of the results.", "items": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "geography": { "anyOf": [ { "$ref": "#/$defs/GeographicSearchData" }, { "type": "null" } ], "description": "Where listings are located, by country, subdivision or distance from a point; every member given must hold." }, "includeUnspecifiedAvailability": { "description": "Also include listings that state no availability (default false).", "type": [ "boolean", "null" ] }, "language": { "default": "en", "description": "Language of the returned listing text and of the titles `productQuery` is matched against, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "listingSourceId": { "description": "Only listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "lotBiddingOpens": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the time bidding on the lot opens, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "lotScheduledCloses": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the lot's scheduled closing time, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "orderability": { "anyOf": [ { "items": { "enum": [ "ORDERABLE_NOW", "ORDERABLE_CONDITIONALLY", "NOT_ORDERABLE" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings whose availability falls into one of these orderability groups; combined with `availability`, a listing must satisfy both." }, "price": { "anyOf": [ { "$ref": "#/$defs/NumberRangeSchema" }, { "type": "null" } ], "description": "Price range in the request's `currency`, with both bounds inclusive. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "productQuery": { "description": "Keyword phrases matched against listing titles; every word of one phrase must match, and a listing matches when any phrase does.", "items": { "minLength": 1, "type": "string" }, "type": "array" }, "shipping": { "anyOf": [ { "$ref": "#/$defs/ShippingSearchData" }, { "type": "null" } ], "description": "Only listings whose advertised shipping terms meet these conditions for a destination country; every member given must hold." }, "updated": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's last update time, as ISO 8601 date-times with offset; both bounds inclusive." } }, "required": [ "language", "currency" ], "type": "object" }, "PublicListingSourceData": { "properties": { "image": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] }, "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "listingSourceSlugId": { "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ], "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared." }, "viewLink": { "anyOf": [ { "$ref": "#/$defs/ViewLinkData" }, { "type": "null" } ], "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "listingSourceId", "listingSourceSlugId", "name", "operator" ], "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "SearchFilterData": { "properties": { "created": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "listingSources": { "description": "Public cards of the ListingSources that `search.listingSourceId` and `search.excludeListingSourceId` reference, one per ID, ordered by `listingSourceId`. A source referenced by both lists appears once. An ID whose source no longer exists stays in `search` but has no card. Read-only.", "items": { "$ref": "#/$defs/PublicListingSourceData" }, "type": "array" }, "name": { "type": "string" }, "notifications": { "type": "boolean" }, "search": { "$ref": "#/$defs/ProductListingSearchData" }, "state": { "enum": [ "ACTIVE", "INACTIVE_BY_USER", "INACTIVE_BY_RESTRICTED_PLAN" ], "type": "string" }, "updated": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "userId": { "pattern": "^usr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "userSearchFilterId": { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userId", "userSearchFilterId", "name", "notifications", "state", "search", "listingSources" ], "type": "object" }, "ShippingSearchData": { "additionalProperties": false, "properties": { "collectionOffered": { "description": "Only listings that offer collection in person; the only shipping condition that works without a destination country.", "type": "boolean" }, "destination": { "anyOf": [ { "$ref": "#/$defs/DestinationData" }, { "type": "null" } ], "description": "Country the listing must ship to, as `{\"kind\":\"COUNTRY\",\"country\":\"DE\"}`; `{\"kind\":\"NONE\"}` sets no destination." }, "interpretation": { "description": "`WHOLE_COUNTRY_PER_ITEM_V1` (default) or `WHOLE_COUNTRY_PER_ITEM_FX_V1`, which values `maximumPerItem` in its own currency at the request's exchange rates and requires `maximumPerItem`.", "type": [ "string", "null" ] }, "maximumPerItem": { "anyOf": [ { "$ref": "#/$defs/AmountData" }, { "type": "null" } ], "description": "Highest acceptable shipping price per item, in the amount's own currency; requires a `destination` country. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "referenceRelease": { "description": "Version of the ISO 3166 code list the country code comes from; `iso-codes-4.20.1` is the only accepted value and the default.", "type": [ "string", "null" ] }, "service": { "description": "Shipping service code the terms must include, as free text of at most 128 characters; requires a `destination` country.", "type": [ "string", "null" ] } }, "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "from": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "items": { "items": { "$ref": "#/$defs/SearchFilterData" }, "type": "array" }, "size": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "total": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "items", "from", "size" ], "title": "PaginatedData", "type": "object" } }, { "description": "List the listings on the signed-in user's watchlist with their full details and notification settings, in the requested language and currency. Pass the returned searchAfter array as a JSON string to get the next page. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "currency": { "default": "EUR", "description": "Currency of the returned prices, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "language": { "default": "en", "description": "Language of the returned listing text, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "searchAfter": { "description": "Continuation from the previous page: its `searchAfter` array of [RFC 3339 watchlist creation time, listing ID] serialized as a JSON string, passed back exactly as returned.", "type": [ "string", "null" ] }, "size": { "description": "Number of results per page, from 1 to 100 (default 21); values outside that range are clamped.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "title": "ListInput", "type": "object" }, "name": "getWatchlistProductListings", "outputSchema": { "$defs": { "AuctionScheduleData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "liveStarts": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "lotsBeginClosing": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledEnd": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "AuctionSummaryData": { "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "format": { "type": [ "string", "null" ] }, "name": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "reportedStatus": { "type": [ "string", "null" ] }, "schedule": { "$ref": "#/$defs/AuctionScheduleData" } }, "required": [ "auctionId", "schedule" ], "type": "object" }, "ContentPolicyData": { "oneOf": [ { "properties": { "decision": { "const": "ALLOWED", "type": "string" } }, "required": [ "decision" ], "type": "object" }, { "properties": { "category": { "type": "string" }, "decision": { "const": "REQUIRES_CONSENT", "type": "string" } }, "required": [ "decision", "category" ], "type": "object" } ] }, "ContentVisibilityUserStateData": { "properties": { "showUnassessedOrSensitiveContent": { "type": "boolean" } }, "required": [ "showUnassessedOrSensitiveContent" ], "type": "object" }, "DeliveryAssessmentAttribution": { "description": "Attribution required by the geographic evidence behind the assessed destination.", "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "DeliveryAssessmentExplanation": { "description": "Why eligibility remains undetermined beyond missing caller inputs.", "oneOf": [ { "description": "Partial coverage neither includes nor excludes the destination or service.", "properties": { "code": { "const": "INCOMPLETE_COVERAGE", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "A condition depends on a qualifying amount at this scope, which browsing never supplies.", "properties": { "code": { "const": "QUALIFYING_AMOUNT_REQUIRED", "type": "string" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "code", "scope" ], "type": "object" }, { "description": "Advertised terms or their seller-side facts cannot be interpreted conservatively.", "properties": { "code": { "const": "UNRESOLVED_TERMS", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "Collection depends on shipping eligibility, which remains undetermined.", "properties": { "code": { "const": "SHIPPING_UNDETERMINED", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "The applicable advertised terms assert no eligibility.", "properties": { "code": { "const": "NOT_ASSERTED", "type": "string" } }, "required": [ "code" ], "type": "object" } ] }, "DeliveryAssessmentRequiredInput": { "description": "Inputs a caller can supply whose absence leaves eligibility undetermined.", "enum": [ "DESTINATION", "DESTINATION_COUNTRY", "DESTINATION_SUBDIVISION", "POSTAL_CODE", "QUANTITY", "LOTS", "SHIPMENTS", "SELLER_ORDERS", "VARIANT" ], "type": "string" }, "DeliveryAssessmentSummaryData": { "description": "Assessed eligibility, or the inputs and explanations leaving it undetermined. Omitted\neligibility means unknown or unasserted; only an explicit `NOT_OFFERED` is a negative.", "minProperties": 1, "properties": { "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingShippingPriceData": { "description": "Every advertised price kind. On-request and externally calculated prices stay explicit\nrather than becoming an absent or zero price.", "oneOf": [ { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "FREE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "EXTERNALLY_CALCULATED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "ListingShippingSummaryData": { "description": "Destination-independent summary shared by every viewer of a collection item.", "minProperties": 1, "properties": { "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingSourceSummaryData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" }, "ListingTextData": { "description": "A listing text as the source published it and as shown for the requested language.", "properties": { "localized": { "$ref": "#/$defs/LocalizedTextData", "description": "Text to show for the requested language. Chosen from the translations and the original in\nthe order requested language, `en`, `de`, then any other language, so it can be the\noriginal itself. Always present; compare its `language` with `original.language` to tell\nwhether the text was translated." }, "original": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ], "description": "Text as the source published it, normalized: styled letters and digits are presented as\nordinary text, emoji and ornamental symbols are removed and truncation ellipses remain\nstable. Omitted where the response does not carry the original, such as search and\nsimilar-listing summaries and notification payloads." } }, "required": [ "localized" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "NotificationUserStateData": { "properties": { "unseenNotificationIds": { "items": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" } }, "required": [ "unseenNotificationIds" ], "type": "object" }, "PersonalizedData": { "properties": { "item": { "$ref": "#/$defs/ProductListingDetailsData" }, "userState": { "anyOf": [ { "$ref": "#/$defs/ProductListingUserStateData" }, { "type": "null" } ] } }, "required": [ "item" ], "type": "object" }, "PersonalizedShippingSummaryData": { "description": "Assessment for the caller's selected browsing destination, without echoing it.", "minProperties": 1, "properties": { "attribution": { "$ref": "#/$defs/DeliveryAssessmentAttribution" }, "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "pricePreview": { "$ref": "#/$defs/ShippingPricePreviewData" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "PriceData": { "description": "A monetary amount in the currency's minor units.", "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "currency", "amount" ], "type": "object" }, "ProductListingDetailsData": { "description": "`Shipping` and `Images` follow the response purpose: complete by default, bounded in collections.", "properties": { "auction": { "anyOf": [ { "$ref": "#/$defs/AuctionSummaryData" }, { "type": "null" } ] }, "availability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "contentPolicy": { "anyOf": [ { "$ref": "#/$defs/ContentPolicyData" }, { "type": "null" } ] }, "created": { "format": "date-time", "type": "string" }, "eventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ProductListingImageData" }, { "type": "null" } ] }, "lifecycle": { "enum": [ "ACTIVE", "WITHDRAWN" ], "type": "string" }, "lot": { "anyOf": [ { "$ref": "#/$defs/ProductListingLotData" }, { "type": "null" } ] }, "pricing": { "$ref": "#/$defs/ProductListingPricingPresentationData" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": [ "string", "null" ] }, "shipping": { "$ref": "#/$defs/ListingShippingSummaryData" }, "source": { "$ref": "#/$defs/ListingSourceSummaryData" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "updated": { "format": "date-time", "type": "string" }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "eventId", "source", "sourceListingId", "pricing", "lifecycle", "url", "viewLink", "created", "updated" ], "type": "object" }, "ProductListingImageData": { "properties": { "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingLotData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "cataloguePosition": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": [ "integer", "null" ] }, "lotNumber": { "type": [ "string", "null" ] }, "reportedClosedAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledCloses": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPriceData": { "oneOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "ProductListingPricingData": { "properties": { "price": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "priceEstimateMax": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] }, "priceEstimateMin": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPricingPresentationData": { "properties": { "display": { "$ref": "#/$defs/ProductListingPricingData" }, "source": { "$ref": "#/$defs/ProductListingPricingData" }, "valuation": { "$ref": "#/$defs/ProductListingPricingValuationData" } }, "required": [ "source", "display", "valuation" ], "type": "object" }, "ProductListingPricingValuationData": { "oneOf": [ { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": { "const": "CURRENT", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt" ], "type": "object" }, { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "observedAt": { "format": "date-time", "type": "string" }, "type": { "const": "SALE_OBSERVATION", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt", "observedAt" ], "type": "object" } ] }, "ProductListingUserStateData": { "properties": { "contentVisibility": { "anyOf": [ { "$ref": "#/$defs/ContentVisibilityUserStateData" }, { "type": "null" } ] }, "notification": { "anyOf": [ { "$ref": "#/$defs/NotificationUserStateData" }, { "type": "null" } ] }, "searchFilter": { "anyOf": [ { "$ref": "#/$defs/SearchFilterUserStateData" }, { "type": "null" } ] }, "shipping": { "$ref": "#/$defs/PersonalizedShippingSummaryData" }, "watchlist": { "anyOf": [ { "$ref": "#/$defs/WatchlistUserStateData" }, { "type": "null" } ] } }, "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "SearchFilterUserStateData": { "properties": { "hidden": { "type": "boolean" }, "matchFeedback": { "type": [ "boolean", "null" ] }, "matched": { "type": "boolean" }, "shippingMatchValuation": { "anyOf": [ { "$ref": "#/$defs/ShippingMatchValuationData" }, { "type": "null" } ] }, "userSearchFilterId": { "anyOf": [ { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "userSearchFilterName": { "type": [ "string", "null" ] } }, "required": [ "matched", "hidden" ], "type": "object" }, "ShippingDisplayData": { "description": "Shared valuation of the requested-currency values in one shipping object. Present only\nwhen a value was actually converted; HalfUp rounding uses currency minor-unit exponents.", "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "currency": { "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" ], "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "currency", "fxRateId", "capturedAt" ], "type": "object" }, "ShippingMatchMaximumData": { "properties": { "amount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "ShippingMatchValuationData": { "properties": { "capturedAt": { "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "interpretation": { "type": "string" }, "maximumPerItem": { "$ref": "#/$defs/ShippingMatchMaximumData" } }, "required": [ "interpretation", "fxRateId", "capturedAt", "maximumPerItem" ], "type": "object" }, "ShippingMoneyData": { "description": "Advertised amount in currency minor units; never an authorized quote or checkout total.", "properties": { "amount_minor": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount_minor", "currency" ], "type": "object" }, "ShippingPricePreviewData": { "description": "One advertised rate of an applicable service in the requested currency where convertible.\nIt identifies its service and charge basis and never claims a quantity or total.", "properties": { "basis": { "enum": [ "PER_ITEM", "PER_LOT", "PER_SHIPMENT", "PER_SELLER_ORDER" ], "type": "string" }, "price": { "$ref": "#/$defs/ListingShippingPriceData" }, "service": { "type": "string" } }, "required": [ "service", "basis", "price" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" }, "WatchlistUserStateData": { "properties": { "notifications": { "type": "boolean" }, "watching": { "type": "boolean" } }, "required": [ "watching", "notifications" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "description": "REST-compatible pagination reports the returned item count and a JSON cursor array.", "properties": { "items": { "items": { "$ref": "#/$defs/PersonalizedData" }, "type": "array" }, "searchAfter": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "type": "string" }, { "type": "string" } ], "type": [ "array", "null" ] }, "size": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "total": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "items", "size" ], "title": "CursoredWatchlistData", "type": "object" } }, { "description": "List auctions of the auction houses and platforms that Aura Historia indexes, filtered by provider, format, reported status and schedule period and sorted by creation or schedule time. Use it to find upcoming, running or past auctions. A schedule period needs timeRole, from and to together, and sorting by schedule time needs timeRole. Pass the returned searchAfter object as a JSON string to get the next page.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "format": { "anyOf": [ { "enum": [ "LIVE", "TIMED" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Only auctions of this format." }, "from": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "Start of the schedule period for `timeRole`, as an ISO 8601 date-time with offset; give it together with `to` and `timeRole`." }, "listingSourceId": { "anyOf": [ { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ], "default": null, "description": "Only auctions of this provider, as a listing source ID (`ls_…`)." }, "order": { "anyOf": [ { "enum": [ "asc", "desc" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Sort direction, `asc` or `desc`." }, "pageSize": { "description": "Number of auctions per page, from 1 to 100 (default 21); values outside that range are clamped.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "reportedStatus": { "anyOf": [ { "enum": [ "SCHEDULED", "IN_PROGRESS", "ENDED", "POSTPONED", "CANCELLED" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Only auctions with this status as the provider reports it." }, "searchAfter": { "description": "Continuation from the previous page: its `searchAfter` object serialized as a JSON string, passed back exactly as returned with the same filters and sort.", "type": [ "string", "null" ] }, "sort": { "anyOf": [ { "enum": [ "created", "scheduled" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "`created` (default) orders by creation time; `scheduled` orders by the `timeRole` instant and requires `timeRole`." }, "timeRole": { "anyOf": [ { "enum": [ "BIDDING_OPENS", "LIVE_STARTS", "LOTS_BEGIN_CLOSING", "SCHEDULED_END" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Schedule instant that `from` and `to` filter on and `sort=scheduled` orders by; required with `from`/`to` and with `sort=scheduled`." }, "to": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "End of the schedule period for `timeRole`, as an ISO 8601 date-time with offset; give it together with `from` and `timeRole`." } }, "title": "DirectoryQuery", "type": "object" }, "name": "listAuctions", "outputSchema": { "$defs": { "AuctionScheduleResponseData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "liveStarts": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "lotsBeginClosing": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledEnd": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "DirectoryCursorData": { "additionalProperties": false, "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "created": { "format": "date-time", "type": "string" }, "scheduled": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scope": { "$ref": "#/$defs/DirectoryCursorScopeData" } }, "required": [ "created", "auctionId", "scope" ], "type": "object" }, "DirectoryCursorScopeData": { "additionalProperties": false, "properties": { "format": { "anyOf": [ { "enum": [ "LIVE", "TIMED" ], "type": "string" }, { "type": "null" } ] }, "from": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "listingSourceId": { "anyOf": [ { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "order": { "anyOf": [ { "enum": [ "asc", "desc" ], "type": "string" }, { "type": "null" } ] }, "reportedStatus": { "anyOf": [ { "enum": [ "SCHEDULED", "IN_PROGRESS", "ENDED", "POSTPONED", "CANCELLED" ], "type": "string" }, { "type": "null" } ] }, "sort": { "anyOf": [ { "enum": [ "created", "scheduled" ], "type": "string" }, { "type": "null" } ] }, "timeRole": { "anyOf": [ { "enum": [ "BIDDING_OPENS", "LIVE_STARTS", "LOTS_BEGIN_CLOSING", "SCHEDULED_END" ], "type": "string" }, { "type": "null" } ] }, "to": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "PublicAuctionDirectoryItemData": { "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "created": { "format": "date-time", "type": "string" }, "format": { "anyOf": [ { "enum": [ "LIVE", "TIMED" ], "type": "string" }, { "type": "null" } ] }, "listingSource": { "$ref": "#/$defs/PublicSourceData" }, "name": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "reportedStatus": { "anyOf": [ { "enum": [ "SCHEDULED", "IN_PROGRESS", "ENDED", "POSTPONED", "CANCELLED" ], "type": "string" }, { "type": "null" } ] }, "schedule": { "$ref": "#/$defs/AuctionScheduleResponseData" } }, "required": [ "auctionId", "listingSource", "schedule", "created" ], "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "PublicSourceData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "items": { "items": { "$ref": "#/$defs/PublicAuctionDirectoryItemData" }, "type": "array" }, "pageSize": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "searchAfter": { "anyOf": [ { "$ref": "#/$defs/DirectoryCursorData" }, { "type": "null" } ] } }, "required": [ "items", "pageSize" ], "title": "PublicAuctionDirectoryData", "type": "object" } }, { "description": "List the signed-in user's notifications, such as watchlist changes and new saved-search matches, with each listing as it was when notified, in the requested language. Returns up to size notifications (default 21, 1 to 100); pass the returned searchAfter array as a JSON string to get the next page. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "language": { "default": "en", "description": "Language of the returned notification text, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "searchAfter": { "description": "Continuation from the previous page: its `searchAfter` array of [created time, notification ID] serialized as a JSON string, passed back exactly as returned.", "type": [ "string", "null" ] }, "size": { "description": "Number of results per page, from 1 to 100 (default 21); values outside that range are clamped.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "title": "ListArguments", "type": "object" }, "name": "listNotifications", "outputSchema": { "$defs": { "ListingTextData": { "description": "A listing text as the source published it and as shown for the requested language.", "properties": { "localized": { "$ref": "#/$defs/LocalizedTextData", "description": "Text to show for the requested language. Chosen from the translations and the original in\nthe order requested language, `en`, `de`, then any other language, so it can be the\noriginal itself. Always present; compare its `language` with `original.language` to tell\nwhether the text was translated." }, "original": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ], "description": "Text as the source published it, normalized: styled letters and digits are presented as\nordinary text, emoji and ornamental symbols are removed and truncation ellipses remain\nstable. Omitted where the response does not carry the original, such as search and\nsimilar-listing summaries and notification payloads." } }, "required": [ "localized" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "NotificationContentData": { "anyOf": [ { "$ref": "#/$defs/WatchlistNotificationPayloadData" }, { "$ref": "#/$defs/SearchFilterNotificationPayloadData" }, { "$ref": "#/$defs/PartnershipApplicationNotificationPayloadData" } ] }, "NotificationData": { "properties": { "created": { "format": "date-time", "type": "string" }, "kind": { "enum": [ "WATCHLIST_PRICE_CHANGED", "WATCHLIST_AVAILABILITY_CHANGED", "SEARCH_FILTER_MATCH", "PARTNERSHIP_APPLICATION_APPROVED", "PARTNERSHIP_APPLICATION_REJECTED" ], "type": "string" }, "notificationId": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "payload": { "$ref": "#/$defs/NotificationContentData" }, "seen": { "type": "boolean" }, "updated": { "format": "date-time", "type": "string" } }, "required": [ "notificationId", "seen", "created", "updated", "kind", "payload" ], "type": "object" }, "PartnershipApplicationNotificationPayloadData": { "properties": { "decision": { "enum": [ "APPROVED", "REJECTED" ], "type": "string" }, "image": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] }, "listingSourceName": { "type": "string" }, "partnershipApplicationId": { "pattern": "^pa_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "partyName": { "type": "string" } }, "required": [ "partnershipApplicationId", "decision", "partyName", "listingSourceName" ], "type": "object" }, "ProductListingImageData": { "properties": { "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPriceData": { "oneOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "SearchFilterNotificationPayloadData": { "properties": { "image": { "anyOf": [ { "$ref": "#/$defs/ProductListingImageData" }, { "type": "null" } ] }, "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "listingSourceName": { "type": "string" }, "listingSourcePartner": { "description": "`true` while the ListingSource's operator holds an active Aura Historia partnership, like\n`operator.partner` on listing sources. It is read with the notification, so it turns\n`false` once the partnership ends.", "type": "boolean" }, "listingSourceSlugId": { "type": "string" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": "string" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "userSearchFilterId": { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "userSearchFilterName": { "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "userSearchFilterId", "userSearchFilterName", "listingSourceId", "sourceListingId", "listingSourceSlugId", "productListingTitleSlugId", "listingSourceName", "listingSourcePartner", "url", "viewLink" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" }, "WatchlistNotificationChangeData": { "oneOf": [ { "properties": { "newPrice": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "oldPrice": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "type": { "const": "PRICE_CHANGE", "type": "string" } }, "required": [ "type" ], "type": "object" }, { "properties": { "newAvailability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "oldAvailability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "type": { "const": "AVAILABILITY_CHANGE", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "WatchlistNotificationPayloadData": { "properties": { "change": { "$ref": "#/$defs/WatchlistNotificationChangeData" }, "image": { "anyOf": [ { "$ref": "#/$defs/ProductListingImageData" }, { "type": "null" } ] }, "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "listingSourceName": { "type": "string" }, "listingSourcePartner": { "description": "`true` while the ListingSource's operator holds an active Aura Historia partnership, like\n`operator.partner` on listing sources. It is read with the notification, so it turns\n`false` once the partnership ends.", "type": "boolean" }, "listingSourceSlugId": { "type": "string" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": "string" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "listingSourceId", "sourceListingId", "listingSourceSlugId", "productListingTitleSlugId", "listingSourceName", "listingSourcePartner", "url", "viewLink", "change" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "items": { "items": { "$ref": "#/$defs/NotificationData" }, "type": "array" }, "searchAfter": { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "date-time", "type": "string" }, { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } ], "type": "array" }, "size": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "items", "size" ], "title": "NotificationsPageData", "type": "object" } }, { "description": "List the listings that matched one of the signed-in user's saved searches, oldest match first, in the requested language and currency. Matching runs in the background, so an empty first page means there are no matches yet. Returns up to size matches (default 21, 1 to 100); pass the returned searchAfter array unchanged to get the next page. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "currency": { "default": "EUR", "description": "Currency of the returned prices, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "language": { "default": "en", "description": "Language of the returned listing text, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "searchAfter": { "anyOf": [ { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "date-time", "type": "string" }, { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } ], "type": "array" }, { "type": "null" } ], "default": null, "description": "Continuation from the previous page: its `searchAfter` array of [RFC 3339 match time, listing ID], passed back exactly as returned." }, "size": { "default": null, "description": "Number of results per page, from 1 to 100 (default 21); values outside that range are clamped.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "userSearchFilterId": { "description": "ID of the saved search (`sf_…`).", "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userSearchFilterId" ], "title": "MatchesArguments", "type": "object" }, "name": "listSearchFilterMatches", "outputSchema": { "$defs": { "AuctionScheduleData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "liveStarts": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "lotsBeginClosing": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledEnd": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "AuctionSummaryData": { "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "format": { "type": [ "string", "null" ] }, "name": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "reportedStatus": { "type": [ "string", "null" ] }, "schedule": { "$ref": "#/$defs/AuctionScheduleData" } }, "required": [ "auctionId", "schedule" ], "type": "object" }, "ContentPolicyData": { "oneOf": [ { "properties": { "decision": { "const": "ALLOWED", "type": "string" } }, "required": [ "decision" ], "type": "object" }, { "properties": { "category": { "type": "string" }, "decision": { "const": "REQUIRES_CONSENT", "type": "string" } }, "required": [ "decision", "category" ], "type": "object" } ] }, "ContentVisibilityUserStateData": { "properties": { "showUnassessedOrSensitiveContent": { "type": "boolean" } }, "required": [ "showUnassessedOrSensitiveContent" ], "type": "object" }, "DeliveryAssessmentAttribution": { "description": "Attribution required by the geographic evidence behind the assessed destination.", "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "DeliveryAssessmentExplanation": { "description": "Why eligibility remains undetermined beyond missing caller inputs.", "oneOf": [ { "description": "Partial coverage neither includes nor excludes the destination or service.", "properties": { "code": { "const": "INCOMPLETE_COVERAGE", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "A condition depends on a qualifying amount at this scope, which browsing never supplies.", "properties": { "code": { "const": "QUALIFYING_AMOUNT_REQUIRED", "type": "string" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "code", "scope" ], "type": "object" }, { "description": "Advertised terms or their seller-side facts cannot be interpreted conservatively.", "properties": { "code": { "const": "UNRESOLVED_TERMS", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "Collection depends on shipping eligibility, which remains undetermined.", "properties": { "code": { "const": "SHIPPING_UNDETERMINED", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "The applicable advertised terms assert no eligibility.", "properties": { "code": { "const": "NOT_ASSERTED", "type": "string" } }, "required": [ "code" ], "type": "object" } ] }, "DeliveryAssessmentRequiredInput": { "description": "Inputs a caller can supply whose absence leaves eligibility undetermined.", "enum": [ "DESTINATION", "DESTINATION_COUNTRY", "DESTINATION_SUBDIVISION", "POSTAL_CODE", "QUANTITY", "LOTS", "SHIPMENTS", "SELLER_ORDERS", "VARIANT" ], "type": "string" }, "DeliveryAssessmentSummaryData": { "description": "Assessed eligibility, or the inputs and explanations leaving it undetermined. Omitted\neligibility means unknown or unasserted; only an explicit `NOT_OFFERED` is a negative.", "minProperties": 1, "properties": { "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingShippingPriceData": { "description": "Every advertised price kind. On-request and externally calculated prices stay explicit\nrather than becoming an absent or zero price.", "oneOf": [ { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "FREE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "EXTERNALLY_CALCULATED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "ListingShippingSummaryData": { "description": "Destination-independent summary shared by every viewer of a collection item.", "minProperties": 1, "properties": { "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingSourceSummaryData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" }, "ListingTextData": { "description": "A listing text as the source published it and as shown for the requested language.", "properties": { "localized": { "$ref": "#/$defs/LocalizedTextData", "description": "Text to show for the requested language. Chosen from the translations and the original in\nthe order requested language, `en`, `de`, then any other language, so it can be the\noriginal itself. Always present; compare its `language` with `original.language` to tell\nwhether the text was translated." }, "original": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ], "description": "Text as the source published it, normalized: styled letters and digits are presented as\nordinary text, emoji and ornamental symbols are removed and truncation ellipses remain\nstable. Omitted where the response does not carry the original, such as search and\nsimilar-listing summaries and notification payloads." } }, "required": [ "localized" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "NotificationUserStateData": { "properties": { "unseenNotificationIds": { "items": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" } }, "required": [ "unseenNotificationIds" ], "type": "object" }, "PersonalizedData": { "properties": { "item": { "$ref": "#/$defs/ProductListingDetailsData" }, "userState": { "anyOf": [ { "$ref": "#/$defs/ProductListingUserStateData" }, { "type": "null" } ] } }, "required": [ "item" ], "type": "object" }, "PersonalizedShippingSummaryData": { "description": "Assessment for the caller's selected browsing destination, without echoing it.", "minProperties": 1, "properties": { "attribution": { "$ref": "#/$defs/DeliveryAssessmentAttribution" }, "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "pricePreview": { "$ref": "#/$defs/ShippingPricePreviewData" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "PriceData": { "description": "A monetary amount in the currency's minor units.", "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "currency", "amount" ], "type": "object" }, "ProductListingDetailsData": { "description": "`Shipping` and `Images` follow the response purpose: complete by default, bounded in collections.", "properties": { "auction": { "anyOf": [ { "$ref": "#/$defs/AuctionSummaryData" }, { "type": "null" } ] }, "availability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "contentPolicy": { "anyOf": [ { "$ref": "#/$defs/ContentPolicyData" }, { "type": "null" } ] }, "created": { "format": "date-time", "type": "string" }, "eventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "image": { "anyOf": [ { "$ref": "#/$defs/ProductListingImageData" }, { "type": "null" } ] }, "lifecycle": { "enum": [ "ACTIVE", "WITHDRAWN" ], "type": "string" }, "lot": { "anyOf": [ { "$ref": "#/$defs/ProductListingLotData" }, { "type": "null" } ] }, "pricing": { "$ref": "#/$defs/ProductListingPricingPresentationData" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": [ "string", "null" ] }, "shipping": { "$ref": "#/$defs/ListingShippingSummaryData" }, "source": { "$ref": "#/$defs/ListingSourceSummaryData" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "updated": { "format": "date-time", "type": "string" }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "eventId", "source", "sourceListingId", "pricing", "lifecycle", "url", "viewLink", "created", "updated" ], "type": "object" }, "ProductListingImageData": { "properties": { "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingLotData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "cataloguePosition": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": [ "integer", "null" ] }, "lotNumber": { "type": [ "string", "null" ] }, "reportedClosedAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledCloses": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPriceData": { "oneOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "ProductListingPricingData": { "properties": { "price": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "priceEstimateMax": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] }, "priceEstimateMin": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPricingPresentationData": { "properties": { "display": { "$ref": "#/$defs/ProductListingPricingData" }, "source": { "$ref": "#/$defs/ProductListingPricingData" }, "valuation": { "$ref": "#/$defs/ProductListingPricingValuationData" } }, "required": [ "source", "display", "valuation" ], "type": "object" }, "ProductListingPricingValuationData": { "oneOf": [ { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": { "const": "CURRENT", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt" ], "type": "object" }, { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "observedAt": { "format": "date-time", "type": "string" }, "type": { "const": "SALE_OBSERVATION", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt", "observedAt" ], "type": "object" } ] }, "ProductListingUserStateData": { "properties": { "contentVisibility": { "anyOf": [ { "$ref": "#/$defs/ContentVisibilityUserStateData" }, { "type": "null" } ] }, "notification": { "anyOf": [ { "$ref": "#/$defs/NotificationUserStateData" }, { "type": "null" } ] }, "searchFilter": { "anyOf": [ { "$ref": "#/$defs/SearchFilterUserStateData" }, { "type": "null" } ] }, "shipping": { "$ref": "#/$defs/PersonalizedShippingSummaryData" }, "watchlist": { "anyOf": [ { "$ref": "#/$defs/WatchlistUserStateData" }, { "type": "null" } ] } }, "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "SearchFilterUserStateData": { "properties": { "hidden": { "type": "boolean" }, "matchFeedback": { "type": [ "boolean", "null" ] }, "matched": { "type": "boolean" }, "shippingMatchValuation": { "anyOf": [ { "$ref": "#/$defs/ShippingMatchValuationData" }, { "type": "null" } ] }, "userSearchFilterId": { "anyOf": [ { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "userSearchFilterName": { "type": [ "string", "null" ] } }, "required": [ "matched", "hidden" ], "type": "object" }, "ShippingDisplayData": { "description": "Shared valuation of the requested-currency values in one shipping object. Present only\nwhen a value was actually converted; HalfUp rounding uses currency minor-unit exponents.", "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "currency": { "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" ], "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "currency", "fxRateId", "capturedAt" ], "type": "object" }, "ShippingMatchMaximumData": { "properties": { "amount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "ShippingMatchValuationData": { "properties": { "capturedAt": { "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "interpretation": { "type": "string" }, "maximumPerItem": { "$ref": "#/$defs/ShippingMatchMaximumData" } }, "required": [ "interpretation", "fxRateId", "capturedAt", "maximumPerItem" ], "type": "object" }, "ShippingMoneyData": { "description": "Advertised amount in currency minor units; never an authorized quote or checkout total.", "properties": { "amount_minor": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount_minor", "currency" ], "type": "object" }, "ShippingPricePreviewData": { "description": "One advertised rate of an applicable service in the requested currency where convertible.\nIt identifies its service and charge basis and never claims a quantity or total.", "properties": { "basis": { "enum": [ "PER_ITEM", "PER_LOT", "PER_SHIPMENT", "PER_SELLER_ORDER" ], "type": "string" }, "price": { "$ref": "#/$defs/ListingShippingPriceData" }, "service": { "type": "string" } }, "required": [ "service", "basis", "price" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" }, "WatchlistUserStateData": { "properties": { "notifications": { "type": "boolean" }, "watching": { "type": "boolean" } }, "required": [ "watching", "notifications" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "items": { "items": { "$ref": "#/$defs/PersonalizedData" }, "type": "array" }, "searchAfter": { "anyOf": [ { "maxItems": 2, "minItems": 2, "prefixItems": [ { "format": "date-time", "type": "string" }, { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } ], "type": "array" }, { "type": "null" } ] }, "size": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "total": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "items", "size" ], "title": "SearchFilterMatchesData", "type": "object" } }, { "description": "List the signed-in user's saved addresses with their resolved locations. Returns up to limit addresses (default 25, 1 to 100); pass the returned next as after to get the next page.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "after": { "anyOf": [ { "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ], "default": null, "description": "Continuation from the previous page: its `next` address ID, passed back exactly as returned." }, "limit": { "default": null, "description": "Number of addresses per page, from 1 to 100 (default 25).", "format": "uint32", "maximum": 100, "minimum": 1, "type": [ "integer", "null" ] } }, "title": "PageQuery", "type": "object" }, "name": "listUserAddresses", "outputSchema": { "$defs": { "AddressAttributionData": { "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "AddressData": { "properties": { "addressId": { "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "geography": { "allOf": [ { "$ref": "#/$defs/GeographyData" }, { "properties": { "addressText": { "description": "Free-text address; required for address-book entries.", "maxLength": 4096, "minLength": 1, "type": "string" } }, "required": [ "addressText" ], "type": "object" } ] }, "inputRevision": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "label": { "type": "string" }, "preferred": { "type": "boolean" }, "resolution": { "$ref": "#/$defs/AddressResolutionData" }, "version": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "addressId", "label", "geography", "inputRevision", "version", "preferred", "resolution" ], "type": "object" }, "AddressResolutionData": { "properties": { "attribution": { "anyOf": [ { "$ref": "#/$defs/AddressAttributionData" }, { "type": "null" } ] }, "derived": { "anyOf": [ { "$ref": "#/$defs/DerivedData" }, { "type": "null" } ] }, "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "DerivedData": { "properties": { "geography": { "anyOf": [ { "$ref": "#/$defs/GeographyData" }, { "type": "null" } ] }, "position": { "anyOf": [ { "$ref": "#/$defs/PositionData" }, { "type": "null" } ] } }, "type": "object" }, "GeographyData": { "additionalProperties": false, "properties": { "addressText": { "description": "Free-text address; address-book entries require it.", "type": [ "string", "null" ] }, "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": [ "string", "null" ] }, "postalCode": { "description": "Postal code.", "type": [ "string", "null" ] }, "referenceRelease": { "description": "Version of the ISO 3166 code list the codes come from; `iso-codes-4.20.1` is the only accepted value.", "type": "string" }, "subdivision": { "description": "ISO 3166-2 subdivision code.", "type": [ "string", "null" ] } }, "required": [ "referenceRelease" ], "type": "object" }, "PositionData": { "additionalProperties": false, "properties": { "accuracyMetres": { "format": "double", "type": [ "number", "null" ] }, "latitudeDegrees": { "format": "double", "type": "number" }, "longitudeDegrees": { "format": "double", "type": "number" }, "precision": { "type": "string" } }, "required": [ "latitudeDegrees", "longitudeDegrees", "precision" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "items": { "items": { "$ref": "#/$defs/AddressData" }, "type": "array" }, "next": { "anyOf": [ { "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] } }, "required": [ "items" ], "title": "PageData", "type": "object" } }, { "description": "Turn notifications for a watched listing on or off, or pause (INACTIVE_BY_USER) or resume (ACTIVE) the entry. Omitted fields stay unchanged and null is invalid; resuming is subject to subscription tier limits. Returns the listing with its full details in the requested language and currency. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Existing presentation query used by listing detail and similarity reads.", "properties": { "currency": { "default": "EUR", "description": "Currency of the returned prices, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "language": { "default": "en", "description": "Language of the returned listing text, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "notifications": { "description": "Whether to be notified about changes to the listing; omit to keep the current setting, null is rejected.", "type": "boolean" }, "productListingId": { "description": "ID of the listing (`pl_…`).", "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "state": { "description": "`ACTIVE` or `INACTIVE_BY_USER`; omit to keep the current state, null is rejected.", "enum": [ "ACTIVE", "INACTIVE_BY_USER" ], "type": "string" } }, "required": [ "productListingId" ], "title": "UpdateInput", "type": "object" }, "name": "patchWatchlistProduct", "outputSchema": { "$defs": { "AuctionScheduleData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "liveStarts": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "lotsBeginClosing": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledEnd": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "AuctionSummaryData": { "properties": { "auctionId": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "format": { "type": [ "string", "null" ] }, "name": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ] }, "reportedStatus": { "type": [ "string", "null" ] }, "schedule": { "$ref": "#/$defs/AuctionScheduleData" } }, "required": [ "auctionId", "schedule" ], "type": "object" }, "ContentPolicyData": { "oneOf": [ { "properties": { "decision": { "const": "ALLOWED", "type": "string" } }, "required": [ "decision" ], "type": "object" }, { "properties": { "category": { "type": "string" }, "decision": { "const": "REQUIRES_CONSENT", "type": "string" } }, "required": [ "decision", "category" ], "type": "object" } ] }, "ContentVisibilityUserStateData": { "properties": { "showUnassessedOrSensitiveContent": { "type": "boolean" } }, "required": [ "showUnassessedOrSensitiveContent" ], "type": "object" }, "DeliveryAssessmentAttribution": { "description": "Attribution required by the geographic evidence behind the assessed destination.", "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "DeliveryAssessmentCharge": { "description": "Arithmetic advertised charge for an explicit basis and count; never a quote or landed cost.", "oneOf": [ { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" } ] }, "DeliveryAssessmentExplanation": { "description": "Why eligibility remains undetermined beyond missing caller inputs.", "oneOf": [ { "description": "Partial coverage neither includes nor excludes the destination or service.", "properties": { "code": { "const": "INCOMPLETE_COVERAGE", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "A condition depends on a qualifying amount at this scope, which browsing never supplies.", "properties": { "code": { "const": "QUALIFYING_AMOUNT_REQUIRED", "type": "string" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "code", "scope" ], "type": "object" }, { "description": "Advertised terms or their seller-side facts cannot be interpreted conservatively.", "properties": { "code": { "const": "UNRESOLVED_TERMS", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "Collection depends on shipping eligibility, which remains undetermined.", "properties": { "code": { "const": "SHIPPING_UNDETERMINED", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "The applicable advertised terms assert no eligibility.", "properties": { "code": { "const": "NOT_ASSERTED", "type": "string" } }, "required": [ "code" ], "type": "object" } ] }, "DeliveryAssessmentGeography": { "description": "Minimal area facts: no street, coordinates, address identity or provider evidence.", "properties": { "country": { "pattern": "^[A-Z]{2}$", "type": "string" }, "postalCode": { "type": "string" }, "referenceRelease": { "enum": [ "iso-codes-4.20.1" ], "type": "string" }, "subdivision": { "type": "string" } }, "required": [ "referenceRelease" ], "type": "object" }, "DeliveryAssessmentOption": { "description": "An assessed service of the destination's zone, identified by its code and advertised rate.\nA charge appears only when browsing supplied every count its basis needs.", "minProperties": 1, "properties": { "charge": { "$ref": "#/$defs/DeliveryAssessmentCharge" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "rate": { "$ref": "#/$defs/ListingShippingRateData" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true }, "service": { "type": "string" } }, "required": [ "service" ], "type": "object" }, "DeliveryAssessmentRequiredInput": { "description": "Inputs a caller can supply whose absence leaves eligibility undetermined.", "enum": [ "DESTINATION", "DESTINATION_COUNTRY", "DESTINATION_SUBDIVISION", "POSTAL_CODE", "QUANTITY", "LOTS", "SHIPMENTS", "SELLER_ORDERS", "VARIANT" ], "type": "string" }, "DeliveryAssessmentSummaryData": { "description": "Assessed eligibility, or the inputs and explanations leaving it undetermined. Omitted\neligibility means unknown or unasserted; only an explicit `NOT_OFFERED` is a negative.", "minProperties": 1, "properties": { "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingShippingApplicabilityData": { "description": "Present only when at least one condition is asserted; every asserted condition must hold.", "minProperties": 1, "properties": { "class": { "type": "string" }, "quantity": { "$ref": "#/$defs/ShippingQuantityData" }, "threshold": { "$ref": "#/$defs/ShippingThresholdData" }, "variants": { "items": { "type": "string" }, "maxItems": 64, "minItems": 1, "type": "array" } }, "type": "object" }, "ListingShippingCollectionArrangementData": { "oneOf": [ { "properties": { "kind": { "const": "BY_APPOINTMENT", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "CONTACT_TO_ARRANGE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "duration": { "$ref": "#/$defs/ListingShippingTimeData" }, "kind": { "const": "WINDOW", "type": "string" } }, "required": [ "kind", "duration" ], "type": "object" } ] }, "ListingShippingCollectionData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "arrangement": { "$ref": "#/$defs/ListingShippingCollectionArrangementData" }, "dependency": { "enum": [ "INDEPENDENT", "SHIPPING" ], "type": "string" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" } }, "required": [ "dependency" ], "type": "object" }, "ListingShippingCoverageData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "completeness": { "enum": [ "PARTIAL", "COMPLETE" ], "type": "string" }, "exclusions": { "items": { "$ref": "#/$defs/ShippingAreaData" }, "maxItems": 64, "minItems": 1, "type": "array" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" }, "zones": { "description": "Ordered; the first zone matching a destination applies.", "items": { "$ref": "#/$defs/ListingShippingZoneData" }, "maxItems": 64, "type": "array" } }, "required": [ "reference_release", "completeness", "zones" ], "type": "object" }, "ListingShippingDetailData": { "description": "Effective public terms shared by every viewer of the listing; omitted when unasserted.\nTerms that cannot be resolved leave only the explanation of the undetermined outcome.", "minProperties": 1, "properties": { "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true }, "terms": { "$ref": "#/$defs/ListingShippingTermsData" } }, "type": "object" }, "ListingShippingLeadTimesData": { "minProperties": 1, "properties": { "handling": { "$ref": "#/$defs/ListingShippingTimeData" }, "total": { "$ref": "#/$defs/ListingShippingTimeData" }, "transit": { "$ref": "#/$defs/ListingShippingTimeData" } }, "type": "object" }, "ListingShippingPolicyData": { "oneOf": [ { "properties": { "kind": { "const": "PROHIBITED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "coverage": { "$ref": "#/$defs/ListingShippingCoverageData" }, "kind": { "const": "COVERAGE", "type": "string" } }, "required": [ "kind", "coverage" ], "type": "object" } ] }, "ListingShippingPriceData": { "description": "Every advertised price kind. On-request and externally calculated prices stay explicit\nrather than becoming an absent or zero price.", "oneOf": [ { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "FREE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "EXTERNALLY_CALCULATED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "ListingShippingRateData": { "description": "An advertised rate. `display_price` is the requested-currency value of an amount\nadvertised in another currency; `price` always keeps the advertised source value.", "properties": { "basis": { "enum": [ "PER_ITEM", "PER_LOT", "PER_SHIPMENT", "PER_SELLER_ORDER" ], "type": "string" }, "components": { "additionalProperties": { "enum": [ "INCLUDED", "EXCLUDED" ], "type": "string" }, "minProperties": 1, "propertyNames": { "enum": [ "TRANSPORT", "PACKING", "INSURANCE", "HANDLING", "INSTALLATION", "IMPORT_DUTY", "TAX" ], "type": "string" }, "type": "object" }, "display_price": { "$ref": "#/$defs/ListingShippingPriceData" }, "price": { "$ref": "#/$defs/ListingShippingPriceData" }, "qualifying_scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "price" ], "type": "object" }, "ListingShippingServiceData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "arranger": { "$ref": "#/$defs/ShippingActorData" }, "code": { "type": "string" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "features": { "items": { "enum": [ "TRACKING", "INSURED", "WHITE_GLOVE", "INSTALLATION", "PACKING" ], "type": "string" }, "minItems": 1, "type": "array", "uniqueItems": true }, "lead_times": { "$ref": "#/$defs/ListingShippingLeadTimesData" }, "performer": { "$ref": "#/$defs/ShippingActorData" }, "rate": { "$ref": "#/$defs/ListingShippingRateData" } }, "required": [ "code" ], "type": "object" }, "ListingShippingTermsData": { "minProperties": 1, "properties": { "collection": { "$ref": "#/$defs/ListingShippingCollectionData" }, "shipping": { "$ref": "#/$defs/ListingShippingPolicyData" } }, "type": "object" }, "ListingShippingTimeData": { "properties": { "basis": { "enum": [ "CALENDAR", "BUSINESS" ], "type": "string" }, "maximum": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": "integer" }, "minimum": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": "integer" }, "trigger": { "enum": [ "ORDER", "ORDER_CONFIRMATION", "PAYMENT", "DISPATCH", "READY_FOR_COLLECTION" ], "type": "string" }, "unit": { "enum": [ "HOURS", "DAYS", "WEEKS" ], "type": "string" } }, "required": [ "minimum", "maximum", "unit" ], "type": "object" }, "ListingShippingZoneData": { "properties": { "applicability": { "$ref": "#/$defs/ListingShippingApplicabilityData" }, "areas": { "items": { "$ref": "#/$defs/ShippingAreaData" }, "maxItems": 64, "minItems": 1, "type": "array" }, "services": { "items": { "$ref": "#/$defs/ListingShippingServiceData" }, "maxItems": 64, "minItems": 1, "type": "array" } }, "required": [ "areas", "services" ], "type": "object" }, "ListingSourceSummaryData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" }, "ListingTextData": { "description": "A listing text as the source published it and as shown for the requested language.", "properties": { "localized": { "$ref": "#/$defs/LocalizedTextData", "description": "Text to show for the requested language. Chosen from the translations and the original in\nthe order requested language, `en`, `de`, then any other language, so it can be the\noriginal itself. Always present; compare its `language` with `original.language` to tell\nwhether the text was translated." }, "original": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ], "description": "Text as the source published it, normalized: styled letters and digits are presented as\nordinary text, emoji and ornamental symbols are removed and truncation ellipses remain\nstable. Omitted where the response does not carry the original, such as search and\nsimilar-listing summaries and notification payloads." } }, "required": [ "localized" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "NotificationUserStateData": { "properties": { "unseenNotificationIds": { "items": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" } }, "required": [ "unseenNotificationIds" ], "type": "object" }, "PersonalizedShippingDetailData": { "description": "Assessment for the caller's selected browsing destination.", "minProperties": 1, "properties": { "attribution": { "$ref": "#/$defs/DeliveryAssessmentAttribution" }, "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "destination": { "$ref": "#/$defs/DeliveryAssessmentGeography" }, "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "options": { "items": { "$ref": "#/$defs/DeliveryAssessmentOption" }, "maxItems": 64, "minItems": 1, "type": "array" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "required": [ "destination" ], "type": "object" }, "PriceData": { "description": "A monetary amount in the currency's minor units.", "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "currency", "amount" ], "type": "object" }, "ProductListingDetailsData": { "description": "`Shipping` and `Images` follow the response purpose: complete by default, bounded in collections.", "properties": { "auction": { "anyOf": [ { "$ref": "#/$defs/AuctionSummaryData" }, { "type": "null" } ] }, "availability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "contentPolicy": { "anyOf": [ { "$ref": "#/$defs/ContentPolicyData" }, { "type": "null" } ] }, "created": { "format": "date-time", "type": "string" }, "eventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "images": { "items": { "$ref": "#/$defs/ProductListingImageData" }, "type": "array" }, "lifecycle": { "enum": [ "ACTIVE", "WITHDRAWN" ], "type": "string" }, "lot": { "anyOf": [ { "$ref": "#/$defs/ProductListingLotData" }, { "type": "null" } ] }, "pricing": { "$ref": "#/$defs/ProductListingPricingPresentationData" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": [ "string", "null" ] }, "shipping": { "$ref": "#/$defs/ListingShippingDetailData" }, "source": { "$ref": "#/$defs/ListingSourceSummaryData" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "updated": { "format": "date-time", "type": "string" }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "eventId", "source", "sourceListingId", "pricing", "lifecycle", "url", "viewLink", "images", "created", "updated" ], "type": "object" }, "ProductListingImageData": { "properties": { "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingLotData": { "properties": { "biddingOpens": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "cataloguePosition": { "format": "uint32", "maximum": 4294967295, "minimum": 0, "type": [ "integer", "null" ] }, "lotNumber": { "type": [ "string", "null" ] }, "reportedClosedAt": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "scheduledCloses": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPriceData": { "oneOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "ProductListingPricingData": { "properties": { "price": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "priceEstimateMax": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] }, "priceEstimateMin": { "anyOf": [ { "$ref": "#/$defs/PriceData" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPricingPresentationData": { "properties": { "display": { "$ref": "#/$defs/ProductListingPricingData" }, "source": { "$ref": "#/$defs/ProductListingPricingData" }, "valuation": { "$ref": "#/$defs/ProductListingPricingValuationData" } }, "required": [ "source", "display", "valuation" ], "type": "object" }, "ProductListingPricingValuationData": { "oneOf": [ { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": { "const": "CURRENT", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt" ], "type": "object" }, { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "observedAt": { "format": "date-time", "type": "string" }, "type": { "const": "SALE_OBSERVATION", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt", "observedAt" ], "type": "object" } ] }, "ProductListingUserStateData": { "properties": { "contentVisibility": { "anyOf": [ { "$ref": "#/$defs/ContentVisibilityUserStateData" }, { "type": "null" } ] }, "notification": { "anyOf": [ { "$ref": "#/$defs/NotificationUserStateData" }, { "type": "null" } ] }, "searchFilter": { "anyOf": [ { "$ref": "#/$defs/SearchFilterUserStateData" }, { "type": "null" } ] }, "shipping": { "$ref": "#/$defs/PersonalizedShippingDetailData" }, "watchlist": { "anyOf": [ { "$ref": "#/$defs/WatchlistUserStateData" }, { "type": "null" } ] } }, "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "SearchFilterUserStateData": { "properties": { "hidden": { "type": "boolean" }, "matchFeedback": { "type": [ "boolean", "null" ] }, "matched": { "type": "boolean" }, "shippingMatchValuation": { "anyOf": [ { "$ref": "#/$defs/ShippingMatchValuationData" }, { "type": "null" } ] }, "userSearchFilterId": { "anyOf": [ { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "userSearchFilterName": { "type": [ "string", "null" ] } }, "required": [ "matched", "hidden" ], "type": "object" }, "ShippingActorData": { "oneOf": [ { "properties": { "kind": { "const": "LISTING_SOURCE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "BUYER", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "PARTY", "type": "string" }, "party_id": { "pattern": "^pty_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "kind", "party_id" ], "type": "object" } ] }, "ShippingAreaData": { "oneOf": [ { "properties": { "kind": { "const": "ANYWHERE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "kind": { "const": "DOMESTIC", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "code": { "type": "string" }, "kind": { "const": "COUNTRY", "type": "string" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" } }, "required": [ "kind", "code", "reference_release" ], "type": "object" }, { "properties": { "code": { "type": "string" }, "kind": { "const": "SUBDIVISION", "type": "string" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" } }, "required": [ "kind", "code", "reference_release" ], "type": "object" }, { "properties": { "country": { "type": "string" }, "form": { "$ref": "#/$defs/ShippingPostalFormData" }, "kind": { "const": "POSTAL", "type": "string" }, "reference_release": { "enum": [ "iso-codes-4.20.1" ], "type": "string" }, "version": { "enum": [ "POSTAL_RULE_V1" ], "type": "string" } }, "required": [ "kind", "version", "country", "reference_release", "form" ], "type": "object" }, { "properties": { "assertion": { "type": "string" }, "kind": { "const": "UNRESOLVED", "type": "string" } }, "required": [ "kind", "assertion" ], "type": "object" } ] }, "ShippingDisplayData": { "description": "Shared valuation of the requested-currency values in one shipping object. Present only\nwhen a value was actually converted; HalfUp rounding uses currency minor-unit exponents.", "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "currency": { "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" ], "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "currency", "fxRateId", "capturedAt" ], "type": "object" }, "ShippingMatchMaximumData": { "properties": { "amount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "ShippingMatchValuationData": { "properties": { "capturedAt": { "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "interpretation": { "type": "string" }, "maximumPerItem": { "$ref": "#/$defs/ShippingMatchMaximumData" } }, "required": [ "interpretation", "fxRateId", "capturedAt", "maximumPerItem" ], "type": "object" }, "ShippingMoneyData": { "description": "Advertised amount in currency minor units; never an authorized quote or checkout total.", "properties": { "amount_minor": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount_minor", "currency" ], "type": "object" }, "ShippingPostalFormData": { "oneOf": [ { "properties": { "code": { "type": "string" }, "kind": { "const": "EXACT", "type": "string" } }, "required": [ "kind", "code" ], "type": "object" }, { "properties": { "kind": { "const": "GERMAN_PREFIX", "type": "string" }, "prefix": { "type": "string" } }, "required": [ "kind", "prefix" ], "type": "object" }, { "properties": { "first": { "type": "string" }, "kind": { "const": "GERMAN_RANGE", "type": "string" }, "last": { "type": "string" } }, "required": [ "kind", "first", "last" ], "type": "object" } ] }, "ShippingQuantityData": { "properties": { "maximum": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 1, "type": "integer" }, "minimum": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 1, "type": "integer" } }, "required": [ "minimum", "maximum" ], "type": "object" }, "ShippingThresholdData": { "properties": { "minimum": { "$ref": "#/$defs/ShippingMoneyData" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "minimum", "scope" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" }, "WatchlistUserStateData": { "properties": { "notifications": { "type": "boolean" }, "watching": { "type": "boolean" } }, "required": [ "watching", "notifications" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "item": { "$ref": "#/$defs/ProductListingDetailsData" }, "userState": { "anyOf": [ { "$ref": "#/$defs/ProductListingUserStateData" }, { "type": "null" } ] } }, "required": [ "item" ], "title": "PersonalizedData", "type": "object" } }, { "description": "Search the providers whose listings Aura Historia indexes (dealers, auction houses, marketplaces and auction platforms) by name. Without a query it browses all providers; a query too short to match returns no results. Returns 1 to 50 providers per page (default 21); pass the returned searchAfter unchanged, with the same query and size, to get the next page. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "query": { "default": null, "description": "Optional source-name text; omission or whitespace browses, insufficient text returns no matches.", "type": [ "string", "null" ] }, "searchAfter": { "default": null, "description": "Continuation from the previous page: pass back exactly as returned, with the same `query` and `size`.", "type": [ "string", "null" ] }, "size": { "default": 21, "description": "Number of providers per page, from 1 to 50 (default 21); continuations are bound to the query and page size.", "format": "uint8", "maximum": 255, "minimum": 0, "type": "integer" } }, "title": "SearchPublicListingSourcesData", "type": "object" }, "name": "searchPublicListingSources", "outputSchema": { "$defs": { "PublicListingSourceData": { "properties": { "image": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] }, "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "listingSourceSlugId": { "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ], "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared." }, "viewLink": { "anyOf": [ { "$ref": "#/$defs/ViewLinkData" }, { "type": "null" } ], "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "listingSourceId", "listingSourceSlugId", "name", "operator" ], "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "items": { "items": { "$ref": "#/$defs/PublicListingSourceData" }, "type": "array" }, "searchAfter": { "type": [ "string", "null" ] }, "size": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "items", "size" ], "title": "PublicListingSourceSearchCollectionData", "type": "object" } }, { "description": "Set or clear the destination used to estimate shipping while the signed-in user browses: NONE clears it, ADDRESS selects one of their saved addresses and COUNTRY_POSTAL a country with an optional postal code. expectedVersion must equal the current version. Returns the new destination and version.", "inputSchema": { "$defs": { "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No browsing destination.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "One of the user's saved addresses.", "properties": { "addressId": { "description": "ID of the saved address (`uaddr_…`).", "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "kind": { "const": "ADDRESS", "description": "Selects this variant; always `ADDRESS` here.", "type": "string" } }, "required": [ "kind", "addressId" ], "type": "object" }, { "additionalProperties": false, "description": "A country, optionally with a postal code.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY_POSTAL", "description": "Selects this variant; always `COUNTRY_POSTAL` here.", "type": "string" }, "postalCode": { "description": "Postal code within the country.", "type": [ "string", "null" ] } }, "required": [ "kind", "country" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "destination": { "$ref": "#/$defs/DestinationData", "description": "The browsing destination to store, replacing the current one.", "type": "object" }, "expectedVersion": { "description": "Current version from the last read; a stale version returns CONFLICT.", "format": "uint64", "maximum": 9223372036854776000, "minimum": 1, "type": "integer" } }, "required": [ "expectedVersion", "destination" ], "title": "SetDestinationData", "type": "object" }, "name": "setBrowsingDestination", "outputSchema": { "$defs": { "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No browsing destination.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "One of the user's saved addresses.", "properties": { "addressId": { "description": "ID of the saved address (`uaddr_…`).", "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "kind": { "const": "ADDRESS", "description": "Selects this variant; always `ADDRESS` here.", "type": "string" } }, "required": [ "kind", "addressId" ], "type": "object" }, { "additionalProperties": false, "description": "A country, optionally with a postal code.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY_POSTAL", "description": "Selects this variant; always `COUNTRY_POSTAL` here.", "type": "string" }, "postalCode": { "description": "Postal code within the country.", "type": [ "string", "null" ] } }, "required": [ "kind", "country" ], "type": "object" } ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "destination": { "$ref": "#/$defs/DestinationData" }, "version": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "version", "destination" ], "title": "DestinationResponse", "type": "object" } }, { "description": "Search Aura Historia's index of art, antiques and design objects listed by dealers, auction houses, marketplaces and auction platforms. Use it to find listings by text and by filters such as price, dates, availability, provider, auction, location and shipping. Returns listing summaries in the requested language and currency, with the total when known; pass the returned searchAfter object unchanged to get the next page. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$defs": { "AmountData": { "additionalProperties": false, "properties": { "amount": { "description": "Amount as an integer in the currency's minor unit (EUR cents; JPY whole yen).", "format": "uint64", "maximum": 9223372036854776000, "minimum": 0, "type": "integer" }, "currency": { "description": "ISO 4217 code of the currency the amount is in.", "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "DateRangeSchema": { "properties": { "max": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "End of the range, as an ISO 8601 date-time with offset." }, "min": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "Start of the range, as an ISO 8601 date-time with offset." } }, "type": "object" }, "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No destination country.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "A destination country.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY", "description": "Selects this variant; always `COUNTRY` here.", "type": "string" } }, "required": [ "kind", "country" ], "type": "object" } ] }, "GeographicSearchData": { "additionalProperties": false, "properties": { "countries": { "description": "ISO 3166-1 alpha-2 country codes, at most 100; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" }, "distanceOrder": { "description": "Order results by distance from `origin`, `ASC` (nearest first) or `DESC`; requires `origin`.", "type": [ "string", "null" ] }, "mode": { "description": "Which locations count when measuring distance: `STRICT` (default) only exact premises, `APPROXIMATE` also street, locality and representative points; `APPROXIMATE` needs `origin` with `radius` or `distanceOrder`.", "type": [ "string", "null" ] }, "origin": { "anyOf": [ { "$ref": "#/$defs/OriginData" }, { "type": "null" } ], "description": "Point that `radius` and `distanceOrder` measure from; required by either of them." }, "radius": { "anyOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Distance in `unit`; greater than 0.", "type": "number" }, "unit": { "description": "Unit of `amount`: one of MILES, YARDS, FEET, INCHES, KILOMETERS, METERS, CENTIMETERS, MILLIMETERS, NAUTICAL_MILES.", "type": "string" } }, "required": [ "amount", "unit" ], "type": "object" }, { "type": "null" } ], "description": "Only listings within this distance of `origin`, at most 20,000 km." }, "subdivisions": { "description": "ISO 3166-2 subdivision codes, at most 100, that belong to `countries` when those are given; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "NumberRangeSchema": { "properties": { "max": { "description": "Highest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "min": { "description": "Lowest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "OriginData": { "additionalProperties": false, "properties": { "latitude": { "description": "Latitude in decimal degrees.", "format": "double", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees.", "format": "double", "type": "number" } }, "required": [ "latitude", "longitude" ], "type": "object" }, "ProductListingSearchCursorInputData": { "properties": { "fxRateId": { "description": "Exchange-rate snapshot ID (`fx_…`) from the previous page's `searchAfter`, passed back unchanged.", "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "searchAfter": { "description": "Opaque sort values from the previous page's `searchAfter`, passed back unchanged." } }, "required": [ "fxRateId", "searchAfter" ], "type": "object" }, "ShippingSearchData": { "additionalProperties": false, "properties": { "collectionOffered": { "description": "Only listings that offer collection in person; the only shipping condition that works without a destination country.", "type": "boolean" }, "destination": { "anyOf": [ { "$ref": "#/$defs/DestinationData" }, { "type": "null" } ], "description": "Country the listing must ship to, as `{\"kind\":\"COUNTRY\",\"country\":\"DE\"}`; `{\"kind\":\"NONE\"}` sets no destination." }, "interpretation": { "description": "`WHOLE_COUNTRY_PER_ITEM_V1` (default) or `WHOLE_COUNTRY_PER_ITEM_FX_V1`, which values `maximumPerItem` in its own currency at the request's exchange rates and requires `maximumPerItem`.", "type": [ "string", "null" ] }, "maximumPerItem": { "anyOf": [ { "$ref": "#/$defs/AmountData" }, { "type": "null" } ], "description": "Highest acceptable shipping price per item, in the amount's own currency; requires a `destination` country. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "referenceRelease": { "description": "Version of the ISO 3166 code list the country code comes from; `iso-codes-4.20.1` is the only accepted value and the default.", "type": [ "string", "null" ] }, "service": { "description": "Shipping service code the terms must include, as free text of at most 128 characters; requires a `destination` country.", "type": [ "string", "null" ] } }, "type": "object" }, "SortProductListingFieldData": { "enum": [ "score", "updated", "created" ], "type": "string" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Query options shared by REST extraction and MCP's combined argument envelope.", "properties": { "auctionId": { "default": [], "description": "Only listings that belong to these auctions, given as auction IDs (`auc_…`).", "items": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "availability": { "anyOf": [ { "items": { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings in one of these exact availability states; combined with `orderability`, a listing must satisfy both." }, "created": { "$ref": "#/$defs/DateRangeSchema", "default": null, "description": "Range on the listing's creation time, as ISO 8601 date-times with offset; both bounds inclusive.", "type": "object" }, "currency": { "default": "EUR", "description": "Currency prices are returned in and `price` is interpreted in, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "enhancedSearchDescription": { "default": null, "description": "Optional natural-language description that refines the ranking of `productQuery` results. Only effective together with `productQuery`; on its own it returns unranked, unrelated results.", "type": [ "string", "null" ] }, "excludeListingSourceId": { "default": [], "description": "Leave out listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "excludeProductListingId": { "default": [], "description": "Listing IDs (`pl_…`) to leave out of the results.", "items": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "geography": { "anyOf": [ { "$ref": "#/$defs/GeographicSearchData" }, { "type": "null" } ], "default": null, "description": "Where listings are located, by country, subdivision or distance from a point; every member given must hold." }, "includeUnspecifiedAvailability": { "default": null, "description": "Also include listings that state no availability (default false).", "type": [ "boolean", "null" ] }, "language": { "default": "en", "description": "Language of the returned listing text and of the titles `productQuery` is matched against, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "listingSourceId": { "default": [], "description": "Only listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "lotBiddingOpens": { "$ref": "#/$defs/DateRangeSchema", "default": null, "description": "Range on the time bidding on the lot opens, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive.", "type": "object" }, "lotScheduledCloses": { "$ref": "#/$defs/DateRangeSchema", "default": null, "description": "Range on the lot's scheduled closing time, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive.", "type": "object" }, "order": { "anyOf": [ { "enum": [ "asc", "desc" ], "type": "string" }, { "type": "null" } ], "default": null, "description": "Sort direction, `asc` or `desc` (default `desc`); only valid together with `sort`." }, "orderability": { "anyOf": [ { "items": { "enum": [ "ORDERABLE_NOW", "ORDERABLE_CONDITIONALLY", "NOT_ORDERABLE" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings whose availability falls into one of these orderability groups; combined with `availability`, a listing must satisfy both." }, "price": { "anyOf": [ { "$ref": "#/$defs/NumberRangeSchema" }, { "type": "null" } ], "default": null, "description": "Price range in the request's `currency`, with both bounds inclusive. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "productQuery": { "default": [], "description": "Keyword phrases matched against listing titles; every word of one phrase must match, and a listing matches when any phrase does.", "items": { "minLength": 1, "type": "string" }, "type": "array" }, "searchAfter": { "anyOf": [ { "$ref": "#/$defs/ProductListingSearchCursorInputData" }, { "type": "null" } ], "description": "Continuation from the previous page: pass back exactly as returned by the previous page, with the same filters and sort." }, "shipping": { "anyOf": [ { "$ref": "#/$defs/ShippingSearchData" }, { "type": "null" } ], "default": null, "description": "Only listings whose advertised shipping terms meet these conditions for a destination country; every member given must hold." }, "size": { "description": "Number of results per page, from 1 to 100 (default 21); values outside that range are clamped.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "sort": { "anyOf": [ { "$ref": "#/$defs/SortProductListingFieldData" }, { "type": "null" } ], "description": "Field to order results by: `score` (relevance), `updated` or `created`; cannot be combined with `geography.distanceOrder`." }, "updated": { "$ref": "#/$defs/DateRangeSchema", "default": null, "description": "Range on the listing's last update time, as ISO 8601 date-times with offset; both bounds inclusive.", "type": "object" } }, "title": "SearchInput", "type": "object" }, "name": "simpleSearchProductListings", "outputSchema": { "$defs": { "ContentPolicyData": { "oneOf": [ { "properties": { "decision": { "const": "ALLOWED", "type": "string" } }, "required": [ "decision" ], "type": "object" }, { "properties": { "category": { "type": "string" }, "decision": { "const": "REQUIRES_CONSENT", "type": "string" } }, "required": [ "decision", "category" ], "type": "object" } ] }, "ContentVisibilityUserStateData": { "properties": { "showUnassessedOrSensitiveContent": { "type": "boolean" } }, "required": [ "showUnassessedOrSensitiveContent" ], "type": "object" }, "DeliveryAssessmentAttribution": { "description": "Attribution required by the geographic evidence behind the assessed destination.", "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "DeliveryAssessmentExplanation": { "description": "Why eligibility remains undetermined beyond missing caller inputs.", "oneOf": [ { "description": "Partial coverage neither includes nor excludes the destination or service.", "properties": { "code": { "const": "INCOMPLETE_COVERAGE", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "A condition depends on a qualifying amount at this scope, which browsing never supplies.", "properties": { "code": { "const": "QUALIFYING_AMOUNT_REQUIRED", "type": "string" }, "scope": { "enum": [ "ITEM", "LOT", "SHIPMENT", "SELLER_ORDER" ], "type": "string" } }, "required": [ "code", "scope" ], "type": "object" }, { "description": "Advertised terms or their seller-side facts cannot be interpreted conservatively.", "properties": { "code": { "const": "UNRESOLVED_TERMS", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "Collection depends on shipping eligibility, which remains undetermined.", "properties": { "code": { "const": "SHIPPING_UNDETERMINED", "type": "string" } }, "required": [ "code" ], "type": "object" }, { "description": "The applicable advertised terms assert no eligibility.", "properties": { "code": { "const": "NOT_ASSERTED", "type": "string" } }, "required": [ "code" ], "type": "object" } ] }, "DeliveryAssessmentRequiredInput": { "description": "Inputs a caller can supply whose absence leaves eligibility undetermined.", "enum": [ "DESTINATION", "DESTINATION_COUNTRY", "DESTINATION_SUBDIVISION", "POSTAL_CODE", "QUANTITY", "LOTS", "SHIPMENTS", "SELLER_ORDERS", "VARIANT" ], "type": "string" }, "DeliveryAssessmentSummaryData": { "description": "Assessed eligibility, or the inputs and explanations leaving it undetermined. Omitted\neligibility means unknown or unasserted; only an explicit `NOT_OFFERED` is a negative.", "minProperties": 1, "properties": { "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingGeographyData": { "properties": { "basis": { "type": "string" }, "country": { "type": [ "string", "null" ] }, "distanceKm": { "format": "double", "type": [ "number", "null" ] }, "locationId": { "pattern": "^ploc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "point": { "anyOf": [ { "$ref": "#/$defs/OriginData" }, { "type": "null" } ] }, "precision": { "type": [ "string", "null" ] }, "referenceRelease": { "type": "string" }, "subdivision": { "type": [ "string", "null" ] } }, "required": [ "locationId", "basis", "referenceRelease" ], "type": "object" }, "ListingShippingPriceData": { "description": "Every advertised price kind. On-request and externally calculated prices stay explicit\nrather than becoming an absent or zero price.", "oneOf": [ { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "FREE", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FIXED", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "amount": { "$ref": "#/$defs/ShippingMoneyData" }, "kind": { "const": "FROM", "type": "string" } }, "required": [ "kind", "amount" ], "type": "object" }, { "properties": { "kind": { "const": "ESTIMATED_RANGE", "type": "string" }, "maximum": { "$ref": "#/$defs/ShippingMoneyData" }, "minimum": { "$ref": "#/$defs/ShippingMoneyData" } }, "required": [ "kind", "minimum", "maximum" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "EXTERNALLY_CALCULATED", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "properties": { "currency": { "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" ], "type": "string" }, "kind": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "ListingShippingSummaryData": { "description": "Destination-independent summary shared by every viewer of a collection item.", "minProperties": 1, "properties": { "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ListingSourceSummaryData": { "properties": { "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "slugId": { "type": "string" } }, "required": [ "listingSourceId", "name", "slugId", "operator" ], "type": "object" }, "ListingTextData": { "description": "A listing text as the source published it and as shown for the requested language.", "properties": { "localized": { "$ref": "#/$defs/LocalizedTextData", "description": "Text to show for the requested language. Chosen from the translations and the original in\nthe order requested language, `en`, `de`, then any other language, so it can be the\noriginal itself. Always present; compare its `language` with `original.language` to tell\nwhether the text was translated." }, "original": { "anyOf": [ { "$ref": "#/$defs/LocalizedTextData" }, { "type": "null" } ], "description": "Text as the source published it, normalized: styled letters and digits are presented as\nordinary text, emoji and ornamental symbols are removed and truncation ellipses remain\nstable. Omitted where the response does not carry the original, such as search and\nsimilar-listing summaries and notification payloads." } }, "required": [ "localized" ], "type": "object" }, "LocalizedTextData": { "description": "Text paired with its public language code.", "properties": { "language": { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "text": { "type": "string" } }, "required": [ "text", "language" ], "type": "object" }, "NotificationUserStateData": { "properties": { "unseenNotificationIds": { "items": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" } }, "required": [ "unseenNotificationIds" ], "type": "object" }, "OriginData": { "additionalProperties": false, "properties": { "latitude": { "description": "Latitude in decimal degrees.", "format": "double", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees.", "format": "double", "type": "number" } }, "required": [ "latitude", "longitude" ], "type": "object" }, "PersonalizedData": { "properties": { "item": { "$ref": "#/$defs/ProductListingSummaryData" }, "userState": { "anyOf": [ { "$ref": "#/$defs/ProductListingUserStateData" }, { "type": "null" } ] } }, "required": [ "item" ], "type": "object" }, "PersonalizedShippingSummaryData": { "description": "Assessment for the caller's selected browsing destination, without echoing it.", "minProperties": 1, "properties": { "attribution": { "$ref": "#/$defs/DeliveryAssessmentAttribution" }, "collection": { "$ref": "#/$defs/DeliveryAssessmentSummaryData" }, "display": { "$ref": "#/$defs/ShippingDisplayData" }, "eligibility": { "enum": [ "OFFERED", "NOT_OFFERED", "SUBJECT_TO_CONFIRMATION" ], "type": "string" }, "explanations": { "items": { "$ref": "#/$defs/DeliveryAssessmentExplanation" }, "minItems": 1, "type": "array", "uniqueItems": true }, "pricePreview": { "$ref": "#/$defs/ShippingPricePreviewData" }, "requiredInputs": { "items": { "$ref": "#/$defs/DeliveryAssessmentRequiredInput" }, "minItems": 1, "type": "array", "uniqueItems": true } }, "type": "object" }, "ProductListingImageData": { "properties": { "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] } }, "type": "object" }, "ProductListingPriceData": { "oneOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Unsigned amount in the currency's minor units.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" }, "type": { "const": "MONETARY", "type": "string" } }, "required": [ "type", "currency", "amount" ], "type": "object" }, { "properties": { "type": { "const": "ON_REQUEST", "type": "string" } }, "required": [ "type" ], "type": "object" } ] }, "ProductListingSearchCursorData": { "description": "Public encoding of the ProductListing-owned opaque continuation cursor.", "properties": { "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "searchAfter": true }, "required": [ "fxRateId", "searchAfter" ], "type": "object" }, "ProductListingSummaryData": { "properties": { "auctionId": { "anyOf": [ { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "availability": { "anyOf": [ { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, { "type": "null" } ] }, "contentPolicy": { "anyOf": [ { "$ref": "#/$defs/ContentPolicyData" }, { "type": "null" } ] }, "displayPrice": { "anyOf": [ { "$ref": "#/$defs/ProductListingPriceData" }, { "type": "null" } ] }, "eventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "geography": { "anyOf": [ { "$ref": "#/$defs/ListingGeographyData" }, { "type": "null" } ] }, "image": { "anyOf": [ { "$ref": "#/$defs/ProductListingImageData" }, { "type": "null" } ] }, "lifecycle": { "enum": [ "ACTIVE", "WITHDRAWN" ], "type": "string" }, "priceValuation": { "$ref": "#/$defs/ProductListingSummaryPriceValuationData" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingTitleSlugId": { "type": [ "string", "null" ] }, "shipping": { "$ref": "#/$defs/ListingShippingSummaryData" }, "source": { "$ref": "#/$defs/ListingSourceSummaryData" }, "sourceListingId": { "type": "string" }, "title": { "anyOf": [ { "$ref": "#/$defs/ListingTextData" }, { "type": "null" } ] }, "updated": { "format": "date-time", "type": "string" }, "url": { "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.", "format": "uri", "type": "string" }, "viewLink": { "$ref": "#/$defs/ViewLinkData", "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "productListingId", "eventId", "source", "sourceListingId", "priceValuation", "lifecycle", "url", "viewLink", "updated" ], "type": "object" }, "ProductListingSummaryPriceValuationData": { "oneOf": [ { "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": { "const": "CURRENT", "type": "string" } }, "required": [ "type", "fxRateId", "capturedAt" ], "type": "object" }, { "properties": { "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "observedAt": { "format": "date-time", "type": "string" }, "type": { "const": "SALE_OBSERVATION", "type": "string" } }, "required": [ "type", "fxRateId", "observedAt" ], "type": "object" } ] }, "ProductListingUserStateData": { "properties": { "contentVisibility": { "anyOf": [ { "$ref": "#/$defs/ContentVisibilityUserStateData" }, { "type": "null" } ] }, "notification": { "anyOf": [ { "$ref": "#/$defs/NotificationUserStateData" }, { "type": "null" } ] }, "searchFilter": { "anyOf": [ { "$ref": "#/$defs/SearchFilterUserStateData" }, { "type": "null" } ] }, "shipping": { "$ref": "#/$defs/PersonalizedShippingSummaryData" }, "watchlist": { "anyOf": [ { "$ref": "#/$defs/WatchlistUserStateData" }, { "type": "null" } ] } }, "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "SearchFilterUserStateData": { "properties": { "hidden": { "type": "boolean" }, "matchFeedback": { "type": [ "boolean", "null" ] }, "matched": { "type": "boolean" }, "shippingMatchValuation": { "anyOf": [ { "$ref": "#/$defs/ShippingMatchValuationData" }, { "type": "null" } ] }, "userSearchFilterId": { "anyOf": [ { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, { "type": "null" } ] }, "userSearchFilterName": { "type": [ "string", "null" ] } }, "required": [ "matched", "hidden" ], "type": "object" }, "ShippingDisplayData": { "description": "Shared valuation of the requested-currency values in one shipping object. Present only\nwhen a value was actually converted; HalfUp rounding uses currency minor-unit exponents.", "properties": { "capturedAt": { "format": "date-time", "type": "string" }, "currency": { "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" ], "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "currency", "fxRateId", "capturedAt" ], "type": "object" }, "ShippingMatchMaximumData": { "properties": { "amount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "ShippingMatchValuationData": { "properties": { "capturedAt": { "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "interpretation": { "type": "string" }, "maximumPerItem": { "$ref": "#/$defs/ShippingMatchMaximumData" } }, "required": [ "interpretation", "fxRateId", "capturedAt", "maximumPerItem" ], "type": "object" }, "ShippingMoneyData": { "description": "Advertised amount in currency minor units; never an authorized quote or checkout total.", "properties": { "amount_minor": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount_minor", "currency" ], "type": "object" }, "ShippingPricePreviewData": { "description": "One advertised rate of an applicable service in the requested currency where convertible.\nIt identifies its service and charge basis and never claims a quantity or total.", "properties": { "basis": { "enum": [ "PER_ITEM", "PER_LOT", "PER_SHIPMENT", "PER_SELLER_ORDER" ], "type": "string" }, "price": { "$ref": "#/$defs/ListingShippingPriceData" }, "service": { "type": "string" } }, "required": [ "service", "basis", "price" ], "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" }, "WatchlistUserStateData": { "properties": { "notifications": { "type": "boolean" }, "watching": { "type": "boolean" } }, "required": [ "watching", "notifications" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "items": { "items": { "$ref": "#/$defs/PersonalizedData" }, "type": "array" }, "searchAfter": { "anyOf": [ { "$ref": "#/$defs/ProductListingSearchCursorData" }, { "type": "null" } ] }, "size": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "total": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "items", "size" ], "title": "CursoredProductListingsData", "type": "object" } }, { "description": "Mark every notification of the signed-in user as seen or unseen, including those beyond the listed page. Returns an empty object.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "seen": { "description": "`true` marks as seen, `false` as unseen.", "type": "boolean" } }, "required": [ "seen" ], "title": "AllSeenArguments", "type": "object" }, "name": "updateAllNotificationsSeen", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Structured result of a bodyless business outcome: an empty object rather than `null`,\nbecause tool results never carry JSON `null` members.", "title": "Completed", "type": "object" } }, { "description": "Mark one of the signed-in user's notifications as seen or unseen by notificationId. Returns an empty object; an unknown ID returns NOT_FOUND.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "notificationId": { "description": "ID of the notification (`ntf_…`).", "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "seen": { "description": "`true` marks as seen, `false` as unseen.", "type": "boolean" } }, "required": [ "notificationId", "seen" ], "title": "SingleSeenArguments", "type": "object" }, "name": "updateNotificationSeen", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Structured result of a bodyless business outcome: an empty object rather than `null`,\nbecause tool results never carry JSON `null` members.", "title": "Completed", "type": "object" } }, { "description": "Mark the signed-in user's notifications with the given notificationIds (at least one) as seen or unseen. Unknown IDs are ignored. Returns an empty object.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "notificationIds": { "description": "IDs (`ntf_…`) of the notifications to update; unknown or foreign IDs are ignored and an empty list is rejected.", "items": { "pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "seen": { "description": "`true` marks as seen, `false` as unseen.", "type": "boolean" } }, "required": [ "notificationIds", "seen" ], "title": "SelectedSeenArguments", "type": "object" }, "name": "updateNotificationsSeen", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "description": "Structured result of a bodyless business outcome: an empty object rather than `null`,\nbecause tool results never carry JSON `null` members.", "title": "Completed", "type": "object" } }, { "description": "Record whether a listing that matched one of the signed-in user's saved searches is relevant: true or false sets the feedback, null clears it and omission keeps it. Returns the match; a listing that is not a current match returns NOT_FOUND. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$defs": { "PatchValue_boolean": { "type": [ "boolean", "null" ] } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "feedback": { "$ref": "#/$defs/PatchValue_boolean", "description": "Feedback on the match, `true` or `false`; omit to keep the stored value, null clears it.", "type": [ "boolean", "null" ] }, "productListingId": { "description": "ID of the listing (`pl_…`).", "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "userSearchFilterId": { "description": "ID of the saved search (`sf_…`).", "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userSearchFilterId", "productListingId" ], "title": "FeedbackArguments", "type": "object" }, "name": "updateSearchFilterMatchFeedback", "outputSchema": { "$defs": { "ShippingMatchMaximumData": { "properties": { "amount": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "currency": { "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "ShippingMatchValuationData": { "properties": { "capturedAt": { "type": "string" }, "fxRateId": { "pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "interpretation": { "type": "string" }, "maximumPerItem": { "$ref": "#/$defs/ShippingMatchMaximumData" } }, "required": [ "interpretation", "fxRateId", "capturedAt", "maximumPerItem" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "created": { "format": "date-time", "type": "string" }, "feedback": { "type": [ "boolean", "null" ] }, "originEventId": { "pattern": "^evt_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "productListingId": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "shippingMatchValuation": { "anyOf": [ { "$ref": "#/$defs/ShippingMatchValuationData" }, { "type": "null" } ] }, "updated": { "format": "date-time", "type": "string" }, "userId": { "pattern": "^usr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "userSearchFilterId": { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "userSearchFilterName": { "type": [ "string", "null" ] } }, "required": [ "userId", "userSearchFilterId", "productListingId", "originEventId", "created", "updated" ], "title": "SearchFilterMatchData", "type": "object" } }, { "description": "Update the signed-in user's name, language, currency, measurement unit or whether unassessed or sensitive content is shown. Omitted fields stay unchanged and null clears an optional field; the content preference cannot be null. Returns the updated account.", "inputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "currency": { "anyOf": [ { "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" ], "type": "string" }, { "type": "null" } ], "description": "Preferred currency, as an ISO 4217 code; omit to keep it, null clears it." }, "firstName": { "description": "First name; omit to keep it, null clears it.", "type": [ "string", "null" ] }, "language": { "anyOf": [ { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, { "type": "null" } ], "description": "Preferred language, as an ISO 639-1 code; omit to keep it, null clears it." }, "lastName": { "description": "Last name; omit to keep it, null clears it.", "type": [ "string", "null" ] }, "measurementUnit": { "anyOf": [ { "enum": [ "METRIC", "IMPERIAL" ], "type": "string" }, { "type": "null" } ], "description": "Preferred measurement unit system; omit to keep it, null clears it." }, "showUnassessedOrSensitiveContent": { "description": "Whether listings with unassessed or sensitive content are shown; omit to keep it, null is rejected.", "type": "boolean" } }, "title": "PatchOwnUserData", "type": "object" }, "name": "updateUserAccount", "outputSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "currency": { "anyOf": [ { "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" ], "type": "string" }, { "type": "null" } ] }, "email": { "type": "string" }, "firstName": { "type": [ "string", "null" ] }, "language": { "anyOf": [ { "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, { "type": "null" } ] }, "lastName": { "type": [ "string", "null" ] }, "marketingEmailConsent": { "type": "boolean" }, "measurementUnit": { "anyOf": [ { "enum": [ "METRIC", "IMPERIAL" ], "type": "string" }, { "type": "null" } ] }, "role": { "enum": [ "USER", "ADMIN" ], "type": "string" }, "showUnassessedOrSensitiveContent": { "type": "boolean" }, "tier": { "enum": [ "FREE", "PRO", "ULTIMATE" ], "type": "string" }, "userId": { "pattern": "^usr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userId", "email", "showUnassessedOrSensitiveContent", "marketingEmailConsent", "tier", "role" ], "title": "OwnUserData", "type": "object" } }, { "description": "Replace the label and location of one of the signed-in user's saved addresses. expectedVersion must equal the address's current version; a stale version returns CONFLICT. Returns the updated address.", "inputSchema": { "$defs": { "GeographyData": { "additionalProperties": false, "properties": { "addressText": { "description": "Free-text address; address-book entries require it.", "type": [ "string", "null" ] }, "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": [ "string", "null" ] }, "postalCode": { "description": "Postal code.", "type": [ "string", "null" ] }, "referenceRelease": { "description": "Version of the ISO 3166 code list the codes come from; `iso-codes-4.20.1` is the only accepted value.", "type": "string" }, "subdivision": { "description": "ISO 3166-2 subdivision code.", "type": [ "string", "null" ] } }, "required": [ "referenceRelease" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "addressId": { "description": "ID of the saved address (`uaddr_…`).", "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "expectedVersion": { "description": "Current version from the last read; a stale version returns CONFLICT.", "format": "uint64", "maximum": 9223372036854776000, "minimum": 1, "type": "integer" }, "geography": { "allOf": [ { "$ref": "#/$defs/GeographyData" }, { "properties": { "addressText": { "description": "Free-text address; required for address-book entries.", "maxLength": 4096, "minLength": 1, "type": "string" } }, "required": [ "addressText" ], "type": "object" } ], "description": "New location of the address, replacing the current one entirely.", "type": "object" }, "label": { "description": "New name of the address, replacing the current one.", "type": "string" } }, "required": [ "addressId", "expectedVersion", "label", "geography" ], "title": "UpdateAddressArguments", "type": "object" }, "name": "updateUserAddress", "outputSchema": { "$defs": { "AddressAttributionData": { "properties": { "attributionUrl": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "attributionUrl" ], "type": "object" }, "AddressResolutionData": { "properties": { "attribution": { "anyOf": [ { "$ref": "#/$defs/AddressAttributionData" }, { "type": "null" } ] }, "derived": { "anyOf": [ { "$ref": "#/$defs/DerivedData" }, { "type": "null" } ] }, "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "DerivedData": { "properties": { "geography": { "anyOf": [ { "$ref": "#/$defs/GeographyData" }, { "type": "null" } ] }, "position": { "anyOf": [ { "$ref": "#/$defs/PositionData" }, { "type": "null" } ] } }, "type": "object" }, "GeographyData": { "additionalProperties": false, "properties": { "addressText": { "description": "Free-text address; address-book entries require it.", "type": [ "string", "null" ] }, "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": [ "string", "null" ] }, "postalCode": { "description": "Postal code.", "type": [ "string", "null" ] }, "referenceRelease": { "description": "Version of the ISO 3166 code list the codes come from; `iso-codes-4.20.1` is the only accepted value.", "type": "string" }, "subdivision": { "description": "ISO 3166-2 subdivision code.", "type": [ "string", "null" ] } }, "required": [ "referenceRelease" ], "type": "object" }, "PositionData": { "additionalProperties": false, "properties": { "accuracyMetres": { "format": "double", "type": [ "number", "null" ] }, "latitudeDegrees": { "format": "double", "type": "number" }, "longitudeDegrees": { "format": "double", "type": "number" }, "precision": { "type": "string" } }, "required": [ "latitudeDegrees", "longitudeDegrees", "precision" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "addressId": { "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "geography": { "allOf": [ { "$ref": "#/$defs/GeographyData" }, { "properties": { "addressText": { "description": "Free-text address; required for address-book entries.", "maxLength": 4096, "minLength": 1, "type": "string" } }, "required": [ "addressText" ], "type": "object" } ] }, "inputRevision": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" }, "label": { "type": "string" }, "preferred": { "type": "boolean" }, "resolution": { "$ref": "#/$defs/AddressResolutionData" }, "version": { "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": "integer" } }, "required": [ "addressId", "label", "geography", "inputRevision", "version", "preferred", "resolution" ], "title": "AddressData", "type": "object" } }, { "description": "Change the name, criteria, state or notification setting of one of the signed-in user's saved searches. Omitted fields stay unchanged and null clears fields that can be cleared; availability, orderability and includeUnspecifiedAvailability change together. Matching against new criteria runs in the background. Returns the saved search. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents.", "inputSchema": { "$defs": { "AcceptShippingDestinationData": { "description": "Optional acceptance guard. The submitted country must equal the authorized address or\npreference's asserted country. Neither the reference nor provider evidence is retained.", "oneOf": [ { "additionalProperties": false, "description": "Compare with the country of one of the user's saved addresses.", "properties": { "addressId": { "description": "ID of the saved address (`uaddr_…`).", "pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "kind": { "const": "ADDRESS", "description": "Selects this variant; always `ADDRESS` here.", "type": "string" } }, "required": [ "kind", "addressId" ], "type": "object" }, { "additionalProperties": false, "description": "Compare with the country of the user's stored browsing destination.", "properties": { "kind": { "const": "PREFERENCE", "description": "Selects this variant; always `PREFERENCE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" } ] }, "AmountData": { "additionalProperties": false, "properties": { "amount": { "description": "Amount as an integer in the currency's minor unit (EUR cents; JPY whole yen).", "format": "uint64", "maximum": 9223372036854776000, "minimum": 0, "type": "integer" }, "currency": { "description": "ISO 4217 code of the currency the amount is in.", "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "DateRangeSchema": { "properties": { "max": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "End of the range, as an ISO 8601 date-time with offset." }, "min": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "Start of the range, as an ISO 8601 date-time with offset." } }, "type": "object" }, "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No destination country.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "A destination country.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY", "description": "Selects this variant; always `COUNTRY` here.", "type": "string" } }, "required": [ "kind", "country" ], "type": "object" } ] }, "GeographicSearchData": { "additionalProperties": false, "properties": { "countries": { "description": "ISO 3166-1 alpha-2 country codes, at most 100; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" }, "distanceOrder": { "description": "Order results by distance from `origin`, `ASC` (nearest first) or `DESC`; requires `origin`.", "type": [ "string", "null" ] }, "mode": { "description": "Which locations count when measuring distance: `STRICT` (default) only exact premises, `APPROXIMATE` also street, locality and representative points; `APPROXIMATE` needs `origin` with `radius` or `distanceOrder`.", "type": [ "string", "null" ] }, "origin": { "anyOf": [ { "$ref": "#/$defs/OriginData" }, { "type": "null" } ], "description": "Point that `radius` and `distanceOrder` measure from; required by either of them." }, "radius": { "anyOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Distance in `unit`; greater than 0.", "type": "number" }, "unit": { "description": "Unit of `amount`: one of MILES, YARDS, FEET, INCHES, KILOMETERS, METERS, CENTIMETERS, MILLIMETERS, NAUTICAL_MILES.", "type": "string" } }, "required": [ "amount", "unit" ], "type": "object" }, { "type": "null" } ], "description": "Only listings within this distance of `origin`, at most 20,000 km." }, "subdivisions": { "description": "ISO 3166-2 subdivision codes, at most 100, that belong to `countries` when those are given; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "NumberRangeSchema": { "properties": { "max": { "description": "Highest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "min": { "description": "Lowest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "type": "object" }, "OriginData": { "additionalProperties": false, "properties": { "latitude": { "description": "Latitude in decimal degrees.", "format": "double", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees.", "format": "double", "type": "number" } }, "required": [ "latitude", "longitude" ], "type": "object" }, "PatchSearchFilterStateData": { "enum": [ "ACTIVE", "INACTIVE_BY_USER" ], "type": "string" }, "PatchValue_GeographicSearchData": { "anyOf": [ { "$ref": "#/$defs/GeographicSearchData" }, { "type": "null" } ] }, "PatchValue_ShippingSearchData": { "anyOf": [ { "$ref": "#/$defs/ShippingSearchData" }, { "type": "null" } ] }, "PatchValue_boolean": { "type": [ "boolean", "null" ] }, "PatchValue_string": { "type": [ "string", "null" ] }, "ProductListingSearchPatchData": { "anyOf": [ { "not": { "anyOf": [ { "required": [ "availability" ] }, { "required": [ "orderability" ] }, { "required": [ "includeUnspecifiedAvailability" ] } ] } }, { "properties": { "availability": { "type": "null" }, "includeUnspecifiedAvailability": { "type": "null" }, "orderability": { "type": "null" } }, "required": [ "availability", "orderability", "includeUnspecifiedAvailability" ] }, { "properties": { "availability": { "type": "array" }, "includeUnspecifiedAvailability": { "type": "boolean" }, "orderability": { "type": "array" } }, "required": [ "availability", "orderability", "includeUnspecifiedAvailability" ] } ], "properties": { "auctionId": { "anyOf": [ { "items": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings that belong to these auctions, given as auction IDs (`auc_…`)." }, "availability": { "anyOf": [ { "items": { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings in one of these exact availability states; combined with `orderability`, a listing must satisfy both." }, "created": { "anyOf": [ { "$ref": "#/$defs/DateRangeSchema" }, { "type": "null" } ], "description": "Range on the listing's creation time, as ISO 8601 date-times with offset; both bounds inclusive." }, "currency": { "description": "Currency prices are returned in and `price` is interpreted in, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "enhancedSearchDescription": { "$ref": "#/$defs/PatchValue_string", "description": "Optional natural-language description that refines the ranking of `productQuery` results. Only effective together with `productQuery`; on its own it returns unranked, unrelated results." }, "excludeListingSourceId": { "description": "Leave out listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "geography": { "$ref": "#/$defs/PatchValue_GeographicSearchData", "description": "Where listings are located, by country, subdivision or distance from a point; every member given must hold." }, "includeUnspecifiedAvailability": { "$ref": "#/$defs/PatchValue_boolean", "description": "Also include listings that state no availability (default false)." }, "language": { "description": "Language of the returned listing text and of the titles `productQuery` is matched against, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi", "de-DE", "de-AT", "de-CH", "de-LU", "de-LI", "en-US", "en-GB", "en-AU", "en-CA", "en-NZ", "en_IE", "fr-FR", "fr-CA", "fr-BE", "fr-CH", "fr-LU", "es-ES", "es-MX", "es-AR", "es-CO", "es-CL", "es-PE", "es-VE", "it-IT", "it-CH", "zh-CN", "zh-Hans", "zh-TW", "zh-Hant", "zh-HK", "pt-PT", "pt-BR", "pl-PL", "tr-TR", "nl-NL", "nl-BE", "cs-CZ", "ja-JP", "ru-RU", "ar-SA", "ar-EG", "ar-AE", "ko-KR", "el-GR", "he-IL", "th-TH", "hi-IN" ], "type": "string" }, "listingSourceId": { "description": "Only listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "lotBiddingOpens": { "anyOf": [ { "$ref": "#/$defs/DateRangeSchema" }, { "type": "null" } ], "description": "Range on the time bidding on the lot opens, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "lotScheduledCloses": { "anyOf": [ { "$ref": "#/$defs/DateRangeSchema" }, { "type": "null" } ], "description": "Range on the lot's scheduled closing time, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "orderability": { "anyOf": [ { "items": { "enum": [ "ORDERABLE_NOW", "ORDERABLE_CONDITIONALLY", "NOT_ORDERABLE" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings whose availability falls into one of these orderability groups; combined with `availability`, a listing must satisfy both." }, "price": { "anyOf": [ { "$ref": "#/$defs/NumberRangeSchema" }, { "type": "null" } ], "description": "Price range in the request's `currency`, with both bounds inclusive. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "productQuery": { "description": "Keyword phrases matched against listing titles; every word of one phrase must match, and a listing matches when any phrase does.", "items": { "minLength": 1, "type": "string" }, "type": "array" }, "shipping": { "$ref": "#/$defs/PatchValue_ShippingSearchData", "description": "Only listings whose advertised shipping terms meet these conditions for a destination country; every member given must hold." }, "updated": { "anyOf": [ { "$ref": "#/$defs/DateRangeSchema" }, { "type": "null" } ], "description": "Range on the listing's last update time, as ISO 8601 date-times with offset; both bounds inclusive." } }, "type": "object" }, "ShippingSearchData": { "additionalProperties": false, "properties": { "collectionOffered": { "description": "Only listings that offer collection in person; the only shipping condition that works without a destination country.", "type": "boolean" }, "destination": { "anyOf": [ { "$ref": "#/$defs/DestinationData" }, { "type": "null" } ], "description": "Country the listing must ship to, as `{\"kind\":\"COUNTRY\",\"country\":\"DE\"}`; `{\"kind\":\"NONE\"}` sets no destination." }, "interpretation": { "description": "`WHOLE_COUNTRY_PER_ITEM_V1` (default) or `WHOLE_COUNTRY_PER_ITEM_FX_V1`, which values `maximumPerItem` in its own currency at the request's exchange rates and requires `maximumPerItem`.", "type": [ "string", "null" ] }, "maximumPerItem": { "anyOf": [ { "$ref": "#/$defs/AmountData" }, { "type": "null" } ], "description": "Highest acceptable shipping price per item, in the amount's own currency; requires a `destination` country. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "referenceRelease": { "description": "Version of the ISO 3166 code list the country code comes from; `iso-codes-4.20.1` is the only accepted value and the default.", "type": [ "string", "null" ] }, "service": { "description": "Shipping service code the terms must include, as free text of at most 128 characters; requires a `destination` country.", "type": [ "string", "null" ] } }, "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "additionalProperties": false, "properties": { "acceptShippingDestination": { "anyOf": [ { "$ref": "#/$defs/AcceptShippingDestinationData" }, { "type": "null" } ], "description": "Optional guard confirming the shipping destination: the filter's shipping country must equal the country of the referenced address or browsing preference." }, "name": { "default": null, "description": "New name, at most 255 characters (longer names are cut off); omit to keep the current name.", "type": [ "string", "null" ] }, "notifications": { "default": null, "description": "Whether matches trigger notifications; omit to keep the current setting.", "type": [ "boolean", "null" ] }, "search": { "anyOf": [ { "$ref": "#/$defs/ProductListingSearchPatchData" }, { "type": "null" } ], "description": "Partial criteria: omitted members stay unchanged, null clears `enhancedSearchDescription`, `auctionId`, `price`, the date ranges and the availability query, and `availability`, `orderability` and `includeUnspecifiedAvailability` are given together or all null." }, "state": { "anyOf": [ { "$ref": "#/$defs/PatchSearchFilterStateData" }, { "type": "null" } ], "description": "`ACTIVE` or `INACTIVE_BY_USER`; omit to keep the current state, and activating a filter checks all its criteria against the current tier." }, "userSearchFilterId": { "description": "ID of the saved search (`sf_…`).", "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userSearchFilterId" ], "title": "UpdateArguments", "type": "object" }, "name": "updateUserSearchFilter", "outputSchema": { "$defs": { "AmountData": { "additionalProperties": false, "properties": { "amount": { "description": "Amount as an integer in the currency's minor unit (EUR cents; JPY whole yen).", "format": "uint64", "maximum": 9223372036854776000, "minimum": 0, "type": "integer" }, "currency": { "description": "ISO 4217 code of the currency the amount is in.", "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" ], "type": "string" } }, "required": [ "amount", "currency" ], "type": "object" }, "DateRangeSchema": { "properties": { "max": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "End of the range, as an ISO 8601 date-time with offset." }, "min": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ], "default": null, "description": "Start of the range, as an ISO 8601 date-time with offset." } }, "required": [ "min", "max" ], "type": "object" }, "DestinationData": { "oneOf": [ { "additionalProperties": false, "description": "No destination country.", "properties": { "kind": { "const": "NONE", "description": "Selects this variant; always `NONE` here.", "type": "string" } }, "required": [ "kind" ], "type": "object" }, { "additionalProperties": false, "description": "A destination country.", "properties": { "country": { "description": "ISO 3166-1 alpha-2 country code.", "type": "string" }, "kind": { "const": "COUNTRY", "description": "Selects this variant; always `COUNTRY` here.", "type": "string" } }, "required": [ "kind", "country" ], "type": "object" } ] }, "GeographicSearchData": { "additionalProperties": false, "properties": { "countries": { "description": "ISO 3166-1 alpha-2 country codes, at most 100; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" }, "distanceOrder": { "description": "Order results by distance from `origin`, `ASC` (nearest first) or `DESC`; requires `origin`.", "type": [ "string", "null" ] }, "mode": { "description": "Which locations count when measuring distance: `STRICT` (default) only exact premises, `APPROXIMATE` also street, locality and representative points; `APPROXIMATE` needs `origin` with `radius` or `distanceOrder`.", "type": [ "string", "null" ] }, "origin": { "anyOf": [ { "$ref": "#/$defs/OriginData" }, { "type": "null" } ], "description": "Point that `radius` and `distanceOrder` measure from; required by either of them." }, "radius": { "anyOf": [ { "additionalProperties": false, "properties": { "amount": { "description": "Distance in `unit`; greater than 0.", "type": "number" }, "unit": { "description": "Unit of `amount`: one of MILES, YARDS, FEET, INCHES, KILOMETERS, METERS, CENTIMETERS, MILLIMETERS, NAUTICAL_MILES.", "type": "string" } }, "required": [ "amount", "unit" ], "type": "object" }, { "type": "null" } ], "description": "Only listings within this distance of `origin`, at most 20,000 km." }, "subdivisions": { "description": "ISO 3166-2 subdivision codes, at most 100, that belong to `countries` when those are given; a listing matches when it is located in any of them.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "NumberRangeSchema": { "properties": { "max": { "description": "Highest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] }, "min": { "description": "Lowest price to include, as an integer amount in the currency's minor unit.", "format": "uint64", "maximum": 18446744073709552000, "minimum": 0, "type": [ "integer", "null" ] } }, "required": [ "min", "max" ], "type": "object" }, "OriginData": { "additionalProperties": false, "properties": { "latitude": { "description": "Latitude in decimal degrees.", "format": "double", "type": "number" }, "longitude": { "description": "Longitude in decimal degrees.", "format": "double", "type": "number" } }, "required": [ "latitude", "longitude" ], "type": "object" }, "ProductListingSearchData": { "properties": { "auctionId": { "description": "Only listings that belong to these auctions, given as auction IDs (`auc_…`).", "items": { "pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "availability": { "anyOf": [ { "items": { "enum": [ "AVAILABLE", "IN_STOCK", "LIMITED_AVAILABILITY", "BACK_ORDER", "MADE_TO_ORDER", "PRE_ORDER", "PRE_SALE", "UNAVAILABLE", "RESERVED", "OUT_OF_STOCK", "SOLD_OUT" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings in one of these exact availability states; combined with `orderability`, a listing must satisfy both." }, "created": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's creation time, as ISO 8601 date-times with offset; both bounds inclusive." }, "currency": { "default": "EUR", "description": "Currency prices are returned in and `price` is interpreted in, as an ISO 4217 code (default `EUR`).", "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" ], "type": "string" }, "enhancedSearchDescription": { "description": "Optional natural-language description that refines the ranking of `productQuery` results. Only effective together with `productQuery`; on its own it returns unranked, unrelated results.", "type": [ "string", "null" ] }, "excludeListingSourceId": { "description": "Leave out listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "excludeProductListingId": { "description": "Listing IDs (`pl_…`) to leave out of the results.", "items": { "pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "geography": { "anyOf": [ { "$ref": "#/$defs/GeographicSearchData" }, { "type": "null" } ], "description": "Where listings are located, by country, subdivision or distance from a point; every member given must hold." }, "includeUnspecifiedAvailability": { "description": "Also include listings that state no availability (default false).", "type": [ "boolean", "null" ] }, "language": { "default": "en", "description": "Language of the returned listing text and of the titles `productQuery` is matched against, as an ISO 639-1 code (default `en`).", "enum": [ "de", "en", "fr", "es", "it", "zh", "pt", "pl", "tr", "nl", "cs", "ja", "ru", "ar", "ko", "el", "he", "th", "hi" ], "type": "string" }, "listingSourceId": { "description": "Only listings from these providers, given as listing source IDs (`ls_…`).", "items": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "type": "array" }, "lotBiddingOpens": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the time bidding on the lot opens, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "lotScheduledCloses": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the lot's scheduled closing time, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive." }, "orderability": { "anyOf": [ { "items": { "enum": [ "ORDERABLE_NOW", "ORDERABLE_CONDITIONALLY", "NOT_ORDERABLE" ], "type": "string" }, "type": "array" }, { "type": "null" } ], "description": "Only listings whose availability falls into one of these orderability groups; combined with `availability`, a listing must satisfy both." }, "price": { "anyOf": [ { "$ref": "#/$defs/NumberRangeSchema" }, { "type": "null" } ], "description": "Price range in the request's `currency`, with both bounds inclusive. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "productQuery": { "description": "Keyword phrases matched against listing titles; every word of one phrase must match, and a listing matches when any phrase does.", "items": { "minLength": 1, "type": "string" }, "type": "array" }, "shipping": { "anyOf": [ { "$ref": "#/$defs/ShippingSearchData" }, { "type": "null" } ], "description": "Only listings whose advertised shipping terms meet these conditions for a destination country; every member given must hold." }, "updated": { "$ref": "#/$defs/DateRangeSchema", "description": "Range on the listing's last update time, as ISO 8601 date-times with offset; both bounds inclusive." } }, "required": [ "language", "currency" ], "type": "object" }, "PublicListingSourceData": { "properties": { "image": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ] }, "listingSourceId": { "pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "listingSourceSlugId": { "type": "string" }, "name": { "type": "string" }, "operator": { "$ref": "#/$defs/PublicListingSourceOperatorData" }, "url": { "anyOf": [ { "format": "uri", "type": "string" }, { "type": "null" } ], "description": "The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared." }, "viewLink": { "anyOf": [ { "$ref": "#/$defs/ViewLinkData" }, { "type": "null" } ], "description": "The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link." } }, "required": [ "listingSourceId", "listingSourceSlugId", "name", "operator" ], "type": "object" }, "PublicListingSourceOperatorData": { "description": "The Party that operates a ListingSource, as shown wherever a source is presented publicly.", "properties": { "name": { "type": "string" }, "partner": { "description": "`true` while the operator Party has an active Aura Historia Partnership, otherwise\n`false`, including after a Partnership is dissolved. Unrelated to ingestion methods and\nreferral configuration.", "type": "boolean" } }, "required": [ "name", "partner" ], "type": "object" }, "ShippingSearchData": { "additionalProperties": false, "properties": { "collectionOffered": { "description": "Only listings that offer collection in person; the only shipping condition that works without a destination country.", "type": "boolean" }, "destination": { "anyOf": [ { "$ref": "#/$defs/DestinationData" }, { "type": "null" } ], "description": "Country the listing must ship to, as `{\"kind\":\"COUNTRY\",\"country\":\"DE\"}`; `{\"kind\":\"NONE\"}` sets no destination." }, "interpretation": { "description": "`WHOLE_COUNTRY_PER_ITEM_V1` (default) or `WHOLE_COUNTRY_PER_ITEM_FX_V1`, which values `maximumPerItem` in its own currency at the request's exchange rates and requires `maximumPerItem`.", "type": [ "string", "null" ] }, "maximumPerItem": { "anyOf": [ { "$ref": "#/$defs/AmountData" }, { "type": "null" } ], "description": "Highest acceptable shipping price per item, in the amount's own currency; requires a `destination` country. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (`211453` = ¥211,453). Follow ISO 4217 exponents." }, "referenceRelease": { "description": "Version of the ISO 3166 code list the country code comes from; `iso-codes-4.20.1` is the only accepted value and the default.", "type": [ "string", "null" ] }, "service": { "description": "Shipping service code the terms must include, as free text of at most 128 characters; requires a `destination` country.", "type": [ "string", "null" ] } }, "type": "object" }, "ViewLinkData": { "description": "The provider link meant to be shared with people, paired with whether it is an affiliate link.", "properties": { "affiliate": { "description": "`true` when `url` is an affiliate link, which can earn Aura Historia a commission when people follow it. `false` when it carries only Aura Historia's tracking parameters or leads to Aura Historia itself.", "type": "boolean" }, "url": { "description": "Link to the provider's page that is meant to be shared with people. It carries Aura Historia's referral tagging, which is lost when its query parameters are changed.", "format": "uri", "type": "string" } }, "required": [ "url", "affiliate" ], "type": "object" } }, "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "created": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "listingSources": { "description": "Public cards of the ListingSources that `search.listingSourceId` and `search.excludeListingSourceId` reference, one per ID, ordered by `listingSourceId`. A source referenced by both lists appears once. An ID whose source no longer exists stays in `search` but has no card. Read-only.", "items": { "$ref": "#/$defs/PublicListingSourceData" }, "type": "array" }, "name": { "type": "string" }, "notifications": { "type": "boolean" }, "search": { "$ref": "#/$defs/ProductListingSearchData" }, "state": { "enum": [ "ACTIVE", "INACTIVE_BY_USER", "INACTIVE_BY_RESTRICTED_PLAN" ], "type": "string" }, "updated": { "anyOf": [ { "format": "date-time", "type": "string" }, { "type": "null" } ] }, "userId": { "pattern": "^usr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" }, "userSearchFilterId": { "pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$", "type": "string" } }, "required": [ "userId", "userSearchFilterId", "name", "notifications", "state", "search", "listingSources" ], "title": "SearchFilterData", "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:531b4fd74c121214acb9c19e576f45045b987438b8fcb96b500c30b953835b5b | sha256sum