Public API Documentation

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

Rate Limiting: Requests are rate limited to 15 requests per 10 seconds. Exceeding this limit will result in being blocked from accessing the API for an hour.

Base URL

https://digimoncard-laravel-jgyftkqk.on-forge.com/api-public

Search Specific Cards

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

GET https://digimoncard-laravel-jgyftkqk.on-forge.com/api-public/search

Parameters

Parameter Type Description
n string Search by Card Name. Supports exclude syntax: e:term to exclude terms.
desc string Search by Card Description (searches Source Effect, Main Effect, and Alt Effect)
color string Search by Card Color. Options: Black, Blue, Colorless, Green, Purple, Red, White, Yellow
type string Search by Card Type. Options: Digimon, Option, Tamer, Digi-Egg
attribute string Search by Card Attribute
card string Search by Card Number (e.g., BT4-016). Supports comma-separated values for multiple cards.
pack string Search by Pack Name (e.g., BT-04: Booster Great Legend)
setname string Alternative parameter for Pack Name (same as pack)
sort string Sorting. Options: name, power, code, color, random, level, playcost, type, new, views
sortdirection string Sorting Direction. Options: asc, desc
series string Set the game type. Options: Digimon Card Game, Digimon Digi-Battle Card Game, Digimon Collectible Card Game
format string Alternative parameter for series (same as series)
digitype string Search by Card Digi-Type (e.g., Wizard, Dragon, etc.)
evocost integer Search by Card Evolution Cost
evocolor string Search by Card Evolution Color. Options: Black, Blue, Colorless, Green, Purple, Red, White, Yellow
level integer Search by Card Level
playcost integer Search by Play Cost
dp integer Search by DP (Power)
stage string Search by Stage
artist string Search by Artist Name
limit integer Limit the number of results returned

Example Request

https://digimoncard-laravel-jgyftkqk.on-forge.com/api-public/search?n=Aldamon&desc=include%20a%20Digimon%20card&color=red&type=digimon&attribute=Variable&card=BT4-016&pack=BT-04%3A%20Booster%20Great%20Legend&sort=name&sortdirection=desc&series=Digimon%20Card%20Game&digitype=Wizard&evocost=3&evocolor=Red

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": " (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",
    "tcgplayer_name": "Aldamon",
    "tcgplayer_id": 238186,
    "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.

GET https://digimoncard-laravel-jgyftkqk.on-forge.com/api-public/getAllCards

Parameters

Parameter Type Description
series string Filter by game series (optional)
sort string Sorting. Options: name, random, card_number (default: name)
sortdirection string Sorting Direction. Options: asc, desc (default: asc)

Example Request

https://digimoncard-laravel-jgyftkqk.on-forge.com/api-public/getAllCards?series=Digimon%20Card%20Game&sort=name&sortdirection=asc

Example Response

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

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."
}

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: If you continue to exceed limits, you may be temporarily blocked for up to 1 hour

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

Need Help?

If you have questions about the API or need assistance, please visit our forums or check the about page for more information.