Retrieve a catalog product by SKU

GET /catalog/product/

Fetches details of a product in the catalog.

Query parameters

  • sku string Required

    The Stock Keeping Unit (SKU) of the product.

Responses

  • 200 application/json

    Successfully deleted products in catalog.

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes object
    • token string(uuid) Required

      A unique token that identifies the product.

    • external_id null | string Required

      An external identifier for the product, typically used for mapping with external systems.

    • sku null | string Required

      Stock Keeping Unit (SKU).

    • quantity integer Required

      The available stock quantity for the variant.

      Minimum value is 0, maximum value is 1000000.

    • is_simple boolean Required

      Indicates whether the product is a simple product (true) or has variants (false).

    • status string Required

      The current status of the product.

      Values are Active, Inactive, Disabled, Preorder, Available, Draft, Pending, Private, Publish, or Archive.

    • title string Required

      The name or title of the product.

    • images array[string(url)] Required

      A list of image URLs representing the product.

    • attributes array[object] Required

      A list of key-value pairs representing attributes.

      Hide attributes attributes Show attributes attributes object
      • name string Required

        The name of the attribute (e.g., material, size, color).

      • value string Required

        The value of the attribute corresponding to its name (e.g., cotton, red, large).

    • update_date string(date-time) Required

      The date and time when the product was last updated, in ISO 8601 format.

    • variants array[object] Required

      A list of product variants.

      Hide variants attributes Show variants attributes object
      • token string(uuid) Required

        A unique token identifying the product variant.

      • sku null | string Required

        Stock Keeping Unit (SKU).

      • barcode null | string Required

        The unique barcode for the variant, such as UPC or EAN.

      • price number Required

        The price of the variant in the specified currency.

        Minimum value is 0, maximum value is 1000000.0.

      • quantity integer Required

        The available stock quantity for the variant.

        Minimum value is 0, maximum value is 1000000.

      • images array[string(url)] Required

        A list of image URLs representing the product variant.

      • options array[object] Required

        A list of options specifying attributes of the variant (e.g., size, color).

        Hide options attributes Show options attributes object
        • name string Required

          The name of the option.

        • value string Required

          The value of the option.

      • attributes array[object] Required

        A list of key-value pairs representing attributes.

        Hide attributes attributes Show attributes attributes object
        • name string Required

          The name of the attribute (e.g., material, size, color).

        • value string Required

          The value of the attribute corresponding to its name (e.g., cotton, red, large).

      • weight null | number Required

        The weight of the product variant.

        Minimum value is 0.

      • weight_unit null | string Required

        The unit of measurement for the weight.

        Values are GRAMS, KILOGRAMS, OUNCES, POUNDS, or TONNES.

      • height null | number Required

        The height of the product variant.

        Minimum value is 0.

      • depth null | number Required

        The depth of the product variant.

        Minimum value is 0.

      • width null | number Required

        The width of the product variant.

        Minimum value is 0.

      • dimension_unit null | string Required

        The unit of measurement for dimensions (height, width, depth).

        Values are MILLILITERS, CENTILITERS, DECIMETERS, METERS, INCHES, YARD, or FEET.

      • update_date string(date-time) Required

        The date and time when the variant was last updated, in ISO 8601 format.

  • 400 application/json

    Bad request

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes object
    • code string Required

      An error code that identifies the type of error that occurred.

    • message string Required

      A message that describes the error condition in a human-readable form.

    • data object | array Required

      Additional information that can help the caller understand or fix the issue.

  • 404 application/json

    Not found

    Hide response attributes Show response attributes object
    • code string Required

      An error code that identifies the type of error that occurred.

    • message string Required

      A message that describes the error condition in a human-readable form.

    • data object | array Required

      Additional information that can help the caller understand or fix the issue.

  • 401 application/json

    Unauthorized

    Hide response attributes Show response attributes object
    • code string Required

      An error code that identifies the type of error that occurred.

    • message string Required

      A message that describes the error condition in a human-readable form.

    • data object | array Required

      Additional information that can help the caller understand or fix the issue.

  • 429 application/json

    Too many requests

    Hide headers attributes Show headers attributes
    Hide response attributes Show response attributes object
    • code string Required

      An error code that identifies the type of error that occurred.

    • message string Required

      A message that describes the error condition in a human-readable form.

    • data object | array Required

      Additional information that can help the caller understand or fix the issue.

  • 500 application/json

    Internal server error

    Hide response attributes Show response attributes object
    • code string Required

      An error code that identifies the type of error that occurred.

    • message string Required

      A message that describes the error condition in a human-readable form.

    • data object | array Required

      Additional information that can help the caller understand or fix the issue.

GET /catalog/product/
curl \
 -X GET https://m2e.cloud/api/v1/api/catalog/product/?sku=WBH-12345
Response examples (200)
# Headers
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 90
X-RateLimit-Retry-After: 2022-11-04T13:43:28Z

# Payload
{
  "token": "1529970e-7508-489f-8a79-281225ee330e",
  "external_id": "0011-0022-11",
  "sku": "WBH-12345",
  "quantity": 100,
  "is_simple": false,
  "status": "Active",
  "title": "Wireless Bluetooth Headphones",
  "images": [
    "https://example.com/image1.jpg"
  ],
  "attributes": [
    {
      "name": "material",
      "value": "cotton"
    }
  ],
  "update_date": "2020-12-30T15:30:50Z",
  "variants": [
    {
      "token": "1529970e-7508-489f-8a79-281225ee330e",
      "sku": "WBH-12345",
      "barcode": "012345678905",
      "price": 79.99,
      "quantity": 100,
      "images": [
        "https://example.com/variant-image1.jpg"
      ],
      "options": [
        {
          "name": "Size",
          "value": "Medium"
        }
      ],
      "attributes": [
        {
          "name": "material",
          "value": "cotton"
        }
      ],
      "weight": 0.5,
      "weight_unit": "GRAMS",
      "height": 10.0,
      "depth": 5.0,
      "width": 8.0,
      "dimension_unit": "CENTILITERS",
      "update_date": "2020-12-30T15:30:50Z"
    }
  ]
}
Response examples (400)
[
  {
    "code": null,
    "message": "All array items must match schema"
  },
  {
    "code": null,
    "message": "The required properties (currency) are missing"
  }
]
Response examples (404)
[
  {
    "code": 404,
    "message": "Entity is not found."
  }
]
Response examples (401)
[
  {
    "code": 401,
    "message": "Unauthorized"
  }
]
Response examples (429)
[
  {
    "code": 429,
    "message": "Too many requests."
  }
]
Response examples (500)
[
  {
    "code": 500,
    "message": "Internal server error."
  }
]