any OK
Retrieve a list of catalog product categories To retrieve information about a particular products categories, use this feature. It returns details about the catalog categories associated with the catalog product. Categories help identify the type of product associated with them. For instance, the category "Men's T-shirts" denotes that the product is a subgroup of T-shirts intended for men.
Product ID.
any OK
Retrieve information about specific category Returns information about a specific catalog category. The categories specify the type of the product that is associated with it. For example, the category "Men’s T-shirts" indicates that the product is a subgroup of T-shirts specifically targeted at Men. Categories can be used to filter the product list by specific tags See categories_ids
Category ID
any OK
Retrieve catalog product mockup templates Returns positional data for specified catalog product mockups. The data from this endpoint could be used to generate your own mockups without the need to use Printful's mockup generator.
Product ID.
Optional
placements: string[]One or more identifiers of a placement to return only products with variants that have that placement. The complete list of placements can be found here.
Only returns the products that can be sold in the specified region.
The number of results to return per page.
Optional
offset: numberThe number of results to not include in the response starting from the beginning of the list.
This can be used to return results after the initial 100. For example, sending offset 100
any OK
Retrieve a single catalog product Returns information about a single specified catalog product. See catalog product
Product ID.
Only returns the products that can be sold in the specified region.
any OK
Retrieve blank images for a catalog product
This feature helps to fetch blank images for a catalog product. These blank images are always white and semi-transparent and can be colored by the user on the client-side as per the specified color in the data.color
field. The endpoint allows filtering of the result based on the type of the mockup, the placement, and the color of the product.
Product ID.
Optional
mockupStyleIds: numberUsed to specify style of images For example:
Optional
colors: stringString values separated by comma. You can specify multiple variant colors filters.
Optional
placement: stringFilters result by specified placement
any OK
Retrieve catalog product prices Calculates prices for specific catalog product based on selling region and specified currency. Calculations also include Store discounts. Selling region is used to specify product production currency, that is the price that the product is natively manufactured in. Different selling regions might affect the overall price amount. Currency parameter is used only to define the currency that the prices will be displayed in.
Product ID.
Optional
sellingRegionName: stringSpecifies the region production currency that the product prices will be calculated in
Optional
currency: stringThe currency (3-letter code) used to determine currency in which the prices will be displayed. The store currency will be used by default. The format is compliant with ISO 4217 standard.
any OK
Retrieve size guide for a catalog product Returns information about the size guide for a specific product.
Product ID.
Optional
unit: stringA comma-separated list of measurement unit in which size tables are to be returned (inches
or cm
).
The default value is determined based on the locale country. The inches are used for United States, Liberia
and Myanmar, for other countries the unit defaults to centimeters.
any OK
Retrieve catalog product stock availability Provides information about the catalog product stock status. Stock availability is grouped by variants → techniques → selling regions.
Product ID.
Optional
techniques: TechniqueEnum[]One or more techniques to return only products with variants that can be printed using one of the techniques.
Only returns the products that can be sold in the specified region.
The number of results to return per page.
Optional
offset: numberThe number of results to not include in the response starting from the beginning of the list.
This can be used to return results after the initial 100. For example, sending offset 100
any OK
Retrieve information about catalog product variants Returns information about all catalog variants associated with the specified catalog product. See catalog variant
Product ID.
any OK
Retrieve a list of catalog products This endpoint retrieves a list of the products available in Printful's catalog. The list is paginated and can be filtered using various filters. The information returned includes details on how each product can be designed, such as the available placements, techniques, and additional options. For a visual representation of the design data, please see the following diagram:
Optional
categoryIds: number[]One or more category IDs to return only products in those categories. The IDs can be found in the response of the operation Get Categories.
Optional
colors: string[]One or more color names to return only products with variants of one the those colors.
The number of results to return per page.
If true only new Products will be returned.
Optional
offset: numberThe number of results to not include in the response starting from the beginning of the list.
This can be used to return results after the initial 100. For example, sending offset 100
Optional
placements: string[]One or more identifiers of a placement to return only products with variants that have that placement. The complete list of placements can be found here.
Only returns the products that can be sold in the specified region.
This parameter only is used if sort_type is also present and it changes the order of the returned products.
The exact meaning varies depending on the value of sort_type
:
sort_type=new
sort_type=rating
sort_type=price
Optional
sortType: "new" | "rating" | "price"The sorting strategy to use when sorting the result. When it's not present, no specific order is guaranteed.
Optional
techniques: TechniqueEnum[]One or more techniques to return only products with variants that can be printed using one of the techniques.
any OK
Retrieve information about specific catalog variant Returns information about single specified catalog variant. See catalog variant
Variant ID
any OK
Retrieve blank images for a catalog variant Returns images for a specified Variant.
Variant ID
Optional
mockupStyleIds: numberUsed to specify style of images For example:
Optional
placement: stringFilters result by specified placement
any OK
Retrieve pricing information for the catalog variant Return pricing information from a single variant and the parent product
Variant ID
Optional
sellingRegionName: stringSpecifies the region production currency that the product prices will be calculated in
Optional
currency: stringThe currency (3-letter code) used to determine currency in which the prices will be displayed. The store currency will be used by default. The format is compliant with ISO 4217 standard.
any OK
Retrieve catalog variant stock availability Provides information about the catalog variant stock status. Stock availability is grouped by variants → techniques → selling regions.
Variant ID
Optional
techniques: TechniqueEnum[]One or more techniques to return only products with variants that can be printed using one of the techniques.
Only returns the products that can be sold in the specified region.
any OK
Retrieve catalog product mockup styles Returns information about available mockup styles for specified catalog product.
Product ID.
Optional
placements: string[]One or more placement idenitifiers used to filter in mockup styles that match a given placement. The complete list of placements can be found here.
Only returns the products that can be sold in the specified region.
Optional
offset: numberResult set offset
Optional
limit: numberNumber of items per page (max 100)
any OK
Retrieve a list of catalog categories Returns list of all categories that are present in the catalog. The categories specify the type of the product that is associated with it. For example, the category "Men’s T-shirts" indicates that the product is a subgroup of T-shirts specifically targeted at Men. Categories can be used to filter the product list by specific tags See categories_ids