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

{
  "success": true,
  "data": {
    "characters": [],
    "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
Character name partial match (bidirectional wildcard, case-sensitive)
​
filter.class
string
Class filter. Use all_classes (default) for all classes
​
filter.job
string
Job filter. Includes all job advancement stages 1–5. Use all_jobs (default) to remove filter
​
filter.attackPower
string
Minimum attack power threshold (inclusive). Positive integers only
​
filter.price.min
number
Minimum price (NESO, ≥0)
​
filter.price.max
number
Maximum price (NESO, ≥min)
​
filter.level.min
integer
Minimum level
​
filter.level.max
integer
Maximum level (≥min)
​
sorting
string
Sort criterion (HIGHEST_PRICE, LOWEST_PRICE, ENDING_SOON, RECENTLY_LISTED, HIGHEST_ATTACK_POWER)
​
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/characters?paginationParam.pageNo=1&paginationParam.pageSize=30' \
  --header 'Content-Type: application/json' \
  --header 'x-nxopen-api-key: YOUR_API_KEY'

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