PSA API endpoint
Looks up PSA's own public Cert Verification record for one PSA-graded card by its certification number: item title, grade, label type, reverse cert/barcode flag, year, brand/title, subject, card number, category, PSA's own price estimate, and this-cert's-own population figures (population for this exact card+grade, and pop-higher). Scoped to PSA's trading-card department; a cert number issued under a different PSA division (autographs, tickets) returns a not-found error. PSA's full Population Report and Auction Prices Realized both require a PSA/Collectors account login and are not available through this endpoint.
/psa/cert-lookupQuery parameters:
cert_number (required) — the numeric PSA certification number printed
on the graded item's label, e.g. 125866845.Notable response behavior:
A successful lookup is cached for up to 6 hours, so psa_estimate and the
population figures can be that old on a repeat request. An uncached lookup
typically takes 5 to 30 seconds.
psa_estimate, psa_population, psa_population_url and
psa_pop_higher are omitted when PSA shows no figure for a given field
on this cert (e.g. an ungraded/authentic-only item carries no PSA
Estimate).
psa_population_url is PSA's own Population Report deep link for this
card+grade, informational only — following it requires a Collectors
account login.
label_type is empty when the cert carries PSA's standard label (no
special label variant like Fugitive Ink or a Black Label-style
qualifier).
A cert number PSA cannot resolve (invalid, or issued under a
non-trading-card department) returns 404.
| Field | In the sample | Value in the sample |
|---|---|---|
| cert_number | Has a value | 125,866,845 |
| title | Has a value | “2003 POKEMON SKYRIDGE #146 CHARIZARD-HOLO” |
| item_grade | Has a value | “GEM MT 10” |
| label_type | Has a value | “w/ Fugitive Ink Technology” |
| reverse_cert_barcode | Has a value | true |
| year | Has a value | 2,003 |
| brand_title | Has a value | “POKEMON SKYRIDGE” |
| subject | Has a value | “CHARIZARD-HOLO” |
| card_number | Has a value | 146 |
| category | Has a value | “TCG Cards” |
| psa_estimate | Has a value | “$211,821.00” |
| psa_population | Has a value | 250 |
| psa_population_url | Has a value | psacard.com |
| psa_pop_higher | Has a value | 0 |
| set_registry_note | Has a value | “This cert does not appear in any sets.” |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| cert_number | string | Yes | PSA certification number, numeric, e.g. \ | 125866845 | |
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/psa/cert-lookup?cert_number=125866845" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"cert_number": "125866845",
"title": "2003 POKEMON SKYRIDGE #146 CHARIZARD-HOLO",
"item_grade": "GEM MT 10",
"label_type": "w/ Fugitive Ink Technology",
"reverse_cert_barcode": true,
"year": "2003",
"brand_title": "POKEMON SKYRIDGE",
"subject": "CHARIZARD-HOLO",
"card_number": "146",
"category": "TCG Cards",
"psa_estimate": "$135,624.00",
"psa_population": 248,
"psa_population_url": "https://www.psacard.com/pop/tcg-cards/2003/pokemon-skyridge/62300",
"psa_pop_higher": 0,
"set_registry_note": "This cert does not appear in any sets.",
"source_url": "https://www.psacard.com/cert/125866845/psa"
}
}Request schema
No body schema
Response schema
#/definitions/psa.certLookupResponseDoc
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| code | integer | No | 200 | |||
| data | psa.CertLookupResult | No | ||||
| data.brand_title | string | No | BrandTitle is the issuing brand/product line, e.g. "POKEMON SKYRIDGE". | |||
| data.card_number | string | No | CardNumber is the card's number within its set, e.g. "146". | |||
| data.category | string | No | Category is PSA's own item category, e.g. "TCG CARDS". | |||
| data.cert_number | string | No | CertNumber echoes the requested certification number. | |||
| data.item_grade | string | No | ItemGrade is PSA's graded condition for this item, e.g. "GEM MT 10", from PSA's own published grade scale (Authentic through Gem Mint 10). | |||
| data.label_type | string | No | LabelType is a special label variant PSA applied to this cert, e.g. "W/ FUGITIVE INK TECHNOLOGY". Empty when the cert carries PSA's standard label. | |||
| data.psa_estimate | string | No | PSAEstimate is PSA's own dollar price estimate for this exact cert+grade, PSA's own formatted string (e.g. "$135,624.00"). Empty when PSA shows no estimate for this cert. | |||
| data.psa_pop_higher | integer | No | PSAPopHigher is the number of items PSA has graded higher than this cert's own grade for the same card. Nil when PSA shows no figure. | |||
| data.psa_population | integer | No | PSAPopulation is the number of items PSA has graded at this exact card+grade combination. Nil when PSA shows no population figure for this cert (e.g. an ungraded/authentic-only cert). | |||
| data.psa_population_url | string | No | PSAPopulationURL is PSA's own Population Report deep link for this card+grade. Informational only -- following it requires a Collectors account login; see the CertLookupResult doc comment above. | |||
| data.reverse_cert_barcode | boolean | No | ReverseCertBarcode reports whether the physical label also carries a barcode on its reverse side. | |||
| data.set_registry_note | string | No | SetRegistryNote is PSA's own Set Registry membership line for this cert, e.g. "This cert does not appear in any sets." when the item is not registered in any PSA Set Registry set. | |||
| data.source_url | string | No | SourceURL is the PSA cert-verification page this result was parsed from. | |||
| data.subject | string | No | Subject is the card's subject/player name, e.g. "CHARIZARD-HOLO". | |||
| data.title | string | No | Title is PSA's own item title line, e.g. "2003 POKEMON SKYRIDGE #146 CHARIZARD-HOLO". | |||
| data.year | string | No | Year is the card/item's issue year, e.g. "2003". | |||
| msg | string | No | OK |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 404 | Not Found | #/definitions/app.Response |
| 500 | Internal Server Error | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/psa/cert-lookup?cert_number=125866845" \
-H "x-api-key: $CRAWLORA_API_KEY"