{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/aura-historia-com/json-schema/aura-historia-com-public-auction-data-schema.json",
  "title": "PublicAuctionData",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/aura-historia-com-auctions-api-openapi.yml#/components/schemas/PublicAuctionData",
  "type": "object",
  "additionalProperties": false,
  "required": [
    "auctionId",
    "listingSource",
    "name",
    "catalogueUrl",
    "viewUrl",
    "format",
    "schedule",
    "reportedStatus",
    "reportedLotCount",
    "visibleListingCount"
  ],
  "properties": {
    "auctionId": {
      "type": "string",
      "description": "Strict `auc_` UUIDv7 TypeID."
    },
    "listingSource": {
      "$ref": "#/$defs/PublicAuctionSourceData"
    },
    "name": {
      "allOf": [
        {
          "$ref": "#/$defs/LocalizedTextData"
        }
      ]
    },
    "catalogueUrl": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "viewUrl": {
      "type": [
        "string",
        "null"
      ],
      "format": "uri"
    },
    "format": {
      "allOf": [
        {
          "$ref": "#/$defs/AuctionFormatData"
        }
      ]
    },
    "schedule": {
      "$ref": "#/$defs/AuctionScheduleData"
    },
    "reportedStatus": {
      "allOf": [
        {
          "$ref": "#/$defs/AuctionReportedStatusData"
        }
      ]
    },
    "reportedLotCount": {
      "type": [
        "integer",
        "null"
      ],
      "format": "int64",
      "minimum": 0
    },
    "visibleListingCount": {
      "type": "integer",
      "format": "int64",
      "minimum": 0
    }
  },
  "$defs": {
    "AuctionFormatData": {
      "type": "string",
      "enum": [
        "LIVE",
        "TIMED"
      ]
    },
    "AuctionReportedStatusData": {
      "type": "string",
      "enum": [
        "SCHEDULED",
        "IN_PROGRESS",
        "ENDED",
        "POSTPONED",
        "CANCELLED"
      ]
    },
    "AuctionScheduleData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "biddingOpens",
        "liveStarts",
        "lotsBeginClosing",
        "scheduledEnd"
      ],
      "properties": {
        "biddingOpens": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "liveStarts": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "lotsBeginClosing": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "scheduledEnd": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        }
      }
    },
    "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"
    },
    "LocalizedTextData": {
      "type": "object",
      "description": "Text content with language information",
      "required": [
        "text",
        "language"
      ],
      "properties": {
        "text": {
          "type": "string",
          "description": "The text content"
        },
        "language": {
          "$ref": "#/$defs/LanguageData"
        }
      }
    },
    "PublicAuctionSourceData": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "listingSourceId",
        "name",
        "slugId"
      ],
      "properties": {
        "listingSourceId": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "slugId": {
          "type": "string"
        }
      }
    }
  }
}