Public API Documentation

The DigimonCard.io Public API allows you to retrieve information for Digimon Cards from the Digimon TCG programmatically.

Base URL

Search Specific Cards

Search for specific cards using various parameters. If no parameters are set, an error is returned.

Parameters

Example Request

Example Response

[
  {
    "name": "Aldamon",
    "type": "Digimon",
    "id": "BT4-016",
    "level": 5,
    "play_cost": 8,
    "evolution_cost": 3,
    "evolution_color": "Red",
    "evolution_level": 4,
    "xros_req": "",
    "color": "Red",
    "color2": null,
    "digi_type": "Wizard",
    "digi_type2": null,
    "form": "Hybrid",
    "dp": 7000,
    "attribute": "Variable",
    "rarity": "sr",
    "stage": "Hybrid",
    "artist": null,
    "main_effect": "<Security Attack +1> (This Digimon checks 1 additional security card).\n[Your Turn] While this Digimon's digivolution cards include a Digimon card with the [Hybrid] trait or a red Tamer card, it gets +4000 DP.",
    "source_effect": "",
    "alt_effect": "",
    "series": "Digimon Card Game",
    "pretty_url": "aldamon-bt4-016",
    "date_added": "2024-05-27 15:14:30",
    "set_name": ["BT-04: Booster Great Legend"]
  }
]

Get All Cards

Retrieve a simplified list of all cards (name and card number only). Useful for getting a complete list of cards. The default catalogue is a prebuilt static response and supports gzip compression when the client sends Accept-Encoding: gzip.

Parameters

Example Request

Example Response

[
  {
    "name": "Agumon",
    "cardnumber": "BT1-010"
  },
  {
    "name": "Aldamon",
    "cardnumber": "BT4-016"
  }
]

Acceptable Use

You may use the API to build applications, tools, bots, and other services for the Digimon TCG community, subject to the following conditions:

• Do not mirror, republish, sublicense, sell, resell, or offer the API dataset as a competing data service without prior written permission.
• Do not hotlink images hosted by DigimonCard.io. You must download any images you use and serve them from your own hosting or infrastructure.
• Do not bypass rate limits, caching, access controls, or other measures intended to protect the API and website.
• Do not use the API in a way that degrades service for other users or places unreasonable load on DigimonCard.io.
• Where practical, identify DigimonCard.io as the source and link to this API documentation.

Digimon and Digimon Card Game names, artwork, and related intellectual property belong to their respective owners. Access may be restricted for abusive use or violations of these terms.

CORS Support

The API supports Cross-Origin Resource Sharing (CORS) and can be accessed from any domain. All endpoints return appropriate CORS headers.

Error Handling

If no cards are found or no search parameters are provided, the API will return a 400 status code with an error message:

{
  "error": "No cards found for this search."
}

Unsupported parameters, invalid values, and limits above 1,000 return a 422 response with field-level validation errors. Query parameter names are case-sensitive.

Rate Limiting

To ensure fair usage and maintain API performance, requests are rate limited:

• Limit: 15 requests per 10 seconds per IP address
• Penalty: Exceeding the limit will result in a 429 (Too Many Requests) response
• Block Duration: Exceeding the limit results in a 1-hour temporary block

We recommend implementing request throttling in your application to avoid hitting our rate limits.