Your Collection, Your API

We've been building Byndr to be the best place to manage your TCG collection. But we know your collection data shouldn't live in a silo — which is why we're launching the Byndr Collection API.

What Is It?#

The Collection API gives you programmatic access to your card data. Every card you've added to your collection, across all projects and TCGs, is now available via a simple REST endpoint.

This means you can:

• Build a portfolio site that displays your collection in real-time
• Power a Discord bot that shares your latest pulls with your community
• Connect to Google Sheets for custom tracking and analysis
• Create custom dashboards with exactly the visualizations you want
• Automate exports without manual CSV downloads

How It Works#

The API uses key-based authentication. You create an API key in your settings, and then use it to make requests:

bash
curl -H "X-API-Key: cv_your_key" \
  https://byndr.cards/api/v1/collection

That's it. You get back a JSON response with your cards, including name, set, rarity, market price, images, and metadata.

Filtering & Pagination#

The API supports query parameters to narrow results:

You can combine these freely. Want all Secret Rares from Scarlet & Violet 151, sorted by price? Done:

/api/v1/collection?set=sv3pt5&rarity=Secret%20Rare&sort=market_price&order=desc

Rate Limits & Security#

Each API key allows 100 requests per hour — more than enough for most integrations. Rate limit info is returned in response headers so you can track your usage.

Security was a priority:

• API keys are hashed before storage — even we can't see your full key
• Keys can be scoped to specific projects for least-privilege access
• Keys can be revoked instantly from your settings
• You can create up to 5 keys for different integrations
• All requests are logged for your visibility

Getting Started#

1. Go to Settings → API Keys in your dashboard
2. Click New Key and give it a name
3. Copy the key (shown only once)
4. Start making requests

Full documentation with code examples in JavaScript, Python, and curl is available at /docs/api.

What's Next#

This is version 1 of the API. We're considering:

• Webhooks — get notified when cards are added or goals are completed
• Write access — add cards to your collection via API
• Collection stats endpoint — aggregated data (total value, completion rates)
• Wishlist endpoint — access your want-list programmatically

Let us know what you'd build with these features — your feedback drives our roadmap.

The Collection API is available to all Byndr users for free. No paid tier required.