V&A
App · 5 actions
Explore the Victoria and Albert Museum's collection of art, design and performance: search over a million objects by maker, material, place, style, category, date and more, read an object's full record, get its images at any size, count a search's objects per maker or material, and search the V&A archives. A trigger starts a workflow when the V&A adds or changes a matching object. No account or API key required.
Actions
| Action | What it does |
|---|---|
| Count objects by | Count the objects a search matches per maker, person, organisation, object type, material, technique, place, style, category, collection, gallery, subject depicted, event or year acquired, most first. |
| Get object | Read one object's full record by its system number: its titles, descriptions, makers and their roles, dates, places, materials, techniques, categories, styles, measurements, marks and inscriptions, gallery label, where it is now and its images. |
| List object images | List every photograph of one object as image links at the size you choose, from a thumbnail to the largest the V&A has (up to 2,500 pixels), with each image's copyright, its IIIF address for other sizes and crops, and the object's IIIF manifest and viewer. |
| Search archives | Search the V&A's archive catalogue (theatre and performance, art and design archives and more) anywhere in a record, or by title, creator or reference code. |
| Search objects | Search the V&A's collection of over a million objects by words and by maker, material, technique, place, style, category, collection or object type, the years they were made, whether they have images, where they are on display and when their record changed. |
Count objects by
Count the objects a search matches per maker, person, organisation, object type, material, technique, place, style, category, collection, gallery, subject depicted, event or year acquired, most first. Each value comes with the V&A's id for it, which the matching filter of Search objects takes.
Inputs
- Group by
group_bytextRequired - What to count the matching objects by.One of:
maker,person,organisation,object_type(Object type),material,technique,place,style,category,collection, and 6 more. - Search
querytext - Words to find anywhere in an object's record, such as teapot or "William Morris". Put a phrase in double quotes, a hyphen before a word to leave it out (-silver), or | between words for either. Leave empty to search by the filters alone.
- Object type
object_typetext - Only objects of this type, such as Teapot or Poster: one of the commonest, or any type typed exactly as the V&A names it. Leave empty for any.
- Maker
makertext - Only objects made by this person or company: one of the commonest makers, or the V&A's id for any other, such as A8676 for William Morris (Count objects by Maker shows the ids). Leave empty for any.
- Material
materialtext - Only objects made of this, such as silver: one of the commonest, or the V&A's id for any other (Count objects by Material shows them). Leave empty for any.
- Technique
techniquetext - Only objects made this way, such as embroidery: one of the commonest, or the V&A's id for any other (Count objects by Technique shows them). Leave empty for any.
- Place
placetext - Only objects connected with this place, such as London or Japan: one of the commonest, or the V&A's id for any other (Count objects by Place shows them). Leave empty for any.
- Style
styletext - Only objects in this style, such as Art Nouveau: one of the commonest, or the V&A's id for any other. Leave empty for any.
- Category
categorytext - Only objects in this V&A category, such as Ceramics, Fashion or Posters: one of the commonest, or the V&A's id for any other. Leave empty for any.
- Collection
collectiontext - Only objects in this V&A collection, such as the Ceramics Collection or the Theatre and Performance Collection. Leave empty for all.
- Made from year
made_from_yearnumber - Only objects made in or after this year; for BC give a negative year, such as -500. Objects dated loosely (19th century) count when their range overlaps. Leave empty for no limit.From -10000 to 2100.
- Made to year
made_to_yearnumber - Only objects made in or before this year. Leave empty for no limit.From -10000 to 2100.
- Images
imagestext - Only objects with photographs online, or only those with large ones (up to 2,500 pixels). Leave empty to include objects without images.One of:
any(With images),large(With large images (up to 2,500 pixels)). - On display at
on_display_attext - Only objects on display now at this V&A museum, or at any of them. Leave empty to include objects in store.One of:
all(Any V&A site),southken(V&A South Kensington),es(V&A East Storehouse),em(V&A East Museum),yva(Young V&A),wed(V&A Wedgwood Collection),dundee(V&A Dundee). - Number of results
limitnumber - How many values to return, 1 to 100. Defaults to 20.From 1 to 100. Default:
20.
Outputs
countnumber- How many values are listed
group_bytext- What the objects were counted by, such as maker
group_labeltext- The same, as the builder names it, such as Maker
valueslist- Each value and how many matching objects have it, most first
Example output
{
"count": 3,
"group_by": "maker",
"group_label": "Maker",
"values": [
{
"count": 493,
"id": "A1848",
"name": "Unknown",
"parent": ""
},
{
"count": 354,
"id": "A1450",
"name": "Josiah Wedgwood and Sons",
"parent": ""
},
{
"count": 107,
"id": "A9260",
"name": "Worcester porcelain factory",
"parent": ""
}
]
}Get object
Read one object's full record by its system number: its titles, descriptions, makers and their roles, dates, places, materials, techniques, categories, styles, measurements, marks and inscriptions, gallery label, where it is now and its images.
Inputs
- System number
system_numbertextRequired - The V&A's number for the object, such as O94917, as Search objects returns it and the object's page shows. The page's address works too.
Outputs
accession_numbertext- The museum number the object was given when it joined the collection, such as M.934-1983
accession_yearnumber- The year it joined the collection
brief_descriptiontext- A one or two sentence description
categorieslist- The V&A's categories for it, such as Metalwork
content_warningslist- What the V&A warns may be offensive or upsetting: 'record' (the text), 'images', both, or neither
created_ontext- When the record was created, YYYY-MM-DD
credit_linetext- The credit to give, such as 'Given by ...'; often empty
datetext- When it was made, as the V&A writes it, such as 1922-1923 or ca. 1700
dimensionslist- Its measurements, such as 'Height: 13.2 cm'
gallery_labelslist- The text of its gallery labels, newest first
historical_contexttext- Its background and significance
image_countnumber- How many images of it are online
image_idtext- The id of its main image; empty when it has no image online
image_idslist- The ids of every image of it online, main one first
image_urltext- Its main image, up to 768 pixels; empty without an image
locationtext- Where it is now: a gallery and room such as 'Silver, Room 68', or 'In Store'
makertext- The first maker named, such as Robert Crawford Johnson or Unknown
maker_roletext- What that maker did, such as designer, maker or photographer
makerslist- Every maker named, with what each did
manifest_urltext- Its IIIF manifest, which image viewers such as Mirador open with every image of the object; empty unless the V&A has large images of it
marks_and_inscriptionslist- Marks, signatures and inscriptions on it
materialslist- What it is made of
materials_and_techniquestext- What it is made of and how, in words
object_historytext- Where it came from and how the V&A acquired it
object_typetext- What kind of object it is, such as Teapot or Poster
on_displaytrue/false- True when the object is on display in a gallery
physical_descriptiontext- What it looks like
placetext- The first place connected with making it, such as Birmingham
placeslist- The places it was made, designed or used
production_dateslist- When it was made (and designed, printed...)
production_notetext- Notes on how and where it was made
sitetext- The V&A museum it is at, such as V&A South Kensington or V&A East Storehouse; empty when it is elsewhere
styleslist- Its styles, such as Modernist
summary_descriptiontext- The V&A's longer account of the object
system_numbertext- The V&A's number for the object record, such as O94917: what Get object and List object images take
techniqueslist- How it was made
thumbnail_urltext- Its main image, up to 100 pixels; empty without an image
titletext- The object's title; empty for the many objects that have none
titleslist- Every title the object has, the main one first
updated_ontext- When the record was last changed, YYYY-MM-DD
urltext- The object's page on collections.vam.ac.uk
Example output
{
"accession_number": "M.934-1983",
"accession_year": 1983,
"brief_description": "Teapot, silver with wooden details, Birmingham hallmarks for 1922-23, mark of Napper and Davenport, designed by Robert Johnson.",
"categories": [
{
"id": "THES48920",
"name": "Metalwork"
},
{
"id": "THES48886",
"name": "Tea, Coffee & Chocolate wares"
}
],
"content_warnings": [],
"created_on": "2004-03-03",
"credit_line": "",
"date": "1922-1923",
"dimensions": [
"Height: 13.2 cm",
"Length: 13.2 cm",
"Width: 13.2 cm"
],
"gallery_labels": [
"CUBE TEAPOT\r\nSilver, the finial and handle of wood\r\nHallmarks for Birmingham 1922-23"
],
"historical_context": "",
"image_count": 1,
"image_id": "2006BG1640",
"image_ids": [
"2006BG1640"
],
"image_url": "https://framemark.vam.ac.uk/collections/2006BG1640/full/!768,768/0/default.jpg",
"location": "Silver, Room 68",
"maker": "Robert Crawford Johnson",
"maker_role": "designer",
"makers": [
{
"id": "A12154",
"name": "Robert Crawford Johnson",
"role": "designer"
},
{
"id": "A11061",
"name": "Napper and Davenport",
"role": "maker"
}
],
"manifest_url": "https://iiif.vam.ac.uk/collections/O94917/manifest.json",
"marks_and_inscriptions": [
"Base: stamped: \u201cThe Cube Tea Pot\nRobert Johnsons Patents\nGt Britain 110951\nUSA 1380066-21\nNapper and Davenport\nBirmingham England\nSerial No. L31"
],
"materials": [
{
"id": "AAT11029",
"name": "silver"
},
{
"id": "AAT11914",
"name": "wood"
}
],
"materials_and_techniques": "Silver, with hinged lid and black wooden handle and finial.",
"object_history": "Its production in silver by the Birmingham retail silversmith, Napper & Davenport gave it an aesthetic importance that the original patentee never initially intended.",
"object_type": "Teapot",
"on_display": true,
"physical_description": "Cube teapot.",
"place": "Birmingham",
"places": [
{
"id": "x28748",
"name": "Birmingham",
"role": "made"
}
],
"production_dates": [
{
"date": "1922-1923",
"earliest": "1922-05-29",
"latest": "1923-05-28",
"role": "made"
},
{
"date": "1916",
"earliest": "1916-01-01",
"latest": "1916-12-31",
"role": "designed"
}
],
"production_note": "",
"site": "V&A South Kensington",
"styles": [
{
"id": "AAT21474",
"name": "Modernist"
}
],
"summary_description": "Stylistically, this teapot appears to be an English interpretation of the aesthetic principles of the German Bauhaus. However, the patent details inscribed on the base reveal that the design was registered in 1916, three years before the Bauhaus existed.",
"system_number": "O94917",
"techniques": [
{
"id": "AAT53949",
"name": "soldering"
},
{
"id": "x34899",
"name": "stamping"
}
],
"thumbnail_url": "https://framemark.vam.ac.uk/collections/2006BG1640/full/!100,100/0/default.jpg",
"title": "Teapot",
"titles": [
"Teapot"
],
"updated_on": "2026-07-14",
"url": "https://collections.vam.ac.uk/item/O94917/"
}List object images
List every photograph of one object as image links at the size you choose, from a thumbnail to the largest the V&A has (up to 2,500 pixels), with each image's copyright, its IIIF address for other sizes and crops, and the object's IIIF manifest and viewer.
Inputs
- System number
system_numbertextRequired - The V&A's number for the object, such as O94917, as Search objects returns it and the object's page shows. The page's address works too.
- Image size
sizetext - How large the image links are, on the longest side. An image smaller than the size chosen comes at its own size. Defaults to medium (up to 768 pixels).One of:
thumbnail(Thumbnail (up to 100 pixels)),small(Small (up to 400 pixels)),medium(Medium (up to 768 pixels)),large(Large (up to 1,600 pixels)),full(Largest the V&A has (up to 2,500 pixels)). Default:medium.
Outputs
countnumber- How many images there are
image_resolutiontext- high (images up to 2,500 pixels), low (up to 768) or empty without images
imageslist- Every image of the object, main one first
largest_size_pxnumber- The longest side of its images at their largest, in pixels
manifest_urltext- Its IIIF manifest, for image viewers; empty unless its images are high resolution
sizetext- The size the image links are for
system_numbertext- The object's system number, such as O94917
titletext- The object's title, or its type when it has none
urltext- The object's page on collections.vam.ac.uk
viewer_urltext- The images in the V&A's Universal Viewer; empty without a manifest
Example output
{
"count": 1,
"image_resolution": "high",
"images": [
{
"copyright": "\u00a9 Victoria and Albert Museum, London",
"iiif_base_url": "https://framemark.vam.ac.uk/collections/2006BG1640",
"image_id": "2006BG1640",
"info_url": "https://framemark.vam.ac.uk/collections/2006BG1640/info.json",
"is_sensitive": false,
"position": 1,
"thumbnail_url": "https://framemark.vam.ac.uk/collections/2006BG1640/full/!100,100/0/default.jpg",
"url": "https://framemark.vam.ac.uk/collections/2006BG1640/full/!768,768/0/default.jpg"
}
],
"largest_size_px": 2500,
"manifest_url": "https://iiif.vam.ac.uk/collections/O94917/manifest.json",
"size": "medium",
"system_number": "O94917",
"title": "Teapot",
"url": "https://collections.vam.ac.uk/item/O94917/",
"viewer_url": "https://iiif.vam.ac.uk/viewers/uv/3/uv.html#?manifest=https://iiif.vam.ac.uk/collections/O94917/manifest.json"
}Search archives
Search the V&A's archive catalogue (theatre and performance, art and design archives and more) anywhere in a record, or by title, creator or reference code. Each record comes with its reference, level, date, extent and its page on the V&A's website.
Inputs
- Search
querytextRequired - What to look for, such as ballet russes, or a reference code such as THM/636.
- Search in
search_intext - Where to look for it. A reference code must match exactly. Defaults to anywhere in the record.One of:
anywhere(Anywhere in the record),title,creator,reference_code(Reference code (exact)). Default:anywhere. - Page
pagenumber - Which page of records to return, from 1. The V&A reads no further than the 10,000th result. Defaults to 1.From 1 to 10000. Default:
1. - Number of results
limitnumber - How many records to return, 1 to 100. Defaults to 20.From 1 to 100. Default:
20.
Outputs
countnumber- How many records are on this page
pagenumber- Which page this is, from 1
pagesnumber- How many pages there are at this page size
querytext- The text searched for
recordslist- The archive records on this page
search_intext- Where it was looked for: anywhere, title, creator or reference_code
totalnumber- How many records matched in all (counted up to 10,000)
Example output
{
"count": 2,
"page": 1,
"pages": 62,
"query": "ballet russes",
"records": [
{
"date": "16 June 2009",
"extent": "44 images",
"image_id": "2023NK2954",
"level": "File",
"reference_code": "THM/636/1/56",
"system_number": "ARC228146",
"thumbnail_url": "https://framemark.vam.ac.uk/collections/2023NK2954/full/!100,100/0/default.jpg",
"title": "English National Ballet Ballets Russes",
"url": "https://www.vam.ac.uk/archives/unit/ARC228146/"
},
{
"date": "c. 1982",
"extent": "1 folder",
"image_id": "",
"level": "File",
"reference_code": "THM/461/7/2/20",
"system_number": "ARC231413",
"thumbnail_url": "",
"title": "Ballet Russes photographs",
"url": "https://www.vam.ac.uk/archives/unit/ARC231413/"
}
],
"search_in": "anywhere",
"total": 123
}Search objects
Search the V&A's collection of over a million objects by words and by maker, material, technique, place, style, category, collection or object type, the years they were made, whether they have images, where they are on display and when their record changed. Each comes with its title, maker, date, place, where it is now, image links and its page on the V&A's website.
Inputs
- Search
querytext - Words to find anywhere in an object's record, such as teapot or "William Morris". Put a phrase in double quotes, a hyphen before a word to leave it out (-silver), or | between words for either. Leave empty to search by the filters alone.
- Object type
object_typetext - Only objects of this type, such as Teapot or Poster: one of the commonest, or any type typed exactly as the V&A names it. Leave empty for any.
- Maker
makertext - Only objects made by this person or company: one of the commonest makers, or the V&A's id for any other, such as A8676 for William Morris (Count objects by Maker shows the ids). Leave empty for any.
- Material
materialtext - Only objects made of this, such as silver: one of the commonest, or the V&A's id for any other (Count objects by Material shows them). Leave empty for any.
- Technique
techniquetext - Only objects made this way, such as embroidery: one of the commonest, or the V&A's id for any other (Count objects by Technique shows them). Leave empty for any.
- Place
placetext - Only objects connected with this place, such as London or Japan: one of the commonest, or the V&A's id for any other (Count objects by Place shows them). Leave empty for any.
- Style
styletext - Only objects in this style, such as Art Nouveau: one of the commonest, or the V&A's id for any other. Leave empty for any.
- Category
categorytext - Only objects in this V&A category, such as Ceramics, Fashion or Posters: one of the commonest, or the V&A's id for any other. Leave empty for any.
- Collection
collectiontext - Only objects in this V&A collection, such as the Ceramics Collection or the Theatre and Performance Collection. Leave empty for all.
- Made from year
made_from_yearnumber - Only objects made in or after this year; for BC give a negative year, such as -500. Objects dated loosely (19th century) count when their range overlaps. Leave empty for no limit.From -10000 to 2100.
- Made to year
made_to_yearnumber - Only objects made in or before this year. Leave empty for no limit.From -10000 to 2100.
- Images
imagestext - Only objects with photographs online, or only those with large ones (up to 2,500 pixels). Leave empty to include objects without images.One of:
any(With images),large(With large images (up to 2,500 pixels)). - On display at
on_display_attext - Only objects on display now at this V&A museum, or at any of them. Leave empty to include objects in store.One of:
all(Any V&A site),southken(V&A South Kensington),es(V&A East Storehouse),em(V&A East Museum),yva(Young V&A),wed(V&A Wedgwood Collection),dundee(V&A Dundee). - Record changed on
changed_ondate - Only objects whose record the V&A added or last changed on this day. The V&A publishes a day's changes the next day. Leave empty for any.
- Sort
sorttext - The order of the results. Defaults to best match first.One of:
relevance(Best match first),date_newest(Date made, newest first),date_oldest(Date made, oldest first),most_detailed(Most fully catalogued first). Default:relevance. - Page
pagenumber - Which page of results to return, from 1. The V&A reads no further than the 10,000th result. Defaults to 1.From 1 to 10000. Default:
1. - Number of results
limitnumber - How many objects to return, 1 to 100. Defaults to 20.From 1 to 100. Default:
20.
Outputs
countnumber- How many objects are on this page
csv_urltext- This page of results as a CSV file from the V&A, with fewer columns, for a spreadsheet
image_countnumber- How many images the matching objects have in all
objectslist- The objects on this page
pagenumber- Which page this is, from 1
pagesnumber- How many pages there are at this page size
totalnumber- How many objects matched in all
Example output
{
"count": 1,
"csv_url": "https://api.vam.ac.uk/v2/objects/search?q=teapot&kw_object_type=Teapot&id_material=AAT11029&images_exist=1&page=1&page_size=1&response_format=csv",
"image_count": 196,
"objects": [
{
"accession_number": "M.934-1983",
"content_warnings": [],
"date": "1922-1923",
"image_id": "2006BG1640",
"image_url": "https://framemark.vam.ac.uk/collections/2006BG1640/full/!768,768/0/default.jpg",
"location": "Silver, Room 68",
"maker": "Robert Crawford Johnson",
"maker_role": "designer",
"manifest_url": "https://iiif.vam.ac.uk/collections/O94917/manifest.json",
"object_type": "Teapot",
"on_display": true,
"place": "Birmingham",
"site": "V&A South Kensington",
"system_number": "O94917",
"thumbnail_url": "https://framemark.vam.ac.uk/collections/2006BG1640/full/!100,100/0/default.jpg",
"title": "Teapot",
"url": "https://collections.vam.ac.uk/item/O94917/"
}
],
"page": 1,
"pages": 81,
"total": 81
}