{
  "name": "GradedDB Certificate Lookup API",
  "baseUrl": "https://gradeddb.com",
  "version": "1.0.0",
  "auth": {
    "publicLookupRequiresBearerToken": false,
    "externalLookupRequiresBearerToken": true,
    "credentialStore": "mongodb",
    "database": {
      "name": "test",
      "collection": "gradedapi"
    },
    "header": "Authorization: Bearer <GRADEDDB_API_KEY>"
  },
  "endpoints": {
    "health": "https://gradeddb.com/api/health",
    "providers": "https://gradeddb.com/api/providers",
    "lookup": "https://gradeddb.com/api/lookup",
    "externalLookup": "https://gradeddb.com/api/v1/lookup",
    "credentialCheck": "https://gradeddb.com/api/v1/credentials/me",
    "openapi": "https://gradeddb.com/api/openapi.json",
    "docs": "https://gradeddb.com/docs/CERT_LOOKUP_INTEGRATION_GUIDE.md"
  },
  "providers": [
    {
      "id": "psa",
      "label": "PSA",
      "mode": "api",
      "lookupHint": "PSA has a token-protected public API; without a token, use the official cert page."
    },
    {
      "id": "beckett",
      "label": "Beckett",
      "mode": "web-api",
      "lookupHint": "Beckett card lookup supports BGS, BVG, and BCCG serial numbers."
    },
    {
      "id": "cgc",
      "label": "CGC",
      "mode": "scrape",
      "lookupHint": "CGC has a public cert page, though automated server-side fetches may be challenged."
    },
    {
      "id": "sgc",
      "label": "SGC",
      "mode": "protected-api",
      "lookupHint": "SGC's cert page accepts 7-digit black-label certs and 11-character green/white-label certs."
    },
    {
      "id": "tag",
      "label": "TAG",
      "mode": "api",
      "lookupHint": "TAG exposes a public encrypted card detail endpoint used by its cert viewer."
    },
    {
      "id": "ace",
      "label": "Ace Grading",
      "mode": "official-page",
      "lookupHint": "Use Ace Grading's Certification Lookup search box with the cert number."
    },
    {
      "id": "getgraded",
      "label": "GetGraded",
      "mode": "scrape",
      "lookupHint": "GetGraded returns public cert data on its Cert Checker page."
    },
    {
      "id": "pgs",
      "label": "PGS / Platin Grading",
      "mode": "scrape",
      "lookupHint": "PGS records are available on direct /card/{cert} pages."
    },
    {
      "id": "pggrading",
      "label": "PG Grading",
      "mode": "web-api",
      "lookupHint": "PG Grading uses an embedded public verification route with a page hash."
    },
    {
      "id": "pca",
      "label": "PCA",
      "mode": "protected-page",
      "lookupHint": "PCA's public card check is protected by Cloudflare/Turnstile in this environment."
    },
    {
      "id": "ags",
      "label": "AGS",
      "mode": "official-page",
      "lookupHint": "AGS exposes a public population report, but no serial-number detail API was found."
    },
    {
      "id": "mnt",
      "label": "MNT Grading",
      "mode": "official-page",
      "lookupHint": "Enter the MNT verification ID on the official Verification Lookup page."
    },
    {
      "id": "ksa",
      "label": "KSA",
      "mode": "official-page",
      "lookupHint": "KSA's verification page is public, but their visible cert result endpoint is not exposed in the fetched page."
    },
    {
      "id": "pcg",
      "label": "Premier Card Grading",
      "mode": "api",
      "lookupHint": "PCG reports use a direct /report/{cert-number} URL and public grading data endpoint."
    },
    {
      "id": "isa",
      "label": "ISA Grading",
      "mode": "web-api",
      "lookupHint": "ISA exposes a public cert_ajax.php lookup behind its validation page."
    },
    {
      "id": "advanced",
      "label": "Advanced Grading",
      "mode": "api",
      "lookupHint": "Advanced Grading's lookup app reads from a public Supabase table."
    },
    {
      "id": "aura",
      "label": "Aura Grading",
      "mode": "scrape",
      "lookupHint": "Aura returns public cert details on a direct cert.php query page."
    }
  ]
}