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

ActionWhat it does
Count objects byCount 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 objectRead 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 imagesList 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 archivesSearch 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 objectsSearch 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 bygroup_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.
Searchquerytext
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 typeobject_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.
Makermakertext
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.
Materialmaterialtext
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.
Techniquetechniquetext
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.
Placeplacetext
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.
Stylestyletext
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.
Categorycategorytext
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.
Collectioncollectiontext
Only objects in this V&A collection, such as the Ceramics Collection or the Theatre and Performance Collection. Leave empty for all.
Made from yearmade_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 yearmade_to_yearnumber
Only objects made in or before this year. Leave empty for no limit.From -10000 to 2100.
Imagesimagestext
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 aton_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 resultslimitnumber
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 numbersystem_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 numbersystem_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 sizesizetext
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

SearchquerytextRequired
What to look for, such as ballet russes, or a reference code such as THM/636.
Search insearch_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.
Pagepagenumber
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 resultslimitnumber
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

Searchquerytext
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 typeobject_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.
Makermakertext
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.
Materialmaterialtext
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.
Techniquetechniquetext
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.
Placeplacetext
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.
Stylestyletext
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.
Categorycategorytext
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.
Collectioncollectiontext
Only objects in this V&A collection, such as the Ceramics Collection or the Theatre and Performance Collection. Leave empty for all.
Made from yearmade_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 yearmade_to_yearnumber
Only objects made in or before this year. Leave empty for no limit.From -10000 to 2100.
Imagesimagestext
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 aton_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 onchanged_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.
Sortsorttext
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.
Pagepagenumber
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 resultslimitnumber
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
}

On this page