Our API is currently in open beta, if you encounter any issues or have a suggestion, please email us at devs@lumaprints.com. Your insights are invaluable to us.

Products cost

Sandbox

https://us.api-sandbox.lumaprints.com

POST

/api/v1/pricing/products

Returns the calculated prices for multiple products in a single request. Each item in the request should specify its subcategory, size dimensions, and any optional product options. The response returns an array of results in the same order as the request, with each entry containing the product price along with all applicable options and their individual prices.

This endpoint is useful for minimizing round trips when pricing a cart, order, or product catalog. If a particular item cannot be priced (e.g., due to an invalid subcategory or unsupported size), its corresponding result will include an error indicator instead of a price, while the rest of the batch will still be processed and returned.

Request

Authorization

Send your HTTP requests with an

Authorization

header that contains the word Basic followed by a space and a base64-encoded string username:password

Example:

Authorization: Basic *****************

Body Params application/json

Example

[
    {
        "subcategoryId": 101001,
        "size": {
            "width": 16,
            "height": 20
        }
    },
    {
        "subcategoryId": 102001,
        "size": {
            "width": 12,
            "height": 16
        },
        "options": [
            1,
            11,
            21
        ]
    }
]

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://us.api-sandbox.lumaprints.com/api/v1/pricing/products' \
--header 'Authorization: Basic <encoded-value>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "subcategoryId": 101001,
        "size": {
            "width": 16,
            "height": 20
        }
    },
    {
        "subcategoryId": 102001,
        "size": {
            "width": 12,
            "height": 16
        },
        "options": [
            1,
            11,
            21
        ]
    }
]'

Responses

🟢200Success

application/json

Body

Example

[
    {
        "success": true,
        "subcategoryId": 101001,
        "size": {
            "width": 16,
            "height": 20
        },
        "price": 24.99,
        "options": [
            {
                "optionId": 3,
                "optionGroupName": "Mounting",
                "optionName": "No Mounting",
                "price": 0
            }
        ]
    },
    {
        "success": false,
        "subcategoryId": 102001,
        "size": {
            "width": 12,
            "height": 16
        },
        "error": "Frame style option from option group 5 is required for subcategory 102001",
        "statusCode": 400
    }
]

Modified at 2026-03-04 23:03:32

Product cost

Subscribe to a new event