API Endpoints

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

Attributes

GET /attributes

Get all card attributes

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/attributes" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /attributes

Create a new attribute

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

Example Request

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

GET /attributes/{id}

Get a specific attribute

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/attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /attributes/{id}

Update an attribute

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/attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /attributes/{id}

Delete an attribute

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/attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Brands

GET /brands

Get all brands

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/brands" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /brands

Create a new brand

Create a new trading card brand

Example Request

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

GET /brands/{id}

Get a specific brand

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/brands/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /brands/{id}

Update a brand

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/brands/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /brands/{id}

Delete a brand

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/brands/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Cards

GET /cards

Get all cards

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/cards" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /cards

Create a new card

Create a new trading card record

Example Request

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

GET /cards/{id}

Get a specific card

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/cards/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /cards/{id}

Update a card

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/cards/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /cards/{id}

Delete a card

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/cards/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Genres

GET /genres

Get all genres

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/genres" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /genres

Create a new genre

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

Example Request

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

GET /genres/{id}

Get a specific genre

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/genres/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /genres/{id}

Update a genre

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/genres/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /genres/{id}

Delete a genre

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/genres/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /genres/deleted

Get deleted genres

Retrieve a list of all soft-deleted genres

Example Request

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

Manufacturers

GET /manufacturers

Get all manufacturers

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/manufacturers" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /manufacturers

Create a new manufacturer

Create a new trading card manufacturer

Example Request

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

GET /manufacturers/{id}

Get a specific manufacturer

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/manufacturers/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /manufacturers/{id}

Update a manufacturer

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/manufacturers/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /manufacturers/{id}

Delete a manufacturer

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/manufacturers/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

ObjectAttributes

GET /object-attributes

Get all object attributes

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/object-attributes" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /object-attributes

Create a new object attribute

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

Example Request

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

GET /object-attributes/{id}

Get a specific object attribute

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/object-attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /object-attributes/{id}

Update an object attribute

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/object-attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /object-attributes/{id}

Delete an object attribute

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/object-attributes/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Players

GET /players

Get all players

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/players" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /players

Create a new player

Create a new player record

Example Request

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

GET /players/{id}

Get a specific player

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/players/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /players/{id}

Update a player

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/players/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /players/{id}

Delete a player

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/players/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PlayerTeams

GET /playerteams

Get all player-team associations

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/playerteams" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /playerteams

Create a new player-team association

Create a new player-team association record

Example Request

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

Sets

GET /sets

Get all card sets

Retrieve a paginated list of all trading card sets

Parameters

Name	Type	Required	Description
include	string	No	Comma-separated list of relationships to include
limit	integer	No	Number of sets per page
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/sets" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /sets

Create a new set

Create a new trading card set

Example Request

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

GET /sets/{id}

Get a specific set

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/sets/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /sets/{id}

Update a set

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/sets/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /sets/{id}

Delete a set

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/sets/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

GET /sets/{id}/checklist

Get set checklist

Retrieve the complete checklist for a trading card set including all cards

Parameters

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

Example Request

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

POST /sets/{id}/checklist

Add checklist to set

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/sets/\{id\}/checklist" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Statistics

GET /stats/{modelType}

Get statistics for a model type

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/stats/\{modelType\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Teams

GET /teams

Get all teams

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/teams" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /teams

Create a new team

Create a new team record

Example Request

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

GET /teams/{id}

Get a specific team

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/teams/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /teams/{id}

Update a team

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/teams/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /teams/{id}

Delete a team

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/teams/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

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"

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
limit	integer	No	Number of sets per page
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

Parameters

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

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"

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"

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"

Years

GET /years

Get all years

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/years" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

POST /years

Create a new year

Create a new year record for trading card classification

Example Request

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

GET /years/{id}

Get a specific year

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/years/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

PUT /years/{id}

Update a year

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/years/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

DELETE /years/{id}

Delete a year

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/years/\{id\}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/vnd.api+json"

Attributes​

GET /attributes​

Parameters​

Example Request​

POST /attributes​

Example Request​

GET /attributes/{id}​

Parameters​

Example Request​

PUT /attributes/{id}​

Parameters​

Example Request​

DELETE /attributes/{id}​

Parameters​

Example Request​

Brands​

GET /brands​

Parameters​

Example Request​

POST /brands​

Example Request​

GET /brands/{id}​

Parameters​

Example Request​

PUT /brands/{id}​

Parameters​

Example Request​

DELETE /brands/{id}​

Parameters​

Example Request​

Cards​

GET /cards​

Parameters​

Example Request​

POST /cards​

Example Request​

GET /cards/{id}​

Parameters​

Example Request​

PUT /cards/{id}​

Parameters​

Example Request​

DELETE /cards/{id}​

Parameters​

Example Request​

Genres​

GET /genres​

Parameters​

Example Request​

POST /genres​

Example Request​

GET /genres/{id}​

Parameters​

Example Request​

PUT /genres/{id}​

Parameters​

Example Request​

DELETE /genres/{id}​

Parameters​

Example Request​

GET /genres/deleted​

Example Request​

Manufacturers​

GET /manufacturers​

Parameters​

Example Request​

POST /manufacturers​

Example Request​

GET /manufacturers/{id}​

Parameters​

Example Request​

PUT /manufacturers/{id}​

Parameters​

Example Request​

DELETE /manufacturers/{id}​

Parameters​

Example Request​

ObjectAttributes​

GET /object-attributes​

Parameters​

Attributes

GET /attributes

Parameters

Example Request

POST /attributes

Example Request

GET /attributes/{id}

Parameters

Example Request

PUT /attributes/{id}

Parameters

Example Request

DELETE /attributes/{id}

Parameters

Example Request

Brands

GET /brands

Parameters

Example Request

POST /brands

Example Request

GET /brands/{id}

Parameters

Example Request

PUT /brands/{id}

Parameters

Example Request

DELETE /brands/{id}

Parameters

Example Request

Cards

GET /cards

Parameters

Example Request

POST /cards

Example Request

GET /cards/{id}

Parameters

Example Request

PUT /cards/{id}

Parameters

Example Request

DELETE /cards/{id}

Parameters

Example Request

Genres

GET /genres

Parameters

Example Request

POST /genres

Example Request

GET /genres/{id}

Parameters

Example Request

PUT /genres/{id}

Parameters

Example Request

DELETE /genres/{id}

Parameters

Example Request

GET /genres/deleted

Example Request

Manufacturers

GET /manufacturers

Parameters

Example Request

POST /manufacturers

Example Request

GET /manufacturers/{id}

Parameters

Example Request

PUT /manufacturers/{id}

Parameters

Example Request

DELETE /manufacturers/{id}

Parameters

Example Request

ObjectAttributes

GET /object-attributes

Parameters