Loading...
CardGrade now offers a public REST API for Pro and Business subscribers. Programmatically submit cards for AI grading, retrieve results, and integrate CardGrade into your tools and workflows.
In short: The CardGrade REST API lets card shops, prep services, and developers submit card images programmatically and receive the same 16-zone AI grading reports available on the website — same AI-powered grading engine, no browser required. See the API docs and current plan details for integration guidance.
We built CardGrade to make AI card grading fast and accessible. Today, we're taking the next step: the CardGrade API is now live for Pro and Business plan subscribers.
Whether you run a card shop, operate a prep service, build inventory tools, or just have a large collection to process, the API lets you integrate AI card grading directly into your workflow — no browser required.
The CardGrade API is a standard REST API that accepts card images and returns the same detailed grading reports you get on the website:
Every API call uses the same CGI Vision AI engine that powers the website and Chrome Extension, so you get the same AI-powered grading and full 47-point inspection report.
The API opens up use cases that weren't practical through the website alone:
Card shops and prep services can pre-screen inventory in bulk before deciding which cards to send to PSA, BGS, or CGC. Upload photos as part of your intake process and get grade predictions without manual effort.
App developers and tool builders can integrate CardGrade grading into their own platforms — inventory management systems, marketplace apps, collection trackers, or anything else that touches trading cards.
High-volume collectors can script their grading workflow instead of uploading cards one at a time through the website.
Getting started takes three steps:
Go to your dashboard API page and create a new token. You'll see the token once — copy it and store it securely.
Send a POST request with your card images:
curl -X POST https://cardgrade.io/api/v1/grade \
-H "Authorization: Bearer YOUR_API_TOKEN" \
-F "frontImage=@card_front.jpg" \
-F "gradingCompany=PSA" \
-F "cardType=Pokemon Card"
Poll the grading status endpoint until it completes:
curl https://cardgrade.io/api/v1/grade/GRADING_ID \
-H "Authorization: Bearer YOUR_API_TOKEN"
When the grading is complete, you'll receive the full report including overall grade, sub-grades (centering, corners, edges, surface), and predictions for PSA, BGS, and CGC.
The full API documentation has detailed endpoint references, code examples in cURL, Python, and Node.js, and a complete error code reference.
API access is included with Pro and Business plans at no extra cost. Each API grading uses one credit from your plan, just like grading on the website.
| Plan | Rate Limit | Monthly Credits |
|---|---|---|
| Pro ($24.99/mo) | 10 grades/minute | 80 credits |
| Business ($74.99/mo) | 30 grades/minute | 300 credits |
Need more credits? Credit packs are available starting at $10 for 20 credits, and they never expire.
If you're already on a Pro or Business plan:
Not on Pro or Business yet? View plans to upgrade and unlock API access.
We're excited to see what you build with the CardGrade API. If you have questions or feedback, reach out through our contact page — we'd love to hear from you.
Pre-screen your cards before submitting to PSA, BGS, or CGC. Plans from $4.99/mo.
Start gradingAlso available as a Chrome Extension
Grade cards while you browse
Install our free Chrome Extension — right-click any card on eBay, COMC, or TCGPlayer for a grade in ~60 seconds.
Founder, CardGrade
Jamie Budesky is the founder of CardGrade and the engineer behind its AI vision grading pipeline. An Army veteran and IT specialist (DoD, since 2017), he writes about card grading, AI/ML grading technology, and collecting strategy — grounded in CardGrade's own grading data.
Forensic Capture is CardGrade's premium grade: eight per-corner macros, stitched live, for sharper whitening, fraying, and edge-wear detection.
Pair a high-speed card scanner with the CardGrade API to build an automated grading pipeline. Scan cards, submit images programmatically, and get AI grade predictions at scale.