Extract grader and certificate number from a graded card image, then look up pricing.

This endpoint uses AI vision to read the grading label from a card image, extracts the grading company (PSA, BGS, CGC, etc.) and certificate number, then performs the same lookup as /prices-by-cert.

Provide either image_url (public URL) or image_base64 (base64-encoded image).

Daily limit

This endpoint is capped at 2000 requests per day per API key.

The allowance is shared with /v1/cards/details-by-cert-ocr — calls to either endpoint draw from the same daily pool. It resets at 00:00 UTC and applies on every subscription tier, because each request runs an AI vision model over your image.

Once the cap is reached the endpoint returns 429 until reset. The 429 response carries the quota state in its headers:

Successful responses do not currently carry these headers, so track your own call count if you need to throttle before hitting the cap.

Contact sales if you need more capacity — support@cardhedger.com. Higher daily allowances are available for this endpoint.

Example curl:

curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{
       "image_url": "https://example.com/graded-card.jpg"
     }' \
     "https://api.cardhedger.com/v1/cards/prices-by-cert-ocr"

Returns certificate info, card details, and price history (same as prices-by-cert).

Daily allowance of uncached lookups. The first time a certificate is looked up it needs a live call to our grading-data provider and draws on your account's daily allowance of such lookups; repeat lookups are served from cache and do not. See Rate limits in the API overview for your tier's allowance.

{
  "days": 180,
  "image_url": "https://example.com/graded-card.jpg"
}

{
  "card": {
    "card_id": "1699670576265x928796749151534600",
    "category": "Baseball",
    "category_group": "Sports Cards",
    "description": "C.C. Sabathia 1999 Bowman Chrome Baseball",
    "image": "https://942284f33c575895b4be9de571ca6e40.cdn.bubble.io/d112/f1699670857725x475053799924132860/resized_20231111_024737.jpeg",
    "number": "344",
    "player": "C.C. Sabathia",
    "set": "1999 Bowman Chrome Baseball",
    "set_type": "Bowman Chrome Baseball",
    "variant": "Base"
  },
  "cert_info": {
    "cert": "50000000",
    "description": "1999 Bowman Chrome C.C. Sabathia 344",
    "gemrate_id": "25783324b9710f1366ca4d54f3dd4689c02b6885",
    "grade": "PSA 10",
    "grader": "psa",
    "universal_gemrate_id": "25783324b9710f1366ca4d54f3dd4689c02b6885"
  },
  "prices": [
    {
      "Grade": "PSA 10",
      "card_id": "1699670576265x928796749151534600",
      "closing_date": "2025-10-26T23:59:00.000Z",
      "price": "125.50"
    },
    {
      "Grade": "PSA 10",
      "card_id": "1699670576265x928796749151534600",
      "closing_date": "2025-10-25T23:59:00.000Z",
      "price": "122.00"
    }
  ]
}