The Partner Grade APIfor card platforms
Plug Mint Condition™ grading into your marketplace, POS, or inventory stack. Send a SKU plus front and back images. Get grades, overlays, and scores back in one response.
api.mintconditiongrading.com/v1/grade· Preview{ "sku": "MC-INV-10482", "images": { "front": "https://cdn.mcgrade.com/in/10482-f.jpg", "back": "https://cdn.mcgrade.com/in/10482-b.jpg" }, "card": { "player": "Jackie Robinson", "year": 1948, "set": "Leaf", "number": "79", "category": "Baseball" } }
How it works
Same request format for every card you submit.
- 1
Authenticate
Send requests with a partner key. We issue keys after reviewing your Request Information form.
- 2
Submit a card
POST the SKU, front and back image URLs, and any card details you already have.
- 3
Get results
We return the overall grade, subgrades, and overlay image URLs in one response.
What you get back
Grades, overlays, and a report link in one response.
Grades & subgrades
Overall grade plus centering, corners, edges, and surface. Same breakdown dealers see in Vault.
Overlay images
Image overlays you can show in your own UI so customers can see what drove the grade.
Report link
A shareable report URL for each graded card, ready to open from your product.
These are estimates, not official PSA, BGS, or SGC grades.
Partner API
Request Information
Tell us a bit about your product. We will follow up when sandbox access is ready.
Frequently asked questions
- Who is the Partner API for?
- Marketplaces, POS systems, inventory tools, and other B2B products that want to grade cards through an API. It is not a stand-in for consumer credit packs on the website or iOS app.
- How do images work?
- You send front and back image URLs (or another upload flow we agree on). We return grade results and overlay image URLs you can show in your product.
- Are these official PSA, BGS, or SGC grades?
- No. Mint Condition returns AI pre-grade estimates to help with triage and listing decisions. Only the grading companies issue official slab grades.
- When will sandbox access open?
- Soon. Send a Request Information form and we will follow up when a sandbox is ready.