Expansions feed
The expansions feed lists every expansion (set) in a game.
Get the download link from GET /v1/feeds/{gameId}/expansions, then read it as described in the feeds overview. One expansion per line.
Record shape
{
"id": 42,
"name": "Alpha",
"slug": "alpha",
"code": "LEA",
"releaseDate": "1993-08-05T00:00:00.000Z",
"logoUrl": "https://cardnexus.com/assets/games/magic/alpha-logo.png",
"symbolUrl": "https://cardnexus.com/assets/games/magic/alpha-symbol.svg",
"cardCount": 295,
"sealedProductCount": 4,
"translations": {
"fr": { "name": "Alpha" }
},
"attributes": {
"setType": "physical",
"expansionGroupId": null,
"serieId": null,
"setId": null
}
}
| Field | Type | Description |
|---|---|---|
id |
number | The expansion's stable identifier — the same id GET /v1/games/{gameId}/expansions uses. The catalog feed references it as expansionId. |
name |
string | The expansion's name. |
slug |
string | URL-safe identifier, unique within the game. |
code |
string | The expansion's set code. |
releaseDate |
string | null | Release date, ISO 8601 UTC, or null when unknown. |
logoUrl |
string | null | Absolute logo URL, or null. |
symbolUrl |
string | null | Absolute set-symbol URL, or null. |
cardCount |
number | Number of cards in the expansion. |
sealedProductCount |
number | Number of sealed products in the expansion. |
translations |
object | null | Per-locale overrides, keyed by language code. |
attributes |
object | Game-specific fields. setType is physical or digital; expansionGroupId is a number, or null when the expansion belongs to no group. |
Related
- Catalog feed — products, joined by
expansionId/expansionSlug - Feeds overview — file format and how to download