Skip to content

Get current user status

Request

Get authenticated user status types. Use pagination parameters (page & limit) for optimal performance. Legacy support: returns array without params (deprecated - will be removed in future).

Security
authJWT
Query
pagenumber

Page number (1-based)

limitnumber

Items per page

curl -i -X GET \
  'https://docs.pers.ninja/_mock/swagger/users/me/status?page=0&limit=0' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

User status found

Bodyapplication/json
Array [
namestringrequired

User Status Type name

descriptionstring

User Status Type description

minTokenBalancestringrequired

User Status Type eligible Token Addresses

discountPercentagenumberrequired

User Status Type discount Rate in percentage

imageUrlstring

User Status Type image Url

eligibleTokenAddressesArray of strings

Eligible token contract addresses for this status type

Example:
[ "0x1234...", "0x5678..." ]
tagsArray of strings

Tags for categorization and filtering

Example:
[ "vip", "premium", "gold" ]
ordernumber

Explicit ordering for status hierarchy (higher = more prestigious). If not set, falls back to minTokenBalance for ordering.

Example:100
idnumberrequired

User Status Type id

]
Response
[ { "name": "string", "description": "string", "minTokenBalance": "string", "discountPercentage": 0, "imageUrl": "string", "eligibleTokenAddresses": [ … ], "tags": [ … ], "order": 100, "id": 0 } ]