Spencer Museum of Art API 2.0 Documentation

Exhibition Search

URL

https://sma-search-api.ku.edu/search-online/exhibition/{searchTerm}

Method

GET

Path Parameters

Parameter Type Description
searchTerm string The term to search for.

Response

200 OK

Description

Returns the search results for the specified exhibition term.

Example Response
{
                "id": 53,
                "ExhBeginDateDat": {
                    "date": "1968-03-01 00:00:00.000000",
                    "timezone_type": 3,
                    "timezone": "America/Chicago"
                },
                "ExhEndDateDat": {
                    "date": "2024-05-15 00:00:00.000000",
                    "timezone_type": 3,
                    "timezone": "America/Chicago"
                },
                "ExhTitleTxt": "Paintings and Drawings by Albert Newbill (Recent Work by Albert Newbill)",
                "ExhVenueDetailsTxt": "University of Kansas Museum of Art, Lawrence, Kansas",
                "ExhDescriptionClb": "The art of the 1967-1968 Visiting Professor of Drawing and Painting at the University of Kansas",
                "ExhDateTxt": "1968",
                "ExhTypeVoc": "InternalExh",
                "ExhRecordTypeVoc": "Single exhibition",
                "ExhExhibitionVrt": "Paintings and Drawings by Albert Newbill (Recent Work by Albert Newbill), 03/01/1968",
                "ExhCurrentStatusVrt": "null"
            }

Fields

Exhibition Object

Field Type Description
id int The ID of the exhibition.
ExhBeginDateDat object The begin date of the exhibition.
ExhBeginDateDat.date string The date in "YYYY-MM-DD HH:MM:SS.ffffff" format.
ExhBeginDateDat.timezone_type int The timezone type.
ExhBeginDateDat.timezone string The timezone.
ExhEndDateDat object The end date of the exhibition.
ExhEndDateDat.date string The date in "YYYY-MM-DD HH:MM:SS.ffffff" format.
ExhEndDateDat.timezone_type int The timezone type.
ExhEndDateDat.timezone string The timezone.
ExhTitleTxt string The title of the exhibition.
ExhVenueDetailsTxt string The venue details of the exhibition.
ExhDescriptionClb string The description of the exhibition.
ExhDateTxt string The exhibition date text.
ExhTypeVoc string The type of exhibition.
ExhRecordTypeVoc string The record type of exhibition.
ExhExhibitionVrt string The exhibition details in "Title, BeginDate" format.
ExhCurrentStatusVrt string The current status of the exhibition.

Literature Search

URL

https://sma-search-api.ku.edu/search-online/literature/{searchTerm}

Method

GET

Response

200 OK

Description

Returns the literature details.

Example Response
{
                "id": 511,
                "LitCitationClb": "Bloch, Albert. Albert Bloch: A Retrospective exhibition of his work from 1911 to 1955. Lawrence, Kansas: The University of Kansas Museum of Art, 1955.",
                "LitPublicationDateLnu": null,
                "LitNoVolumeTxt": "",
                "LitPagesTxt": "",
                "LitPublicationPlaceTxt": "Lawrence, Kansas",
                "LitPublisherTxt": "The University of Kansas Museum of Art",
                "LitTitleClb": "Albert Bloch: A Retrospective exhibition of his work from 1911 to 1955",
                "LitTomeVolumeTxt": "Publ. Series: Miscellaneous Publications of the Museum of Art, No. 16",
                "LitWayOfCitationVoc": "Book by One Author",
                "LitTypeVoc": "Exhibition Catalog",
                "LitLiteratureVrt": "Albert Bloch: A Retrospective exhibition of his work from 1911 to 1955, Author: Bloch, Albert; Lawrence, Kansas"
            }

Fields

Literature Object

Field Type Description
id int The ID of the literature.
LitCitationClb string The citation of the literature.
LitPublicationDateLnu null The publication date of the literature.
LitNoVolumeTxt string The volume number of the literature.
LitPagesTxt string The pages of the literature.
LitPublicationPlaceTxt string The publication place of the literature.
LitPublisherTxt string The publisher of the literature.
LitTitleClb string The title of the literature.
LitTomeVolumeTxt string The tome volume of the literature.
LitWayOfCitationVoc string The way of citation of the literature.
LitTypeVoc string The type of the literature.
LitLiteratureVrt string The literature reference text.

Objects Search

URL

https://sma-search-api.ku.edu/search-online/{searchTerm}

Method

GET

Path Parameters

Parameter Type Description
searchTerm string The term to search for.

Response

200 OK

Description

Returns the search results for the specified term.

Example Response
{
            {
                "id": 9014,
                "url": "https://sma-search-api.ku.edu/image/1949.0010.01.jpg",
                "ObjObjectTitleVrt": "Album of Landscapes - 12 leaves",
                "ObjDateMainVrt": "mid 1700s, Qing dynasty (1644–1911)",
                "ObjCreditLineTxt": "Gift of Mrs. Alice Dains",
                "ObjSpencerTypeVoc": "Asian paintings",
                "ObjMaterialTechniqueVrt": "ink; silk; color",
                "ToDate": "1970",
                "FromDate": "1970",
                "ObjPerAssociationVrt": "Ilya Bolotowsky (1907–1981)"
                "ObjGeograficVrt": " -> United States;  -> North and Central America",
                "Country": "United States",
                "Continent": "North and Central America"
            }
        
            }

Fields

Result Object

Field Type Description
id int The ID of the search result item.
url string The URL to the image of the item.
ObjObjectTitleVrt string The title of the object.
ObjDateMainVrt string The main date associated with the object.
ObjCreditLineTxt string The credit line for the object.
ObjSpencerTypeVoc string The type of object according to the Spencer Museum's classification.
ObjMaterialTechniqueVrt string The materials and techniques used in the object.
ToDate string Begin date the object.
FromDate string End date the object.
ObjPerAssociationVrt string The person(s) associated with the object in the object.
ObjGeograficVrt string Object Geographic location
Country string Object Geographic Country
Continent string Object Geographic Continent

Person Search

URL

https://sma-search-api.ku.edu/search-online/person/{searchTerm}

Method

GET

Path Parameters

Parameter Type Description
searchTerm string The term to search for.

Response

200 OK

Description

Returns the search results for the specified person term.

Example Response
{
                "id": 16089,
                "PerNameVrt": "Bloch, Albert",
                "PerDateOfBirth": "2–Aug–1882",
                "PerDateOfDeath": "9–Dec–1961",
                "PerPlaceOfBirth": "Saint Louis, Missouri, United States",
                "PerPlaceOfDeath": "Lawrence, Kansas, United States",
                "PerActiveCountry": "United States"
            }

Fields

Person Object

Field Type Description
id int The ID of the person.
PerNameVrt string The name of the person.
PerDateOfBirth string The date of birth of the person.
PerDateOfDeath string The date of death of the person.
PerPlaceOfBirth string The place of birth of the person.
PerPlaceOfDeath string The place of death of the person.
PerActiveCountry string The country where the person was active.

Event

URL

https://sma-search-api.ku.edu/event

Method

GET

Response

200 OK

Description

Returns the event details.

Example Response
{
                "id": 15947,
                "type": "Grant",
                "audience": "",
                "seriesTitle": "",
                "title": "Institute of Museum and Library Services",
                "location": "Lawrence, Kansas",
                "specificLocation": "",
                "startDate": {
                    "date": "2023-09-01 00:00:00.000000",
                    "timezone_type": 3,
                    "timezone": "America/Chicago"
                },
                "endDate": {
                    "date": "2025-05-31 00:00:00.000000",
                    "timezone_type": 3,
                    "timezone": "America/Chicago"
                },
                "startTime": "",
                "endTime": "",
                "host": "",
                "description": "The Spencer Museum of Art respectfully requests $250,000 from IMLS to support the...",
                "lastUpdated": {
                    "date": "2024-02-03 23:56:48.000000",
                    "timezone_type": 3,
                    "timezone": "America/Chicago"
                }
            }

Fields

Event Object

Field Type Description
id int The ID of the event.
type string The type of the event.
audience string The intended audience for the event.
seriesTitle string The series title of the event.
title string The title of the event.
location string The location of the event.
specificLocation string The specific location of the event.
startDate object The start date of the event.
endDate object The end date of the event.
startTime string The start time of the event.
endTime string The end time of the event.
host string The host of the event.
description string The description of the event.
lastUpdated object The date and time the event was last updated.

Date Object

Field Type Description
date string The date in "YYYY-MM-DD HH:MM:SS.UUUUUU" format.
timezone_type int The type of timezone.
timezone string The timezone.

Get Exhibition Details

URL

https://sma-search-api.ku.edu/exhibition/{id}

Method

GET

Path Parameters

Parameter Type Description
id int The ID of the exhibition.

Response

200 OK

Description

Returns the details of the specified exhibition along with its associated events.

Example Response
{
                    "exhibition": {
                        "id": 2,
                        "ExhBeginDateDat": {
                            "date": "2002-02-23 00:00:00.000000",
                            "timezone_type": 3,
                            "timezone": "America/Chicago"
                        },
                        "ExhEndDateDat": {
                            "date": "2024-05-15 00:00:00.000000",
                            "timezone_type": 3,
                            "timezone": "America/Chicago"
                        },
                        "ExhTitleTxt": "Contemporary Ceramics East and West",
                        "ExhVenueDetailsTxt": "South Balcony, Spencer Museum of Art, University of Kansas, Lawrence, Kansas",
                        "ExhDescriptionClb": "A selection of contemporary Asian, European and American ceramics",
                        "ExhDateTxt": "2002",
                        "ExhTypeVoc": "InternalExh",
                        "ExhRecordTypeVoc": "Single exhibition",
                        "ExhExhibitionVrt": "Contemporary Ceramics East and West, 02/23/2002 - 06/30/2002",
                        "ExhCurrentStatusVrt": "null",
                        "__lastModified": {
                            "date": "2024-02-04 00:25:45.000000",
                            "timezone_type": 3,
                            "timezone": "America/Chicago"
                        }
                    },
                    "events": [
                        {
                            "id": 1001,
                            "type": "Talk",
                            "audience": "General",
                            "seriesTitle": "Art Talks",
                            "title": "Exploring Ceramics with Dr. Jane Smith",
                            "location": "Spencer Museum of Art",
                            "specificLocation": "Room 101",
                            "startDate": {
                                "date": "2022-03-15 14:00:00.000000",
                                "timezone_type": 3,
                                "timezone": "America/Chicago"
                            },
                            "endDate": {
                                "date": "2022-03-15 15:00:00.000000",
                                "timezone_type": 3,
                                "timezone": "America/Chicago"
                            },
                            "startTime": "14:00:00",
                            "endTime": "15:00:00",
                            "host": "Dr. Jane Smith",
                            "description": "A deep dive into the history and techniques of contemporary ceramics.",
                            "lastUpdated": {
                                "date": "2024-02-01 10:00:00.000000",
                                "timezone_type": 3,
                                "timezone": "America/Chicago"
                            }
                        },
                        {
                            "id": 1002,
                            "type": "Workshop",
                            "audience": "Students",
                            "seriesTitle": "Ceramics Workshops",
                            "title": "Hands-On Ceramics",
                            "location": "Spencer Museum of Art",
                            "specificLocation": "Workshop Room",
                            "startDate": {
                                "date": "2022-04-01 10:00:00.000000",
                                "timezone_type": 3,
                                "timezone": "America/Chicago"
                            },
                            "endDate": {
                                "date": "2022-04-01 12:00:00.000000",
                                "timezone_type": 3,
                                "timezone": "America/Chicago"
                            },
                            "startTime": "10:00:00",
                            "endTime": "12:00:00",
                            "host": "John Doe",
                            "description": "A practical workshop on creating ceramic art pieces.",
                            "lastUpdated": {
                                "date": "2024-02-01 10:30:00.000000",
                                "timezone_type": 3,
                                "timezone": "America/Chicago"
                            }
                        }
                    ]
                }

Fields

Exhibition Object

Field Type Description
id int The ID of the exhibition.
ExhBeginDateDat object The start date of the exhibition.
ExhBeginDateDat.date string The start date in the format "YYYY-MM-DD HH:MM:SS.ffffff".
ExhBeginDateDat.timezone_type int The type of timezone.
ExhBeginDateDat.timezone string The timezone identifier.
ExhEndDateDat object The end date of the exhibition.
ExhEndDateDat.date string The end date in the format "YYYY-MM-DD HH:MM:SS.ffffff".
ExhEndDateDat.timezone_type int The type of timezone.
ExhEndDateDat.timezone string The timezone identifier.
ExhTitleTxt string The title of the exhibition.
ExhVenueDetailsTxt string The venue details of the exhibition.
ExhDescriptionClb string The description of the exhibition.
ExhDateTxt string The year

Get Person Details

URL

https://sma-search-api.ku.edu/person/{id}

Method

GET

Path Parameters

Parameters

Name Type Required Description
id Integer Yes The unique identifier of the person

Response

The response is returned in JSON format and includes information about the person and associated objects.

Response Fields

Person

Field Type Description
id Integer The unique identifier of the person
PerNameVrt String The name of the person
PerCulturalAffiliationClb String The cultural affiliation of the person
PerActiveDates String The active dates of the person
PerDateOfBirth String The date of birth of the person
PerDateOfDeath String The date of death of the person
PerPlaceOfBirth String The place of birth of the person
PerPlaceOfDeath String The place of death of the person
PerActiveCountry String The country where the person was active

Objects

Field Type Description
id Integer The unique identifier of the object
ObjObjectTitleVrt String The title of the object
ObjDateMainVrt String The main date of the object
ObjCreditLineTxt String The credit line of the object
ObjMaterialTechniqueVrt String The material or technique of the object
ObjObjectNumberVrt String The object number
ObjSpencerTypeVoc String The type of object

Exhibition

Field Type Description
id int The ID of the exhibition.
ExhBeginDateDat object The start date of the exhibition.
ExhBeginDateDat.date string The start date in the format "YYYY-MM-DD HH:MM:SS.ffffff".
ExhBeginDateDat.timezone_type int The type of timezone.
ExhBeginDateDat.timezone string The timezone identifier.
ExhEndDateDat object The end date of the exhibition.
ExhEndDateDat.date string The end date in the format "YYYY-MM-DD HH:MM:SS.ffffff".
ExhEndDateDat.timezone_type int The type of timezone.
ExhEndDateDat.timezone string The timezone identifier.
ExhTitleTxt string The title of the exhibition.
ExhVenueDetailsTxt string The venue details of the exhibition.
ExhDescriptionClb string The description of the exhibition.
ExhDateTxt string The year

Example Request

GET https://sma-search-api.ku.edu/person/15396

Example Response

{
    "person": {
        "id": 15396,
        "PerNameVrt": "Abbott, Berenice",
        "PerCulturalAffiliationClb": "",
        "PerActiveDates": "",
        "PerDateOfBirth": "17–Jul–1898",
        "PerDateOfDeath": "9–Dec–1991",
        "PerPlaceOfBirth": "Springfield, Ohio, United States",
        "PerPlaceOfDeath": "Monson, Maine, United States",
        "PerActiveCountry": "United States"
    },
    "objects": [
        {
            "id": 166,
            "ObjObjectTitleVrt": "Shelter on the Waterfront",
            "ObjDateMainVrt": "1938",
            "ObjCreditLineTxt": "Gift of the WPA Arts Project",
            "ObjMaterialTechniqueVrt": "gelatin silver print",
            "ObjObjectNumberVrt": "0000.0106",
            "ObjSpencerTypeVoc": "photographs"
            "ObjPerAssociationVrt": "Berenice Abbott (1898–1991)",
            "DateFromTxt": "",
            "DateToTxt": "",
            "ObjPublicDomain": false,
            "ObjGeograficVrt": " -> United States;  -> North and Central America"
        },
        {
            "id": 170,
            "ObjObjectTitleVrt": "Hanover Square",
            "ObjDateMainVrt": "1936",
            "ObjCreditLineTxt": "Gift of the WPA Arts Project",
            "ObjMaterialTechniqueVrt": "gelatin silver print",
            "ObjObjectNumberVrt": "0000.0110",
            "ObjSpencerTypeVoc": "photographs"
            "ObjPerAssociationVrt": "Berenice Abbott (1898–1991)",
            "DateFromTxt": "",
            "DateToTxt": "",
            "ObjPublicDomain": false,
            "ObjGeograficVrt": " -> United States;  -> North and Central America"
        }
    ],
    "exhibitions": [
        {
            "id": 307,
            "ExhBeginDateDat": {
                "date": "2007-09-28 00:00:00.000000",
                "timezone_type": 3,
                "timezone": "America/Chicago"
            },
            "ExhEndDateDat": {
                "date": "2024-06-06 00:00:00.000000",
                "timezone_type": 3,
                "timezone": "America/Chicago"
            },
            "ExhTitleTxt": "A New York Picture Post: Gotham in the 20th Century",
            "ExhVenueDetailsTxt": "Spencer Museum of Art, University of Kansas, Lawrence, Kansas",
            "ExhDescriptionClb": "Each man reads his own meaning into New York - famed New York reporter, Meyer Berger...",
            "ExhDateTxt": "2007",
            "ExhTypeVoc": "InternalExh",
            "ExhRecordTypeVoc": "Single exhibition",
            "ExhExhibitionVrt": "A New York Picture Post: Gotham in the 20th Century, 09/28/2007 - 12/08/2007",
            "ExhCurrentStatusVrt": "null",
            "__lastModified": {
                "date": "2024-02-04 00:25:26.000000",
                "timezone_type": 3,
                "timezone": "America/Chicago"
            },
            "ExhStdImg": "https://sma-search-api.ku.edu/image/exhib/307",
            "ExhCuratedBy": [ ]
        },
        {
            "id": 57,
            "ExhBeginDateDat": {
                "date": "2005-01-22 00:00:00.000000",
                "timezone_type": 3,
                "timezone": "America/Chicago"
            },
            "ExhEndDateDat": {
                "date": "2024-06-06 00:00:00.000000",
                "timezone_type": 3,
                "timezone": "America/Chicago"
            },
            "ExhTitleTxt": "Daguerreotype to Digital: Photographs from the Collection",
            "ExhVenueDetailsTxt": "North Balcony and Study Gallery, Spencer Museum of Art, University of Kansas, Lawrence, Kansas",
            "ExhDescriptionClb": "This exhibition surveys the history of photography from the 1840s to the present...",
            "ExhDateTxt": "2005",
            "ExhTypeVoc": "InternalExh",
            "ExhRecordTypeVoc": "Single exhibition",
            "ExhExhibitionVrt": "Daguerreotype to Digital: Photographs from the Collection, 01/22/2005 - 07/31/2005",
            "ExhCurrentStatusVrt": "null",
            "__lastModified": {
                "date": "2024-02-04 00:25:49.000000",
                "timezone_type": 3,
                "timezone": "America/Chicago"
            },
            "ExhStdImg": "https://sma-search-api.ku.edu/image/exhib/307",
            "ExhCuratedBy": [ ]
        }
    ]
}

Get Object Details

URL

https://sma-search-api.ku.edu/objects/{id}

Method

GET

Path Parameters

Name Type Required Description
id Integer Yes The unique identifier of the object

Response

The response is returned in JSON format and includes detailed information about the object.

Response Fields

Field Type Description
id Integer The unique identifier of the object
url String The URL of the object's image
ObjPerAssociationVrt String The association of persons related to the object
ObjObjectNumberVrt String The object's number
ObjObjectTitleVrt String The title of the object
ObjDateMainVrt String The main date associated with the object
ObjCreditLineTxt String The credit line of the object
ObjSpencerTypeVoc String The type of the object according to Spencer classification
ObjMaterialTechniqueVrt String The material and technique used for the object
ObjOnDisplayLocationVrt String The display location of the object (if available)
ObjPublicDomain Boolen Is in the public domain (used to determin image size)
ObjGeograficVrt string Object Geographic location
Country string Object Geographic Country
Continent string Object Geographic Continent
Continent string Object Geographic Continent
Labels Array An array of labels including an array called RegDidacticLabelClb
Dimensions Array An array of dimension objects
Person Array An array of arrays of person objects
Literature Array An array of literature references
Exhibitions Array An array of arrays of exhibition objects
Multimedia Array An array of arrays of multimedia objects

Example Request

GET https://sma-search-api.ku.edu/objects/55340

Example Response

[
    {
        "id": 55340,
        "url": "https://sma-search-api.ku.edu/image/full/2016.0024.07.jpg",
        "ObjPerAssociationVrt": "Christopher T. Creyts; Matthew Day Jackson (born 1974); Collaborative Art Editions",
        "ObjObjectNumberVrt": "2016.0024.07",
        "ObjObjectTitleVrt": "Whistling their whims on a low fence-wire",
        "ObjDateMainVrt": "2015–2016",
        "ObjCreditLineTxt": "Museum purchase: Peter T. Bohan Art Acquisition Fund",
        "ObjSpencerTypeVoc": "prints",
        "ObjMaterialTechniqueVrt": "color intaglio",
        "ObjOnDisplayLocationVrt": "Not on display",
        "ObjPublicDomain": false,
        "ObjGeograficVrt": " -> United States;  -> North and Central America",
        "Country": "United States",
        "Continent": "North and Central America"
        Labels: [
            {
            TextClb: ""
            },
            RegDidacticLabelClb: [
                [
                    {
                    id: 52995,
                    label: "birds known for their noisy chatter and aggressive behavior, but also their intelligence and curiosity.",
                    ExhTitleTxt: "Audubon in the Anthropocene: Works by Matthew Day Jackson"
                    },
                    {
                    id: 64099,
                    label: "birds known for their noisy chatter and aggressive behavior, but also their intelligence and curiosity.",
                    ExhTitleTxt: "Audubon in the Anthropocene: Works by Matthew Day Jackson"
                    }
                ]
            ]
        ],
        "Dimensions": [
            {
                "id": 257742,
                "SortLnu": "1",
                "PreviewTxt": "493 x 398 mm",
                "UnitDdiVoc": "mm",
                "HeightNum": 493,
                "WidthNum": 398,
                "LengthNum": null,
                "DepthNum": null,
                "DiameterNum": null,
                "WidthInchNum": null,
                "LengthInchNum": null,
                "HeightInchNum": null,
                "DepthInchNum": null,                
                "DiameterInchNum": null,
                "PrefixTxt": null,
                "TypeDimRef": "Image Dimensions Height/Width (Height x Width)"
            },
            {
                "id": 257743,
                "SortLnu": "2",
                "PreviewTxt": null,
                "UnitDdiVoc": "cm",
                "HeightNum": null,
                "WidthNum": null,
                "LengthNum": null,
                "DepthNum": null,
                "DiameterNum": null,
                "WidthInchNum": "15.6693",
                "LengthInchNum": null,
                "HeightInchNum": "19.4094",
                "DepthInchNum": null,
                "DiameterInchNum": null,
                "PrefixTxt": null,
                "TypeDimRef": "Image Dimensions Height/Width (Height x Width)"
            }
        ],
        "Person": [
            [
                {
                    "id": 26306,
                    "PerNameVrt": "Jackson, Matthew Day",
                    "PerCulturalAffiliationClb": "",
                    "PerActiveDates": "born 1974",
                    "PerDateOfBirth": null,
                    "PerDateOfDeath": null,
                    "PerPlaceOfBirth": "Panorama City, California, United States",
                    "PerPlaceOfDeath": null,
                    "PerActiveCountry": null,
                    "role": "artist"
                }
            ],
            [
                {
                    "id": 27371,
                    "PerNameVrt": "",
                    "PerCulturalAffiliationClb": "",
                    "PerActiveDates": null,
                    "PerDateOfBirth": null,
                    "PerDateOfDeath": null,
                    "PerPlaceOfBirth": null,
                    "PerPlaceOfDeath": null,
                    "PerActiveCountry": null,
                    "role": "publisher"
                }
            ],
            [
                {
                    "id": 27372,
                    "PerNameVrt": "Creyts, Christopher T.",
                    "PerCulturalAffiliationClb": "",
                    "PerActiveDates": null,
                    "PerDateOfBirth": null,
                    "PerDateOfDeath": null,
                    "PerPlaceOfBirth": null,
                    "PerPlaceOfDeath": null,
                    "PerActiveCountry": null,
                    "role": "printer"
                }
            ]
        ],
        "Literature": [
            [
                {
                "id": 679,
                "LitCitationClb": "Goddard, Stephen, ed. Teaching from Prints: The Legacy of John Talleur. Lawrence, Kansas: Spencer Museum of Art, The University of Kansas, 2003.",
                "LitPublicationDateLnu": null,
                "LitNoVolumeTxt": "",
                "LitPagesTxt": "",
                "LitPublicationPlaceTxt": "Lawrence, Kansas",
                "LitPublisherTxt": "Spencer Museum of Art, The University of Kansas",
                "LitTitleClb": "Teaching from Prints: The Legacy of John Talleur",
                "LitTomeVolumeTxt": "",
                "LitWayOfCitationVoc": "Book with Editor, no Author",
                "LitTypeVoc": "Exhibition Catalog with Editor",
                "LitLiteratureVrt": "Teaching from Prints: The Legacy of John Talleur, Author: Goddard, Stephen; Lawrence, Kansas",
                "LitObjectRefTxt": "",
                "LitPersonRefTxt": ""
                }
            ]
        ],
        "Exhibitions": [
            [
                {
                    "id": 3264,
                    "ExhBeginDateDat": {
                        "date": "2020-03-21 00:00:00.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "ExhEndDateDat": {
                        "date": "2024-07-31 00:00:00.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "ExhTitleTxt": "Audubon in the Anthropocene: Works by Matthew Day Jackson",
                    "ExhVenueDetailsTxt": "Gallery 404, Spencer Museum of Art, University of Kansas, Lawrence, Kansas",
                    "ExhDescriptionClb": "This exhibition features a portfolio of prints by ...",
                    "ExhDateTxt": "2020",
                    "ExhTypeVoc": "InternalExh",
                    "ExhRecordTypeVoc": "Single exhibition",
                    "ExhExhibitionVrt": "Audubon in the Anthropocene: Works by Matthew Day Jackson, 03/21/2020 - 11/24/2020",
                    "ExhCurrentStatusVrt": "null",
                    "__lastModified": {
                        "date": "2024-02-04 00:25:36.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "ExhStdImg": "https://sma-search-api.ku.edu/image/exhib/3264",
                    "ExhCuratedBy": []
                }
            ],
            [
                {
                    "id": 3323,
                    "ExhBeginDateDat": {
                        "date": "2020-05-04 00:00:00.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "ExhEndDateDat": {
                        "date": "2024-07-31 00:00:00.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "ExhTitleTxt": "Audubon in the Anthropocene: Works by Matthew Day Jackson",
                    "ExhVenueDetailsTxt": "mobile app",
                    "ExhDescriptionClb": "This exhibition features a portfolio of prints by contemporary artist...",
                    "ExhDateTxt": "2020",
                    "ExhTypeVoc": "InternalExh",
                    "ExhRecordTypeVoc": "Single exhibition",
                    "ExhExhibitionVrt": "Audubon in the Anthropocene: Works by Matthew Day Jackson, 05/04/2020 - 11/24/2020",
                    "ExhCurrentStatusVrt": "null",
                    "__lastModified": {
                        "date": "2023-09-06 03:18:56.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "ExhStdImg": "https://sma-search-api.ku.edu/image/exhib/3323",
                    "ExhCuratedBy": []
                }
            ],
            [
                {
                    "id": 3354,
                    "ExhBeginDateDat": {
                        "date": "2020-10-23 00:00:00.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "ExhEndDateDat": {
                        "date": "2024-07-31 00:00:00.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "ExhTitleTxt": "Conference of the Birds",
                    "ExhVenueDetailsTxt": "https://spencerartapps.ku.edu/spencer-projects/3354",
                    "ExhDescriptionClb": "Kick off the 5th annual Backyard Bash with a special edition of Spencer Projects...",
                    "ExhDateTxt": "2020",
                    "ExhTypeVoc": "InternalExhVirtual",
                    "ExhRecordTypeVoc": "Single exhibition",
                    "ExhExhibitionVrt": "Conference of the Birds, 10/23/2020 - 10/30/2020",
                    "ExhCurrentStatusVrt": "null",
                    "__lastModified": {
                        "date": "2023-09-06 03:18:56.000000",
                        "timezone_type": 3,
                        "timezone": "America/Chicago"
                    },
                    "ExhStdImg": "https://sma-search-api.ku.edu/image/exhib/3354",
                    "ExhCuratedBy": [
                        "Emily Kruse",
                        "Sabine Rishell"
                    ]
                }
            ]
        ],
        "Multimedia": [
            [
                {
                    "id": 118752,
                    "MulTypeVoc": "image",
                    "MulMultimediaVrt": "Still Image, 2016.0024.07.jpg",
                    "MulObjectRefTxt": "55340",
                    "MulAternativeTextClb": null
                    "MulOriginalFileTxt": "2016.0024.07.jpg",
                    "URL": "https://sma-search-api.ku.edu/image/2016.0024.07.jpg"
                    "MulAppDescriptionClb": "",
                    "MulCategoryVoc": "",
                    "MulTranscriptionClb": ""
                }
            ],
            [
                {
                    "id": 149066,
                    "MulTypeVoc": "Virtual Object",
                    "MulMultimediaVrt": "Virtual Object, Web Page",
                    "MulObjectRefTxt": "55340",
                    "MulAternativeTextClb": null
                    "MulOriginalFileTxt": "2016.0024.07.jpg",
                    "URL": "https://www.audubon.org/birds-of-america/blue-jay"
                    "MulAppDescriptionClb": "",
                    "MulCategoryVoc": "",
                    "MulTranscriptionClb": ""
                }
            ]
        ]
    }
]

Get Highlight Details

URL

https://sma-search-api.ku.edu/highlights/8556

Method

GET

Path Parameters

Parameters

Name Type Required Description
id Integer Yes The unique identifier of the highlight

Response

The response is returned in JSON format and includes information about the highlight objects.

Response Fields

Field Type Description
id Integer The unique identifier of the object
ObjObjectTitleVrt String The title of the object
ObjDateMainVrt String The main date of the object
ObjCreditLineTxt String The credit line of the object
ObjMaterialTechniqueVrt String The material or technique of the object
url String The URL to the image of the object
ObjSpencerTypeVoc String The type of object
ObjPerAssociationVrt String The person or maker associated with the object

Example Request

GET https://sma-search-api.ku.edu/highlights/8556

Example Response

[
    [
        {
            "id": 9109,
            "ObjObjectTitleVrt": "Saint Cosmas",
            "ObjDateMainVrt": "circa 1750–1765",
            "ObjCreditLineTxt": "Museum purchase",
            "ObjMaterialTechniqueVrt": "linden wood; gilding; polychromy",
            "url": "https://sma-search-api.ku.edu/image/1950.0090.jpg",
            "ObjSpencerTypeVoc": "sculpture",
            "ObjPerAssociationVrt": "Circle of Ignaz Günther (active late 1700s)"
        },
        {
            "id": 12506,
            "ObjObjectTitleVrt": "Landscape with Four Trees",
            "ObjDateMainVrt": "1920",
            "ObjCreditLineTxt": "Gift of Mr. and Mrs. Olin Petefish",
            "ObjMaterialTechniqueVrt": "canvas; oil",
            "url": "https://sma-search-api.ku.edu/image/1976.0001.jpg",
            "ObjSpencerTypeVoc": "paintings",
            "ObjPerAssociationVrt": "Birger Sandzén (1871–1954)"
        }
    ]
]

Get Random Assortment of Objects

URL

https://sma-search-api.ku.edu/randomize

Method

GET

Path Parameters

This endpoint does not require any path parameters.

Response

The response is returned in JSON format and includes a random assortment of objects.

Response Fields

Field Type Description
id Integer The unique identifier of the object
obj_object_number_sorted_vrt String The sorted object number
obj_date_main_vrt String The main date of the object
obj_associated_place_vrt String The associated place of the object
obj_object_title_vrt String The title of the object
obj_object_vrt String The complete description of the object
obj_per_association_vrt String The person or maker associated with the object
obj_object_number_vrt String The object number
obj_geografic_vrt String The geographic location associated with the object
obj_material_technique_vrt String The material or technique of the object

Example Request

GET https://sma-search-api.ku.edu/randomize

Example Response

{
    "id": 2931,
    "obj_object_number_sorted_vrt": "0000.2755",
    "obj_date_main_vrt": "date unknown",
    "obj_associated_place_vrt": "",
    "obj_object_title_vrt": "lace fragment",
    "obj_object_vrt": "0000.2755, unknown maker from Italy, lace fragment, date unknown",
    "obj_per_association_vrt": "unknown maker from Italy",
    "obj_object_number_vrt": "0000.2755",
    "obj_geografic_vrt": " -> Italy;  -> Europe",
    "obj_material_technique_vrt": "lace"
}

Get Object Images

URL

https://sma-search-api.ku.edu/multimedia/object-images

Method

GET

Query Parameters

Name Type Required Description
accnum[] String[] Yes An array of accession numbers to retrieve images for specific objects

Response

The response is returned in JSON format and includes an array of objects, each containing information about the images associated with the given accession numbers.

Response Fields

Field Type Description
id Integer The unique identifier of the image
alt_text String The alternative text for the image (if available)
title String The title of the object
person String The name and dates of the person associated with the object
url String The URL of the image
url_full String The URL of the full-sized image

Example Request

GET https://sma-search-api.ku.edu/multimedia/object-images?accnum[]=0000.0110&accnum[]=0000.0106

Example Response

[
    {
        "id": 16278,
        "alt_text": null,
        "title": "Hanover Square",
        "person": "Berenice Abbott (1898–1991)",
        "url": "https://sma-search-api.ku.edu/image/0000.0110.jpg",
        "url_full": "https://sma-search-api.ku.edu/image/full/0000.0110.jpg"
    },
    {
        "id": 15916,
        "alt_text": null,
        "title": "Shelter on the Waterfront",
        "person": "Berenice Abbott (1898–1991)",
        "url": "https://sma-search-api.ku.edu/image/0000.0106.jpg",
        "url_full": "https://sma-search-api.ku.edu/image/full/0000.0106.jpg"
    }
]

Create New User

URL

https://sma-search-api.ku.edu/app/users/new

Method

POST

Request Body

The request body should be in JSON format and include the following fields:

Field Type Required Description
name String Yes The name of the new user
email String Yes The email address of the new user

Response

The response is returned in JSON format and includes a success message.

Created Fields

Field Type Description
id Integer The unique identifier of the new user
name String The name of the new user
email String The email address of the new user
active Integer Indicates if the user is active (1 for active, 0 for inactive)
authType String The authentication type of the user, e.g., "FORMS"
created DateTime The creation timestamp of the user
accessToken String The access token for the user
accessCode Integer The access code for the user
role String The role of the user, e.g., "ROLE_USER"

Example Request

POST https://sma-search-api.ku.edu/app/users/new
{
    "name": "John Doe",
    "email": "john.doe@example.com"
}

Example Response

{
    "message": "User created successfully"
}

Create New Portfolio

URL

https://sma-search-api.ku.edu/portfolio/new

Method

POST

Request Body

The request body should be in JSON format and include the following fields:

Field Type Required Description
token String Yes The secret token for authentication
title String Yes The title of the new portfolio
description String Yes The description of the new portfolio

Response

The response is returned in JSON format and includes a message indicating the result of the operation.

Response Fields

Field Type Description
message String A message indicating the result of the portfolio creation operation

Example Request

POST https://sma-search-api.ku.edu/portfolio/new
{
    "token": "guid",
    "title": "New portfolio title",
    "description": "description"
}

Example Response

{
    "message": "Portfolio created successfully"
}

Update Portfolio

URL

https://sma-search-api.ku.edu/portfolio/update

Method

POST

Request Body

The request body should be in JSON format and include the following fields:

Field Type Required Description
id Integer Yes The unique identifier of the portfolio to be updated
token String Yes The secret token for authentication
title String Yes The new title of the portfolio
description String Yes The new description of the portfolio

Response

The response is returned in JSON format and includes a message indicating the result of the operation.

Response Fields

Field Type Description
message String A message indicating the result of the portfolio update operation

Example Request

POST https://sma-search-api.ku.edu/portfolio/update
{
    "id": 3,
    "token": "guid",
    "title": "This is my test Portfolio 5",
    "description": "Changed more stuff"
}

Example Response

{
    "message": "Portfolio updated successfully"
}

Delete Portfolio

URL

https://sma-search-api.ku.edu/portfolio/delete/{id}

Method

POST

Path Parameters

Name Type Required Description
id Integer Yes The unique identifier of the portfolio to be deleted

Request Body

The request body should be in JSON format and include the following field:

Field Type Required Description
token String Yes The secret token for authentication

Response

The response is returned in JSON format and includes a message indicating the result of the operation.

Response Fields

Field Type Description
message String A message indicating the result of the portfolio delete operation

Example Request

POST https://sma-search-api.ku.edu/portfolio/delete/2
{
    "token": "guid"
}

Example Response

{
    "message": "Portfolio and associated objects deleted successfully"
}

List Portfolio Items

URL

https://sma-search-api.ku.edu/portfolio/list

Method

POST

Request Body

The request body should be in JSON format and include the following fields:

Field Type Required Description
token String Yes The secret token for authentication
portfolio_id Integer No The unique identifier of the portfolio (optional)

Response

The response is returned in JSON format and includes a list of portfolio items or an error message.

Response Fields

Field Type Description
id Integer The unique identifier of the portfolio item
portfolio_id Integer The unique identifier of the portfolio
object_id Integer The unique identifier of the object
message String An error message, if applicable

Example Request

POST https://sma-search-api.ku.edu/portfolio/list
{
    "token": "guid",
    "portfolio_id": 1
}

Example Response

[
    {
        "id": 1,
        "portfolio_id": 1,
        "object_id": 101
    },
    {
        "id": 2,
        "portfolio_id": 1,
        "object_id": 102
    }
]

Example Error Response

{
    "message": "403 Unauthorized"
}

Add Object to Portfolio

URL

https://sma-search-api.ku.edu/portfolio/objects

Method

POST

Request Body

The request body should be in JSON format and include the following fields:

Field Type Required Description
token String Yes The secret token for authentication
portfolio_id Integer Yes The unique identifier of the portfolio
object_id Integer Yes The unique identifier of the object

Response

The response is returned in JSON format and includes a message indicating the result of the operation.

Response Fields

Field Type Description
message String A message indicating the result of the operation

Example Request

POST https://sma-search-api.ku.edu/portfolio/objects
{
    "token": "guid",
    "portfolio_id": 1,
    "object_id": 101
}

Example Response

{
    "message": "Object added to portfolio successfully"
}

Example Error Responses

{
    "message": "400 Bad Request"
}
{
    "message": "403 Unauthorized"
}

List Objects in Portfolio

URL

https://sma-search-api.ku.edu/portfolio/objects/list

Method

POST

Request Body

The request body should be in JSON format and include the following fields:

Field Type Required Description
token String Yes The secret token for authentication
portfolio_id Integer Yes The unique identifier of the portfolio

Response

The response is returned in JSON format and includes a list of objects in the portfolio.

Response Fields

Field Type Description
id Integer The unique identifier of the portfolio object
portfolio_id Integer The unique identifier of the portfolio
object_id Integer The unique identifier of the object

Example Request

POST https://sma-search-api.ku.edu/portfolio/objects/list
{
    "token": "guid",
    "portfolio_id": 1
}

Example Response

[
    {
        "id": 1,
        "portfolio_id": 1,
        "object_id": 101
    },
    {
        "id": 2,
        "portfolio_id": 1,
        "object_id": 102
    }
]

Example Error Responses

{
    "message": "400 Bad Request"
}
{
    "message": "403 Unauthorized"
}

Delete Portfolio Object

URL

https://sma-search-api.ku.edu/portfolio/objects/delete/{id}

Method

POST

Path Parameters

Name Type Required Description
id Integer Yes The unique identifier of the portfolio object

Request Body

The request body should be in JSON format and include the following fields:

Field Type Required Description
token String Yes The secret token for authentication

Response

The response is returned in JSON format and includes a message indicating the success of the deletion.

Response Fields

Field Type Description
message String Indicates the success of the deletion

Example Request

POST https://sma-search-api.ku.edu/portfolio/objects/delete/101
{
    "token": "guid"
}

Example Response

{
    "message": "Portfolio object successfully deleted"
}

Example Error Responses

{
    "message": "400 Bad Request"
}
{
    "message": "403 Unauthorized"
}