Aura Historia · Schema

NotificationCollectionData

CompanyAntiquesMarketplaceSearchSoftware-as-a-Service

Properties

Name Type Description
items array
size integer Number of items returned in the current page.
searchAfter arraynull Opaque `[created RFC3339 timestamp, Notification ID]` cursor for the next page; omitted when no further page exists.
View JSON Schema on GitHub

JSON Schema

aura-historia-com-notification-collection-data-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-notification-collection-data-schema.json",
  "title": "NotificationCollectionData",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aura-historia-com-notifications-api-openapi.yml#/components/schemas/NotificationCollectionData",
  "type": "object",
  "required": [
    "items",
    "size"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/NotificationData"
      }
    },
    "size": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "description": "Number of items returned in the current page."
    },
    "searchAfter": {
      "type": [
        "array",
        "null"
      ],
      "minItems": 2,
      "maxItems": 2,
      "items": {
        "type": "string"
      },
      "description": "Opaque `[created RFC3339 timestamp, Notification ID]` cursor for the next page; omitted when no further page exists."
    }
  },
  "$defs": {
    "CurrencyData": {
      "type": "string",
      "enum": [
        "EUR",
        "GBP",
        "USD",
        "AUD",
        "CAD",
        "NZD",
        "CNY",
        "BRL",
        "PLN",
        "TRY",
        "JPY",
        "CZK",
        "RUB",
        "AED",
        "SAR",
        "HKD",
        "SGD",
        "CHF",
        "ZAR",
        "SEK",
        "DKK",
        "NOK",
        "KRW",
        "INR",
        "TWD",
        "HUF",
        "RON",
        "MXN",
        "THB",
        "ARS"
      ],
      "description": "Supported currencies (ISO 4217 codes):\n- EUR: Euro\n- GBP: British Pound\n- USD: US Dollar\n- AUD: Australian Dollar\n- CAD: Canadian Dollar\n- NZD: New Zealand Dollar\n- CNY: Chinese Yuan\n- BRL: Brazilian Real\n- PLN: Polish Złoty\n- TRY: Turkish Lira\n- JPY: Japanese Yen\n- CZK: Czech Koruna\n- RUB: Russian Ruble\n- AED: UAE Dirham\n- SAR: Saudi Riyal\n- HKD: Hong Kong Dollar\n- SGD: Singapore Dollar\n- CHF: Swiss Franc\n- ZAR: South African Rand\n- SEK: Swedish Krona\n- DKK: Danish Krone\n- NOK: Norwegian Krone\n- KRW: South Korean Won\n- INR: Indian Rupee\n- TWD: New Taiwan Dollar\n- HUF: Hungarian Forint\n- RON: Romanian Leu\n- MXN: Mexican Peso\n- THB: Thai Baht\n- ARS: Argentine Peso (2 minor-unit decimal places)\n",
      "default": "EUR"
    },
    "LanguageData": {
      "type": "string",
      "enum": [
        "de",
        "en",
        "fr",
        "es",
        "it",
        "zh",
        "pt",
        "pl",
        "tr",
        "nl",
        "cs",
        "ja",
        "ru",
        "ar"
      ],
      "description": "Supported language codes (ISO 639-1 canonical values):\n- de: German (includes de-DE, de-AT, de-CH, de-LU, de-LI)\n- en: English (includes en-US, en-GB, en-AU, en-CA, en-NZ, and backend-specific accepted alias en_IE)\n- fr: French (includes fr-FR, fr-CA, fr-BE, fr-CH, fr-LU)\n- es: Spanish (includes es-ES, es-MX, es-AR, es-CO, es-CL, es-PE, es-VE)\n- it: Italian (includes it-IT, it-CH)\n- zh: Chinese (Simplified) (includes zh-CN, zh-Hans)\n- pt: Portuguese (includes pt-PT, pt-BR)\n- pl: Polish (includes pl-PL)\n- tr: Turkish (includes tr-TR)\n- nl: Dutch (includes nl-NL, nl-BE)\n- cs: Czech (includes cs-CZ)\n- ja: Japanese (includes ja-JP)\n- ru: Russian (includes ru-RU)\n- ar: Arabic (includes ar-SA, ar-EG, ar-AE)\n\n`de`, `en`, `fr`, `es`, and `it` are fully supported localization/translation-target languages.\n`zh`, `pt`, `pl`, `tr`, `nl`, `cs`, `ja`, `ru`, and `ar` are ingestion-only languages:\nthey can appear in stored/native content and are accepted anywhere `LanguageData` is used,\nbut backend-generated translations and fallback localized strings are not produced in these languages.\n",
      "default": "en"
    },
    "ListingAvailabilityData": {
      "type": "string",
      "enum": [
        "AVAILABLE",
        "IN_STOCK",
        "LIMITED_AVAILABILITY",
        "BACK_ORDER",
        "MADE_TO_ORDER",
        "PRE_ORDER",
        "PRE_SALE",
        "UNAVAILABLE",
        "RESERVED",
        "OUT_OF_STOCK",
        "SOLD_OUT"
      ],
      "description": "Current reliable source assertion of listing purchase availability. Omitted or `null` means Aura has no reliable current assertion."
    },
    "LocalizedTextData": {
      "type": "object",
      "description": "Text content with language information",
      "required": [
        "text",
        "language"
      ],
      "properties": {
        "text": {
          "type": "string",
          "description": "The text content"
        },
        "language": {
          "$ref": "#/$defs/LanguageData"
        }
      }
    },
    "NotificationData": {
      "type": "object",
      "required": [
        "notificationId",
        "kind",
        "payload",
        "seen",
        "created",
        "updated"
      ],
      "properties": {
        "notificationId": {
          "type": "string"
        },
        "kind": {
          "type": "string",
          "enum": [
            "WATCHLIST_PRICE_CHANGED",
            "WATCHLIST_AVAILABILITY_CHANGED",
            "SEARCH_FILTER_MATCH",
            "PARTNERSHIP_APPLICATION_APPROVED",
            "PARTNERSHIP_APPLICATION_REJECTED"
          ]
        },
        "payload": {
          "$ref": "#/$defs/NotificationPayloadData"
        },
        "seen": {
          "type": "boolean"
        },
        "created": {
          "type": "string",
          "format": "date-time"
        },
        "updated": {
          "type": "string",
          "format": "date-time",
          "description": "When the notification state (such as `seen`) last changed; repeating an identical state leaves it unchanged."
        }
      }
    },
    "NotificationPayloadData": {
      "description": "Reason-specific immutable snapshot. Its shape is selected by the parent `NotificationData.kind`.",
      "oneOf": [
        {
          "$ref": "#/$defs/WatchlistNotificationPayloadData"
        },
        {
          "$ref": "#/$defs/SearchFilterNotificationPayloadData"
        },
        {
          "$ref": "#/$defs/PartnershipApplicationNotificationPayloadData"
        }
      ]
    },
    "PartnershipApplicationNotificationPayloadData": {
      "type": "object",
      "required": [
        "partnershipApplicationId",
        "decision",
        "listingSourceName",
        "image"
      ],
      "properties": {
        "partnershipApplicationId": {
          "type": "string"
        },
        "decision": {
          "type": "string",
          "enum": [
            "APPROVED",
            "REJECTED"
          ]
        },
        "listingSourceName": {
          "type": "string"
        },
        "image": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri"
        }
      }
    },
    "ProductListingImageData": {
      "type": "object",
      "description": "Product image after viewer-specific presentation.",
      "required": [
        "url"
      ],
      "properties": {
        "url": {
          "type": [
            "string",
            "null"
          ],
          "format": "uri",
          "description": "URL to the product image, or `null` when it is not shown to this viewer."
        }
      }
    },
    "ProductListingPriceData": {
      "oneOf": [
        {
          "type": "object",
          "required": [
            "type",
            "currency",
            "amount"
          ],
          "additionalProperties": false,
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "MONETARY"
              ]
            },
            "currency": {
              "$ref": "#/$defs/CurrencyData"
            },
            "amount": {
              "type": "integer",
              "minimum": 0
            }
          }
        },
        {
          "type": "object",
          "required": [
            "type"
          ],
          "additionalProperties": false,
          "properties": {
            "type": {
              "type": "string",
              "enum": [
                "ON_REQUEST"
              ]
            }
          }
        }
      ]
    },
    "SearchFilterNotificationPayloadData": {
      "type": "object",
      "required": [
        "productListingId",
        "userSearchFilterId",
        "userSearchFilterName",
        "listingSourceId",
        "sourceListingId",
        "listingSourceSlugId",
        "productListingTitleSlugId",
        "listingSourceName",
        "title",
        "image",
        "url",
        "viewUrl"
      ],
      "properties": {
        "productListingId": {
          "type": "string"
        },
        "userSearchFilterId": {
          "type": "string"
        },
        "userSearchFilterName": {
          "type": "string"
        },
        "listingSourceId": {
          "type": "string"
        },
        "sourceListingId": {
          "type": "string"
        },
        "listingSourceSlugId": {
          "type": "string"
        },
        "productListingTitleSlugId": {
          "type": "string"
        },
        "listingSourceName": {
          "type": "string"
        },
        "title": {
          "allOf": [
            {
              "$ref": "#/$defs/LocalizedTextData"
            }
          ]
        },
        "image": {
          "allOf": [
            {
              "$ref": "#/$defs/ProductListingImageData"
            }
          ]
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "viewUrl": {
          "type": "string",
          "format": "uri"
        }
      }
    },
    "WatchlistNotificationAvailabilityChangeData": {
      "type": "object",
      "required": [
        "type",
        "oldAvailability",
        "newAvailability"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "AVAILABILITY_CHANGE"
          ]
        },
        "oldAvailability": {
          "allOf": [
            {
              "$ref": "#/$defs/ListingAvailabilityData"
            }
          ]
        },
        "newAvailability": {
          "allOf": [
            {
              "$ref": "#/$defs/ListingAvailabilityData"
            }
          ]
        }
      }
    },
    "WatchlistNotificationChangeData": {
      "oneOf": [
        {
          "$ref": "#/$defs/WatchlistNotificationPriceChangeData"
        },
        {
          "$ref": "#/$defs/WatchlistNotificationAvailabilityChangeData"
        }
      ]
    },
    "WatchlistNotificationPayloadData": {
      "type": "object",
      "required": [
        "productListingId",
        "listingSourceId",
        "sourceListingId",
        "listingSourceSlugId",
        "productListingTitleSlugId",
        "listingSourceName",
        "title",
        "image",
        "url",
        "viewUrl",
        "change"
      ],
      "properties": {
        "productListingId": {
          "type": "string"
        },
        "listingSourceId": {
          "type": "string"
        },
        "sourceListingId": {
          "type": "string"
        },
        "listingSourceSlugId": {
          "type": "string"
        },
        "productListingTitleSlugId": {
          "type": "string"
        },
        "listingSourceName": {
          "type": "string"
        },
        "title": {
          "allOf": [
            {
              "$ref": "#/$defs/LocalizedTextData"
            }
          ]
        },
        "image": {
          "allOf": [
            {
              "$ref": "#/$defs/ProductListingImageData"
            }
          ]
        },
        "url": {
          "type": "string",
          "format": "uri"
        },
        "viewUrl": {
          "type": "string",
          "format": "uri"
        },
        "change": {
          "$ref": "#/$defs/WatchlistNotificationChangeData"
        }
      }
    },
    "WatchlistNotificationPriceChangeData": {
      "type": "object",
      "required": [
        "type",
        "oldPrice",
        "newPrice"
      ],
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "PRICE_CHANGE"
          ]
        },
        "oldPrice": {
          "allOf": [
            {
              "$ref": "#/$defs/ProductListingPriceData"
            }
          ],
          "description": "Previous asking-price assertion. Null when unavailable."
        },
        "newPrice": {
          "allOf": [
            {
              "$ref": "#/$defs/ProductListingPriceData"
            }
          ],
          "description": "New asking-price assertion. Null when unavailable."
        }
      }
    }
  }
}

Work with this as data

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

MCP server

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

https://apis.io/mcp

Tools for schemas

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

Call it yourself

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

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

Get an API key

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

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