Listings

List variant bindings

Gets the mapping from external variations to local Variants.

GET
/v1/listings/{listingId}/variant-bindings

The map explains which local SKU receives each listing inventory or publication. Each line points to a MarketplaceProduct variation (marketplaceProductVariantId); variantId comes along, read-only. externalId is the external id of the offer line, and desired.offer is the offer override for that line only. A Listing may remain unlinked after import.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Path Parameters

listingId*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

Current complete binding map, in the order of the last PUT.

application/json
  1. response
[index: integer]?

One offer line: a marketplace product variation sold by this listing.

curl -X GET "https://example.com/v1/listings/497f6eca-6276-4993-bfeb-53cbbbba6f08/variant-bindings"
[  {    "id": "cb064b64-2f63-4c3e-aa42-f11ea0f82b17",    "listingId": "0e2ce906-a6ab-4101-9461-4168c8b6b902",    "marketplaceProductVariantId": "5b2d7e9a-1c4f-4e6b-8a3d-2f9c0b7e6d41",    "variantId": "47c9f819-fcf6-4478-b21a-678ecc594a11",    "externalId": "MLB123",    "externalSku": "IP16-BLK-128",    "inventoryEligible": true,    "linkSource": "manual",    "matchedBy": null,    "desired": {},    "marketplaceStatus": null,    "buyable": null,    "discoverable": null,    "pendingRevision": null,    "statusReasons": [],    "lastPublishedAt": null  }]