Marketplace products

List marketplace products

Lists the account's marketplace content, paginated.

GET
/v1/marketplace-products

Use this collection to see the content each Connection has. Filter by connectionId for one channel. Each item shows publicationState and externalId, which only exists after publication or import. To find which offers use an item, filter listings by marketplaceProductId.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Query Parameters

page?integer

Page number, starting at 1. Defaults to 1. A page beyond pagination.totalPages is not an error: it returns empty data.

Range1 <= value <= 9007199254740991
Default1
pageSize?integer

Items per page, from 1 to 100. Defaults to 20.

Range1 <= value <= 100
Default20
connectionId?string

Only marketplace products of this connection.

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

Marketplace products newest first, optionally of one connection.

application/json
  1. response

One page of marketplace products.

data*array<>

Marketplace products in this page, newest first.

pagination*

Where this page sits in the whole listing: the totals and whether there are pages before and after it.

curl -X GET "https://example.com/v1/marketplace-products"
{  "data": [    {      "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"    }  ],  "pagination": {    "page": 1,    "pageSize": 20,    "totalItems": 57,    "totalPages": 3,    "hasNext": true,    "hasPrev": false  }}