Get the expansions feed

​

Returns a download link and metadata for a game's expansions feed.

The file is gzip-compressed, newline-delimited JSON. Each line is one expansion (set): its identifier, name, code, release date, card and sealed-product counts, and game-specific attributes. The download is the literal gzip bytes — your HTTP client will not decompress it automatically. Gunzip the file before reading it; see https://docs.cardnexus.com/feeds for download examples in Node and Python.

The expansions feed is rebuilt when a game's catalog is updated. checksum changes only when the expansions change. The url is a time-limited download link; request this endpoint again for a fresh link once it expires.

The file's record shape (one expansion per line) is documented at https://docs.cardnexus.com/feeds/expansions.

Authentication is required (any valid API key); no scope.

Path Parameters
  • gameId
    Type: string
    min length:  
    1
    required

    The game's identifier (e.g. mtg, pokemon). Returned by GET /v1/games.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/feeds/{gameId}/expansions
curl 'https://public-api.cardnexus.com/v1/feeds/{gameId}/expansions' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "feedType": "expansions",
  "url": "https://cardnexus-feeds.s3.eu-west-1.amazonaws.com/feeds/mtg/expansions.ndjson.gz?X-Amz-Expires=3600&X-Amz-Signature=2b7d...",
  "urlExpiresAt": "2026-06-08T15:04:11.000Z",
  "checksum": "9f2c4e1b7d3a6f508c2e9b1d4a7f0c3e6b9d2f5a8c1e4b7d0a3f6c9e2b5d8f1a",
  "sizeBytes": 81920,
  "recordCount": 642,
  "format": "ndjson",
  "encoding": "gzip",
  "lastRefreshedAt": "2026-06-08T14:04:11.000Z",
  "generatedAt": "2026-06-05T02:11:47.000Z"
}

Expansions feed metadata returned.