{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/trove/main/json-schema/trove-article-title-schema.json",
  "title": "articleTitle",
  "x-generated": "2026-10-21",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/trove-openapi.yml#/components/schemas/articleTitle",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "ID of the newspaper or gazette title."
    },
    "title": {
      "type": "string",
      "description": "Name of the newspaper (or magazine, gazette)"
    },
    "state": {
      "type": "string",
      "enum": [
        "International",
        "National",
        "ACT",
        "New South Wales",
        "Northern Territory",
        "Queensland",
        "South Australia",
        "Tasmania",
        "Victoria",
        "Western Australia"
      ],
      "description": "The state the newspaper or gazette was primarily published in."
    },
    "issn": {
      "type": "string",
      "description": "International Standard Serial Number"
    },
    "publisher": {
      "type": "string",
      "description": "The name of the publisher, where available"
    },
    "place": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Place is the geographic region the item is about (geographic coverage) and includes Australian states and territories and a number of Australia's closest International neighbours"
    },
    "alternateTitles": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Other names for this title"
    },
    "troveUrl": {
      "type": "string",
      "description": "A link to view this newspaper or gazette title in Trove"
    },
    "startDate": {
      "type": "string",
      "description": "The publication date of the easliest issue of this newspaper available in Trove, in the format YYYY-MM-DD."
    },
    "endDate": {
      "type": "string",
      "description": "The publication date of the  most recently issue of this newspaper or gazette available in Trove, in the format YYYY-MM-DD."
    },
    "year": {
      "type": "array",
      "description": "A list of the  publication years for this newspaper or gazette that are included in Trove.",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "A year this newspaper or gazette title was published, in the format YYYY."
          },
          "issuecount": {
            "type": "integer",
            "description": "The number of issues  published in this year."
          },
          "issue": {
            "type": "array",
            "description": "Information about a particular issue of this newspaper or gazette",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string",
                  "description": "Issue id"
                },
                "date": {
                  "type": "string",
                  "description": "Date this issue was published, the format YYYY-MM-DD"
                },
                "url": {
                  "type": "string",
                  "description": "URL to view this issue in Trove"
                }
              }
            }
          }
        }
      }
    }
  }
}