<tr>
<td>/objects/dates/{year1}/{year2}</td>
<td>Retrieve objects created between year1 and year2</td>
</tr>
</tbody>
| Endpoint | Description |
|---|---|
| /objects | Index of object links |
| /objects/{id} | Retrieve object with corresponding `id` |
| /objects/on-view | Retrieve objects currently on view |
| /objects/dates | Index of dates |
| /objects/dates/{year} | Retrieve objects create in the given year |
The index endpoint provides a list of links to other object-related endpoints.
Returns all objects currently on view. This will included a number of objects not owned by but loaned to the Solomon R. Guggenheim museum for current exhibitions. Loaned objects must be distinguished from permanent collection objects in any presentation.
| Parameter | Req'd? | Description |
|---|---|---|
| page | OPTIONAL | The page of the paginated objects resource to return (default 1). |
| per_page | OPTIONAL | The maximum number of items on to return on each page (default 20, maximum 100). |
| no_objects | OPTIONAL | If set to any value, return only a count of the total number
of objects. This option overrides
page and per_page. |
Returns an example list of dates endpoints organized by decade.
Request:
curl http://api.guggenheim.org/objects/dates
Response:
{
"_links": {
"_self": {
"href": "http://api.guggenheim.org/objects/dates/"
},
"decades": [
{
"href": "http://api.guggenheim.org/objects/dates/1860/1869/",
"title": "1860s"
},
{
"href": "http://api.guggenheim.org/objects/dates/1870/1879/",
"title": "1870s"
},
...,
{
"href": "http://api.guggenheim.org/objects/dates/2010/2019/",
"title": "2010s"
}
]
}
}
Returns all objects created in the given year. Many objects have a date range (see Dates) and such on object is considered to have been created in a given year that year falls within the range of its start and end dates inclusive.
| Parameter | Req'd? | Description |
|---|---|---|
| page | OPTIONAL | The page of the paginated objects resource to return (default 1). |
| per_page | OPTIONAL | The maximum number of items on to return on each page (default 20, maximum 100). |
| no_objects | OPTIONAL | If set to any value, return only a count of the total number
of objects. This option overrides
page and per_page. |
| sort | OPTIONAL | If set it will allow you to override the default object sort of name to sort via a different method such as date. |
| order | OPTIONAL | If set it will allow you to override the default sort of ASC (ascending)to sort via a different method such as DESC (descending). |
Returns all objects created between the years year1 and year2. Many objects have a date range (see Dates) and such on object is considered to have been created within the given range if either is start date or end date falls within the range inclusive.
| Parameter | Req'd? | Description |
|---|---|---|
| page | OPTIONAL | The page of the paginated objects resource to return (default 1). |
| per_page | OPTIONAL | The maximum number of items on to return on each page (default 20, maximum 100). |
| no_objects | OPTIONAL | If set to any value, return only a count of the total number
of objects. This option overrides
page and per_page. |
| sort | OPTIONAL | If set it will allow you to override the default object sort of name to sort via a different method such as date. |
| order | OPTIONAL | If set it will allow you to override the default sort of ASC (ascending)to sort via a different method such as DESC (descending). |
Objects contain several kinds of resources (Constituents and Movements for
example) that could contain their own paginated object resources. When these resources are contained within an Object, their paginated resource objects will
only have total_count, as if they had been requested with the no_objects
option. See Paginated Objects.
{
"_links": {
"_self": {
"href": "http://api.guggenheim.org/collections/objects/1924"
},
"web": {
"href": "http://www.guggenheim.org/new-york/collections/collection-online/show-full/piece/?&search=&f=Title&object=37.262"
}
},
"id": 1924,
"accession": "37.262",
"acquisition": {
"_links": {
"_self": {
"href": "http://api.guggenheim.org/collections/acquisitions/6"
}
},
"id": 6,
"name": "Solomon R. Guggenheim Founding Collection",
"objects": {
"total_count": 55
}
},
"constituents": [
{
"constituent": {
"_links": {
"_self": {
"href": "http://api.guggenheim.org/collections/constituents/1515"
}
},
"dates": {
"begin": 1866,
"display": "b. 1866, Moscow, Russia; d. 1944, Neuilly-sur-Seine, France",
"end": 1944
},
"display": "Vasily Kandinsky",
"firstname": "Vasily",
"id": 1515,
"lastname": "Kandinsky",
"middlename": null,
"nationality": "Russian",
"objects": {
"total_count": 17
},
"sort": "Kandinsky, Vasily",
"suffix": null
},
"order": 1,
"role": "Artist"
}
],
"copyright": "\u00a9 2012 Artists Rights Society (ARS), New York/ADAGP, Paris",
"credit": "Solomon R. Guggenheim Museum, New York\r\nSolomon R. Guggenheim Founding Collection, By gift",
"dates": {
"begin": 1923,
"display": "July 1923",
"end": 1923
},
"dimensions": "55 1/8 \u00d7 79 1/8 inches (140 \u00d7 201 cm)",
"edition": null,
"essay": "<p>When Kandinsky returned to his native Moscow after the outbreak of World War I, his expressive abstract style underwent changes that reflected the utopian artistic experiments of the Russian avant-garde. The emphasis on geometric forms, promoted by artists such as Kazimir Malevich, Aleksandr Rodchenko, and Liubov Popova in an effort to establish a universal aesthetic language, inspired Kandinsky to expand his own pictorial vocabulary. Although he adopted some aspects of the geometrizing trends of Suprematism and Constructivism—such as overlapping flat planes and clearly delineated shapes—his belief in the expressive content of abstract forms alienated him from the majority of his Russian colleagues, who championed more rational, systematizing principles. This conflict led him to return to Germany in 1921. <i>In the Black Square</i>, executed two years later, epitomizes Kandinsky\u2019s synthesis of Russian avant-garde art and his own lyrical abstraction: the white trapezoid recalls Malevich\u2019s Suprematist paintings, but the dynamic compositional elements, resembling clouds, mountains, sun, and a rainbow, still refer to the landscape.</p><p>In 1922 Kandinsky joined the faculty of the Weimar Bauhaus, where he discovered a more sympathetic environment in which to pursue his art. Originally premised on a Germanic, expressionistic approach to artmaking, the Bauhaus aesthetic came to reflect Constructivist concerns and styles, which by the mid-1920s had become international in scope. While there, Kandinsky furthered his investigations into the correspondence between colors and forms and their psychological and spiritual effects. In <i>Composition 8</i>, the colorful, interactive geometric forms create a pulsating surface that is alternately dynamic and calm, aggressive and quiet. The importance of circles in this painting prefigures the dominant role they would play in many subsequent works, culminating in his cosmic and harmonious image <i>Several Circles</i>. \u201cThe circle,\u201d claimed Kandinsky, \u201cis the synthesis of the greatest oppositions. It combines the concentric and the eccentric in a single form and in equilibrium. Of the three primary forms, it points most clearly to the fourth dimension.\u201d</p><p>Nancy Spector",
"exhibitions": null,
"location": null,
"media": [
{
"assets": {
"full": {
"_links": {
"_self": {
"href": null
}
},
"height": 401,
"width": 573
}
},
"format": "JPEG",
"orientation": "landscape",
"type": "Image"
}
],
"medium": "Oil on canvas",
"movements": [
{
"_links": {
"_self": {
"href": "http://api.guggenheim.org/collections/movements/195207"
}
},
"id": 195207,
"name": "Bauhaus",
"objects": {
"total_count": 17
}
}
],
"series": null,
"sites": [
{
"_links": {
"_self": {
"href": "http://api.guggenheim.org/collections/sites/3"
}
},
"id": 3,
"location": "New York",
"name": "Solomon R. Guggenheim Museum",
"objects": {
"total_count": 834
}
}
],
"sort_name": "Kandinsky, Vasily",
"sort_number": " 37 262",
"sort_title": "Composition 8",
"titles": {
"other": [
{
"append": null,
"language": "de",
"order": 2,
"prepend": null,
"title": "Komposition 8",
"type": "Original Title"
}
],
"primary": {
"append": null,
"language": "en",
"order": 1,
"prepend": null,
"title": "Composition 8",
"type": "Translation"
}
}
}
| Field | Type | Description |
|---|---|---|
| id | number | Unique ID number for the object |
| accession | string | Guggenheim catalogue number for the object |
| sort_number | string | Sortable representation of the ```accession``` property |
| sort_name | string | Sortable representation of the name of the artist under which the object should be alphabetized |
| sort_title | string | Sortable representation of the title of the work under which the object should be alphabetized |
| constituents | array | An array Role object |
| titles | object | A Titles object |
| series | object | A Title object or null |
| dates | object | A Dates object representing the date or date range of the object's creation |
| location | string | Location in museum if on display (may be null). |
| exhibitions | array | An array of Exhibitions objects. Exhibitions in which the object was included (may be null) |
| sites | array | An array of Site objects |
| movements | array | An array of Movement objects |
| acquisition | object | An Acquisition object (may be null) |
| edition | string | The object's edition, e.g. "edition 3/9" |
| medium | string | The object's medium |
| dimensions | string | The object's dimensions |
| credit | string | Credit line for object |
| copyright | string | Copyright statement |
| essay | string | Curator's essay on the object. Essays contain HTML markup and should be treated
accordingly. May be nil |
| media | array | An array of media objects |
A Role object represents a Constituent and its connection to the Object.
{
"order": 1,
"role": "Artist",
"constituent": {
"id": 1515,
"firstname": "Vasily",
"middlename": null,
"lastname": "Kandinsky",
"suffix": null,
"display": "Vasily Kandinsky",
"sort": "Kandinsky, Vasily",
"dates": {
"begin": 1866,
"display": "b. 1866, Moscow, Russia; d. 1944, Neuilly-sur-Seine, France",
"end": 1944
},
"nationality": "Russian",
"objects": {
"total_count": 17
},
"_links": {
"_self": {
"href": "http://api.guggenheim.org/constituents/1515"
}
}
}
}
| Field | Type | Req'd? | Description |
|---|---|---|---|
| order | number | REQUIRED | The ranking of the constituent among all the constituents of the object |
| role | string | REQUIRED | The role the constituent played in the creation of the object e.g. "Artist", "Collaborator" |
| constituent | object | REQUIRED | The Constituent object |
The Titles object contains the list of multiple titles, each one a
Title by which the artwork is known. The preferred title is
given in the REQUIRED primary property. The OPTIONAL other property,
if present, will contain a list of other titles -- translations (or an original
title if the primary is a translation), alternates, etc.
"titles": {
"primary": {
"title": "Composition 8",
"language": "en",
"order": 1,
"type": "Translation"
"prepend": null,
"append": null
},
"other": [
{
"title": "Komposition 8",
"language": "de",
"order": 2,
"type": "Original Title"
"prepend": null,
"append": null
}
]
}
| Field | Type | Req'd? | Description |
|---|---|---|---|
| primary | object | REQUIRED | A title object. The preferred title for the object |
| other | array | OPTIONAL | An array of alternate title objects. |
{
"title": "Composition 8",
"language": "en",
"order": 1,
"type": "Translation"
"prepend": null,
"append": null
}
| Field | Type | Req'd? | Description |
|---|---|---|---|
| title | string | REQUIRED | The title |
| language | string | REQUIRED | The ISO 639-1 code of the language of the title. May be
null |
| order | number | REQUIRED | The title's ranking by preference among *all the titles* in the
Titles object. |
| type | string | REQUIRED | The type of title. Examples: "Title", "Original Title", "Translation" |
| prepend | string | REQUIRED | Phrase to be prepended to the title when it is displayed, may be null |
| append | string | REQUIRED | Phrase to be appended to the title when it is displayed, may be null |
Titles (currently only series titles) may need to have some additional phrasing, e.g. the series title
"Beaches" may need to be displayed as "from the Beaches series." The prepend and
append indicate what needs to be added before and after the title, respectively. When the title is italicized,
prepend and append are not.