# alibaba1688_list_pairings (https://sellersheetai.com/docs/mcp-api/tools/alibaba1688_list_pairings)

> List the 1688 variants stored for the account and the local SKU each is paired with — before an order, to see what is paired; pair an unpaired one with alibaba1688_pair_sku, or add

Access: **READ** · toolset alibaba1688 · family null

a product's variants with alibaba1688_list_offer_variants. A variant several SKUs share (a 1-pack and a 2-pack) is one row per SKU, each with its own item_id and units_per_sku.

## Call it

MCP tool call:

```json
{
  "name": "alibaba1688_list_pairings",
  "arguments": {
    "account": "<account>"
  }
}
```

Tool API (early access — contact us):

```bash
curl -X POST https://api.sellersheetai.com/api/v1/tools/alibaba1688_list_pairings \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"account":"<account>"}'
```

## Arguments

| Name | Type | Required | Description |
|---|---|---|---|
| `account` | string | yes | the 1688 account ref (its 1688 login name) — one of get_user_context's alibaba1688 account_refs, verbatim. |
| `state` | string |  | paired (has a local SKU), unpaired, or gone (1688 no longer lists the variant on its product); omit for all. Allowed: paired \| unpaired \| gone. |
| `q` | string |  | text to find in the 1688 product title, the supplier's name or item number, or the local SKU's code or name. |
| `sku` | string |  | a local SKU code — only the variants paired with it. |
| `cursor` | string |  | the cursor from the previous call's data.next_cursor; omit for the first page. |
| `limit` | integer |  | rows per page, 1 to 200. |

## Result

- `data.items[]` — item_id, offer_id, spec_id (empty for a product without variants), offer_url, subject, attributes [{name, value}], supplier_login_id, supplier_name, price_yuan (the listed price, in yuan), unit, min_order_qty, cargo_number, state, sku {sku_id, sku, name} or null, units_per_sku, is_default, updated_at.
- `data.next_cursor` — present when more rows exist.