Marketplace products

Get resolved marketplace product content

Gets content inheritance and the source of each field.

GET
/v1/marketplace-products/{marketplaceProductId}/resolved

Use before publishing. It does not query the marketplace or change anything. For the product and for each variation, it shows the final value of each field and its source: MarketplaceProduct variation, MarketplaceProduct, Variant, or Product.

The order is: MarketplaceProduct variation → MarketplaceProduct → Variant → Product. The product-level content uses the Product of the first variation, without a Variant. The offer (price) is not here: see the Listing resolved.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Path Parameters

marketplaceProductId*string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid

Response Body

Content resolved from Product, Variant, marketplace product and variation, with the layer each field came from. Nothing is published.

application/json
  1. response

Resolved content of a marketplace product: what a publication would send, and which layer each value came from. Read-only; nothing is published.

marketplaceProduct*

The marketplace product, as GET returns it.

content*

Content shared by every variation: the marketplace product over the Product of its first variation, without a Variant.

variants*array<>

One entry per variation, in map order.

curl -X GET "https://example.com/v1/marketplace-products/497f6eca-6276-4993-bfeb-53cbbbba6f08/resolved"
{  "marketplaceProduct": {    "id": "8a6f0c55-6a1e-4c55-9b0a-3b1f2d9e4c10",    "sellerId": "3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01",    "connectionId": "3f7d8a57-3e44-4c91-bbf1-02d9f4e4e5b0",    "externalId": null,    "desired": {      "content": {        "title": "iPhone 16",        "brand": "Apple",        "condition": "new"      },      "variationAxes": [        "color",        "storage"      ]    },    "observed": null,    "catalogReference": null,    "publicationState": "never_published",    "createdAt": "2026-10-10T12:00:00.000Z",    "updatedAt": "2026-10-10T12:00:00.000Z"  },  "content": {    "content": {      "title": {        "value": "iPhone 16",        "source": "marketplace_product"      },      "description": {        "value": "Apple smartphone, 128 GB.",        "source": "product"      },      "brand": {        "value": "Apple",        "source": "product"      }    },    "attributes": {      "color": {        "value": {          "type": "enum",          "value": "black"        },        "source": "marketplace_product_variant"      }    },    "media": null,    "gtin": {      "value": "7891234567890",      "source": "variant"    },    "physical": {      "value": {        "weightInGrams": 170,        "dimensionsInMm": {          "length": 147,          "width": 72,          "height": 8        }      },      "source": "product"    }  },  "variants": [    {      "marketplaceProductVariant": {        "id": "5b2d7e9a-1c4f-4e6b-8a3d-2f9c0b7e6d41",        "marketplaceProductId": "8a6f0c55-6a1e-4c55-9b0a-3b1f2d9e4c10",        "variantId": "47c9f819-fcf6-4478-b21a-678ecc594a11",        "externalVariantId": null,        "desired": {          "attributes": [            {              "key": "color",              "value": {                "type": "enum",                "value": "black"              }            },            {              "key": "storage",              "value": {                "type": "text",                "text": "128GB"              }            }          ]        },        "observed": null,        "createdAt": "2026-10-10T12:00:00.000Z",        "updatedAt": "2026-10-10T12:00:00.000Z"      },      "resolved": {        "content": {          "title": {            "value": "iPhone 16",            "source": "marketplace_product"          },          "description": {            "value": "Apple smartphone, 128 GB.",            "source": "product"          },          "brand": {            "value": "Apple",            "source": "product"          }        },        "attributes": {          "color": {            "value": {              "type": "enum",              "value": "black"            },            "source": "marketplace_product_variant"          }        },        "media": null,        "gtin": {          "value": "7891234567890",          "source": "variant"        },        "physical": {          "value": {            "weightInGrams": 170,            "dimensionsInMm": {              "length": 147,              "width": 72,              "height": 8            }          },          "source": "product"        }      }    }  ]}