Commercial card grading API

Card grading built for your platform

Add AI condition grading to your trading card app, marketplace or workflow. One card, front and back, counts as one grade.

Start with 7 days of unlimited grading. A payment method is required. Your selected monthly plan starts automatically after the trial; cancel before it ends to avoid the first charge. One trial per API account.

5,000 grades / month

$250 USD / month

$0.0500 per card at full usage

  • 7-day unlimited grading trial for new accounts
  • Front and back included
  • Overall grade and condition subgrades
  • Separate front/back corner, edge and surface scores
  • REST API and MCP for AI agents
  • Cancel anytime

10,000 grades / month

$449 USD / month

$0.0449 per card at full usage

  • 7-day unlimited grading trial for new accounts
  • Front and back included
  • Overall grade and condition subgrades
  • Separate front/back corner, edge and surface scores
  • REST API and MCP for AI agents
  • Cancel anytime

Grading only. These plans exclude card identification, authentication, price estimates and market analysis. Unused monthly grades do not roll over. AI grades are estimates, not certified grades.

Let your AI agent set it up

Paste this into your coding agent. Replace the name and email with yours. Your agent prepares the integration; you enter payment details only on Stripe.

Set up CardGrader.AI commercial grading for my app [APP NAME], using billing email [MY EMAIL]. Read https://cardgrader.ai/api-docs and https://cardgrader.ai/api-terms. I want the 7-day unlimited grading-only trial, then $250/month for 5,000 complete front/back card grades. Use the MCP server https://cardgrader.ai/mcp and start_grading_trial, or register once with commercialOnly=true at POST /v1/agents and call POST /v1/subscriptions/checkout with plan grading_5000. Reuse my existing API key if I have one. Save the key securely, show me the Stripe checkout link and billing terms, and wait for me to finish checkout. Never ask for card details in chat. After I finish, check my balances and trial expiry, then test one front/back card with grade_card or POST /v1/grades. Use a unique Idempotency-Key and store the result. Identification and market data are not included; never spend prepaid credits without asking me.

REST and MCP quickstart

Need identification or market information too?

Buy prepaid API credits for those requests. They are tracked separately from monthly grades, including when both are on the same account.

API documentation and quickstart · API data and privacy · OpenAPI specification · Agent integration guide

Common questions

Is the price per image or per card?

Per card. Send one front photo and one back photo in the same request; that uses one grade.

How do monthly grades and prepaid credits work together?

Use POST /v1/grades for subscription grading. Use POST /v1/scans with prepaid credits for identification, grading with identification, or full analysis. GET /v1/agents/me reports each balance separately.

Can I cancel or change plans?

Yes. Manage billing lets you cancel future renewals and update your payment method. Plan changes start at the next renewal and do not reset the current allowance.

What happens after the free trial?

We automatically charge your selected monthly price after seven days. A successful payment starts your 5,000- or 10,000-grade monthly allowance. If you cancel before trial end, there is no first charge and unlimited access ends at the trial deadline. An unpaid trial does not retain grading access. Returning subscribers do not receive a second trial.

Does unlimited mean unlimited simultaneous requests?

There is no grade-count cap during the seven-day trial. Submit one card at a time per API account; the usual API rate limits apply to protect service for all customers.

Can prices change?

We give at least 14 days' notice before changing your subscription price. Prices for future prepaid credit-pack purchases may change at any time. See the API terms.