Art Institute of Chicago

Art Institute of Chicago Public API

Open REST and search API surfacing the museum's collection, agents, exhibitions, tours, publications, products and operational data (galleries, hours, sites). Backed by Elasticsearch; data refreshed nightly. Read-only.

Documentation GitHub OpenAPI

Documentation

https://api.artic.edu/docs/

https://api.artic.edu/docs/

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/rate-limits/art-institute-of-chicago-rate-limits.yml

Specifications

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/openapi/art-institute-of-chicago-openapi.yml

https://api.artic.edu/api/v1/openapi.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-ld/art-institute-of-chicago-context.jsonld

Examples

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/examples/art-institute-of-chicago-artworks-list-example.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/examples/art-institute-of-chicago-agents-list-example.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/examples/art-institute-of-chicago-exhibitions-list-example.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/examples/art-institute-of-chicago-galleries-list-example.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/examples/art-institute-of-chicago-places-list-example.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/examples/art-institute-of-chicago-products-list-example.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/examples/art-institute-of-chicago-tours-list-example.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/examples/art-institute-of-chicago-exhibitions-search-example.json

Schemas & Data

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-schema/art-institute-of-chicago-artwork-schema.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-schema/art-institute-of-chicago-agent-schema.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-schema/art-institute-of-chicago-place-schema.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-schema/art-institute-of-chicago-gallery-schema.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-schema/art-institute-of-chicago-exhibition-schema.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-schema/art-institute-of-chicago-product-schema.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-schema/art-institute-of-chicago-tour-schema.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-structure/art-institute-of-chicago-artwork-structure.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-structure/art-institute-of-chicago-agent-structure.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-structure/art-institute-of-chicago-place-structure.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-structure/art-institute-of-chicago-gallery-structure.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-structure/art-institute-of-chicago-exhibition-structure.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-structure/art-institute-of-chicago-product-structure.json

https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/json-structure/art-institute-of-chicago-tour-structure.json

Other Resources

https://creativecommons.org/publicdomain/zero/1.0/

OpenAPI Specification

openapi: 3.1.0
info:
  title: Art Institute of Chicago Public API
  description: 'The Art Institute of Chicago publishes an open, REST + Elasticsearch-style API for ~120,000 artworks plus
    artists/agents, places, galleries, exhibitions, tours, mobile sounds, products, publications, sections, sites, educational
    resources, digital and printed publications, and static archive images. Most data is CC0 1.0; descriptions and places
    are CC-BY 4.0. No API key required. Anonymous limit: 60 requests/minute per IP. Clients should send an AIC-User-Agent
    header (recommended for courtesy tracking).'
  termsOfService: https://www.artic.edu/terms/terms-and-conditions
  contact:
    email: [email protected]
    url: https://api.artic.edu/docs/
  license:
    name: CC0 1.0 (data) / CC-BY 4.0 (descriptions and place data)
    url: https://creativecommons.org/publicdomain/zero/1.0/
  version: '1.14'
servers:
- url: https://api.artic.edu/api/v1
  description: Public API v1
tags:
- name: Agent Roles
  description: Roles agents can play in relation to an artwork.
- name: Agent Types
  description: Classifications of agents (Individual, Corporate, etc.).
- name: Agents
  description: People and organizations (artists, makers, donors) associated with artworks.
- name: Articles
  description: Magazine-style articles published by the museum.
- name: Artists
  description: Convenience alias for agents flagged as artists.
- name: Artwork Date Qualifiers
  description: Date qualifier terms used on artworks.
- name: Artwork Place Qualifiers
  description: Place qualifier terms used on artworks.
- name: Artwork Types
  description: Classification of artwork types (Painting, Sculpture, etc.).
- name: Artworks
  description: Artworks from the Art Institute of Chicago collection (~120,000 records).
- name: Category Terms
  description: Subject, department and style category terms.
- name: Digital Publication Articles
  description: Articles inside digital publications.
- name: Digital Publications
  description: Online scholarly publications and catalogues.
- name: Educator Resources
  description: Lesson plans and resources for educators.
- name: Event Occurrences
  description: Scheduled occurrences of an event.
- name: Event Programs
  description: Recurring program series the events belong to.
- name: Events
  description: Public events at the museum.
- name: Exhibitions
  description: Past, current and upcoming exhibitions.
- name: Galleries
  description: Galleries inside the Art Institute of Chicago museum.
- name: Generic Pages
  description: Generic landing-style pages.
- name: Highlights
  description: Curated highlight items from the collection.
- name: Hours
  description: Museum opening hours.
- name: Images
  description: Image assets (delivered via IIIF for binary data).
- name: Landing Pages
  description: Top-level landing pages of artic.edu.
- name: Mobile Sounds
  description: Audio tour stops and mobile-app sound content.
- name: Places
  description: Geographic places linked to artworks (uses Getty Thesaurus of Geographic Names).
- name: Press Releases
  description: Official press releases from the museum.
- name: Printed Publications
  description: Print catalogues and books.
- name: Products
  description: Items for sale in the museum shop.
- name: Publications
  description: All museum publications (combined index).
- name: Search
  description: Cross-resource Elasticsearch-style search.
- name: Sections
  description: Sections of online publications and catalogues.
- name: Sites
  description: Microsites and online sites published by the museum.
- name: Sounds
  description: Sound assets and metadata.
- name: Static Pages
  description: Static content pages of artic.edu.
- name: Texts
  description: Long-form text content.
- name: Tours
  description: Curated multi-stop museum tours.
- name: Videos
  description: Video assets and metadata.
paths:
  /artworks:
    get:
      tags:
      - Artworks
      operationId: listArtworks
      summary: List Artworks
      description: A list of all artworks sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Artwork'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /artworks/search:
    get:
      tags:
      - Artworks
      operationId: searchArtworks
      summary: Search Artworks
      description: Search artworks data in the aggregator. Artworks in the groups of essentials are boosted so they'll show
        up higher in results.
      parameters:
      - $ref: '#/components/parameters/SearchQ'
      - $ref: '#/components/parameters/SearchQuery'
      - $ref: '#/components/parameters/SearchSort'
      - $ref: '#/components/parameters/SearchFrom'
      - $ref: '#/components/parameters/SearchSize'
      - $ref: '#/components/parameters/SearchFacets'
      - $ref: '#/components/parameters/Fields'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  preference:
                    type:
                    - string
                    - 'null'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchHit'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /artworks/{id}:
    get:
      tags:
      - Artworks
      operationId: getArtwork
      summary: Get Artwork
      description: Retrieve a single artwork by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Artwork'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /agents:
    get:
      tags:
      - Agents
      operationId: listAgents
      summary: List Agents
      description: A list of all agents sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Agent'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /agents/search:
    get:
      tags:
      - Agents
      operationId: searchAgents
      summary: Search Agents
      description: 'Search agents data in the aggregator. '
      parameters:
      - $ref: '#/components/parameters/SearchQ'
      - $ref: '#/components/parameters/SearchQuery'
      - $ref: '#/components/parameters/SearchSort'
      - $ref: '#/components/parameters/SearchFrom'
      - $ref: '#/components/parameters/SearchSize'
      - $ref: '#/components/parameters/SearchFacets'
      - $ref: '#/components/parameters/Fields'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  preference:
                    type:
                    - string
                    - 'null'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchHit'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /agents/{id}:
    get:
      tags:
      - Agents
      operationId: getAgent
      summary: Get Agent
      description: Retrieve a single agent by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Agent'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /artists:
    get:
      tags:
      - Artists
      operationId: listArtists
      summary: List Artists
      description: A list of all artists sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Agent'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /artists/{id}:
    get:
      tags:
      - Artists
      operationId: getArtist
      summary: Get Artist
      description: Retrieve a single artist by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Agent'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /places:
    get:
      tags:
      - Places
      operationId: listPlaces
      summary: List Places
      description: A list of all places sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Place'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /places/search:
    get:
      tags:
      - Places
      operationId: searchPlaces
      summary: Search Places
      description: 'Search places data in the aggregator. '
      parameters:
      - $ref: '#/components/parameters/SearchQ'
      - $ref: '#/components/parameters/SearchQuery'
      - $ref: '#/components/parameters/SearchSort'
      - $ref: '#/components/parameters/SearchFrom'
      - $ref: '#/components/parameters/SearchSize'
      - $ref: '#/components/parameters/SearchFacets'
      - $ref: '#/components/parameters/Fields'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  preference:
                    type:
                    - string
                    - 'null'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchHit'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /places/{id}:
    get:
      tags:
      - Places
      operationId: getPlace
      summary: Get Place
      description: Retrieve a single place by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Place'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /galleries:
    get:
      tags:
      - Galleries
      operationId: listGalleries
      summary: List Galleries
      description: A list of all galleries sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Gallery'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /galleries/search:
    get:
      tags:
      - Galleries
      operationId: searchGalleries
      summary: Search Galleries
      description: 'Search galleries data in the aggregator. '
      parameters:
      - $ref: '#/components/parameters/SearchQ'
      - $ref: '#/components/parameters/SearchQuery'
      - $ref: '#/components/parameters/SearchSort'
      - $ref: '#/components/parameters/SearchFrom'
      - $ref: '#/components/parameters/SearchSize'
      - $ref: '#/components/parameters/SearchFacets'
      - $ref: '#/components/parameters/Fields'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  preference:
                    type:
                    - string
                    - 'null'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchHit'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /galleries/{id}:
    get:
      tags:
      - Galleries
      operationId: getGallery
      summary: Get Gallery
      description: Retrieve a single gallery by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Gallery'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /exhibitions:
    get:
      tags:
      - Exhibitions
      operationId: listExhibitions
      summary: List Exhibitions
      description: A list of all exhibitions sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Exhibition'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /exhibitions/search:
    get:
      tags:
      - Exhibitions
      operationId: searchExhibitions
      summary: Search Exhibitions
      description: 'Search exhibitions data in the aggregator. '
      parameters:
      - $ref: '#/components/parameters/SearchQ'
      - $ref: '#/components/parameters/SearchQuery'
      - $ref: '#/components/parameters/SearchSort'
      - $ref: '#/components/parameters/SearchFrom'
      - $ref: '#/components/parameters/SearchSize'
      - $ref: '#/components/parameters/SearchFacets'
      - $ref: '#/components/parameters/Fields'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  preference:
                    type:
                    - string
                    - 'null'
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/SearchHit'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /exhibitions/{id}:
    get:
      tags:
      - Exhibitions
      operationId: getExhibition
      summary: Get Exhibition
      description: Retrieve a single exhibition by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/Exhibition'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /agent-types:
    get:
      tags:
      - Agent Types
      operationId: listAgentTypes
      summary: List Agent Types
      description: A list of all agent-types sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/GenericResource'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /agent-types/{id}:
    get:
      tags:
      - Agent Types
      operationId: getAgentType
      summary: Get Agent Type
      description: Retrieve a single agent type by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/GenericResource'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /agent-roles:
    get:
      tags:
      - Agent Roles
      operationId: listAgentRoles
      summary: List Agent Roles
      description: A list of all agent-roles sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/GenericResource'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /agent-roles/{id}:
    get:
      tags:
      - Agent Roles
      operationId: getAgentRole
      summary: Get Agent Role
      description: Retrieve a single agent role by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/GenericResource'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /artwork-place-qualifiers:
    get:
      tags:
      - Artwork Place Qualifiers
      operationId: listArtworkPlaceQualifiers
      summary: List Artwork Place Qualifiers
      description: A list of all artwork-place-qualifiers sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/GenericResource'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /artwork-place-qualifiers/{id}:
    get:
      tags:
      - Artwork Place Qualifiers
      operationId: getArtworkPlaceQualifier
      summary: Get Artwork Place Qualifier
      description: Retrieve a single artwork place qualifier by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/GenericResource'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /artwork-date-qualifiers:
    get:
      tags:
      - Artwork Date Qualifiers
      operationId: listArtworkDateQualifiers
      summary: List Artwork Date Qualifiers
      description: A list of all artwork-date-qualifiers sorted by last updated date in descending order.
      parameters:
      - $ref: '#/components/parameters/Ids'
      - $ref: '#/components/parameters/Limit'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/components/parameters/Include'
      responses:
        '200':
          description: Successful response.
          content:
            application/json:
              schema:
                type: object
                properties:
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/GenericResource'
                  info:
                    $ref: '#/components/schemas/Info'
                  config:
                    $ref: '#/components/schemas/Config'
        default:
          description: Error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
  /artwork-date-qualifiers/{id}:
    get:
      tags:
      - Artwork Date Qualifiers
      operationId: getArtworkDateQualifier
      summary: Get Artwork Date Qualifier
      description: Retrieve a single artwork date qualifier by ID.
      parameters:
      - $ref: '#/components/parameters/ResourceId'
      - $ref: '#/components/parameters/Fields'
      - $ref: '#/compon

# --- truncated at 32 KB (146 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/art-institute-of-chicago/refs/heads/main/openapi/art-institute-of-chicago-openapi.yml