# Store listing (/docs/agent-payments/store-listing)

```http
GET https://apps.apiswop.co/api/v5/x402/store/{handle}
```

Returns up to 100 priced, non-archived products for a swop.id. No authentication, no payment. CORS is open, so a browser-based agent can call it too.

## Request [#request]

| Parameter | In | Description |
|---|---|---|
| `handle` | path | The seller's swop.id, for example `travis.swop.id`. Case-insensitive |

<Tabs items={['curl', 'Node', 'Python']} groupId="lang" persist>
<Tab value="curl">
```bash
curl -s https://apps.apiswop.co/api/v5/x402/store/travis.swop.id
```
</Tab>
<Tab value="Node">
```js
const res = await fetch('https://apps.apiswop.co/api/v5/x402/store/travis.swop.id');
const { data } = await res.json();

for (const p of data.products) {
  console.log(p.name, p.priceUsd, p.agentPayable ? p.buyUrl : '(not agent-payable)');
}
```
</Tab>
<Tab value="Python">
```python
import requests

data = requests.get("https://apps.apiswop.co/api/v5/x402/store/travis.swop.id").json()["data"]
for p in data["products"]:
    print(p["name"], p["priceUsd"], p["buyUrl"] if p["agentPayable"] else "(not agent-payable)")
```
</Tab>
</Tabs>

## Response [#response]

```json
{
  "state": "success",
  "data": {
    "handle": "travis.swop.id",
    "name": "Travis Herron",
    "network": "base",
    "currency": "USDC",
    "products": [
      {
        "sku": "6a7f63002e22feb6ad48dd7c",
        "name": "Cabal Card",
        "description": "Access to the Cabal's group chat and post on my feed.",
        "image": "https://res.cloudinary.com/…/dwm3kmxiot17hidzqdf7.png",
        "priceUsd": 1,
        "currency": "USDC",
        "type": "collectible",
        "shippingRequired": false,
        "shippingCostUsd": 0,
        "agentPayable": true,
        "variants": [],
        "requiredOrderFields": [],
        "buyUrl": "https://apps.apiswop.co/api/v5/x402/store/travis.swop.id/buy/6a7f63002e22feb6ad48dd7c"
      }
    ]
  }
}
```

### Product fields [#product-fields]

| Field | Type | Description |
|---|---|---|
| `sku` | string | Product id. Also the last segment of `buyUrl` |
| `name`, `description` | string | What the product is |
| `image` | string or null | Primary image URL |
| `priceUsd` | number | Item price in USD, paid in USDC |
| `currency` | string | Always `USDC` |
| `type` | string | Product type, for example `collectible`, `phygital`, `membership` |
| `shippingRequired` | boolean | `true` for physical goods |
| `shippingCostUsd` | number | Flat shipping, added to the price in the 402 |
| `agentPayable` | boolean | `false` when the seller has no payout wallet for this product yet |
| `variants` | array | Option groups the buyer must choose from, each `{ name, options[] }` |
| `requiredOrderFields` | string[] | Shipping fields to send in `X-ORDER` for physical goods |
| `buyUrl` | string | The x402 endpoint. `GET` it to receive the 402 challenge |

The total an agent pays is `priceUsd + shippingCostUsd`. The 402 states it exactly in USDC base units.

## Errors [#errors]

| Status | Meaning |
|---|---|
| `404` | No swop.id with that handle |
| `429` | Rate limited. Back off and retry |

## Getting it from an AI assistant [#getting-it-from-an-ai-assistant]

The [Swop MCP](/docs/mcp) exposes the same listing as [`swop_get_store`](/docs/mcp/tool-reference/identity-and-stores), and [`swop_get_product_link`](/docs/mcp/tool-reference/identity-and-stores) returns the shareable link for one product.
