# Introduction

The Art Institute of Chicago's API provides JSON-formatted data as a REST-style service that allows developers to explore and integrate the museum’s public data into their projects. This API is the same tool that powers our website, our mobile app, and many other technologies in the museum.

If the application you're building will be public, please send it our way! We'd love to share it alongside some of the other projects that use our API. And if you have any questions, please feel free to reach out to us: engineering@artic.edu.

# Quick Start

An API is a structured way that one software application can talk to another. APIs power much of the software we use today, from the apps on our phones and watches to technology we see in sports and TV shows. We have built an API to let people like you easily get our data in an ongoing way.

TIP

Do you want all of our data? Are you running into problems with throttling or deep pagination? Consider using our data dumps instead of our API.

For example, you can access the /artworks listing endpoint in our API by visiting the following URL to see all the published artworks in our collection:

https://api.artic.edu/api/v1/artworks

If you want to see data for just one artwork, you can use the /artworks/{id} detail endpoint. For example, here's Starry Night and the Astronauts by Alma Thomas:

https://api.artic.edu/api/v1/artworks/129884

When you view these URLs in your browser, you might see a jumbled bunch of text. That's OK! If you're using Chrome, install the JSON Formatter extension, hit reload, and the results will be formatted in a way humans can read, too.

There is a lot of data you'll get for each artwork. If you want to only retrieve a certain set of fields, change the fields parameter in the query to list which ones you want, like this:

https://api.artic.edu/api/v1/artworks?fields=id,title,artist_display,date_display,main_reference_number

TIP

The fields parameter expects either an array of field names, or a comma-separated list of field names in a single string (e.g. example above). We encourage you to use it because it makes your queries run faster and lets us track which fields need continued support.

You can paginate through results using page and limit params:

https://api.artic.edu/api/v1/artworks?page=2&limit=100

If you want to search and filter the results, you can do so via our search endpoints. For example, here is a full-text search for all artworks whose metadata contains some mention of cats:

https://api.artic.edu/api/v1/artworks/search?q=cats

Here is the same search, but filtered to only show artworks that are in the public domain:

https://api.artic.edu/api/v1/artworks/search?q=cats&query[term][is_public_domain]=true

Behind the scenes, our search is powered by Elasticsearch. You can use its Query DSL to interact with our API. The example above uses a term query. Other queries we use often include exists and bool. Aggregations are also a powerful tool.

Our API accepts queries through both GET and POST. It might be easier to visualize how the GET query above is structured by comparing it to its POST equivallent:

curl --location --request POST 'https://api.artic.edu/api/v1/artworks/search' \
--header 'Content-Type: application/json' \
--data-raw '{
    "q": "cats",
    "query": {
        "term": {
            "is_public_domain": true
        }
    }
}'

For production use, we recommend using GET and passing the entire query as minified URL-encoded JSON via the params parameter. For example:

https://api.artic.edu/api/v1/artworks/search?params=%7B%22q%22%3A%22cats%22%2C%22query%22%3A%7B%22term%22%3A%7B%22is_public_domain%22%3Atrue%7D%7D%7D

WARNING

Our API is flexible in how it accepts queries, but each method of querying is meant for a specific purpose. See GET vs. POST for more details.

There's a lot of information you can get about our collection, and there's a lot more than artworks in our API. Explore our documentation to learn more!

# Conventions

  • We refer to models in our API as "resources" (e.g. artworks, artists, places)

  • Resources are typically accessed via their endpoints. Each resource has three endpoints:

    • Listing (e.g. /artworks)
    • Detail (e.g. /artworks/{id})
    • Search (e.g. /artworks/search) (optional)

    Some resources might lack a search endpoint if there appears to be no need for it yet.

  • Multi-word endpoints are hyphenated (e.g. /tour-stop).

  • All field names are lowercase and snake case (underscore case).

  • Every resource in the API has id and title fields.

  • Fields that contain a single id reference to another resource are singular and end with _id:

    "artist_id": 51349,
    
  • Fields that contain id references to multiple records from another resource are singular and end with _ids:

    "style_ids": ["TM-4439", "TM-8542", "TM-4441"],
    
  • Fields that contain title references to records from other resources follow naming conventions similar to id-based fields:

    "artist_title": "Ancient Roman",
    "classification_titles": ["modern and contemporary art", "painting"],
    
  • Every title-based field has a keyword subfield in Elasticsearch, which is meant for filters and aggregations. See "New defaults" section in this article for more info.

  • Numeric and boolean fields get parsed into actual numbers and booleans:

    "artwork_id": "45", // BAD
    "date_start": 1942, // GOOD
    
    "is_preferred": "True", // BAD
    "is_in_gallery": true, // GOOD
    
  • We never show any empty strings in the API. We only show null:

    "date_display": "", // BAD
    "artist_display": null, // GOOD
    
  • We prefer to always show all fields, even if they are null for the current record:

    • If a field that typically returns a string, number, or object is empty for a given record, we return it as null, rather than omitting it.

    • If a field typically returns an array, we prefer to return an empty array, rather than returning null. This is done in part for backwards-compatibility reasons.

# Best Practices

Here are some tips that will make your application run faster and/or reduce load on our systems:

  • Cache API responses in your system when possible.

  • Use the fields parameter to tell us exactly what fields you need.

  • Batch detail queries with the multi-id parameter (?ids=).

  • Batch search queries with multi-search (/msearch).

  • When downloading images, use /full/843,/0/default.jpg parameters.

  • When scraping, please use a single thread and self-throttle.

  • Consider using data dumps instead of scraping our API.

# Data Dumps

You can download a dump that contains all of our public data here:

https://github.com/art-institute-of-chicago/api-data

These data dumps are updated nightly. They are generated from our API. As such, they contain the same data as our API, and their schema mirrors that of the API. The data is dumped in JSON format, with one JSON file per record. Records are grouped by API resource type.

Our intention with this approach is to make it easier to adapt code to draw from the data dumps instead of the API, and vice-versa. Since the schema is the same, switching between the two should be relatively straight-forward.

If you notice schema discrepancies between the data dumps and the API, or if you need help with using our data dumps, please open an issue in the api-data repo.

# Data Dumps vs. API?

We recommend using the data dumps for scenarios such as the following:

  • You want to have a full copy of our data for archival purposes.
  • You want to scrape a large result set (>10,000 records).
  • You want to analyze or enhance our data.

Use our API if the following fits your use case:

  • You want to integrate our data into a website or application.
  • You need real-time access to our data.

# Scraping Data

Generally, we ask that you avoid extensive scraping of our API. The API is meant for direct integration into websites and applications. The data dumps are meant for backups and analysis. Scraping our API puts undue stress on our systems. Instead of scraping, please download the data dumps and filter them locally to obtain the data you need.

That said, we don't mind small-scale scraping of our API. It can be convenient to use our search endpoint to filter records and retrieve only the fields you need. You can even use the aggregation functionality of our search endpoints to run some simple analyses. Just remember that you cannot paginate beyond 10,000 results in our search endpoints (see Pagination).

If you do decide to scrape our resources, please throttle your requests to no more than one per second and avoid running multiple scrapers in parallel.

# Images

This API does not contain image files. However, it does contain all of the data you need to access our images. Our institution serves images via a separate API that is compliant with the IIIF Image API 2.0 specification. Using metadata from this API, you can craft URLs that will allow you to access images of artworks from our collection.

The International Image Interoperability Framework (IIIF) stewards a set of open standards that enables rich access to digital media from libraries, archives, museums, and other cultural institutions around the world. In practical terms, they define several API specifications that enable interoperability. When a tool is built to be IIIF-compliant, it's easier to adapt it to consume images from any number of institutions that offer IIIF-compliant APIs.

# IIIF Image API

We deliver our images via the IIIF Image API 2.0. Our IIIF URLs have the following structure:

https://www.artic.edu/iiif/2/{identifier}/{region}/{size}/{rotation}/{quality}.{format}

We recommend the following URL structure for most use-cases:

https://www.artic.edu/iiif/2/{identifier}/full/843,/0/default.jpg

Let's jump right into an example. Here's how you can construct IIIF URLs:

  1. Retrieve one or more artworks with image_id fields. Here are a few ways of doing so:

    # La Grande Jatte
    https://api.artic.edu/api/v1/artworks/27992?fields=id,title,image_id
    
    # La Grande Jatte and The Bedroom
    https://api.artic.edu/api/v1/artworks?ids=27992,28560&fields=id,title,image_id
    
    # Top two public domain artworks
    https://api.artic.edu/api/v1/artworks/search?query[term][is_public_domain]=true&limit=2&fields=id,title,image_id
    

    Let's go with the first one, La Grande Jatte. Your response will look something like this:

    {
        "data": {
            "id": 27992,
            "title": "A Sunday on La Grande Jatte — 1884",
            "image_id": "1adf2696-8489-499b-cad2-821d7fde4b33"
        },
        "config": {
            "iiif_url": "https://www.artic.edu/iiif/2",
        }
    }
    
  2. Find the base IIIF Image API endpoint in the config.iiif_url field:

    https://www.artic.edu/iiif/2
    

    We recommend that you avoid hardcoding this value into your applications.

  3. Append the image_id of the artwork as a segment to this URL:

    https://www.artic.edu/iiif/2/1adf2696-8489-499b-cad2-821d7fde4b33
    
  4. Append /full/843,/0/default.jpg to the URL:

    https://www.artic.edu/iiif/2/1adf2696-8489-499b-cad2-821d7fde4b33/full/843,/0/default.jpg
    

That's it! This is a valid IIIF URL. It will return the same image as we use on our website:

La Grande Jatte

Some artworks also have alt_image_ids, such as the Coronation Stone of Motecuhzoma II:

https://api.artic.edu/api/v1/artworks/75644?fields=id,title,image_id,alt_image_ids

Exhibitions have images, too:

https://api.artic.edu/api/v1/exhibitions/4568?fields=id,title,image_id,alt_image_ids

# Image Sizes

The IIIF Image API 2.0 has a lot of options. However, we prefer to use it conservatively. As mentioned above, here's the URL pattern we use for most projects:

https://www.artic.edu/iiif/2/{identifier}/full/843,/0/default.jpg

We recommend using /full/843,/0/default.jpg because this is the most common size used by our website, so there's a good chance that the image has previously been requested and cached. If you use this pattern in your projects, it will make images load faster in your application and decrease load on our systems.

TIP

We don't mind if you hotlink to our images. Our images support CORS with Access-Control-Allow-Origin: * headers—same as our API responses! However, please be aware that any image can get unpublished or replaced at any time.

If you'd like to display the full image at smaller sizes, we recommend the following size increments, as these are likely to give you a cache hit as well:

https://www.artic.edu/iiif/2/{identifier}/full/200,/0/default.jpg
https://www.artic.edu/iiif/2/{identifier}/full/400,/0/default.jpg
https://www.artic.edu/iiif/2/{identifier}/full/600,/0/default.jpg
https://www.artic.edu/iiif/2/{identifier}/full/843,/0/default.jpg

If you are accessing public domain images, you may also use the following pattern for larger images:

https://www.artic.edu/iiif/2/{identifier}/full/1686,/0/default.jpg

However, we still recommend using 843 instead unless there's a clear need for 1686.

Why the strange number—843px wide? This number is related to certain guidelines for the use of copyrighted materials within the museum field. Over time, it became the most common dimension used by our applications, so it is the size we continue to recommend.

# IIIF Manifests

We also offer IIIF Manifests for all of our public domain artworks. A manifest is a resource defined by the IIIF Presentation API. Each manifest contains artwork metadata—such as title, artist name, and copyright info—alongside a list of images associated with that artwork.

You can access the manifest by appending /manifest.json after the identifier in an artwork detail endpoint. For example, here is the manifest for The Great Wave:

https://api.artic.edu/api/v1/artworks/24645/manifest.json

These IIIF manifests do not contain any data that cannot be found elsewhere in our API. But because they follow a standardized API, they can be used with IIIF-compliant tools, such as Mirador. For a fun example, try pasting the URL above into the Getty's Animal Crossing Art Generator—and scroll up to see the result!

# Image Dumps

Unfortunately, we cannot offer image dumps at this time. We are exploring that possibility.

For now, you may scrape images from our IIIF Image API. We ask that you please follow our guidelines for scraping images if you decide to do so.

# Scraping Images

Generally, we prefer that you hotlink to our images, rather than scraping them. Scraping images can put unnecessary strain on our systems. That said, we understand that many use-cases require images to be stored locally.

If you'd like to scrape images from our IIIF API, please follow these guidelines:

  • Scrape one image at a time—do not use multiple threads or processes!
  • Consider adding a delay of 1 second between each image download
  • Use the following URL pattern to download our most common image size:
    https://www.artic.edu/iiif/2/{identifier}/full/843,/0/default.jpg
    

For information about copyright, please see the Image Licensing and Terms pages on our website. We defer to those resources in all legal respects.

From a developer's perspective, we recommend only using images from artworks that are tagged as public domain. When querying for artworks, you can filter by public domain status like so:

https://api.artic.edu/api/v1/artworks/search?query[term][is_public_domain]=true&limit=0

To get the full list of artworks that are in the public domain, you will need to download our data dumps and perform the filtering locally.

Please note that you may encounter images that are not public domain via our IIIF Image API. It is up to you to determine whether or not you are allowed to use these images for your use-case and to obtain any necessary permissions.

# General Information

# Authentication

You may access our API without authentication. Anonymous users are throttled to 60 requests per minute. (Each IP counts as a separate user.) If you are working on an application that needs to exceed this restriction, please get in touch with us at engineering@artic.edu.

Please use HTTPS to access our API. To support legacy applications, our API is currently accessible via both HTTP and HTTPS, but HTTP access will be removed in the future.

Lastly, consider adding a User-Agent header with the name of your project and a contact email to your API requests. For example:

curl 'https://api.artic.edu/api/v1/artworks/24645' \
--header 'User-Agent: aic-bash (engineering@artic.edu)'

We ask that you do so as a matter of courtesy. If we see an application using a disproportionate amount of system resources, this gives us an avenue to reach out and work with you to optimize your queries.

# Pagination

Listing and search endpoints are paginated. We show 12 records per page by default. Pagination can be controlled via the following query parameters:

  • page to request a specific page of results (1-based, default: 1)
  • limit to set how many records each page should return (0-based, default: 12)

Example: https://api.artic.edu/api/v1/artists?page=2&limit=10

For performance reasons, limit cannot exceed 100. Additionally, you cannot request more than 10,000 records from a single search query through any combination of limit and page. For example:

Generally, we ask that you avoid scraping our API. If you want to filter and scrape our search results, but the number of results is greater than 10,000, you won't be able to scrape them fully. Instead, we recommend that you download our data dumps and perform your filtering locally.

Occasionally, it might be useful to check the total number of results without retrieving any data. Our API supports this by allowing you to make a request with limit=0. For example, check pagination.total of this query to see the number of public domain artworks in our API:

https://api.artic.edu/api/v1/artworks/search?query[term][is_public_domain]=true&limit=0

All paginated endpoints include a pagination block in their responses:

{
    "pagination": {
        "total": 112773,
        "limit": 12,
        "offset": 24,  // 0-based
        "current_page": 3, // 1-based
        "total_pages": 9398,
        "prev_url": "https://api.artic.edu/api/v1/artworks?page=2&limit=12",
        "next_url": "https://api.artic.edu/api/v1/artworks?page=4&limit=12"
    },
    "data": [
        // ...
    ]
}

# Endpoints

# Collections

# Artworks

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /artworks

A list of all artworks sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • artist_pivots
    • catalogue_pivots
    • dates
    • place_pivots
    • sites
Example request: https://api.artic.edu/api/v1/artworks?limit=2
{
    "pagination": {
        "total": 114008,
        "limit": 2,
        "offset": 0,
        "total_pages": 57004,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/artworks?page=2&limit=2"
    },
    "data": [
        {
            "id": 242611,
            "api_model": "artworks",
            "api_link": "https://api.artic.edu/api/v1/artworks/242611",
            "is_boosted": false,
            "title": "Mirror Pieces Installation II",
            "alt_titles": null,
            ...
        },
        {
            "id": 157021,
            "api_model": "artworks",
            "api_link": "https://api.artic.edu/api/v1/artworks/157021",
            "is_boosted": false,
            "title": "\"Rock Crystal\" Vase",
            "alt_titles": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search artworks data in the aggregator. Artworks in the groups of essentials are boosted so they'll show up higher in results.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/artworks/search?q=monet
{
    "preference": null,
    "pagination": {
        "total": 296,
        "limit": 10,
        "offset": 0,
        "total_pages": 30,
        "current_page": 1
    },
    "data": [
        {
            "_score": 249.32751,
            "thumbnail": {
                "alt_text": "Painting of a pond seen up close spotted with thickly painted pink and white water lilies and a shadow across the top third of the picture.",
                "width": 8809,
                "lqip": "data:image/gif;base64,R0lGODlhBQAFAPQAAEZcaFFfdVtqbk9ldFBlcVFocllrcFlrd11rdl9sdFZtf15wcWV0d2R2eGByfmd6eGl6e2t9elZxiGF4kWB4kmJ9kGJ8lWeCkWSAnQAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAALAAAAAAFAAUAAAUVoJBADXI4TLRMWHU9hmRRCjAURBACADs=",
                "height": 8461
            },
            "api_model": "artworks",
            "is_boosted": true,
            "api_link": "https://api.artic.edu/api/v1/artworks/16568",
            "id": 16568,
            "title": "Water Lilies",
            "timestamp": "2021-03-22T03:02:21-05:00"
        },
        {
            "_score": 231.00276,
            "thumbnail": {
                "alt_text": "Loosely painted image of an open-air train station. On the right, a parked train gives off an enormous plumb of white smoke, making the scene look as though it were full of clouds. A huddled mass of barely discernible people crowd around the train on both sides of the tracks. Blue, green, and gray tones dominate.",
                "width": 6786,
                "lqip": "data:image/gif;base64,R0lGODlhBwAFAPUAADU8QkROS0ZPU0hSVk1YXVFWUlBXXlFaWVNcWFFkV1plVVtjWmBnWmFqXmRrX05ZYFFaYlljbF5qbGNsY2ZydmlzdWRxeGdze2l1fWx3fG16enJ4fH+KioWOkZeam5yjqZ2lqrG1ubS6vwAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAALAAAAAAHAAUAAAYhQIKmYslQDoONp8ORBECi0OfyKEAMmAhAgFhMHA2GIhEEADs=",
                "height": 5092
            },
            "api_model": "artworks",
            "is_boosted": true,
            "api_link": "https://api.artic.edu/api/v1/artworks/16571",
            "id": 16571,
            "title": "Arrival of the Normandy Train, Gare Saint-Lazare",
            "timestamp": "2021-03-22T03:02:21-05:00"
        },
        {
            "_score": 228.45622,
            "thumbnail": {
                "alt_text": "Painting composed of short, dense brushstrokes depicts two domed stacks of wheat that cast long shadows on a field. The angled light indicates either a rising or setting sun.",
                "width": 6884,
                "lqip": "data:image/gif;base64,R0lGODlhCAAFAPUAAF5eVW1bVm9eVmpjW3RoXXxyV39yXmdsZmhmaXZtbG11eH57eYl5bYR7dHuAf4mDfo6HfpePdpCFeZSOfJ+VdnZ+g4ODgoCHg4iHgo+GgY2MgpmThJeTipaSjaCcmbWnh6qrpKmopqqtrKusrbGxobq4pLu5qq2zsQAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACH5BAAAAAAALAAAAAAIAAUAAAYlwJNoFAKRSiZPh7OZRCgfBWJwAAQEBU2D8VgkCAYI5uKoWDKSIAA7",
                "height": 4068
            },
            "api_model": "artworks",
            "is_boosted": true,
            "api_link": "https://api.artic.edu/api/v1/artworks/64818",
            "id": 64818,
            "title": "Stacks of Wheat (End of Summer)",
            "timestamp": "2021-03-22T03:09:46-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /artworks/{id}

A single artwork by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/artworks/4
{
    "data": {
        "id": 4,
        "api_model": "artworks",
        "api_link": "https://api.artic.edu/api/v1/artworks/4",
        "is_boosted": false,
        "title": "Priest and Boy",
        "alt_titles": null,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}
# GET /artworks/{id}/manifest[.json]

A representation of this artwork in the IIIF Presentation API format.

Example request: https://api.artic.edu/api/v1/artworks/4/manifest.json
{
    "@context": "http://iiif.io/api/presentation/2/context.json",
    "@id": "https://api.artic.edu/api/v1/artworks/4/manifest.json",
    "@type": "sc:Manifest",
    "label": "Priest and Boy",
    "description": [
        {
            "value": "",
            "language": "en"
        }
    ],
    "metadata": [
        {
            "label": "Artist / Maker",
            "value": "Lawrence Carmichael Earle\nAmerican, 1845-1921"
        },
        {
            "label": "Medium",
            "value": "Watercolor over graphite on cream wove paper"
        },
        {
            "label": "Dimensions",
            "value": "472 \u00d7 345 mm"
        },
        {
            "label": "Object Number",
            "value": "1880.1"
        },
        {
            "label": "Collection",
            "value": "<a href='https://www.artic.edu/collection' target='_blank'>Art Institute of Chicago</a>"
        },
        "..."
    ],
    "attribution": "Digital image courtesy of the Art Institute of Chicago.",
    "logo": "https://raw.githubusercontent.com/Art-Institute-of-Chicago/template/master/aic-logo.gif",
    "within": "https://www.artic.edu/collection",
    "rendering": {
        "@id": "https://www.artic.edu/artworks/4",
        "format": "text/html",
        "label": "Full record"
    },
    "sequences": [
        {
            "@type": "sc:Sequence",
            "canvases": [
                {
                    "@type": "sc:Canvas",
                    "@id": "https://www.artic.edu/iiif/2/1a396e09-08f3-518e-8460-30c9ca19241f",
                    "label": "Priest and Boy, n.d.. Lawrence Carmichael Earle, American, 1845-1921",
                    "width": 843,
                    "height": 1162,
                    "images": [
                        {
                            "@type": "oa:Annotation",
                            "motivation": "sc:painting",
                            "on": "https://www.artic.edu/iiif/2/1a396e09-08f3-518e-8460-30c9ca19241f",
                            "resource": {
                                "@type": "dctypes:Image",
                                "@id": "https://www.artic.edu/iiif/2/1a396e09-08f3-518e-8460-30c9ca19241f/full/843,/0/default.jpg",
                                "width": 843,
                                "height": 1162,
                                "service": {
                                    "@context": "http://iiif.io/api/image/2/context.json",
                                    "@id": "https://www.artic.edu/iiif/2/1a396e09-08f3-518e-8460-30c9ca19241f",
                                    "profile": "http://iiif.io/api/image/2/level2.json"
                                }
                            }
                        }
                    ]
                }
            ]
        },
        "..."
    ]
}

# Agents

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /agents

A list of all agents sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • sites
    • place_pivots
Example request: https://api.artic.edu/api/v1/agents?limit=2
{
    "pagination": {
        "total": 14177,
        "limit": 2,
        "offset": 0,
        "total_pages": 7089,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/agents?page=2&limit=2"
    },
    "data": [
        {
            "id": 117464,
            "api_model": "agents",
            "api_link": "https://api.artic.edu/api/v1/agents/117464",
            "title": "Pietro Malombra",
            "sort_title": "Malombra, Pietro",
            "alt_titles": null,
            ...
        },
        {
            "id": 105683,
            "api_model": "agents",
            "api_link": "https://api.artic.edu/api/v1/agents/105683",
            "title": "Lelooska",
            "sort_title": "Lelooska",
            "alt_titles": [
                "Don Lelooska",
                "Don Smith, (Lelooska)",
                "Don Smith (Lelooska)"
            ],
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search agents data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/agents/search
{
    "preference": null,
    "pagination": {
        "total": 14462,
        "limit": 10,
        "offset": 0,
        "total_pages": 1447,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "agents",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agents/60368",
            "id": 60368,
            "title": "Faith Wilding",
            "timestamp": "2020-05-18T04:01:24-05:00"
        },
        {
            "_score": 1,
            "api_model": "agents",
            "api_link": "https://aggregator-data.artic.edu/api/v1/agents/115891",
            "id": 115891,
            "title": "Adam Pendleton",
            "timestamp": "2020-05-18T04:05:02-05:00"
        },
        {
            "_score": 1,
            "api_model": "agents",
            "api_link": "https://api.artic.edu/api/v1/agents/1213",
            "id": 1213,
            "title": "Jean Michel Atlan",
            "timestamp": "2021-03-22T03:34:54-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /agents/{id}

A single agent by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/agents/2
{
    "data": {
        "id": 2,
        "api_model": "agents",
        "api_link": "https://api.artic.edu/api/v1/agents/2",
        "title": "Antiquarian Society",
        "sort_title": "Antiquarian Society",
        "alt_titles": [
            "Art Institute of Chicago Antiquarian Society",
            "A.I.C. Antiquarian Society"
        ],
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Places

The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.

# GET /places

A list of all places sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/places?limit=2
{
    "pagination": {
        "total": 3928,
        "limit": 2,
        "offset": 0,
        "total_pages": 1964,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/places?page=2&limit=2"
    },
    "data": [
        {
            "id": -2147479000,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-2147479000",
            "title": "B\u00e4stad",
            "type": "No location",
            "last_updated_source": "2020-12-10T06:43:10-06:00",
            ...
        },
        {
            "id": -2147473257,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-2147473257",
            "title": "Kinngait",
            "type": "No location",
            "last_updated_source": "2020-12-04T04:27:49-06:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.",
        "license_links": [
            "https://www.artic.edu/terms",
            "https://creativecommons.org/licenses/by/4.0/"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search places data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/places/search
{
    "preference": null,
    "pagination": {
        "total": 3951,
        "limit": 10,
        "offset": 0,
        "total_pages": 396,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-2147483613",
            "id": -2147483613,
            "title": "Peoria",
            "timestamp": "2021-03-22T03:36:21-05:00"
        },
        {
            "_score": 1,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-2147483581",
            "id": -2147483581,
            "title": "Askov",
            "timestamp": "2021-03-22T03:36:21-05:00"
        },
        {
            "_score": 1,
            "api_model": "places",
            "api_link": "https://api.artic.edu/api/v1/places/-2147483534",
            "id": -2147483534,
            "title": "Z\u00fcrich",
            "timestamp": "2021-03-22T03:36:21-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.",
        "license_links": [
            "https://www.artic.edu/terms",
            "https://creativecommons.org/licenses/by/4.0/"
        ],
        "version": "1.0"
    }
}
# GET /places/{id}

A single place by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/places/-2147483613
{
    "data": {
        "id": -2147483613,
        "api_model": "places",
        "api_link": "https://api.artic.edu/api/v1/places/-2147483613",
        "title": "Peoria",
        "type": "No location",
        "last_updated_source": "1976-09-02T06:20:00-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Attribution 4.0 Generic License (CC-By) and the Terms and Conditions of artic.edu. Contains information from the J. Paul Getty Trust, Getty Research Institute, the Getty Thesaurus of Geographic Names, which is made available under the ODC Attribution License.",
        "license_links": [
            "https://www.artic.edu/terms",
            "https://creativecommons.org/licenses/by/4.0/"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Galleries

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /galleries

A list of all galleries sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/galleries?limit=2
{
    "pagination": {
        "total": 180,
        "limit": 2,
        "offset": 0,
        "total_pages": 90,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/galleries?page=2&limit=2"
    },
    "data": [
        {
            "id": 23967,
            "api_model": "galleries",
            "api_link": "https://api.artic.edu/api/v1/galleries/23967",
            "title": "Gallery 283",
            "type": "AIC Gallery",
            "is_closed": false,
            ...
        },
        {
            "id": 2147483621,
            "api_model": "galleries",
            "api_link": "https://api.artic.edu/api/v1/galleries/2147483621",
            "title": "Gallery 214",
            "type": "AIC Gallery",
            "is_closed": true,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search galleries data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/galleries/search
{
    "preference": null,
    "pagination": {
        "total": 180,
        "limit": 10,
        "offset": 0,
        "total_pages": 18,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "galleries",
            "api_link": "https://api.artic.edu/api/v1/galleries/2",
            "id": 2,
            "title": "East Garden at Columbus Drive",
            "timestamp": "2021-03-22T03:36:24-05:00"
        },
        {
            "_score": 1,
            "api_model": "galleries",
            "api_link": "https://api.artic.edu/api/v1/galleries/346",
            "id": 346,
            "title": "Stock Exchange Trading Room",
            "timestamp": "2021-03-22T03:36:24-05:00"
        },
        {
            "_score": 1,
            "api_model": "galleries",
            "api_link": "https://api.artic.edu/api/v1/galleries/2705",
            "id": 2705,
            "title": "Gallery 59",
            "timestamp": "2021-03-22T03:36:24-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /galleries/{id}

A single gallery by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/galleries/2
{
    "data": {
        "id": 2,
        "api_model": "galleries",
        "api_link": "https://api.artic.edu/api/v1/galleries/2",
        "title": "East Garden at Columbus Drive",
        "type": "AIC Gallery",
        "is_closed": false,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Exhibitions

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /exhibitions

A list of all exhibitions sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • artworks
    • sites
Example request: https://api.artic.edu/api/v1/exhibitions?limit=2
{
    "pagination": {
        "total": 6395,
        "limit": 2,
        "offset": 0,
        "total_pages": 3198,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/exhibitions?page=2&limit=2"
    },
    "data": [
        {
            "id": 1664,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/1664",
            "title": "Danh Vo: We the People",
            "is_featured": false,
            "is_published": false,
            ...
        },
        {
            "id": 6,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/6",
            "title": "Watercolors by Winslow Homer: The Color of Light",
            "is_featured": false,
            "is_published": false,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search exhibitions data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/exhibitions/search
{
    "preference": null,
    "pagination": {
        "total": 6128,
        "limit": 10,
        "offset": 0,
        "total_pages": 613,
        "current_page": 1
    },
    "data": [
        {
            "_score": 6.647884,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/2831",
            "id": 2831,
            "title": "Taoism and the Arts of China",
            "timestamp": "2021-03-22T03:36:35-05:00"
        },
        {
            "_score": 6.647884,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/2834",
            "id": 2834,
            "title": "Beyond the Easel: Decorative Painting by Bonnard, Vuillard, Denis, and Roussel, 1890\u20131930",
            "timestamp": "2021-03-22T03:36:35-05:00"
        },
        {
            "_score": 6.647884,
            "api_model": "exhibitions",
            "api_link": "https://api.artic.edu/api/v1/exhibitions/2835",
            "id": 2835,
            "title": "Van Gogh and Gauguin: The Studio of the South",
            "timestamp": "2021-03-22T03:36:35-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /exhibitions/{id}

A single exhibition by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/exhibitions/5
{
    "data": {
        "id": 5,
        "api_model": "exhibitions",
        "api_link": "https://api.artic.edu/api/v1/exhibitions/5",
        "title": "Manet and the Sea",
        "is_featured": false,
        "is_published": true,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Agent Types

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /agent-types

A list of all agent-types sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/agent-types?limit=2
{
    "pagination": {
        "total": 26,
        "limit": 2,
        "offset": 0,
        "total_pages": 13,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/agent-types?page=2&limit=2"
    },
    "data": [
        {
            "id": 29,
            "api_model": "agent-types",
            "api_link": "https://api.artic.edu/api/v1/agent-types/29",
            "title": "Artist Collaborative",
            "last_updated_source": "2019-05-08T13:31:54-05:00",
            "last_updated": "2019-05-09T12:01:08-05:00",
            ...
        },
        {
            "id": 28,
            "api_model": "agent-types",
            "api_link": "https://api.artic.edu/api/v1/agent-types/28",
            "title": "Nonprofit",
            "last_updated_source": "2019-05-08T13:31:54-05:00",
            "last_updated": "2019-05-09T12:01:08-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}
# GET /agent-types/{id}

A single agent-type by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/agent-types/1
{
    "data": {
        "id": 1,
        "api_model": "agent-types",
        "api_link": "https://api.artic.edu/api/v1/agent-types/1",
        "title": "Corporate Body",
        "last_updated_source": "2019-05-08T13:31:53-05:00",
        "last_updated": "2019-05-09T12:01:08-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Agent Roles

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /agent-roles

A list of all agent-roles sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/agent-roles?limit=2
{
    "pagination": {
        "total": 164,
        "limit": 2,
        "offset": 0,
        "total_pages": 82,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/agent-roles?page=2&limit=2"
    },
    "data": [
        {
            "id": 434,
            "api_model": "agent-roles",
            "api_link": "https://api.artic.edu/api/v1/agent-roles/434",
            "title": "Craftsperson",
            "last_updated_source": "2020-06-24T11:02:14-05:00",
            "last_updated": "2020-06-24T16:00:33-05:00",
            ...
        },
        {
            "id": 574,
            "api_model": "agent-roles",
            "api_link": "https://api.artic.edu/api/v1/agent-roles/574",
            "title": "File Transfer",
            "last_updated_source": "2019-05-08T14:05:12-05:00",
            "last_updated": "2019-05-09T12:01:07-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}
# GET /agent-roles/{id}

A single agent-role by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/agent-roles/1
{
    "data": {
        "id": 1,
        "api_model": "agent-roles",
        "api_link": "https://api.artic.edu/api/v1/agent-roles/1",
        "title": "Collection",
        "last_updated_source": "2019-05-08T14:05:07-05:00",
        "last_updated": "2019-05-09T12:01:07-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Agent Place Qualifiers

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /agent-place-qualifiers

A list of all agent-place-qualifiers sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/agent-place-qualifiers?limit=2
{
    "pagination": {
        "total": 0,
        "limit": 2,
        "offset": 0,
        "total_pages": 1,
        "current_page": 1
    },
    "data": [],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}
# GET /agent-place-qualifiers/{id}

A single agent-place-qualifier by the given identifier. {id} is the identifier from our collections management system.

# Artwork Types

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /artwork-types

A list of all artwork-types sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/artwork-types?limit=2
{
    "pagination": {
        "total": 44,
        "limit": 2,
        "offset": 0,
        "total_pages": 22,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/artwork-types?page=2&limit=2"
    },
    "data": [
        {
            "id": 48,
            "api_model": "artwork-types",
            "api_link": "https://api.artic.edu/api/v1/artwork-types/48",
            "title": "Time Based Media",
            "last_updated_source": "2020-05-04T07:25:27-05:00",
            "last_updated": "2020-05-04T07:25:51-05:00",
            ...
        },
        {
            "id": 47,
            "api_model": "artwork-types",
            "api_link": "https://api.artic.edu/api/v1/artwork-types/47",
            "title": "Materials",
            "last_updated_source": "2019-10-07T06:53:19-05:00",
            "last_updated": "2019-10-07T06:56:21-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}
# GET /artwork-types/{id}

A single artwork-type by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/artwork-types/1
{
    "data": {
        "id": 1,
        "api_model": "artwork-types",
        "api_link": "https://api.artic.edu/api/v1/artwork-types/1",
        "title": "Painting",
        "last_updated_source": "2019-05-08T14:03:58-05:00",
        "last_updated": "2019-05-09T12:01:07-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Artwork Place Qualifiers

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /artwork-place-qualifiers

A list of all artwork-place-qualifiers sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/artwork-place-qualifiers?limit=2
{
    "pagination": {
        "total": 15,
        "limit": 2,
        "offset": 0,
        "total_pages": 8,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/artwork-place-qualifiers?page=2&limit=2"
    },
    "data": [
        {
            "id": 54,
            "api_model": "artwork-place-qualifiers",
            "api_link": "https://api.artic.edu/api/v1/artwork-place-qualifiers/54",
            "title": "Artist's culture:",
            "last_updated_source": "2020-04-14T04:36:05-05:00",
            "last_updated": "2020-04-14T08:46:00-05:00",
            ...
        },
        {
            "id": 55,
            "api_model": "artwork-place-qualifiers",
            "api_link": "https://api.artic.edu/api/v1/artwork-place-qualifiers/55",
            "title": "Inhabited place:",
            "last_updated_source": "2020-04-13T08:01:45-05:00",
            "last_updated": "2020-04-13T08:05:56-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}
# GET /artwork-place-qualifiers/{id}

A single artwork-place-qualifier by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/artwork-place-qualifiers/1
{
    "data": {
        "id": 1,
        "api_model": "artwork-place-qualifiers",
        "api_link": "https://api.artic.edu/api/v1/artwork-place-qualifiers/1",
        "title": "Building address",
        "last_updated_source": "2019-05-08T13:00:18-05:00",
        "last_updated": "2019-05-09T12:01:07-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Artwork Date Qualifiers

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /artwork-date-qualifiers

A list of all artwork-date-qualifiers sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/artwork-date-qualifiers?limit=2
{
    "pagination": {
        "total": 31,
        "limit": 2,
        "offset": 0,
        "total_pages": 16,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/artwork-date-qualifiers?page=2&limit=2"
    },
    "data": [
        {
            "id": 62,
            "api_model": "artwork-date-qualifiers",
            "api_link": "https://api.artic.edu/api/v1/artwork-date-qualifiers/62",
            "title": "Manufactured",
            "last_updated_source": "2019-05-08T16:59:24-05:00",
            "last_updated": "2019-05-09T12:01:07-05:00",
            ...
        },
        {
            "id": 61,
            "api_model": "artwork-date-qualifiers",
            "api_link": "https://api.artic.edu/api/v1/artwork-date-qualifiers/61",
            "title": "Delineated",
            "last_updated_source": "2019-05-08T16:59:24-05:00",
            "last_updated": "2019-05-09T12:01:07-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}
# GET /artwork-date-qualifiers/{id}

A single artwork-date-qualifier by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/artwork-date-qualifiers/1
{
    "data": {
        "id": 1,
        "api_model": "artwork-date-qualifiers",
        "api_link": "https://api.artic.edu/api/v1/artwork-date-qualifiers/1",
        "title": "Cast",
        "last_updated_source": "2019-05-08T16:59:23-05:00",
        "last_updated": "2019-05-09T12:01:07-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Catalogues

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /catalogues

A list of all catalogues sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/catalogues?limit=2
{
    "pagination": {
        "total": 1102,
        "limit": 2,
        "offset": 0,
        "total_pages": 551,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/catalogues?page=2&limit=2"
    },
    "data": [
        {
            "id": 537,
            "api_model": "catalogues",
            "api_link": "https://api.artic.edu/api/v1/catalogues/537",
            "title": "Walch",
            "last_updated_source": "2020-11-17T07:20:47-06:00",
            "last_updated": "2020-11-17T07:25:42-06:00",
            ...
        },
        {
            "id": 536,
            "api_model": "catalogues",
            "api_link": "https://api.artic.edu/api/v1/catalogues/536",
            "title": "Chamberlain",
            "last_updated_source": "2019-10-15T04:35:50-05:00",
            "last_updated": "2019-10-15T04:36:17-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}
# GET /catalogues/{id}

A single catalogue by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/catalogues/-2147483646
{
    "data": {
        "id": -2147483646,
        "api_model": "catalogues",
        "api_link": "https://api.artic.edu/api/v1/catalogues/-2147483646",
        "title": "Bliss",
        "last_updated_source": "2019-05-08T13:18:14-05:00",
        "last_updated": "2019-05-09T12:01:08-05:00",
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Category Terms

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /category-terms

A list of all category-terms sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/category-terms?limit=2
{
    "pagination": {
        "total": 9224,
        "limit": 2,
        "offset": 0,
        "total_pages": 4612,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/category-terms?page=2&limit=2"
    },
    "data": [
        {
            "id": "TM-14540",
            "api_model": "category-terms",
            "api_link": "https://api.artic.edu/api/v1/category-terms/TM-14540",
            "title": "chintz",
            "subtype": "style",
            "parent_id": null,
            ...
        },
        {
            "id": "TM-14539",
            "api_model": "category-terms",
            "api_link": "https://api.artic.edu/api/v1/category-terms/TM-14539",
            "title": "chaise longue",
            "subtype": "subject",
            "parent_id": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search category-terms data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/category-terms/search
{
    "preference": null,
    "pagination": {
        "total": 9161,
        "limit": 10,
        "offset": 0,
        "total_pages": 917,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "category-terms",
            "api_link": "https://api.artic.edu/api/v1/category-terms/PC-826",
            "id": "PC-826",
            "title": "AIC Archives",
            "timestamp": "2021-03-22T03:37:26-05:00"
        },
        {
            "_score": 1,
            "api_model": "category-terms",
            "api_link": "https://api.artic.edu/api/v1/category-terms/PC-827",
            "id": "PC-827",
            "title": "SAIC Alumni and Faculty",
            "timestamp": "2021-03-22T03:37:26-05:00"
        },
        {
            "_score": 1,
            "api_model": "category-terms",
            "api_link": "https://api.artic.edu/api/v1/category-terms/PC-829",
            "id": "PC-829",
            "title": "Latin American",
            "timestamp": "2021-03-22T03:37:26-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /category-terms/{id}

A single category-term by the given identifier. {id} is the identifier from our collections management system.

Example request: https://api.artic.edu/api/v1/category-terms/PC-1
{
    "data": {
        "id": "PC-1",
        "api_model": "category-terms",
        "api_link": "https://api.artic.edu/api/v1/category-terms/PC-1",
        "title": "Arts of Africa",
        "subtype": "department",
        "parent_id": null,
        ...
    },
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Images

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /images

A list of all images sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/images?limit=2
{
    "pagination": {
        "total": 285577,
        "limit": 2,
        "offset": 0,
        "total_pages": 142789,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/images?page=2&limit=2"
    },
    "data": [
        {
            "id": "6cc52ff7-1284-9013-02a0-97bb272bf0ef",
            "lake_guid": "6cc52ff7-1284-9013-02a0-97bb272bf0ef",
            "api_model": "images",
            "api_link": "https://api.artic.edu/api/v1/images/6cc52ff7-1284-9013-02a0-97bb272bf0ef",
            "title": "PD_20283",
            "type": "image",
            ...
        },
        {
            "id": "a63b3e5f-beb3-7af2-af82-a4d3ee1b1f1c",
            "lake_guid": "a63b3e5f-beb3-7af2-af82-a4d3ee1b1f1c",
            "api_model": "images",
            "api_link": "https://api.artic.edu/api/v1/images/a63b3e5f-beb3-7af2-af82-a4d3ee1b1f1c",
            "title": "PD_20472",
            "type": "image",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search images data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/images/search
{
    "preference": null,
    "pagination": {
        "total": 288543,
        "limit": 10,
        "offset": 0,
        "total_pages": 28855,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "images",
            "api_link": "https://aggregator-data.artic.edu/api/v1/images/2231cdf1-d6ed-05cd-7ef8-66ab93dc8932",
            "id": "2231cdf1-d6ed-05cd-7ef8-66ab93dc8932",
            "title": "G00149",
            "timestamp": "2020-05-18T04:24:04-05:00"
        },
        {
            "_score": 1,
            "api_model": "images",
            "api_link": "https://aggregator-data.artic.edu/api/v1/images/2fd42dbf-1bca-06a5-4c8e-b82fc431a0e6",
            "id": "2fd42dbf-1bca-06a5-4c8e-b82fc431a0e6",
            "title": "E30137",
            "timestamp": "2020-05-18T04:30:30-05:00"
        },
        {
            "_score": 1,
            "api_model": "images",
            "api_link": "https://aggregator-data.artic.edu/api/v1/images/3f2f9f3d-5a59-8c6b-37fb-198cec93ba4d",
            "id": "3f2f9f3d-5a59-8c6b-37fb-198cec93ba4d",
            "title": "G00134",
            "timestamp": "2020-05-18T04:37:40-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /images/{id}

A single image by the given identifier. {id} is the identifier from our collections management system.

# Videos

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /videos

A list of all videos sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/videos?limit=2
{
    "pagination": {
        "total": 4,
        "limit": 2,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/videos?page=2&limit=2"
    },
    "data": [
        {
            "id": "c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "lake_guid": "c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "api_model": "videos",
            "api_link": "https://api.artic.edu/api/v1/videos/c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "title": "Under Cover: The Science of Van Gogh's Bedroom",
            "type": "video",
            ...
        },
        {
            "id": "eb06edce-6f2e-727c-0cee-a32cef589911",
            "lake_guid": "eb06edce-6f2e-727c-0cee-a32cef589911",
            "api_model": "videos",
            "api_link": "https://api.artic.edu/api/v1/videos/eb06edce-6f2e-727c-0cee-a32cef589911",
            "title": "A Thousand and One Swabs: The Transformation of \"Paris Street; Rainy Day\"",
            "type": "video",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search videos data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/videos/search
{
    "preference": null,
    "pagination": {
        "total": 4,
        "limit": 10,
        "offset": 0,
        "total_pages": 1,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "videos",
            "api_link": "https://api.artic.edu/api/v1/videos/1ee4a231-0dad-2638-24fd-dfa2138eb142",
            "id": "1ee4a231-0dad-2638-24fd-dfa2138eb142",
            "title": "Digital Simulation: Original appearance of <em>For to Be a Farmer's Boy</em>",
            "timestamp": "2021-01-13T04:24:59-06:00"
        },
        {
            "_score": 1,
            "api_model": "videos",
            "api_link": "https://api.artic.edu/api/v1/videos/c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "id": "c051f71e-2b69-ac68-9aa8-99410d91f3f3",
            "title": "Under Cover: The Science of Van Gogh's Bedroom",
            "timestamp": "2021-01-13T04:24:59-06:00"
        },
        {
            "_score": 1,
            "api_model": "videos",
            "api_link": "https://api.artic.edu/api/v1/videos/c5700df1-473c-c1cd-ab1b-79b20a32fc27",
            "id": "c5700df1-473c-c1cd-ab1b-79b20a32fc27",
            "title": "Online Game: Winslow Homer's <em>The Water Fan</em>",
            "timestamp": "2021-01-13T04:24:59-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /videos/{id}

A single video by the given identifier. {id} is the identifier from our collections management system.

# Sounds

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /sounds

A list of all sounds sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/sounds?limit=2
{
    "pagination": {
        "total": 1908,
        "limit": 2,
        "offset": 0,
        "total_pages": 954,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/sounds?page=2&limit=2"
    },
    "data": [
        {
            "id": "fcb1b4d0-e285-7e45-5459-138fe3ce2abf",
            "lake_guid": "fcb1b4d0-e285-7e45-5459-138fe3ce2abf",
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/fcb1b4d0-e285-7e45-5459-138fe3ce2abf",
            "title": "Audio stop 986.mp3",
            "type": "sound",
            ...
        },
        {
            "id": "f076abd9-6d6f-1a9a-e1b3-2bde776e9e82",
            "lake_guid": "f076abd9-6d6f-1a9a-e1b3-2bde776e9e82",
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/f076abd9-6d6f-1a9a-e1b3-2bde776e9e82",
            "title": "Audio stop 989.mp3",
            "type": "sound",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search sounds data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/sounds/search
{
    "preference": null,
    "pagination": {
        "total": 1909,
        "limit": 10,
        "offset": 0,
        "total_pages": 191,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/2fffdf0d-39f1-d0bd-712c-791a0fe12d9e",
            "id": "2fffdf0d-39f1-d0bd-712c-791a0fe12d9e",
            "title": "Audio stop 623.mp3",
            "timestamp": "2021-01-13T04:25:03-06:00"
        },
        {
            "_score": 1,
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/30198693-76a0-5adc-e753-2de5a418a5fd",
            "id": "30198693-76a0-5adc-e753-2de5a418a5fd",
            "title": "Audio stop 910.mp3",
            "timestamp": "2021-01-13T04:25:03-06:00"
        },
        {
            "_score": 1,
            "api_model": "sounds",
            "api_link": "https://api.artic.edu/api/v1/sounds/30d4cfab-2e68-be75-cc5c-8207fd459cb1",
            "id": "30d4cfab-2e68-be75-cc5c-8207fd459cb1",
            "title": "Audio stop 91.mp3",
            "timestamp": "2021-01-13T04:25:03-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /sounds/{id}

A single sound by the given identifier. {id} is the identifier from our collections management system.

# Texts

The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.

# GET /texts

A list of all texts sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/texts?limit=2
{
    "pagination": {
        "total": 5899,
        "limit": 2,
        "offset": 0,
        "total_pages": 2950,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/texts?page=2&limit=2"
    },
    "data": [
        {
            "id": "94fa5de6-38e4-0159-2d96-33266855e4de",
            "lake_guid": "94fa5de6-38e4-0159-2d96-33266855e4de",
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/94fa5de6-38e4-0159-2d96-33266855e4de",
            "title": "1970_Photographs_by_Euge_ne_Atget_Installation_Photos_2.pdf",
            "type": "text",
            ...
        },
        {
            "id": "d23c19b1-e9b6-60e3-dcf9-c240c3996fa0",
            "lake_guid": "d23c19b1-e9b6-60e3-dcf9-c240c3996fa0",
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/d23c19b1-e9b6-60e3-dcf9-c240c3996fa0",
            "title": "1970_Photographs_by_Euge_ne_Atget_Installation_Photos_5.pdf",
            "type": "text",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search texts data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/texts/search
{
    "preference": null,
    "pagination": {
        "total": 5911,
        "limit": 10,
        "offset": 0,
        "total_pages": 592,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/34633f5d-d90c-5b05-3e37-b009698e4243",
            "id": "34633f5d-d90c-5b05-3e37-b009698e4243",
            "title": "Audio transcript 590.txt",
            "timestamp": "2020-12-11T09:21:42-06:00"
        },
        {
            "_score": 1,
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/0ce7c09b-72fa-2879-0e4a-f460a04276aa",
            "id": "0ce7c09b-72fa-2879-0e4a-f460a04276aa",
            "title": "Audio Transcript 957.txt",
            "timestamp": "2021-01-13T04:25:07-06:00"
        },
        {
            "_score": 1,
            "api_model": "texts",
            "api_link": "https://api.artic.edu/api/v1/texts/0ce9f003-fa67-e2c9-bcd5-33d3196510fa",
            "id": "0ce9f003-fa67-e2c9-bcd5-33d3196510fa",
            "title": "AIC1921APoole_comb.pdf",
            "timestamp": "2021-01-13T04:25:07-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response is licensed under a Creative Commons Zero (CC0) 1.0 designation and the Terms and Conditions of artic.edu.",
        "license_links": [
            "https://creativecommons.org/publicdomain/zero/1.0/",
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /texts/{id}

A single text by the given identifier. {id} is the identifier from our collections management system.

# Shop

# Products

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /products

A list of all products sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/products?limit=2
{
    "pagination": {
        "total": 7374,
        "limit": 2,
        "offset": 0,
        "total_pages": 3687,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/products?page=2&limit=2"
    },
    "data": [
        {
            "id": 8366,
            "api_model": "products",
            "api_link": "https://api.artic.edu/api/v1/products/8366",
            "title": "TEE HOPPER NIGHTHAWKS XXL",
            "external_sku": 283125,
            "image_url": "https://shop-images.imgix.net283125_2.jpg",
            ...
        },
        {
            "id": 8365,
            "api_model": "products",
            "api_link": "https://api.artic.edu/api/v1/products/8365",
            "title": "TEE HOPPER NIGHTHAWKS L",
            "external_sku": 283123,
            "image_url": "https://shop-images.imgix.net283123_2.jpg",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search products data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/products/search
{
    "preference": null,
    "pagination": {
        "total": 0,
        "limit": 10,
        "offset": 0,
        "total_pages": 0,
        "current_page": 1
    },
    "data": [],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /products/{id}

A single product by the given identifier.

Example request: https://api.artic.edu/api/v1/products/37
{
    "data": {
        "id": 37,
        "api_model": "products",
        "api_link": "https://api.artic.edu/api/v1/products/37",
        "title": "Sullivan Scarf",
        "external_sku": 265543,
        "image_url": "https://shop-images.imgix.net265543_2.jpg",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Mobile

# Tours

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /tours

A list of all tours sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • tour_stops
Example request: https://api.artic.edu/api/v1/tours?limit=2
{
    "pagination": {
        "total": 16,
        "limit": 2,
        "offset": 0,
        "total_pages": 8,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/tours?page=2&limit=2"
    },
    "data": [
        {
            "id": 1000,
            "api_model": "tours",
            "api_link": "https://api.artic.edu/api/v1/tours/1000",
            "title": "Magic of the Miniature",
            "image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/E17048_reduced.jpg",
            "description": "<p>Travel back in time through the magic of the Thorne Rooms.</p>\n",
            ...
        },
        {
            "id": 1023,
            "api_model": "tours",
            "api_link": "https://api.artic.edu/api/v1/tours/1023",
            "title": "The Architecture Tour",
            "image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/IM016907_008_reduced.jpg",
            "description": "<p>Uncover the secrets of the museum\u2019s storied architecture.</p>\n",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search tours data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/tours/search
{
    "preference": null,
    "pagination": {
        "total": 21,
        "limit": 10,
        "offset": 0,
        "total_pages": 3,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "tours",
            "api_link": "https://aggregator-data.artic.edu/api/v1/tours/4581",
            "id": 4581,
            "title": "In a Cloud, in a Wall, in a Chair: Six Modernists in Mexico at Midcentury",
            "timestamp": "2020-03-06T06:10:23-06:00"
        },
        {
            "_score": 1,
            "api_model": "tours",
            "api_link": "https://aggregator-data.artic.edu/api/v1/tours/4626",
            "id": 4626,
            "title": "Andy Warhol\u2014From A to B and Back Again",
            "timestamp": "2020-03-06T06:10:23-06:00"
        },
        {
            "_score": 1,
            "api_model": "tours",
            "api_link": "https://aggregator-data-dev.artic.edu/api/v1/tours/4636",
            "id": 4636,
            "title": "MD Test Tour",
            "timestamp": "2019-12-05T11:00:47-06:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /tours/{id}

A single tour by the given identifier.

Example request: https://api.artic.edu/api/v1/tours/1000
{
    "data": {
        "id": 1000,
        "api_model": "tours",
        "api_link": "https://api.artic.edu/api/v1/tours/1000",
        "title": "Magic of the Miniature",
        "image": "http://aic-mobile-tours.artic.edu/sites/default/files/tour-images/E17048_reduced.jpg",
        "description": "<p>Travel back in time through the magic of the Thorne Rooms.</p>\n",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Mobile Sounds

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /mobile-sounds

A list of all mobile-sounds sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/mobile-sounds?limit=2
{
    "pagination": {
        "total": 792,
        "limit": 2,
        "offset": 0,
        "total_pages": 396,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/mobile-sounds?page=2&limit=2"
    },
    "data": [
        {
            "id": 4732,
            "api_model": "mobile-sounds",
            "api_link": "https://api.artic.edu/api/v1/mobile-sounds/4732",
            "title": "Vase (Maebyong) with Clouds, Flying Cranes, and Children amid Bamboo",
            "web_url": "https://www.artic.edu/mobile/audio/1950.1626_KoreanVase_V4.mp3",
            "transcript": "<p>There are a lot of celedons in our collection, but some are better than the others.</p>\n<p>My name is Yeonsoo Chee, I\u2019m an Associate Curator at the Art Institute of Chicago.</p>\n<p>There\u2019s kind of an even coloration, and also the thickness of the glaze is very even, so you don\u2019t see that some parts are shinier than the others. The technique decorating this vase is called the \u201csanggam\u201d technique. The most common techniques to decorate the ceramics were either to paint or incise designs. But the sanggam, actually, is more involved than any of these two techniques. The potter will carve out the space to create the design and then he will fill those negative spaces with white clay or white slip. Then, after it\u2019s dried, he will carve out the next details that we see in black, and then he will fill that space with red clay this time. These white parts stay white and then the red parts turn into black. So, now we see two different colorations from the motifs.</p>\n<p>Usually, the motifs in Asian art, they are not accidental\u2014they all carry very specific meanings. Cranes represent longevity. When there are children, it means the wish for fertility and a lot of offspring. And bamboo is one of the four friends of the gentlemen\u2014it is known as \u201cSagunja\u201d in Korean and also it is very common in Chinese art, too. Bamboo represents the integrity and resilience because bamboo is evergreen, they don\u2019t change. And then they are very hard to be broken. So, along with the plum, orchids, and chrysanthemum, these four represent the virtues that scholar gentlemen should have.</p>\n<p>So I think those kinds of consistencies in terms of coloration and also the execution of the design\u2014those things make this piece stand out among others.</p>\n",
            ...
        },
        {
            "id": 4722,
            "api_model": "mobile-sounds",
            "api_link": "https://api.artic.edu/api/v1/mobile-sounds/4722",
            "title": "T036_MonetIntro_V4.mp3 (Monet and Chicago)",
            "web_url": "https://www.artic.edu/mobile/audio/00_MonetIntroduction_V4.mp3",
            "transcript": "<p>Gloria Groom: Welcome! My name is Gloria Groom and I\u2019m Chair of the Department of European Painting and Sculpture. We\u2019re really excited to be presenting the Monet exhibition. We have had Monet exhibitions in the past but this is the first time to really focus on the artist and his impact on the city of Chicago and at the Art Institute. We\u2019ll be talking about those important early collectors of Monet\u2014the Palmers, the Ryersons, the Coburns\u2014and, of course, other collectors throughout the 20th century. But we also want to be able to reveal some of the discoveries that have been made in the Conservation Lab with conservators and curators and art historians as we\u2019ve looked very deeply and closely at his paintings. It\u2019s really a celebration of the artist but also the history we\u2019ve had with the artist in the city of Chicago.</p>\n<p>So in the next room what you\u2019ll see are photographs of the three most important collectors of Monet early on\u2014how they lived with his paintings, how they looked, a little biography on them\u2014to really get you into the story that Monet was not necessarily a household name but he was certainly appreciated by the leaders of the Chicago cultural life of that time.</p>\n",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search mobile-sounds data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/mobile-sounds/search
{
    "preference": null,
    "pagination": {
        "total": 794,
        "limit": 10,
        "offset": 0,
        "total_pages": 80,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "mobile-sounds",
            "api_link": "https://aggregator-data-dev.artic.edu/api/v1/mobile-sounds/4528",
            "id": 4528,
            "title": "Statue of a Young Satyr Wearing a Theater Mask of Silenos",
            "timestamp": "2019-12-05T11:00:45-06:00"
        },
        {
            "_score": 1,
            "api_model": "mobile-sounds",
            "api_link": "https://aggregator-data-dev.artic.edu/api/v1/mobile-sounds/4637",
            "id": 4637,
            "title": "Intro",
            "timestamp": "2019-12-05T11:00:46-06:00"
        },
        {
            "_score": 1,
            "api_model": "mobile-sounds",
            "api_link": "https://api.artic.edu/api/v1/mobile-sounds/226",
            "id": 226,
            "title": "Justus Sustermans",
            "timestamp": "2021-03-22T03:51:02-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /mobile-sounds/{id}

A single mobile-sound by the given identifier.

Example request: https://api.artic.edu/api/v1/mobile-sounds/226
{
    "data": {
        "id": 226,
        "api_model": "mobile-sounds",
        "api_link": "https://api.artic.edu/api/v1/mobile-sounds/226",
        "title": "Justus Sustermans",
        "web_url": "https://www.artic.edu/mobile/audio/882.mp3",
        "transcript": "<p>VICTORIA SANCHO LOBIS:  Portrait prints had been made since the beginning of the history of the print.  But they typically were used to represent political figures or scholars.</p>\n<p>NARRATOR: Until Van Dyck\u2019 created the Iconography. In this series of prints he not only included political leaders and other renowned citizens, but artists as well, signaling their growing importance in 17th century European society. The Art Institute is fortunate to own all of Van Dyck\u2019s etchings for this project, and they are exhibited here for the first time in almost a century.</p>\n<p>The artist began the series by casually creating 15 portraits, expecting that expert printmakers would finish his plates. He could hardly have anticipated the interest these \u2018unfinished\u2019 prints would generate.</p>\n<p>In this portrait of artist Justus Sustermans, Van Dyck paid great attention to detail in his sitter\u2019s face.</p>\n<p>VICTORIA SANCHO LOBIS: And then from there, the description of the sitter becomes increasingly abstract. And we eventually get to the painter\u2019s right hand, which is drawn in with just the most preliminary and rudimentary lines, sort of square-shaped fingertips, and no shading whatsoever.</p>\n<p>NARRATOR: This contrast between detailed depiction and imaginative abstraction is precisely what caught a collector\u2019s eye and what still seems so modern about Van Dyck\u2019s etchings today. Van Dyck\u2019s self-portrait is probably the first unfinished print ever to have been produced in an edition.</p>\n<p>VICTORIA SANCHO LOBIS: Like most of the etchings that Van Dyck made, this print shows the effects of an imperfectly polished copper plate. So we see scratches, particularly in the upper register. There\u2019s various other passages where a more conscientious printmaker would have taken pains to remove blemishes or imperfections. But these seemed not to bother Van Dyck very much, nor did it bother some of the early collectors.</p>\n<p>NARRATOR: Those collectors immediately embraced van Dyck\u2019s revolutionary portraiture, eagerly purchasing new prints for their collections. Nearby, you\u2019ll see other unfinished portraits van Dyck created for the series.</p>\n",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Digital Scholarly Catalogs

# Publications

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /publications

A list of all publications sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/publications?limit=2
{
    "pagination": {
        "total": 12,
        "limit": 2,
        "offset": 0,
        "total_pages": 6,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/publications?page=2&limit=2"
    },
    "data": [
        {
            "id": 141096,
            "api_model": "publications",
            "api_link": "https://api.artic.edu/api/v1/publications/141096",
            "title": "Gauguin Paintings, Sculpture, and Graphic Works at the Art Institute of Chicago",
            "web_url": "https://publications.artic.edu/gauguin/reader/gauguinart",
            "site": "gauguin",
            ...
        },
        {
            "id": 140019,
            "api_model": "publications",
            "api_link": "https://api.artic.edu/api/v1/publications/140019",
            "title": "Manet Paintings and Works on Paper at the Art Institute of Chicago",
            "web_url": "https://publications.artic.edu/manet/reader/manetart",
            "site": "manet",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search publications data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/publications/search
{
    "preference": null,
    "pagination": {
        "total": 12,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "publications",
            "api_link": "https://api.artic.edu/api/v1/publications/2",
            "id": 2,
            "title": "American Silver in the Art Institute of Chicago",
            "timestamp": "2021-03-22T03:51:06-05:00"
        },
        {
            "_score": 1,
            "api_model": "publications",
            "api_link": "https://api.artic.edu/api/v1/publications/7",
            "id": 7,
            "title": "Pissarro Paintings and Works on Paper at the Art Institute of Chicago",
            "timestamp": "2021-03-22T03:51:06-05:00"
        },
        {
            "_score": 1,
            "api_model": "publications",
            "api_link": "https://api.artic.edu/api/v1/publications/12",
            "id": 12,
            "title": "The Modern Series at the Art Institute of Chicago",
            "timestamp": "2021-03-22T03:51:06-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /publications/{id}

A single publication by the given identifier.

Example request: https://api.artic.edu/api/v1/publications/2
{
    "data": {
        "id": 2,
        "api_model": "publications",
        "api_link": "https://api.artic.edu/api/v1/publications/2",
        "title": "American Silver in the Art Institute of Chicago",
        "web_url": "https://publications.artic.edu/americansilver/reader/collection",
        "site": "americansilver",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Sections

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /sections

A list of all sections sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/sections?limit=2
{
    "pagination": {
        "total": 1124,
        "limit": 2,
        "offset": 0,
        "total_pages": 562,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/sections?page=2&limit=2"
    },
    "data": [
        {
            "id": 128775,
            "api_model": "sections",
            "api_link": "https://api.artic.edu/api/v1/sections/128775",
            "title": "Bibliography",
            "web_url": "https://publications.artic.edu/americansilver/reader/collection/section/504",
            "accession": null,
            ...
        },
        {
            "id": 108342,
            "api_model": "sections",
            "api_link": "https://api.artic.edu/api/v1/sections/108342",
            "title": "Select Silver Objects in the Collection of the Art Institute of Chicago",
            "web_url": "https://publications.artic.edu/americansilver/reader/collection/section/462",
            "accession": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search sections data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/sections/search
{
    "preference": null,
    "pagination": {
        "total": 1124,
        "limit": 10,
        "offset": 0,
        "total_pages": 113,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "sections",
            "api_link": "https://api.artic.edu/api/v1/sections/36912890728",
            "id": 36912890728,
            "title": "Signatures",
            "timestamp": "2021-03-22T03:51:15-05:00"
        },
        {
            "_score": 1,
            "api_model": "sections",
            "api_link": "https://api.artic.edu/api/v1/sections/36941697573",
            "id": 36941697573,
            "title": "Mrs. Lewis Larned (Annie Swan) Coburn",
            "timestamp": "2021-03-22T03:51:15-05:00"
        },
        {
            "_score": 1,
            "api_model": "sections",
            "api_link": "https://api.artic.edu/api/v1/sections/36942241206",
            "id": 36942241206,
            "title": "Charles H. and Mary F. S. Worcester",
            "timestamp": "2021-03-22T03:51:15-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /sections/{id}

A single section by the given identifier.

Example request: https://api.artic.edu/api/v1/sections/18
{
    "data": {
        "id": 18,
        "api_model": "sections",
        "api_link": "https://api.artic.edu/api/v1/sections/18",
        "title": "Foreword",
        "web_url": "https://publications.artic.edu/americansilver/reader/collection/section/3",
        "accession": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Static Archive

# Sites

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /sites

A list of all sites sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • artworks
Example request: https://api.artic.edu/api/v1/sites?limit=2
{
    "pagination": {
        "total": 93,
        "limit": 2,
        "offset": 0,
        "total_pages": 47,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/sites?page=2&limit=2"
    },
    "data": [
        {
            "id": 104,
            "api_model": "sites",
            "api_link": "https://api.artic.edu/api/v1/sites/104",
            "title": "Hugh Edwards",
            "description": null,
            "web_url": "http://archive.artic.edu/edwards/",
            ...
        },
        {
            "id": 103,
            "api_model": "sites",
            "api_link": "https://api.artic.edu/api/v1/sites/103",
            "title": "Edward Steichen's Work War I Years",
            "description": "This website, which includes works drawn from the Art Institute\u2019s collection, reveals the profound influence Steichen had on various photographic fields. Featured is a unique album of World War I aerial photographs assembled and annotated by Steichen in 1919 following his military discharge.",
            "web_url": "http://archive.artic.edu/steichen/",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search sites data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/sites/search
{
    "preference": null,
    "pagination": {
        "total": 93,
        "limit": 10,
        "offset": 0,
        "total_pages": 10,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "sites",
            "api_link": "https://api.artic.edu/api/v1/sites/1",
            "id": 1,
            "title": "Chicago Architecture: Ten Visions",
            "timestamp": "2021-03-22T03:51:20-05:00"
        },
        {
            "_score": 1,
            "api_model": "sites",
            "api_link": "https://api.artic.edu/api/v1/sites/2",
            "id": 2,
            "title": "American Perspectives: A yearlong celebration of American artistic vision",
            "timestamp": "2021-03-22T03:51:20-05:00"
        },
        {
            "_score": 1,
            "api_model": "sites",
            "api_link": "https://api.artic.edu/api/v1/sites/3",
            "id": 3,
            "title": "Curious Corner",
            "timestamp": "2021-03-22T03:51:21-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /sites/{id}

A single site by the given identifier.

Example request: https://api.artic.edu/api/v1/sites/1
{
    "data": {
        "id": 1,
        "api_model": "sites",
        "api_link": "https://api.artic.edu/api/v1/sites/1",
        "title": "Chicago Architecture: Ten Visions",
        "description": "Chicago Architecture: Ten Visions presents diverse views of the future of Chicago\u2019s built environment from 10 internationally renowned architects. The architects were selected from an invited competition juried by architects Stanley Tigerman and Harry Cobb, in collaboration with curators from the Art Institute\u2019s Department of Architecture. The 10 architects reflect a cross section of Chicago\u2019s vibrant architectural scene\u2014from large and small firms as well as the academic community\u2014bringing to this exhibition diverse experiences and insights. Each architect was asked to define an important issue for the future of Chicago and create a \u201cspatial commentary\u201d on that particular theme. Within a lively plan designed by Stanley Tigerman, each of the participants has curated and designed his or her own mini-exhibition in a space of approximately 21 feet square. Tigerman\u2019s setting creates a linear sequence in which visitors pass through the architects\u2019 spaces to an interactive area where the architects\u2019 commentaries can be heard by picking up a telephone. Visitors are encouraged to record their comments on any and all of the \u201cten visions.\u201d",
        "web_url": "http://archive.artic.edu/10visions/",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Website

# Closures

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /closures

A list of all closures sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/closures?limit=2
{
    "pagination": {
        "total": 34,
        "limit": 2,
        "offset": 0,
        "total_pages": 17,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/closures?page=2&limit=2"
    },
    "data": [
        {
            "id": 38,
            "api_model": "closures",
            "api_link": "https://api.artic.edu/api/v1/closures/38",
            "title": "Lorem ipsum.",
            "date_start": "2020-09-22T00:00:00-05:00",
            "date_end": "2020-09-23T00:00:00-05:00",
            ...
        },
        {
            "id": 45,
            "api_model": "closures",
            "api_link": "https://api.artic.edu/api/v1/closures/45",
            "title": "Lorem ipsum.",
            "date_start": "2020-09-26T00:00:00-05:00",
            "date_end": "2020-09-26T00:00:00-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search closures data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/closures/search
{
    "preference": null,
    "pagination": {
        "total": 27,
        "limit": 10,
        "offset": 0,
        "total_pages": 3,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "closures",
            "api_link": "https://api.artic.edu/api/v1/closures/4",
            "id": 4,
            "title": "Lorem ipsum.",
            "timestamp": "2021-03-22T03:51:22-05:00"
        },
        {
            "_score": 1,
            "api_model": "closures",
            "api_link": "https://api.artic.edu/api/v1/closures/5",
            "id": 5,
            "title": "Lorem ipsum.",
            "timestamp": "2021-03-22T03:51:22-05:00"
        },
        {
            "_score": 1,
            "api_model": "closures",
            "api_link": "https://api.artic.edu/api/v1/closures/9",
            "id": 9,
            "title": "Lorem ipsum.",
            "timestamp": "2021-03-22T03:51:22-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /closures/{id}

A single closure by the given identifier.

Example request: https://api.artic.edu/api/v1/closures/4
{
    "data": {
        "id": 4,
        "api_model": "closures",
        "api_link": "https://api.artic.edu/api/v1/closures/4",
        "title": "Lorem ipsum.",
        "date_start": "2020-12-25T00:00:00-06:00",
        "date_end": "2020-12-25T00:00:00-06:00",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Web Exhibitions

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /web-exhibitions

A list of all web-exhibitions sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/web-exhibitions?limit=2
{
    "pagination": {
        "total": 689,
        "limit": 2,
        "offset": 0,
        "total_pages": 345,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/web-exhibitions?page=2&limit=2"
    },
    "data": [
        {
            "id": 66,
            "api_model": "web-exhibitions",
            "api_link": "https://api.artic.edu/api/v1/web-exhibitions/66",
            "title": "Tools of the Trade: 19th- and 20th- Century Architectural Trade Catalogs",
            "exhibition_id": 2999,
            "is_featured": false,
            ...
        },
        {
            "id": 60,
            "api_model": "web-exhibitions",
            "api_link": "https://api.artic.edu/api/v1/web-exhibitions/60",
            "title": "The Modern Chair",
            "exhibition_id": null,
            "is_featured": false,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search web-exhibitions data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/web-exhibitions/search
{
    "preference": null,
    "pagination": {
        "total": 699,
        "limit": 10,
        "offset": 0,
        "total_pages": 70,
        "current_page": 1
    },
    "data": [
        {
            "_score": 4.563684,
            "api_model": "web-exhibitions",
            "api_link": "https://api.artic.edu/api/v1/web-exhibitions/1",
            "id": 1,
            "title": "Charles White: A Retrospective",
            "timestamp": "2021-03-22T03:51:22-05:00"
        },
        {
            "_score": 4.563684,
            "api_model": "web-exhibitions",
            "api_link": "https://api.artic.edu/api/v1/web-exhibitions/2",
            "id": 2,
            "title": "Manet and Modern Beauty",
            "timestamp": "2021-03-22T03:51:22-05:00"
        },
        {
            "_score": 4.563684,
            "api_model": "web-exhibitions",
            "api_link": "https://api.artic.edu/api/v1/web-exhibitions/3",
            "id": 3,
            "title": "Andy Warhol\u2013From A to B and Back Again",
            "timestamp": "2021-03-22T03:51:22-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /web-exhibitions/{id}

A single web-exhibition by the given identifier.

Example request: https://api.artic.edu/api/v1/web-exhibitions/1
{
    "data": {
        "id": 1,
        "api_model": "web-exhibitions",
        "api_link": "https://api.artic.edu/api/v1/web-exhibitions/1",
        "title": "Charles White: A Retrospective",
        "exhibition_id": 2663,
        "is_featured": false,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Events

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /events

A list of all events sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
  • include - A comma-separated list of subresource to embed in the returned resources. Available options are:
    • email_series_pivots
    • sponsor
Example request: https://api.artic.edu/api/v1/events?limit=2
{
    "pagination": {
        "total": 2073,
        "limit": 2,
        "offset": 0,
        "total_pages": 1037,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/events?page=2&limit=2"
    },
    "data": [
        {
            "id": 3972,
            "api_model": "events",
            "api_link": "https://api.artic.edu/api/v1/events/3972",
            "title": "Concert: Thurston Moore Presents New Noise Guitar Explorations",
            "title_display": null,
            "published": true,
            ...
        },
        {
            "id": 3927,
            "api_model": "events",
            "api_link": "https://api.artic.edu/api/v1/events/3927",
            "title": "Concert: Sun Ra Arkestra",
            "title_display": null,
            "published": true,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search events data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/events/search
{
    "preference": null,
    "pagination": {
        "total": 2010,
        "limit": 10,
        "offset": 0,
        "total_pages": 201,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1.0656996,
            "api_model": "events",
            "api_link": "https://api.artic.edu/api/v1/events/4972",
            "id": 4972,
            "title": "Conversation: The Life Cycle of an El Greco Masterpiece\u2014POSTPONED",
            "timestamp": "2021-03-22T03:51:32-05:00"
        },
        {
            "_score": 1.0656996,
            "api_model": "events",
            "api_link": "https://api.artic.edu/api/v1/events/4974",
            "id": 4974,
            "title": "Performance: The Seldoms\u2014Floe",
            "timestamp": "2021-03-22T03:51:32-05:00"
        },
        {
            "_score": 1.0656996,
            "api_model": "events",
            "api_link": "https://api.artic.edu/api/v1/events/4975",
            "id": 4975,
            "title": "CANCELED | Performance: The Seldoms\u2014Floe",
            "timestamp": "2021-03-22T03:51:32-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /events/{id}

A single event by the given identifier.

Example request: https://api.artic.edu/api/v1/events/4
{
    "data": {
        "id": 4,
        "api_model": "events",
        "api_link": "https://api.artic.edu/api/v1/events/4",
        "title": "Member Preview: John Singer Sargent and Chicago\u2019s Gilded Age",
        "title_display": null,
        "published": true,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Event Occurrences

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /event-occurrences

A list of all event-occurrences sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/event-occurrences?limit=2
{
    "pagination": {
        "total": 19,
        "limit": 2,
        "offset": 0,
        "total_pages": 10,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/event-occurrences?page=2&limit=2"
    },
    "data": [
        {
            "id": "178b4bfc-a4cb-5739-83ce-113bde6f45c5",
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/178b4bfc-a4cb-5739-83ce-113bde6f45c5",
            "title": "Virtual Reading and Conversation: Jenny Offill and Ling Ma",
            "event_id": 5138,
            "short_description": "Authors Jenny Offill and Ling Ma reflect on art, literature, and the experienceof living your life during a globalcrisis.",
            ...
        },
        {
            "id": "29a87bc4-6fda-5aec-be22-bb723914cb13",
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/29a87bc4-6fda-5aec-be22-bb723914cb13",
            "title": "Virtual Talk: Chicago Stories",
            "event_id": 5141,
            "short_description": "Educators Corinne Rose and Nancy Chen focus on the artwork of the Ukrainian-born artist Todros Geller as a lens to explore immigrant experience in 1920s Chicago.",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search event-occurrences data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/event-occurrences/search
{
    "preference": null,
    "pagination": {
        "total": 35,
        "limit": 10,
        "offset": 0,
        "total_pages": 4,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1.2260857,
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/019afb63-9f6f-536c-91b1-83a55811699a",
            "id": "019afb63-9f6f-536c-91b1-83a55811699a",
            "title": "Jam 2021: Research",
            "timestamp": "2021-03-22T03:51:33-05:00"
        },
        {
            "_score": 1.2260857,
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/06baf7b8-ffbc-55bf-b4fe-064c943e24a9",
            "id": "06baf7b8-ffbc-55bf-b4fe-064c943e24a9",
            "title": "Jam 2021: \u201cHandle with Care\u201d",
            "timestamp": "2021-03-22T03:51:33-05:00"
        },
        {
            "_score": 1.2260857,
            "api_model": "event-occurrences",
            "api_link": "https://api.artic.edu/api/v1/event-occurrences/0ce64fcf-f529-560d-8b4c-55a246b48065",
            "id": "0ce64fcf-f529-560d-8b4c-55a246b48065",
            "title": "Luminary Tour: Hartwell Memorial Window",
            "timestamp": "2021-03-22T03:51:33-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /event-occurrences/{id}

A single event-occurrence by the given identifier.

Example request: https://api.artic.edu/api/v1/event-occurrences/06227504-e4c5-543f-90a8-2acc0c203788
{
    "data": {
        "id": "06227504-e4c5-543f-90a8-2acc0c203788",
        "api_model": "event-occurrences",
        "api_link": "https://api.artic.edu/api/v1/event-occurrences/06227504-e4c5-543f-90a8-2acc0c203788",
        "title": "Virtual Member Lecture: Cosmoscapes\u2014Ink Paintings by Tai Xiangzhou",
        "event_id": 5117,
        "short_description": "Curator of Chinese art Colin Mackenzie discusses the revelatory works of Tai Xiangzhou, followed by a conversation betweenTao Wang,Pritzker Chair of the Arts of Asia and curator of Chinese art,and the artist.",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Event Programs

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /event-programs

A list of all event-programs sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/event-programs?limit=2
{
    "pagination": {
        "total": 70,
        "limit": 2,
        "offset": 0,
        "total_pages": 35,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/event-programs?page=2&limit=2"
    },
    "data": [
        {
            "id": 10,
            "api_model": "event-programs",
            "api_link": "https://api.artic.edu/api/v1/event-programs/10",
            "title": "Intersections",
            "is_affiliate_group": false,
            "is_event_host": false,
            ...
        },
        {
            "id": 9,
            "api_model": "event-programs",
            "api_link": "https://api.artic.edu/api/v1/event-programs/9",
            "title": "Modern Wing Highlights",
            "is_affiliate_group": false,
            "is_event_host": false,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search event-programs data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/event-programs/search
{
    "preference": null,
    "pagination": {
        "total": 70,
        "limit": 10,
        "offset": 0,
        "total_pages": 7,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "event-programs",
            "api_link": "https://api.artic.edu/api/v1/event-programs/1",
            "id": 1,
            "title": "Artist\u2019s Studio",
            "timestamp": "2021-03-22T03:51:34-05:00"
        },
        {
            "_score": 1,
            "api_model": "event-programs",
            "api_link": "https://api.artic.edu/api/v1/event-programs/2",
            "id": 2,
            "title": "Family Festivals",
            "timestamp": "2021-03-22T03:51:34-05:00"
        },
        {
            "_score": 1,
            "api_model": "event-programs",
            "api_link": "https://api.artic.edu/api/v1/event-programs/3",
            "id": 3,
            "title": "Picture This",
            "timestamp": "2021-03-22T03:51:34-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /event-programs/{id}

A single event-program by the given identifier.

Example request: https://api.artic.edu/api/v1/event-programs/1
{
    "data": {
        "id": 1,
        "api_model": "event-programs",
        "api_link": "https://api.artic.edu/api/v1/event-programs/1",
        "title": "Artist\u2019s Studio",
        "is_affiliate_group": false,
        "is_event_host": false,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Articles

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /articles

A list of all articles sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/articles?limit=2
{
    "pagination": {
        "total": 301,
        "limit": 2,
        "offset": 0,
        "total_pages": 151,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/articles?page=2&limit=2"
    },
    "data": [
        {
            "id": 889,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/889",
            "title": "when-eileen-agar-made-a-magritte-her-own",
            "is_published": false,
            "date": "2020-12-15T00:00:00-06:00",
            ...
        },
        {
            "id": 705,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/705",
            "title": "hidden-materials-in-john-singer-sargents-watercolors",
            "is_published": true,
            "date": "2018-08-01T00:00:00-05:00",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search articles data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/articles/search
{
    "preference": null,
    "pagination": {
        "total": 312,
        "limit": 10,
        "offset": 0,
        "total_pages": 32,
        "current_page": 1
    },
    "data": [
        {
            "_score": 4.062318,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/14",
            "id": 14,
            "title": "secrets-of-the-modern-wing",
            "timestamp": "2021-03-22T03:51:34-05:00"
        },
        {
            "_score": 4.062318,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/18",
            "id": 18,
            "title": "your-move",
            "timestamp": "2021-03-22T03:51:34-05:00"
        },
        {
            "_score": 4.062318,
            "api_model": "articles",
            "api_link": "https://api.artic.edu/api/v1/articles/26",
            "id": 26,
            "title": "secrets-of-the-modern-wing-take-two",
            "timestamp": "2021-03-22T03:51:34-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /articles/{id}

A single article by the given identifier.

Example request: https://api.artic.edu/api/v1/articles/14
{
    "data": {
        "id": 14,
        "api_model": "articles",
        "api_link": "https://api.artic.edu/api/v1/articles/14",
        "title": "secrets-of-the-modern-wing",
        "is_published": true,
        "date": "2009-11-03T00:00:00-06:00",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Selections

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /selections

A list of all selections sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/selections?limit=2
{
    "pagination": {
        "total": 23,
        "limit": 2,
        "offset": 0,
        "total_pages": 12,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/selections?page=2&limit=2"
    },
    "data": [
        {
            "id": 8,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/8",
            "title": "holidays-at-the-art-institute-201920",
            "published": false,
            "short_copy": "<p>Make the Art Institute your home for the holidays this season.</p>",
            ...
        },
        {
            "id": 6,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/6",
            "title": "american-art",
            "published": true,
            "short_copy": "<p>The Art Institute boasts an outstanding collection of American Art\u2014fitting for a classic American city. Find some of the icons below.</p>",
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search selections data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/selections/search
{
    "preference": null,
    "pagination": {
        "total": 25,
        "limit": 10,
        "offset": 0,
        "total_pages": 3,
        "current_page": 1
    },
    "data": [
        {
            "_score": 4.3071003,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/3",
            "id": 3,
            "title": "what-to-see-in-an-hour",
            "timestamp": "2021-03-22T03:51:35-05:00"
        },
        {
            "_score": 4.3071003,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/4",
            "id": 4,
            "title": "new-on-view",
            "timestamp": "2021-03-22T03:51:35-05:00"
        },
        {
            "_score": 4.3071003,
            "api_model": "selections",
            "api_link": "https://api.artic.edu/api/v1/selections/5",
            "id": 5,
            "title": "impressionism",
            "timestamp": "2021-03-22T03:51:35-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /selections/{id}

A single selection by the given identifier.

Example request: https://api.artic.edu/api/v1/selections/3
{
    "data": {
        "id": 3,
        "api_model": "selections",
        "api_link": "https://api.artic.edu/api/v1/selections/3",
        "title": "what-to-see-in-an-hour",
        "published": true,
        "short_copy": "Short on time? Never fear, you can still see some of the most iconic and beloved works in the Art Institute\u2019s collection on this quick spin through the galleries. Ready, set\u2014art!",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Web Artists

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /web-artists

A list of all web-artists sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/web-artists?limit=2
{
    "pagination": {
        "total": 139,
        "limit": 2,
        "offset": 0,
        "total_pages": 70,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/web-artists?page=2&limit=2"
    },
    "data": [
        {
            "id": 3,
            "api_model": "web-artists",
            "api_link": "https://api.artic.edu/api/v1/web-artists/3",
            "title": "Neue Galerie New York",
            "has_also_known_as": null,
            "intro_copy": null,
            ...
        },
        {
            "id": 2,
            "api_model": "web-artists",
            "api_link": "https://api.artic.edu/api/v1/web-artists/2",
            "title": "Don A. DuBroff",
            "has_also_known_as": null,
            "intro_copy": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search web-artists data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/web-artists/search
{
    "preference": null,
    "pagination": {
        "total": 165,
        "limit": 10,
        "offset": 0,
        "total_pages": 17,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "web-artists",
            "api_link": "https://api.artic.edu/api/v1/web-artists/1",
            "id": 1,
            "title": "Winslow Homer",
            "timestamp": "2021-03-22T03:51:35-05:00"
        },
        {
            "_score": 1,
            "api_model": "web-artists",
            "api_link": "https://api.artic.edu/api/v1/web-artists/2",
            "id": 2,
            "title": "Don A. DuBroff",
            "timestamp": "2021-03-22T03:51:35-05:00"
        },
        {
            "_score": 1,
            "api_model": "web-artists",
            "api_link": "https://api.artic.edu/api/v1/web-artists/3",
            "id": 3,
            "title": "Neue Galerie New York",
            "timestamp": "2021-03-22T03:51:35-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /web-artists/{id}

A single web-artist by the given identifier.

Example request: https://api.artic.edu/api/v1/web-artists/1
{
    "data": {
        "id": 1,
        "api_model": "web-artists",
        "api_link": "https://api.artic.edu/api/v1/web-artists/1",
        "title": "Winslow Homer",
        "has_also_known_as": null,
        "intro_copy": "<p>Winslow Homer, one of the most influential American painters of the nineteenth century, is known for his dynamic depictions of the power and beauty of nature and reflections on humanity\u2019s struggle with the sea. A keen observer of the world around him, Homer likewise experimented with color, form, and composition, pushing his landscapes and genre pictures in modern directions. Raised in Massachusetts, he apprenticed in a lithography shop in Boston in the mid-1850s and soon secured work as a freelance illustrator. Relocating to New York, he undertook assignments for <em>Harper\u2019s Weekly</em><span>, among other journals, and enrolled in drawing classes at the National Academy of Design.&nbsp;</span></p><p>During the Civil War, <em>Harper\u2019s Weekly</em><span> sent</span><em><span> </span></em><span>Homer to the front, where he made drawings of </span><a href=\"https://www.artic.edu/artworks/158367/the-war-for-the-union-1862-a-cavalry-charge\" target=\"_blank\"><span>Union battlefields</span></a><span>, camps, and military hospitals that appeared as wood engravings in the widely circulated publication. Homer also took up painting during his time as an artist-correspondent. After the war, he focused on oil painting, working in New York and also traveling to France in 1866\u201367. Over the following decade, Homer painted </span><a href=\"https://www.artic.edu/artworks/44018/croquet-scene\" target=\"_blank\"><span>scenes of leisure</span></a><span> set in nature, such as </span><a href=\"https://www.artic.edu/artworks/75957/mount-washington\" target=\"_blank\"><span>the White Mountains</span></a><span> in New Hampshire and the Adirondacks in upstate New York. He also spent his summers visiting </span><a href=\"https://www.artic.edu/artworks/16800/boy-in-boat-gloucester\" target=\"_blank\"><span>New England fishing villages</span></a><span>, discovering new subjects that had a profound effect on his career.&nbsp;</span></p><p>In 1881, he spent more than a year in the small fishing village of Cullercoats, England. This extended stay in the seaside community catalyzed a new, enduring interest in humankind\u2019s age-old contest with nature, rendered in larger-scale compositions with more monumental figures and forms. In the summer of 1883 Homer moved to the coastal village of Prouts Neck, Maine, which remained his home for the rest of his life. There, he observed the shoreline in various weather conditions and seasons, creating his great seascapes, such as the iconic work <a href=\"https://www.artic.edu/artworks/25865/the-herring-net\" target=\"_blank\"><em>The Herring Net</em></a><span>. Amid the remote and dramatic landscape, he depicted views void of human life, focusing instead on an emotional response to nature, as in </span><a href=\"https://www.artic.edu/artworks/8971/coast-of-maine\" target=\"_blank\"><em><span>Coast of Maine</span></em></a><span>.&nbsp;</span></p><p>Late in his career, during visits to the Bahamas, Bermuda, Cuba, and Florida, Homer applied his sophisticated understanding of color and light to a new set of atmospheric conditions, most spectacularly in his watercolors, such as <a href=\"https://www.artic.edu/artworks/16776/after-the-hurricane-bahamas\" target=\"_blank\"><em>After the Hurricane, Bahamas</em></a><span>.</span></p><p>The Art Institute\u2019s collection of works by Winslow Homer spans his career. The artist\u2019s works on paper were featured in the 2008 exhibition <a href=\"https://archive.artic.edu/homer_exhb/overview/\" target=\"_blank\"><em>Watercolors by Winslow Homer: The Color of Light</em></a><em>.</em></p>",
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Static Pages

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /static-pages

A list of all static-pages sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/static-pages?limit=2
{
    "pagination": {
        "total": 11,
        "limit": 2,
        "offset": 0,
        "total_pages": 6,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/static-pages?page=2&limit=2"
    },
    "data": [
        {
            "id": 11,
            "api_model": "static-pages",
            "api_link": "https://api.artic.edu/api/v1/static-pages/11",
            "title": "Articles",
            "web_url": "/articles",
            "is_published": true,
            ...
        },
        {
            "id": 2,
            "api_model": "static-pages",
            "api_link": "https://api.artic.edu/api/v1/static-pages/2",
            "title": "Events",
            "web_url": "/events",
            "is_published": true,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search static-pages data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/static-pages/search
{
    "preference": null,
    "pagination": {
        "total": 11,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 4.0851192,
            "api_model": "static-pages",
            "api_link": "https://api.artic.edu/api/v1/static-pages/1",
            "id": 1,
            "title": "Visit",
            "timestamp": "2021-03-22T14:15:05-05:00"
        },
        {
            "_score": 4.0851192,
            "api_model": "static-pages",
            "api_link": "https://api.artic.edu/api/v1/static-pages/2",
            "id": 2,
            "title": "Events",
            "timestamp": "2021-03-22T14:15:05-05:00"
        },
        {
            "_score": 4.0851192,
            "api_model": "static-pages",
            "api_link": "https://api.artic.edu/api/v1/static-pages/3",
            "id": 3,
            "title": "Exhibitions",
            "timestamp": "2021-03-22T14:15:05-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /static-pages/{id}

A single static-page by the given identifier.

Example request: https://api.artic.edu/api/v1/static-pages/1
{
    "data": {
        "id": 1,
        "api_model": "static-pages",
        "api_link": "https://api.artic.edu/api/v1/static-pages/1",
        "title": "Visit",
        "web_url": "/visit",
        "is_published": true,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Generic Pages

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /generic-pages

A list of all generic-pages sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/generic-pages?limit=2
{
    "pagination": {
        "total": 255,
        "limit": 2,
        "offset": 0,
        "total_pages": 128,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/generic-pages?page=2&limit=2"
    },
    "data": [
        {
            "id": 468,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/468",
            "title": "test",
            "is_published": false,
            "type": null,
            ...
        },
        {
            "id": 204,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/204",
            "title": "Databases for Auction Research",
            "is_published": false,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search generic-pages data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/generic-pages/search
{
    "preference": null,
    "pagination": {
        "total": 259,
        "limit": 10,
        "offset": 0,
        "total_pages": 26,
        "current_page": 1
    },
    "data": [
        {
            "_score": 4.155737,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/2",
            "id": 2,
            "title": "Free Admission Opportunities",
            "timestamp": "2021-03-22T03:51:36-05:00"
        },
        {
            "_score": 4.155737,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/4",
            "id": 4,
            "title": "Directions & Parking",
            "timestamp": "2021-03-22T03:51:36-05:00"
        },
        {
            "_score": 4.155737,
            "api_model": "generic-pages",
            "api_link": "https://api.artic.edu/api/v1/generic-pages/6",
            "id": 6,
            "title": "Dining",
            "timestamp": "2021-03-22T03:51:36-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /generic-pages/{id}

A single generic-page by the given identifier.

Example request: https://api.artic.edu/api/v1/generic-pages/2
{
    "data": {
        "id": 2,
        "api_model": "generic-pages",
        "api_link": "https://api.artic.edu/api/v1/generic-pages/2",
        "title": "Free Admission Opportunities",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Press Releases

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /press-releases

A list of all press-releases sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/press-releases?limit=2
{
    "pagination": {
        "total": 281,
        "limit": 2,
        "offset": 0,
        "total_pages": 141,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/press-releases?page=2&limit=2"
    },
    "data": [
        {
            "id": 60,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/60",
            "title": "Press Releases from 1998",
            "is_published": true,
            "type": null,
            ...
        },
        {
            "id": 50,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/50",
            "title": "Press Releases from 1988",
            "is_published": true,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search press-releases data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/press-releases/search
{
    "preference": null,
    "pagination": {
        "total": 284,
        "limit": 10,
        "offset": 0,
        "total_pages": 29,
        "current_page": 1
    },
    "data": [
        {
            "_score": 4.0141125,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/1",
            "id": 1,
            "title": "Press Releases from 1939",
            "timestamp": "2021-03-22T03:51:36-05:00"
        },
        {
            "_score": 4.0141125,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/2",
            "id": 2,
            "title": "Press Releases from 1940",
            "timestamp": "2021-03-22T03:51:36-05:00"
        },
        {
            "_score": 4.0141125,
            "api_model": "press-releases",
            "api_link": "https://api.artic.edu/api/v1/press-releases/3",
            "id": 3,
            "title": "Press Releases from 1941",
            "timestamp": "2021-03-22T03:51:36-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /press-releases/{id}

A single press-release by the given identifier.

Example request: https://api.artic.edu/api/v1/press-releases/1
{
    "data": {
        "id": 1,
        "api_model": "press-releases",
        "api_link": "https://api.artic.edu/api/v1/press-releases/1",
        "title": "Press Releases from 1939",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Educator Resources

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /educator-resources

A list of all educator-resources sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/educator-resources?limit=2
{
    "pagination": {
        "total": 110,
        "limit": 2,
        "offset": 0,
        "total_pages": 55,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/educator-resources?page=2&limit=2"
    },
    "data": [
        {
            "id": 2,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/2",
            "title": "Test Resource",
            "is_published": false,
            "type": null,
            ...
        },
        {
            "id": 3,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/3",
            "title": "Activity: Arrival of the Normandy Train, Gare Saint-Lazare",
            "is_published": false,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search educator-resources data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/educator-resources/search
{
    "preference": null,
    "pagination": {
        "total": 120,
        "limit": 10,
        "offset": 0,
        "total_pages": 12,
        "current_page": 1
    },
    "data": [
        {
            "_score": 4.6027293,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/7",
            "id": 7,
            "title": "Thematic Curriculum: Art + Science",
            "timestamp": "2021-03-22T03:51:37-05:00"
        },
        {
            "_score": 4.6027293,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/12",
            "id": 12,
            "title": "Educator Resource Packet: A Boy in Front of the Loews 125th Street Movie Theater, from the series Harlem, U.S.A",
            "timestamp": "2021-03-22T03:51:37-05:00"
        },
        {
            "_score": 4.6027293,
            "api_model": "educator-resources",
            "api_link": "https://api.artic.edu/api/v1/educator-resources/13",
            "id": 13,
            "title": "Educator Resource Packet: America Windows by Marc Chagall",
            "timestamp": "2021-03-22T03:51:37-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /educator-resources/{id}

A single educator-resource by the given identifier.

Example request: https://api.artic.edu/api/v1/educator-resources/7
{
    "data": {
        "id": 7,
        "api_model": "educator-resources",
        "api_link": "https://api.artic.edu/api/v1/educator-resources/7",
        "title": "Thematic Curriculum: Art + Science",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Digital Catalogs

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /digital-catalogs

A list of all digital-catalogs sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/digital-catalogs?limit=2
{
    "pagination": {
        "total": 15,
        "limit": 2,
        "offset": 0,
        "total_pages": 8,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/digital-catalogs?page=2&limit=2"
    },
    "data": [
        {
            "id": 2,
            "api_model": "digital-catalogs",
            "api_link": "https://api.artic.edu/api/v1/digital-catalogs/2",
            "title": "American Silver",
            "is_published": true,
            "type": null,
            ...
        },
        {
            "id": 5,
            "api_model": "digital-catalogs",
            "api_link": "https://api.artic.edu/api/v1/digital-catalogs/5",
            "title": "Roman Art at the Art Institute of Chicago",
            "is_published": true,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search digital-catalogs data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/digital-catalogs/search
{
    "preference": null,
    "pagination": {
        "total": 17,
        "limit": 10,
        "offset": 0,
        "total_pages": 2,
        "current_page": 1
    },
    "data": [
        {
            "_score": 4.115182,
            "api_model": "digital-catalogs",
            "api_link": "https://api.artic.edu/api/v1/digital-catalogs/2",
            "id": 2,
            "title": "American Silver",
            "timestamp": "2021-03-22T03:51:38-05:00"
        },
        {
            "_score": 4.115182,
            "api_model": "digital-catalogs",
            "api_link": "https://api.artic.edu/api/v1/digital-catalogs/3",
            "id": 3,
            "title": "Modern Series: Go",
            "timestamp": "2021-03-22T03:51:38-05:00"
        },
        {
            "_score": 4.115182,
            "api_model": "digital-catalogs",
            "api_link": "https://api.artic.edu/api/v1/digital-catalogs/4",
            "id": 4,
            "title": "Manet Paintings and Works on Paper at the Art Institute of Chicago",
            "timestamp": "2021-03-22T03:51:38-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /digital-catalogs/{id}

A single digital-catalog by the given identifier.

Example request: https://api.artic.edu/api/v1/digital-catalogs/2
{
    "data": {
        "id": 2,
        "api_model": "digital-catalogs",
        "api_link": "https://api.artic.edu/api/v1/digital-catalogs/2",
        "title": "American Silver",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Printed Catalogs

The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for "fair use" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.

# GET /printed-catalogs

A list of all printed-catalogs sorted by last updated date in descending order. For a description of all the fields included with this response, see here.

# Available parameters:
  • ids - A comma-separated list of resource ids to retrieve
  • limit - The number of resources to return per page
  • page - The page of resources to retrieve
  • fields - A comma-separated list of fields to return per resource
Example request: https://api.artic.edu/api/v1/printed-catalogs?limit=2
{
    "pagination": {
        "total": 183,
        "limit": 2,
        "offset": 0,
        "total_pages": 92,
        "current_page": 1,
        "next_url": "https://api.artic.edu/api/v1/printed-catalogs?page=2&limit=2"
    },
    "data": [
        {
            "id": 41,
            "api_model": "printed-catalogs",
            "api_link": "https://api.artic.edu/api/v1/printed-catalogs/41",
            "title": "2001: Building for Space Travel",
            "is_published": true,
            "type": null,
            ...
        },
        {
            "id": 39,
            "api_model": "printed-catalogs",
            "api_link": "https://api.artic.edu/api/v1/printed-catalogs/39",
            "title": "1945: Creativity and Crisis, Chicago Architecture and Design of the World War II Era",
            "is_published": true,
            "type": null,
            ...
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

Search printed-catalogs data in the aggregator.

# Available parameters:
  • q - Your search query
  • query - For complex queries, you can pass Elasticsearch domain syntax queries here
  • sort - Used in conjunction with query
  • from - Starting point of results. Pagination via Elasticsearch conventions
  • size - Number of results to return. Pagination via Elasticsearch conventions
  • facets - A comma-separated list of 'count' aggregation facets to include in the results.
Example request: https://api.artic.edu/api/v1/printed-catalogs/search
{
    "preference": null,
    "pagination": {
        "total": 184,
        "limit": 10,
        "offset": 0,
        "total_pages": 19,
        "current_page": 1
    },
    "data": [
        {
            "_score": 1,
            "api_model": "printed-catalogs",
            "api_link": "https://api.artic.edu/api/v1/printed-catalogs/4",
            "id": 4,
            "title": "The Art Institute of Chicago: The Essential Guide",
            "timestamp": "2021-03-22T03:51:38-05:00"
        },
        {
            "_score": 1,
            "api_model": "printed-catalogs",
            "api_link": "https://api.artic.edu/api/v1/printed-catalogs/5",
            "id": 5,
            "title": "Roy Lichtenstein: A Retrospective",
            "timestamp": "2021-03-22T03:51:38-05:00"
        },
        {
            "_score": 1,
            "api_model": "printed-catalogs",
            "api_link": "https://api.artic.edu/api/v1/printed-catalogs/6",
            "id": 6,
            "title": "Dawoud Bey: Harlem, U.S.A.",
            "timestamp": "2021-03-22T03:51:38-05:00"
        }
    ],
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.0"
    }
}
# GET /printed-catalogs/{id}

A single printed-catalog by the given identifier.

Example request: https://api.artic.edu/api/v1/printed-catalogs/4
{
    "data": {
        "id": 4,
        "api_model": "printed-catalogs",
        "api_link": "https://api.artic.edu/api/v1/printed-catalogs/4",
        "title": "The Art Institute of Chicago: The Essential Guide",
        "is_published": true,
        "type": null,
        ...
    },
    "info": {
        "license_text": "The data in this response may be protected by copyright, and other restrictions, of the Art Institute of Chicago and third parties. You may use this data for noncommercial educational and personal use and for \"fair use\" as authorized under law, provided that you also retain all copyright and other proprietary notices contained on the materials and cite the author and source of the materials.",
        "license_links": [
            "https://www.artic.edu/terms"
        ],
        "version": "1.1"
    },
    "config": {
        "iiif_url": "https://www.artic.edu/iiif/2",
        "website_url": "https://www.artic.edu"
    }
}

# Fields

# Collections

# Artworks

Represents a work of art in our collections. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • is_boosted boolean - Whether this document should be boosted in search
  • title string - The name of this resource
  • alt_titles array - Alternate names for this work
  • thumbnail array - Metadata about the image referenced by image_id. Currently, all thumbnails are IIIF images. You must build your own image URLs using IIIF Image API conventions. See our API documentation for more details.
  • main_reference_number string - Unique identifier assigned to the artwork upon acquisition
  • has_not_been_viewed_much boolean - Whether the artwork hasn't been visited on our website very much
  • boost_rank number - Manual indication of what rank this artwork should take in search results. Noncontiguous.
  • date_start number - The year of the period of time associated with the creation of this work
  • date_end number - The year of the period of time associated with the creation of this work
  • date_display string - Readable, free-text description of the period of time associated with the creation of this work. This might include date terms like Dynasty, Era etc. Written by curators and editors in house style, and is the preferred field for display on websites and apps.
  • date_qualifier_title string - Readable, text qualifer to the dates provided for this record.
  • date_qualifier_id integer - Unique identifier of the qualifer to the dates provided for this record.
  • artist_display string - Readable description of the creator of this work. Includes artist names, nationality and lifespan dates
  • place_of_origin string - The location where the creation, design, or production of the work took place, or the original location of the work
  • dimensions string - The size, shape, scale, and dimensions of the work. May include multiple dimensions like overall, frame, or dimension for each section of a work. Free-form text formatted in a house style.
  • medium_display string - The substances or materials used in the creation of a work
  • inscriptions string - A description of distinguishing or identifying physical markings that are on the work
  • credit_line string - Brief statement indicating how the work came into the collection
  • publication_history string - Bibliographic list of all the places this work has been published
  • exhibition_history string - List of all the places this work has been exhibited
  • provenance_text string - Ownership/collecting history of the work. May include names of owners, dates, and possibly methods of transfer of ownership. Free-form text formatted in a house style.
  • publishing_verification_level string - Indicator of how much metadata on the work in published. Web Basic is the least amount, Web Everything is the greatest.
  • internal_department_id number - An internal department id we use for analytics. Does not correspond to departments on the website.
  • fiscal_year number - The fiscal year in which the work was acquired.
  • fiscal_year_deaccession number - The fiscal year in which the work was deaccessioned.
  • is_public_domain boolean - Whether the work is in the public domain, meaning it was created before copyrights existed or has left the copyright term
  • is_zoomable boolean - Whether images of the work are allowed to be displayed in a zoomable interface.
  • max_zoom_window_size number - The maximum size of the window the image is allowed to be viewed in, in pixels.
  • copyright_notice string - Statement notifying how the work is protected by copyright. Applies to the work itself, not image or other related assets.
  • has_multimedia_resources boolean - Whether this artwork has any associated microsites, digital publications, or documents tagged as multimedia
  • has_educational_resources boolean - Whether this artwork has any documents tagged as educational
  • colorfulness float - Unbounded positive float representing an abstract measure of colorfulness.
  • color object - Dominant color of this artwork in HSL
  • latitude number - Latitude coordinate of the location of this work in our galleries
  • longitude number - Longitude coordinate of the location of this work in our galleries
  • latlon string - Latitude and longitude coordinates of the location of this work in our galleries
  • is_on_view boolean - Whether the work is on display
  • on_loan_display string - If an artwork is on loan, this contains details about the loan
  • gallery_title string - The location of this work in our museum
  • gallery_id number - Unique identifier of the location of this work in our museum
  • artwork_type_title string - The kind of object or work (e.g. Painting, Sculpture, Book)
  • artwork_type_id number - Unique identifier of the kind of object or work
  • department_title string - Name of the curatorial department that this work belongs to
  • department_id number - Unique identifier of the curatorial department that this work belongs to
  • artist_id integer - Unique identifier of the preferred artist/culture associated with this work
  • artist_title string - Name of the preferred artist/culture associated with this work
  • alt_artist_ids array - Unique identifiers of the non-preferred artists/cultures associated with this work
  • artist_ids integer - Unique identifier of all artist/cultures associated with this work
  • artist_titles array - Names of all artist/cultures associated with this work
  • category_ids array - Unique identifiers of the categories this work is a part of
  • category_titles array - Names of the categories this artwork is a part of
  • artwork_catalogue_ids array - This list represents all the catalogues this work is included in. This isn't an exhaustive list of publications where the work has been mentioned. For that, see publication_history.
  • term_titles array - The names of the taxonomy tags for this work
  • style_id string - Unique identifier of the preferred style term for this work
  • style_title string - The name of the preferred style term for this work
  • alt_style_ids array - Unique identifiers of all other non-preferred style terms for this work
  • style_ids array - Unique identifiers of all style terms for this work
  • style_titles array - The names of all style terms related to this artwork
  • classification_id string - Unique identifier of the preferred classification term for this work
  • classification_title string - The name of the preferred classification term for this work
  • alt_classification_ids array - Unique identifiers of all other non-preferred classification terms for this work
  • classification_ids array - Unique identifiers of all classification terms for this work
  • classification_titles array - The names of all classification terms related to this artwork
  • subject_id string - Unique identifier of the preferred subject term for this work
  • alt_subject_ids array - Unique identifiers of all other non-preferred subject terms for this work
  • subject_ids array - Unique identifiers of all subject terms for this work
  • subject_titles array - The names of all subject terms related to this artwork
  • material_id string - Unique identifier of the preferred material term for this work
  • alt_material_ids array - Unique identifiers of all other non-preferred material terms for this work
  • material_ids array - Unique identifiers of all material terms for this work
  • material_titles array - The names of all material terms related to this artwork
  • technique_id string - Unique identifier of the preferred technique term for this work
  • alt_technique_ids array - Unique identifiers of all other non-preferred technique terms for this work
  • technique_ids array - Unique identifiers of all technique terms for this work
  • technique_titles array - The names of all technique terms related to this artwork
  • theme_titles array - The names of all thematic publish categories related to this artwork
  • image_id uuid - Unique identifier of the preferred image to use to represent this work
  • alt_image_ids array - Unique identifiers of all non-preferred images of this work.
  • document_ids array - Unique identifiers of assets that serve as documentation for this artwork
  • sound_ids uuid - Unique identifiers of the audio about this work
  • video_ids uuid - Unique identifiers of the videos about this work
  • text_ids uuid - Unique identifiers of the texts about this work
  • section_ids array - Unique identifiers of the digital publication chapters this work in included in
  • section_titles array - Names of the digital publication chapters this work is included in
  • site_ids array - Unique identifiers of the microsites this work is a part of
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Agents

Represents a person or organization. In the API, this includes artists. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • sort_title string - Sortable name for this agent, typically with last name first.
  • alt_titles array - Alternate names for this agent
  • birth_date number - The year this agent was born
  • birth_place string - Name of the place this agent was born
  • death_date number - The year this agent died
  • death_place string - Name of the place this agent died
  • description string - A biographical description of the agent
  • is_licensing_restricted boolean - Whether the use of the images of works by this artist are restricted by licensing
  • is_artist boolean - Whether the agent is an artist. Solely based on whether the agent is listed as an artist for an artwork record.
  • agent_type_title string - Name of the type of agent, e.g. individual, fund, school, organization, etc.
  • agent_type_id number - Unique identifier of the type of agent, e.g. individual, fund, school, organization, etc.
  • artwork_ids array - Unique identifiers of the works this artist created.
  • site_ids array - Unique identifiers of the microsites this exhibition is a part of
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Places

A room or hall that works of art are displayed in. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: AIC Gallery, AIC Storage, No location
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Galleries

A room or hall that works of art are displayed in. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: AIC Gallery, AIC Storage, No location
  • is_closed boolean - Whether the gallery is currently closed
  • number string - The gallery's room number. For "Gallery 100A", this would be "100A".
  • floor string - The level the gallery is on, e.g., 1, 2, 3, or LL
  • latitude number - Latitude coordinate of the center of the room
  • longitude number - Longitude coordinate of the center of the room
  • latlon string - Latitude and longitude coordinates of the center of the room
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Exhibitions

An organized presentation and display of a selection of artworks. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • is_featured boolean - Is this exhibition currently featured on our website?
  • description string - Explanation of what this exhibition is
  • short_description string - Brief explanation of what this exhibition is
  • web_url string - URL to this exhibition on our website
  • image_url string - URL to the hero image from the website
  • type string - The type of exhibition. In particular this notes whether the exhibition was only displayed at the Art Institute or whether it traveled to other venues.
  • status string - Whether the exhibition is open or closed
  • aic_start_at ISO 8601 date and time - Date the exhibition opened at the Art Institute of Chicago
  • aic_end_at ISO 8601 date and time - Date the exhibition closed at the Art Institute of Chicago
  • date_display string - A human-friendly string describing when this exhibition was open
  • department_display string - The name of the department that primarily organized the exhibition
  • gallery_id number - Unique identifier of the gallery that mainly housed the exhibition
  • gallery_title string - The name of the gallery that mainly housed the exhibition
  • artwork_ids array - Unique identifiers of the artworks that were part of the exhibition
  • artwork_titles array - Names of the artworks that were part of the exhibition
  • artist_ids array - Unique identifiers of the artist agent records representing who was shown in the exhibition
  • site_ids array - Unique identifiers of the microsites this exhibition is a part of
  • image_id uuid - Unique identifier of the preferred image to use to represent this exhibition
  • alt_image_ids array - Unique identifiers of all non-preferred images of this exhibition.
  • document_ids array - Unique identifiers of assets that serve as documentation for this exhibition
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Agent Types

A kind of agent, e.g. Individual, Couple, School, Estate, Culture. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Agent Roles

A qualifier for the relationship an agent may have to an artwork. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Agent Place Qualifiers

A qualifier for the relationship a place may have to an agent. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Artwork Types

A kind of object or work, e.g., Painting, Sculpture, Book, etc. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Artwork Place Qualifiers

A qualifier for the relationship a place may have to an artwork. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Artwork Date Qualifiers

A kind of date on at artwork, e.g., Made, Reconstructed, Published, etc. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Catalogues

Represents a catalogue raisonne. A catalogue raisonné is a comprehensive, annotated listing of all the known artworks by an artist. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Category Terms

Tag-like classifications of artworks and other resources. For a description of all the endpoints available for this resource, see here.

  • id keyword - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • subtype string - Takes one of the following values: classification, material, technique, style, subject, department, theme
  • parent_id string - Unique identifier of this category's parent
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Images

A pictorial representation of a collections resource, like an artwork, artist, exhibition, etc. For a description of all the endpoints available for this resource, see here.

  • id keyword - Unique identifier of this resource. Taken from the source system.
  • lake_guid uuid - Unique UUID of this resource in LAKE, our DAMS.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: image, sound, text, video
  • description string - Explanation of what this asset is
  • alt_text string - Alternative text for the asset to describe it to people with low or no vision
  • content string - Text of or URL to the contents of this asset
  • is_multimedia_resource boolean - Whether this resource is considered to be multimedia
  • is_educational_resource boolean - Whether this resource is considered to be educational
  • is_teacher_resource boolean - Whether this resource is considered to be educational
  • credit_line string - Asset-specific copyright information
  • content_e_tag string - Arbitrary unique identifier that changes when the binary file gets updated
  • content_modified_at ISO 8601 date and time - Date and time the associated binary file was updated
  • iiif_url url - IIIF URL of this image
  • width number - Native width of the image
  • height number - Native height of the image
  • lqip text - Low-quality image placeholder (LQIP). Currently a 5x5-constrained, base64-encoded GIF.
  • colorfulness float - Unbounded positive float representing an abstract measure of colorfulness.
  • color object - Dominant color of this image in HSL
  • fingerprint object - Image hashes: aHash, dHash, pHash, wHash
  • artwork_ids array - Unique identifiers of the artworks associated with this asset
  • artwork_titles array - Names of the artworks associated with this asset
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the LAKE LPM Solr index, which is our direct source of data
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Videos

A moving image representation of a collections resource, like an artwork, artist, exhibition, etc. For a description of all the endpoints available for this resource, see here.

  • id keyword - Unique identifier of this resource. Taken from the source system.
  • lake_guid uuid - Unique UUID of this resource in LAKE, our DAMS.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: image, sound, text, video
  • description string - Explanation of what this asset is
  • alt_text string - Alternative text for the asset to describe it to people with low or no vision
  • content string - Text of or URL to the contents of this asset
  • is_multimedia_resource boolean - Whether this resource is considered to be multimedia
  • is_educational_resource boolean - Whether this resource is considered to be educational
  • is_teacher_resource boolean - Whether this resource is considered to be educational
  • credit_line string - Asset-specific copyright information
  • content_e_tag string - Arbitrary unique identifier that changes when the binary file gets updated
  • content_modified_at ISO 8601 date and time - Date and time the associated binary file was updated
  • artwork_ids array - Unique identifiers of the artworks associated with this asset
  • artwork_titles array - Names of the artworks associated with this asset
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the LAKE LPM Solr index, which is our direct source of data
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Sounds

Audio that represents a collections resource, like an artwork, artist, exhibition, etc. For a description of all the endpoints available for this resource, see here.

  • id keyword - Unique identifier of this resource. Taken from the source system.
  • lake_guid uuid - Unique UUID of this resource in LAKE, our DAMS.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: image, sound, text, video
  • description string - Explanation of what this asset is
  • alt_text string - Alternative text for the asset to describe it to people with low or no vision
  • content string - Text of or URL to the contents of this asset
  • is_multimedia_resource boolean - Whether this resource is considered to be multimedia
  • is_educational_resource boolean - Whether this resource is considered to be educational
  • is_teacher_resource boolean - Whether this resource is considered to be educational
  • credit_line string - Asset-specific copyright information
  • content_e_tag string - Arbitrary unique identifier that changes when the binary file gets updated
  • content_modified_at ISO 8601 date and time - Date and time the associated binary file was updated
  • artwork_ids array - Unique identifiers of the artworks associated with this asset
  • artwork_titles array - Names of the artworks associated with this asset
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the LAKE LPM Solr index, which is our direct source of data
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Texts

Text that represents a collections resource, like an artwork, artist, exhibition, etc. For a description of all the endpoints available for this resource, see here.

  • id keyword - Unique identifier of this resource. Taken from the source system.
  • lake_guid uuid - Unique UUID of this resource in LAKE, our DAMS.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - Type always takes one of the following values: image, sound, text, video
  • description string - Explanation of what this asset is
  • alt_text string - Alternative text for the asset to describe it to people with low or no vision
  • content string - Text of or URL to the contents of this asset
  • is_multimedia_resource boolean - Whether this resource is considered to be multimedia
  • is_educational_resource boolean - Whether this resource is considered to be educational
  • is_teacher_resource boolean - Whether this resource is considered to be educational
  • credit_line string - Asset-specific copyright information
  • content_e_tag string - Arbitrary unique identifier that changes when the binary file gets updated
  • content_modified_at ISO 8601 date and time - Date and time the associated binary file was updated
  • artwork_ids array - Unique identifiers of the artworks associated with this asset
  • artwork_titles array - Names of the artworks associated with this asset
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the LAKE LPM Solr index, which is our direct source of data
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Shop

# Products

An item available for purchase in the museum shop. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • external_sku number - Numeric product identification code of a machine-readable barcode, when the customer sku differs from our internal one
  • image_url url - URL of an image for this product
  • web_url url - URL of this product in the shop
  • description string - Explanation of what this product is
  • price_display string - Explanation of what this product is
  • min_compare_at_price number - Number indicating how much the least expensive variant of a product cost before a sale
  • max_compare_at_price number - Number indicating how much the most expensive variant of a product cost before a sale
  • min_current_price number - Number indicating how much the least expensive variant of a product costs right now
  • max_current_price number - Number indicating how much the most expensive variant of a product costs right now
  • artist_ids array - Unique identifiers of the artists associated with this product
  • artwork_ids array - Unique identifiers of the artworks associated with this product
  • exhibition_ids array - Unique identifiers of the exhibitions associated with this product
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Mobile

# Tours

A collection of audio tour stops to form a tour. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • image url - The main image for the tour
  • description string - Explanation of what the tour is
  • intro string - Text introducing the tour
  • weight number - Number representing this tour's sort order
  • intro_link url - Link to the audio file of the introduction
  • intro_transcript string - Transcript of the introduction audio to the tour
  • artwork_titles array - Names of the artworks featured in this tour's tour stops
  • artist_titles array - Names of the artists of the artworks featured in this tour's tour stops
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Mobile Sounds

The audio file for a stop on a tour. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - Name of this mobile audio file – derived from the artwork and tour titles
  • web_url url - URL to the audio file
  • transcript string - Text transcription of the audio file
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Digital Scholarly Catalogs

# Publications

Represents an overall digital publication. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • web_url string - URL to the publication
  • site string - Which site in our multi-site Drupal installation owns this publication
  • alias string - Used by Drupal in lieu of the id to generate pretty paths
  • section_ids array - Unique identifiers of the sections of this publication
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Sections

Represents a chapter of publication. For a description of all the endpoints available for this resource, see here.

  • id long - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • web_url string - URL to the section
  • accession string - An accession number parsed from the title or tombstone
  • revision number - Version identifier as provided by Drupal
  • source_id number - Drupal node id, unique only within the site of this publication
  • weight number - Number representing this section's sort order
  • generic_page_id number - Unique identifier of the page on the website that represents the publication this section belongs to
  • artwork_id number - Unique identifier of the artwork with which this section is associated
  • parent_id number - Uniquer identifier of the parent section
  • publication_title string - Name of the publication this section belongs to
  • publication_id number - Unique identifier of the publication this section belongs to
  • content string - Content of this section in plaintext
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Static Archive

# Sites

An archived static microsite. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • description string - Explanation of what this site is
  • web_url url - URL to this site
  • exhibition_ids array - Unique identifier of the exhibitions this site is associated with
  • exhibition_titles array - Names of the exhibitions this site is associated with
  • artist_ids array - Unique identifiers of the artists this site is associated with
  • artist_titles array - Names of the artists this site is associated with
  • artwork_ids array - Unique identifiers of the artworks this site is associated with
  • artwork_titles array - Names of the artworks this site is associated with
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Website

# Closures

Closure on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • date_start ISO 8601 date and time - The date the closure begins
  • date_end ISO 8601 date and time - The date the closure ends
  • closure_copy string - Description of the closure
  • type number - Number indicating the type of closure
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Web Exhibitions

An enhanced exhibition on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • exhibition_id number - Identifier of the CITI exhibition this website exhibition is tied to
  • is_featured boolean - Is this exhibition currently featured on our website?
  • header_copy string - The text at the top of the exhibition page
  • list_description string - Short description to be used for exhibition listings
  • exhibition_message string - Pricing or attendance information
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Events

An event on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • title_display string - The name of this event formatted with HTML (optional)
  • image_url string - The URL of an image representing this page
  • hero_caption string - Text displayed with the hero image on the event
  • short_description string - Brief description of the event
  • header_description string - Brief description of the event displayed below the title
  • list_description string - One-sentence description of the event displayed in listings
  • description string - All copytext of the event
  • location string - Where the event takes place
  • event_type_id number - Unique identifier indicating the preferred type of this event
  • alt_event_type_ids array - Unique identifiers indicating the alternate types of this event
  • audience_id number - Unique identifier indicating the preferred audience for this event
  • alt_audience_ids array - Unique identifiers indicating the alternate audiences for this event
  • program_ids array - Unique identifiers indicating the programs this event is a part of
  • program_titles array - Titles of the programs this event is a part of
  • is_ticketed boolean - Whether a ticket is required to attend the event
  • rsvp_link url - The URL to the sales site for this event
  • buy_button_text string - The text used on the ticket/registration button
  • buy_button_caption string - Additional text below the ticket/registration button
  • is_registration_required boolean - Whether registration is required to attend the event
  • is_member_exclusive boolean - Whether the event is exclusive to members of the museum
  • is_sold_out boolean - Whether the event is sold out
  • is_free boolean - Whether the event is free
  • is_admission_required boolean - Whether admission to the museum is required to attend this event
  • is_after_hours boolean - Whether the event is to be held after the museum closes
  • is_virtual_event boolean - Whether the event is being held virtually
  • start_date ISO 8601 date and time - The date the event begins
  • end_date ISO 8601 date and time - The date the event ends
  • start_time string - The time the event starts
  • end_time string - The time the event ends
  • date_display string - A readable display of the event dates
  • door_time string - The time the doors open for this event
  • layout_type number - Number indicating the type of layout this event page uses
  • slug string - A string used in the URL for this event
  • entrance string - Which entrance to use for this event
  • join_url string - URL to the membership signup page via this event
  • survey_url string - URL to the survey associated with this event
  • event_host_id number - Unique identifier of the host (cf. event programs) that is presenting this event
  • event_host_title string - Unique identifier of the host (cf. event programs) that is presenting this event
  • sponsor_id number - Unique identifier of the sponsor this website event is tied to
  • search_tags array - Editor-specified list of tags to aid in internal search
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Event Occurrences

An occurrence of an event on the website For a description of all the endpoints available for this resource, see here.

  • id keyword - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • event_id integer - Identifier of the master event of which this is an occurrence
  • short_description string - Brief description of the event
  • description string - Description of the event
  • image_url string - The URL of an image representing this page
  • is_private boolean - Whether the event is private. Private events should be omitted from listings.
  • start_at ISO 8601 date and time - The date the event occurrence begins
  • end_at ISO 8601 date and time - The date the event occurrence ends
  • location string - Where the event takes place
  • button_url url - The URL to the sales site or an RSVP link for this event
  • button_text string - The text used on the ticket/registration button
  • button_caption string - Additional text below the ticket/registration button
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Event Programs

An event on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • is_affiliate_group boolean - Whether this program represents an affiliate group
  • is_event_host boolean - Whether this program represents an event host
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Articles

Article on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • date ISO 8601 date and time - The date the article was published
  • copy string - The text of the article
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Selections

Selections are a grouping of artworks on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • short_copy string - A brief summary of what is contained in the selection
  • copy string - The text of the selection description
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Web Artists

Article on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • has_also_known_as boolean - Whether the artist will display multiple names
  • intro_copy string - Description of the artist
  • agent_id number - Unique identifier of the CITI agent records this artist represents
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Static Pages

Pages defined in the website code. For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • web_url string - The URL to this page on our website
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Generic Pages

A generic page on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • search_tags array - Editor-specified list of tags to aid in internal search
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Press Releases

A press release on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Educator Resources

An educator resource on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Digital Catalogs

A digital catalog on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index

# Printed Catalogs

A printed catalog on the website For a description of all the endpoints available for this resource, see here.

  • id integer - Unique identifier of this resource. Taken from the source system.
  • api_model string - REST API resource type or endpoint
  • api_link string - REST API link for this resource
  • title string - The name of this resource
  • type string - The type of page this record represents
  • web_url string - The URL to this page on our website
  • slug string - A human-readable string used in the URL
  • image_url string - The URL of an image representing this page
  • listing_description string - A brief description of the page used in listings
  • short_description string - A brief description of the page used in mobile and meta tags
  • copy string - The text of the page
  • suggest_autocomplete_boosted object - Internal field to power the /autocomplete endpoint. Do not use directly.
  • suggest_autocomplete_all object - Internal field to power the /autosuggest endpoint. Do not use directly.
  • last_updated_source ISO 8601 date and time - Date and time the resource was updated in the source system
  • last_updated ISO 8601 date and time - Date and time the record was updated in the aggregator database
  • timestamp ISO 8601 date and time - Date and time the record was updated in the aggregator search index