Accessing Variants

In order to access variants available to you, you can use any of the following endpoints:

Endpoint	Description
GET /articles/{article_id}/variants (opens new window)	Returns a list of all variants of the given Article
GET /variants/{variant_id} (opens new window)	Returns the variant with the provided variant_id

You can also search within all available variants. Learn how to do so here: Variant Search

Example Request

GET /articles/7cbf51bd-35a8-47a1-84a2-57aa63140234/variants

Example Response

[
  {
    "id": "0001b94e-4e87-4ee9-8b14-6ff9910b4f26",
    "brightness": null,
    "category": "PS1 - Premium Coated",
    "color": null,
    "dimensions_unit": "mm",
    "form": "sheet",
    "grain": "long",
    "height": 640,
    "paper_weight": 90,
    "paper_weight_unit": "gsm",
    "roughness": null,
    "thickness": 64,
    "transparency": null,
    "unit_system": "metric",
    "whiteness": null,
    "width": 460,
    "article_id": "7cbf51bd-35a8-47a1-84a2-57aa63140234",
    "article": {
      "id": "7cbf51bd-35a8-47a1-84a2-57aa63140234",
      "name": "Bounty gloss",
      "links": [
        {
          "rel": "self",
          "href": "/consumers/api/v1/articles/7cbf51bd-35a8-47a1-84a2-57aa63140234"
        }
      ]
    },
    "created_at": "2020-10-13T10:34:51.485Z",
    "updated_at": "2021-03-15T11:29:49.545Z"
  },
  {
    "id": "00d388c3-fee2-43bc-a17f-e51bafcc77cb",
    "brightness": null,
    "category": "PS1 - Premium Coated",
    "color": null,
    "dimensions_unit": "mm",
    "form": "sheet",
    "grain": "long",
    "height": 900,
    "paper_weight": 300,
    "paper_weight_unit": "gsm",
    "roughness": null,
    "thickness": 246,
    "transparency": null,
    "unit_system": "metric",
    "whiteness": null,
    "width": 640,
    "article_id": "7cbf51bd-35a8-47a1-84a2-57aa63140234",
    "article": {
      "id": "7cbf51bd-35a8-47a1-84a2-57aa63140234",
      "name": "Bounty gloss",
      "links": [
        {
          "rel": "self",
          "href": "/consumers/api/v1/articles/7cbf51bd-35a8-47a1-84a2-57aa63140234"
        }
      ]
    },
    "created_at": "2020-10-13T10:37:28.578Z",
    "updated_at": "2021-03-15T11:29:48.665Z"
  }
]