Loading...
Loading...
Send a card photo, get back a full AI grade — PSA, BGS & CGC predictions, corner, edge, surface and centering analysis, market value, and a share-ready report image. Structured JSON, no SDK required.
Plans from $149/mo · 50% off your first month · Explore the OpenAPI 3.1 spec
$ curl -X POST https://cardgrade.io/api/v1/grade \
-H "Authorization: Bearer cgrd_live_..." \
-F "frontImage=@charizard.jpg"
{ "id": "d71bb389", "status": "pending" }
# poll until completed
{
"status": "completed",
"overallGrade": 9.2,
"results": {
"centering": 9.5, "corners": 9.0,
"edges": 9.0, "surface": 9.0,
"psaPrediction": 9, "gradeLabel": "Mint",
"marketValueLow": 120, "marketValueHigh": 180
}
}The same engine behind 32,000+ analyzed cards — exposed as a clean REST API you can ship this week.
Every score, AI summary, and photo the web app shows — returned as a clean, bare JSON object. No SDK to install, no envelope to unwrap.
Submit a photo, poll for the result. 47 inspection points across centering, corners, edges, and surface — the same CGI Vision engine the apps run on.
Mint a read-only key for read-heavy apps that can pull grades and market values but can never spend a credit. Or a full-access key for automated grading.
Pass an Idempotency-Key and a timed-out request is safe to resend — you get the original grade back instead of being charged twice.
No screen-scraping an HTML page. GET /api/v1/grade/:id returns the structured data behind every grade.
{
"id": "d71bb389",
"status": "completed",
"cardName": "2024 Topps Chrome Paul Skenes RC",
"overallGrade": 9.2,
"reportImageUrl": "https://cardgrade.io/…/report.jpg",
"results": {
"psaPrediction": 9,
"gradeLabel": "Mint",
"limitingFactor": "centering",
"frontCornerScores": { "topLeft": 9.0, "topRight": 9.5 },
"marketValueLow": 120,
"marketValueHigh": 180,
"zoneCropUrls": {
"front-full": "https://…",
"front-topLeft": "https://…",
"front-sfx": "https://…"
}
}
}If your product touches trading cards, grade and value data make it smarter.
Auto-fill condition, predicted grade, and a value estimate on every card listing the moment a photo is uploaded.
Feed grade-conditioned market value data into your pricing models, comps, and portfolio dashboards.
Bulk pre-grade intake so staff only send the highest-potential cards to PSA, BGS, or CGC.
Generate instant, share-ready condition reports for every card pulled — at break-night scale.
The boring guarantees that matter when this is in your critical path.
Read-only or full-access, chosen when you create the key. Read-only keys cannot submit gradings or spend credits.
An Idempotency-Key header dedupes retried submits so network blips never double-charge a credit.
Every response carries X-RateLimit headers; 429s include Retry-After so your client backs off cleanly.
A complete machine-readable spec that drops straight into Postman, Insomnia, or your codegen.
/api/v1/gradeSubmit a card for grading/api/v1/grade/:idFetch a grade + full report/api/v1/gradesList your gradings/api/v1/grade/:id/reportGet the report image (JPG)/api/v1/accountPlan, credits & rate limitsPick a tier and get an API key in minutes. Every plan includes the full report, scoped keys, idempotency, and the OpenAPI spec — your first month is 50% off.
New integrations and smaller apps.
50% off your first month
Scaling marketplaces and trend apps.
50% off your first month
High-volume and bulk grading.
50% off your first month
First month 50% off, then the monthly price — cancel anytime. Need more than 12,000 grades/mo or custom terms? Talk to us.
Yes. Once a grade completes, the API returns everything the web report shows — AI summaries, per-zone corner/edge/surface scores, centering metrics, PSA/BGS/CGC predictions, the close-up crop photos, market value, and a rendered report image — as structured JSON.
The dedicated Developer API plans (Starter, Growth, Scale) have no trial — subscribe and your key works immediately. API access is also included on active Pro and Business subscriptions. The 3-day trial on consumer plans lets you explore the dashboard and docs; generate a key once it converts to an active plan. Building at volume? Reach out and we will help you evaluate.
Pokémon, baseball, basketball, football, hockey, Magic: The Gathering, Yu-Gi-Oh, One Piece, and most modern and vintage trading cards.
You do not need one. It is plain REST with bare JSON responses and an OpenAPI 3.1 spec, so any HTTP client in any language works out of the box.
Each completed grade uses one credit from your plan. Submissions are idempotent, and failed requests are automatically refunded, so you only pay for grades you actually receive.
Building something bigger? Talk to us about volume pricing and integration support.