Developer API

Pick an API. Check out. Start building.

Three APIs, each sold on its own. Export finished stacks, search the Heystack catalog, or identify cards from photos.

  1. Choose a planSearch and Recognition require approval.
  2. Accept the terms and pay with StripeBilled to your company account.
  3. Get your keyOpen the Developer Console to get started.

API powered by Heystack

Black & Gold Sports Cards Greg Morris Cards Slab Sharks 4 Sharp Corners TGA Grading Sync My Cards

Find Your
API Use Case

Let collectors add cards the easy way.

Incorporate our Recognition API into your interface so collectors can directly upload card images. Supplement our Recognition with our Search API so collectors can more quickly upload cards from our vast and expanding catalog.

Create Account

Export API

Pull your finished stacks into your own platform through the API, instead of downloading and re-uploading CSV files.

How it works
  1. HeystackFinished stack
  2. Export APIStructured data
  3. Your platformYour listings
  • No CSV round trips. Pull stacks straight into your own systems.
  • Per company account, so your whole team works from the same access.
  • Commerce-ready images and titles, directly from your finished stacks.
$99.99 / 31 days

Billed through Stripe. Cancel any time.

This price is for the Export API only. Search and Recognition are priced separately.

Purchase
Export API reference Authentication, endpoints, errors

Authentication

Send your API key in the X-API-Key header on every request. Keys are tied to your company account.

curl "https://admin.heystack.tech/api/v1/stacks?status=complete" \
  -H "X-API-Key: $HEYSTACK_API_KEY"

Endpoints

GET /stacks List your stacks
ParameterTypeDescription
statusstringFilter by status, like complete.
updated_sinceISO 8601 dateOnly stacks changed after this time.
pageintegerPage number. 50 stacks per page.
{
  "stacks": [
    { "stack_id": "st_48213", "name": "Oct show buys", "status": "complete",
      "card_count": 250, "completed_at": "2026-10-18T21:04:11Z" }
  ],
  "next_page": 2
}
GET /stacks/:id Get one stack with its cards
ParameterTypeDescription
idstring, requiredThe stack_id from the list endpoint.
{
  "stack_id": "st_48213",
  "status": "complete",
  "cards": [
    { "player": "Ja'Marr Chase", "year": "2021", "set": "Donruss Optic",
      "number": "108", "confirmed_by_user": true,
      "images": { "front": "https://…", "back": "https://…" } }
  ]
}

Errors

CodeMeaning
401Missing or invalid API key.
403This API isn't on your account. Subscribe to turn it on.
404No stack with that ID on your account.
429Too many calls per minute. Check the Retry-After header.

Recognition API

Send front and back card images and get back recommended matches, ranked, for your users to review and confirm. Tell us about your platform and how you'd use it, and our dev team will follow up.

By approval

POST /identify front.jpg + back.jpg

Patrick Mahomes Green Scope trading card

Match found · conf 0.97

2017 Panini Prizm Patrick Mahomes #269
Green Scope
Player
Patrick Mahomes
Sport
Football
League
NFL
Team
Kansas City Chiefs
Year
2017
Set
Panini Prizm
Insert
None
Card #
269
Variant
Green Scope
Serial
None
Rookie
Yes
Autograph
No
Memorabilia
No
Grade read
Raw
Market Movers
$184
By Approval

Reviewed before we switch it on.

  • Front and back photo to a ranked match. Send two images, get recommended matches back.
  • Credit based. Subscribe after your account is approved.
  • A real person approves your use case first. Tell us what you are building.
Purchase