List All Groups

This listing comes from the current Store's inventory whose Seller is associated with the user's bearer token making this API call.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Returns a list of all of the groups that are currently for sale by the authenticated store. This can be useful for generating a cascading inventory page.

{
    "totalItems": 193,
    "success": true,
    "errors": [],
    "results": [
        {
            "groupId": 2098,
            "name": "Rivals of Ixalan",
            "abbreviation": "RIX",
            "supplemental": false,
            "publishedOn": "1/19/2018",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        },
        {
            "groupId": 2092,
            "name": "Unstable",
            "abbreviation": "UST",
            "supplemental": true,
            "publishedOn": "12/8/2017",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        },
        {
            "groupId": 2077,
            "name": "Explorers of Ixalan",
            "abbreviation": "E02",
            "supplemental": false,
            "publishedOn": "11/24/2017",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        },
        {
            "groupId": 2050,
            "name": "Iconic Masters",
            "abbreviation": "IMA",
            "supplemental": false,
            "publishedOn": "11/17/2017",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        },
        {
            "groupId": 2076,
            "name": "Duel Decks: Merfolk vs. Goblins",
            "abbreviation": "DDT",
            "supplemental": false,
            "publishedOn": "11/10/2017",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        },
        {
            "groupId": 2084,
            "name": "Gift Boxes and Promos",
            "abbreviation": "GBP",
            "supplemental": false,
            "publishedOn": "10/20/2017",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        },
        {
            "groupId": 2043,
            "name": "Ixalan",
            "abbreviation": "XLN",
            "supplemental": false,
            "publishedOn": "9/29/2017",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        },
        {
            "groupId": 2009,
            "name": "Commander 2017",
            "abbreviation": "C17",
            "supplemental": true,
            "publishedOn": "8/25/2017",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        },
        {
            "groupId": 1934,
            "name": "Hour of Devastation",
            "abbreviation": "HOU",
            "supplemental": false,
            "publishedOn": "7/14/2017",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        },
        {
            "groupId": 1904,
            "name": "Archenemy: Nicol Bolas",
            "abbreviation": "AC2",
            "supplemental": false,
            "publishedOn": "6/16/2017",
            "category": {
                "categoryId": 1,
                "name": "Magic",
                "modifiedOn": "2018-03-08T19:05:06.26",
                "displayName": null,
                "seoCategoryName": null,
                "sealedLabel": null,
                "nonSealedLabel": null,
                "conditionGuideUrl": null,
                "isScannable": false,
                "popularity": 0
            },
            "modifiedOn": "0001-01-01T00:00:00"
        }
    ]
}
{
    "totalItems": integer,
    "success": boolean,
    "errors": [],
    "results": [
        {
            "groupId": integer,
            "name": "string",
            "abbreviation": "string",
            "supplemental": boolean,
            "publishedOn": "string",
            "category": {
                "categoryId": integer,
                "name": "string",
                "modifiedOn": "datetime",
                "displayName": string,
                "seoCategoryName": string,
                "sealedLabel": string,
                "nonSealedLabel": string,
                "conditionGuideUrl": string,
                "isScannable": boolean,
                "popularity": integer
            },
            "modifiedOn": "datetime"
        }
		]
}
Path Params
string
required

Required. A unique key used to identify the caller of the API.

Query Params
int32

If provided, this request will only return groups from the specified category.

string

If provided, this request will only return groups from the specified category

int32

The channel to search for results. Defaults to 0, the TCG Marketplace.

boolean

If true, will return results for excluded categories. Default is false.

int32

Used for paging. The number of Groups to skip. Default is 0.

int32

Used for paging. The maximum number of Groups to return. Default is 10.

boolean

If true, will only return Groups which are in-stock.
If false, will include Groups which have prices but aren't in stock.
If null, will use Sellers 'Hide Sets without Inventory' Pro Setting.
Default is null.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Response

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/json