people

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/trove/main/json-schema/trove-people-schema.json",
  "title": "people",
  "x-generated": "2026-10-21",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/trove-openapi.yml#/components/schemas/people",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The unique identifier for this person/organisation."
    },
    "url": {
      "type": "string",
      "description": "A link to view this article in the Trove API."
    },
    "troveUrl": {
      "type": "string",
      "description": "A link to view this article in the Trove web interface."
    },
    "type": {
      "type": "string",
      "enum": [
        "person",
        "corporatebody",
        "family"
      ]
    },
    "relevance": {
      "$ref": "#/$defs/relevance"
    },
    "primaryName": {
      "type": "string",
      "description": "The person/organisation's primary name with, life dates (where applicable)"
    },
    "primaryDisplayName": {
      "type": "string",
      "description": "The person/organisation's primary name without life dates"
    },
    "alternateName": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Other name(s) that the person/organisation's is/are known by, with life dates (where applicable)"
    },
    "alternateDisplayName": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Other name(s) that the person/organisation's is/are known by, without life dates"
    },
    "identifier": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/identifier"
      },
      "description": "Additional identifiers for the person/organisation."
    },
    "disambiguation": {
      "type": "boolean",
      "description": "Disambiguation information for a person or organisation, to help distinguish people or organisations with the same or similar name"
    },
    "disambiguationName": {
      "type": "array",
      "description": "Disambiguation names and relation (e.g. 'is not')",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "description": "The related disambiguation name."
          },
          "url": {
            "type": "string",
            "description": "A link to the related person/organisation record."
          },
          "reltype": {
            "type": "string",
            "description": "The type of relationship between the two person/organisation records (e.g. may refer to, is not, etc)."
          },
          "reldesc": {
            "type": "string",
            "description": "More information about the relationship between the records."
          }
        }
      }
    },
    "title": {
      "type": "array",
      "description": "Title associated with the person or organization including post-nominals and titles of status to show the awards and honours a person has (not available for organisations)",
      "items": {
        "type": "string"
      }
    },
    "occupation": {
      "type": "array",
      "description": "One or more occupations describing the person (not available for organisations)",
      "items": {
        "type": "string"
      }
    },
    "contributor": {
      "type": "array",
      "description": "The name of the contributor of this person or organisation record to Trove",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The Trove contributor id"
          },
          "nuc": {
            "type": "string",
            "description": "The Trove contributor Nuc. Nuc (id) of the contributor of the person or organisation record to Trove"
          },
          "name": {
            "type": "string",
            "description": "The Trove contributor name. Name of the contributor of the person or organisation record to Trove"
          },
          "url": {
            "type": "string",
            "description": "The Trove contributor Url. A link to access the person or organisation record through the contributing organisation’s external website"
          }
        }
      }
    },
    "biography": {
      "type": "array",
      "description": "A written account of the persons life or brief history of the organisation. Some Trove people and organisation records include multiple biographies contributed by various Trove partners/contributors",
      "items": {
        "type": "object",
        "properties": {
          "contributor": {
            "type": "string",
            "description": "The Trove contributor name. Name of the contributor of the person or organisation biography to Trove"
          },
          "contributorId": {
            "type": "string",
            "description": "The Trove contributorId. Id of the contributor of the person or organisation biography to Trove"
          },
          "id": {
            "type": "string",
            "description": "The URL id for the biography. URL identifier for the person or organization biography on the contributors website"
          },
          "biography": {
            "type": "string",
            "description": "Container element for the biography record for each person or organization biography contributed to Trove"
          }
        }
      }
    },
    "record": {
      "type": "array",
      "description": "Container element for a Dublin Core or EAC-CPF record. These records are contributed to Trove from various sources and have often been converted by Trove or the original contributor to Dublin Core from other formats.",
      "items": {
        "$ref": "#/$defs/record"
      }
    },
    "tagCount": {
      "type": "integer",
      "description": "The number of public tags this person/organisation is in."
    },
    "commentCount": {
      "type": "integer",
      "description": "The number of public comments this person/organisation has."
    },
    "listCount": {
      "type": "integer",
      "description": "The number of public lists this person/organisation is in."
    },
    "tag": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/tag"
      }
    },
    "comment": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/comment"
      }
    },
    "list": {
      "type": "array",
      "items": {
        "$ref": "#/$defs/list"
      }
    },
    "culturallySensitive": {
      "type": "string",
      "description": "An indicator of cultural sensitivity, particularly in respect to First Australians."
    },
    "firstAustralians": {
      "type": "string",
      "description": "Whether the item pertains to First Australians."
    }
  },
  "$defs": {
    "article": {
      "type": "object",
      "properties": {
        "id": {
          "type": "string",
          "description": "Trove newspaper article id."
        },
        "url": {
          "type": "string",
          "description": "Trove newspaper url."
        },
        "identifier": {
          "type": "string",
          "description": "The article identifier. This URL leads to the article view on the Trove web interface."
        },
        "heading": {
          "type": "string",
          "description": "The article heading"
        },
        "category": {
          "type": "string",
          "enum": [
            "Article",
            "Advertising",
            "Detailed lists, results, guides",
            "Family Notices",
            "Literature",
            "Government Gazette Notices",
            "Government Gazette Tenders and Contracts",
            "Government Gazette Proclamations And Legislation",
            "Government Gazette Private Notices",
            "Government Gazette Budgetary Papers",
            "Government Gazette Index And Contents",
            "Government Gazette Appointments And Employment",
            "Government Gazette Freedom Of Information"
          ],
          "description": "The type of article. Displayed on the Trove web interface as “Category”"
        },
        "title": {
          "description": "The name of the newspaper or periodical this article is found in.",
          "$ref": "#/$defs/articleTitle"
        },
        "edition": {
          "type": "string",
          "description": "If this article appeared in a special newspaper/periodical edition, the name of that edition is included here. In the Trove web interface, this is shown on the page view. e.g. https://trove.nla.gov.au/ndp/del/page/4298413"
        },
        "date": {
          "type": "string",
          "description": "When the issue this article belongs to was published. YYYY-MM-DD."
        },
        "page": {
          "type": "string",
          "description": "Determine the sequence of delivery of the pages in an issue."
        },
        "pageSequence": {
          "type": "string",
          "description": "In addition to the page sequence number, indicates if the article is part of a supplement/section (displayed in the Trove web interface)"
        },
        "pageLabel": {
          "type": "string",
          "description": "Sometimes used to indicate what is printed on the page, or perhaps the page number within a section/supplement. Not displayed in the Trove web interface. Sometimes numeric and sometimes not."
        },
        "status": {
          "type": "string",
          "enum": [
            "coming soon",
            "withdrawn",
            "currently unavailable"
          ],
          "description": "Included if the article is not currently available. Not included for normal articles. New articles are included before they are fully approved. These articles have a status of “coming soon”. They don’t include the full text or a link to view the article in Trove. They may be deleted from Trove. If you want to harvest newspaper articles into your own system, you may prefer to only harvest those added more than a month ago, as most articles which are “coming soon” will be approved within this timeframe. If you do harvest any articles which are “coming soon” you will need to check back later to find out whether they still exist/have been approved/get the Trove link and full text."
        },
        "relevance": {
          "$ref": "#/$defs/relevance"
        },
        "snippet": {
          "type": "string",
          "description": "A small amount of article text containing one or more of the search terms. The matching term/s are enclosed in a <B> element"
        },
        "troveUrl": {
          "type": "string",
          "description": "A link to view this article in the Trove web interface. If this record was retrieved in response to a search, the search terms will be included in the URL which allows them to be highlighted when viewing in the article. This is not available for articles with a status of \"coming soon\". The persistent id for this article can be found in the identifier element. (It does not support search term highlighting)."
        },
        "trovePageUrl": {
          "type": "string",
          "description": "A link to view the first page of this article, in the Trove web interface. This is not available for articles with a status of “coming soon”."
        },
        "supplement": {
          "type": "string",
          "description": "The newspaper/periodical section this article appeared in. In the Trove web interface, this is shown on the page view. A supplement is part of an issue."
        },
        "section": {
          "type": "string",
          "description": "The newspaper/periodical section this article appeared in. In the Trove web interface, this is shown on the page view. A section is part of an issue."
        },
        "illustrated": {
          "type": "string",
          "enum": [
            "Y",
            "N"
          ],
          "description": "Flags whether the article is illustrated or not"
        },
        "wordCount": {
          "type": "string",
          "description": "The number of words in the full text of the article"
        },
        "correctionCount": {
          "type": "string",
          "description": "The number of corrections made to the article. Each correction may involve many lines."
        },
        "tagCount": {
          "type": "string",
          "description": "The number of public tags added to this article by Trove users."
        },
        "commentCount": {
          "type": "string",
          "description": "The number of public comments added to this article by Trove users."
        },
        "listCount": {
          "type": "string",
          "description": "The number of  public Trove user created lists this article has been added to."
        },
        "tag": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/tag"
          },
          "description": "A public tag added to the article. There may be more than one tag element."
        },
        "comment": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/comment"
          },
          "description": "A public comment added to the article. There may be more than one comment element."
        },
        "list": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/list"
          },
          "description": "The name of a public, user created list this article belongs to. There may be more than one list element"
        },
        "lastCorrection": {
          "type": "object",
          "description": "Further information about the most recent correction to this article. The correction itself is not included.",
          "properties": {
            "by": {
              "type": "string",
              "description": "The username of the person who made the most recent correction to this article, or “anonymous”"
            },
            "lastupdated": {
              "type": "string",
              "description": "When the most recent correction was made to this article (UTC timezone)"
            }
          }
        },
        "pdf": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "A link leading to the pdf for the page this article appears on. There may be more than one pdf element if the article appears over multiple pages. PDFs are not available for some articles, such as the Australian Women’s Weekly, and articles with a status of “coming soon”."
        },
        "articleText": {
          "type": "string",
          "description": "The full text of the article, including all corrections. Article paragraphs are enclosed in a <p> element.  Lines are enclosed by <span>. Article text is not available for some articles, such as those from the Australian Women’s Weekly, and articles with a status of “coming soon”. For these articles, there will be no articleText element present."
        },
        "warning": {
          "type": "string",
          "description": "A message to indicate if a newspaper article is not present in the newspaper database, but exists in the Trove index"
        }
      }
    },
    "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"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "comment": {
      "type": "object",
      "properties": {
        "lastupdated": {
          "type": "string",
          "description": "When the comment was most recently added/edited (UTC timezone)."
        },
        "by": {
          "type": "string",
          "description": "The username of the person who added the comment."
        },
        "rating": {
          "type": "string",
          "description": "An optional rating of the item from 0 to 5."
        },
        "value": {
          "type": "string",
          "description": "A public comment added to the work. There may be more than one comment element. Comments can also be added to a version (the version/comment element)."
        }
      }
    },
    "dcRecord": {
      "type": "object",
      "description": "Container element for a Dublin Core record",
      "properties": {
        "title": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "A name given to the resource."
        },
        "type": {
          "type": "array",
          "description": "The nature or genre of the resource.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The nature or genre of the resource."
              },
              "type": {
                "type": "string",
                "description": "Used to identify which Trove category the item belongs in (e.g. book, thesis, audio, video, chart, diagram, etc)."
              }
            }
          }
        },
        "alternative": {
          "type": "array",
          "description": "The alternate name (alternative title) for the item",
          "items": {
            "type": "string"
          }
        },
        "creator": {
          "type": "array",
          "description": "An entity primarily responsible for making the resource. Examples of a Creator include a person, an organisation, or a service.",
          "items": {
            "type": "object",
            "properties": {
              "name": {
                "type": "string",
                "description": "The name of the entity."
              },
              "type": {
                "type": "string",
                "description": "The type of entity (e.g. author, illustrator)."
              }
            }
          }
        },
        "contributor": {
          "type": "array",
          "description": "An entity responsible for making contributions to the resource. Examples of a Contributor include a person, an organisation, or a service.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The name of the entity."
              },
              "type": {
                "type": "string",
                "description": "The type of contributor. Examples include: conferenceOrganiser, owner, photographer."
              }
            }
          }
        },
        "issued": {
          "type": "array",
          "description": "Date of formal issuance (e.g., publication) of the resource. ISO-8601 format dates are used, ie yyyy-mm-dd.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The date."
              },
              "type": {
                "type": "string",
                "description": "The type of issuance"
              }
            }
          }
        },
        "description": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The description text."
              },
              "type": {
                "type": "string",
                "description": "The type of description. Examples include: byline, fulltext, open_fulltext, scale."
              }
            }
          },
          "description": "An account of the resource. Description may include an abstract, a byline or a free-text account of the resource. When the fulltext of an article is available, include it in a description field with the additional attribute type=”fulltext”. Trove will index this text (return the record for a search on a word in the fulltext) but only display the first 200 characters. Users will need to visit your site to view the fulltext. Trove will only index the first 30,000 characters of a description field."
        },
        "date": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "A point or period of time associated with an event in the lifecycle of the resource. ISO-8601 format dates are used, ie yyyy-mm-dd."
        },
        "coverage": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The spatial or temporal topic of the resource, the spatial applicability of the resource, or the jurisdiction under which the resource is relevant. Spatial topic and spatial applicability may be a named place or a location specified by its geographic coordinates. Temporal topic may be a named period, date, or date range. A jurisdiction may be a named administrative entity or a geographic place to which the resource applies. Use of a controlled vocabulary is encouraged but not mandatory."
        },
        "subject": {
          "type": "array",
          "description": "The topic of the content of the resource. Use of a controlled vocabulary such as the Australian Pictorial Thesaurus, LCSH or the Australian Extension to LCSH is encouraged but not mandatory.",
          "items": {
            "type": "string"
          }
        },
        "format": {
          "type": "array",
          "description": "The physical format of the item",
          "items": {
            "type": "string"
          }
        },
        "extent": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "The size or duration of the resource, e.g. the number of pages, size of a computer file or length of a sound recording."
        },
        "audience": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "A class of entity for whom the resource is intended or useful, e.g. Academic, Professional"
        },
        "abstract": {
          "type": "array",
          "description": "A description, summary, abstract, or first few words of this work, if available.",
          "items": {
            "type": "string"
          }
        },
        "tableOfContents": {
          "type": "string",
          "description": "A list of subunits of the resource, e.g. Book chapter headings. This field is split on “-- “ and displayed as a list."
        },
        "language": {
          "type": "array",
          "description": "A language of the resource. ISO-639-2 is preferred (3 letter language codes). Plain text can also be used. If your system keeps ISO-639-1 language codes, combines a language with a country code (ISO-3166), or uses another standard please let the Trove team know at setup time. A special mapping will be applied to your data. Austlang (Aboriginal and Torres Strait Islander languages) codes may be added to this field as described at Austlang Codes.",
          "items": {
            "$ref": "#/$defs/language"
          }
        },
        "temporal": {
          "type": "array",
          "description": "Temporal characteristics of the resource. This can be a year, date range or named period.",
          "items": {
            "type": "string"
          }
        },
        "publisher": {
          "type": "array",
          "description": "An entity responsible for making the resource available. Examples of a publisher include a person, an organisation, or a service. Typically, the name of a publisher should be used to indicate the entity.",
          "items": {
            "type": "string"
          }
        },
        "references": {
          "type": "array",
          "description": "The URL of a related resource that is referenced, cited, or otherwise pointed to by the described resource.",
          "items": {
            "type": "string"
          }
        },
        "relation": {
          "type": "array",
          "description": "A related resource; a version of the work, or a significant part of the work. Recommended best practice is to reference the resource by means of a string or number conforming to a formal identification system, for example a permanent URL. ARC or NHMRC grant numbers can also be entered as a permanent URL.",
          "items": {
            "type": "string"
          }
        },
        "medium": {
          "type": "array",
          "description": "The material or physical carrier of the resource.",
          "items": {
            "type": "string"
          }
        },
        "licenseRef": {
          "type": "array",
          "description": "A URL pointing to a licence – ideally human and machine readable – that explains the terms for use or re-use of the content. RightsStatements.org URLs need to point to the Persistant link to the statement. URLs from Creative Commons and RightsStatements.org are used to populate the rights facets in Trove.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The licence URL."
              },
              "startDate": {
                "type": "string",
                "description": "the date at which these licence conditions begin to apply"
              }
            }
          }
        },
        "identifier": {
          "type": "array",
          "description": "A local system identifier OR A URL to the resource, a version of the resource, or a related item. For long-term viability of the record a permanent URL such as a handle or purl should be used, rather than a system-specific URL. Include the linktype attribute will give Trove further data about the nature of the resource available, and should be included with all URLs.",
          "items": {
            "$ref": "#/$defs/identifier"
          }
        },
        "spatial": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/spatial"
          },
          "description": "Spatial characteristics of the resource, e.g. the location a photograph was taken; can also be used to include MARC Geographic Area Codes (GAC) to apply place facets."
        },
        "isPartOf": {
          "type": "array",
          "description": "A related resource in which the described resource is physically or logically included, e.g. a photograph or manuscript collection",
          "items": {
            "$ref": "#/$defs/isPartOf"
          }
        },
        "bibliographicCitation": {
          "type": "array",
          "description": "A bibliographic reference for the resource. Recommended practice is to include sufficient bibliographic detail to identify the resource as unambiguously as possible.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The citation text."
              },
              "type": {
                "type": "string",
                "description": "The type of citation.  Examples of bibliographic citation types include: publication, volume, issue, pagination, edition, eisbn, isbn, issn, dateIssues, placeOfPub, sourceCreator, dateIssued, yearIssued."
              }
            }
          }
        },
        "rights": {
          "type": "array",
          "description": "Information about rights held in and over the resource. Copyright should be asserted if known. Free text or a URI is acceptable e.g. link to a Creative Commons licence. For better display in Trove a standard licence should be included in the Licence Ref element instead. Rights statements starting with a Creative Commons or RightsStatements.org URI will populate the rights facet with appropriate data.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The rights statement."
              },
              "type": {
                "type": "string",
                "description": "The type of rights statement (e.g. metadata)."
              }
            }
          }
        },
        "freeToRead": {
          "type": "array",
          "description": "Indicates an Open Access item. Including the free_to_read element indicates any user can freely access the full item online without authenticating or having to pay. No content is required in this tag, its presence indicates an item is Open Access and its absence indicates an item is not Open Access.",
          "items": {
            "type": "object",
            "properties": {
              "value": {
                "type": "string",
                "description": "The free to read statement, if present."
              },
              "startDate": {
                "type": "string",
                "description": "the date on which an item becomes free to read, for example when an embargo is lifted. This date should be in ISO-8601 format, ie yyyy-mm-dd."
              },
              "endDate": {
                "type": "string",
                "description": "the date on which the item ceases to be free to read, for example when a free trial period ends. This date should

# --- truncated at 32 KB (66 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/trove/refs/heads/main/json-schema/trove-people-schema.json