Pokémon TCG API

https://docs.pokemontcg.io
Admin
The Pokémon TCG API is a REST API for accessing Pokémon Trading Card Game data including cards,...
Tokens:8,000
Snippets:64
Trust Score:8.7
Update:2 months ago
Show doc for...
Tokens:
Raw
### Ordering data examples

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Examples of using the orderBy parameter to sort results.

```text
?orderBy=number
```

```text
?orderBy=name,-number
```

--------------------------------

### Keyword matching examples

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Examples of using the q parameter for field-specific keyword searches.

```text
name:charizard
```

```text
name:"venusaur v"
```

```text
name:charizard subtypes:mega
```

```text
name:charizard (subtypes:mega OR subtypes:vmax)
```

```text
subtypes:mega -types:water
```

--------------------------------

### Wildcard matching examples

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Examples of using wildcards for partial string matching.

```text
name:char*
```

```text
name:char*der
```

--------------------------------

### Exact matching example

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Example of using the ! operator for exact field matching.

```text
!name:charizard
```

--------------------------------

### Sample Response

Source: https://docs.pokemontcg.io/api-reference/rarities/get-rarities

Example JSON response containing the array of rarity strings.

```json
{
"data": [
"Amazing Rare",
"Common",
"LEGEND",
"Promo",
"Rare",
"Rare ACE",
"Rare BREAK",
"Rare Holo",
"Rare Holo EX",
"Rare Holo GX",
"Rare Holo LV.X",
"Rare Holo Star",
"Rare Holo V",
"Rare Holo VMAX",
"Rare Prime",
"Rare Prism Star",
"Rare Rainbow",
"Rare Secret",
"Rare Shining",
"Rare Shiny",
"Rare Shiny GX",
"Rare Ultra",
"Uncommon"
]
}
```

--------------------------------

### Range search examples

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Examples of inclusive and exclusive range searches for numerical fields.

```text
nationalPokedexNumbers:[1 TO 151]
```

```text
hp:[* TO 100]
```

```text
hp:[150 TO *]
```

--------------------------------

### Search Sets in Ruby

Source: https://docs.pokemontcg.io/api-reference/sets/search-sets

Examples for retrieving all sets, filtering by legality, and paginating results using the Ruby SDK.

```ruby
# Get all sets
sets = Pokemon::Set.all
# Filter sets
sets = Pokemon::Set.where(q: 'legailities.standard:legal')
# Get a specific page of data
sets = Pokemon::Set.where(page: 2, pageSize: 10)
```

--------------------------------

### Retrieve all subtypes

Source: https://docs.pokemontcg.io/api-reference/subtypes/get-subtypes

Examples for fetching the list of subtypes across different programming languages and cURL.

```python
subtypes = Subtype.all()
```

```ruby
types = Pokemon::Subtype.all
```

```javascript
pokemon.subtype.all()
```

```bash
curl "https://api.pokemontcg.io/v2/subtypes"
```

--------------------------------

### Nested field search examples

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Examples of filtering by nested object properties using dot notation.

```text
set.id:sm1
```

```text
attacks.name:Spelunk
```

```text
legalities.standard:banned
```

--------------------------------

### Search Sets in Python

Source: https://docs.pokemontcg.io/api-reference/sets/search-sets

Examples for retrieving all sets, filtering by legality, and paginating results using the Python SDK.

```python
# Get all sets
sets = Set.all()
# Filter sets
sets = Set.where(q='legailities.standard:legal')
# Get a specific page of data
sets = Set.where(page=2, pageSize=10)
```

--------------------------------

### Search Sets in JavaScript

Source: https://docs.pokemontcg.io/api-reference/sets/search-sets

Examples for retrieving all sets, filtering by legality, and paginating results using the JavaScript SDK.

```javascript
// Get all sets
pokemon.set.all()
.then((sets) => {
console.log(sets[0].name) // "Base"
})
// Filter sets
pokemon.set.where({ q: 'legalities.standard:legal' })
.then(result => {
console.log(result.data[0].name)
})
// Get specific page of data
pokemon.set.where({ pageSize: 10, page: 2 })
.then(result => {
console.log(result.data[0].name)
})
```

--------------------------------

### Set Object JSON Structure

Source: https://docs.pokemontcg.io/api-reference/sets/set-object

Example of a complete Set object returned by the API.

```json
{
"id": "swsh1",
"name": "Sword & Shield",
"series": "Sword & Shield",
"printedTotal": 202,
"total": 216,
"legalities": {
"unlimited": "Legal",
"standard": "Legal",
"expanded": "Legal"
},
"ptcgoCode": "SSH",
"releaseDate": "2020/02/07",
"updatedAt": "2020/08/14 09:35:00",
"images": {
"symbol": "https://images.pokemontcg.io/swsh1/symbol.png",
"logo": "https://images.pokemontcg.io/swsh1/logo.png"
}
}
```

--------------------------------

### Retrieve all Pokémon types

Source: https://docs.pokemontcg.io/api-reference/types/get-types

Examples for fetching the list of types across different programming languages and cURL.

```python
types = Type.all()
```

```ruby
types = Pokemon::Type.all
```

```javascript
pokemon.type.all()
```

```bash
curl "https://api.pokemontcg.io/v2/types"
```

--------------------------------

### Retrieve a set by ID

Source: https://docs.pokemontcg.io/api-reference/sets/get-set

Examples for fetching set details using various programming languages and cURL.

```python
card = Set.find('swsh1')
```

```ruby
card = Pokemon::Set.find('swsh1')
```

```javascript
pokemon.set.find('swsh1')
.then(set => {
console.log(set.name) // "Sword & Shield"
})
```

```curl
curl --request GET \
--url https://api.pokemontcg.io/v2/sets/swsh1 \
--header 'X-Api-Key: <api_key_here>'
```

--------------------------------

### GET https://api.pokemontcg.io/v2/supertypes

Source: https://docs.pokemontcg.io/api-reference/supertypes/get-supertypes

Retrieves a list of all possible supertypes.

```APIDOC
## GET https://api.pokemontcg.io/v2/supertypes

### Description
Retrieves a list of all possible supertypes available in the Pokémon TCG API.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/supertypes

### Response
#### Success Response (200)
- **data** (array) - A list of strings representing the available supertypes.

#### Response Example
{
  "data": [
    "Energy",
    "Pokémon",
    "Trainer"
  ]
}
```

--------------------------------

### Fetch card details by ID

Source: https://docs.pokemontcg.io/api-reference/cards/get-card

Examples for retrieving a specific card using different client libraries and raw HTTP requests.

```python
card = Card.find('xy1-1')
```

```ruby
card = Pokemon::Card.find('xy1-1')
```

```javascript
pokemon.card.find('base1-4')
.then(card => {
console.log(card.name) // "Charizard"
})
```

```curl
curl --request GET \
--url https://api.pokemontcg.io/v2/cards/xy1-1 \
--header 'X-Api-Key: <api_key_here>'
```

--------------------------------

### GET https://api.pokemontcg.io/v2/rarities

Source: https://docs.pokemontcg.io/api-reference/rarities/get-rarities

Retrieves a list of all possible rarities.

```APIDOC
## GET https://api.pokemontcg.io/v2/rarities

### Description
Retrieves a list of all possible rarities available in the Pokémon TCG database.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/rarities

### Response
#### Success Response (200)
- **data** (array) - A list of strings representing all available rarity types.

#### Response Example
{
  "data": [
    "Amazing Rare",
    "Common",
    "LEGEND",
    "Promo",
    "Rare",
    "Rare ACE",
    "Rare BREAK",
    "Rare Holo",
    "Rare Holo EX",
    "Rare Holo GX",
    "Rare Holo LV.X",
    "Rare Holo Star",
    "Rare Holo V",
    "Rare Holo VMAX",
    "Rare Prime",
    "Rare Prism Star",
    "Rare Rainbow",
    "Rare Secret",
    "Rare Shining",
    "Rare Shiny",
    "Rare Shiny GX",
    "Rare Ultra",
    "Uncommon"
  ]
}
```

--------------------------------

### Retrieve supertypes across multiple languages

Source: https://docs.pokemontcg.io/api-reference/supertypes/get-supertypes

Use these examples to fetch the list of supertypes using various programming languages and cURL.

```python
supertypes = Supertype.all()
```

```ruby
supertypes = Pokemon::Supertype.all
```

```javascript
pokemon.supertype.all()
```

```curl
curl "https://api.pokemontcg.io/v2/supertypes"
```

--------------------------------

### GET https://api.pokemontcg.io/v2/types

Source: https://docs.pokemontcg.io/api-reference/types/get-types

Retrieves a list of all possible Pokémon types.

```APIDOC
## GET https://api.pokemontcg.io/v2/types

### Description
Get all possible Pokémon types.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/types

### Response
#### Success Response (200)
- **data** (array) - A list of strings representing the available Pokémon types.

#### Response Example
{
  "data": [
    "Colorless",
    "Darkness",
    "Dragon",
    "Fairy",
    "Fighting",
    "Fire",
    "Grass",
    "Lightning",
    "Metal",
    "Psychic",
    "Water"
  ]
}
```

--------------------------------

### GET https://api.pokemontcg.io/v2/sets

Source: https://docs.pokemontcg.io/api-reference/sets/search-sets

Retrieve a list of sets based on optional search criteria.

```APIDOC
## GET https://api.pokemontcg.io/v2/sets

### Description
Search for one or many sets given a search query.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/sets

### Parameters
#### Query Parameters
- **q** (string) - Optional - The search query.
- **page** (integer) - Optional - The page of data to access. Default: 1
- **pageSize** (integer) - Optional - The maximum amount of cards to return. Default: 250 (max of 250)
- **orderBy** (string) - Optional - The field(s) to order the results by.
- **select** (string) - Optional - A comma delimited list of fields to return in the response.

### Response
#### Success Response (200)
- **data** (array) - A list of set objects.
- **page** (integer) - The current page number.
- **pageSize** (integer) - The number of items per page.
- **count** (integer) - The number of items returned in this response.
- **totalCount** (integer) - The total number of items available.

#### Response Example
{
  "data": [
    {
      "id": "base1",
      "name": "Base",
      "series": "Base",
      "printedTotal": 102,
      "total": 102,
      "legalities": {
        "unlimited": "Legal"
      },
      "ptcgoCode": "BS",
      "releaseDate": "1999/01/09",
      "updatedAt": "2020/08/14 09:35:00",
      "images": {
        "symbol": "https://images.pokemontcg.io/base1/symbol.png",
        "logo": "https://images.pokemontcg.io/base1/logo.png"
      }
    }
  ],
  "page": 1,
  "pageSize": 250,
  "count": 123,
  "totalCount": 123
}
```

--------------------------------

### GET https://api.pokemontcg.io/v2/sets/<id>

Source: https://docs.pokemontcg.io/api-reference/sets/get-set

Fetch the details of a single set by providing its ID.

```APIDOC
## GET https://api.pokemontcg.io/v2/sets/<id>

### Description
Fetch the details of a single set.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/sets/<id>

### Parameters
#### Path Parameters
- **id** (string) - Required - The Id of the set

#### Query Parameters
- **select** (string) - Optional - A comma delimited list of fields to return in the response (ex. ?select=id,name). By default, all fields are returned.

### Request Example
curl --request GET \
--url https://api.pokemontcg.io/v2/sets/swsh1 \
--header 'X-Api-Key: <api_key_here>'

### Response
#### Success Response (200)
- **data** (object) - The set details object.

#### Response Example
{
"data": {
"id": "swsh1",
"name": "Sword & Shield",
"series": "Sword & Shield",
"printedTotal": 202,
"total": 216,
"legalities": {
"unlimited": "Legal",
"standard": "Legal",
"expanded": "Legal"
},
"ptcgoCode": "SSH",
"releaseDate": "2020/02/07",
"updatedAt": "2020/08/14 09:35:00",
"images": {
"symbol": "https://images.pokemontcg.io/swsh1/symbol.png",
"logo": "https://images.pokemontcg.io/swsh1/logo.png"
}
}
}
```

--------------------------------

### GET https://api.pokemontcg.io/v2/subtypes

Source: https://docs.pokemontcg.io/api-reference/subtypes/get-subtypes

Retrieves a list of all possible subtypes available in the Pokémon TCG.

```APIDOC
## GET https://api.pokemontcg.io/v2/subtypes

### Description
Retrieves a list of all possible subtypes available in the Pokémon TCG.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/subtypes

### Response
#### Success Response (200)
- **data** (array) - A list of strings representing all available subtypes.

#### Response Example
{
  "data": [
    "BREAK",
    "Baby",
    "Basic",
    "EX",
    "GX",
    "Goldenrod Game Corner",
    "Item",
    "LEGEND",
    "Level-Up",
    "MEGA",
    "Pokémon Tool",
    "Pokémon Tool F",
    "Rapid Strike",
    "Restored",
    "Rocket's Secret Machine",
    "Single Strike",
    "Special",
    "Stadium",
    "Stage 1",
    "Stage 2",
    "Supporter",
    "TAG TEAM",
    "Technical Machine",
    "V",
    "VMAX"
  ]
}
```

--------------------------------

### Retrieve Card JSON Structure

Source: https://docs.pokemontcg.io/api-reference/cards/card-object

Example of the full JSON schema returned for a Pokémon card, including abilities, attacks, and market pricing.

```json
{
"id": "swsh4-25",
"name": "Charizard",
"supertype": "Pokémon",
"subtypes": [
"Stage 2"
],
"hp": "170",
"types": [
"Fire"
],
"evolvesFrom": "Charmeleon",
"abilities": [
{
"name": "Battle Sense",
"text": "Once during your turn, you may look at the top 3 cards of your deck and put 1 of them into your hand. Discard the other cards.",
"type": "Ability"
}
],
"attacks": [
{
"name": "Royal Blaze",
"cost": [
"Fire",
"Fire"
],
"convertedEnergyCost": 2,
"damage": "100+",
"text": "This attack does 50 more damage for each Leon card in your discard pile."
}
],
"weaknesses": [
{
"type": "Water",
"value": "×2"
}
],
"retreatCost": [
"Colorless",
"Colorless",
"Colorless"
],
"convertedRetreatCost": 3,
"set": {
"id": "swsh4",
"name": "Vivid Voltage",
"series": "Sword & Shield",
"printedTotal": 185,
"total": 203,
"legalities": {
"unlimited": "Legal",
"standard": "Legal",
"expanded": "Legal"
},
"ptcgoCode": "VIV",
"releaseDate": "2020/11/13",
"updatedAt": "2020/11/13 16:20:00",
"images": {
"symbol": "https://images.pokemontcg.io/swsh4/symbol.png",
"logo": "https://images.pokemontcg.io/swsh4/logo.png"
}
},
"number": "25",
"artist": "Ryuta Fuse",
"rarity": "Rare",
"flavorText": "It spits fire that is hot enough to melt boulders. It may cause forest fires by blowing flames.",
"nationalPokedexNumbers": [
6
],
"legalities": {
"unlimited": "Legal",
"standard": "Legal",
"expanded": "Legal"
},
"images": {
"small": "https://images.pokemontcg.io/swsh4/25.png",
"large": "https://images.pokemontcg.io/swsh4/25_hires.png"
},
"tcgplayer": {
"url": "https://prices.pokemontcg.io/tcgplayer/swsh4-25",
"updatedAt": "2021/08/04",
"prices": {
"normal": {
"low": 1.73,
"mid": 3.54,
"high": 12.99,
"market": 2.82,
"directLow": 3.93
},
"reverseHolofoil": {
"low": 3,
"mid": 8.99,
"high": 100,
"market": 3.89,
"directLow": 4.46
}
}
},
"cardmarket": {
"url": "https://prices.pokemontcg.io/cardmarket/swsh4-25",
"updatedAt": "2021/08/04",
"prices": {
"averageSellPrice": 9.38,
"lowPrice": 8.95,
"trendPrice": 10.29,
"germanProLow": null,
"suggestedPrice": null,
"reverseHoloSell": null,
"reverseHoloLow": null,
"reverseHoloTrend": null,
"lowPriceExPlus": 8.95,
"avg1": 9.95,
"avg7": 9.35,
"avg30": 11.31,
"reverseHoloAvg1": null,
"reverseHoloAvg7": null,
"reverseHoloAvg30": null
}
}
}
```

--------------------------------

### GET https://api.pokemontcg.io/v2/cards/<id>

Source: https://docs.pokemontcg.io/api-reference/cards/get-card

Fetch the details of a single card by providing its unique ID.

```APIDOC
## GET https://api.pokemontcg.io/v2/cards/<id>

### Description
Fetch the details of a single card.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/cards/<id>

### Parameters
#### Path Parameters
- **id** (string) - Required - The Id of the card

#### Query Parameters
- **select** (string) - Optional - A comma delimited list of fields to return in the response (ex. ?select=id,name). By default, all fields are returned.

### Response
#### Success Response (200)
- **data** (object) - The card object containing details such as name, hp, types, attacks, and set information.

#### Response Example
{
  "data": {
    "id": "xy1-1",
    "name": "Venusaur-EX",
    "supertype": "Pokémon",
    "hp": "180"
  }
}
```

--------------------------------

### GET /v2/cards

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Retrieves a list of cards based on specified query filters and sorting criteria.

```APIDOC
## GET /v2/cards

### Description
Search for Pokémon cards using query parameters to filter by attributes like set name or subtype, and optionally sort the results.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/cards

### Parameters
#### Query Parameters
- **q** (string) - Optional - The query string to filter cards (e.g., "set.name:generations subtypes:mega").
- **orderBy** (string) - Optional - Field to sort results by (e.g., "-set.releaseDate" for descending order).

### Response
#### Success Response (200)
- **data** (array) - List of card objects.
- **page** (integer) - Current page number.
- **pageSize** (integer) - Number of items per page.
- **count** (integer) - Number of items returned in this response.
- **totalCount** (integer) - Total number of items available.

### Response Example
{
  "data": [
    {
      "id": "g1-1",
      "name": "Venusaur-EX",
      "supertype": "Pokémon",
      "subtypes": ["Basic", "EX"],
      "hp": "180"
    }
  ],
  "page": 1,
  "pageSize": 250,
  "count": 117,
  "totalCount": 117
}
```

--------------------------------

### GET /v2/cards

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Retrieves a list of Pokémon cards. Supports pagination, filtering via query parameters, and ordering.

```APIDOC
## GET /v2/cards

### Description
Retrieves a collection of Pokémon cards. This endpoint supports pagination and filtering using query parameters.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/cards

### Parameters
#### Query Parameters
- **page** (integer) - Optional - The page number to retrieve.
- **pageSize** (integer) - Optional - The number of cards to return per page.
- **q** (string) - Optional - The query string to filter cards (e.g., 'set.name:generations subtypes:mega').
- **orderBy** (string) - Optional - Field to order the results by (e.g., '-set.releaseDate').

### Response
#### Success Response (200)
- **data** (array) - A list of card objects.
```

--------------------------------

### GET https://api.pokemontcg.io/v2/cards

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Search for one or many cards given a search query with optional pagination, ordering, and field selection.

```APIDOC
## GET https://api.pokemontcg.io/v2/cards

### Description
Search for one or many cards given a search query. All query parameters are optional.

### Method
GET

### Endpoint
https://api.pokemontcg.io/v2/cards

### Parameters
#### Query Parameters
- **q** (string) - Optional - The search query using Lucene-like syntax.
- **page** (integer) - Optional - The page of data to access. Default: 1
- **pageSize** (integer) - Optional - The maximum amount of cards to return. Max: 250. Default: 250
- **orderBy** (string) - Optional - The field(s) to order the results by.
- **select** (string) - Optional - A comma delimited list of fields to return in the response.
```

--------------------------------

### Sample Response

Source: https://docs.pokemontcg.io/api-reference/subtypes/get-subtypes

The JSON structure returned by the subtypes endpoint.

```json
{
"data": [
"BREAK",
"Baby",
"Basic",
"EX",
"GX",
"Goldenrod Game Corner",
"Item",
"LEGEND",
"Level-Up",
"MEGA",
"Pokémon Tool",
"Pokémon Tool F",
"Rapid Strike",
"Restored",
"Rocket's Secret Machine",
"Single Strike",
"Special",
"Stadium",
"Stage 1",
"Stage 2",
"Supporter",
"TAG TEAM",
"Technical Machine",
"V",
"VMAX"
]
}
```

--------------------------------

### Sample API Response

Source: https://docs.pokemontcg.io/api-reference/sets/get-set

The JSON structure returned when successfully fetching a set.

```json
{
"data": {
"id": "swsh1",
"name": "Sword & Shield",
"series": "Sword & Shield",
"printedTotal": 202,
"total": 216,
"legalities": {
"unlimited": "Legal",
"standard": "Legal",
"expanded": "Legal"
},
"ptcgoCode": "SSH",
"releaseDate": "2020/02/07",
"updatedAt": "2020/08/14 09:35:00",
"images": {
"symbol": "https://images.pokemontcg.io/swsh1/symbol.png",
"logo": "https://images.pokemontcg.io/swsh1/logo.png"
}
}
}
```

--------------------------------

### Sample API response

Source: https://docs.pokemontcg.io/api-reference/cards/get-card

The JSON structure returned when successfully fetching a card.

```json
{
"data": {
"id": "xy1-1",
"name": "Venusaur-EX",
"supertype": "Pokémon",
"subtypes": [
"Basic",
"EX"
],
"hp": "180",
"types": [
"Grass"
],
"evolvesTo": [
"M Venusaur-EX"
],
"rules": [
"Pokémon-EX rule: When a Pokémon-EX has been Knocked Out, your opponent takes 2 Prize cards."
],
"attacks": [
{
"name": "Poison Powder",
"cost": [
"Grass",
"Colorless",
"Colorless"
],
"convertedEnergyCost": 3,
"damage": "60",
"text": "Your opponent's Active Pokémon is now Poisoned."
},
{
"name": "Jungle Hammer",
"cost": [
"Grass",
"Grass",
"Colorless",
"Colorless"
],
"convertedEnergyCost": 4,
"damage": "90",
"text": "Heal 30 damage from this Pokémon."
}
],
"weaknesses": [
{
"type": "Fire",
"value": "×2"
}
],
"retreatCost": [
"Colorless",
"Colorless",
"Colorless",
"Colorless"
],
"convertedRetreatCost": 4,
"set": {
"id": "xy1",
"name": "XY",
"series": "XY",
"printedTotal": 146,
"total": 146,
"legalities": {
"unlimited": "Legal",
"expanded": "Legal"
},
"ptcgoCode": "XY",
"releaseDate": "2014/02/05",
"updatedAt": "2018/03/04 10:35:00",
"images": {
"symbol": "https://images.pokemontcg.io/xy1/symbol.png",
"logo": "https://images.pokemontcg.io/xy1/logo.png"
}
},
"number": "1",
"artist": "Eske Yoshinob",
"rarity": "Rare Holo EX",
"nationalPokedexNumbers": [
3
],
"legalities": {
"unlimited": "Legal",
"expanded": "Legal"
},
"images": {
"small": "https://images.pokemontcg.io/xy1/1.png",
"large": "https://images.pokemontcg.io/xy1/1_hires.png"
},
"tcgplayer": {
"url": "https://prices.pokemontcg.io/tcgplayer/xy1-1",
"updatedAt": "2021/07/09",
"prices": {
"holofoil": {
"low": 1.0,
"mid": 3.46,
"high": 12.95,
"market": 3.32,
"directLow": 2.95
}
}
}
}
}
```

--------------------------------

### Sample response for supertypes

Source: https://docs.pokemontcg.io/api-reference/supertypes/get-supertypes

The expected JSON response format when querying the supertypes endpoint.

```json
{
"data": [
"Energy",
"Pokémon",
"Trainer"
]
}
```

--------------------------------

### Search and Order Cards via cURL

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Use these commands to filter cards by specific criteria or sort them by release date.

```bash
curl "https://api.pokemontcg.io/v2/cards?q=set.name:generations subtypes:mega"
```

```bash
curl "https://api.pokemontcg.io/v2/cards?q=subtypes:mega&orderBy=-set.releaseDate"
```

--------------------------------

### Search Cards with Python SDK

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Use the Card class methods to retrieve and filter card data.

```python
# Get all cards (will take awhile, automatically pages through data)
cards = Card.all()
# Get a single page of cards
cards = Card.where(page=1, pageSize=250)
# Filter cards via query parameters
cards = Card.where(q='set.name:generations subtypes:mega')
# Order by release date (descending)
cards = Card.where(q='subtypes:mega', orderBy='-set.releaseDate')
```

--------------------------------

### Search Cards with JavaScript SDK

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Use the pokemon.card methods which return promises to handle card data retrieval.

```javascript
// Get all cards (will take awhile, automatically pages through data)
pokemon.card.all()
.then((cards) => {
console.log(cards[0].name) // "Blastoise"
})
// Get a single page of cards
pokemon.card.where({ pageSize: 250, page: 1 })
.then(result => {
console.log(result.data[0].name) // "Blastoise"
})
// Filter cards via query parameters
pokemon.card.all({ q: 'set.name:generations subtypes:mega' })
.then(result => {
console.log(result.data[0].name) // "Venusaur"
})
// Order by release date (descending)
pokemon.card.all({ q: 'subtypes:mega', orderBy: '-set.releaseDate' })
.then(result => {
console.log(result.data[0].name)
})
```

--------------------------------

### Sample API Response

Source: https://docs.pokemontcg.io/api-reference/types/get-types

The JSON structure returned by the types endpoint.

```json
{
"data": [
"Colorless",
"Darkness",
"Dragon",
"Fairy",
"Fighting",
"Fire",
"Grass",
"Lightning",
"Metal",
"Psychic",
"Water"
]
}
```

--------------------------------

### Retrieve all rarities

Source: https://docs.pokemontcg.io/api-reference/rarities/get-rarities

Fetches the complete list of card rarities using various programming languages and tools.

```python
rarities = Rarity.all()
```

```ruby
rarities = Pokemon::Rarity.all
```

```javascript
pokemon.rarity.all()
```

```curl
curl "https://api.pokemontcg.io/v2/rarities"
```

--------------------------------

### Search Cards with cURL

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Directly query the API endpoints using standard HTTP requests.

```bash
# Get all cards
curl "https://api.pokemontcg.io/v2/cards"
# Get a single page of cards
curl "https://api.pokemontcg.io/v2/cards?page=1&pageSize=250"
```

--------------------------------

### Sample Error Response Format

Source: https://docs.pokemontcg.io/getting-started/errors

The standard JSON structure returned when an API request fails.

```json
{
"error": {
"message": "Bad Request. Your request is either malformed, or is missing one or more required fields.",
"code": 400
}
}
```

--------------------------------

### Search Sets via cURL

Source: https://docs.pokemontcg.io/api-reference/sets/search-sets

Direct HTTP requests for retrieving all sets, filtering by legality, and paginating results.

```bash
# Get all sets
curl "https://api.pokemontcg.io/v2/sets"
# Filter sets
curl "https://api.pokemontcg.io/v2/sets?q=legalities.standard:legal"
# Get specific page of data
curl "https://api.pokemontcg.io/v2/sets?page=2&pageSize=10"
```

--------------------------------

### Search Cards with Ruby SDK

Source: https://docs.pokemontcg.io/api-reference/cards/search-cards

Use the Pokemon::Card class methods to retrieve and filter card data.

```ruby
# Get all cards (will take awhile, automatically pages through data)
cards = Pokemon::Card.all
# Get a single page of cards
cards = Pokemon::Card.where(page: 1, pageSize: 250)
# Filter cards via query parameters
cards = Pokemon::Card.where(q: 'set.name:generations subtypes:mega')
# Order by release date (descending)
cards = Pokemon::Card.where(q: 'subtypes:mega', orderBy: '-set.releaseDate')
```

--------------------------------

### Error Response Format

Source: https://docs.pokemontcg.io/getting-started/errors

The API returns a consistent JSON structure when an error occurs, providing a descriptive message and the corresponding HTTP status code.

```APIDOC
## Error Response Structure

### Description
When an API request fails, the server returns a JSON object containing an error object with a message and the status code.

### Response Example
{
  "error": {
    "message": "Bad Request. Your request is either malformed, or is missing one or more required fields.",
    "code": 400
  }
}
```
Tokens:
Raw