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

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 returns certificate info and card details (without price history).

Same as /details-by-certs but accepts an image instead of certificate numbers.

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

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/details-by-cert-ocr"

Daily limit

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

The allowance is shared with /v1/cards/prices-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.

Returns certificate info and card details (no price history).

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.

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