# Slab identification

Use `POST /api/v1/slabs/identify` when the evidence comes from a graded slab. ALT resolves the certificate to its graded identity independently of TCGplayer coverage. A missing raw-card match does not cancel or weaken a successful slab result.

Send exactly one of `cert`, `barcode`, or `labelText`. Supply the grader when known. For ordinary slab lookups, set `enrich:true` to request the resolved slab’s graded market with the identity unless the user requests identity only; otherwise use `/api/v1/graded/prices` to choose markets explicitly.

Generate the operation ID once for a new lookup. On a network retry, rerun only the `curl` command with the same body and saved ID.

```bash
STRATA_OPERATION_ID=$(uuidgen)
curl https://stratatcg.com/connector/api/v1/slabs/identify \
  -H "Authorization: Bearer $STRATA_API_KEY" \
  -H 'Content-Type: application/json' \
  -H "Idempotency-Key: $STRATA_OPERATION_ID" \
  -d '{"cert":"149085863","grader":"PSA","enrich":true}'
```

A resolved response includes an ALT `identityRef`, the slab identity, an optional graded quote, and independent registry progress. `rawMatch.status` can be `verified`, `queued`, `resolving`, `review_required`, `unmapped`, `unsupported`, or `unavailable`. Only a verified raw link can support a raw comparison. Sports and foreign-language slabs remain identifiable and priceable even without one.

Present the slab identity and graded quote together. Include a TCGplayer link only when a verified raw mapping exists, clearly labelled as a raw reference. Display a returned slab image when available; never substitute an unverified card image. See [result presentation](./agent-workflows.md).

If the result is not found or temporarily unavailable, preserve that distinction. A provider failure is not proof that the certificate is invalid. `TAG` cert-only lookup is explicitly unsupported by the current ALT source. Do not send a slab label to `/api/v1/identify`; that route identifies raw/sealed products from text.

`cardLadderUrl`, when returned, is an outbound cert-search link. Strata does not scrape CardLadder and does not claim the link is a verified item permalink. See [graded prices](./graded-prices.md) to request additional markets and [registry feedback](./registry-feedback.md) to report a wrong mapping.
