Get card details for a GemRate card identifier.

The GemRate-ID analog of /v1/cards/details-by-certs, for callers who hold a GemRate ID (grader-specific or universal) rather than a grader certificate number.

How it works

1. Looks the ID up directly in CardHedge.
2. Checks the persistent cert-resolution cache (any previously resolved certificate sharing this GemRate ID).
3. Fallback: queries the GemRate population API for the card description and any sibling/universal GemRate IDs, retries the CardHedge lookup with those, and finally matches the description via the AI card-match endpoint.

Card resolution (card_source / match_confidence)

• card_source: "gemrate_id" — resolved by a direct GemRate ID → CardHedge lookup. match_confidence is null.
• card_source: "card_match" — resolved from the GemRate description via the AI fallback; match_confidence (0-1) is the matcher's score. Cards resolved this way have null category_group and set_type.

Status codes

• 200 with card: null — GemRate knows the ID but no CardHedge card matched (gemrate_info.description is still populated).
• 404 — the ID is unknown to both CardHedge and GemRate.
• 502 — an upstream API failed while resolving.

Example curl:

curl -X POST -H "X-API-Key: your-api-key-here" \
     -H "Content-Type: application/json" \
     -d '{"gemrate_id": "25783324b9710f1366ca4d54f3dd4689c02b6885"}' \
     "https://api.cardhedger.com/v1/cards/details-by-gemrate-id"

{
  "gemrate_id": "25783324b9710f1366ca4d54f3dd4689c02b6885"
}