# V&A

> 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.

App · 5 actions. Web page: https://docs.lodol.com/docs/integrations/vam

## Actions

### 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_by`, text, required): 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 (`query`, text): 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_type`, text): 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 (`maker`, text): 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 (`material`, text): 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 (`technique`, text): 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 (`place`, text): 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 (`style`, text): 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 (`category`, text): 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 (`collection`, text): 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_year`, number): 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_year`, number): Only objects made in or before this year. Leave empty for no limit. From -10000 to 2100.
- Images (`images`, text): 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_at`, text): 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 (`limit`, number): How many values to return, 1 to 100. Defaults to 20. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many values are listed
- `group_by` (text): What the objects were counted by, such as maker
- `group_label` (text): The same, as the builder names it, such as Maker
- `values` (list): Each value and how many matching objects have it, most first

**Example output**

```json
{
  "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_number`, text, required): 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_number` (text): The museum number the object was given when it joined the collection, such as M.934-1983
- `accession_year` (number): The year it joined the collection
- `brief_description` (text): A one or two sentence description
- `categories` (list): The V&A's categories for it, such as Metalwork
- `content_warnings` (list): What the V&A warns may be offensive or upsetting: 'record' (the text), 'images', both, or neither
- `created_on` (text): When the record was created, YYYY-MM-DD
- `credit_line` (text): The credit to give, such as 'Given by ...'; often empty
- `date` (text): When it was made, as the V&A writes it, such as 1922-1923 or ca. 1700
- `dimensions` (list): Its measurements, such as 'Height: 13.2 cm'
- `gallery_labels` (list): The text of its gallery labels, newest first
- `historical_context` (text): Its background and significance
- `image_count` (number): How many images of it are online
- `image_id` (text): The id of its main image; empty when it has no image online
- `image_ids` (list): The ids of every image of it online, main one first
- `image_url` (text): Its main image, up to 768 pixels; empty without an image
- `location` (text): Where it is now: a gallery and room such as 'Silver, Room 68', or 'In Store'
- `maker` (text): The first maker named, such as Robert Crawford Johnson or Unknown
- `maker_role` (text): What that maker did, such as designer, maker or photographer
- `makers` (list): Every maker named, with what each did
- `manifest_url` (text): 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_inscriptions` (list): Marks, signatures and inscriptions on it
- `materials` (list): What it is made of
- `materials_and_techniques` (text): What it is made of and how, in words
- `object_history` (text): Where it came from and how the V&A acquired it
- `object_type` (text): What kind of object it is, such as Teapot or Poster
- `on_display` (true/false): True when the object is on display in a gallery
- `physical_description` (text): What it looks like
- `place` (text): The first place connected with making it, such as Birmingham
- `places` (list): The places it was made, designed or used
- `production_dates` (list): When it was made (and designed, printed...)
- `production_note` (text): Notes on how and where it was made
- `site` (text): The V&A museum it is at, such as V&A South Kensington or V&A East Storehouse; empty when it is elsewhere
- `styles` (list): Its styles, such as Modernist
- `summary_description` (text): The V&A's longer account of the object
- `system_number` (text): The V&A's number for the object record, such as O94917: what Get object and List object images take
- `techniques` (list): How it was made
- `thumbnail_url` (text): Its main image, up to 100 pixels; empty without an image
- `title` (text): The object's title; empty for the many objects that have none
- `titles` (list): Every title the object has, the main one first
- `updated_on` (text): When the record was last changed, YYYY-MM-DD
- `url` (text): The object's page on collections.vam.ac.uk

**Example output**

```json
{
  "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_number`, text, required): 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 (`size`, text): 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**

- `count` (number): How many images there are
- `image_resolution` (text): high (images up to 2,500 pixels), low (up to 768) or empty without images
- `images` (list): Every image of the object, main one first
- `largest_size_px` (number): The longest side of its images at their largest, in pixels
- `manifest_url` (text): Its IIIF manifest, for image viewers; empty unless its images are high resolution
- `size` (text): The size the image links are for
- `system_number` (text): The object's system number, such as O94917
- `title` (text): The object's title, or its type when it has none
- `url` (text): The object's page on collections.vam.ac.uk
- `viewer_url` (text): The images in the V&A's Universal Viewer; empty without a manifest

**Example output**

```json
{
  "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 (`query`, text, required): What to look for, such as ballet russes, or a reference code such as THM/636.
- Search in (`search_in`, text): 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 (`page`, number): 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 (`limit`, number): How many records to return, 1 to 100. Defaults to 20. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many records are on this page
- `page` (number): Which page this is, from 1
- `pages` (number): How many pages there are at this page size
- `query` (text): The text searched for
- `records` (list): The archive records on this page
- `search_in` (text): Where it was looked for: anywhere, title, creator or reference_code
- `total` (number): How many records matched in all (counted up to 10,000)

**Example output**

```json
{
  "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 (`query`, text): 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_type`, text): 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 (`maker`, text): 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 (`material`, text): 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 (`technique`, text): 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 (`place`, text): 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 (`style`, text): 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 (`category`, text): 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 (`collection`, text): 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_year`, number): 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_year`, number): Only objects made in or before this year. Leave empty for no limit. From -10000 to 2100.
- Images (`images`, text): 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_at`, text): 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_on`, date): 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 (`sort`, text): 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 (`page`, number): 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 (`limit`, number): How many objects to return, 1 to 100. Defaults to 20. From 1 to 100. Default: `20`.

**Outputs**

- `count` (number): How many objects are on this page
- `csv_url` (text): This page of results as a CSV file from the V&A, with fewer columns, for a spreadsheet
- `image_count` (number): How many images the matching objects have in all
- `objects` (list): The objects on this page
- `page` (number): Which page this is, from 1
- `pages` (number): How many pages there are at this page size
- `total` (number): How many objects matched in all

**Example output**

```json
{
  "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
}
```
