Get Products - MANGOTEEPRINTS

Get list of products.

Required permission: read:products

Query parameters:

page: Page number (default: 1)

limit: Items per page (default: 20, max: 100)

catalog_id: Filter by catalog

name: Search by product name

min_price: Minimum price filter

max_price: Maximum price filter

is_active: Filter by active status (default: true)

Returns:
List of products with pagination

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Successful Response

application/json

Body

Example

{
    "code": "SUCCESS",
    "data": {
        "items": [
            {
                "attributes": {
                    "gender": [
                        "Hard Goods"
                    ],
                    "group": "Hat",
                    "print_areas": [
                        "center_hat",
                        "left_hat",
                        "right_hat",
                        "back_hat"
                    ]
                },
                "base_price": "0.00",
                "catalog_id": "1dde0324-58d6-48e3-8b0b-561d8a940fea",
                "catalog_name": "Unisex",
                "currency": "USD",
                "id": "4311bb76-00b2-497f-9d2b-3e0f106a68dd",
                "images": [],
                "is_active": true,
                "max_order_quantity": 100,
                "min_order_quantity": 1,
                "name": "Baseball Hat MM VN",
                "sku": "PROD-4311bb76-00b2-497f-9d2b-3e0f106a68dd",
                "variations_count": 160
            },
            {
                "attributes": {
                    "gender": [
                        "Hard Goods"
                    ],
                    "group": "Hat",
                    "print_areas": [
                        "center_hat",
                        "left_hat",
                        "right_hat",
                        "back_hat"
                    ]
                },
                "base_price": "0.00",
                "catalog_id": "1dde0324-58d6-48e3-8b0b-561d8a940fea",
                "catalog_name": "Unisex",
                "currency": "USD",
                "id": "4794ea81-19a2-4232-b42a-78ef49e7d4ff",
                "images": [],
                "is_active": true,
                "max_order_quantity": 100,
                "min_order_quantity": 1,
                "name": "Baseball Hat MTR VN",
                "sku": "PROD-4794ea81-19a2-4232-b42a-78ef49e7d4ff",
                "variations_count": 112
            },
            {
                "attributes": {
                    "gender": [
                        "Hard Goods"
                    ],
                    "group": "Hat",
                    "print_areas": [
                        "center_hat",
                        "left_hat",
                        "right_hat",
                        "back_hat"
                    ]
                },
                "base_price": "0.00",
                "catalog_id": "1dde0324-58d6-48e3-8b0b-561d8a940fea",
                "catalog_name": "Unisex",
                "currency": "USD",
                "id": "3f1865c6-0c69-4400-90a3-74f453049b2e",
                "images": [],
                "is_active": true,
                "max_order_quantity": 100,
                "min_order_quantity": 1,
                "name": "Two-tone Hat VN",
                "sku": "PROD-3f1865c6-0c69-4400-90a3-74f453049b2e",
                "variations_count": 96
            },
            {
                "attributes": {
                    "gender": [
                        "Hard Goods"
                    ],
                    "group": "Socks",
                    "print_areas": [
                        "sock_collar"
                    ]
                },
                "base_price": "0.00",
                "catalog_id": "1dde0324-58d6-48e3-8b0b-561d8a940fea",
                "catalog_name": "Unisex",
                "currency": "USD",
                "id": "a7f045f9-e2a7-4a6c-a106-5a08a2955241",
                "images": [],
                "is_active": true,
                "max_order_quantity": 100,
                "min_order_quantity": 1,
                "name": "Mix Color Socks VN",
                "sku": "PROD-a7f045f9-e2a7-4a6c-a106-5a08a2955241",
                "variations_count": 128
            },
            {
                "attributes": {
                    "gender": [
                        "Hard Goods"
                    ],
                    "group": "Hat",
                    "print_areas": [
                        "center_hat",
                        "left_hat",
                        "right_hat",
                        "back_hat"
                    ]
                },
                "base_price": "0.00",
                "catalog_id": "1dde0324-58d6-48e3-8b0b-561d8a940fea",
                "catalog_name": "Unisex",
                "currency": "USD",
                "id": "a0df52e3-9751-4374-91b9-a5fd4043a54f",
                "images": [],
                "is_active": true,
                "max_order_quantity": 100,
                "min_order_quantity": 1,
                "name": "Bucket Hat VN",
                "sku": "PROD-a0df52e3-9751-4374-91b9-a5fd4043a54f",
                "variations_count": 96
            }
        ],
        "pagination": {
            "limit": 5,
            "page": 1,
            "pages": 18,
            "total": 86
        }
    },
    "message": "Products retrieved successfully",
    "request_id": "1dc3599b-ef50-4529-b77c-73bb0613410f",
    "status": true,
    "timestamp": "2025-08-20T08:59:27.005130"
}

🟠422Validation Error