extractr docs
TCGPlayer

Grading scale reference

GET
/tcgplayer/grading_scales

The reference table mapping every grade_id used across this module to a grading company, grade and tier — PSA, BGS, CGC, TAG, ACE, ARS and AGS, plus the raw/ungraded id. Fetch once and cache (the response is served with a one-day Cache-Control); then resolve grade ids client-side, including ids in data you cached before grades were resolved.

Costs 1 credit per request.

Authorization

ApiKeyAuth
X-API-Key<token>

API key created in the extractr dashboard (ext_live_...). Also accepted as Authorization: Bearer.

In: header

Query Parameters

company?string

Filter to a single company symbol (case-insensitive).

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/tcgplayer/grading_scales"
{  "count": 0,  "scales": [    {      "grade_id": "12",      "company": "PSA",      "grade": "10",      "label": "PSA 10",      "grade_name": "GEM - MT",      "tier": "gem_mint",      "pristine": false    }  ],  "source": "snapshot",  "updated_at": "string"}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}
{  "error": {    "code": "invalid_api_key",    "message": "The provided API key is invalid or has been revoked.",    "reason": "sold"  }}