Medium

April 23, 2026 ยท View on GitHub

Contains information on the mediums (the materials that are applied in the making of an object) used to describe items in the Harvard Art Museums collections. This information is oftentimes provided by the Harvard Art Museums' conservators as a result of their expertise, technical examination, and/or analysis.

Get Mediums

GET /medium will get all mediums.

Include one or more of the following parameters to filter the items.

ParameterValue
apikeyYOUR API KEY required
qFIELD:VALUE (see Elasticsearch Query String syntax for more options)
size0-9+
page0-9+
sortFIELD NAME or "random" or "random:[SEED NUMBER]"
sortorderasc or desc
fieldscomma separated list of data fields you want in the output
aggregationsee Elasticsearch aggregations
idpipe separated list of record IDs
usedbyFIELD NAME:ID
level[0-9+]
parent[0-9+]

Examples

https://api.harvardartmuseums.org/medium
Returns all of the mediums.

Response

{
    "info": {
        "totalrecordsperquery": 3,
        "totalrecords": 271,
        "pages": 91,
        "page": 1,
        "next": "https://api.harvardartmuseums.org/medium?size=3&page=2",
        "responsetime": "6 ms"
    },
    "records": [
        {
            "objectcount": null,
            "id": 2039518,
            "lastupdate": "2015-11-22T03:18:09-0500",
            "haschildren": 0,
            "level": 1,
            "pathforward": "",
            "name": "Resin",
            "parentmediumid": null,
            "mediumid": 2039518
        },
        {
            "objectcount": null,
            "id": 2036627,
            "lastupdate": "2015-11-22T03:18:09-0500",
            "haschildren": 0,
            "level": 1,
            "pathforward": "",
            "name": "Varnish",
            "parentmediumid": null,
            "mediumid": 2036627
        },
        {
            "objectcount": 14,
            "id": 2035845,
            "lastupdate": "2015-11-22T03:18:09-0500",
            "haschildren": 0,
            "level": 1,
            "pathforward": "",
            "name": "Hair",
            "parentmediumid": null,
            "mediumid": 2035845
        }
    ]
}

Get Medium

GET /medium/MEDIUM_ID will get the full record of the specified medium.

Examples

https://api.harvardartmuseums.org/medium/2028206
Returns the full record for the medium Watercolor.

Response

{
    "mediumid": 2028206,
    "name": "Watercolor",
    "pathforward": "",
    "parentmediumid": null,
    "haschildren": 0,
    "level": 1,
    "objectcount": 2509,
    "id": 2028206,
    "lastupdate": "2015-11-22T03:18:09-0500"
}