> ## Documentation Index
> Fetch the complete documentation index at: https://assetpay.gg/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Item Listings

> View specific listings for an item type.

# GET /client/market/item

Returns individual listings for a specific item. Use this when you want to let users pick a specific skin variant (different float, stickers, etc.) rather than just the cheapest one.

**Authentication:** Client Token (`Authorization` header)

## Request

```http theme={null}
GET https://api.assetpay.gg/client/market/item?itemId=marketplace-item-id&delivery=any&page=1
Authorization: CLIENT_TOKEN
```

### Query Parameters

| Parameter        | Type   | Default    | Description                                                                                                                                                                                                       |
| ---------------- | ------ | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `itemId`         | string | Required\* | Marketplace item ID. For CS2 listings, this is the Assetpay item identifier returned by `/client/market` or `/client/market/suggestions`. Provide this **or** `marketHashName`; `itemId` wins when both are sent. |
| `marketHashName` | string | Required\* | Exact market hash name (e.g. `AK-47 \| Redline (Field-Tested)`), resolved to the catalog item id. Ignored when `itemId` is supplied.                                                                              |
| `delivery`       | string | `any`      | `"any"`, `"standard"` (bot sources from supplier and sends trade offer) or `"instant"` (immediate delivery from pre-positioned stock). Filters listings by delivery mode.                                         |
| `phase`          | string | -          | Doppler phase: `"Phase 1"`–`"Phase 4"`, `"Ruby"`, `"Sapphire"`, `"Black Pearl"`, `"Emerald"`. Returns only that phase's listings. Combinable with `delivery`.                                                     |
| `floatMin`       | number | -          | Lower bound on the item float/wear value (`0`–`1`).                                                                                                                                                               |
| `floatMax`       | number | -          | Upper bound on the item float/wear value (`0`–`1`).                                                                                                                                                               |
| `page`           | number | `1`        | Page number                                                                                                                                                                                                       |
| `perPage`        | number | `50`       | Listings per page (max 100)                                                                                                                                                                                       |

\* Provide either `itemId` or `marketHashName`.

## Response

```json theme={null}
{
  "requestId": "...",
  "success": true,
  "data": [
    {
      "id": "listing-uuid-1",
      "name": "AK-47 | Redline",
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "type": "Rifle",
      "iconUrl": "IzMF03bk9WpSBq-S-ekoE33L-iLqGFHVaU25ZzQNQcXdA3g5gMEPvUZZEfSMJ6dESN8p_2SVTY7V2N4MxGVIwXpaL3_a3Hh...",
      "appid": 730,
      "tradable": true,
      "offer": {
        "price": 10.50,
        "reference": "ref_listing_001",
        "delivery": "standard"
      },
      "exterior": "Field-Tested",
      "wear": "0.15234",
      "paintSeed": 123,
      "stickers": [
        {
          "name": "iBUYPOWER | Katowice 2014",
          "marketHashName": "Sticker | iBUYPOWER | Katowice 2014",
          "slot": 0,
          "wear": 0,
          "iconUrl": "IzMF03bi9WpSBq-S-ekoE33L-iLqGFHVaU25Zzc..."
        }
      ]
    },
    {
      "id": "listing-uuid-2",
      "name": "AK-47 | Redline",
      "marketHashName": "AK-47 | Redline (Field-Tested)",
      "appid": 730,
      "tradable": true,
      "offer": {
        "price": 9.80,
        "reference": "ref_listing_002",
        "delivery": "instant"
      },
      "wear": "0.35678",
      "paintSeed": 456,
      "stickers": []
    }
  ]
}
```

Each listing represents a specific item instance with its own float value, stickers, and price. Use the `id` and `offer.price` when initiating a withdrawal.

<Note>
  This endpoint is currently CS2-only. Rust withdrawals don't use per-variant listings — the cheapest available stack is sourced when the withdrawal is purchased.
</Note>

## Rate Limits

| Merchant Status | Limit              |
| --------------- | ------------------ |
| Verified        | 600 requests / min |
| Unverified      | 30 requests / min  |