Public API

The Mixam Public API is designed to provide seamless integration of our comprehensive printing services into your applications. Built with the OpenAPI v3 schema, our API ensures a standardized and efficient way to interact with our services. Developers can easily download the OpenAPI schema for detailed information and integration purposes.

Key functionalities include:

  • Retrieve Available Products: Get a complete list of all available print products offered by Mixam.
  • Product Options: Access detailed options for each product, including paper types, paper weights, binding types, lamination options, and more, to customize your print projects precisely to your needs.
  • Place Orders: Submit print orders directly through the API, ensuring a smooth and efficient order placement process.
  • Order Management: Retrieve detailed information about your orders, including current statuses, to keep track of progress and updates in real-time.

Additionally, we offer a Swagger UI tool, which allows you to try out and view the API interactively. This tool provides an intuitive interface to explore the API endpoints, execute requests, and see responses, making it easier to understand and utilize our API capabilities.

Whether you’re building an e-commerce platform, a design application, or any service requiring professional printing, the Mixam Public API provides the tools you need for a fully integrated print solution. Explore our comprehensive documentation to get started quickly and efficiently.

Security

Please note that you must have a Mixam account to access the API.


Obtaining a JWT Token

Once your account is approved, you will need a JSON Web Token (JWT) to authenticate your API requests. Follow these steps to obtain your JWT token:

Security Flow
  • Send a Basic Auth Request:

    Use your approved credentials to make a Basic Auth request to the /api/user/token endpoint. Your username is the email address you used to register an account. The password is the password for your account.

    Endpoint:

    GET /api/user/token

    Headers:

    Authorization: Basic 
  • Receive the JWT Token:

    On successful authentication, the API will return a JWT token. This token will be used for authenticating subsequent API requests.


Making Authenticated API Requests

With the JWT token obtained in the previous step, you can now make requests to other API endpoints using Bearer Token Authentication. Include the token in the Authorization header of your requests.

Example:

GET /api/endpoint
Authorization: Bearer <your-jwt-token>

By following these steps, you will be able to securely access and use our API.

Users API

The Users API allows you to retrieve detailed information about a specified user account, including their orders and quotes. This API is designed to provide access to user-specific data, enabling you to manage your account effectively. Note: You can only fetch user information and orders/quotes for your own user account.


Retrieve User Information

To get information about a user, make a GET request to the /api/public/user endpoint.

User API Request
Endpoint:
GET /api/public/user
Example Request:
curl -X 'GET' \
 'https://mixam.co.uk/api/public/user' \
 -H 'accept: application/json' \
 -H 'Authorization: Bearer YOUR_JWT_TOKEN'
Response:
{
  "id": "5f28202ebb78cb0027b0c284",
  "email": "sherlock@bakerstreet.com",
  "firstName": "Sherlock",
  "lastname": "Holmes",
  "preferredLanguage": "en",
  "createdDate": {
    "date": "2020-08-03T15:33:18.085+01",
    "timestamp": 1596465198085
  },
  "firstOrderDate": {
    "date": "2020-09-03T11:42:19.017+01",
    "timestamp": 1599129739017
  },
  "lastOrderDate": {
    "date": "2024-05-14T17:05:13.439+01",
    "timestamp": 1715702713439
  },
  "lastLoginDate": {
    "date": "2024-06-06T13:37:08.382+01",
    "timestamp": 1717677428382
  },
  "confirmedOrderCount": 542,
  "addressBook": {
    "addresses": [
      {
        "id": "4d44fc32-fc4b-4014-9a73-f0c870bac75c",
        "firstName": "Sherlock",
        "lastName": "Holmes",
        "postcode": "NW1 6XE",
        "line1": "221B Baker Street",
        "line2": "",
        "town": "London",
        "county": "",
        "country": "GB",
        "phone": "+44 12345 678912",
        "company": "Detective Agency",
        "instructions": "",
        "locationType": "residential",
        "valid": true,
        "postBox": false
      },
      {
        "id": "8a9daaf8-3d33-4022-b83c-38d21751a1c3",
        "firstName": "Sherlock",
        "lastName": "Holmes",
        "postcode": "NW1 6XE",
        "line1": "221B Baker Street",
        "line2": "",
        "town": "London",
        "county": "",
        "country": "GB",
        "phone": "+44 12345 678912",
        "company": "Detective Agency",
        "instructions": "",
        "locationType": "residential",
        "valid": true,
        "postBox": false
      }
    ],
    "defaultShippingAddressId": "4d44fc32-fc4b-4014-9a73-f0c870bac75c",
    "defaultBillingAddressId": "4d44fc32-fc4b-4014-9a73-f0c870bac75c",
    "defaultBillingAddress": {
      "id": "4d44fc32-fc4b-4014-9a73-f0c870bac75c",
      "firstName": "Sherlock",
      "lastName": "Holmes",
      "postcode": "NW1 6XE",
      "line1": "221B Baker Street",
      "line2": "",
      "town": "London",
      "county": "",
      "country": "GB",
      "phone": "+44 12345 678912",
      "company": "Detective Agency",
      "instructions": "",
      "locationType": "residential",
      "valid": true,
      "postBox": false
    },
    "defaultShippingAddress": {
      "id": "4d44fc32-fc4b-4014-9a73-f0c870bac75c",
      "firstName": "Sherlock",
      "lastName": "Holmes",
      "postcode": "NW1 6XE",
      "line1": "221B Baker Street",
      "line2": "",
      "town": "London",
      "county": "",
      "country": "GB",
      "phone": "+44 12345 678912",
      "company": "Detective Agency",
      "instructions": "",
      "locationType": "residential",
      "valid": true,
      "postBox": false
    }
  },
  "creditLimit": 0,
  "taxExemptionCertificates": []
}

Retrieve User Quotes

To get a list of quotes associated with the user's account, make a GET request to the /api/public/user/quotes endpoint.

User Quotes API Request
Endpoint:
GET /api/public/user/quotes
Example Request:
curl -X 'GET' \
 'https://mixam.co.uk/api/public/user/quotes' \
 -H 'accept: application/json' \
 -H 'Authorization: Bearer YOUR_JWT_TOKEN'
Response:
{
  "quotes": [
    {
      "id": "66438bb90c9b7d7b15927e80",
      "orderNumber": 1259237,
      "orderStatus": "INIT",
      "lastModifiedDate": {
        "date": "2024-06-05T14:00:19.433+01",
        "timestamp": 1717592419433
      },
      "createdDate": {
        "date": "2024-05-14T17:05:13.439+01",
        "timestamp": 1715702713439
      },
      "confirmedDate": {},
      "total": 314.9100036621094,
      "totalPaid": 0,
      "tax": {
        "taxRate": 20,
        "taxAmount": 0
      },
      "orderItems": [
        {
          "total": 277.5,
          "itemStatus": "INIT",
          "itemDescription": "100 Folded Leaflet\nSize: A4 (210 mm x 297 mm) - Portrait\nFull-colour printing (front and back), Cross Fold, Gloss Lamination (front and back), 8 sides, 170gsm Silk",
          "viewThisQuoteLink": "/folded?copies=100&productId=3&format=4&paper=5&paperFinish=1&colors=5&coat0=4&colors2=5&coat1=4&simpleFold=5&sides=8&quantity=1¤cy=1&universalKey=100%7E3-fd%7B5c-5c%2B-5d-4f-4l-4l%2B-8s-1st-5sw%7D",
          "problemReports": [],
          "discountTotal": 0,
          "id": "03089bdc-208a-4172-89a2-30585355d7e1",
          "allowReorder": false,
          "itemSpecification": {
            "copies": 100,
            "product": "FOLDED_LEAFLETS",
            "components": [
              {
                "format": 4,
                "standardSize": "NONE",
                "orientation": "PORTRAIT",
                "colours": "PROCESS",
                "substrate": {
                  "typeId": 1,
                  "weightId": 5,
                  "colourId": 0,
                  "design": "NONE"
                },
                "lamination": "GLOSS",
                "foiling": {
                  "gold": false,
                  "silver": false,
                  "copper": false,
                  "red": false,
                  "blue": false,
                  "green": false,
                  "value": ""
                },
                "backColours": "PROCESS",
                "backLamination": "GLOSS",
                "backFoiling": {
                  "gold": false,
                  "silver": false,
                  "copper": false,
                  "red": false,
                  "blue": false,
                  "green": false,
                  "value": ""
                },
                "simpleFold": "CROSS",
                "sides": 8,
                "flatOnDelivery": false,
                "preDrilledHoles": "NONE",
                "componentType": "FOLDED",
                "folded": true,
                "twoSidedComponent": true,
                "laminatedComponent": true,
                "foiledComponent": true,
                "hasCustomSize": false
              }
            ],
            "customSize": false,
            "bound": false,
            "hasFoiling": false
          },
          "universalKey": "100~3-fd{5c-5c+-5d-4f-4l-4l+-8s-1st-5sw}"
        }
      ],
      "discountTotal": 0,
      "totalAfterDiscount": 314.9100036621094
    },
    {
      "id": "6642008181f5201d39761703",
      "orderNumber": 1257543,
      "orderStatus": "PENDING",
      "lastModifiedDate": {
        "date": "2024-05-14T17:04:50.555+01",
        "timestamp": 1715702690555
      },
      "createdDate": {
        "date": "2024-05-13T12:58:57.788+01",
        "timestamp": 1715601537788
      },
      "confirmedDate": {},
      "total": 79.5,
      "totalPaid": 0,
      "tax": {
        "taxRate": 20,
        "taxAmount": 0
      },
      "orderItems": [
        {
          "total": 47,
          "itemStatus": "INIT",
          "itemDescription": "100 Booklets\nSize: A5 (148 mm x 210 mm) - Portrait\nStaple, Full-colour printing, 8 pages, 130gsm Silk",
          "viewThisQuoteLink": "/booklets?copies=100&productId=1&format=5&paper=3&paperFinish=1&colors=5&pages=8&ctype=-1&quantity=1¤cy=1&subProductId=100009&universalKey=100%7E1-bd%7B5c-5f-8p-1st-3sw%7D",
          "problemReports": [],
          "discountTotal": 0,
          "id": "218835d8-6fda-4a98-85fb-b55ddbd8b035",
          "allowReorder": false,
          "itemSpecification": {
            "copies": 100,
            "product": "BROCHURES",
            "components": [
              {
                "format": 5,
                "standardSize": "NONE",
                "orientation": "PORTRAIT",
                "colours": "PROCESS",
                "substrate": {
                  "typeId": 1,
                  "weightId": 3,
                  "colourId": 0,
                  "design": "NONE"
                },
                "lamination": "NONE",
                "pages": 8,
                "binding": {
                  "type": "STAPLED",
                  "edge": "LEFT_RIGHT",
                  "sewn": false,
                  "colour": "BLACK",
                  "loops": "TWO_LOOPS",
                  "headAndTailBands": "NONE"
                },
                "ribbonColour": "NONE",
                "preDrilledHoles": "NONE",
                "componentType": "BOUND",
                "twoSidedComponent": false,
                "laminatedComponent": true,
                "foiledComponent": false,
                "folded": false,
                "hasCustomSize": false
              }
            ],
            "customSize": false,
            "bound": true,
            "hasFoiling": false
          },
          "universalKey": "100~1-bd{5c-5f-8p-1st-3sw}"
        }
      ],
      "discountTotal": 0,
      "totalAfterDiscount": 79.5
    }
  ]
}

Retrieve User Orders

To get a list of orders associated with the user's account, make a GET request to the /api/public/user/orders endpoint.

User Orders API Request
Endpoint:
GET /api/public/user/orders
Example Request:
curl -X 'GET' 'https://mixam.co.uk/api/public/user/orders' \
 -H 'accept: application/json' \
 -H 'Authorization: Bearer YOUR_JWT_TOKEN'
Response:
{
  "orders": [
    {
      "id": "663234f3fc6abb4269dc51b5",
      "orderNumber": 1245944,
      "orderStatus": "DISPATCHED",
      "lastModifiedDate": {
        "date": "2024-05-01T13:46:24.224+01",
        "timestamp": 1714567584224
      },
      "createdDate": {
        "date": "2024-05-01T13:26:27.094+01",
        "timestamp": 1714566387094
      },
      "confirmedDate": {
        "date": "2024-05-01T13:29:07.307+01",
        "timestamp": 1714566547307
      },
      "total": 48.58000183105469,
      "totalPaid": 48.58000183105469,
      "tax": {
        "taxRate": 20,
        "taxAmount": 8.100000381469727
      },
      "orderItems": [
        {
          "total": 12,
          "itemStatus": "INPRODUCTION",
          "status": "LABELED",
          "thumbnailUrl": "https://s3-eu-west-1.amazonaws.com/files.mixam.com/b85d9f4a-b37f-427e-9954-320db0cc6c0c/167b78e7-ac11-496a-a68d-b27cc363a1b3_thumb_1.jpg",
          "itemDescription": "10 Posters\nSize: A3 (297 mm x 420 mm)\nFull-colour printing (outside), 130gsm Silk",
          "viewThisQuoteLink": "/posters?copies=10&productId=4&format=3&paper=3&paperFinish=1&colors=5&quantity=1¤cy=1&universalKey=10%7E4-ft%7B5c-3f-1st-3sw%7D",
          "problemReports": [],
          "discountTotal": 0,
          "id": "3af32416-052f-40b8-99b4-1a5f37b4813b",
          "allowReorder": true,
          "itemSpecification": {
            "copies": 10,
            "product": "POSTERS",
            "components": [
              {
                "format": 3,
                "standardSize": "NONE",
                "orientation": "PORTRAIT",
                "colours": "PROCESS",
                "substrate": {
                  "typeId": 1,
                  "weightId": 3,
                  "colourId": 0,
                  "design": "NONE"
                },
                "lamination": "NONE",
                "foiling": {
                  "gold": false,
                  "silver": false,
                  "copper": false,
                  "red": false,
                  "blue": false,
                  "green": false,
                  "value": ""
                },
                "backColours": "NONE",
                "backLamination": "NONE",
                "backFoiling": {
                  "gold": false,
                  "silver": false,
                  "copper": false,
                  "red": false,
                  "blue": false,
                  "green": false,
                  "value": ""
                },
                "roundCorners": false,
                "preDrilledHoles": "NONE",
                "componentType": "FLAT",
                "twoSidedComponent": true,
                "laminatedComponent": true,
                "foiledComponent": true,
                "folded": false,
                "hasCustomSize": false
              }
            ],
            "customSize": false,
            "bound": false,
            "hasFoiling": false
          },
          "universalKey": "10~4-ft{5c-3f-1st-3sw}"
        }
      ],
      "discountTotal": 0,
      "totalAfterDiscount": 48.58000183105469
    },
    {
      "id": "663232a9fc6abb4269dc51ad",
      "orderNumber": 1245935,
      "orderStatus": "DISPATCHED",
      "lastModifiedDate": {
        "date": "2024-05-01T13:46:26.493+01",
        "timestamp": 1714567586493
      },
      "createdDate": {
        "date": "2024-05-01T13:16:41.053+01",
        "timestamp": 1714565801053
      },
      "confirmedDate": {
        "date": "2024-05-01T13:19:53.728+01",
        "timestamp": 1714565993728
      },
      "total": 25.1900005340576,
      "totalPaid": 25.1900005340576,
      "tax": {
        "taxRate": 20,
        "taxAmount": 4.19999980926514
      },
      "orderItems": [
        {
          "total": 14,
          "itemStatus": "INPRODUCTION",
          "status": "LABELED",
          "thumbnailUrl": "https://s3-eu-west-1.amazonaws.com/files.mixam.com/ecb5d3dc-76e7-46ed-b232-c72001e0ac7f/80dfc043-7752-4c03-b3fb-d337ef105298_thumb_1.jpg",
          "itemDescription": "100 Posters\nSize: A3 (297 mm x 420 mm)\nFull-colour printing (outside), 130gsm Silk",
          "viewThisQuoteLink": "/posters?copies=100&productId=4&format=3&paper=3&paperFinish=1&colors=5&quantity=1¤cy=1&universalKey=100%7E4-ft%7B5c-3f-1st-3sw%7D",
          "problemReports": [],
          "discountTotal": 0,
          "id": "1f52e507-7a01-4f44-9888-55fb9bfd60d5",
          "allowReorder": true,
          "itemSpecification": {
            "copies": 100,
            "product": "POSTERS",
            "components": [
              {
                "format": 3,
                "standardSize": "NONE",
                "orientation": "PORTRAIT",
                "colours": "PROCESS",
                "substrate": {
                  "typeId": 1,
                  "weightId": 3,
                  "colourId": 0,
                  "design": "NONE"
                },
                "lamination": "NONE",
                "foiling": {
                  "gold": false,
                  "silver": false,
                  "copper": false,
                  "red": false,
                  "blue": false,
                  "green": false,
                  "value": ""
                },
                "backColours": "NONE",
                "backLamination": "NONE",
                "backFoiling": {
                  "gold": false,
                  "silver": false,
                  "copper": false,
                  "red": false,
                  "blue": false,
                  "green": false,
                  "value": ""
                },
                "roundCorners": false,
                "preDrilledHoles": "NONE",
                "componentType": "FLAT",
                "twoSidedComponent": true,
                "laminatedComponent": true,
                "foiledComponent": true,
                "folded": false,
                "hasCustomSize": false
              }
            ],
            "customSize": false,
            "bound": false,
            "hasFoiling": false
          },
          "universalKey": "100~4-ft{5c-3f-1st-3sw}"
        }
      ],
      "discountTotal": 0,
      "totalAfterDiscount": 25.1900005340576
    }
  ]
}

Products API

The Products API allows users to retrieve available products and their respective options from the system. This API is crucial for obtaining the necessary metadata required to construct a valid ItemSpecification, which is used to obtain pricing.

Retrieving Available Products

To get the available products, make a GET request to the /api/public/products endpoint. This endpoint returns a list of products along with their options.

Products API - Retrieving Products
Endpoint:
GET /api/public/products
Example Request:
curl -X 'GET' \
  'https://mixam.co.uk/api/public/products' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'
Response:
{
  "products": [
    {
      "id": "63171538b99a9d2503b65953",
      "locale": "en_GB",
      "title": "Activity Book",
      "menuLabel": "Activity Books",
      "description": "

Activity Books are perfect boredom-busters. Whether you print Activity Books for kids to keep them occupied on long-haul flights or Activity Books for adults as a fun way to keep brains active, you can customise every page, and our uncoated paper stocks offer the perfect surface for an array of creative materials, from crayons and pencils to pens. And if you need help formatting your design, you can download free Activity Book templates to get your projects printer-ready.

", "options": [ { "productId": 1, "subProductId": 100031, "title": "Paperback", "imageUrl": "https://d1e8vjamx1ssze.cloudfront.net/price-calculator-product-selector/scactivity-book-soft.png" } ], "quoteType": "QUOTE" }, { "id": "63161004b99a9d2503a0c3b4", "locale": "en_GB", "title": "Art Book", "menuLabel": "Art Books", "description": "

Printing Art Books online is more than just an extension of your work. Whether you’re an artist, designer or creative, it can be an exciting way to reach new audiences beyond the confines of galleries and museums. Expect professional bookbinding and streamlined service with expert print advice whenever you need it. You can also add custom print options like Bookmark Ribbons and Dust Jackets and share a free virtual preview on your website, social media, and email. 

", "options": [ { "productId": 7, "subProductId": 100018, "title": "Hardcover", "imageUrl": "https://d1e8vjamx1ssze.cloudfront.net/coloratura/images/price-calculator/product_selector/7_100018.png" }, { "productId": 1, "subProductId": 100018, "title": "Paperback & Wiro", "imageUrl": "https://d1e8vjamx1ssze.cloudfront.net/coloratura/images/price-calculator/product_selector/1_100018.png" }, { "productId": 15, "subProductId": 100018, "title": "Layflat", "imageUrl": "https://d1e8vjamx1ssze.cloudfront.net/coloratura/images/price-calculator/product_selector/15_100018.png" } ], "quoteType": "QUOTE" }, { "id": "634fd9623c1e5438c9a14721", "locale": "en_GB", "title": "Art Print", "menuLabel": "Art Prints", "description": "

Creating Art Prints online provides the perfect opportunity to get your work in front of more people. Whether you’re an artist, designer or photographer, you can choose from a range of sizes and professional printing options for your wall art. We only deliver top-quality prints, so you can rest assured we'll reproduce your work with high colour accuracy and detail. 

", "options": [ { "productId": 2, "subProductId": 100012, "title": "Art Prints", "imageUrl": "https://d1e8vjamx1ssze.cloudfront.net/price-calculator-product-selector/scartprint.png" } ], "quoteType": "QUOTE" }, ] }

Retrieving Product Metadata

Once you have the productId and subProductId and quoteType from the product options, you can retrieve the metadata for a specific product. This metadata includes all possible components, attributes, and values required to construct a valid ItemSpecification which will be required to retrieve prices for an item or place an order.

Note: You can send the locale attribute as a request attribute if you would like the response to have locale specific language for a supported language ?locale=de_DE

Products Metadata API
Endpoint:
GET /api/public/products/metadata/{productId}/{subProductId}
Example Request:
curl -X 'GET' \
  'https://mixam.co.uk/api/public/products/metadata/7/100018?quoteType=QUOTE' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'
Response:
{
  "productMetadata": {
    "productId": 7,
    "subProductId": 100018,
    "productName": "Hardcover Art Books",
    "boundMetadata": {
      "pagesIncrement": 4,
      "defaultPages": 48,
      "pagesPerLeaf": 2,
      "ribbonMetadata": [
        {
          "ribbonColour": "NONE",
          "colourCode": "none",
          "santaDefault": true,
          "label": "None"
        },
        {
          "ribbonColour": "WHITE",
          "colourCode": "ribcol1",
          "santaDefault": false,
          "label": "White"
        },
        {
          "ribbonColour": "CREAM",
          "colourCode": "ribcol50",
          "santaDefault": false,
          "label": "Ivory"
        },
        {
          "ribbonColour": "GOLD",
          "colourCode": "ribcol678",
          "santaDefault": false,
          "label": "Gold"
        },
        {
          "ribbonColour": "ORANGE",
          "colourCode": "ribcol42",
          "santaDefault": false,
          "label": "Orange"
        },
        {
          "ribbonColour": "RED",
          "colourCode": "ribcol15",
          "santaDefault": false,
          "label": "Bright Red"
        },
        {
          "ribbonColour": "MAROON",
          "colourCode": "ribcol405",
          "santaDefault": false,
          "label": "Maroon"
        },
        {
          "ribbonColour": "PINK",
          "colourCode": "ribcol400",
          "santaDefault": false,
          "label": "Baby Pink"
        },
        {
          "ribbonColour": "PURPLE",
          "colourCode": "ribcol19",
          "santaDefault": false,
          "label": "Purple"
        },
        {
          "ribbonColour": "LIGHT_BLUE",
          "colourCode": "ribcol12",
          "santaDefault": false,
          "label": "Light Blue"
        },
        {
          "ribbonColour": "BLUE",
          "colourCode": "ribcol3",
          "santaDefault": false,
          "label": "Baby Blue"
        },
        {
          "ribbonColour": "NAVY_BLUE",
          "colourCode": "ribcol13",
          "santaDefault": false,
          "label": "Navy Blue"
        },
        {
          "ribbonColour": "GREEN",
          "colourCode": "ribcol56",
          "santaDefault": false,
          "label": "Fresh Green"
        },
        {
          "ribbonColour": "DARK_GREEN",
          "colourCode": "ribcol969",
          "santaDefault": false,
          "label": "Dark Green"
        },
        {
          "ribbonColour": "GREY",
          "colourCode": "ribcol669",
          "santaDefault": false,
          "label": "Grey"
        },
        {
          "ribbonColour": "BLACK",
          "colourCode": "ribcol10",
          "santaDefault": false,
          "label": "Black"
        }
      ],
      "headAndTailBandMetadata": [
        {
          "headAndTailBands": "NONE",
          "colourCode": "none",
          "santaDefault": true,
          "label": "None"
        },
        {
          "headAndTailBands": "NAVY_BLUE_AND_WHITE",
          "colourCode": "9",
          "santaDefault": false,
          "label": "Navy Blue & White"
        },
        {
          "headAndTailBands": "BLACK_AND_GREEN",
          "colourCode": "52",
          "santaDefault": false,
          "label": "Black & Green"
        },
        {
          "headAndTailBands": "RED_AND_BLACK",
          "colourCode": "53",
          "santaDefault": false,
          "label": "Red & Black"
        },
        {
          "headAndTailBands": "PURPLE_AND_WHITE",
          "colourCode": "54",
          "santaDefault": false,
          "label": "Purple & White"
        },
        {
          "headAndTailBands": "RED_AND_GREY",
          "colourCode": "55",
          "santaDefault": false,
          "label": "Red & Grey"
        },
        {
          "headAndTailBands": "RED_AND_WHITE",
          "colourCode": "56",
          "santaDefault": false,
          "label": "Red & White"
        },
        {
          "headAndTailBands": "YELLOW_AND_BROWN",
          "colourCode": "57",
          "santaDefault": false,
          "label": "Yellow & Brown"
        },
        {
          "headAndTailBands": "DARK_BROWN_AND_WHITE",
          "colourCode": "58",
          "santaDefault": false,
          "label": "Dark Brown & White"
        },
        {
          "headAndTailBands": "BLUE_AND_YELLOW",
          "colourCode": "59",
          "santaDefault": false,
          "label": "Blue & Yellow"
        },
        {
          "headAndTailBands": "RED_AND_GREEN",
          "colourCode": "61",
          "santaDefault": false,
          "label": "Red & Green"
        },
        {
          "headAndTailBands": "YELLOW_AND_GREEN",
          "colourCode": "62",
          "santaDefault": false,
          "label": "Yellow & Green"
        },
        {
          "headAndTailBands": "BLUE_AND_WHITE",
          "colourCode": "63",
          "santaDefault": false,
          "label": "Blue & White"
        },
        {
          "headAndTailBands": "DARK_BLUE_AND_WHITE",
          "colourCode": "64",
          "santaDefault": false,
          "label": "Dark Blue & White"
        },
        {
          "headAndTailBands": "RED_AND_YELLOW",
          "colourCode": "65",
          "santaDefault": false,
          "label": "Red & Yellow"
        },
        {
          "headAndTailBands": "MAROON_AND_WHITE",
          "colourCode": "66",
          "santaDefault": false,
          "label": "Maroon & White"
        },
        {
          "headAndTailBands": "YELLOW_AND_BLACK",
          "colourCode": "67",
          "santaDefault": false,
          "label": "Yellow & Black"
        },
        {
          "headAndTailBands": "GREEN_AND_WHITE",
          "colourCode": "68",
          "santaDefault": false,
          "label": "Green & White"
        },
        {
          "headAndTailBands": "BLACK_AND_WHITE",
          "colourCode": "69",
          "santaDefault": false,
          "label": "Black & White"
        },
        {
          "headAndTailBands": "DARK_GREEN_AND_BLACK",
          "colourCode": "71",
          "santaDefault": false,
          "label": "Dark Green & Black"
        },
        {
          "headAndTailBands": "DARK_GREEN_AND_WHITE",
          "colourCode": "72",
          "santaDefault": false,
          "label": "Dark Green & White"
        },
        {
          "headAndTailBands": "RED",
          "colourCode": "105",
          "santaDefault": false,
          "label": "Red"
        },
        {
          "headAndTailBands": "BLACK",
          "colourCode": "108",
          "santaDefault": false,
          "label": "Black"
        },
        {
          "headAndTailBands": "GREY",
          "colourCode": "109",
          "santaDefault": false,
          "label": "Grey"
        },
        {
          "headAndTailBands": "WHITE",
          "colourCode": "117",
          "santaDefault": false,
          "label": "White"
        },
        {
          "headAndTailBands": "DARK_BLUE",
          "colourCode": "118",
          "santaDefault": false,
          "label": "Dark Blue"
        },
        {
          "headAndTailBands": "YELLOW",
          "colourCode": "119",
          "santaDefault": false,
          "label": "Yellow"
        }
      ],
      "endPaperMetadata": [
        {
          "endPaperColour": "WHITE",
          "colourCode": "epcp000",
          "santaDefault": true,
          "colourId": 0,
          "label": "Stock White"
        },
        {
          "endPaperColour": "BLACK",
          "colourCode": "epcp001",
          "santaDefault": false,
          "colourId": 1,
          "label": "Stock Black"
        },
        {
          "endPaperColour": "COLORPLAN_ADRIATIC",
          "colourCode": "epcp010",
          "santaDefault": false,
          "colourId": 10,
          "label": "Adriatic"
        },
        {
          "endPaperColour": "COLORPLAN_AMETHYST",
          "colourCode": "epcp011",
          "santaDefault": false,
          "colourId": 11,
          "label": "Amethyst"
        },
        {
          "endPaperColour": "COLORPLAN_AZURE_BLUE",
          "colourCode": "epcp012",
          "santaDefault": false,
          "colourId": 12,
          "label": "Azure Blue"
        },
        {
          "endPaperColour": "COLORPLAN_BAGHDAD_BROWN",
          "colourCode": "epcp013",
          "santaDefault": false,
          "colourId": 13,
          "label": "Brown"
        },
        {
          "endPaperColour": "COLORPLAN_BITTER_CHOCOLATE",
          "colourCode": "epcp014",
          "santaDefault": false,
          "colourId": 14,
          "label": "Bitter Chocolate"
        },
        {
          "endPaperColour": "COLORPLAN_BRIGHT_RED",
          "colourCode": "epcp015",
          "santaDefault": false,
          "colourId": 15,
          "label": "Bright Red"
        },
        {
          "endPaperColour": "COLORPLAN_BRIGHT_WHITE",
          "colourCode": "epcp016",
          "santaDefault": false,
          "colourId": 16,
          "label": "Bright White"
        },
        {
          "endPaperColour": "COLORPLAN_CANDY_PINK",
          "colourCode": "epcp017",
          "santaDefault": false,
          "colourId": 17,
          "label": "Candy Pink"
        },
        {
          "endPaperColour": "COLORPLAN_CHINA_WHITE",
          "colourCode": "epcp018",
          "santaDefault": false,
          "colourId": 18,
          "label": "China White"
        },
        {
          "endPaperColour": "COLORPLAN_CITRINE",
          "colourCode": "epcp019",
          "santaDefault": false,
          "colourId": 19,
          "label": "Citrine"
        },
        {
          "endPaperColour": "COLORPLAN_CLARET",
          "colourCode": "epcp020",
          "santaDefault": false,
          "colourId": 20,
          "label": "Claret"
        },
        {
          "endPaperColour": "COLORPLAN_COBALT",
          "colourCode": "epcp021",
          "santaDefault": false,
          "colourId": 21,
          "label": "Cobalt"
        },
        {
          "endPaperColour": "COLORPLAN_COOL_BLUE",
          "colourCode": "epcp022",
          "santaDefault": false,
          "colourId": 22,
          "label": "Cool Blue"
        },
        {
          "endPaperColour": "COLORPLAN_COOL_GREY",
          "colourCode": "epcp023",
          "santaDefault": false,
          "colourId": 23,
          "label": "Cool Grey"
        },
        {
          "endPaperColour": "COLORPLAN_DARK_GREY",
          "colourCode": "epcp024",
          "santaDefault": false,
          "colourId": 24,
          "label": "Dark Grey"
        },
        {
          "endPaperColour": "COLORPLAN_EBONY",
          "colourCode": "epcp025",
          "santaDefault": false,
          "colourId": 25,
          "label": "Ebony"
        },
        {
          "endPaperColour": "COLORPLAN_EMERALD",
          "colourCode": "epcp026",
          "santaDefault": false,
          "colourId": 26,
          "label": "Emerald"
        },
        {
          "endPaperColour": "COLORPLAN_FACTORY_YELLOW",
          "colourCode": "epcp027",
          "santaDefault": false,
          "colourId": 27,
          "label": "Factory Yellow"
        },
        {
          "endPaperColour": "COLORPLAN_FOREST",
          "colourCode": "epcp028",
          "santaDefault": false,
          "colourId": 28,
          "label": "Forest"
        },
        {
          "endPaperColour": "COLORPLAN_FUSCHIA_PINK",
          "colourCode": "epcp029",
          "santaDefault": false,
          "colourId": 29,
          "label": "Fuschia Pink"
        },
        {
          "endPaperColour": "COLORPLAN_HARVEST",
          "colourCode": "epcp030",
          "santaDefault": false,
          "colourId": 30,
          "label": "Harvest"
        },
        {
          "endPaperColour": "COLORPLAN_HOT_PINK",
          "colourCode": "epcp031",
          "santaDefault": false,
          "colourId": 31,
          "label": "Hot Pink"
        },
        {
          "endPaperColour": "COLORPLAN_ICE_WHITE",
          "colourCode": "epcp032",
          "santaDefault": false,
          "colourId": 32,
          "label": "Ice White"
        },
        {
          "endPaperColour": "COLORPLAN_IMPERIAL_BLUE",
          "colourCode": "epcp033",
          "santaDefault": false,
          "colourId": 33,
          "label": "Imperial Blue"
        },
        {
          "endPaperColour": "COLORPLAN_LAVENDAR",
          "colourCode": "epcp034",
          "santaDefault": false,
          "colourId": 34,
          "label": "Lavender"
        },
        {
          "endPaperColour": "COLORPLAN_LOCKWOOD_GREEN",
          "colourCode": "epcp035",
          "santaDefault": false,
          "colourId": 35,
          "label": "Lockwood Green"
        },
        {
          "endPaperColour": "COLORPLAN_MANDARIN",
          "colourCode": "epcp036",
          "santaDefault": false,
          "colourId": 36,
          "label": "Mandarin"
        },
        {
          "endPaperColour": "COLORPLAN_MARRS_GREEN",
          "colourCode": "epcp037",
          "santaDefault": false,
          "colourId": 37,
          "label": "Marrs Green"
        },
        {
          "endPaperColour": "COLORPLAN_MID_GREEN",
          "colourCode": "epcp038",
          "santaDefault": false,
          "colourId": 38,
          "label": "Mid Green"
        },
        {
          "endPaperColour": "COLORPLAN_MIST",
          "colourCode": "epcp039",
          "santaDefault": false,
          "colourId": 39,
          "label": "Mist"
        },
        {
          "endPaperColour": "COLORPLAN_NATURAL",
          "colourCode": "epcp040",
          "santaDefault": false,
          "colourId": 40,
          "label": "Natural"
        },
        {
          "endPaperColour": "COLORPLAN_NEW_BLUE",
          "colourCode": "epcp041",
          "santaDefault": false,
          "colourId": 41,
          "label": "New Blue"
        },
        {
          "endPaperColour": "COLORPLAN_NUBUCK_BROWN",
          "colourCode": "epcp042",
          "santaDefault": false,
          "colourId": 42,
          "label": "Nubuck Brown"
        },
        {
          "endPaperColour": "COLORPLAN_PALE_GREY",
          "colourCode": "epcp043",
          "santaDefault": false,
          "colourId": 43,
          "label": "Pale Grey"
        },
        {
          "endPaperColour": "COLORPLAN_PARK_GREEN",
          "colourCode": "epcp044",
          "santaDefault": false,
          "colourId": 44,
          "label": "Park Green"
        },
        {
          "endPaperColour": "COLORPLAN_PISTACHIO",
          "colourCode": "epcp045",
          "santaDefault": false,
          "colourId": 45,
          "label": "Pistachio"
        },
        {
          "endPaperColour": "COLORPLAN_POWDER_GREEN",
          "colourCode": "epcp046",
          "santaDefault": false,
          "colourId": 46,
          "label": "Powder Green"
        },
        {
          "endPaperColour": "COLORPLAN_PRISTINE_WHITE",
          "colourCode": "epcp047",
          "santaDefault": false,
          "colourId": 47,
          "label": "Pristine White"
        },
        {
          "endPaperColour": "COLORPLAN_PURPLE",
          "colourCode": "epcp048",
          "santaDefault": false,
          "colourId": 48,
          "label": "Purple"
        },
        {
          "endPaperColour": "COLORPLAN_RACING_GREEN",
          "colourCode": "epcp049",
          "santaDefault": false,
          "colourId": 49,
          "label": "Racing Green"
        },
        {
          "endPaperColour": "COLORPLAN_REAL_GREY",
          "colourCode": "epcp050",
          "santaDefault": false,
          "colourId": 50,
          "label": "Real Grey"
        },
        {
          "endPaperColour": "COLORPLAN_ROYAL_BLUE",
          "colourCode": "epcp051",
          "santaDefault": false,
          "colourId": 51,
          "label": "Royal Blue"
        },
        {
          "endPaperColour": "COLORPLAN_SAPPHIRE",
          "colourCode": "epcp052",
          "santaDefault": false,
          "colourId": 52,
          "label": "Sapphire"
        },
        {
          "endPaperColour": "COLORPLAN_SCARLET",
          "colourCode": "epcp053",
          "santaDefault": false,
          "colourId": 53,
          "label": "Scarlet"
        },
        {
          "endPaperColour": "COLORPLAN_SMOKE",
          "colourCode": "epcp054",
          "santaDefault": false,
          "colourId": 54,
          "label": "Smoke"
        },
        {
          "endPaperColour": "COLORPLAN_SORBET_YELLOW",
          "colourCode": "epcp055",
          "santaDefault": false,
          "colourId": 55,
          "label": "Sorbet Yellow"
        },
        {
          "endPaperColour": "COLORPLAN_STONE",
          "colourCode": "epcp056",
          "santaDefault": false,
          "colourId": 56,
          "label": "Stone"
        },
        {
          "endPaperColour": "COLORPLAN_TABRIZ_BLUE",
          "colourCode": "epcp057",
          "santaDefault": false,
          "colourId": 57,
          "label": "Tabriz Blue"
        },
        {
          "endPaperColour": "COLORPLAN_TURQUOISE",
          "colourCode": "epcp058",
          "santaDefault": false,
          "colourId": 58,
          "label": "Turquoise"
        },
        {
          "endPaperColour": "COLORPLAN_VELLUM_WHITE",
          "colourCode": "epcp059",
          "santaDefault": false,
          "colourId": 59,
          "label": "Vellum White"
        },
        {
          "endPaperColour": "COLORPLAN_VERMILLION",
          "colourCode": "epcp060",
          "santaDefault": false,
          "colourId": 60,
          "label": "Vermillion"
        },
        {
          "endPaperColour": "COLORPLAN_WHITE_FROST",
          "colourCode": "epcp061",
          "santaDefault": false,
          "colourId": 61,
          "label": "White Frost"
        }
      ],
      "bindingTypeOptions": [
        {
          "bindingType": "CASE",
          "label": "Adhesive Casebound",
          "defaultPages": 48,
          "separateCover": "REQUIRED",
          "preDrilledHoles": "UNAVAILABLE",
          "sewing": "UNAVAILABLE",
          "requiredSubstrate": {
            "typeId": 1,
            "weightId": 5,
            "colourId": 0,
            "design": "NONE"
          },
          "santaDefault": true,
          "supportsEndPapers": true,
          "supportsDustJacket": true,
          "supportsRibbons": true,
          "supportsHeadAndTailBands": true,
          "value": 6,
          "caliper": 5
        },
        {
          "bindingType": "CASE",
          "label": "Smyth Sewn",
          "defaultPages": 48,
          "separateCover": "REQUIRED",
          "preDrilledHoles": "UNAVAILABLE",
          "sewing": "REQUIRED",
          "requiredSubstrate": {
            "typeId": 1,
            "weightId": 5,
            "colourId": 0,
            "design": "NONE"
          },
          "santaDefault": false,
          "supportsEndPapers": true,
          "supportsDustJacket": true,
          "supportsRibbons": true,
          "supportsHeadAndTailBands": true,
          "value": 6,
          "caliper": 5
        }
      ],
      "bindingEdgeOptions": [
        {
          "bindingEdge": "LEFT_RIGHT",
          "santaDefault": false,
          "label": "left right"
        }
      ],
      "supportsSewing": true
    },
    "laminationMetadata": {
      "frontOptions": [],
      "coverOptions": [
        {
          "lamination": "GLOSS",
          "label": "Gloss Lamination",
          "santaDefault": false,
          "value": 4
        },
        {
          "lamination": "MATT",
          "label": "Matt Lamination",
          "santaDefault": false,
          "value": 5
        }
      ],
      "backOptions": [],
      "dustJacketOptions": [
        {
          "lamination": "GLOSS",
          "label": "Gloss Lamination",
          "santaDefault": false,
          "value": 4
        },
        {
          "lamination": "MATT",
          "label": "Matt Lamination",
          "santaDefault": false,
          "value": 5
        }
      ]
    },
    "coverSubstrateTypes": [],
    "copiesMetadata": {
      "initialValue": 1,
      "stepValue": 1,
      "minimumValue": 1
    },
    "substrateDesigns": [],
    "standardSizes": [
      {
        "standardSize": "NONE",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "A4",
        "format": 4,
        "santaValue": "4",
        "secondaryFormat": 0,
        "height": 297,
        "width": 210,
        "label": "A4 (210 mm x 297 mm)"
      },
      {
        "standardSize": "NONE",
        "unitFormat": 0,
        "santaDefault": true,
        "allowFreeTest": false,
        "name": "A5",
        "format": 5,
        "santaValue": "5",
        "secondaryFormat": 0,
        "height": 210,
        "width": 148,
        "label": "A5 (148 mm x 210 mm)"
      },
      {
        "standardSize": "NONE",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "A6",
        "format": 6,
        "santaValue": "6",
        "secondaryFormat": 0,
        "height": 148,
        "width": 105,
        "label": "A6 (105 mm x 148 mm)"
      },
      {
        "standardSize": "IN_8_5_X_11",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "Letter",
        "format": 4,
        "santaValue": "447",
        "secondaryFormat": 47,
        "height": 279,
        "width": 216,
        "label": "Letter (216 mm x 279 mm)"
      },
      {
        "standardSize": "NOVEL",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "Novel",
        "format": 5,
        "santaValue": "501",
        "secondaryFormat": 1,
        "height": 203,
        "width": 127,
        "label": "Novel (127 mm x 203 mm)"
      },
      {
        "standardSize": "STANDARD_BOOK",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "Standard",
        "format": 5,
        "santaValue": "502",
        "secondaryFormat": 2,
        "height": 197,
        "width": 132,
        "label": "Standard (132 mm x 197 mm)"
      },
      {
        "standardSize": "DEMY",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "Demy",
        "format": 4,
        "santaValue": "403",
        "secondaryFormat": 3,
        "height": 216,
        "width": 138,
        "label": "Demy (138 mm x 216 mm)"
      },
      {
        "standardSize": "ROYAL",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "Royal",
        "format": 4,
        "santaValue": "405",
        "secondaryFormat": 5,
        "height": 234,
        "width": 156,
        "label": "Royal (156 mm x 234 mm)"
      },
      {
        "standardSize": "US_ROYAL",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "US Royal",
        "format": 4,
        "santaValue": "404",
        "secondaryFormat": 4,
        "height": 229,
        "width": 152,
        "label": "US Royal (152 mm x 229 mm)"
      },
      {
        "standardSize": "SQUARE_210_MM",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "210mm x 210mm",
        "format": 4,
        "santaValue": "406",
        "secondaryFormat": 6,
        "height": 210,
        "width": 210,
        "label": "210 mm x 210 mm"
      },
      {
        "standardSize": "MM_300_X_300",
        "unitFormat": 0,
        "santaDefault": false,
        "allowFreeTest": false,
        "name": "300mm x 300mm",
        "format": 3,
        "santaValue": "3103",
        "secondaryFormat": 103,
        "height": 300,
        "width": 300,
        "label": "300 mm x 300 mm"
      }
    ],
    "coloursMetadata": {
      "coloursOptions": [
        {
          "label": "Colour",
          "colours": "PROCESS",
          "santaDefault": true,
          "sameAsFront": false
        },
        {
          "label": "Greyscale",
          "colours": "GRAYSCALE",
          "santaDefault": false,
          "sameAsFront": false
        }
      ],
      "backColoursOptions": [],
      "outerCoverColoursOptions": [
        {
          "label": "Colour",
          "colours": "PROCESS",
          "santaDefault": true,
          "sameAsFront": false
        },
        {
          "label": "Greyscale",
          "colours": "GRAYSCALE",
          "santaDefault": false,
          "sameAsFront": false
        }
      ],
      "innerCoverColoursOptions": [
        {
          "label": "None",
          "colours": "NONE",
          "santaDefault": false,
          "sameAsFront": false
        }
      ],
      "jacketColoursOptions": [
        {
          "label": "Colour",
          "colours": "PROCESS",
          "santaDefault": true,
          "sameAsFront": false
        },
        {
          "label": "Greyscale",
          "colours": "GRAYSCALE",
          "santaDefault": false,
          "sameAsFront": false
        }
      ]
    },
    "envelopeSubstrateTypes": [],
    "foilingMetadata": {
      "coverFoiling": [],
      "dustJacketFoiling": [],
      "frontFoiling": [],
      "backFoiling": []
    },
    "preDrilledHolesMetadata": {
      "preDrilledHoleOptions": []
    },
    "shrinkWrapMetadata": {
      "options": []
    },
    "publicationMetadata": {
      "supportsSelfPublishing": false
    },
    "initialSpecification": {
      "copies": 1,
      "product": "BOOK",
      "components": [
        {
          "format": 5,
          "standardSize": "NONE",
          "orientation": "PORTRAIT",
          "colours": "PROCESS",
          "substrate": {
            "typeId": 1,
            "weightId": 3,
            "colourId": 0,
            "design": "NONE"
          },
          "lamination": "NONE",
          "pages": 48,
          "binding": {
            "type": "CASE",
            "edge": "LEFT_RIGHT",
            "sewn": false,
            "colour": "BLACK",
            "loops": "TWO_LOOPS",
            "headAndTailBands": "NONE"
          },
          "ribbonColour": "NONE",
          "preDrilledHoles": "NONE",
          "componentType": "BOUND",
          "laminatedComponent": true,
          "foiledComponent": false,
          "twoSidedComponent": false,
          "folded": false,
          "hasCustomSize": false
        },
        {
          "format": 5,
          "standardSize": "NONE",
          "orientation": "PORTRAIT",
          "colours": "PROCESS",
          "substrate": {
            "typeId": 1,
            "weightId": 5,
            "colourId": 0,
            "design": "NONE"
          },
          "lamination": "GLOSS",
          "foiling": {
            "gold": false,
            "silver": false,
            "copper": false,
            "red": false,
            "blue": false,
            "green": false,
            "value": ""
          },
          "backColours": "NONE",
          "backLamination": "NONE",
          "backFoiling": {
            "gold": false,
            "silver": false,
            "copper": false,
            "red": false,
            "blue": false,
            "green": false,
            "value": ""
          },
          "coverArea": "FRONT_AND_BACK",
          "componentType": "COVER",
          "preDrilledHoles": "NONE",
          "laminatedComponent": true,
          "foiledComponent": true,
          "twoSidedComponent": true,
          "folded": false,
          "hasCustomSize": false
        }
      ],
      "customSize": false,
      "bound": true,
      "hasFoiling": false
    },
    "customSizeMetadata": {
      "minWidth": 105,
      "minHeight": 148,
      "maxWidth": 245,
      "maxHeight": 348,
      "sizeFormat": "METRIC"
    },
    "roundedCorners": "UNAVAILABLE",
    "santaType": "QUOTE",
    "customsExportCode": "4901990000",
    "autoOrientable": false,
    "substrateTypes": [
      {
        "substrateType": "SILK",
        "santaDefault": true,
        "id": 1,
        "substrateColours": [
          {
            "colour": "NONE",
            "weights": [
              {
                "id": 0,
                "weight": 90,
                "gsm": 90,
                "caliper": 0.078,
                "label": "90gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 40,
                    "increment": 4,
                    "max": 1132,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 40,
                    "increment": 4,
                    "max": 1132,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 2,
                "weight": 115,
                "gsm": 115,
                "caliper": 0.097,
                "label": "115gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 36,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 36,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 3,
                "weight": 130,
                "gsm": 130,
                "caliper": 0.109,
                "label": "130gsm",
                "santaDefault": true,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 4,
                "weight": 150,
                "gsm": 150,
                "caliper": 0.126,
                "label": "150gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 16,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 16,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 5,
                "weight": 170,
                "gsm": 170,
                "caliper": 0.145,
                "label": "170gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 16,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 16,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 14,
                "weight": 200,
                "gsm": 200,
                "caliper": 0.172,
                "label": "200gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 24,
                    "increment": 4,
                    "max": 500,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 24,
                    "increment": 4,
                    "max": 500,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              }
            ],
            "id": 0
          }
        ],
        "label": "Silk",
        "allowLamination": true
      },
      {
        "substrateType": "GLOSS",
        "santaDefault": false,
        "id": 2,
        "substrateColours": [
          {
            "colour": "NONE",
            "weights": [
              {
                "id": 0,
                "weight": 90,
                "gsm": 90,
                "caliper": 0.07,
                "label": "90gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 40,
                    "increment": 4,
                    "max": 1100,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 40,
                    "increment": 4,
                    "max": 1100,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 2,
                "weight": 115,
                "gsm": 115,
                "caliper": 0.085,
                "label": "115gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 36,
                    "increment": 4,
                    "max": 1096,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 36,
                    "increment": 4,
                    "max": 1096,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 3,
                "weight": 130,
                "gsm": 130,
                "caliper": 0.094,
                "label": "130gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 4,
                "weight": 150,
                "gsm": 150,
                "caliper": 0.11,
                "label": "150gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 16,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 16,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 5,
                "weight": 170,
                "gsm": 170,
                "caliper": 0.128,
                "label": "170gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 16,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 16,
                    "increment": 4,
                    "max": 1056,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 14,
                "weight": 200,
                "gsm": 200,
                "caliper": 0.152,
                "label": "200gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 24,
                    "increment": 4,
                    "max": 636,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 24,
                    "increment": 4,
                    "max": 636,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              }
            ],
            "id": 0
          }
        ],
        "label": "Gloss",
        "allowLamination": true
      },
      {
        "substrateType": "UNCOATED",
        "santaDefault": false,
        "id": 3,
        "substrateColours": [
          {
            "colour": "NONE",
            "weights": [
              {
                "id": 100,
                "weight": 90,
                "gsm": 90,
                "caliper": 0.097,
                "label": "90gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 40,
                    "increment": 4,
                    "max": 940,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 40,
                    "increment": 4,
                    "max": 940,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 111,
                "weight": 100,
                "gsm": 100,
                "caliper": 0.115,
                "label": "100gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 36,
                    "increment": 4,
                    "max": 940,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 36,
                    "increment": 4,
                    "max": 940,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 112,
                "weight": 120,
                "gsm": 120,
                "caliper": 0.138,
                "label": "120gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 700,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 700,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 104,
                "weight": 150,
                "gsm": 150,
                "caliper": 0.173,
                "label": "150gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 700,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 700,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 105,
                "weight": 170,
                "gsm": 170,
                "caliper": 0.196,
                "label": "170gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 24,
                    "increment": 4,
                    "max": 460,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 24,
                    "increment": 4,
                    "max": 460,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              },
              {
                "id": 113,
                "weight": 200,
                "gsm": 200,
                "caliper": 0.23,
                "label": "200gsm",
                "santaDefault": false,
                "pageCounts": [
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 432,
                    "bindingTypeId": 6
                  },
                  {
                    "bindingType": "CASE",
                    "min": 20,
                    "increment": 4,
                    "max": 432,
                    "bindingTypeId": 6
                  }
                ],
                "unit": "GSM"
              }
            ],
            "id": 0
          }
        ],
        "label": "Uncoated",
        "allowLamination": false
      }
    ]
  }
}

Item Specifications

An ItemSpecification is a data structure used to define the details of an item to be printed without relying on an SKU. This structure allows for a flexible and comprehensive description of the product, ensuring that all necessary attributes are captured accurately.

An ItemSpecification consists of one or more components, depending on the type of product being described. Each component encapsulates specific aspects of the item, ensuring that every detail is meticulously defined.

Structure of an ItemSpecification
  • Copies
    • Field Name: copies
    • Type: Integer
    • Description: Specifies the number of copies to be printed.
    • Example: 100
  • Product ID/Type
    • Field Name: product
    • Type: String
    • Description: Identifies the type of product to be printed.
    • Example: "BROCHURES"
  • Components
    • Field Name: components
    • Type: Array of Component Objects
    • Description: A list of components that make up the item. Each component describes a specific part of the product, such as the cover or internal pages.
Component Object Structure
  • Format
    • Field Name: format
    • Type: Integer
    • Description: Defines the din size of the item. This is an important field, a lot of the pricing calculations and impositions require this field and it must be correct.
    • Example: A1=1, A2=2, A3=3, A4=4, A5=5
  • Standard Size
    • Field Name: standardSize
    • Type: String
    • Description: Indicates if the component uses a standard size (e.g., non DIN size such as US Letter). If you need just a DIN size then this field should be set NONE. You must specifiy the format (DIN) size correctly when using a StandardSize. The product metadata will provide a list of the correct values to use for each size
  • Orientation
    • Field Name: orientation
    • Type: String
    • Description: Specifies the layout orientation of the component (e.g., PORTRAIT).
  • Colours
    • Field Name: colours
    • Type: String
    • Description: Defines the color scheme used for printing (e.g., PROCESS for full-color).
  • Substrate
    • Field Name: substrate
    • Type: Object
    • Description: Contains details about the material used for the component, including type, weight, and color.
    • Type ID: typeId (Integer) - Specifies the substrate type (e.g., Silk, Gloss, Uncoated).
    • Weight ID: weightId (Integer) - Specifies the weight of the substrate.
    • Colour ID: colourId (Integer) - Specifies the color of the substrate.
    • Design: design (String) - Any special design or finish (e.g., NONE).
  • Component Type
    • Field Name: componentType
    • Type: String
    • Description: Indicates the type of the component (e.g., FLAT, FOLDED, BOUND, COVER, END_PAPER, DUST_JACKET).

There are more optional additional attributes available which are optional. Please see the examples below for some real world examples


Example Item Specifications

Posters

Below is a real-world example of a Single Sided Poster in JSON format

Please Note: Posters are automatically orientable and therefore only support PORTRAIT as an orientation, regardless of whether they are to be printed in portrait or landscape. We detect the orientation of the uploaded artwork files and handle this accordingly.

This example translates to the following product specification:

  • Quantity: 200 Posters
  • Size: A3 (297 mm x 420 mm)
  • Printing: Full-colour (process) printing on the front
  • Lamination: Matt Lamination on the front
  • Substrate: 250gsm Silk paper
{
  "itemSpecification": {
    "copies": 200,
    "product": "POSTERS",
    "components": [
      {
        "componentType": "FLAT",
        "format": 3,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 7
        },
        "lamination": "MATT"
      }
    ]
  }
}

Below is a real-world example of a Double Sided Poster in JSON format

This example translates to the following product specification:

  • Quantity: 20 Posters
  • Size: A2 (420 mm x 594 mm) - Portrait
  • Printing: Full-colour (process) printing on both sides
  • Lamination: Gloss Lamination (front and back)
  • Paper: 300gsm Gloss paper
{
  "itemSpecification": {
    "copies": 20,
    "product": "POSTERS",
    "components": [
      {
        "componentType": "FLAT",
        "format": 2,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 2,
          "weightId": 8,
        },
        "backColours": "PROCESS",
        "backLamination": "GLOSS",
        "lamination": "GLOSS"
      }
    ]
  }
}

Booklets

Below is a real-world example of an Saddle Stitch Booklet With Cover in JSON format

This example translates to the following product specification:

  • Quantity: 100 Booklets
  • Size: A4 (210 mm x 297 mm) - Portrait
  • Binding: Staple binding
  • Printing: Full-colour (process) printing
  • Internal Pages:
    • 32 pages
    • 130gsm Silk paper
    • No lamination
  • Cover:
    • Full-colour (process) printing on both front and back
    • Gloss Lamination on the outside
    • 250gsm Gloss paper
{
  "itemSpecification": {
    "copies": 100,
    "product": "BROCHURES",
    "components": [
      {
        "componentType": "BOUND",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 3,
        },
        "pages": 32,
        "binding": {
          "type": "STAPLED"
        },
      },
      {
        "componentType": "COVER",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 2,
          "weightId": 7,
        },
        "lamination": "GLOSS",
        "backColours": "PROCESS"
      }
    ]
  }
}

Below is a real-world example of an Saddle Stitch Booklet Without Cover (Self Cover) in JSON format

This example translates to the following product specification:

  • Quantity: 100 Booklets
  • Size: Letter (216 mm x 279 mm | 8.5" x 11") - Portrait
  • Binding: Staple binding
  • Printing: Grayscale printing
  • Internal Pages:
    • 48 pages
    • 100gsm Uncoated paper
    • No lamination
{
  "itemSpecification": {
    "copies": 100,
    "product": "BROCHURES",
    "components": [
      {
        "componentType": "BOUND",
        "format": 4,
        "standardSize": "IN_8_5_X_11",
        "orientation": "PORTRAIT",
        "colours": "GRAYSCALE",
        "substrate": {
          "typeId": 3,
          "weightId": 111
        },
        "pages": 48,
        "binding": {
          "type": "STAPLED"
        }
      }
    ]
  }
}

Below is a real-world example of a Wiro Bound Booklet With Gold Foil Cover in JSON format:

Please Note: Foiling is only supported for one colour at a time currently. Support for multiple foiling layers may be available in the future.

This example translates to the following product specification:

  • Quantity: 100 Wiro Bound Booklets
  • Size: A5 (148 mm x 210 mm) - Portrait
  • Binding: Wiro binding (colour: silver)
  • Printing: Full-colour (process) printing
  • Internal Pages:
    • 100 pages
    • 130gsm Silk paper
    • No lamination
  • Cover:
    • Full-colour (process) printing on both front and back
    • Gold foiling on the outside
    • Matt Anti Scuff Lamination on the outside
    • 250gsm Silk paper
{
  "itemSpecification": {
    "copies": 100,
    "product": "BROCHURES",
    "components": [
      {
        "componentType": "BOUND",
        "format": 5,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 3
        },
        "pages": 100,
        "binding": {
          "type": "WIRO",
          "edge": "LEFT_RIGHT",
          "colour": "SILVER"
        }
      },
      {
        "componentType": "COVER",
        "format": 5,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 7
        },
        "foiling": {
          "gold": true
        },
        "lamination": "MATT_ANTI_SCUFF",
        "backColours": "PROCESS"
      }
    ]
  }
}

Books

Below is a real-world example of a Paperback Book (PUR) in JSON format

This example translates to the following product specification:

  • Quantity: 10 Paperback Photo Quality Books
  • Size: A5 (148 mm x 210 mm) - Portrait
  • Binding: Perfect (PUR) binding
  • Printing: Grayscale printing
  • Internal Pages:
    • 200 pages
    • 130gsm Silk paper
    • No lamination
  • Cover:
    • Full-colour (process) printing on both front and back
    • Soft-Touch Lamination (outside)
    • 250gsm Silk paper
{
  "itemSpecification": {
    "copies": 10,
    "product": "BROCHURES",
    "components": [
      {
        "componentType": "BOUND",
        "format": 5,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "GRAYSCALE",
        "substrate": {
          "typeId": 1,
          "weightId": 3
        },
        "pages": 200,
        "binding": {
          "type": "PUR"
        }
      },
      {
        "componentType": "COVER",
        "format": 5,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 7
        },
        "lamination": "SOFT",
        "backColours": "PROCESS"
      }
    ]
  }
}

Below is a real-world example of a Hardcover Photo Quality Book in JSON format

This example translates to the following product specification:

  • Quantity: 5 Hardcover Photo Quality Books
  • Size: Letter (216 mm x 279 mm | 8.5" x 11") - Portrait
  • Binding: Adhesive Casebound
  • Printing: Full-colour (process) printing
  • Internal Pages:
    • 200 pages
    • 200gsm Silk paper
  • Cover:
    • Full-colour (process) printing on the outside
    • Matt Lamination on the outside
  • End Papers:
    • Stock Black
{
  "itemSpecification": {
    "copies": 5,
    "product": "BOOK",
    "components": [
      {
        "componentType": "BOUND",
        "format": 4,
        "standardSize": "IN_8_5_X_11",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 14,
        },
        "pages": 200,
        "binding": {
          "type": "CASE"
        }
      },
      {
        "componentType": "COVER",
        "format": 4,
        "standardSize": "IN_8_5_X_11",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 5,
        },
        "lamination": "MATT"
      },
      {
        "componentType": "END_PAPERS",
        "format": 4,
        "standardSize": "IN_8_5_X_11",
        "orientation": "PORTRAIT",
        "colours": "NONE",
        "substrate": {
          "typeId": 0,
          "weightId": 0,
          "colourId": 1,
        }
      }
    ]
  }
}

Below is a real-world example of a Hardcover Photo Quality Book with Dust Jacket, Head & Tail Band & Ribbon in JSON format

This example translates to the following product specification:

  • Quantity: 10 Hardcover Photo Quality Books
  • Size: US Royal (152 mm x 229 mm) - Portrait
  • Binding: Adhesive Casebound with Red & Black head and tail bands
  • Printing: Grayscale printing
  • Internal Pages:
    • 200 pages
    • 130gsm Silk paper
    • No lamination
    • Bright Red ribbon
  • Cover:
    • Full-colour (process) printing on the outside
    • Matt Lamination on the outside
  • End Papers:
    • Bright Red
  • Dust Jacket:
    • Full-colour (process) printing
    • Gloss Lamination
{
  "itemSpecification": {
    "copies": 10,
    "product": "BOOK",
    "components": [
      {
        "componentType": "BOUND",
        "format": 4,
        "standardSize": "US_ROYAL",
        "orientation": "PORTRAIT",
        "colours": "GRAYSCALE",
        "substrate": {
          "typeId": 1,
          "weightId": 3,
        },
        "pages": 200,
        "binding": {
          "type": "CASE",
          "headAndTailBands": "RED_AND_BLACK"
        },
        "ribbonColour": "RED"
      },
      {
        "componentType": "COVER",
        "format": 4,
        "standardSize": "US_ROYAL",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 5,
        },
        "lamination": "MATT"
      },
      {
        "componentType": "END_PAPERS",
        "format": 4,
        "standardSize": "US_ROYAL",
        "orientation": "PORTRAIT",
        "colours": "NONE",
        "substrate": {
          "typeId": 0,
          "weightId": 0,
          "colourId": 15,
        }
      },
      {
        "componentType": "DUST_JACKET",
        "format": 4,
        "standardSize": "US_ROYAL",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 0,
          "weightId": 0,
        },
        "lamination": "GLOSS"
      }
    ]
  }
}

Below is a real-world example of Softcover Layflat Books in JSON format

This example translates to the following product specification:

  • Quantity: 10 Paperback Layflat Books
  • Size: A4 (210 mm x 297 mm) - Portrait
  • Binding: Softcover
  • Printing: Full-colour printing
  • Finish: Gloss Lamination
  • Internal Pages:
    • 48 pages
    • 170gsm Silk paper
  • Cover:
    • Full-colour printing (outside)
    • Gloss Lamination (outside)
    • 300gsm Silk paper
{
  "itemSpecification": {
    "copies": 10,
    "product": "LAYFLAT_BOOKS",
    "components": [
      {
        "componentType": "BOUND",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 5
        },
        "pages": 48,
        "lamination": "GLOSS",
        "binding": {
          "type": "PUR"
        }
      },
      {
        "componentType": "COVER",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 8
        },
        "lamination": "GLOSS"
      }
    ]
  }
}

Below is a real-world example of a Hardcover Layflat Book in JSON format

This example translates to the following product specification:

  • Quantity: 5 Hardcover Layflat Books
  • Size: A4 (210 mm x 297 mm) - Landscape
  • Binding: Hardcover
  • Printing: Full-colour printing
  • Finish: Matt Lamination
  • Internal Pages:
    • 48 pages
    • 170gsm Silk paper
  • Cover:
    • Full-colour printing (outside)
    • Matt Lamination (outside)
{
  "itemSpecification": {
    "copies": 5,
    "product": "LAYFLAT_BOOKS",
    "components": [
      {
        "componentType": "BOUND",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "LANDSCAPE",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 5
        },
        "pages": 48,
        "lamination": "MATT",
        "binding": {
          "type": "CASE"
        }
      },
      {
        "componentType": "COVER",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "LANDSCAPE",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 5
        },
        "lamination": "MATT"
      }
    ]
  }
}

Bookmarks

Below is a real-world example of a Bookmark With Drill Hole in JSON format

This example translates to the following product specification:

  • Quantity: 100 Bookmarks
  • Size: 52 mm x 210 mm - Portrait
  • Printing: Full-colour (process) printing on both front and back
  • Finishing:
    • Hole drilling: Single Hole Top Centre
    • Gloss Lamination on the outside
  • Paper: 400gsm Gloss
{
  "itemSpecification": {
    "copies": 100,
    "product": "FLYERS",
    "components": [
      {
        "componentType": "FLAT",
        "format": 5,
        "standardSize": "MM_52_X_210",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 2,
          "weightId": 13,
        },
        "backColours": "PROCESS",
        "lamination": "GLOSS",
        "preDrilledHoles": "ONE_HOLE_TOP_CENTER"
      }
    ]
  }
}

Business Cards

Below is a real-world example of a Single Sided Business Card With Rounded Corners in JSON format

This example translates to the following product specification:

  • Quantity: 500 Business Cards
  • Size: Business Card (55 mm x 85 mm) - Landscape
  • Printing: Full-colour printing (outside)
  • Finish: Rounded Corners
  • Paper: 350gsm Silk
{
  "itemSpecification": {
    "copies": 500,
    "product": "BUSINESS_CARDS",
    "components": [
      {
        "componentType": "FLAT",
        "format": 7,
        "standardSize": "BUSINESS_CARD",
        "orientation": "LANDSCAPE",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 9,
        },
        "roundCorners": true
      }
    ]
  }
}

Below is a real-world example of a Double Sided Business Card in JSON format

This example translates to the following product specification:

  • Quantity: 500 Business Cards
  • Size: Business Card (55 mm x 85 mm) - Landscape
  • Printing: Full-colour printing (front and back)
  • Finish: Matt Lamination (outside)
  • Paper: 400gsm Silk
{
  "itemSpecification": {
    "copies": 500,
    "product": "BUSINESS_CARDS",
    "components": [
      {
        "componentType": "FLAT",
        "format": 7,
        "standardSize": "BUSINESS_CARD",
        "orientation": "LANDSCAPE",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 13
        },
        "lamination": "MATT",
        "backColours": "PROCESS"
      }
    ]
  }
}

Canvases

Below is a real-world example of a Canvas in JSON format

This example translates to the following product specification:

  • Quantity: 1 Canvas
  • Size: 200 mm x 200 mm - Portrait
  • Printing: Full-colour printing
  • Frame: 38 mm frame
  • Material: 260gsm Polyester
{
  "itemSpecification": {
    "copies": 1,
    "product": "CANVAS",
    "components": [
      {
        "componentType": "FRAMED",
        "format": 4,
        "standardSize": "MM_200_X_200",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 56,
          "weightId": 55000,
          "colourId": 0,
          "design": "NONE"
        },
        "frameDepth": "MM_38"
      }
    ]
  }
}

Calendars

Below is a real-world example of a Wiro Wall Calendar With Drill Hole & Top/ Bottom Binding in JSON format

This example translates to the following product specification:

  • Quantity: 1 Wiro Wall Calendar With Drill Hole
  • Size: A4 (210 mm x 297 mm) - Portrait
  • Binding: Wiro (colour: black), Top/Bottom Binding Edge
  • Printing: Full-colour printing
  • Internal Pages:
    • 24 pages
    • 130gsm Gloss paper
    • Hole drilling (Single Hole Centred)
  • Cover:
    • Full-colour printing (front and back)
    • Gloss Lamination (outside)
    • 250gsm Silk paper
    • Hole drilling (Single Hole Centred)
{
  "itemSpecification": {
    "copies": 1,
    "product": "BROCHURES",
    "components": [
      {
        "componentType": "BOUND",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 2,
          "weightId": 3
        },
        "preDrilledHoles": "ONE_HOLE_OPPOSITE_BINDING_CENTER",
        "pages": 24,
        "binding": {
          "type": "WIRO",
          "edge": "TOP_BOTTOM"
        }
      },
      {
        "componentType": "COVER",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 7
        },
        "preDrilledHoles": "ONE_HOLE_OPPOSITE_BINDING_CENTER",
        "lamination": "GLOSS",
        "backColours": "PROCESS"
      }
    ]
  }
}

Below is a real-world example of a Stapled Wall Calendar With Drill Hole & Top/Bottom Binding in JSON format

This example translates to the following product specification:

  • Quantity: 1 Stapled Wall Calendar
  • Size: A4 (210 mm x 297 mm) - Portrait
  • Binding: Staple, Top/Bottom Binding Edge
  • Printing: Full-colour printing
  • Internal Pages:
    • 24 pages
    • 130gsm Silk paper
    • Hole drilling (Single Hole Centred)
  • Cover:
    • Full-colour printing (front and back)
    • Matt Lamination (outside)
    • 250gsm Silk paper
    • Hole drilling (Single Hole Centred)
{
  "itemSpecification": {
    "copies": 1,
    "product": "BROCHURES",
    "components": [
      {
        "componentType": "BOUND",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 3
        },
        "preDrilledHoles": "ONE_HOLE_OPPOSITE_BINDING_CENTER",
        "pages": 24,
        "binding": {
          "type": "STAPLED",
          "edge": "TOP_BOTTOM"
        }
      },
      {
        "componentType": "COVER",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 7
        },
        "preDrilledHoles": "ONE_HOLE_OPPOSITE_BINDING_CENTER",
        "lamination": "MATT",
        "backColours": "PROCESS"
      }
    ]
  }
}

Below is a real-world example of Desk Calendars With Top/Bottom Binding in JSON format

This example translates to the following product specification:

  • Quantity: 10 Desk Calendars
  • Size: A5 (148 mm x 210 mm) - Portrait
  • Binding: Wiro (colour: black), Top/Bottom binding edge
  • Printing: Full-colour printing
  • Pages: 14 pages, 200gsm Silk
{
  "itemSpecification": {
    "copies": 10,
    "product": "VR_DESK_CALENDARS",
    "components": [
      {
        "componentType": "BOUND",
        "format": 5,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 14
        },
        "folded": false,
        "pages": 14,
        "binding": {
          "type": "CALENDAR_WIRO",
          "edge": "TOP_BOTTOM",
          "colour": "BLACK"
        }
      }
    ]
  }
}

Postcards

Below is a real-world example of Postcards in JSON format

This example translates to the following product specification:

  • Quantity: 500 Postcards
  • Size: A6 (105 mm x 148 mm) - Landscape
  • Printing: Full-colour printing (front and back)
  • Lamination: Gloss Lamination (front only)
  • Paper: 300gsm Silk
{
  "itemSpecification": {
    "copies": 500,
    "product": "POSTCARDS",
    "components": [
      {
        "componentType": "FLAT",
        "format": 6,
        "standardSize": "NONE",
        "orientation": "LANDSCAPE",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 8
        },
        "backColours": "PROCESS",
        "lamination": "GLOSS"
      }
    ]
  }
}

Greetings Cards

Below is a real-world example of a Greeting Card in JSON format

This example translates to the following product specification:

  • Quantity: 100 Greeting Cards
  • Size: DL Small (99 mm x 210 mm) - Portrait
  • Printing: Full-colour printing (front and back)
  • Folding: Half Fold
  • Sides: 4 sides
  • Paper: 350gsm Uncoated
{
  "itemSpecification": {
    "copies": 100,
    "product": "GREETING_CARDS",
    "components": [
      {
        "componentType": "FOLDED",
        "format": 4,
        "standardSize": "DL_SMALL_99_MM",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 3,
          "weightId": 109
        },
        "sides": 4,
        "simpleFold": "HALF"
      }
    ]
  }
}

Below is a real-world example of a Greeting Card With Envelope in JSON format

This example translates to the following product specification:

  • Quantity: 100 Greeting Cards
  • Size: A6 (105 mm x 148 mm) - Portrait
  • Printing: Full-colour printing (front and back)
  • Folding: Half Fold
  • Lamination: Gloss Lamination (outside)
  • Sides: 4 sides
  • Paper: 350gsm Silk
  • Envelope: 100gsm Uncoated
{
  "itemSpecification": {
    "copies": 100,
    "product": "GREETING_CARDS",
    "components": [
      {
        "componentType": "FOLDED",
        "format": 6,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 9
        },
        "sides": 4,
        "simpleFold": "HALF",
        "lamination": "GLOSS"
      },
      {
        "componentType": "ENVELOPE"
        "format": 6,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "substrate": {
          "typeId": 3,
          "weightId": 111
        }
      }
    ]
  }
}

Folded Leaflets

Below is a real-world example of Folded Leaflets With Roll Fold 6 Panels in JSON format

This example translates to the following product specification:

  • Quantity: 100 Folded Leaflet
  • Size: A4 (210 mm x 297 mm) - Portrait
  • Printing: Full-colour printing (front and back)
  • Folding: Roll Fold
  • Sides: 6 sides
  • Paper: 150gsm Silk
{
  "itemSpecification": {
    "copies": 100,
    "product": "FOLDED_LEAFLETS",
    "components": [
      {
        "componentType": "FOLDED",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 4
        },
        "folded": true,
        "sides": 6,
        "simpleFold": "ROLE"
      }
    ]
  }
}

Below is a real-world example of a Folded Leaflet With Z Fold 6 Panels in JSON format

This example translates to the following product specification:

  • Quantity: 100 Folded Leaflet
  • Size: A4 (210 mm x 297 mm) - Portrait
  • Printing: Full-colour printing (front and back)
  • Folding: Z-Fold
  • Sides: 6 sides
  • Paper: 130gsm Gloss
{
  "itemSpecification": {
    "copies": 100,
    "product": "FOLDED_LEAFLETS",
    "components": [
      {
        "componentType": "FOLDED",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 2,
          "weightId": 3
        },
        "sides": 6,
        "simpleFold": "Z"
      }
    ]
  }
}

Below is a real-world example of a Folded Leaflet With Gate Fold 6 Panels in JSON format

This example translates to the following product specification:

  • Quantity: 100 Folded Leaflet
  • Size: A4 (210 mm x 297 mm) - Portrait
  • Printing: Full-colour printing (front and back)
  • Folding: Gate Fold
  • Sides: 6 sides
  • Paper: 130gsm Silk
{
  "itemSpecification": {
    "copies": 100,
    "product": "FOLDED_LEAFLETS",
    "components": [
      {
        "componentType": "FOLDED",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 3
        },
        "sides": 6,
        "simpleFold": "GATE"
      }
    ]
  }
}

Below is a real-world example of a Folded Leaflet 8 Panel Cross Fold in JSON format

This example translates to the following product specification:

  • Quantity: 100 Folded Leaflet
  • Size: A4 (210 mm x 297 mm) - Portrait
  • Printing: Full-colour printing (front and back)
  • Folding: Cross Fold
  • Lamination: Gloss Lamination (front and back)
  • Sides: 8 sides
  • Paper: 170gsm Silk
{
  "itemSpecification": {
    "copies": 100,
    "product": "FOLDED_LEAFLETS",
    "components": [
      {
        "componentType": "FOLDED",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 5
        },
        "sides": 8,
        "simpleFold": "CROSS",
        "lamination": "GLOSS",
        "backLamination": "GLOSS"
      }
    ]
  }
}

Offers API

The Offers API allows users to obtain multiple price offers for a given item specification. This API is essential for retrieving pricing details based on specific product configurations.


Obtaining Price Offers

To obtain price offers, make a POST request to the /api/public/offers endpoint. This endpoint returns a list of price offers based on the provided item specification.

Process Flow
Offer API Request
Request Attributes
Attribute Required Type Description
productId Yes Integer The ID of the product.
subProductId Yes Integer The ID of the sub-product.
productName Yes String The name of the product. This can be anything you like such as 'My Awesome Comicbook'
quoteType Yes String The type of quote. The default of QUOTE should be used in most instances unless instructed otherwise
itemSpecification Yes Object The descriptor of the item being ordered, please see the Item Specification documentation for examples
Endpoint:
POST /api/public/offers
Example Request:
curl -X 'POST' \
  'https://mixam.co.uk/api/public/offers' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "productId": 1,
  "subProductId": 100002,
  "productName": "My Awesome Comic Book",
  "quoteType": "QUOTE",
  "itemSpecification": {
    "copies": 10,
    "product": "BROCHURES",
    "components": [
      {
        "componentType": "BOUND",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 3,
          "colourId": 0
        },
        "pages": 200,
        "lamination": "NONE",
        "binding": {
          "type": "PUR"
        }
      },
      {
        "componentType": "COVER",
        "format": 4,
        "standardSize": "NONE",
        "orientation": "PORTRAIT",
        "colours": "PROCESS",
        "substrate": {
          "typeId": 1,
          "weightId": 7,
          "colourId": 0
        },
        "lamination": "GLOSS",
        "backColours": "PROCESS",
        "backLamination": "NONE"
      }
    ]
  }
}'
Response:
{
  "weight": 8.399999618530273,
  "weightKg": 8.399999618530273,
  "turnaroundMin": 2,
  "turnaroundMax": 3,
  "spine": 12,
  "offers": [
    {
      "offerId": "89153C02732744223ED13A69AEDBF9D6",
      "price": 122,
      "productionDays": 4,
      "pressType": "Canon iX",
      "includeShipment": false,
      "printType": "INKJET",
      "printQuality": "PREMIUM",
      "countryOfOrigin": "GB",
      "currencyCode": "GBP",
      "bestTime": false,
      "express": false,
      "bestPrice": true
    },
    {
      "offerId": "9CBFC331CBC7EB45F745543C75B66A70",
      "price": 142,
      "productionDays": 3,
      "pressType": "Indigo 12000",
      "includeShipment": false,
      "printType": "DIGITAL",
      "printQuality": "PREMIUM",
      "countryOfOrigin": "GB",
      "currencyCode": "GBP",
      "bestTime": true,
      "express": false,
      "bestPrice": false
    }
  ],
  "vat": {
    "rate": 20,
    "included": false,
    "fixed": false,
    "vatCountryCodes": []
  },
  "forceVatable": false,
  "includeShipment": false,
  "universalKey": "10~1-bd{4bt-5c-4f-200p-1st-3sw}-cr{5c-5c+-4f-4l-1st-7sw}",
  "packagingCost": 0,
  "printOnDemandAvailable": true,
  "quoteLink": "https://mixam.co.uk/paperbackbooks?copies=10&productId=1&format=4&paper=3&paperFinish=1&colors=5&pages=200&bind=4&coat2=4&ctype=7&coverPaperFinish=1&ccolors=5&ccolors2=5&quantity=1¤cy=1&subProductId=100002&universalKey=10%7E1-bd%7B4bt-5c-4f-200p-1st-3sw%7D-cr%7B5c-5c%2B-4f-4l-1st-7sw%7D"
}

Catalogue API

The Catalogue API provides a comprehensive overview of the available options for various products on the site. This includes not only paper types and weights but also information about product categories, sizes, colors, binding types, laminations, and much more. It is an essential tool for understanding the full range of customization options available for printing products.

Please Note: The catalogue is different for each of our sites and will return data depending on what options we have available for the given market.


Retrieving the Catalogue

To get the catalogue, make a GET request to the /api/public/catalogue endpoint.

Catalogue API Request
Endpoint:
GET /api/public/catalogue
Example Request:
curl -X 'GET' \
  'https://mixam.co.uk/api/public/catalogue' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'
Response:
{
  "products": {
    "1": "BROCHURES",
    "2": "FLYERS",
    "3": "FOLDED_LEAFLETS",
    "4": "POSTERS",
    "5": "LETTERHEADS",
    "6": "PHOTO_BOOKS",
    "7": "BOOK",
    "8": "BUSINESS_CARDS",
    "9": "POSTCARDS",
    "10": "GREETING_CARDS",
    "11": "NOTE_BOOKS",
    "12": "COMPLIMENT_SLIPS",
    "13": "ENVELOPES",
    "14": "FOLDERS",
    "15": "LAYFLAT_BOOKS",
    "16": "WALL_CALENDARS",
    "17": "DESK_CALENDARS",
    "18": "VR_WALL_CALENDARS",
    "19": "VR_DESK_CALENDARS",
    "20": "TRADITIONAL_BOOKS",
    "21": "CANVAS"
  },
  "dinSizes": {
    "0": [
      {
        "width": 841,
        "height": 1189,
        "unitType": "MILLIMETERS",
        "label": "A0"
      },
      {
        "width": 33.11,
        "height": 46.811,
        "unitType": "INCHES",
        "label": "A0"
      }
    ],
    "1": [
      {
        "width": 594,
        "height": 841,
        "unitType": "MILLIMETERS",
        "label": "A1"
      },
      {
        "width": 23.386,
        "height": 33.11,
        "unitType": "INCHES",
        "label": "A1"
      }
    ],
    "2": [
      {
        "width": 420,
        "height": 594,
        "unitType": "MILLIMETERS",
        "label": "A2"
      },
      {
        "width": 16.535,
        "height": 23.386,
        "unitType": "INCHES",
        "label": "A2"
      }
    ],
    "3": [
      {
        "width": 297,
        "height": 420,
        "unitType": "MILLIMETERS",
        "label": "A3"
      },
      {
        "width": 11.693,
        "height": 16.535,
        "unitType": "INCHES",
        "label": "A3"
      }
    ],
    "4": [
      {
        "width": 210,
        "height": 297,
        "unitType": "MILLIMETERS",
        "label": "A4"
      },
      {
        "width": 8.268,
        "height": 11.693,
        "unitType": "INCHES",
        "label": "A4"
      }
    ],
    "5": [
      {
        "width": 148,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "A5"
      },
      {
        "width": 5.827,
        "height": 8.268,
        "unitType": "INCHES",
        "label": "A5"
      }
    ],
    "6": [
      {
        "width": 105,
        "height": 148,
        "unitType": "MILLIMETERS",
        "label": "A6"
      },
      {
        "width": 4.134,
        "height": 5.827,
        "unitType": "INCHES",
        "label": "A6"
      }
    ],
    "7": [
      {
        "width": 74,
        "height": 105,
        "unitType": "MILLIMETERS",
        "label": "A7"
      },
      {
        "width": 2.913,
        "height": 4.134,
        "unitType": "INCHES",
        "label": "A7"
      }
    ]
  },
  "standardSizes": {
    "SQUARE_35_MM": [
      {
        "width": 35,
        "height": 35,
        "unitType": "MILLIMETERS",
        "label": "35mm x 35mm"
      },
      {
        "width": 1.378,
        "height": 1.378,
        "unitType": "INCHES",
        "label": "1.378\" x 1.378\""
      }
    ],
    "MM_21_X_68": [
      {
        "width": 21,
        "height": 68,
        "unitType": "MILLIMETERS",
        "label": "21mm x 68mm"
      },
      {
        "width": 0.827,
        "height": 2.677,
        "unitType": "INCHES",
        "label": "0.827\" x 2.677\""
      }
    ],
    "IN_8_75_X_11": [
      {
        "width": 222,
        "height": 279,
        "unitType": "MILLIMETERS",
        "label": "222mm x 279mm"
      },
      {
        "width": 8.75,
        "height": 11,
        "unitType": "INCHES",
        "label": "8.75\" x 11\""
      }
    ],
    "SQUARE_70_MM": [
      {
        "width": 70,
        "height": 70,
        "unitType": "MILLIMETERS",
        "label": "70mm x 70mm"
      },
      {
        "width": 2.756,
        "height": 2.756,
        "unitType": "INCHES",
        "label": "2.756\" x 2.756\""
      }
    ],
    "SQUARE_120_MM": [
      {
        "width": 120,
        "height": 120,
        "unitType": "MILLIMETERS",
        "label": "120mm x 120mm"
      },
      {
        "width": 4.724,
        "height": 4.724,
        "unitType": "INCHES",
        "label": "4.724\" x 4.724\""
      }
    ],
    "A7_LONG": [
      {
        "width": 52,
        "height": 149,
        "unitType": "MILLIMETERS",
        "label": "A7 Long"
      },
      {
        "width": 2.047,
        "height": 5.866,
        "unitType": "INCHES",
        "label": "A7 Long"
      }
    ],
    "A5_LONG": [
      {
        "width": 105,
        "height": 297,
        "unitType": "MILLIMETERS",
        "label": "A5 Long"
      },
      {
        "width": 4.13,
        "height": 11.69,
        "unitType": "INCHES",
        "label": "A5 Long"
      }
    ],
    "IN_2_X_6": [
      {
        "width": 51,
        "height": 152,
        "unitType": "MILLIMETERS",
        "label": "51mm x 152mm"
      },
      {
        "width": 2,
        "height": 6,
        "unitType": "INCHES",
        "label": "2\" x 6\""
      }
    ],
    "MM_150_X_265": [
      {
        "width": 150,
        "height": 265,
        "unitType": "MILLIMETERS",
        "label": "150mm x 265mm"
      },
      {
        "width": 5.906,
        "height": 10.433,
        "unitType": "INCHES",
        "label": "5.906\" x 10.433\""
      }
    ],
    "IN_12_X_18": [
      {
        "width": 305,
        "height": 457,
        "unitType": "MILLIMETERS",
        "label": "305mm x 457mm"
      },
      {
        "width": 12,
        "height": 18,
        "unitType": "INCHES",
        "label": "12\" x 18\""
      }
    ],
    "IN_40_X_60": [
      {
        "width": 1016,
        "height": 1524,
        "unitType": "MILLIMETERS",
        "label": "1016mm x 1524mm"
      },
      {
        "width": 40,
        "height": 60,
        "unitType": "INCHES",
        "label": "40\" x 60\""
      }
    ],
    "MM_52_X_210": [
      {
        "width": 52,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "52mm x 210mm"
      },
      {
        "width": 2.047,
        "height": 8.268,
        "unitType": "INCHES",
        "label": "2.047\" x 8.268\""
      }
    ],
    "SQUARE_8_5_IN": [
      {
        "width": 216,
        "height": 216,
        "unitType": "MILLIMETERS",
        "label": "216mm x 216mm"
      },
      {
        "width": 8.5,
        "height": 8.5,
        "unitType": "INCHES",
        "label": "8.5\" x 8.5\""
      }
    ],
    "MM_750_X_750": [
      {
        "width": 750,
        "height": 750,
        "unitType": "MILLIMETERS",
        "label": "750mm x 750mm"
      },
      {
        "width": 29.528,
        "height": 29.528,
        "unitType": "INCHES",
        "label": "29.528\" x 29.528\""
      }
    ],
    "SQUARE_4_75_IN": [
      {
        "width": 121,
        "height": 121,
        "unitType": "MILLIMETERS",
        "label": "121mm x 121mm"
      },
      {
        "width": 4.75,
        "height": 4.75,
        "unitType": "INCHES",
        "label": "4.75\" x 4.75\""
      }
    ],
    "SQUARE_25_MM": [
      {
        "width": 25,
        "height": 25,
        "unitType": "MILLIMETERS",
        "label": "25mm x 25mm"
      },
      {
        "width": 0.984,
        "height": 0.984,
        "unitType": "INCHES",
        "label": "0.984\" x 0.984\""
      }
    ],
    "IN_8_X_10": [
      {
        "width": 203,
        "height": 254,
        "unitType": "MILLIMETERS",
        "label": "203mm x 254mm"
      },
      {
        "width": 8,
        "height": 10,
        "unitType": "INCHES",
        "label": "8\" x 10\""
      }
    ],
    "MM_800_X_1200": [
      {
        "width": 800,
        "height": 1200,
        "unitType": "MILLIMETERS",
        "label": "800mm x 1200mm"
      },
      {
        "width": 31.496,
        "height": 47.244,
        "unitType": "INCHES",
        "label": "31.496\" x 47.244\""
      }
    ],
    "SQUARE_100_MM": [
      {
        "width": 100,
        "height": 100,
        "unitType": "MILLIMETERS",
        "label": "100mm x 100mm"
      },
      {
        "width": 3.937,
        "height": 3.937,
        "unitType": "INCHES",
        "label": "3.937\" x 3.937\""
      }
    ],
    "MM_98_X_420": [
      {
        "width": 98,
        "height": 420,
        "unitType": "MILLIMETERS",
        "label": "98mm x 420mm"
      },
      {
        "width": 3.858,
        "height": 16.535,
        "unitType": "INCHES",
        "label": "3.858\" x 16.535\""
      }
    ],
    "MM_300_X_800": [
      {
        "width": 300,
        "height": 800,
        "unitType": "MILLIMETERS",
        "label": "300mm x 800mm"
      },
      {
        "width": 11.811,
        "height": 31.496,
        "unitType": "INCHES",
        "label": "11.811\" x 31.496\""
      }
    ],
    "IN_18_X_24": [
      {
        "width": 457,
        "height": 610,
        "unitType": "MILLIMETERS",
        "label": "457mm x 610mm"
      },
      {
        "width": 18,
        "height": 24,
        "unitType": "INCHES",
        "label": "18\" x 24\""
      }
    ],
    "IN_4_125_X_5_875": [
      {
        "width": 105,
        "height": 149,
        "unitType": "MILLIMETERS",
        "label": "105mm x 149mm"
      },
      {
        "width": 4.125,
        "height": 5.875,
        "unitType": "INCHES",
        "label": "4.125\" x 5.875\""
      }
    ],
    "MM_120_X_125": [
      {
        "width": 120,
        "height": 125,
        "unitType": "MILLIMETERS",
        "label": "120mm x 125mm"
      },
      {
        "width": 4.724,
        "height": 4.921,
        "unitType": "INCHES",
        "label": "4.724\" x 4.921\""
      }
    ],
    "IN_4_X_6": [
      {
        "width": 102,
        "height": 152,
        "unitType": "MILLIMETERS",
        "label": "US Standard"
      },
      {
        "width": 4,
        "height": 6,
        "unitType": "INCHES",
        "label": "US Standard"
      }
    ],
    "IN_5_X_8": [
      {
        "width": 127,
        "height": 203,
        "unitType": "MILLIMETERS",
        "label": "127mm x 203mm"
      },
      {
        "width": 5,
        "height": 8,
        "unitType": "INCHES",
        "label": "5\" x 8\""
      }
    ],
    "SILVER_AGE": [
      {
        "width": 175,
        "height": 260,
        "unitType": "MILLIMETERS",
        "label": "Silver Age"
      },
      {
        "width": 6.875,
        "height": 10.25,
        "unitType": "INCHES",
        "label": "Silver Age"
      }
    ],
    "SQUARE_45_MM": [
      {
        "width": 45,
        "height": 45,
        "unitType": "MILLIMETERS",
        "label": "45mm x 45mm"
      },
      {
        "width": 1.772,
        "height": 1.772,
        "unitType": "INCHES",
        "label": "1.772\" x 1.772\""
      }
    ],
    "B6": [
      {
        "width": 125,
        "height": 176,
        "unitType": "MILLIMETERS",
        "label": "B6"
      },
      {
        "width": 4.921,
        "height": 6.929,
        "unitType": "INCHES",
        "label": "B6"
      }
    ],
    "IN_5_25_X_8": [
      {
        "width": 133,
        "height": 203,
        "unitType": "MILLIMETERS",
        "label": "133mm x 203mm"
      },
      {
        "width": 5.25,
        "height": 8,
        "unitType": "INCHES",
        "label": "5.25\" x 8\""
      }
    ],
    "A1_LONG": [
      {
        "width": 420,
        "height": 1188,
        "unitType": "MILLIMETERS",
        "label": "A1 Long"
      },
      {
        "width": 16.535,
        "height": 46.772,
        "unitType": "INCHES",
        "label": "A1 Long"
      }
    ],
    "IN_8_5_X_22": [
      {
        "width": 216,
        "height": 559,
        "unitType": "MILLIMETERS",
        "label": "216mm x 559mm"
      },
      {
        "width": 8.5,
        "height": 22,
        "unitType": "INCHES",
        "label": "8.5\" x 22\""
      }
    ],
    "SQUARE_11_8_IN": [
      {
        "width": 300,
        "height": 300,
        "unitType": "MILLIMETERS",
        "label": "300mm x 300mm"
      },
      {
        "width": 11.8,
        "height": 11.8,
        "unitType": "INCHES",
        "label": "11.8\" x 11.8\""
      }
    ],
    "BUSINESS_CARD_2": [
      {
        "width": 50,
        "height": 90,
        "unitType": "MILLIMETERS",
        "label": "50mm x 90mm"
      },
      {
        "width": 1.969,
        "height": 3.543,
        "unitType": "INCHES",
        "label": "1.969\" x 3.543\""
      }
    ],
    "MM_700_X_1000": [
      {
        "width": 700,
        "height": 1000,
        "unitType": "MILLIMETERS",
        "label": "700mm x 1000mm"
      },
      {
        "width": 27.559,
        "height": 39.37,
        "unitType": "INCHES",
        "label": "27.559\" x 39.37\""
      }
    ],
    "MM_48_X_70": [
      {
        "width": 48,
        "height": 70,
        "unitType": "MILLIMETERS",
        "label": "48mm x 70mm"
      },
      {
        "width": 1.89,
        "height": 2.756,
        "unitType": "INCHES",
        "label": "1.89\" x 2.756\""
      }
    ],
    "DL": [
      {
        "width": 105,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "DL"
      },
      {
        "width": 4.13,
        "height": 8.27,
        "unitType": "INCHES",
        "label": "DL"
      }
    ],
    "IN_8_5_X_3_5": [
      {
        "width": 89,
        "height": 216,
        "unitType": "MILLIMETERS",
        "label": "89mm x 216mm"
      },
      {
        "width": 3.5,
        "height": 8.5,
        "unitType": "INCHES",
        "label": "3.5\" x 8.5\""
      }
    ],
    "IN_19_X_27": [
      {
        "width": 483,
        "height": 686,
        "unitType": "MILLIMETERS",
        "label": "483mm x 686mm"
      },
      {
        "width": 19,
        "height": 27,
        "unitType": "INCHES",
        "label": "19\" x 27\""
      }
    ],
    "BUSINESS_CARD": [
      {
        "width": 55,
        "height": 85,
        "unitType": "MILLIMETERS",
        "label": "Business Card"
      },
      {
        "width": 2.165,
        "height": 3.346,
        "unitType": "INCHES",
        "label": "Business Card"
      }
    ],
    "SQUARE_105_MM": [
      {
        "width": 105,
        "height": 105,
        "unitType": "MILLIMETERS",
        "label": "105mm x 105mm"
      },
      {
        "width": 4.13,
        "height": 4.13,
        "unitType": "INCHES",
        "label": "4.13\" x 4.13\""
      }
    ],
    "MM_95_X_45": [
      {
        "width": 45,
        "height": 95,
        "unitType": "MILLIMETERS",
        "label": "45mm x 95mm"
      },
      {
        "width": 1.772,
        "height": 3.74,
        "unitType": "INCHES",
        "label": "1.772\" x 3.74\""
      }
    ],
    "MM_300_X_400": [
      {
        "width": 300,
        "height": 400,
        "unitType": "MILLIMETERS",
        "label": "300mm x 400mm"
      },
      {
        "width": 11.811,
        "height": 15.748,
        "unitType": "INCHES",
        "label": "11.811\" x 15.748\""
      }
    ],
    "MM_55_X_173": [
      {
        "width": 55,
        "height": 173,
        "unitType": "MILLIMETERS",
        "label": "55mm x 173mm"
      },
      {
        "width": 2.165,
        "height": 6.811,
        "unitType": "INCHES",
        "label": "2.165\" x 6.811\""
      }
    ],
    "IN_2_X_8": [
      {
        "width": 51,
        "height": 203,
        "unitType": "MILLIMETERS",
        "label": "51mm x 203mm"
      },
      {
        "width": 2,
        "height": 8,
        "unitType": "INCHES",
        "label": "2\" x 8\""
      }
    ],
    "B2": [
      {
        "width": 500,
        "height": 707,
        "unitType": "MILLIMETERS",
        "label": "B2"
      },
      {
        "width": 19.685,
        "height": 27.835,
        "unitType": "INCHES",
        "label": "B2"
      }
    ],
    "NOVEL": [
      {
        "width": 127,
        "height": 203,
        "unitType": "MILLIMETERS",
        "label": "Novel"
      },
      {
        "width": 5,
        "height": 8,
        "unitType": "INCHES",
        "label": "Novel"
      }
    ],
    "IN_6_X_9": [
      {
        "width": 152,
        "height": 229,
        "unitType": "MILLIMETERS",
        "label": "152mm x 229mm"
      },
      {
        "width": 6,
        "height": 9,
        "unitType": "INCHES",
        "label": "6\" x 9\""
      }
    ],
    "IN_3_66_X_4_25": [
      {
        "width": 93,
        "height": 108,
        "unitType": "MILLIMETERS",
        "label": "93mm x 108mm"
      },
      {
        "width": 3.66,
        "height": 4.25,
        "unitType": "INCHES",
        "label": "3.66\" x 4.25\""
      }
    ],
    "IN_11_X_14": [
      {
        "width": 279,
        "height": 356,
        "unitType": "MILLIMETERS",
        "label": "279mm x 356mm"
      },
      {
        "width": 11,
        "height": 14,
        "unitType": "INCHES",
        "label": "11\" x 14\""
      }
    ],
    "MM_210_X_280": [
      {
        "width": 210,
        "height": 280,
        "unitType": "MILLIMETERS",
        "label": "210mm x 280mm"
      },
      {
        "width": 8.27,
        "height": 11,
        "unitType": "INCHES",
        "label": "8.27\" x 11\""
      }
    ],
    "SQUARE_10_IN": [
      {
        "width": 254,
        "height": 254,
        "unitType": "MILLIMETERS",
        "label": "254mm x 254mm"
      },
      {
        "width": 10,
        "height": 10,
        "unitType": "INCHES",
        "label": "10\" x 10\""
      }
    ],
    "MM_130_X_150": [
      {
        "width": 130,
        "height": 150,
        "unitType": "MILLIMETERS",
        "label": "130mm x 150mm"
      },
      {
        "width": 5.118,
        "height": 5.906,
        "unitType": "INCHES",
        "label": "5.118\" x 5.906\""
      }
    ],
    "SQUARE_30_MM": [
      {
        "width": 30,
        "height": 30,
        "unitType": "MILLIMETERS",
        "label": "30mm x 30mm"
      },
      {
        "width": 1.181,
        "height": 1.181,
        "unitType": "INCHES",
        "label": "1.181\" x 1.181\""
      }
    ],
    "IN_11_X_17": [
      {
        "width": 279,
        "height": 432,
        "unitType": "MILLIMETERS",
        "label": "279mm x 432mm"
      },
      {
        "width": 11,
        "height": 17,
        "unitType": "INCHES",
        "label": "11\" x 17\""
      }
    ],
    "MM_35_X_210": [
      {
        "width": 35,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "35mm x 210mm"
      },
      {
        "width": 1.378,
        "height": 8.268,
        "unitType": "INCHES",
        "label": "1.378\" x 8.268\""
      }
    ],
    "MM_500_X_600": [
      {
        "width": 500,
        "height": 600,
        "unitType": "MILLIMETERS",
        "label": "500mm x 600mm"
      },
      {
        "width": 19.685,
        "height": 23.622,
        "unitType": "INCHES",
        "label": "19.685\" x 23.622\""
      }
    ],
    "MM_35_X_105": [
      {
        "width": 35,
        "height": 105,
        "unitType": "MILLIMETERS",
        "label": "35mm x 105mm"
      },
      {
        "width": 1.378,
        "height": 4.134,
        "unitType": "INCHES",
        "label": "1.378\" x 4.134\""
      }
    ],
    "SQUARE_95_MM": [
      {
        "width": 95,
        "height": 95,
        "unitType": "MILLIMETERS",
        "label": "95mm x 95mm"
      },
      {
        "width": 3.74,
        "height": 3.74,
        "unitType": "INCHES",
        "label": "3.74\" x 3.74\""
      }
    ],
    "IN_6_X_11": [
      {
        "width": 152,
        "height": 279,
        "unitType": "MILLIMETERS",
        "label": "152mm x 279mm"
      },
      {
        "width": 6,
        "height": 11,
        "unitType": "INCHES",
        "label": "6\" x 11\""
      }
    ],
    "MM_300_X_600": [
      {
        "width": 300,
        "height": 600,
        "unitType": "MILLIMETERS",
        "label": "300mm x 600mm"
      },
      {
        "width": 11.811,
        "height": 23.622,
        "unitType": "INCHES",
        "label": "11.811\" x 23.622\""
      }
    ],
    "SQUARE_15_MM": [
      {
        "width": 15,
        "height": 15,
        "unitType": "MILLIMETERS",
        "label": "15mm x 15mm"
      },
      {
        "width": 0.591,
        "height": 0.591,
        "unitType": "INCHES",
        "label": "0.591\" x 0.591\""
      }
    ],
    "SQUARE_297_MM": [
      {
        "width": 297,
        "height": 297,
        "unitType": "MILLIMETERS",
        "label": "297mm x 297mm"
      },
      {
        "width": 11.693,
        "height": 11.693,
        "unitType": "INCHES",
        "label": "11.693\" x 11.693\""
      }
    ],
    "MM_600_X_750": [
      {
        "width": 600,
        "height": 750,
        "unitType": "MILLIMETERS",
        "label": "600mm x 750mm"
      },
      {
        "width": 23.622,
        "height": 29.528,
        "unitType": "INCHES",
        "label": "23.622\" x 29.528\""
      }
    ],
    "IN_10_X_15": [
      {
        "width": 254,
        "height": 381,
        "unitType": "MILLIMETERS",
        "label": "254mm x 381mm"
      },
      {
        "width": 10,
        "height": 15,
        "unitType": "INCHES",
        "label": "10\" x 15\""
      }
    ],
    "SQUARE_8_IN": [
      {
        "width": 203,
        "height": 203,
        "unitType": "MILLIMETERS",
        "label": "203mm x 203mm"
      },
      {
        "width": 8,
        "height": 8,
        "unitType": "INCHES",
        "label": "8\" x 8\""
      }
    ],
    "B1": [
      {
        "width": 707,
        "height": 1000,
        "unitType": "MILLIMETERS",
        "label": "B1"
      },
      {
        "width": 27.835,
        "height": 39.37,
        "unitType": "INCHES",
        "label": "B1"
      }
    ],
    "MM_40_X_50": [
      {
        "width": 40,
        "height": 50,
        "unitType": "MILLIMETERS",
        "label": "40mm x 50mm"
      },
      {
        "width": 1.575,
        "height": 1.969,
        "unitType": "INCHES",
        "label": "1.575\" x 1.969\""
      }
    ],
    "A2_LONG": [
      {
        "width": 297,
        "height": 840,
        "unitType": "MILLIMETERS",
        "label": "A2 Long"
      },
      {
        "width": 11.693,
        "height": 33.071,
        "unitType": "INCHES",
        "label": "A2 Long"
      }
    ],
    "IN_30_X_40": [
      {
        "width": 762,
        "height": 1016,
        "unitType": "MILLIMETERS",
        "label": "762mm x 1016mm"
      },
      {
        "width": 30,
        "height": 40,
        "unitType": "INCHES",
        "label": "30\" x 40\""
      }
    ],
    "B0": [
      {
        "width": 1000,
        "height": 1414,
        "unitType": "MILLIMETERS",
        "label": "B0"
      },
      {
        "width": 39.37,
        "height": 55.669,
        "unitType": "INCHES",
        "label": "B0"
      }
    ],
    "MM_300_X_300": [
      {
        "width": 300,
        "height": 300,
        "unitType": "MILLIMETERS",
        "label": "300mm x 300mm"
      },
      {
        "width": 11.811,
        "height": 11.811,
        "unitType": "INCHES",
        "label": "11.811\" x 11.811\""
      }
    ],
    "SQUARE_98_MM": [
      {
        "width": 98,
        "height": 98,
        "unitType": "MILLIMETERS",
        "label": "98mm x 98mm"
      },
      {
        "width": 3.858,
        "height": 3.858,
        "unitType": "INCHES",
        "label": "3.858\" x 3.858\""
      }
    ],
    "A6_LONG": [
      {
        "width": 74,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "A6 Long"
      },
      {
        "width": 2.913,
        "height": 8.268,
        "unitType": "INCHES",
        "label": "A6 Long"
      }
    ],
    "CROWN_QUARTO": [
      {
        "width": 189,
        "height": 246,
        "unitType": "MILLIMETERS",
        "label": "Crown Quarto"
      },
      {
        "width": 7.44,
        "height": 9.68,
        "unitType": "INCHES",
        "label": "Crown Quarto"
      }
    ],
    "IN_9_X_16": [
      {
        "width": 229,
        "height": 406,
        "unitType": "MILLIMETERS",
        "label": "229mm x 406mm"
      },
      {
        "width": 9,
        "height": 16,
        "unitType": "INCHES",
        "label": "9\" x 16\""
      }
    ],
    "BUSINESS_CARD_3": [
      {
        "width": 54,
        "height": 86,
        "unitType": "MILLIMETERS",
        "label": "54mm x 86mm"
      },
      {
        "width": 2.126,
        "height": 3.386,
        "unitType": "INCHES",
        "label": "2.126\" x 3.386\""
      }
    ],
    "ENVELOPE_DL": [
      {
        "width": 110,
        "height": 220,
        "unitType": "MILLIMETERS",
        "label": "DL"
      },
      {
        "width": 4.331,
        "height": 8.661,
        "unitType": "INCHES",
        "label": "DL"
      }
    ],
    "STANDARD_BOOK": [
      {
        "width": 132,
        "height": 197,
        "unitType": "MILLIMETERS",
        "label": "Standard"
      },
      {
        "width": 5.2,
        "height": 7.76,
        "unitType": "INCHES",
        "label": "Standard"
      }
    ],
    "IN_4_25_X_11": [
      {
        "width": 108,
        "height": 280,
        "unitType": "MILLIMETERS",
        "label": "108mm x 280mm"
      },
      {
        "width": 4.25,
        "height": 11,
        "unitType": "INCHES",
        "label": "4.25\" x 11\""
      }
    ],
    "MM_199_X_210": [
      {
        "width": 199,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "199mm x 210mm"
      },
      {
        "width": 7.835,
        "height": 8.268,
        "unitType": "INCHES",
        "label": "7.835\" x 8.268\""
      }
    ],
    "MM_750_X_1000": [
      {
        "width": 750,
        "height": 1000,
        "unitType": "MILLIMETERS",
        "label": "750mm x 1000mm"
      },
      {
        "width": 29.528,
        "height": 39.37,
        "unitType": "INCHES",
        "label": "29.528\" x 39.37\""
      }
    ],
    "UK_STANDARD": [
      {
        "width": 157,
        "height": 240,
        "unitType": "MILLIMETERS",
        "label": "UK Standard"
      },
      {
        "width": 6.18,
        "height": 9.45,
        "unitType": "INCHES",
        "label": "UK Standard"
      }
    ],
    "IN_5_25_X_8_375": [
      {
        "width": 133,
        "height": 213,
        "unitType": "MILLIMETERS",
        "label": "133mm x 213mm"
      },
      {
        "width": 5.25,
        "height": 8.375,
        "unitType": "INCHES",
        "label": "5.25\" x 8.375\""
      }
    ],
    "IN_8_25_X_6": [
      {
        "width": 152,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "152mm x 210mm"
      },
      {
        "width": 6,
        "height": 8.25,
        "unitType": "INCHES",
        "label": "6\" x 8.25\""
      }
    ],
    "B_FORMAT_UK": [
      {
        "width": 129,
        "height": 198,
        "unitType": "MILLIMETERS",
        "label": "UK B Format"
      },
      {
        "width": 5.079,
        "height": 7.795,
        "unitType": "INCHES",
        "label": "UK B Format"
      }
    ],
    "IN_8_5_X_14": [
      {
        "width": 216,
        "height": 356,
        "unitType": "MILLIMETERS",
        "label": "216mm x 356mm"
      },
      {
        "width": 8.5,
        "height": 14,
        "unitType": "INCHES",
        "label": "8.5\" x 14\""
      }
    ],
    "MM_400_X_400": [
      {
        "width": 400,
        "height": 400,
        "unitType": "MILLIMETERS",
        "label": "400mm x 400mm"
      },
      {
        "width": 15.748,
        "height": 15.748,
        "unitType": "INCHES",
        "label": "15.748\" x 15.748\""
      }
    ],
    "SQUARE_280_MM": [
      {
        "width": 280,
        "height": 280,
        "unitType": "MILLIMETERS",
        "label": "280mm x 280mm"
      },
      {
        "width": 11.024,
        "height": 11.024,
        "unitType": "INCHES",
        "label": "11.024\" x 11.024\""
      }
    ],
    "IN_5_125X_7": [
      {
        "width": 130,
        "height": 178,
        "unitType": "MILLIMETERS",
        "label": "130mm x 178mm"
      },
      {
        "width": 5.125,
        "height": 7,
        "unitType": "INCHES",
        "label": "5.125\" x 7\""
      }
    ],
    "MM_51_X_298": [
      {
        "width": 51,
        "height": 298,
        "unitType": "MILLIMETERS",
        "label": "51mm x 298mm"
      },
      {
        "width": 2.008,
        "height": 11.732,
        "unitType": "INCHES",
        "label": "2.008\" x 11.732\""
      }
    ],
    "IN_8_5_X_17": [
      {
        "width": 216,
        "height": 432,
        "unitType": "MILLIMETERS",
        "label": "216mm x 432mm"
      },
      {
        "width": 8.5,
        "height": 17,
        "unitType": "INCHES",
        "label": "8.5\" x 17\""
      }
    ],
    "IN_7_5_X_9_25": [
      {
        "width": 191,
        "height": 235,
        "unitType": "MILLIMETERS",
        "label": "191mm x 235mm"
      },
      {
        "width": 7.5,
        "height": 9.25,
        "unitType": "INCHES",
        "label": "7.5\" x 9.25\""
      }
    ],
    "SQUARE_80_MM": [
      {
        "width": 80,
        "height": 80,
        "unitType": "MILLIMETERS",
        "label": "80mm x 80mm"
      },
      {
        "width": 3.15,
        "height": 3.15,
        "unitType": "INCHES",
        "label": "3.15\" x 3.15\""
      }
    ],
    "SQUARE_10_MM": [
      {
        "width": 10,
        "height": 10,
        "unitType": "MILLIMETERS",
        "label": "10mm x 10mm"
      },
      {
        "width": 0.394,
        "height": 0.394,
        "unitType": "INCHES",
        "label": "0.394\" x 0.394\""
      }
    ],
    "SQUARE_7_5_IN": [
      {
        "width": 191,
        "height": 191,
        "unitType": "MILLIMETERS",
        "label": "191mm x 191mm"
      },
      {
        "width": 7.5,
        "height": 7.5,
        "unitType": "INCHES",
        "label": "7.5\" x 7.5\""
      }
    ],
    "MM_55_X_85": [
      {
        "width": 55,
        "height": 85,
        "unitType": "MILLIMETERS",
        "label": "55mm x 85mm"
      },
      {
        "width": 2.165,
        "height": 3.346,
        "unitType": "INCHES",
        "label": "2.165\" x 3.346\""
      }
    ],
    "IN_13_X_19": [
      {
        "width": 330,
        "height": 483,
        "unitType": "MILLIMETERS",
        "label": "330mm x 483mm"
      },
      {
        "width": 13,
        "height": 19,
        "unitType": "INCHES",
        "label": "13\" x 19\""
      }
    ],
    "DEMY": [
      {
        "width": 138,
        "height": 216,
        "unitType": "MILLIMETERS",
        "label": "Demy"
      },
      {
        "width": 5.43,
        "height": 8.5,
        "unitType": "INCHES",
        "label": "Demy"
      }
    ],
    "IN_5_5_X_8_5": [
      {
        "width": 140,
        "height": 216,
        "unitType": "MILLIMETERS",
        "label": "Digest"
      },
      {
        "width": 5.5,
        "height": 8.5,
        "unitType": "INCHES",
        "label": "Digest"
      }
    ],
    "A7_MINI": [
      {
        "width": 74,
        "height": 98,
        "unitType": "MILLIMETERS",
        "label": "A7 mini"
      },
      {
        "width": 2.913,
        "height": 3.858,
        "unitType": "INCHES",
        "label": "A7 mini"
      }
    ],
    "SQUARE_6_IN": [
      {
        "width": 152,
        "height": 152,
        "unitType": "MILLIMETERS",
        "label": "152mm x 152mm"
      },
      {
        "width": 6,
        "height": 6,
        "unitType": "INCHES",
        "label": "6\" x 6\""
      }
    ],
    "MM_500_X_700": [
      {
        "width": 500,
        "height": 700,
        "unitType": "MILLIMETERS",
        "label": "500mm x 700mm"
      },
      {
        "width": 19.685,
        "height": 27.559,
        "unitType": "INCHES",
        "label": "19.685\" x 27.559\""
      }
    ],
    "IN_7_X_8_5": [
      {
        "width": 178,
        "height": 216,
        "unitType": "MILLIMETERS",
        "label": "178mm x 216mm"
      },
      {
        "width": 7,
        "height": 8.5,
        "unitType": "INCHES",
        "label": "7\" x 8.5\""
      }
    ],
    "MM_1000_X_1500": [
      {
        "width": 1000,
        "height": 1500,
        "unitType": "MILLIMETERS",
        "label": "1000mm x 1500mm"
      },
      {
        "width": 39.37,
        "height": 59.055,
        "unitType": "INCHES",
        "label": "39.37\" x 59.055\""
      }
    ],
    "IN_8_X_11": [
      {
        "width": 203,
        "height": 279,
        "unitType": "MILLIMETERS",
        "label": "203mm x 279mm"
      },
      {
        "width": 8,
        "height": 11,
        "unitType": "INCHES",
        "label": "8\" x 11\""
      }
    ],
    "US_TRADE": [
      {
        "width": 152,
        "height": 229,
        "unitType": "MILLIMETERS",
        "label": "US Trade"
      },
      {
        "width": 6,
        "height": 9,
        "unitType": "INCHES",
        "label": "US Trade"
      }
    ],
    "US_ROYAL": [
      {
        "width": 152,
        "height": 229,
        "unitType": "MILLIMETERS",
        "label": "US Royal"
      },
      {
        "width": 6,
        "height": 8.98,
        "unitType": "INCHES",
        "label": "US Royal"
      }
    ],
    "IN_17_X_22": [
      {
        "width": 432,
        "height": 559,
        "unitType": "MILLIMETERS",
        "label": "432mm x 559mm"
      },
      {
        "width": 17,
        "height": 22,
        "unitType": "INCHES",
        "label": "17\" x 22\""
      }
    ],
    "IN_8_375_X_10_875": [
      {
        "width": 213,
        "height": 276,
        "unitType": "MILLIMETERS",
        "label": "213mm x 276mm"
      },
      {
        "width": 8.375,
        "height": 10.875,
        "unitType": "INCHES",
        "label": "8.375\" x 10.875\""
      }
    ],
    "MM_300_X_1000": [
      {
        "width": 300,
        "height": 1000,
        "unitType": "MILLIMETERS",
        "label": "300mm x 1000mm"
      },
      {
        "width": 11.811,
        "height": 39.37,
        "unitType": "INCHES",
        "label": "11.811\" x 39.37\""
      }
    ],
    "IN_24_X_36": [
      {
        "width": 610,
        "height": 914,
        "unitType": "MILLIMETERS",
        "label": "610mm x 914mm"
      },
      {
        "width": 24,
        "height": 36,
        "unitType": "INCHES",
        "label": "24\" x 36\""
      }
    ],
    "IN_26_X_39": [
      {
        "width": 660,
        "height": 991,
        "unitType": "MILLIMETERS",
        "label": "660mm x 991mm"
      },
      {
        "width": 26,
        "height": 39,
        "unitType": "INCHES",
        "label": "26\" x 39\""
      }
    ],
    "IN_7_44_X_9_69": [
      {
        "width": 189,
        "height": 246,
        "unitType": "MILLIMETERS",
        "label": "189mm x 246mm"
      },
      {
        "width": 7.44,
        "height": 9.69,
        "unitType": "INCHES",
        "label": "7.44\" x 9.69\""
      }
    ],
    "MM_71_X_96": [
      {
        "width": 71,
        "height": 96,
        "unitType": "MILLIMETERS",
        "label": "71mm x 96mm"
      },
      {
        "width": 2.795,
        "height": 3.78,
        "unitType": "INCHES",
        "label": "2.795\" x 3.78\""
      }
    ],
    "MM_1000_X_1000": [
      {
        "width": 1000,
        "height": 1000,
        "unitType": "MILLIMETERS",
        "label": "1000mm x 1000mm"
      },
      {
        "width": 39.37,
        "height": 39.37,
        "unitType": "INCHES",
        "label": "39.37\" x 39.37\""
      }
    ],
    "ROYAL": [
      {
        "width": 156,
        "height": 234,
        "unitType": "MILLIMETERS",
        "label": "Royal"
      },
      {
        "width": 6.14,
        "height": 9.21,
        "unitType": "INCHES",
        "label": "Royal"
      }
    ],
    "SQUARE_55_MM": [
      {
        "width": 55,
        "height": 55,
        "unitType": "MILLIMETERS",
        "label": "55mm x 55mm"
      },
      {
        "width": 2.165,
        "height": 2.165,
        "unitType": "INCHES",
        "label": "2.165\" x 2.165\""
      }
    ],
    "MM_183_X_273": [
      {
        "width": 183,
        "height": 273,
        "unitType": "MILLIMETERS",
        "label": "183mm x 273mm"
      },
      {
        "width": 7.205,
        "height": 10.748,
        "unitType": "INCHES",
        "label": "7.205\" x 10.748\""
      }
    ],
    "MM_170_X_240": [
      {
        "width": 170,
        "height": 240,
        "unitType": "MILLIMETERS",
        "label": "170mm x 240mm"
      },
      {
        "width": 6.693,
        "height": 9.449,
        "unitType": "INCHES",
        "label": "6.693\" x 9.449\""
      }
    ],
    "IN_7_X_10": [
      {
        "width": 178,
        "height": 254,
        "unitType": "MILLIMETERS",
        "label": "Executive"
      },
      {
        "width": 7,
        "height": 10,
        "unitType": "INCHES",
        "label": "Executive"
      }
    ],
    "MM_400_X_600": [
      {
        "width": 400,
        "height": 600,
        "unitType": "MILLIMETERS",
        "label": "400mm x 600mm"
      },
      {
        "width": 15.748,
        "height": 23.622,
        "unitType": "INCHES",
        "label": "15.748\" x 23.622\""
      }
    ],
    "SQUARE_12_IN": [
      {
        "width": 305,
        "height": 305,
        "unitType": "MILLIMETERS",
        "label": "305mm x 305mm"
      },
      {
        "width": 12,
        "height": 12,
        "unitType": "INCHES",
        "label": "12\" x 12\""
      }
    ],
    "MM_1185_X_1750": [
      {
        "width": 1185,
        "height": 1750,
        "unitType": "MILLIMETERS",
        "label": "Large format"
      },
      {
        "width": 46.654,
        "height": 68.898,
        "unitType": "INCHES",
        "label": "Large format"
      }
    ],
    "MM_20_X_50": [
      {
        "width": 20,
        "height": 50,
        "unitType": "MILLIMETERS",
        "label": "20mm x 50mm"
      },
      {
        "width": 0.787,
        "height": 1.969,
        "unitType": "INCHES",
        "label": "0.787\" x 1.969\""
      }
    ],
    "MM_400_X_500": [
      {
        "width": 400,
        "height": 500,
        "unitType": "MILLIMETERS",
        "label": "400mm x 500mm"
      },
      {
        "width": 15.748,
        "height": 19.685,
        "unitType": "INCHES",
        "label": "15.748\" x 19.685\""
      }
    ],
    "MM_500_X_500": [
      {
        "width": 500,
        "height": 500,
        "unitType": "MILLIMETERS",
        "label": "500mm x 500mm"
      },
      {
        "width": 19.685,
        "height": 19.685,
        "unitType": "INCHES",
        "label": "19.685\" x 19.685\""
      }
    ],
    "IN_6_69_X_9_61": [
      {
        "width": 170,
        "height": 244,
        "unitType": "MILLIMETERS",
        "label": "170mm x 244mm"
      },
      {
        "width": 6.69,
        "height": 9.61,
        "unitType": "INCHES",
        "label": "6.69\" x 9.61\""
      }
    ],
    "IN_11_5_X_17_5": [
      {
        "width": 292,
        "height": 445,
        "unitType": "MILLIMETERS",
        "label": "292mm x 445mm"
      },
      {
        "width": 11.5,
        "height": 17.5,
        "unitType": "INCHES",
        "label": "11.5\" x 17.5\""
      }
    ],
    "SQUARE_40_MM": [
      {
        "width": 40,
        "height": 40,
        "unitType": "MILLIMETERS",
        "label": "40mm x 40mm"
      },
      {
        "width": 1.575,
        "height": 1.575,
        "unitType": "INCHES",
        "label": "1.575\" x 1.575\""
      }
    ],
    "IN_11_X_25_5": [
      {
        "width": 279,
        "height": 648,
        "unitType": "MILLIMETERS",
        "label": "279mm x 648mm"
      },
      {
        "width": 11,
        "height": 25.5,
        "unitType": "INCHES",
        "label": "11\" x 25.5\""
      }
    ],
    "IN_3_X_4": [
      {
        "width": 76,
        "height": 102,
        "unitType": "MILLIMETERS",
        "label": "76mm x 102mm"
      },
      {
        "width": 3,
        "height": 4,
        "unitType": "INCHES",
        "label": "3\" x 4\""
      }
    ],
    "US_BUSINESS_CARD": [
      {
        "width": 51,
        "height": 89,
        "unitType": "MILLIMETERS",
        "label": "Business Card"
      },
      {
        "width": 2.008,
        "height": 3.504,
        "unitType": "INCHES",
        "label": "Business Card"
      }
    ],
    "IN_5_06_X_7_81": [
      {
        "width": 129,
        "height": 198,
        "unitType": "MILLIMETERS",
        "label": "129mm x 198mm"
      },
      {
        "width": 5.06,
        "height": 7.81,
        "unitType": "INCHES",
        "label": "5.06\" x 7.81\""
      }
    ],
    "MM_35_X_316": [
      {
        "width": 35,
        "height": 316,
        "unitType": "MILLIMETERS",
        "label": "35mm x 316mm"
      },
      {
        "width": 1.378,
        "height": 12.441,
        "unitType": "INCHES",
        "label": "1.378\" x 12.441\""
      }
    ],
    "MM_200_X_600": [
      {
        "width": 200,
        "height": 600,
        "unitType": "MILLIMETERS",
        "label": "200mm x 600mm"
      },
      {
        "width": 7.874,
        "height": 23.622,
        "unitType": "INCHES",
        "label": "7.874\" x 23.622\""
      }
    ],
    "IN_7_5_X_8_5": [
      {
        "width": 191,
        "height": 216,
        "unitType": "MILLIMETERS",
        "label": "191mm x 216mm"
      },
      {
        "width": 7.5,
        "height": 8.5,
        "unitType": "INCHES",
        "label": "7.5\" x 8.5\""
      }
    ],
    "US_POSTCARD_550": [
      {
        "width": 89,
        "height": 140,
        "unitType": "MILLIMETERS",
        "label": "Postcard"
      },
      {
        "width": 3.504,
        "height": 5.512,
        "unitType": "INCHES",
        "label": "Postcard"
      }
    ],
    "IN_5_8_X_9_25": [
      {
        "width": 147,
        "height": 235,
        "unitType": "MILLIMETERS",
        "label": "147mm x 235mm"
      },
      {
        "width": 5.8,
        "height": 9.25,
        "unitType": "INCHES",
        "label": "5.8\" x 9.25\""
      }
    ],
    "SQUARE_140_MM": [
      {
        "width": 140,
        "height": 140,
        "unitType": "MILLIMETERS",
        "label": "140mm x 140mm"
      },
      {
        "width": 5.512,
        "height": 5.512,
        "unitType": "INCHES",
        "label": "5.512\" x 5.512\""
      }
    ],
    "IN_7_X_9": [
      {
        "width": 178,
        "height": 229,
        "unitType": "MILLIMETERS",
        "label": "178mm x 229mm"
      },
      {
        "width": 7,
        "height": 9,
        "unitType": "INCHES",
        "label": "7\" x 9\""
      }
    ],
    "MM_200_X_250": [
      {
        "width": 200,
        "height": 250,
        "unitType": "MILLIMETERS",
        "label": "200mm x 250mm"
      },
      {
        "width": 7.874,
        "height": 9.843,
        "unitType": "INCHES",
        "label": "7.874\" x 9.843\""
      }
    ],
    "MM_240_X_340": [
      {
        "width": 240,
        "height": 340,
        "unitType": "MILLIMETERS",
        "label": "240mm x 340mm"
      },
      {
        "width": 9.449,
        "height": 13.386,
        "unitType": "INCHES",
        "label": "9.449\" x 13.386\""
      }
    ],
    "MM_600_X_600": [
      {
        "width": 600,
        "height": 600,
        "unitType": "MILLIMETERS",
        "label": "600mm x 600mm"
      },
      {
        "width": 23.622,
        "height": 23.622,
        "unitType": "INCHES",
        "label": "23.622\" x 23.622\""
      }
    ],
    "US_POSTCARD_425": [
      {
        "width": 108,
        "height": 152,
        "unitType": "MILLIMETERS",
        "label": "Postcard"
      },
      {
        "width": 4.252,
        "height": 5.984,
        "unitType": "INCHES",
        "label": "Postcard"
      }
    ],
    "MM_130_X_190": [
      {
        "width": 130,
        "height": 190,
        "unitType": "MILLIMETERS",
        "label": "130mm x 190mm"
      },
      {
        "width": 5.118,
        "height": 7.48,
        "unitType": "INCHES",
        "label": "5.118\" x 7.48\""
      }
    ],
    "SQUARE_8_25_IN": [
      {
        "width": 210,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "210mm x 210mm"
      },
      {
        "width": 8.25,
        "height": 8.25,
        "unitType": "INCHES",
        "label": "8.25\" x 8.25\""
      }
    ],
    "GOLDEN_AGE": [
      {
        "width": 187,
        "height": 260,
        "unitType": "MILLIMETERS",
        "label": "Golden Age"
      },
      {
        "width": 7.375,
        "height": 10.25,
        "unitType": "INCHES",
        "label": "Golden Age"
      }
    ],
    "MM_200_X_200": [
      {
        "width": 200,
        "height": 200,
        "unitType": "MILLIMETERS",
        "label": "200mm x 200mm"
      },
      {
        "width": 7.874,
        "height": 7.874,
        "unitType": "INCHES",
        "label": "7.874\" x 7.874\""
      }
    ],
    "IN_3_5_X_8_5": [
      {
        "width": 89,
        "height": 216,
        "unitType": "MILLIMETERS",
        "label": "89mm x 216mm"
      },
      {
        "width": 3.5,
        "height": 8.5,
        "unitType": "INCHES",
        "label": "3.5\" x 8.5\""
      }
    ],
    "MM_600_X_800": [
      {
        "width": 600,
        "height": 800,
        "unitType": "MILLIMETERS",
        "label": "600mm x 800mm"
      },
      {
        "width": 23.622,
        "height": 31.496,
        "unitType": "INCHES",
        "label": "23.622\" x 31.496\""
      }
    ],
    "IN_6_63_X_10_25": [
      {
        "width": 168,
        "height": 260,
        "unitType": "MILLIMETERS",
        "label": "168mm x 260mm"
      },
      {
        "width": 6.63,
        "height": 10.25,
        "unitType": "INCHES",
        "label": "6.63\" x 10.25\""
      }
    ],
    "PINCHED_CROWN_QUARTO": [
      {
        "width": 171,
        "height": 246,
        "unitType": "MILLIMETERS",
        "label": "Pinched Crown Quarto"
      },
      {
        "width": 6.73,
        "height": 9.65,
        "unitType": "INCHES",
        "label": "Pinched Crown Quarto"
      }
    ],
    "MM_95_X_145": [
      {
        "width": 95,
        "height": 145,
        "unitType": "MILLIMETERS",
        "label": "95mm x 145mm"
      },
      {
        "width": 3.74,
        "height": 5.709,
        "unitType": "INCHES",
        "label": "3.74\" x 5.709\""
      }
    ],
    "MM_138_X_297": [
      {
        "width": 138,
        "height": 297,
        "unitType": "MILLIMETERS",
        "label": "138mm x 297mm"
      },
      {
        "width": 5.433,
        "height": 11.693,
        "unitType": "INCHES",
        "label": "5.433\" x 11.693\""
      }
    ],
    "MM_98_X_210": [
      {
        "width": 98,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "98mm x 210mm"
      },
      {
        "width": 3.858,
        "height": 8.268,
        "unitType": "INCHES",
        "label": "3.858\" x 8.268\""
      }
    ],
    "SQUARE_50_MM": [
      {
        "width": 50,
        "height": 50,
        "unitType": "MILLIMETERS",
        "label": "50mm x 50mm"
      },
      {
        "width": 1.969,
        "height": 1.969,
        "unitType": "INCHES",
        "label": "1.969\" x 1.969\""
      }
    ],
    "MM_51_X_420": [
      {
        "width": 51,
        "height": 420,
        "unitType": "MILLIMETERS",
        "label": "51mm x 420mm"
      },
      {
        "width": 2.008,
        "height": 16.535,
        "unitType": "INCHES",
        "label": "2.008\" x 16.535\""
      }
    ],
    "MM_105_X_297": [
      {
        "width": 105,
        "height": 297,
        "unitType": "MILLIMETERS",
        "label": "A5 Long"
      },
      {
        "width": 4.13,
        "height": 11.69,
        "unitType": "INCHES",
        "label": "A5 Long"
      }
    ],
    "MM_25_X_50": [
      {
        "width": 25,
        "height": 50,
        "unitType": "MILLIMETERS",
        "label": "25mm x 50mm"
      },
      {
        "width": 0.984,
        "height": 1.969,
        "unitType": "INCHES",
        "label": "0.984\" x 1.969\""
      }
    ],
    "IN_7_25_X_9_5": [
      {
        "width": 184,
        "height": 241,
        "unitType": "MILLIMETERS",
        "label": "184mm x 241mm"
      },
      {
        "width": 7.25,
        "height": 9.5,
        "unitType": "INCHES",
        "label": "7.25\" x 9.5\""
      }
    ],
    "IN_20_X_30": [
      {
        "width": 508,
        "height": 762,
        "unitType": "MILLIMETERS",
        "label": "508mm x 762mm"
      },
      {
        "width": 20,
        "height": 30,
        "unitType": "INCHES",
        "label": "20\" x 30\""
      }
    ],
    "MM_500_X_1000": [
      {
        "width": 500,
        "height": 1000,
        "unitType": "MILLIMETERS",
        "label": "500mm x 1000mm"
      },
      {
        "width": 19.685,
        "height": 39.37,
        "unitType": "INCHES",
        "label": "19.685\" x 39.37\""
      }
    ],
    "SQUARE_20_MM": [
      {
        "width": 20,
        "height": 20,
        "unitType": "MILLIMETERS",
        "label": "20mm x 20mm"
      },
      {
        "width": 0.787,
        "height": 0.787,
        "unitType": "INCHES",
        "label": "0.787\" x 0.787\""
      }
    ],
    "IN_4_X_4": [
      {
        "width": 102,
        "height": 102,
        "unitType": "MILLIMETERS",
        "label": "102mm x 102mm"
      },
      {
        "width": 4,
        "height": 4,
        "unitType": "INCHES",
        "label": "4\" x 4\""
      }
    ],
    "IN_8_5_X_11": [
      {
        "width": 216,
        "height": 279,
        "unitType": "MILLIMETERS",
        "label": "Letter"
      },
      {
        "width": 8.5,
        "height": 11,
        "unitType": "INCHES",
        "label": "Letter"
      }
    ],
    "MM_400_X_1500": [
      {
        "width": 400,
        "height": 1500,
        "unitType": "MILLIMETERS",
        "label": "400mm x 1500mm"
      },
      {
        "width": 15.748,
        "height": 59.055,
        "unitType": "INCHES",
        "label": "15.748\" x 59.055\""
      }
    ],
    "IN_4_X_9": [
      {
        "width": 102,
        "height": 229,
        "unitType": "MILLIMETERS",
        "label": "102mm x 229mm"
      },
      {
        "width": 4,
        "height": 9,
        "unitType": "INCHES",
        "label": "4\" x 9\""
      }
    ],
    "IN_8_X_12": [
      {
        "width": 203,
        "height": 305,
        "unitType": "MILLIMETERS",
        "label": "203mm x 305mm"
      },
      {
        "width": 8,
        "height": 12,
        "unitType": "INCHES",
        "label": "8\" x 12\""
      }
    ],
    "MM_15_X_45": [
      {
        "width": 15,
        "height": 45,
        "unitType": "MILLIMETERS",
        "label": "15mm x 45mm"
      },
      {
        "width": 0.591,
        "height": 1.772,
        "unitType": "INCHES",
        "label": "0.591\" x 1.772\""
      }
    ],
    "MM_170_X_590": [
      {
        "width": 170,
        "height": 590,
        "unitType": "MILLIMETERS",
        "label": "170mm x 590mm"
      },
      {
        "width": 6.693,
        "height": 23.228,
        "unitType": "INCHES",
        "label": "6.693\" x 23.228\""
      }
    ],
    "DL_SMALL_99_MM": [
      {
        "width": 99,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "DL Small"
      },
      {
        "width": 3.898,
        "height": 8.268,
        "unitType": "INCHES",
        "label": "DL Small"
      }
    ],
    "MM_55_X_148": [
      {
        "width": 55,
        "height": 148,
        "unitType": "MILLIMETERS",
        "label": "55mm x 148mm"
      },
      {
        "width": 2.165,
        "height": 5.827,
        "unitType": "INCHES",
        "label": "2.165\" x 5.827\""
      }
    ],
    "SQUARE_148_MM": [
      {
        "width": 148,
        "height": 148,
        "unitType": "MILLIMETERS",
        "label": "148mm x 148mm"
      },
      {
        "width": 5.82,
        "height": 5.82,
        "unitType": "INCHES",
        "label": "5.82\" x 5.82\""
      }
    ],
    "MM_20_X_40": [
      {
        "width": 20,
        "height": 40,
        "unitType": "MILLIMETERS",
        "label": "20mm x 40mm"
      },
      {
        "width": 0.787,
        "height": 1.575,
        "unitType": "INCHES",
        "label": "0.787\" x 1.575\""
      }
    ],
    "MANGA_STANDARD": [
      {
        "width": 127,
        "height": 191,
        "unitType": "MILLIMETERS",
        "label": "Manga Standard"
      },
      {
        "width": 5,
        "height": 7.52,
        "unitType": "INCHES",
        "label": "Manga Standard"
      }
    ],
    "MM_500_X_750": [
      {
        "width": 500,
        "height": 750,
        "unitType": "MILLIMETERS",
        "label": "500mm x 750mm"
      },
      {
        "width": 19.685,
        "height": 29.528,
        "unitType": "INCHES",
        "label": "19.685\" x 29.528\""
      }
    ],
    "MM_10_X_30": [
      {
        "width": 10,
        "height": 30,
        "unitType": "MILLIMETERS",
        "label": "10mm x 30mm"
      },
      {
        "width": 0.394,
        "height": 1.181,
        "unitType": "INCHES",
        "label": "0.394\" x 1.181\""
      }
    ],
    "IN_8_5_X_5_5": [
      {
        "width": 140,
        "height": 216,
        "unitType": "MILLIMETERS",
        "label": "140mm x 216mm"
      },
      {
        "width": 5.5,
        "height": 8.5,
        "unitType": "INCHES",
        "label": "5.5\" x 8.5\""
      }
    ],
    "IN_4_25_X_6_87": [
      {
        "width": 108,
        "height": 174,
        "unitType": "MILLIMETERS",
        "label": "Pocket Book"
      },
      {
        "width": 4.25,
        "height": 6.87,
        "unitType": "INCHES",
        "label": "Pocket Book"
      }
    ],
    "IN_6_14_X_9_21": [
      {
        "width": 156,
        "height": 234,
        "unitType": "MILLIMETERS",
        "label": "Royal"
      },
      {
        "width": 6.14,
        "height": 9.21,
        "unitType": "INCHES",
        "label": "Royal"
      }
    ],
    "IN_9_5_X_12": [
      {
        "width": 241,
        "height": 305,
        "unitType": "MILLIMETERS",
        "label": "Quarto"
      },
      {
        "width": 9.5,
        "height": 12,
        "unitType": "INCHES",
        "label": "Quarto"
      }
    ],
    "IN_2_X_3_5": [
      {
        "width": 51,
        "height": 89,
        "unitType": "MILLIMETERS",
        "label": "51mm x 89mm"
      },
      {
        "width": 2,
        "height": 3.5,
        "unitType": "INCHES",
        "label": "2\" x 3.5\""
      }
    ],
    "SQUARE_7_IN": [
      {
        "width": 178,
        "height": 178,
        "unitType": "MILLIMETERS",
        "label": "178mm x 178mm"
      },
      {
        "width": 7,
        "height": 7,
        "unitType": "INCHES",
        "label": "7\" x 7\""
      }
    ],
    "IN_4_25_X_55": [
      {
        "width": 108,
        "height": 140,
        "unitType": "MILLIMETERS",
        "label": "108mm x 140mm"
      },
      {
        "width": 4.25,
        "height": 5.5,
        "unitType": "INCHES",
        "label": "4.25\" x 5.5\""
      }
    ],
    "SQUARE_21_MM": [
      {
        "width": 21,
        "height": 21,
        "unitType": "MILLIMETERS",
        "label": "21mm x 21mm"
      },
      {
        "width": 0.827,
        "height": 0.827,
        "unitType": "INCHES",
        "label": "0.827\" x 0.827\""
      }
    ],
    "MM_1000_X_1400": [
      {
        "width": 1000,
        "height": 1400,
        "unitType": "MILLIMETERS",
        "label": "1000mm x 1400mm"
      },
      {
        "width": 39.37,
        "height": 55.118,
        "unitType": "INCHES",
        "label": "39.37\" x 55.118\""
      }
    ],
    "ENVELOPE_C4": [
      {
        "width": 229,
        "height": 324,
        "unitType": "MILLIMETERS",
        "label": "C4"
      },
      {
        "width": 9.016,
        "height": 12.756,
        "unitType": "INCHES",
        "label": "C4"
      }
    ],
    "MM_124_X_140": [
      {
        "width": 124,
        "height": 140,
        "unitType": "MILLIMETERS",
        "label": "124mm x 140mm"
      },
      {
        "width": 4.882,
        "height": 5.512,
        "unitType": "INCHES",
        "label": "4.882\" x 5.512\""
      }
    ],
    "SQUARE_210_MM": [
      {
        "width": 210,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "210mm x 210mm"
      },
      {
        "width": 8.27,
        "height": 8.27,
        "unitType": "INCHES",
        "label": "8.27\" x 8.27\""
      }
    ],
    "ENVELOPE_C5": [
      {
        "width": 162,
        "height": 229,
        "unitType": "MILLIMETERS",
        "label": "C5"
      },
      {
        "width": 6.378,
        "height": 9.016,
        "unitType": "INCHES",
        "label": "C5"
      }
    ],
    "MM_15_X_35": [
      {
        "width": 15,
        "height": 35,
        "unitType": "MILLIMETERS",
        "label": "15mm x 35mm"
      },
      {
        "width": 0.591,
        "height": 1.378,
        "unitType": "INCHES",
        "label": "0.591\" x 1.378\""
      }
    ],
    "MM_1000_X_2000": [
      {
        "width": 1000,
        "height": 2000,
        "unitType": "MILLIMETERS",
        "label": "1000mm x 2000mm"
      },
      {
        "width": 39.37,
        "height": 78.74,
        "unitType": "INCHES",
        "label": "39.37\" x 78.74\""
      }
    ],
    "DL_SMALL_100_MM": [
      {
        "width": 100,
        "height": 210,
        "unitType": "MILLIMETERS",
        "label": "100mm x 210mm"
      },
      {
        "width": 3.94,
        "height": 8.27,
        "unitType": "INCHES",
        "label": "3.94\" x 8.27\""
      }
    ],
    "MM_30_X_70": [
      {
        "width": 30,
        "height": 70,
        "unitType": "MILLIMETERS",
        "label": "30mm x 70mm"
      },
      {
        "width": 1.181,
        "height": 2.756,
        "unitType": "INCHES",
        "label": "1.181\" x 2.756\""
      }
    ],
    "IN_5_375_X_8_375": [
      {
        "width": 137,
        "height": 213,
        "unitType": "MILLIMETERS",
        "label": "137mm x 213mm"
      },
      {
        "width": 5.375,
        "height": 8.375,
        "unitType": "INCHES",
        "label": "5.375\" x 8.375\""
      }
    ],
    "MM_140_X_297": [
      {
        "width": 140,
        "height": 297,
        "unitType": "MILLIMETERS",
        "label": "140mm x 297mm"
      },
      {
        "width": 5.512,
        "height": 11.693,
        "unitType": "INCHES",
        "label": "5.512\" x 11.693\""
      }
    ],
    "MM_1000_X_1200": [
      {
        "width": 1000,
        "height": 1200,
        "unitType": "MILLIMETERS",
        "label": "1000mm x 1200mm"
      },
      {
        "width": 39.37,
        "height": 47.244,
        "unitType": "INCHES",
        "label": "39.37\" x 47.244\""
      }
    ],
    "US_STANDARD": [
      {
        "width": 170,
        "height": 260,
        "unitType": "MILLIMETERS",
        "label": "US Standard"
      },
      {
        "width": 6.693,
        "height": 10.236,
        "unitType": "INCHES",
        "label": "US Standard"
      }
    ],
    "IN_5_X_7": [
      {
        "width": 127,
        "height": 178,
        "unitType": "MILLIMETERS",
        "label": "127mm x 178mm"
      },
      {
        "width": 5,
        "height": 7,
        "unitType": "INCHES",
        "label": "5\" x 7\""
      }
    ],
    "MM_895_X_1280": [
      {
        "width": 895,
        "height": 1280,
        "unitType": "MILLIMETERS",
        "label": "895mm x 1280mm"
      },
      {
        "width": 35.236,
        "height": 50.394,
        "unitType": "INCHES",
        "label": "35.236\" x 50.394\""
      }
    ],
    "MM_200_X_300": [
      {
        "width": 200,
        "height": 300,
        "unitType": "MILLIMETERS",
        "label": "200mm x 300mm"
      },
      {
        "width": 7.874,
        "height": 11.811,
        "unitType": "INCHES",
        "label": "7.874\" x 11.811\""
      }
    ],
    "IN_9_X_12": [
      {
        "width": 229,
        "height": 305,
        "unitType": "MILLIMETERS",
        "label": "229mm x 305mm"
      },
      {
        "width": 9,
        "height": 12,
        "unitType": "INCHES",
        "label": "9\" x 12\""
      }
    ],
    "SQUARE_60_MM": [
      {
        "width": 60,
        "height": 60,
        "unitType": "MILLIMETERS",
        "label": "60mm x 60mm"
      },
      {
        "width": 2.362,
        "height": 2.362,
        "unitType": "INCHES",
        "label": "2.362\" x 2.362\""
      }
    ]
  },
  "orientations": [
    "PORTRAIT",
    "LANDSCAPE"
  ],
  "colours": [
    "NONE",
    "PROCESS",
    "GRAYSCALE"
  ],
  "bindingTypes": [
    "STAPLED",
    "PUR",
    "CASE",
    "WIRO",
    "LOOP",
    "CALENDAR_WIRO",
    "SMYTH_SEWN",
    "COIL"
  ],
  "componentTypes": [
    "FLAT",
    "FOLDED",
    "BOUND",
    "COVER",
    "END_PAPERS",
    "DUST_JACKET",
    "FRAMED",
    "STICKER",
    "ENVELOPE",
    "SHRINK_WRAP"
  ],
  "laminations": [
    "NONE",
    "MATT",
    "GLOSS",
    "SOFT",
    "UV_MATT",
    "UV_GLOSS",
    "SPOT_UV_MATT",
    "SPOT_UV_GLOSS",
    "SPOT_3D_UV_MATT",
    "SPOT_3D_UV_GLOSS",
    "MATT_SPOT_UV",
    "MATT_ANTI_SCUFF"
  ],
  "ribbonColours": [
    "NONE",
    "WHITE",
    "CREAM",
    "GOLD",
    "ORANGE",
    "RED",
    "MAROON",
    "PINK",
    "PURPLE",
    "LIGHT_BLUE",
    "BLUE",
    "NAVY_BLUE",
    "GREEN",
    "DARK_GREEN",
    "GREY",
    "BLACK"
  ],
  "headAndTailBands": [
    "NONE",
    "NAVY_BLUE_AND_WHITE",
    "BLACK_AND_GREEN",
    "RED_AND_BLACK",
    "PURPLE_AND_WHITE",
    "RED_AND_GREY",
    "RED_AND_WHITE",
    "YELLOW_AND_BROWN",
    "DARK_BROWN_AND_WHITE",
    "BLUE_AND_YELLOW",
    "RED_AND_GREEN",
    "YELLOW_AND_GREEN",
    "BLUE_AND_WHITE",
    "DARK_BLUE_AND_WHITE",
    "RED_AND_YELLOW",
    "MAROON_AND_WHITE",
    "YELLOW_AND_BLACK",
    "GREEN_AND_WHITE",
    "BLACK_AND_WHITE",
    "DARK_GREEN_AND_BLACK",
    "DARK_GREEN_AND_WHITE",
    "RED",
    "BLACK",
    "GREY",
    "WHITE",
    "DARK_BLUE",
    "YELLOW"
  ],
  "bindingColours": [
    "BLACK",
    "WHITE",
    "SILVER",
    "GRAY",
    "CLEAR",
    "RED",
    "BLUE",
    "REFLEX_BLUE",
    "YELLOW",
    "COLLEGE_ORANGE",
    "RED_WINE",
    "BURGUNDY",
    "PINK",
    "PASTEL_PINK",
    "FUSCHIA",
    "NAVY_BLUE",
    "PASTEL_BLUE",
    "ROYAL_BLUE",
    "TEAL",
    "MEDIUM_GREEN",
    "PASTEL_GREEN",
    "APPLE_GREEN",
    "PEARL_GREY",
    "DARK_BROWN",
    "PASTEL_BEIGE",
    "CHOCOLATE_BROWN",
    "NEON_GREEN",
    "ORANGE",
    "NEON_PINK",
    "NEON_ORANGE",
    "WARM_RED",
    "PURPLE",
    "VIOLET",
    "FOREST_GREEN",
    "DARK_GREEN",
    "GOLD"
  ],
  "endPaperColours": [
    "WHITE",
    "BLACK",
    "COLORPLAN_ADRIATIC",
    "COLORPLAN_AMETHYST",
    "COLORPLAN_AZURE_BLUE",
    "COLORPLAN_BAGHDAD_BROWN",
    "COLORPLAN_BITTER_CHOCOLATE",
    "COLORPLAN_BRIGHT_RED",
    "COLORPLAN_BRIGHT_WHITE",
    "COLORPLAN_CANDY_PINK",
    "COLORPLAN_CHINA_WHITE",
    "COLORPLAN_CITRINE",
    "COLORPLAN_CLARET",
    "COLORPLAN_COBALT",
    "COLORPLAN_COOL_BLUE",
    "COLORPLAN_COOL_GREY",
    "COLORPLAN_DARK_GREY",
    "COLORPLAN_EBONY",
    "COLORPLAN_EMERALD",
    "COLORPLAN_FACTORY_YELLOW",
    "COLORPLAN_FOREST",
    "COLORPLAN_FUSCHIA_PINK",
    "COLORPLAN_HARVEST",
    "COLORPLAN_HOT_PINK",
    "COLORPLAN_ICE_WHITE",
    "COLORPLAN_IMPERIAL_BLUE",
    "COLORPLAN_LAVENDAR",
    "COLORPLAN_LOCKWOOD_GREEN",
    "COLORPLAN_MANDARIN",
    "COLORPLAN_MARRS_GREEN",
    "COLORPLAN_MID_GREEN",
    "COLORPLAN_MIST",
    "COLORPLAN_NATURAL",
    "COLORPLAN_NEW_BLUE",
    "COLORPLAN_NUBUCK_BROWN",
    "COLORPLAN_PALE_GREY",
    "COLORPLAN_PARK_GREEN",
    "COLORPLAN_PISTACHIO",
    "COLORPLAN_POWDER_GREEN",
    "COLORPLAN_PRISTINE_WHITE",
    "COLORPLAN_PURPLE",
    "COLORPLAN_RACING_GREEN",
    "COLORPLAN_REAL_GREY",
    "COLORPLAN_ROYAL_BLUE",
    "COLORPLAN_SAPPHIRE",
    "COLORPLAN_SCARLET",
    "COLORPLAN_SMOKE",
    "COLORPLAN_SORBET_YELLOW",
    "COLORPLAN_STONE",
    "COLORPLAN_TABRIZ_BLUE",
    "COLORPLAN_TURQUOISE",
    "COLORPLAN_VELLUM_WHITE",
    "COLORPLAN_VERMILLION",
    "COLORPLAN_WHITE_FROST"
  ],
  "foilingColours": [
    "GOLD",
    "SILVER",
    "COPPER",
    "RED",
    "BLUE",
    "GREEN"
  ],
  "borderTypes": [
    "WRAP_AROUND",
    "EDGE_TO_EDGE",
    "PADDED"
  ],
  "simpleFolds": [
    "NONE",
    "HALF",
    "ROLE",
    "Z",
    "GATE",
    "CROSS",
    "PARALLEL",
    "ENVELOPE"
  ],
  "coverAreas": [
    "FRONT_AND_BACK",
    "FRONT_ONLY"
  ],
  "frameDepths": [
    "UNSPECIFIED",
    "MM_18",
    "MM_38"
  ],
  "unitFormats": [
    0,
    1
  ],
  "substrateDesigns": [
    "NONE",
    "LINED"
  ],
  "bindingLoops": [
    "TWO_LOOPS",
    "FOUR_LOOPS"
  ],
  "designOptions": [
    "UPLOAD",
    "DESIGN_ONLINE",
    "DESIGN_SERVICE"
  ],
  "bindingEdges": [
    "LEFT_RIGHT",
    "TOP_BOTTOM"
  ],
  "preDrilledHoles": [
    "NONE",
    "ONE_HOLE_OPPOSITE_BINDING_CENTER",
    "ONE_HOLE_TOP_CENTER"
  ],
  "substrateTypes": {
    "1": "Silk",
    "2": "Gloss",
    "3": "Uncoated",
    "7": "Recycled Uncoated",
    "8": "Recycled Natural",
    "11": "Postcard Board",
    "45": "Recycled Silk",
    "55": "Bookwove",
    "56": "Polyester",
    "57": "Créme",
    "59": "Matt",
    "60": "Uncoated Natural",
    "64": "Grass Paper",
    "65": "Neon Paper",
    "66": "Paper",
    "67": "Recyled Paper",
    "68": "Temperature Resistant Paper",
    "69": "Handmade Paper",
    "70": "Stone Paper",
    "71": "Sugar Cane Fibre Paper",
    "72": "Vinyl",
    "73": "Biodegradeable Vinyl",
    "74": "Extremely Adhesive Vinyl",
    "75": "Removable Vinyl",
    "78": "E-Photo Silk Lustre",
    "79": "Archival Matt",
    "80": "Archival Uncoated",
    "81": "Archival Textured Matt"
  },
  "substrateWeights": {
    "1": {
      "0": "Silk 90gsm",
      "1": "Silk 100gsm",
      "2": "Silk 115gsm",
      "3": "Silk 130gsm",
      "4": "Silk 150gsm",
      "5": "Silk 170gsm",
      "7": "Silk 250gsm",
      "8": "Silk 300gsm",
      "9": "Silk 350gsm",
      "13": "Silk 400gsm",
      "14": "Silk 200gsm",
      "15": "Silk 450gsm",
      "16": "Silk 240gsm",
      "18": "Silk 110gsm"
    },
    "2": {
      "0": "Gloss 90gsm",
      "2": "Gloss 115gsm",
      "3": "Gloss 130gsm",
      "4": "Gloss 150gsm",
      "5": "Gloss 170gsm",
      "7": "Gloss 250gsm",
      "8": "Gloss 300gsm",
      "9": "Gloss 350gsm",
      "11": "Gloss 74gsm",
      "12": "Gloss 104gsm",
      "13": "Gloss 400gsm",
      "14": "Gloss 200gsm"
    },
    "3": {
      "100": "Uncoated 90gsm",
      "104": "Uncoated 150gsm",
      "105": "Uncoated 170gsm",
      "107": "Uncoated 250gsm",
      "108": "Uncoated 300gsm",
      "109": "Uncoated 350gsm",
      "111": "Uncoated 100gsm",
      "112": "Uncoated 120gsm",
      "113": "Uncoated 200gsm",
      "116": "Uncoated 80gsm",
      "119": "Uncoated 110gsm"
    },
    "7": {
      "7001": "Recycled Uncoated 80gsm",
      "7002": "Recycled Uncoated 170gsm",
      "7003": "Recycled Uncoated 250gsm",
      "7004": "Recycled Uncoated 350gsm",
      "7005": "Recycled Uncoated 300gsm",
      "7006": "Recycled Uncoated 100gsm",
      "7007": "Recycled Uncoated 120gsm",
      "7008": "Recycled Uncoated 135gsm",
      "7009": "Recycled Uncoated 150gsm",
      "7010": "Recycled Uncoated 190gsm"
    },
    "8": {
      "8001": "Recycled Natural 80gsm",
      "8002": "Recycled Natural 170gsm",
      "8003": "Recycled Natural 250gsm",
      "8005": "Recycled Natural 300gsm",
      "8006": "Recycled Natural 115gsm",
      "8007": "Recycled Natural 100gsm",
      "8008": "Recycled Natural 135gsm"
    },
    "11": {
      "11001": "Postcard Board 280gsm",
      "11002": "Postcard Board 350gsm",
      "11003": "Postcard Board 300gsm"
    },
    "45": {
      "45003": "Recycled Silk 100gsm",
      "45004": "Recycled Silk 115gsm",
      "45005": "Recycled Silk 130gsm",
      "45006": "Recycled Silk 150gsm",
      "45007": "Recycled Silk 170gsm",
      "45008": "Recycled Silk 200gsm",
      "45009": "Recycled Silk 250gsm",
      "45010": "Recycled Silk 300gsm",
      "45011": "Recycled Silk 350gsm"
    },
    "55": {},
    "56": {
      "55000": "Polyester 260gsm"
    },
    "57": {
      "60000": "Créme 74gsm",
      "60001": "Créme 80gsm",
      "60002": "Créme 70gsm",
      "60003": "Créme 90gsm"
    },
    "59": {
      "62000": "Matt 74gsm",
      "62001": "Matt 104gsm"
    },
    "60": {
      "63000": "Uncoated Natural 80gsm",
      "63001": "Uncoated Natural 90gsm"
    },
    "64": {
      "64000": "Grass Paper 95gsm"
    },
    "65": {
      "65000": "Neon Paper 68gsm",
      "65001": "Neon Paper 80gsm"
    },
    "66": {
      "66000": "Paper 70gsm",
      "66001": "Paper 80gsm",
      "66002": "Paper 85gsm",
      "66003": "Paper 90gsm"
    },
    "67": {
      "67000": "Recyled Paper 90gsm"
    },
    "68": {
      "68000": "Temperature Resistant Paper 80gsm"
    },
    "69": {
      "69000": "Handmade Paper 80gsm",
      "69001": "Handmade Paper 90gsm"
    },
    "70": {
      "70000": "Stone Paper 144gsm"
    },
    "71": {
      "71000": "Sugar Cane Fibre Paper 90gsm"
    },
    "72": {
      "72000": "Vinyl 50gsm",
      "72001": "Vinyl 60gsm",
      "72002": "Vinyl 70gsm",
      "72003": "Vinyl 80gsm",
      "72004": "Vinyl 90gsm",
      "72005": "Vinyl 95gsm",
      "72006": "Vinyl 135gsm",
      "72007": "Vinyl 150gsm"
    },
    "73": {
      "73000": "Biodegradeable Vinyl 45gsm"
    },
    "74": {
      "74000": "Extremely Adhesive Vinyl 60gsm"
    },
    "75": {
      "75000": "Removable Vinyl 60gsm"
    },
    "78": {
      "78001": "E-Photo Silk Lustre 190gsm",
      "78002": "E-Photo Silk Lustre 260gsm"
    },
    "79": {
      "79001": "Archival Matt 240gsm"
    },
    "80": {
      "80001": "Archival Uncoated 300gsm"
    },
    "81": {
      "81001": "Archival Textured Matt 240gsm"
    }
  },
  "quoteTypes": [
    "QUOTE",
    "PUBLICATION",
    "PRINT_ON_DEMAND",
    "FOURTHWALL"
  ],
  "supportedLocales": [
    "en_GB"
  ]
}

Orders API

The Orders API allows you to create or retrieve orders. This API provides comprehensive details about each order, including its status, items, and associated metadata. You can only retrieve an order that has been created under your own user account.


Order Processing Workflow

This section describes the detailed workflow for order processing in Mixam, from the initial order submission to the final order status updates.

Steps in the Order Processing Workflow:
  1. Client Submits Order: The client submits an order create request containing items and artwork to Mixam.
  2. Order Creation: Mixam creates the order and responds to the client confirming the order creation.
  3. Artwork Submission: Mixam submits the artwork to the Assets Processing Engine for processing.
  4. Artwork Validation: The Assets Processing Engine validates the artwork, checking for any errors such as size discrepancies.
  5. Validation Complete: The Assets Processing Engine informs Mixam that the artwork validation is complete.
  6. Webhook Notification: Mixam sends a webhook to the client's specified callback URL containing the status of the order and any artwork errors detected.
  7. Order Placed on Hold: If the artwork has errors or there are missing artwork pages, the order is placed on hold and not automatically processed.
  8. Order Confirmed: If there are no errors in the artwork, Mixam confirms the order.
  9. Order Submitted for Production: Mixam submits the order for production to the Assets Processing Engine.
  10. PDF Conversion: The Assets Processing Engine produces PDF X1A compliant print files.
  11. Conversion Complete: The Assets Processing Engine informs Mixam that the PDF X1A conversion is complete.
  12. Send to Production Facility: Mixam sends the order details to the production facility for processing. The production facility informs Mixam when the item has been dispatched, and Mixam notifies the client via the callback URL that the item has been shipped.
Retrieve Order API Request

Retrieve an Order

To get information about a specific order, make a GET request to the /api/public/orders/{orderId} endpoint.

Retrieve Order API Request
Endpoint:
GET /api/public/orders/{orderId}
Example Request:
curl -X 'GET' \
  'https://mixam.co.uk/api/public/orders/660c01d759b26c4584f7e7b4' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'
Response:
{
  "order": {
    "id": "667bd1342550666dba0efc39",
    "orderNumber": 1294664,
    "orderStatus": "INIT",
    "lastModifiedDate": {
      "date": "2024-06-26T09:28:37.878+01",
      "timestamp": 1719390517878
    },
    "createdDate": {
      "date": "2024-06-26T09:28:36.753+01",
      "timestamp": 1719390516753
    },
    "confirmedDate": {},
    "total": 34.5,
    "totalPaid": 34.5,
    "tax": {
      "taxRate": 20,
      "taxAmount": 0
    },
    "externalMetadata": {
      "externalOrderId": "ORDER-123456",
      "statusCallbackUrl": "https://example.com/callback"
    },
    "deliveries": [
      {
        "id": "372e19bd-5b3f-4338-b1f9-8cc27ae1505f",
        "deliveryAddress": {
          "id": "49221fe2-a664-46ca-aef6-cc09647eb8f1",
          "firstName": "Sherlock",
          "lastName": "Holmes",
          "postcode": "NW1 6XE",
          "line1": "221B Baker Street",
          "line2": "string",
          "line3": "string",
          "town": "London",
          "county": "Marylebone",
          "country": "GB",
          "phone": "+44 1923 594 252",
          "company": "Holmes Investigations",
          "email": "customer@example.com",
          "locationType": "residential",
          "valid": true,
          "postBox": false
        },
        "quantitiesOfItems": {
          "ca151517-4f35-41fb-b846-59081a34cc8e": 10
        },
        "deliveryGroups": [
          {
            "id": "58dab2a6-62d1-4000-8052-97241928e594",
            "itemIds": [
              "ca151517-4f35-41fb-b846-59081a34cc8e"
            ],
            "serviceId": "DHL-DHL_EXPRESS_DOMESTIC-zxa-1",
            "courier": "DHL",
            "courierCode": "DHL",
            "service": "DHL Express Domestic",
            "serviceCode": "N",
            "cost": 5.5,
            "weight": 1.61,
            "dispatchDate": {
              "date": "2024-07-02T00:00:00.000+01",
              "timestamp": 1719874800000
            },
            "deliveryDate": {
              "date": "2024-07-03T00:00:00.000+01",
              "timestamp": 1719961200000
            },
            "includeShipment": false
          }
        ],
        "taxAmount": 0
      }
    ],
    "orderItems": [
      {
        "total": 29,
        "itemStatus": "INIT",
        "itemDescription": "10 Brochure\nSize: A4 (210 mm x 297 mm) - Portrait\nPerfect (PUR), Full-colour printing, 32 pages, 130gsm Silk\nCover: Full-colour printing (outside), Gloss Lamination (outside), 250gsm Silk",
        "viewThisQuoteLink": "https://mixam.co.uk/brochures?copies=10&productId=1&format=4&paper=3&paperFinish=1&colors=5&pages=32&bind=4&coat2=4&ctype=7&coverPaperFinish=1&ccolors=5&quantity=1¤cy=1&universalKey=10%7E1-bd%7B4bt-5c-4f-32p-1st-3sw%7D-cr%7B5c-4f-4l-1st-7sw%7D",
        "discountCodes": [],
        "problemReports": [],
        "externalMetadata": {
          "externalItemId": "ITEM-123456"
        },
        "universalKey": "10~1-bd{4bt-5c-4f-32p-1st-3sw}-cr{5c-4f-4l-1st-7sw}",
        "discountTotal": 0,
        "id": "ca151517-4f35-41fb-b846-59081a34cc8e",
        "itemSpecification": {
          "copies": 10,
          "product": "BROCHURES",
          "components": [
            {
              "componentType": "BOUND",
              "format": 4,
              "standardSize": "NONE",
              "orientation": "PORTRAIT",
              "colours": "PROCESS",
              "substrate": {
                "typeId": 1,
                "weightId": 3,
                "colourId": 0,
                "design": "NONE"
              },
              "lamination": "NONE",
              "pages": 32,
              "binding": {
                "type": "PUR",
                "edge": "LEFT_RIGHT",
                "sewn": false,
                "colour": "BLACK",
                "loops": "TWO_LOOPS",
                "headAndTailBands": "NONE"
              },
              "ribbonColour": "NONE",
              "preDrilledHoles": "NONE",
              "twoSidedComponent": false,
              "laminatedComponent": true,
              "foiledComponent": false,
              "folded": false,
              "hasCustomSize": false
            },
            {
              "componentType": "COVER",
              "format": 4,
              "standardSize": "NONE",
              "orientation": "PORTRAIT",
              "colours": "PROCESS",
              "substrate": {
                "typeId": 1,
                "weightId": 7,
                "colourId": 0,
                "design": "NONE"
              },
              "lamination": "GLOSS",
              "foiling": {
                "gold": false,
                "silver": false,
                "copper": false,
                "red": false,
                "blue": false,
                "green": false,
                "value": ""
              },
              "backColours": "NONE",
              "backLamination": "NONE",
              "backFoiling": {
                "gold": false,
                "silver": false,
                "copper": false,
                "red": false,
                "blue": false,
                "green": false,
                "value": ""
              },
              "coverArea": "FRONT_AND_BACK",
              "twoSidedComponent": true,
              "preDrilledHoles": "NONE",
              "laminatedComponent": true,
              "foiledComponent": true,
              "folded": false,
              "hasCustomSize": false
            }
          ],
          "bound": true,
          "customSize": false,
          "hasFoiling": false
        },
        "allowReorder": false
      }
    ],
    "totalAfterDiscount": 34.5,
    "discountTotal": 0
  }
}

Create an Order

To create a new order, make a POST request to the /api/public/orders endpoint. Each item can specify an offerId or leave it blank. If the offerId is left blank, then the system will automatically choose the best price option. This is useful if you just want to integrate the Order API without retrieving a live price.

Webhooks

It is important to listen to the callback requests sent to the specified statusCallbackUrl when creating an order. When an order is submitted, we asynchronously validate the artwork files, which can take some time depending on the size of the files. If an error is detected during this validation process, the order will not be processed. Therefore, it is crucial to handle these callbacks appropriately to ensure that any artwork errors are addressed promptly.

Create Order API Request
Request Attributes
Attribute Required Type Description
metadata Yes Object Metadata related to the order. This is a container for storing external data about the order.
metadata.externalOrderId Yes String The external ID for the order i.e. Your reference number.
metadata.statusCallbackUrl Yes String The URL for status callbacks. We will send ACKs back to this endpoint with status updates.
orderItems Yes Array of Objects List of items included in the order.
orderItems[].product Yes String The product type, e.g., BROCHURES.
orderItems[].subProductId Yes Integer The ID of the sub-product.
orderItems[].quoteType Yes String The type of quote. The default of QUOTE should be used in most instances unless instructed otherwise.
orderItems[].itemSpecification Conditional Object The descriptor of the item being ordered. Either an itemSpecification or universalKey should be present.
orderItems[].universalKey Conditional String The universal key for the item specification. Either an itemSpecification or universalKey should be present.
orderItems[].assets Yes Array of Objects Assets associated with the order item.
orderItems[].assets[].name Yes String The name of the asset file. e.g., cover.pdf.
orderItems[].assets[].url Yes String The URL of the asset.
orderItems[].metadata No Object Container for external metadata for the order item.
orderItems[].metadata.externalItemId No String The external ID for the order item.
orderItems[].offerId No String The offer ID related to the order item. Use this if you would like a specific price offer such as express, otherwise the system will just use the best price option.
billingAddress Yes Object Billing address for the order.
billingAddress.company Yes String The company name for the billing address.
billingAddress.firstName Yes String The first name for the billing address.
billingAddress.lastName Yes String The last name for the billing address.
billingAddress.postcode Yes String The postal code for the billing address.
billingAddress.line1 Yes String The first line of the billing address.
billingAddress.line2 No String The second line of the billing address.
billingAddress.line3 No String The third line of the billing address.
billingAddress.town Yes String The town for the billing address.
billingAddress.county Yes String The county for the billing address.
billingAddress.country Yes String The country for the billing address. ISO2 country code format (e.g., GB).
billingAddress.phoneNumber Yes String The phone number for the billing address.
billingAddress.emailAddress Yes String The email address for the billing address.
invoiceAddress Yes Object Invoice address for the order.
invoiceAddress.company Yes String The company name for the invoice address.
invoiceAddress.firstName Yes String The first name for the invoice address.
invoiceAddress.lastName Yes String The last name for the invoice address.
invoiceAddress.postcode Yes String The postal code for the invoice address.
invoiceAddress.line1 Yes String The first line of the invoice address.
invoiceAddress.line2 No String The second line of the invoice address.
invoiceAddress.line3 No String The third line of the invoice address.
invoiceAddress.town Yes String The town for the invoice address.
invoiceAddress.county Yes String The county for the invoice address.
invoiceAddress.country Yes String The country for the invoice address. ISO2 country code format (e.g., GB).
invoiceAddress.phoneNumber Yes String The phone number for the invoice address.
invoiceAddress.emailAddress Yes String The email address for the invoice address.
deliveries Yes Array of Objects List of delivery details.
deliveries[].address Yes Object Delivery address for the order.
deliveries[].address.company Yes String The company name for the delivery address.
deliveries[].address.firstName Yes String The first name for the delivery address.
deliveries[].address.lastName Yes String The last name for the delivery address.
deliveries[].address.postcode Yes String The postal code for the delivery address.
deliveries[].address.line1 Yes String The first line of the delivery address.
deliveries[].address.line2 No String The second line of the delivery address.
deliveries[].address.line3 No String The third line of the delivery address.
deliveries[].address.town Yes String The town for the delivery address.
deliveries[].address.county Yes String The county for the delivery address.
deliveries[].address.country Yes String The country for the delivery address. ISO2 country code format (e.g., GB).
deliveries[].address.phoneNumber Yes String The phone number for the delivery address.
deliveries[].address.emailAddress Yes String The email address for the delivery address.
deliveries[].itemDeliveryDetails Yes Array of Objects Details of the items for delivery.
deliveries[].itemDeliveryDetails[].itemId Yes String The external ID of the item to be delivered.
deliveries[].itemDeliveryDetails[].copies Yes Integer The number of copies to be delivered.
plainPackaging No Boolean If true, the order will be delivered in plain packaging.
paymentMethod Yes String The payment method for the order. Possible values are TEST_ORDER, ACCOUNT and CARD_ON_FILE. For test orders and integration testing please use TEST_ORDER as this will ensure that none of our automated processing features come into play.
Endpoint:
GET /api/public/orders/{orderId}
Example Request:
curl -X 'POST' \
  'https://mixam.co.uk/api/public/orders' \
  -H 'accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "metadata": {
    "externalOrderId": "ORDER-123456",
    "statusCallbackUrl": "https://example.com/callback"
  },
  "orderItems": [
    {
      "product": "BROCHURES",
      "subProductId": 0,
      "quoteType": "QUOTE",
      "itemSpecification": {
        "copies": 10,
        "product": "BROCHURES",
        "components": [
          {
            "componentType": "BOUND",
            "format": 4,
            "standardSize": "NONE",
            "orientation": "PORTRAIT",
            "colours": "PROCESS",
            "substrate": {
              "typeId": 1,
              "weightId": 3,
              "colourId": 0
            },
            "pages": 32,
            "lamination": "NONE",
            "binding": {
              "type": "PUR"
            }
          },
          {
            "componentType": "COVER",
            "format": 4,
            "standardSize": "NONE",
            "orientation": "PORTRAIT",
            "colours": "PROCESS",
            "substrate": {
              "typeId": 1,
              "weightId": 7,
              "colourId": 0
            },
            "lamination": "GLOSS",
            "backColours": "NONE",
            "backLamination": "NONE"
          }
        ]
      },
      "assets": [
        {
          "url": "https://example.com/cover.pdf",
          "name": "cover.pdf"
        },
        {
          "url": "https://example.com/body.pdf",
          "name": "body.pdf"
        }
      ],
      "metadata": {
        "externalItemId": "ITEM-123456"
      }
    }
  ],
  "billingAddress": {
    "company": "Holmes Investigations",
    "firstName": "Sherlock",
    "lastName": "Holmes",
    "postcode": "NW1 6XE",
    "line1": "221B Baker Street",
    "line2": "string",
    "line3": "string",
    "town": "London",
    "county": "Marylebone",
    "country": "GB",
    "phoneNumber": "+44 1923 594 252",
    "emailAddress": "customer@example.com"
  },
  "invoiceAddress": {
    "company": "Holmes Investigations",
    "firstName": "Sherlock",
    "lastName": "Holmes",
    "postcode": "NW1 6XE",
    "line1": "221B Baker Street",
    "line2": "string",
    "line3": "string",
    "town": "London",
    "county": "Marylebone",
    "country": "GB",
    "phoneNumber": "+44 1923 594 252",
    "emailAddress": "customer@example.com"
  },
  "deliveries": [
    {
      "address": {
        "company": "Holmes Investigations",
        "firstName": "Sherlock",
        "lastName": "Holmes",
        "postcode": "NW1 6XE",
        "line1": "221B Baker Street",
        "line2": "string",
        "line3": "string",
        "town": "London",
        "county": "Marylebone",
        "country": "GB",
        "phoneNumber": "+44 1923 594 252",
        "emailAddress": "customer@example.com"
      },
      "itemDeliveryDetails": [
        {
          "itemId": "ITEM-123456",
          "copies": 10
        }
      ]
    }
  ],
  "plainPackaging": true,
  "paymentMethod": "ACCOUNT"
}'
Response:
{
  "order": {
    "id": "667bd1342550666dba0efc39",
    "orderNumber": 1294664,
    "orderStatus": "INIT",
    "lastModifiedDate": {
      "date": "2024-06-26T09:28:37.878+01",
      "timestamp": 1719390517878
    },
    "createdDate": {
      "date": "2024-06-26T09:28:36.753+01",
      "timestamp": 1719390516753
    },
    "confirmedDate": {},
    "total": 34.5,
    "totalPaid": 34.5,
    "tax": {
      "taxRate": 20,
      "taxAmount": 0
    },
    "externalMetadata": {
      "externalOrderId": "ORDER-123456",
      "statusCallbackUrl": "https://example.com/callback"
    },
    "deliveries": [
      {
        "id": "372e19bd-5b3f-4338-b1f9-8cc27ae1505f",
        "deliveryAddress": {
          "id": "49221fe2-a664-46ca-aef6-cc09647eb8f1",
          "firstName": "Sherlock",
          "lastName": "Holmes",
          "postcode": "NW1 6XE",
          "line1": "221B Baker Street",
          "line2": "string",
          "line3": "string",
          "town": "London",
          "county": "Marylebone",
          "country": "GB",
          "phone": "+44 1923 594 252",
          "company": "Holmes Investigations",
          "email": "customer@example.com",
          "locationType": "residential",
          "valid": true,
          "postBox": false
        },
        "quantitiesOfItems": {
          "ca151517-4f35-41fb-b846-59081a34cc8e": 10
        },
        "deliveryGroups": [
          {
            "id": "58dab2a6-62d1-4000-8052-97241928e594",
            "itemIds": [
              "ca151517-4f35-41fb-b846-59081a34cc8e"
            ],
            "serviceId": "DHL-DHL_EXPRESS_DOMESTIC-zxa-1",
            "courier": "DHL",
            "courierCode": "DHL",
            "service": "DHL Express Domestic",
            "serviceCode": "N",
            "cost": 5.5,
            "weight": 1.61,
            "dispatchDate": {
              "date": "2024-07-02T00:00:00.000+01",
              "timestamp": 1719874800000
            },
            "deliveryDate": {
              "date": "2024-07-03T00:00:00.000+01",
              "timestamp": 1719961200000
            },
            "includeShipment": false
          }
        ],
        "taxAmount": 0
      }
    ],
    "orderItems": [
      {
        "total": 29,
        "itemStatus": "INIT",
        "itemDescription": "10 Brochure\nSize: A4 (210 mm x 297 mm) - Portrait\nPerfect (PUR), Full-colour printing, 32 pages, 130gsm Silk\nCover: Full-colour printing (outside), Gloss Lamination (outside), 250gsm Silk",
        "viewThisQuoteLink": "https://mixam.co.uk/brochures?copies=10&productId=1&format=4&paper=3&paperFinish=1&colors=5&pages=32&bind=4&coat2=4&ctype=7&coverPaperFinish=1&ccolors=5&quantity=1¤cy=1&universalKey=10%7E1-bd%7B4bt-5c-4f-32p-1st-3sw%7D-cr%7B5c-4f-4l-1st-7sw%7D",
        "discountCodes": [],
        "problemReports": [],
        "externalMetadata": {
          "externalItemId": "ITEM-123456"
        },
        "universalKey": "10~1-bd{4bt-5c-4f-32p-1st-3sw}-cr{5c-4f-4l-1st-7sw}",
        "discountTotal": 0,
        "id": "ca151517-4f35-41fb-b846-59081a34cc8e",
        "itemSpecification": {
          "copies": 10,
          "product": "BROCHURES",
          "components": [
            {
              "componentType": "BOUND",
              "format": 4,
              "standardSize": "NONE",
              "orientation": "PORTRAIT",
              "colours": "PROCESS",
              "substrate": {
                "typeId": 1,
                "weightId": 3,
                "colourId": 0,
                "design": "NONE"
              },
              "lamination": "NONE",
              "pages": 32,
              "binding": {
                "type": "PUR",
                "edge": "LEFT_RIGHT",
                "sewn": false,
                "colour": "BLACK",
                "loops": "TWO_LOOPS",
                "headAndTailBands": "NONE"
              },
              "ribbonColour": "NONE",
              "preDrilledHoles": "NONE",
              "twoSidedComponent": false,
              "laminatedComponent": true,
              "foiledComponent": false,
              "folded": false,
              "hasCustomSize": false
            },
            {
              "componentType": "COVER",
              "format": 4,
              "standardSize": "NONE",
              "orientation": "PORTRAIT",
              "colours": "PROCESS",
              "substrate": {
                "typeId": 1,
                "weightId": 7,
                "colourId": 0,
                "design": "NONE"
              },
              "lamination": "GLOSS",
              "foiling": {
                "gold": false,
                "silver": false,
                "copper": false,
                "red": false,
                "blue": false,
                "green": false,
                "value": ""
              },
              "backColours": "NONE",
              "backLamination": "NONE",
              "backFoiling": {
                "gold": false,
                "silver": false,
                "copper": false,
                "red": false,
                "blue": false,
                "green": false,
                "value": ""
              },
              "coverArea": "FRONT_AND_BACK",
              "twoSidedComponent": true,
              "preDrilledHoles": "NONE",
              "laminatedComponent": true,
              "foiledComponent": true,
              "folded": false,
              "hasCustomSize": false
            }
          ],
          "bound": true,
          "customSize": false,
          "hasFoiling": false
        },
        "allowReorder": false
      }
    ],
    "totalAfterDiscount": 34.5,
    "discountTotal": 0
  }
}

Retrieve Order Status

To get the status of a specific order, make a GET request to the /api/public/orders/{orderId}/status endpoint.

Endpoint:
GET /api/public/orders/{orderId}/status
Example Request:
curl -X 'GET' \
  'https://mixam.co.uk/api/public/orders/663234f3fc6abb4269dc51b5/status' \
  -H 'accept: application/json' \
  -H 'Authorization: Bearer YOUR_JWT_TOKEN'
Response:
{
  "orderId": "663234f3fc6abb4269dc51b5",
  "status": "DISPATCHED",
  "items": [
    {
      "itemId": "3af32416-052f-40b8-99b4-1a5f37b4813b",
      "errors": [],
      "hasErrors": false
    }
  ],
  "shipments": [
    {
      "itemsInShipment": {
        "3af32416-052f-40b8-99b4-1a5f37b4813b": 10
      },
      "trackingUrl": "https://www.dhl.com/gb-en/home/tracking.html?tracking-id=5613627876",
      "consignmentNumber": "5613627876",
      "courier": "DHL",
      "parcelNumbers": [
        "JD014600004860185763"
      ],
      "date": {
        "date": "2024-05-01T13:31:08.128+01",
        "timestamp": 1714566668128
      }
    }
  ],
  "artworkComplete": true,
  "hasErrors": false
}

Open API Schema

Please note: It is essential to make requests to the correct server, as each of our Mixam shops operates independently. To ensure proper communication, use the specific server address for the appropriate shop:

  • Mixam UK - https://mixam.co.uk
  • Mixam USA - https://mixam.com
  • Mixam Canada - https://mixam.ca
  • Mixam Australia - https://mixam.com.au
  • Mixam Germany - https://mixam.de

Webhooks API

The Webhooks API allows you to receive real-time updates about the status of your orders. When you create an order via the API, you can specify a callback URL where we will send status updates. Whenever the status of the order changes, we send the data as JSON to the specified endpoint via an HTTP POST request. If you prefer not to use webhooks to retrieve the order status, you can use the Order API to poll for the same order status information using the endpoint api/public/orders/{orderId}/status.


Order Status Update Webhook

The Order Status Update Webhook is triggered whenever the status of an order changes. This allows you to keep track of your orders in real time by receiving updates directly to your specified callback URL.

Endpoint:

The endpoint should be specified as the callbackUrl when creating an order. The URL must be capable of handling HTTP POST requests.

Example Payload:
{
  "orderId": "66438bb90c9b7d7b15927e80",
  "status": "ONHOLD",
  "statusReason": "Artwork has errors that need correcting",
  "metadata": {
    "externalOrderId": "ORDER-123456",
    "statusCallbackUrl": "https://example.com/mixam/order/status/update"
  },
  "items": [
    {
      "itemId": "1e115429-b50e-4922-8306-449fe594e429",
      "metadata": {
        "externalItemId": "ITEM-123456"
      },
      "errors": [
        {
          "filename": "3a021855-70db-4559-9b85-9334b7a62910.pdf",
          "page": 1,
          "message": "The supplied outer cover spread artwork size (424.2mm x 297mm) does not match the recommended size (298mm x 210mm)."
        }
      ],
      "hasErrors": true
    }
  ],
  "hasErrors": true,
  "artworkComplete": false,
  "shipments": [
    {
      "itemsInShipment": {
        "3af32416-052f-40b8-99b4-1a5f37b4813b": 10
      },
      "trackingUrl": "https://www.dhl.com/gb-en/home/tracking.html?tracking-id=5613627876",
      "consignmentNumber": "5613627876",
      "courier": "DHL",
      "parcelNumbers": [
        "JD014600004860185763"
      ],
      "date": {
        "date": "2024-05-01T13:31:08.128+01",
        "timestamp": 1714566668128
      }
    }
  ]
}
Fields:
Field Type Description
orderId String The unique identifier for the order.
status String The current status of the order (e.g., PENDING, INPRODUCTION, DISPATCHED).
statusReason String The reason for the current status of the order (e.g. why was the order put on hold?).
metadata Object Additional metadata related to the order.
metadata.externalOrderId String The external identifier for the order.
metadata.statusCallbackUrl String The URL for status callback updates.
items Array A list of items included in the order.
items[].itemId String The unique identifier for the item.
items[].metadata Object Additional metadata related to the item.
items[].metadata.externalItemId String The external identifier for the item.
items[].errors Array A list of errors detected in the item artwork.
items[].errors[].filename String The filename of the artwork file where the error was detected.
items[].errors[].page Integer The page number where the error was detected.
items[].errors[].message String A detailed message describing the error.
items[].hasErrors Boolean Indicates if the item has errors.
hasErrors Boolean Indicates if the order has errors.
artworkComplete Boolean Indicates if the artwork for the order is complete.
shipments Array A list of shipments associated with the order.
shipments[].itemsInShipment Object A map of item IDs to the quantity shipped.
shipments[].trackingUrl String The tracking URL for the shipment.
shipments[].consignmentNumber String The consignment number for the shipment.
shipments[].courier String The courier service used for the shipment.
shipments[].parcelNumbers Array A list of parcel numbers associated with the shipment.
shipments[].date Object The date details of the shipment.
shipments[].date.date String The date and time of the shipment.
shipments[].date.timestamp Integer The timestamp of the shipment date.

Artwork Guidelines

The Artwork Guidelines provide detailed instructions on how to prepare and submit your artwork files for various types of products. Adhering to these guidelines will help ensure that your order is processed smoothly and efficiently.


Bound Items

For bound items, the artwork should be supplied as two separate components: Covers and Body. Each component should be in a format that supports multipage documents, such as PDF, Word, or PowerPoint.

  • Covers: The covers can be supplied as either a single spread or individual page elements (Front Cover, Back Cover, and Spine). We recommend naming the file Covers.
  • Body: The body pages can be supplied as either double page spreads or single pages. We recommend naming the file Body.

Flat Items

For flat items, the artwork should be supplied as a single document. If the product is double-sided, ensure that the first page in the document is the Front Side and the last page is the Back Side.

Folded Items

For folded items, the artwork should be supplied as a single document, preferably as a spread (flat size). If the product is double-sided, ensure that the first spread in the document is the Front Side and the last spread is the Back Side.

General Recommendations
  • File Format: Use high-resolution PDF files whenever possible to ensure the best print quality.
  • Color Mode: Ensure your files are in CMYK color mode to avoid color discrepancies during printing.
  • Bleed: Include a 3mm bleed on all sides of your artwork to prevent white edges after trimming.
  • Safe Area: Keep important elements (text, logos, etc.) at least 5mm away from the edges to avoid being cut off.
  • Fonts: Embed all fonts or convert text to outlines to prevent font substitution issues.