One Piece

API Reference

Overview

The One Piece Card Game API provides access to a comprehensive database of cards, expansions, and pricing data. This overview explains how cards are grouped and how to use advanced query patterns to find exactly what you're looking for.

Card Grouping & Variants

In One Piece, a "card" represents a unique game entity (typically identified by its card number, like OP01-001). However, each card can have multiple variants, such as:

  • Normal
  • Alt Art
  • Special Alt Art
  • Manga Alt Art

When you query the /cards endpoint, the API returns a list of base cards. Each card object contains a variants array that includes all collectible versions of that card.

Cross-Expansion Printings

Some expansions, like Premium Booster Vol. 1 (PRB01), consist entirely of cards that were originally printed in previous sets (except for PRB01-001).

While a card's primary expansion_id reflects its original debut, the printings field (at both the card and variant level) tracks every expansion that specific card or variant has appeared in.

Query Patterns

The printings Filter

If you want to see all cards that were "printed in" a specific expansion, regardless of their original expansion ID, you should use the printings filter in your search query (q).

This is particularly useful for reprint sets like PRB01.

Example: Finding all cards in PRB01

GET /onepiece/v1/cards?q=printings:PRB01

This query will return cards like OP01-006 because they were reprinted in PRB01 as a new variant, even though their primary expansion is OP01.

Filtering by Rarity

You can filter cards by their rarity name or rarity code.

# By rarity name
GET /onepiece/v1/cards?q=rarity:"Super Rare"

# By rarity code
GET /onepiece/v1/cards?q=rarity_code:SR

Combining Filters

You can combine printings with other attributes to narrow down your search.

Example: Super Rares printed in PRB01

GET /onepiece/v1/cards?q=printings:PRB01 AND rarity_code:SR
Example Requests
curl -X GET 'https://api.scrydex.com/onepiece/v1/cards?q=printings:PRB01' \
  -H 'X-Api-Key: YOUR_API_KEY' \
  -H 'X-Team-ID: YOUR_TEAM_ID'