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.99/mo · Intro pricing available · 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 thousands of 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 share-ready condition reports in about 60 seconds 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/validateDry-run a request — validate it without spending a credit/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 — intro pricing is available.
New integrations and smaller apps.
Intro pricing available
Scaling marketplaces and trend apps.
Intro pricing available
High-volume and bulk grading.
Intro pricing available
Monthly billing starts at checkout — 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. Consumer plan subscribers can explore the dashboard and docs; generate a key once the plan is active. 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.
No. Grading is async, so you can poll GET /api/v1/grade/:id — or register a webhook in your dashboard under Webhooks and we POST an HMAC-signed grading.completed event to your URL the moment a grade finishes. Webhooks are included on every plan with API access.
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.