curl --request GET \
  --url https://api.gemrate.com/v1/certs/{grader}/{cert}/population \
  --header 'x-api-key: <api-key>'

import requests

url = "https://api.gemrate.com/v1/certs/{grader}/{cert}/population"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.gemrate.com/v1/certs/{grader}/{cert}/population', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gemrate.com/v1/certs/{grader}/{cert}/population",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gemrate.com/v1/certs/{grader}/{cert}/population"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.gemrate.com/v1/certs/{grader}/{cert}/population")
  .header("x-api-key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gemrate.com/v1/certs/{grader}/{cert}/population")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "data": {
    "description": "1986 Fleer Michael Jordan 57",
    "universal_gemrate_id": "25b4432f12a5d6ec29a6f00490200416d5dfa242",
    "gemrate_id": "25b4432f12a5d6ec29a6f00490200416d5dfa242",
    "is_universal_match": true,
    "gemrate_url": "https://gemrate.com/card/25b4432f12a5d6ec29a6f00490200416d5dfa242",
    "grader": "psa",
    "grader_data": {
      "cert": "47178561",
      "grade": "psa_5",
      "grade_label": "5",
      "set_url": "https://www.psacard.com/pop/basketball-cards/1986/fleer/36766",
      "population_context": {
        "grade_population": 2080,
        "population_higher": 22520,
        "total_population": 30810,
        "gem_total": 340,
        "gem_rate": 0.011
      },
      "spec_id": "299576",
      "cert_retrieval_month": "2026-07"
    },
    "population": {
      "graders_included": [
        "psa",
        "beckett",
        "sgc",
        "cgc"
      ],
      "graders": {
        "psa": {
          "gemrate_id": "25b4432f12a5d6ec29a6f00490200416d5dfa242",
          "spec_id": "299576",
          "set_url": "https://www.psacard.com/pop/basketball-cards/1986/fleer/36766"
        },
        "beckett": {
          "gemrate_id": "7a70aeda7692bf7c24a1b8def12e5afed61c5761",
          "set_url": "https://www.beckett.com/grading/set_match/3022391"
        },
        "sgc": {
          "gemrate_id": "33a95ad34c7e119fd4a3fd6235019d1893feb630",
          "set_url": "https://gosgc.com/pop-report/result/1986-87%20Fleer/Basketball"
        },
        "cgc": {
          "gemrate_id": "408287c2bd6c833dde92eb99662064a9f65afbbf",
          "set_url": "https://www.cgccards.com/population-report/sports/basketball/3/1980s/32/1986-87-fleer/26933/"
        }
      },
      "population_data": {
        "total": 50437,
        "gem_total": 924,
        "gem_rate": 0.0183,
        "data_last_updated": "2026-06-24",
        "last_population_change": "2026-06-24",
        "by_grader": {
          "psa": {
            "total": 30810,
            "gem_total": 340,
            "gem_rate": 0.011,
            "last_population_change": "2026-06-24",
            "grades": {
              "psa_auth": 993,
              "psa_1": 454,
              "psa_1_5": 169,
              "psa_2": 534,
              "psa_2_5": 57,
              "psa_3": 943,
              "psa_3_5": 78,
              "psa_4": 1722,
              "psa_4_5": 126,
              "psa_5": 2080,
              "psa_5_5": 161,
              "psa_6": 3244,
              "psa_6_5": 217,
              "psa_7": 5107,
              "psa_7_5": 323,
              "psa_8": 9336,
              "psa_8_5": 713,
              "psa_9": 3079,
              "psa_10": 340
            },
            "qualifiers": {
              "psa_q1": 13,
              "psa_q1_5": 0,
              "psa_q2": 4,
              "psa_q3": 2,
              "psa_q4": 9,
              "psa_q5": 7,
              "psa_q6": 8,
              "psa_q7": 62,
              "psa_q8": 635,
              "psa_q9": 394
            }
          },
          "beckett": {
            "total": 14942,
            "gem_total": 554,
            "gem_rate": 0.0371,
            "last_population_change": "2026-06-24",
            "grades": {
              "beckett_1": 10,
              "beckett_1_5": 42,
              "beckett_2": 61,
              "beckett_2_5": 91,
              "beckett_3": 136,
              "beckett_3_5": 180,
              "beckett_4": 299,
              "beckett_4_5": 262,
              "beckett_5": 349,
              "beckett_5_5": 405,
              "beckett_6": 576,
              "beckett_6_5": 818,
              "beckett_7": 1279,
              "beckett_7_5": 1902,
              "beckett_8": 2724,
              "beckett_8_5": 3310,
              "beckett_9": 1944,
              "beckett_9_5": 548,
              "beckett_10_pristine": 6,
              "beckett_10_black": 0
            }
          },
          "sgc": {
            "total": 4498,
            "gem_total": 29,
            "gem_rate": 0.0064,
            "last_population_change": "2026-06-24",
            "grades": {
              "sgc_auth": 740,
              "sgc_1": 46,
              "sgc_1_5": 29,
              "sgc_2": 52,
              "sgc_2_5": 39,
              "sgc_3": 139,
              "sgc_3_5": 43,
              "sgc_4": 216,
              "sgc_4_5": 126,
              "sgc_5": 313,
              "sgc_5_5": 182,
              "sgc_6": 383,
              "sgc_6_5": 192,
              "sgc_7": 476,
              "sgc_7_5": 312,
              "sgc_8": 506,
              "sgc_8_5": 406,
              "sgc_9": 236,
              "sgc_9_5": 33,
              "sgc_10": 28,
              "sgc_10_pristine": 1
            }
          },
          "cgc": {
            "total": 187,
            "gem_total": 1,
            "gem_rate": 0.0053,
            "last_population_change": "2026-06-24",
            "grades": {
              "cgc_auth_altered": 34,
              "cgc_auth": 5,
              "cgc_1": 4,
              "cgc_1_5": 5,
              "cgc_2": 2,
              "cgc_2_5": 1,
              "cgc_3": 7,
              "cgc_3_5": 3,
              "cgc_4": 6,
              "cgc_4_5": 2,
              "cgc_5": 14,
              "cgc_5_5": 3,
              "cgc_6": 16,
              "cgc_6_5": 13,
              "cgc_7": 12,
              "cgc_7_5": 16,
              "cgc_8": 18,
              "cgc_8_5": 14,
              "cgc_9": 9,
              "cgc_9_5": 2,
              "cgc_10": 1,
              "cgc_10_pristine": 0,
              "cgc_10_perfect": 0
            }
          }
        }
      }
    }
  },
  "meta": {
    "request_id": "local"
  }
}

{
  "error": {
    "code": "invalid_grader",
    "message": "Unknown grader 'foo'."
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key."
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "code": "forbidden",
    "message": "Your key does not have access to this resource."
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "code": "cert_not_found",
    "message": "No PSA cert found for cert 12345678.",
    "details": {
      "grader": "psa",
      "cert": "12345678"
    }
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests."
  },
  "meta": {
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "code": "internal_error",
    "message": "Something went wrong."
  },
  "meta": {
    "request_id": "req_abc123"
  }
}