Cards API

Cards Graded cert API

Look up one graded trading card slab by its PSA, BGS, SGC or CGC certificate number and get the card (year, set, number, player or character, variety), its grade with BGS subgrades, the approximate population in that grade, the estimated market value with its low and high range, the last sale of any copy in that grade, and the sales of this exact slab that carry its certificate number (eBay and Fanatics Collect sales only from about the last 90 days, when the seller put the number in the title), in one normalized response. Sports cards, Pokemon and other trading card games.

POST/v1/run/cards.graded_cert
Uptime
100.00%
30d · 2 calls
Requests
2
30d
Response
6.8s
median · 30d

Pricing

Cards Graded cert API pricing

Providers
Chameleon- served- uptime- p50$3.38/1k reqflat
You pay
$33.80
$3.38/1k req, only for what you use. No monthly plan.
Your first 29 requests are free with the $0.10 starting balance.

Try it

Get Cards graded cert in one request

Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
  "data": {
    "cardName": "Example title",
    "cardNumber": "example",
    "category": "general",
    "certNumber": "example",
    "certUrl": "https://example.com/page",
    "grade": 12.5,
    "gradeLabel": "Example title",
    "gradingCompany": "Acme Inc",
    "image": "https://example.com/image.jpg",
    "lastSaleInGrade": {
      "marketplace": "example",
      "price": 19.99,
      "saleType": "general",
      "soldUtc": 12.5,
      "url": "https://example.com/page"
    },
    "populationInGrade": 42,
    "qualifier": "example",
    "sales": [
      {
        "grade": "example",
        "image": "https://example.com/image.jpg",
        "marketplace": "example",
        "matchedBy": "example",
        "price": 19.99,
        "saleId": "a1b2c3d4",
        "saleType": "general",
        "shippingPrice": 19.99,
        "soldUtc": 12.5,
        "title": "Example title",
        "url": "https://example.com/page"
      }
    ],
    "salesInGrade": 42,
    "set": "example",
    "subgrades": {
      "centering": 12.5,
      "corners": 12.5,
      "edges": 12.5,
      "surfaces": 12.5
    },
    "subject": "Example title",
    "value": 19.99,
    "valueConfidence": 19.99,
    "valueHigh": 19.99,
    "valueLow": 19.99,
    "variety": "example",
    "year": 2024
  },
  "found": true,
  "reason": "not_found"
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

One request, one response shape.

Every field you send and every field you get back, each with a real example.

Last verified 2026-11-21 · uptime and latency measured over 30d

Request body

JSON, posted to this endpoint.

  • certNumberstring

    0011562845

    Certificate number printed on the slab label, digits only, e.g. 171634124. Keep any leading zeros: BGS numbers start with 00 (0011562845).

  • gradingCompanyenum

    BGS

    The company that graded the slab. Required because the same number can exist at two graders (4272318 is both a PSA and an SGC cert).

You send. A small JSON body. The values shown are examples to replace with your own.

Response

JSON, one example value per field.

datadata

The graded slab, or null when no slab has that certificate number at that grading company.

  • cardNamestring

    Full card name, e.g. "1999 Pokemon Game Holo Charizard #4". Populated whenever the provider has data for the entity.

  • cardNumberstring

    Card number within the set.

  • categorystring

    Card category, e.g. pokemon, basketball or football.

  • certNumberstring

    Certificate number of the slab. Populated whenever the provider has data for the entity.

  • certUrlstring

    The grading company's own certificate verification page, when it has one (PSA).

  • gradenumber

    Numeric grade, e.g. 9.5. Populated whenever the provider has data for the entity.

  • gradeLabelstring

    Grade as printed with its grader, e.g. "PSA 9" or "BGS 9.5".

  • gradingCompanystring

    Grading company of the slab: PSA, BGS, SGC or CGC. Populated whenever the provider has data for the entity.

  • imagestring

    Card image URL, when one is known.

  • populationInGradeinteger

    Approximate number of copies of this card graded at this grade by this grader. It tracks the grader's own population report closely (within about 2% for PSA) but is not the official count.

  • qualifierstring

    Grade qualifier such as OC (off center) or MK (marks), or null when the grade has none.

  • salesInGradeinteger

    Number of recorded sales of any copy of this card at this grade.

  • setstring

    Set name, e.g. "Pokemon Game" or "Fleer".

  • subjectstring

    Player or character on the card.

  • valuenumber

    Estimated market value in USD of this card at this grade, modeled from recent sales.

  • valueConfidencenumber

    Confidence in the estimated value, 0 to 100. Higher means more recent comparable sales.

  • valueHighnumber

    High end of the estimated value range in USD.

  • valueLownumber

    Low end of the estimated value range in USD.

  • varietystring

    Variety or parallel, e.g. "1st Edition Holo" or "Refractor", or null for the base card.

  • yearinteger

    Year of the card's set.

lastSaleInGradedata.lastSaleInGrade

The most recent sale of any copy of this card at this grade. Every member is null when none is recorded.

  • marketplacestring

    Where it sold, as a lowercase marketplace id, e.g. ebay, fanatics (Fanatics Collect, including former PWCC venues), goldin or heritage.

  • pricenumber

    Sale price in USD.

  • saleTypestring

    How it sold: AUCTION, BUY_IT_NOW or BEST_OFFER.

  • soldUtcnumber

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • urlstring

    Link to the sold listing.

each saledata.sales[]

Sales of this exact slab that carry its certificate number, newest first. Sales recorded with the number itself are kept whatever their age; eBay and Fanatics Collect sales are found only from about the last 90 days and only when the seller wrote the number in the title. Empty when no such sale is found, which does not mean the slab never sold.

  • gradestring

    Grade as listed, e.g. "PSA 6".

  • imagestring

    Listing photo URL.

  • marketplacestring

    Where it sold, as a lowercase marketplace id, e.g. ebay, fanatics (Fanatics Collect, including former PWCC venues), goldin or heritage.

  • matchedBystring

    How the sale was tied to this slab: cert_field (the sale record carries the certificate number) or title (the seller wrote the number in the listing title).

  • pricenumber

    Sale price in USD.

  • saleIdstring

    Identifier of the sale record.

  • saleTypestring

    How it sold: AUCTION, BUY_IT_NOW or BEST_OFFER.

  • shippingPricenumber

    Shipping charged in USD, when known.

  • soldUtcnumber

    UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • titlestring

    Listing title.

  • urlstring

    Link to the sold listing.

subgradesdata.subgrades

BGS subgrades. Every member is null for graders that do not issue subgrades.

  • centeringnumber

    Centering subgrade.

  • cornersnumber

    Corners subgrade.

  • edgesnumber

    Edges subgrade.

  • surfacesnumber

    Surface subgrade.

top level
  • foundboolean

    True when the certificate number resolved to a graded slab at that grading company.

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

You get back. Named, typed fields in the same shape whichever source answers.

FAQ

About the Cards Graded cert API

The AnyAPI Cards Graded cert API returns Cards graded cert data as normalized JSON from one POST call to /v1/run/cards.graded_cert. Look up one graded trading card slab by its PSA, BGS, SGC or CGC certificate number and get the card (year, set, number, player or character, variety), its grade with BGS subgrades, the approximate population in that grade, the estimated market value with its low and high range, the last sale of any copy in that grade, and the sales of this exact slab that carry its certificate number (eBay and Fanatics Collect sales only from about the last 90 days, when the seller put the number in the title), in one normalized response. Sports cards, Pokemon and other trading card games. AnyAPI returns one normalized schema whichever source serves it. It costs from $3.38 per 1,000 requests, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Cards graded cert calls through AnyAPI succeeded, with a median response time of 6.8 seconds across 2 measured calls.

It costs from $3.38 per 1,000 requests, in US dollars with no subscription and no monthly minimum. You fund one USD wallet and each call draws it down. Some failed wallet-funded requests incur processing charges that we pass through at cost, with no markup; the error response shows the amount charged.

Look up one graded trading card slab by its PSA, BGS, SGC or CGC certificate number and get the card (year, set, number, player or character, variety), its grade with BGS subgrades, the approximate population in that grade, the estimated market value with its low and high range, the last sale of any copy in that grade, and the sales of this exact slab that carry its certificate number (eBay and Fanatics Collect sales only from about the last 90 days, when the seller put the number in the title), in one normalized response. Sports cards, Pokemon and other trading card games. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 100.0% of Cards graded cert calls through AnyAPI succeeded, with a median response time of 6.8 seconds across 2 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.

Yes. A new AnyAPI account starts with $0.10 of free balance and no card required, which covers 29 Cards Graded cert calls at $0.00338 each.

Send a POST request to https://api.getanyapi.com/v1/run/cards.graded_cert with your AnyAPI key in an "Authorization: Bearer" header and the input as a JSON body. The same key and the same wallet work on every AnyAPI endpoint.

No. You add US dollars to one prepaid AnyAPI balance and each request draws it down. There is no monthly plan and no minimum, and the same balance pays for every AnyAPI endpoint.

Yes. Install @getanyapi/sdk from npm for TypeScript or getanyapi from pip for Python. Both call every AnyAPI endpoint with the same key, and any HTTP client works too.

Yes. An agent can connect to the AnyAPI MCP server at https://api.getanyapi.com/mcp, or create its own free-trial key with one unauthenticated POST to https://api.getanyapi.com/agent/signup and call this endpoint over HTTP.