Skip to main content
GET
/
v1
/
cards
/
{gemrate_id}
Get population for a card
curl --request GET \
  --url https://api.gemrate.com/v1/cards/{gemrate_id} \
  --header 'x-api-key: <api-key>'
{
  "data": {
    "gemrate_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

gemrate_id
string
required

GemRate's universal identifier for a card (returned by cert and spec lookups).

Query Parameters

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 and its current population.

data
object

A card (the GemRate entity) and its current population.

meta
object

Metadata attached to every response.