Getting started with the Holo Folder API

The Holo Folder REST API gives you programmatic access to card search and to your own collection: binders, owned cards and wanted lists. This guide covers the shape of a first integration. The full reference, including every endpoint and scope, is at /app/docs.

Get access

API access is included with Premium and lifetime plans. Create a personal API key in developer settings. Keys are read-only by default, so a new key can search and read but cannot change anything.

Search the catalog

Start with card search. cardId identifies a catalog printing, while inventoryItemId identifies a physical copy. Card, set and series results include game: pokemon. Keep Holo Folder IDs as returned; provider IDs are source evidence.

Read your collection

Read your inventory, wants and storage with the current operations in the contracts guide. slotId identifies a storage slot and collectionId identifies its collection. Pokémon species targets are separate from printing and physical-copy identities.

Handle missing data

Prices come with their sources and confidence. When a value is not available, the API says so rather than filling a gap with a guess. Build your interface to show unknown as unknown.

Turn on writes when you need them

Imports and edits need write permission. Enable it only for keys that need it, and revoke any key in developer settings.

Read the developer docs