# Generate a rank card

**GET /v1/images/rank-card**

Creates a customizable rank card showing user level, XP, and rank position.
Uses Amina's design system with support for custom themes and colors.



## Servers
- Production: https://api.4mina.app (Production)


## Authentication methods
- Bearer auth


## Parameters


### Query parameters
- **username** (string)
  Display name
- **level** (integer)
  Current level
- **xp** (integer)
  Current XP
- **requiredXp** (integer)
  XP needed for next level
- **rank** (integer)
  Leaderboard position
- **avatar** (string(uri))
  Avatar image URL
- **status** (string)
  Discord status indicator
- **theme** (string)
  Card theme
- **progressColor** (string)
  Progress bar color (hex)


## Responses
### 200
SVG image

#### Body: image/svg+xml (string)
string
### 400
Bad request - missing or invalid parameters

#### Body: application/json (object)
- **success** (boolean)

- **error** (object)

- **meta** (object)


### 401
Unauthorized - invalid or missing API key

#### Body: application/json (object)
- **success** (boolean)

- **error** (object)

- **meta** (object)


### 429
Rate limit exceeded
#### Headers
- **X-RateLimit-Limit** (integer)

- **X-RateLimit-Remaining** (integer)

- **X-RateLimit-Reset** (integer)

- **Retry-After** (integer)


#### Body: application/json (object)
- **success** (boolean)

- **error** (object)

- **meta** (object)



[Powered by Bump.sh](https://bump.sh)