API Endpoints

This page provides a complete reference of all available API endpoints.

Attributes v1

GET /v1/attributes

Get all card attributes (v1)

Retrieve a paginated list of all card attributes (autographs, variations, etc.)

Parameters

Name	Type	Required	Description
name	string	No	Filter by attribute name
limit	integer	No	Number of attributes per page
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/attributes" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/attributes

Create a new attribute (v1)

Create a new card attribute (autograph, variation, etc.)

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/attributes" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/attributes/{id}

Get a specific attribute (v1)

Retrieve detailed information about a specific card attribute by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the attribute to retrieve
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/attributes/{id}

Update an attribute (v1)

Update an existing card attribute

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the attribute to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/attributes/{id}

Delete an attribute (v1)

Delete an existing card attribute

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the attribute to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Brands v1

GET /v1/brands

Get all brands (v1)

Retrieve a list of all trading card brands

Parameters

Name	Type	Required	Description
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/brands" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/brands

Create a new brand (v1)

Create a new trading card brand

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/brands" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/brands/{id}

Get a specific brand (v1)

Retrieve detailed information about a specific brand by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the brand to retrieve
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/brands/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/brands/{id}

Update a brand (v1)

Update an existing brand

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the brand to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/brands/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/brands/{id}

Delete a brand (v1)

Delete an existing brand

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the brand to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/brands/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Cards v1

GET /v1/cards

Get all cards (v1)

Retrieve a paginated list of all trading cards in the system

Parameters

Name	Type	Required	Description
include	string	No	Comma-separated list of relationships to include (set,oncard,attributes,children)
page	integer	No	Page number for pagination
per_page	integer	No	Number of items per page

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/cards" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/cards

Create a new card (v1)

Create a new trading card record

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/cards" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/cards/{id}

Get a specific card (v1)

Retrieve detailed information about a specific trading card by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the card to retrieve
include	string	No	Comma-separated list of relationships to include (set,oncard,attributes,children)

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/cards/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/cards/{id}

Update a card (v1)

Update an existing trading card record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the card to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/cards/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/cards/{id}

Delete a card (v1)

Delete an existing trading card record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the card to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/cards/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Card Images

GET /v1/card-images

List all card images

Parameters

Name	Type	Required	Description
include	string	No	Include related resources (card)

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/card-images" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/card-images

Upload a new card image

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/card-images" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/card-images/{id}

Get a specific card image

Parameters

Name	Type	Required	Description
id	string	Yes	Card image UUID
include	string	No	Include related resources (card)

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/card-images/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/card-images/{id}

Delete a card image

Parameters

Name	Type	Required	Description
id	string	Yes	Card image UUID

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/card-images/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PATCH /v1/card-images/{id}

Update a card image

Parameters

Name	Type	Required	Description
id	string	Yes	Card image UUID

Example Request

curl -X PATCH "https://api.tradingcardapi.com/v1/card-images/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/card-images/{id}/download

Download the actual image file

Download/stream the actual image file

Parameters

Name	Type	Required	Description
id	string	Yes	Card image UUID
size	string	No	Image size variant. Sizes configured in config/images.php (default: small/medium/large)

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/card-images/\{id\}/download" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Genres v1

GET /v1/genres

Get all genres (v1)

Retrieve a paginated list of all trading card genres

Parameters

Name	Type	Required	Description
limit	integer	No	Number of genres per page
name	string	No	Filter by genre name
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/genres" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/genres

Create a new genre (v1)

Create a new trading card genre, restoring if previously soft-deleted

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/genres" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/genres/{id}

Get a specific genre (v1)

Retrieve detailed information about a specific genre by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the genre to retrieve
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/genres/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/genres/{id}

Update a genre (v1)

Update an existing genre record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the genre to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/genres/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/genres/{id}

Delete a genre (v1)

Soft delete an existing genre record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the genre to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/genres/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/genres/deleted

Get deleted genres (v1)

Retrieve a list of all soft-deleted genres

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/genres/deleted" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Manufacturers v1

GET /v1/manufacturers

Get all manufacturers (v1)

Retrieve a list of all trading card manufacturers

Parameters

Name	Type	Required	Description
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/manufacturers" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/manufacturers

Create a new manufacturer (v1)

Create a new trading card manufacturer

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/manufacturers" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/manufacturers/{id}

Get a specific manufacturer (v1)

Retrieve detailed information about a specific manufacturer by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the manufacturer to retrieve
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/manufacturers/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/manufacturers/{id}

Update a manufacturer (v1)

Update an existing manufacturer

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the manufacturer to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/manufacturers/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/manufacturers/{id}

Delete a manufacturer (v1)

Delete an existing manufacturer

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the manufacturer to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/manufacturers/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

ObjectAttributes v1

GET /v1/object-attributes

Get all object attributes (v1)

Retrieve a paginated list of all object attributes (card-specific attribute instances)

Parameters

Name	Type	Required	Description
limit	integer	No	Number of object attributes per page
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/object-attributes" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/object-attributes

Create a new object attribute (v1)

Create a new object attribute instance linking an attribute to a specific object (card)

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/object-attributes" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/object-attributes/{id}

Get a specific object attribute (v1)

Retrieve detailed information about a specific object attribute by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the object attribute to retrieve
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/object-attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/object-attributes/{id}

Update an object attribute (v1)

Update an existing object attribute instance

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the object attribute to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/object-attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/object-attributes/{id}

Delete an object attribute (v1)

Delete an existing object attribute instance

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the object attribute to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/object-attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Players v1

GET /v1/players

Get all players (v1)

Retrieve a paginated list of all players with optional filtering

Parameters

Name	Type	Required	Description
first_name	string	No	Filter by player first name
last_name	string	No	Filter by player last name
full_name	string	No	Filter by full name (searches both first and last name)
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/players" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/players

Create a new player (v1)

Create a new player record

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/players" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/players/{id}

Get a specific player (v1)

Retrieve detailed information about a specific player by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the player to retrieve
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/players/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/players/{id}

Update a player (v1)

Update an existing player record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the player to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/players/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/players/{id}

Delete a player (v1)

Delete an existing player record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the player to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/players/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PlayerTeams v1

GET /v1/playerteams

Get all player-team associations (v1)

Retrieve a paginated list of player-team associations with optional filtering

Parameters

Name	Type	Required	Description
team_id	string	No	Filter by team ID
player_id	string	No	Filter by player ID
limit	integer	No	Number of player-teams per page
include	string	No	Comma-separated list of relationships to include (player,team)

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/playerteams" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/playerteams

Create a new player-team association (v1)

Create a new player-team association record

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/playerteams" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Sets v1

GET /v1/sets

Get all card sets (v1)

Retrieve a paginated list of all trading card sets

Parameters

Name	Type	Required	Description
include	string	No	Comma-separated list of relationships to include
per_page	integer	No	Number of sets per page (max 100, default 25)
limit	integer	No	Number of sets per page (deprecated, use per_page instead)
order_by	string	No	Field to order by
sort	string	No	Sort direction
name	string	No	Filter by set name
genre	string	No	Filter by genre ID

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/sets" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/sets

Create a new set (v1)

Create a new trading card set

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/sets" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/sets/{id}

Get a specific set (v1)

Retrieve detailed information about a specific trading card set by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the set to retrieve
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/sets/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/sets/{id}

Update a set (v1)

Update an existing trading card set

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the set to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/sets/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/sets/{id}

Delete a set (v1)

Delete an existing trading card set

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the set to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/sets/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/sets/{id}/checklist

Get set checklist (v1)

Retrieve the complete checklist for a trading card set including all cards. Supports compact format for large sets to avoid response size limits. Compact format returns only id, number, and name fields, reducing response size by ~75%.

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the set to get checklist for
format	string	No	Response format: 'full' returns all card fields, 'compact' returns only id, number, and name
page	integer	No	Page number for pagination (starts at 1)
per_page	integer	No	Number of cards per page (max 100, returns all if not specified)

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/sets/\{id\}/checklist" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/sets/{id}/checklist

Add checklist to set (v1)

Add or import a checklist to a trading card set. Can either generate empty cards or parse a detailed checklist.

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the set to add checklist to

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/sets/\{id\}/checklist" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Set Sources v1

GET /v1/set-sources

Get all set sources (v1)

Retrieve a list of all set sources

Parameters

Name	Type	Required	Description
include	string	No	Comma-separated list of relationships to include (set)

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/set-sources" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/set-sources

Create a new set source (v1)

Create a new set source tracking record

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/set-sources" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/set-sources/{id}

Get a specific set source (v1)

Retrieve detailed information about a specific set source by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the set source to retrieve
include	string	No	Comma-separated list of relationships to include (set)

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/set-sources/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/set-sources/{id}

Update a set source (v1)

Update an existing set source

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the set source to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/set-sources/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/set-sources/{id}

Delete a set source (v1)

Delete an existing set source

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the set source to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/set-sources/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Statistics v1

GET /v1/stats/{modelType}

Get statistics for a model type (v1)

Retrieve daily statistics showing creation and deletion counts for a specific model type

Parameters

Name	Type	Required	Description
modelType	string	Yes	Type of model to get statistics for (e.g., cards, sets, players)

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/stats/\{modelType\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Teams v1

GET /v1/teams

Get all teams (v1)

Retrieve a paginated list of all teams with optional filtering

Parameters

Name	Type	Required	Description
location	string	No	Filter by team location
mascot	string	No	Filter by team mascot
name	string	No	Filter by full team name (searches both location and mascot)
genre_id	string	No	Filter by genre ID
limit	integer	No	Number of teams per page
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/teams" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/teams

Create a new team (v1)

Create a new team record

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/teams" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/teams/{id}

Get a specific team (v1)

Retrieve detailed information about a specific team by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the team to retrieve
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/teams/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/teams/{id}

Update a team (v1)

Update an existing team record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the team to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/teams/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/teams/{id}

Delete a team (v1)

Delete an existing team record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the team to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/teams/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Years v1

GET /v1/years

Get all years (v1)

Retrieve a list of all years available for trading card sets

Parameters

Name	Type	Required	Description
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/years" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /v1/years

Create a new year (v1)

Create a new year record for trading card classification

Example Request

curl -X POST "https://api.tradingcardapi.com/v1/years" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /v1/years/{id}

Get a specific year (v1)

Retrieve detailed information about a specific year by ID

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the year to retrieve
include	string	No	Comma-separated list of relationships to include

Example Request

curl -X GET "https://api.tradingcardapi.com/v1/years/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /v1/years/{id}

Update a year (v1)

Update an existing year record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the year to update

Example Request

curl -X PUT "https://api.tradingcardapi.com/v1/years/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /v1/years/{id}

Delete a year (v1)

Delete an existing year record

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the year to delete

Example Request

curl -X DELETE "https://api.tradingcardapi.com/v1/years/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Sets v2

Why v2?

The v2 checklist endpoint fixes a JSON:API semantic issue in v1:

v1 returns the set as primary data (data: {type: "sets"}) with cards in included - incorrect for a "checklist"
v2 returns cards as primary data (data: [{type: "cards"}, ...]) with set in included - correct semantics

When to use v2:

New integrations that want standards compliance
Applications prioritizing cards over set metadata
When you need the improved response structure

When to use v1:

Existing integrations (backward compatibility)
No breaking changes needed

Both versions are fully supported long-term.

GET /v2/sets/{id}/checklist

Get set checklist (v2)

Retrieve the complete checklist for a trading card set. V2 returns cards as the primary data with set information in the included array. Supports compact format for large sets to avoid response size limits. Compact format returns only id, number, and name fields, reducing response size by ~75%.

Parameters

Name	Type	Required	Description
id	string	Yes	UUID of the set to get checklist for
include	string	No	Comma-separated list of relationships to include (set,oncard,attributes)
format	string	No	Response format: 'full' returns all card fields, 'compact' returns only id, number, and name
page	integer	No	Page number for pagination (starts at 1)
per_page	integer	No	Number of cards per page (max 100, returns all if not specified)

Example Request

curl -X GET "https://api.tradingcardapi.com/v2/sets/\{id\}/checklist" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Response Structure Comparison:

Aspect	v1	v2
Primary data (`data`)	Set object	Cards array
Set location	Primary data	Included array
Cards location	Included array	Primary data
JSON:API semantics	Questionable	Correct

Version

GET /version

Get API version information

Retrieve version information about the API, application, and supported versions

Example Request

curl -X GET "https://api.tradingcardapi.com/version" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Attributes v1​

GET /v1/attributes​

Parameters​

Example Request​

POST /v1/attributes​

Example Request​

GET /v1/attributes/{id}​

Parameters​

Example Request​

PUT /v1/attributes/{id}​

Parameters​

Example Request​

DELETE /v1/attributes/{id}​

Parameters​

Example Request​

Brands v1​

GET /v1/brands​

Parameters​

Example Request​

POST /v1/brands​

Example Request​

GET /v1/brands/{id}​

Parameters​

Example Request​

PUT /v1/brands/{id}​

Parameters​

Example Request​

DELETE /v1/brands/{id}​

Parameters​

Example Request​

Cards v1​

GET /v1/cards​

Parameters​

Example Request​

POST /v1/cards​

Example Request​

GET /v1/cards/{id}​

Parameters​

Example Request​

PUT /v1/cards/{id}​

Parameters​

Example Request​

DELETE /v1/cards/{id}​

Parameters​

Example Request​

Card Images​

GET /v1/card-images​

Parameters​

Example Request​

POST /v1/card-images​

Example Request​

GET /v1/card-images/{id}​

Parameters​

Example Request​

DELETE /v1/card-images/{id}​

Parameters​

Example Request​

PATCH /v1/card-images/{id}​

Parameters​

Example Request​

GET /v1/card-images/{id}/download​

Parameters​

Example Request​

Genres v1​

GET /v1/genres​

Parameters​

Example Request​

POST /v1/genres​

Example Request​

GET /v1/genres/{id}​

Parameters​

Example Request​

PUT /v1/genres/{id}​

Parameters​

Example Request​

DELETE /v1/genres/{id}​

Parameters​

Example Request​

GET /v1/genres/deleted​

Example Request​

Attributes v1

GET /v1/attributes

Parameters

Example Request

POST /v1/attributes

Example Request

GET /v1/attributes/{id}

Parameters

Example Request

PUT /v1/attributes/{id}

Parameters

Example Request

DELETE /v1/attributes/{id}

Parameters

Example Request

Brands v1

GET /v1/brands

Parameters

Example Request

POST /v1/brands

Example Request

GET /v1/brands/{id}

Parameters

Example Request

PUT /v1/brands/{id}

Parameters

Example Request

DELETE /v1/brands/{id}

Parameters

Example Request

Cards v1

GET /v1/cards

Parameters

Example Request

POST /v1/cards

Example Request

GET /v1/cards/{id}

Parameters

Example Request

PUT /v1/cards/{id}

Parameters

Example Request

DELETE /v1/cards/{id}

Parameters

Example Request

Card Images

GET /v1/card-images

Parameters

Example Request

POST /v1/card-images

Example Request

GET /v1/card-images/{id}

Parameters

Example Request

DELETE /v1/card-images/{id}

Parameters

Example Request

PATCH /v1/card-images/{id}

Parameters

Example Request

GET /v1/card-images/{id}/download

Parameters

Example Request

Genres v1

GET /v1/genres

Parameters

Example Request

POST /v1/genres

Example Request

GET /v1/genres/{id}

Parameters

Example Request

PUT /v1/genres/{id}

Parameters

Example Request

DELETE /v1/genres/{id}

Parameters

Example Request

GET /v1/genres/deleted

Example Request