FREE DEVELOPER API

Put BAO condition pre-grading in your app.

Generate a scoped API key from your BAO account. Full-access keys submit front + back photos through BAO's production evidence pipeline. Read-only keys can retrieve your account's reports but cannot submit a grade.

Free fair use

5 completed submissions/minute and 50/day per account. No credits or paid API plan.

Scoped keys

Choose read-only or full access. Tokens are shown once and stored only as hashes.

Idempotent

Send an Idempotency-Key when submitting so a retry can replay the original completed result.

Evidence-first JSON

BAO grade state, subgrades, identity candidate, market context, defect evidence and recapture guidance.

Submit a card

curl -X POST https://baograde.com/api/v1/grade \
  -H "Authorization: Bearer bao_live_..." \
  -H "Idempotency-Key: your-unique-id" \
  -F "[email protected]" \
  -F "[email protected]"

Core endpoints

POST /api/v1/grade
GET  /api/v1/grade/{card_id}
GET  /api/v1/grades
GET  /api/v1/account
GET  /api/v1/openapi.json

BAO requires both sides. This API returns BAO's photographic condition analysis. It does not authenticate cards, encapsulate them, or fabricate PSA/BGS/CGC/TAG/SGC predictions before BAO has evidence to support such calibration.

API key management is available to signed-in BAO accounts through /api/account/api-keys. The OpenAPI 3.1 document is public at /api/v1/openapi.json.