Our API is currently in open beta, if you encounter any issues or have a suggestion, please email us at [email protected]. Your insights are invaluable to us.

Lumaprints API

Retrieve all subcategories under a category.

Sandbox

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

GET

/api/v1/products/categories/{categoryId}/subcategories

Product

Retrieve all subcategories under a category currently being offered.

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

Path Params

categoryId

number

required

The category id of the subcategories to retrieve.

Example:

101

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://us.api-sandbox.lumaprints.com/api/v1/products/categories/101/subcategories' \
--header 'Authorization: Basic Og=='

Responses

🟢200Subcategories retrieved successfully.

application/json

Body

array of:

subcategoryId

number

required

The id of the subcategory.

Example:

101001

name

string

required

The name of the subcategory.

Example:

0.75in Stretched Canvas

minimumWidth

number

required

The minimum width of the subcategory product.

Example:

maximumWidth

number

required

The maximum width of the subcategory product.

Example:

120

minimumHeight

number

required

The minimum height of the subcategory product.

Example:

maximumHeight

number

required

The maximum height of the subcategory product.

Example:

requiredDPI

number

required

The required DPI of the subcategory product.

Example:

200

Example

[
  {
    "subcategoryId": 101001,
    "name": "0.75in Stretched Canvas",
    "minimumWidth": 5,
    "maximumWidth": 120,
    "minimumHeight": 5,
    "maximumHeight": 52,
    "requiredDPI": 200
  }
]

Retrieve all categories available.

Retrieve all options available for the subcategory.