Skip to content
Miwa.lol Logo
Miwa.lolHelp

Get Cards

Retrieve the list of cards displayed on your profile.

Endpoint

GET /api/cards

Request Headers

HeaderValueDescription
AuthorizationBearer YOUR_API_KEYYour API key. Required for all requests.

Example Request

curl https://miwa.lol/api/cards \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

Returns an array of card objects representing the cards on your profile.

Example Response

[
  {
    "id": "f129c98e-5c3f-449b-a3c4-d4690d7708d3",
    "type": "discord",
    "value": null,
    "extra": {
      "show_badges": false
    }
  },
  {
    "id": "dcf146f0-3b81-4f62-88e5-5f20ac569818",
    "type": "server",
    "value": "discord.gg/miwa",
    "extra": null
  },
  {
    "id": "af711e24-13b4-4dc1-bfbe-d2c75dae90ec",
    "type": "weather",
    "value": "Paris",
    "extra": null
  }
]

Response Fields

Each item in the array represents a card with the following fields:

idstring

UUID uniquely identifying the card.

typestring

The card type (e.g. discord, server, weather).

valuestringnull

The card's main value (e.g. an invite URL or city name), or null.

extraobjectnull

Additional card-specific configuration, or null if not applicable.

Error Responses

StatusDescription
401Missing or invalid API key.
429Rate limit exceeded. Wait before retrying.
Was this page useful?