GET/v1/schema/items/:idOrNameDEVELOPER+

/v1/schema/items/:idOrName

A single item's schema record: category, collections, containers, variant structure, float range, image, and per-market catalog ids. Accepts a canonical item id (as returned by the pricing endpoints) or a URL-encoded market_hash_name, so it doubles as the join between a price row and the item behind it.

Accepts either identifier: the canonical id that pricing, NBBO, and liquidity responses return, or a URL-encoded market_hash_name. That makes it the join point between a price row and the item behind it, one small call instead of the full snapshot.

Parameters

idOrNamestringrequired

Path segment. Canonical item id or URL-encoded market_hash_name.

Response fields

SchemaItemLookupOne item plus only the registry entries it references.

schemaVersioninteger

Version (ms epoch) at which this item last changed.

itemSchemaItem

The item's catalog record.

registriesobjectnullable

{ rarities, collections, containers } restricted to entries the item references.

Response 200

{
  "schemaVersion": 1783069455007,
  "item": {
    "id": "cmlofcu700pem01yop1965ua2",
    "marketHashName": "★ Karambit | Doppler (Factory New)",
    "slug": "karambit-doppler-factory-new",
    "category": "skin",
    "baseName": "★ Karambit | Doppler",
    "weapon": "Karambit",
    "finish": "Doppler",
    "rarity": "covert",
    "wear": "Factory New",
    "wears": ["Factory New", "Minimal Wear"],
    "stattrak": false,
    "souvenir": false,
    "hasStattrak": true,
    "hasSouvenir": false,
    "variants": [
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Phase 1",
        "family": "doppler",
        "name": "Phase 1",
        "phase": 1,
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Phase 2",
        "family": "doppler",
        "name": "Phase 2",
        "phase": 2,
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Phase 3",
        "family": "doppler",
        "name": "Phase 3",
        "phase": 3,
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Phase 4",
        "family": "doppler",
        "name": "Phase 4",
        "phase": 4,
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Black Pearl",
        "family": "doppler",
        "name": "Black Pearl",
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Ruby",
        "family": "doppler",
        "name": "Ruby",
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      },
      {
        "marketHashName": "★ Karambit | Doppler (Factory New) - Sapphire",
        "family": "doppler",
        "name": "Sapphire",
        "image": "https://community.akamai.steamstatic.com/economy/image/..."
      }
    ],
    "image": "https://community.akamai.steamstatic.com/economy/image/...",
    "ids": { "buff163": "42998", "marketcsgo": "★ Karambit | Doppler (Factory New)" }
  },
  "registries": {
    "rarities": [{ "key": "covert", "name": "Covert", "tier": 6, "color": "#eb4b4b" }],
    "collections": {},
    "containers": {}
  }
}

Errors

404No item matches the given id or name.

401Missing Authorization header, unsupported scheme, or a key that is unknown, inactive, expired, or revoked.

403Valid key, but the subscription is inactive/expired or the plan does not include this endpoint.

429Rate limit exceeded; see Retry-After + X-RateLimit-* headers. Pooled per account across all keys.

5xxUpstream snapshot unavailable or a server-side issue. Retry with backoff.