Back to Tool Reference
MCP

listing.list

Paginated cross-channel listing index, scoped to the caller's org.

Effectread-onlyScopelisting:readPlanStarter+

Parameters

design_idstring

Optional. Filter to listings for one product design.

channelstring

Optional. One of "tiktok" / "tiktok_shop" / "etsy" / "shopify". Omit to span all channels.

statusstring

Optional. Comma-separated list of statuses ("DRAFT", "ACTIVE", "FAILED", ...). Case-insensitive.

pageintegerDefault: 1

1-indexed.

page_sizeintegerDefault: 50

Clamped to [1, 100].

Returns

resultsListing[]
total_countnumber
Request
json
{
  "name": "listing.list",
  "arguments": {}
}
Response
json
{
  "results": [
    {
      "status": "DRAFT",
      "source": "CREATED",
      "productionPartner": null,
      "productionPartnerProductId": "",
      "productionPartnerSyncStatus": "",
      "gender": null,
      "etsyListingId": null,
      "etsyShopId": null,
      "taxonomyId": "482",
      "taxonomyName": "Gender-Neutral > Tops & Tees > T-shirts",
      "whoMade": "i_did",
      "whenMade": "made_to_order",
      "isSupply": false,
      "tags": [
        "custom photo shirt",
        "dog remembrance gift"
      ],
      "materials": [],
      "occasion": null,
      "style": [],
      "shippingProfileId": null,
      "processingMin": 2,
      "processingMax": 5,
      "isPersonalized": true,
      "personalizationIsRequired": false,
      "personalizationInstructions": null,
      "attributes": {},
      "variants": [
        {
          "sku": "pl-tee-custom-photo-s",
          "price": "19.99",
          "quantity": 999,
          "propertyValues": [
            {
              "values": [
                "S"
              ],
              "scale_id": null,
              "property_name": "Size"
            }
          ],
          "isEnabled": true
        },
        {
          "sku": "pl-tee-custom-photo-m",
          "price": "19.99",
          "quantity": 999,
          "propertyValues": [
            {
              "values": [
                "M"
              ],
              "scale_id": null,
              "property_name": "Size"
            }
          ],
          "isEnabled": true
        }
      ],
      "content": {
        "title": "Custom photo shirt — Personalized Shirt on Bella + Canvas, Your Photo Printed Properly, Free Shipping",
        "description": "Type it. We print it. You wear it.\n\n— WHAT YOU GET —\nA shirt printed to order on a Bella+Canvas 3001 (4.2 oz, 100% Airlume combed cotton). Water-based inks,\nprinted when you order it — no overstock, no warehouse dust.\n\n— HOW TO PERSONALIZE…",
        "images": [],
        "size_chart_image_url": null,
        "video_url": null,
        "channel_snapshot": {}
      },
      "product_design": {
        "id": "4667abde-0c70-4f50-9e6f-417b6b765654",
        "title": "Custom Photo T-Shirt"
      },
      "priceBreakdown": null,
      "created_at": "2026-06-10T14:42:26.581751Z",
      "updated_at": "2026-06-10T14:42:26.581754Z",
      "published_at": null,
      "channel": "etsy",
      "id": "2cf8d0c6-934e-411e-acc3-89b851958bc9"
    },
    {
      "status": "DRAFT",
      "source": "CREATED",
      "productionPartner": null,
      "productionPartnerProductId": "",
      "productionPartnerSyncStatus": "",
      "gender": null,
      "etsyListingId": null,
      "etsyShopId": null,
      "taxonomyId": "2202",
      "taxonomyName": "Gender-Neutral > Hoodies & Sweatshirts > Sweatshirts",
      "whoMade": "i_did",
      "whenMade": "made_to_order",
      "isSupply": false,
      "tags": [
        "custom logo sweatshi",
        "custom sweatshirt"
      ],
      "materials": [],
      "occasion": null,
      "style": [],
      "shippingProfileId": null,
      "processingMin": 2,
      "processingMax": 5,
      "isPersonalized": true,
      "personalizationIsRequired": false,
      "personalizationInstructions": null,
      "attributes": {},
      "variants": [
        {
          "sku": "pl-sweatshirt-business-logo-s",
          "price": "33.99",
          "quantity": 999,
          "propertyValues": [
            {
              "values": [
                "S"
              ],
              "scale_id": null,
              "property_name": "Size"
            }
          ],
          "isEnabled": true
        },
        {
          "sku": "pl-sweatshirt-business-logo-m",
          "price": "33.99",
          "quantity": 999,
          "propertyValues": [
            {
              "values": [
                "M"
              ],
              "scale_id": null,
              "property_name": "Size"
            }
          ],
          "isEnabled": true
        }
      ],
      "content": {
        "title": "Custom logo sweatshirt — Personalized Sweatshirt on Gildan, Your Logo, Faithfully Reproduced, Free Shipping",
        "description": "Type it. We print it. You wear it.\n\n— WHAT YOU GET —\nA sweatshirt printed to order on a Gildan 18000 (8.0 oz, 50/50 cotton-poly heavy blend). Water-based inks,\nprinted when you order it — no overstock, no warehouse dust.\n\n— HOW TO…",
        "images": [],
        "size_chart_image_url": null,
        "video_url": null,
        "channel_snapshot": {}
      },
      "product_design": {
        "id": "d7dcc5df-1942-4828-a67b-3200640b9918",
        "title": "Business Logo Crewneck Sweatshirt"
      },
      "priceBreakdown": null,
      "created_at": "2026-06-10T14:42:26.555769Z",
      "updated_at": "2026-06-10T14:42:26.555774Z",
      "published_at": null,
      "channel": "etsy",
      "id": "5446a0d6-87cd-4863-a46b-8552b66cf410"
    }
  ],
  "total_count": 4
}