API Documentation

Authentication

Generate an API key from your profile page. Include it in the X-API-Key header.

curl https://api.cardgrade.online/api/health \
  -H "X-API-Key: cg_your_api_key_here"

Grade a Card

Upload a card image for AI grading analysis.

curl -X POST https://api.cardgrade.online/api/upload \
  -H "X-API-Key: cg_your_api_key_here" \
  -F "file=@card_front.jpg" \
  -F "back_file=@card_back.jpg"

Response

{
  "id": "a1b2c3d4-...",
  "status": "completed",
  "recommendation": "submit",
  "confidence": 0.87,
  "estimated_grade": 8.8,
  "validation": {
    "blur_score": 245.3,
    "glare_detected": false,
    "card_detected": true,
    "perspective_corrected": true,
    "issues": []
  },
  "image_url": "/api/images/a1b2c3d4-...",
  "created_at": "2026-04-19T..."
}

Bulk Upload

Upload up to 50 cards at once. Business tier only.

curl -X POST https://api.cardgrade.online/api/bulk-upload \
  -H "X-API-Key: cg_your_api_key_here" \
  -F "files=@card1.jpg" \
  -F "files=@card2.jpg" \
  -F "files=@card3.jpg"

Response

{
  "total": 3,
  "processed": 3,
  "failed": 0,
  "results": [
    {
      "id": "...",
      "recommendation": "submit",
      "confidence": 0.87,
      "estimated_grade": 8.8
    },
    ...
  ]
}

Get Result

curl https://api.cardgrade.online/api/results/a1b2c3d4-... \
  -H "X-API-Key: cg_your_api_key_here"

Export History

Export all your assessments as JSON. Business tier only.

curl https://api.cardgrade.online/api/export \
  -H "X-API-Key: cg_your_api_key_here"

Manage API Keys

Rate Limits