HomeGuidesAPI Endpoints
GuidesAPI EndpointsCommunityLog In

Deprecation Notice 11/26/2018

Here at TCGplayer, we recognize that change allows us to improve. To keep improving, we will discontinue support of some older versions of our API in the near future. Removing these versions allows us to utilize resources where they are needed most to deliver the best possible API to you. In the future TCGplayer will be announcing our plans to sunset API versions via email and on docs.tcgplayer.com with as much prior notice as possible.

API deprecation will be conducted in two phases.

Phase 1Phase 2
Impacted Versions1.4.0
1.5.0
1.6.0
1.7.0
1.7.1
1.8.0
1.11.0
1.3.0
1.8.1
1.9.0
1.9.1
1.10.0
1.13.0
/current/
Recommended Version1.20.01.20.0
Deprecation DateNovember 26, 2018November 26, 2018
Sunset DateJanuary 28, 2019April 29, 2019
  • Version 1.20.0 is the latest version at the time of this document.

Note: Effective April 29, 2019, TCGplayer will require a version to be specified in your request. Requests with no version or the shortcut of /current/ will return a 404 response. This will protect integrations from breaking when new versions of the API are released.

Breaking Changes

For versions after v1.3.0, responses have changed from responses using CamelCase with the first letter of the first word capitalized to camelCase with the first word all lowercase.

Endpointv1.13.0 Responsev1.20.0 Response
/catalog/categories{
"Success": true,
"Errors": [],
"Results": [
{
"CategoryId": 55,
"Name": "Architect TCG",
"PublishDate": "11/19/2018",
"LastModifiedDate": "2018-09-17T15:21:54"
}
]
}

** Response truncated for example.
{
"totalItems": 57,
"success": true,
"errors": [],
"results": [
{
"categoryId": 55,
"name": "Architect TCG",
"modifiedOn": "2018-09-17T15:21:54.233",
"displayName": "Architect TCG",
"seoCategoryName": "Architect TCG",
"sealedLabel": "Sealed Products",
"nonSealedLabel": "Singles",
"conditionGuideUrl": "https://store.tcgplayer.com/",
"isScannable": true,
"popularity": 0
}
]
}

Removed Endpoints

Endpoint RemovedSuggested ReplacementVersion no longer available in
GET /catalog/resourcepathsGET /catalog/products/{productId}/mediav1.9.0
GET /catalog/productconditions/{productId}GET /catalog/products/{productId}/productconditionsv1.9.0
GET /stores/{storeKey}/buylist/skusGET /stores/{storeKey}/buylist/skupricesv1.9.0
GET /stores/{storeKey}/buylist/skus/{skuId}GET /stores/{storeKey}/buylist/skuprices?skuId={skuId}v1.9.0
GET /pricing/livepricesGET /stores/{storeKey}/inventory/skupricesv1.9.0
GET /inventory/market/{productConditionId}GET /stores/{storeKey}/inventory/skus/{skuId}v1.9.0

Additional Resources

Please review our Release Notes for additional information on changes between versions.

Please check Swagger for details on each endpoint. Swagger can be found for each version by replacing version with the :version you are looking for http://api.tcgplayer.com/:version/help/index. Example: http://api.tcgplayer.com/v1.17.0/help/index.

If you have comments or concerns, please reach out to us at [email protected] or through our TCGplayer Discord.

Thanks,
The TCGplayer API Team