Card Migrations

For the vast majority of Scryfall’s database, Magic card entries are additive. We add new and upcoming cards as we learn about them and obtain images.

In rare instances, Scryfall may discover that a card in our database does not really exist, or it has been deleted from a digital game permanently. In these situations, we provide endpoints to help you reconcile downstream data you may have synced or imported from Scryfall.

Migration Plans

Each migration has a provided migration_strategy:

Strategy Description

merge

You should update your records to replace the given old Scryfall ID with the new ID. The old ID is being discarded, and an existing record should be used to replace all instances of it.

delete

The given UUID is being discarded, and no replacement data is being provided. This likely means the old records are fully invalid. This migration exists to provide evidence that cards were removed from Scryfall’s database.

Card Migrations have the following properties:

Property Type Atn Details
uri URI A link to the current object on Scryfall’s API.
id UUID This migration’s unique UUID.
created_at Date The date this migration was performed.
migration_strategy String A computer-readable indicator of the migration strategy. See above.
old_scryfall_id UUID The id of the affected API Card object.
new_scryfall_id UUID Nullable The replacement id of the API Card object if this is a merge.
note String Nullable A note left by the Scryfall team about this migration.

Example Request

Retrieve the most recent migrations

GET https://api.scryfall.com/migrations?page=1