GET /v1/images/spotify-card
Bearer auth

Query parameters

  • title string Required

    Track title

  • artist string Required
  • album string
  • albumArt string(uri)
  • progress number

    Playback progress percentage

    Minimum value is 0, maximum value is 100.

  • duration string

    Track duration (e.g., "3:45")

  • currentTime string

    Current playback time

  • isPlaying boolean

    Default value is false.

Responses

  • 200 image/svg+xml

    SVG image
  • 400 application/json

    Bad request - missing or invalid parameters

    Hide response attributes Show response attributes object
    • success boolean
    • error object
      Hide error attributes Show error attributes object
      • message string
      • code string
    • meta object
      Hide meta attribute Show meta attribute object
      • generatedAt string(date-time)
  • 401 application/json

    Unauthorized - invalid or missing API key

    Hide response attributes Show response attributes object
    • success boolean
    • error object
      Hide error attributes Show error attributes object
      • message string
      • code string
    • meta object
      Hide meta attribute Show meta attribute object
      • generatedAt string(date-time)
GET /v1/images/spotify-card 
curl \
 --request GET 'https://api.4mina.app/v1/images/spotify-card?title=string&artist=string' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
string
Response examples (400) 
{
  "success": false,
  "error": {
    "message": "string",
    "code": "string"
  },
  "meta": {
    "generatedAt": "2025-05-04T09:42:00Z"
  }
}
Response examples (401) 
{
  "success": false,
  "error": {
    "message": "string",
    "code": "string"
  },
  "meta": {
    "generatedAt": "2025-05-04T09:42:00Z"
  }
}