Get population history for a card

curl --request GET \
  --url https://api.gemrate.com/v1/cards/{gemrate_id}/history \
  --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>"
    },
    "history": {
      "by_grader": {}
    }
  },
  "meta": {
    "request_id": "req_abc123",
    "pagination": {
      "page": 1,
      "page_size": 100,
      "total": 1340,
      "total_pages": 14,
      "next_page": 2
    }
  }
}

Cards

Get population history for a card

Returns the card’s current population (the same population block as GET /v1/cards/{gemrate_id}) plus history.by_grader — one per-grader time series, each datapoint { date, total, gem_total, grades, qualifiers } on the universal scale. The current population is the base of the response and always comes back; it doesn’t cost an extra call. (No auto/non_auto in the series.)

Ships today with fixed defaults (≈3-year window, ~2-week frequency, all graders). Date-range and frequency parameters will be added later without breaking this shape.

GET

cards

{gemrate_id}

history

Get population history for a card

curl --request GET \
  --url https://api.gemrate.com/v1/cards/{gemrate_id}/history \
  --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>"
    },
    "history": {
      "by_grader": {}
    }
  },
  "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).

Response

The card's population history.

data

object

The current population (as a Card) plus a per-grader history series.

Show child attributes