All articles

Technical update

Clearer IDs for cards and inventory

For developers: which ID to use for a card printing, an owned copy or a storage location, and what to change in an existing integration.

Checked

Holo Folder’s REST API and MCP tools now use clearer names for card printings, owned copies and storage locations. This update is for integration builders. If you only use the app, there is nothing you need to change.

Why these need separate IDs

Suppose you own two copies of the same Bulbasaur printing. Searching for that printing is different from updating one copy or finding the pocket where it is kept. Your tool needs to know which of those records an operation refers to.

The API names make that distinction explicit, so you can choose the correct record before making a request.

What each ID identifies

Record

ID and meaning

Printing

cardId

A catalog printing. Both copies of the same printing share this ID.

Owned copy

inventoryItemId

One physical copy you own. Each copy has its own ID.

Storage slot

slotId

A storage slot, such as a binder pocket. It identifies the location, not the card in it.

Collection

collectionId

The collection that contains the slot. Use it to scope the storage operation.


How that works in practice

Example

Result

Two copies of one printing

The printing ID is the same; each owned copy has a different copy ID.

Move a copy to another pocket

The copy keeps its ID. Its placement points to a different slot.


What to update in an existing integration

Check calls that read or change owned cards. The old public species-row read, save and delete operations have been removed without aliases. Use the current inventory and storage operations for physical copies and their locations. Activity filters for a particular copy now use the inventory item ID.

Keep Holo Folder IDs exactly as returned. Do not construct them from a Pokémon name, game name or another provider’s product number.

The contracts guide explains the record types. The operation reference lists the current request fields, permissions and renamed set-slot and legacy analytics operations. Legacy analytics is still unavailable for native or mixed owners.

Pokémon catalog details

Pokémon is the supported game. Species targets describe a Pokémon species, rather than a particular printing or copy. Trainer and Energy cards can use card and free-slot targets without a species link.

Read the contracts guide

Check the operation reference

Explore Holo Folder features

Open your collection

Product updates and changelog