Skip to main content
GET
/
v1
/
specs
/
{grader}
/
{spec_id}
Resolve a grader spec to its card
curl --request GET \
  --url https://api.gemrate.com/v1/specs/{grader}/{spec_id} \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "gemrate_id": "<string>",
    "spec": {
      "grader": "psa",
      "spec_id": "<string>"
    },
    "description": "<string>",
    "category": "<string>",
    "year": "<string>",
    "set_name": "<string>",
    "name": "<string>",
    "card_number": "<string>",
    "parallel": "<string>",
    "population": {
      "total": 123,
      "grades": {
        "9": 50741,
        "mint_plus": 0,
        "gem_mint": 14878,
        "pristine": null
      },
      "by_grader": {},
      "gem_total": 123,
      "gem_rate": 123,
      "last_population_change": "<string>"
    }
  },
  "meta": {
    "request_id": "req_abc123",
    "pagination": {
      "page": 1,
      "page_size": 100,
      "total": 1340,
      "total_pages": 14,
      "next_page": 2
    }
  }
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
grader
enum<string>
required

The grading company. The grading company. Accepted values: psa, beckett, sgc, cgc. Common aliases are also accepted and normalized (e.g. bgs, bvg, bccg → beckett; csg → cgc).

Available options:
psa,
beckett,
sgc,
cgc
Example:

"psa"

​
spec_id
string
required

The grading company's identifier for the card (PSA spec number, Beckett price-item id, etc.).

Query Parameters

​
include
string

Set to population to append the card's full population block.

Example:

"population"

​
grader_id2
string

Beckett's secondary identifier, when applicable.

​
auto
boolean

When true, adds the PSA-only auto/non_auto split to the population (under by_grader.psa). Must be true or false; any other value returns 400 invalid_parameter.

Response

The card the spec maps to (with a spec echo).

​
data
object

A spec resolves to a card — the full Card plus a spec echo identifying which spec resolved.

​
meta
object

Metadata attached to every response.