Skip to main content
GET
/
v1rc1
/
search
/
items
curl --request GET \
  --url 'https://openapi.msu.io/v1rc1/search/items?paginationParam.pageNo=1&paginationParam.pageSize=30' \
  --header 'Content-Type: application/json' \
  --header 'x-nxopen-api-key: YOUR_API_KEY'

{
  "success": true,
  "data": {
    "items": [],
    "paginationResult": {
      "totalCount": 0,
      "currPageNo": 1,
      "pageSize": 30,
      "isLastPage": true
    }
  }
}

​
Header parameters

​
msu-authorization
string
Auth token. When provided, search filters are applied; without it, filters are not applied.

​
Query parameters

​
filter.name
string
Item name partial match (bidirectional wildcard, case-sensitive)
​
filter.mintingNo
integer
Minting number (exact match)
​
filter.categoryNo
integer
Category number (exact match)
​
filter.itemId
integer
Item meta ID (exact match)
​
filter.classes
array
Class code filter (OR condition). Include all_classes to remove filter
​
filter.achievedCharName
string
History achievement character name (exact match, case-sensitive)
​
filter.color
array
Color code filter for beauty/hair items (OR condition). Include all_colors to remove filter
​
filter.PetSkills
array
Pet skill code filter (OR condition)
​
filter.price.min
number
Minimum price (NESO, ≥0)
​
filter.price.max
number
Maximum price (NESO, ≥min)
​
filter.level.min
integer
Minimum required level
​
filter.level.max
integer
Maximum required level (≥min)
​
filter.starforce.min
integer
Minimum Starforce (valid range: 0–25)
​
filter.starforce.max
integer
Maximum Starforce
​
filter.potential.min
integer
Minimum Potential grade (0: Normal, 1: Rare, 2: Epic, 3: Unique, 4: Legendary)
​
filter.potential.max
integer
Maximum Potential grade
​
filter.bonusPotential.min
integer
Minimum additional Potential grade
​
filter.bonusPotential.max
integer
Maximum additional Potential grade
​
sorting
string
Sort criterion (HIGHEST_PRICE, LOWEST_PRICE, ENDING_SOON, RECENTLY_LISTED)
​
paginationParam.pageNo
integer
Page number (starting from 1, default: 1)
​
paginationParam.pageSize
integer
Page size (default: 30). Combined offset of (pageNo-1) × pageSize must not exceed 10,000

​
Response

​
success
boolean
Indicates if the request was successful
​
data
object
curl --request GET \
  --url 'https://openapi.msu.io/v1rc1/search/items?paginationParam.pageNo=1&paginationParam.pageSize=30' \
  --header 'Content-Type: application/json' \
  --header 'x-nxopen-api-key: YOUR_API_KEY'

{
  "success": true,
  "data": {
    "items": [],
    "paginationResult": {
      "totalCount": 0,
      "currPageNo": 1,
      "pageSize": 30,
      "isLastPage": true
    }
  }
}