Just Merch API
Store APIAdmin API
Store APIAdmin API
Discord
  1. Store API
  • Intro
  • Client SDKs
  • Authentication
  • Get categories
    GET
  • Get products
    GET
  1. Store API

Get products

GET
/v1/catalog/products
Retrieves a list of products from the catalog.

Use Cases#

client-side javascript fetch of available products for display to the customer
server-side inventory sync

Request

Authorization
Add parameter in header
clientId
Example:
clientId: ********************
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'http://localhost:8083/v1/catalog/products?bestFor&limit=10&category=Hats&minimum=10' \
--header 'clientId;'

Responses

🟢200OK
application/json
Body

Example
[
    
    {
        "id": "1zpSm2",
        "name": "Men's T-Shirt",
        "mockups": [
            {
                "id": "gTdjuG",
                "name": "gTdjuG",
                "showcase": true,
                "basis_json_url": "https://mockups.artshop.ai/assets/gTdjuG-JNDBnV.json",
                "hasOwnBackground": true,
                "mockup_url": "https://imagedelivery.net/HdeUgBrl8i-TIb1frGXG8g/e3691a33-ade6-4176-6afa-fa8412796300/public",
                "reflections_url": "",
                "shift_x": 0,
                "shift_y": 0,
                "overlays_url": "",
                "horizontal_alignment": "",
                "vertical_alignment": "",
                "isFloatingObject": false,
                "map_url": "https://imagedelivery.net/HdeUgBrl8i-TIb1frGXG8g/61f259ba-9169-4479-b9c4-d59c56e5c100/public",
                "max_width": 4000,
                "max_height": 4000,
                "masks": [
                    {
                        "id": "4",
                        "name": "4",
                        "brightness": 1,
                        "contrast": 1,
                        "saturation": 1,
                        "mask_url": "https://imagedelivery.net/HdeUgBrl8i-TIb1frGXG8g/5f4d2767-47af-44ab-04ca-619298761100/public",
                        "cropVariant": "square2100maxWidth2100maxHeight",
                        "aspect_ratio_width": 0,
                        "aspect_ratio_height": 0,
                        "calibrated_height": 1500,
                        "calibrated_width": 1500,
                        "printable_height": 2100,
                        "printable_width": 2100,
                        "displacement_x": -60,
                        "displacement_y": 60,
                        "curveStrength": 0,
                        "quad": [
                            {
                                "x": 221,
                                "y": 252
                            },
                            {
                                "x": 1214,
                                "y": 350
                            },
                            {
                                "x": 1184,
                                "y": 1365
                            },
                            {
                                "x": 258,
                                "y": 1381
                            }
                        ],
                        "sortOrder": 5
                    },
                    {
                        "id": "3",
                        "name": "3",
                        "brightness": 1,
                        "contrast": 1,
                        "saturation": 1,
                        "mask_url": "https://imagedelivery.net/HdeUgBrl8i-TIb1frGXG8g/a7050bdb-3696-4b01-de1f-ae99568fb100/public",
                        "cropVariant": "square2100maxWidth2100maxHeight",
                        "aspect_ratio_width": 0,
                        "aspect_ratio_height": 0,
                        "calibrated_height": 1500,
                        "calibrated_width": 1500,
                        "printable_height": 2100,
                        "printable_width": 2100,
                        "displacement_x": -60,
                        "displacement_y": 60,
                        "curveStrength": 0,
                        "quad": [
                            {
                                "x": 302,
                                "y": 357
                            },
                            {
                                "x": 1216,
                                "y": 346
                            },
                            {
                                "x": 1230,
                                "y": 1456
                            },
                            {
                                "x": 216,
                                "y": 1474
                            }
                        ],
                        "sortOrder": 4
                    },
                    {
                        "id": "2",
                        "name": "2",
                        "brightness": 1,
                        "contrast": 1,
                        "saturation": 1,
                        "mask_url": "https://imagedelivery.net/HdeUgBrl8i-TIb1frGXG8g/a91cc910-edb4-4257-91d6-c9548cd5c900/public",
                        "cropVariant": "square2100maxWidth2100maxHeight",
                        "aspect_ratio_width": 0,
                        "aspect_ratio_height": 0,
                        "calibrated_height": 1500,
                        "calibrated_width": 1500,
                        "printable_height": 2100,
                        "printable_width": 2100,
                        "displacement_x": -60,
                        "displacement_y": 60,
                        "curveStrength": 0,
                        "quad": [
                            {
             
Modified at 2024-06-28 22:23:00
Previous
Get categories
Built with