Collection of preset query APIs

This is a collection of different common queries to get useful things from the ID Manager data. The majority of these can be retrieved from the generic query endpoint, but these are common patterns and they return a simple version of the response which can be easily used.

Queries can be POSTed to /id-manager/query as JSON (application/json). Note that the response from the query endpoint will be a full AnnotationCollection for the query, rather than the simplified responses returned by the following convenience queries. See Web Annotation documentation for details.

---

What links does this identifier feature in?

This is a helpful diagnostic query that takes an identifier (or the end portion of one), and looks up all the links that it could be part of. Often the unique part of an identifier is at its end, such as a UUID or unique number, and UUIDs in particular might be shared between different URIs. This can be helpful to work out what a given UUID might be from, or some unknown string that looks like it might be an identifier. For example, 'tms:object:id:46977', 'b9719f37-7e4c-49ed-bb9b-5860053c5e6c', or '2008.M.51'

---

HMO URI to RefID

Paste the full HMO URI into the box, and search to see if it is part of any RefIDs.

Query JSON:

{
    "target_generator": "https://data.getty.edu/local/thesaurus/organizations/GRI",
    "body_id": -- HMO URI here --,
    "motivation": "https://data.getty.edu/local/thesaurus/motivations/part_of",
}

---

Web URL (short) to JSON-LD resource

Paste the full web URL (eg http://www.getty.edu/research/collections/object/1004DS), and search for its source JSON-LD

Query JSON:

{
    "target_generator": "https://data.getty.edu/local/thesaurus/generators/lodlvl2",
    "body_id": -- Web URL here --,
    "body_generator: "https://data.getty.edu/local/thesaurus/generators/rcv",
    "motivation": "https://data.getty.edu/local/thesaurus/motivations/related_to",
}

---

Component URI to RefID

Paste the full Component URI into the box, and search for its RefID (if any)

Query JSON:

{
    "target_generator": "https://data.getty.edu/local/thesaurus/organizations/GRI",
    "body_id": -- Component URI here --,
    "body_generator: "https://data.getty.edu/local/thesaurus/generators/lodlvl2",
    "motivation": "https://data.getty.edu/local/thesaurus/motivations/contains-refid",
}

---

RefID to archival JSON-LD resource

Paste the RefID into the box, and search to see if it is contained in any archival JSON-LD resource

Query JSON:

{
    "target_generator": "https://data.getty.edu/local/thesaurus/organizations/GRI",
    "target_id": "urn:getty-local:REFID HERE",
    "body_generator: "https://data.getty.edu/local/thesaurus/generators/lodlvl2",
    "motivation": "https://data.getty.edu/local/thesaurus/motivations/contains-refid",
}

---

HMO URI to Archival component JSON-LD

Paste the full HMO URI into the box, and search to see if it is a child of an archival part JSON-LD resource. This can involve a more complex multistep query if the link between the two is not yet known, but once it has been found, the following query can find the inferred connection between HMO URI and archival component.

Query JSON:

{
    "target_generator": "https://data.getty.edu/local/thesaurus/generators/lodlvl2",
    "body_id": -- HMO URI here --,
    "motivation": "https://data.getty.edu/local/thesaurus/motivations/part_of",
}

---

RefID to list of HMO URIs

Paste the RefID into the box, and retrieve the list of HMO URIs that are marked as being part of this RefID

Query JSON:

{
    "target_generator": "https://data.getty.edu/local/thesaurus/organizations/GRI",
    "body_generator": "https://data.getty.edu/local/thesaurus/generators/rwo",
    "target_id": "urn:getty-local:REFID HERE",
    "motivation": "https://data.getty.edu/local/thesaurus/motivations/part_of",
}

---

List Accession Numbers currently processed for RCV

This will contain the list of Accession numbers marked for eligible for processing for RCV.

Query JSON:

{
    "target_id": "https://data.getty.edu/local/thesaurus/lod-archival-collection",
    "motivation": "https://data.getty.edu/local/thesaurus/motivations/part_of",
}