[Guide] Response Schema for OpenAPI (v1rc1) (updated on Nov 06, 2025)

We are pleased to introduce the guide on response schema documentation for the new OpenAPI (v1rc1). 

 
This guide provides the names, types, and brief descriptions of each response field in a table format, to help you clearly understand the structure during API integration and apply it effectively in development. 

 
Please refer to the full content below for more details. 

■ Category Descriptions

• Accounts 
  • Retrieves wallet-level information including owned characters, items, currencies, and NESO balances by wallet address. 
  • This is a read-only endpoint that provides account-level ownership and balance information. 
• Characters 
  • Retrieves current status, stats, equipment, image, quest/history, and owner information of character NFTs by asset key. 
  • This is a read-only endpoint that provides instance-level information. 
• GameMeta 
  • Provides game content data (item basic/category/wear conditions/set effects/base stats, skill/quest information). 
  • This is mostly static data with infrequent changes, queried by itemId/skillId/questId. 
  • This is a read-only endpoint that provides meta (definition) level information, not instance data. 
• Items 
  • Retrieves basic/enhanced/stats, status, image, owner, and (representative) history information of individual item NFTs (tokens) by asset key. 
  • This is a read-only endpoint that provides instance-level information. 

■ Enhancement Materials(updated on November 06, 2025)

■ Schemas

• Ability
  Contains character ability information.

  Field	Type	Descriptioin
  ability1	AbilityRecord	First line ability
  ability2	AbilityRecord	Second line ability
  ability3	AbilityRecord	Third line ability

   
• AbilityRecord
  Contains detailed information of individual abilities.

  Field	Type	Descriptioin
  grade	integer	Ability grade
  code	integer	Ability code
  desc	string	Ability description
  values	double[]	Ability value array
  level	integer	Ability level

   
• ApStat
  Contains all AP stat information of a character.

  Field	Type	Descriptioin
  str	ApStatRecord	STR
  dex	ApStatRecord	DEX
  int	ApStatRecord	INT
  luk	ApStatRecord	LUK
  hp	ApStatRecord	HP
  mp	ApStatRecord	MP
  damage	ApStatRecord	Damage
  bossMonsterDamage	ApStatRecord	Boss Monster Damage
  finalDamage	ApStatRecord	Final Damage
  ignoreDefence	ApStatRecord	Ignore Defense
  criticalRate	ApStatRecord	Critical Rate
  criticalDamage	ApStatRecord	Critical Damage
  buffDurationRate	ApStatRecord	Buff Duration
  abnormalStatusResistance	ApStatRecord	Abnormal Status Resistance
  defence	ApStatRecord	Defense
  speed	ApStatRecord	Movement Speed
  jump	ApStatRecord	Jump
  knockbackResistance	ApStatRecord	Stance (Knockback Resistance)

   
• ApStatRecord
  Contains detailed information of each AP stat.

  Field	Type	Descriptioin
  total	integer	Total value
  base	integer	Base value
  ability	integer	Ability increase value
  hyperStat	integer	Hyper stat increase value
  others	integer	Other increase value

   
• BeautyAttributes
  Contains color attribute information of beauty items.

  Field	Type	Descriptioin
  baseColor	ColorCode	Base color code
  baseColorProp	integer	Base color ratio (100 - mixed color ratio)
  mixedColor	ColorCode	Mixed color code
  mixedColorProp	integer	Mixed color ratio (100 - base color ratio)

    
• Category
  Contains category information of items or characters.

  Field	Type	Descriptioin
  categoryNo	integer	Category number
  label	string	Category hierarchy label - String output representing entire hierarchy structure. Example: "Character > Explorer > Warrior > Hero"
  isFtItem	boolean	Whether it's an FT item
  isWearableItem	boolean	Whether it's a wearable item
  tier0	CategoryTier	Category tier 0
  tier1	CategoryTier	Category tier 1
  tier2	CategoryTier	Category tier 2
  tier3	CategoryTier	Category tier 3

    
• CategoryTier
  Represents hierarchy information of categories.

  Field	Type	Descriptioin
  label	string	Tier label
  code	string	Tier code

    
• Character
  Main model containing complete character information.

  Field	Type	Descriptioin
  assetKey	string	Character's unique asset key
  category	Category	Character category information
  tokenInfo	TokenInfo	Token-related information (NFT data)
  statusV2	CharacterStatus	Character status information
  owner	Owner	Owner information
  image	CharacterImage	Character image information
  common	CharacterCommon	Character basic information
  apStat	ApStat	AP stat information
  hyperStat	HyperStat	Hyper stat information
  ability	Ability	Ability information
  wearing	Wearing	Equipment wearing information

    
• CharacterCommon
  Contains basic character information.

  Field	Type	Descriptioin
  name	string	Character name
  level	integer	Character level
  world	GameWorld	Game world information
  job	Job	Job information
  nesolet	string	Nesolet information
  exp	string	Current experience
  totalExp	string	Total experience
  expr	string	Experience ratio
  gender	integer	Gender (0: Male, 1: Female)
  popularity	integer	Fame
  honorExp	integer	Honor experience

   
• CharacterElement
  Summary information used in character lists.

  Field	Type	Descriptioin
  name	string	Character name
  assetKey	string	Asset key
  tokenId	string	Token ID
  categoryNo	integer	Category number
  data	CharacterSummary	Character summary data

   
• CharacterHistoryMission
  Contains character's history mission information.

  Field	Type	Descriptioin
  achievedAt	datetime	Achievement date
  charAssetKey	string	Character asset key
  historyMissionId	integer	History mission ID
  historyMissionTitle	string	History mission title
  mainCategory	HistoryMissionMainCategory	Main category
  subCategory	HistoryMissionSubCategory	Sub category

    
• CharacterImage
  Contains character's image information.

  Field	Type	Descriptioin
  avatarParam	string	Avatar parameter
  imageUrl	string	Image URL

    
• CharacterSkill
  Contains character's skill information.

  Field	Type	Descriptioin
  skillId	integer	Skill ID
  skillMasterLevel	integer	Skill master level
  skillDescription	string	Skill description
  skillName	string	Skill name
  skillLevel	integer	Current skill level
  skillEffectDescription	string	Skill effect description
  skillImageUrl	string	Skill image URL

   
• CharacterSkillSet
  Contains character's skill set information.

  Field	Type	Descriptioin
  tier	integer	Skill tier
  skills	CharacterSkill[]	Skill list

    
• CharacterStatus
  Contains character's status and minting information.

  Field	Type	Descriptioin
  usageStatus	CharacterUsageStatus	Usage status
  isMinted	boolean	Whether minted
  linkedDapp	string[]	List of linked DApps

    
• CharacterSummary
  Contains character's summary information.

  Field	Type	Descriptioin
  classCode	integer	Class code
  jobCode	integer	Job code
  level	integer	Level
  world	integer	World code
  expr	string	Experience ratio
  imageUrl	string	Image URL

    
• Currency
  Contains in-game currency information.

  Field	Type	Descriptioin
  amount	string	Amount held
  code	string	Currency code
  name	string	Currency name

    
• DecoWearings
  Contains decorative equipment wearing information (appearance only).

  Field	Type	Descriptioin
  cap	Gear	Decorative hat
  faceAcc	Gear	Decorative face accessory
  eyeAcc	Gear	Decorative eye accessory
  earAcc	Gear	Decorative ear accessory
  clothes	Gear	Decorative top
  pants	Gear	Decorative bottom
  shoes	Gear	Decorative shoes
  gloves	Gear	Decorative gloves
  cape	Gear	Decorative cape
  subWeapon	Gear	Decorative secondary weapon
  weapon	Gear	Decorative weapon
  ring1	Gear	Decorative ring 1
  ring2	Gear	Decorative ring 2
  ring3	Gear	Decorative ring 3
  ring4	Gear	Decorative ring 4
  face	Gear	Cosmetic face
  skin	Gear	Skin
  hair	Gear	Hair

   
• EquipWearings
  Contains equipment wearing information that affects actual stats.

  Field	Type	Descriptioin
  cap	Gear	Hat
  faceAcc	Gear	Face accessory
  eyeAcc	Gear	Eye accessory
  earAcc	Gear	Ear accessory
  clothes	Gear	Top
  pants	Gear	Bottom
  shoes	Gear	Shoes
  gloves	Gear	Gloves
  cape	Gear	Cape
  subWeapon	Gear	Secondary weapon
  weapon	Gear	Weapon
  ring1	Gear	Ring 1
  ring2	Gear	Ring 2
  ring3	Gear	Ring 3
  ring4	Gear	Ring 4
  pendant1	Gear	Pendant 1
  pendant2	Gear	Pendant 2
  medal	Gear	Medal
  belt	Gear	Belt
  shoulder	Gear	Shoulder decoration
  pocket	Gear	Pocket item
  android	Gear	Android
  machineHeart	Gear	Machine heart
  badge	Gear	Badge
  emblem	Gear	Emblem

    
• ExtraOption
  Contains additional option information.

  Field	Type	Descriptioin
  code	string	Additional option code

   
• GameWorld
  Contains game world information.

  Field	Type	Descriptioin
  code	integer	World code
  name	string	World name

    
• Gear
  Contains basic equipment item information.

  Field	Type	Descriptioin
  assetKey	string	Asset key
  itemId	integer	Item ID
  tokenId	string	Token ID
  mintable	boolean	Whether mintable
  imageUrl	string	Image URL
  expiredDate	datetime	Expiration date

    
• HyperStat
  Contains character's hyper stat information..

  Field	Type	Descriptioin
  str	HyperStatRecord	Strength hyper stat
  dex	HyperStatRecord	Dexterity hyper stat
  int	HyperStatRecord	Intelligence hyper stat
  luk	HyperStatRecord	Luck hyper stat
  maxHp	HyperStatRecord	Max HP
  maxMp	HyperStatRecord	Max MP
  criticalRate	HyperStatRecord	Critical rate
  criticalDamage	HyperStatRecord	Critical damage
  ignoreDefence	HyperStatRecord	Ignore defense
  damage	HyperStatRecord	Damage
  bossMonsterDamage	HyperStatRecord	Boss monster damage
  normalMonsterDamage	HyperStatRecord	Normal monster damage
  abnormalStatusResistance	HyperStatRecord	Abnormal status resistance
  attackAndMagicAttack	HyperStatRecord	Attack/Magic attack
  expEarned	HyperStatRecord	EXP earned

     
• HyperStatRecord
  Contains detailed information of each hyper stat.

  Field	Type	Descriptioin
  code	integer	Hyper stat code
  desc	string	Hyper stat description
  level	integer	Hyper stat level

     
• InventoryElement
  Contains summary information of inventory items.

  Field	Type	Descriptioin
  name	string	Item name
  assetKey	string	Asset key
  tokenId	string	Token ID
  itemId	integer	Item ID
  categoryNo	integer	Category number
  mintingNo	integer	Minting number
  ownerWalletAddr	string	Owner wallet address
  ownerCharAssetKey	string	Owner character asset key
  isSbt	boolean	Whether SBT
  nftItem	NftItemSummary	NFT item summary information

    
• ItemBaseStats
  Contains item's base stat information.

  Field	Type	Descriptioin
  attackSpeed	integer	Attack speed
  knockback	integer	Knockback
  str	integer	Strength
  dex	integer	Dexterity
  int	integer	Intelligence
  luk	integer	Luck
  maxHp	integer	Max HP
  maxMp	integer	Max MP
  maxHpr	integer	HP recovery rate
  maxMpr	integer	MP recovery rate
  pad	integer	Physical attack
  pdd	integer	Physical defense
  mad	integer	Magic attack
  bdr	integer	Boss damage
  imdr	integer	Ignore defense
  damr	integer	Damage
  statr	integer	All stats
  speed	integer	Movement speed
  jump	integer	Jump
  recoveryHp	integer	HP recovery
  recoveryMp	integer	MP recovery

     
• ItemCommon
  Contains basic item information.

  Field	Type	Descriptioin
  itemName	string	Item name
  itemId	integer	Item ID
  desc	string	Item description
  isMintable	boolean	Whether mintable
  isSbt	boolean	Whether SBT (Soul Bound Token)
  isOnly	boolean	Whether unique item
  isOnlyEquip	boolean	Whether equip-only
  isBossReward	boolean	Whether boss reward item
  blockUpgradeStarforce	boolean	Whether starforce upgrade is blocked
  blockUpgradePotential	boolean	Whether potential upgrade is blocked
  blockUpgradeExtraOption	boolean	Whether additional option upgrade is blocked
  enableStarforce	boolean	Whether starforce is available
  enablePotential	boolean	Whether potential is available
  enableExtraOption	boolean	Whether additional option is available
  maxStarforce	integer	Maximum starforce
  slotMax	integer	Maximum slot count
  ridingSkill	integer	Riding skill
  setItemId	integer	Set item ID

    
• ItemElement
  Summary information used in item lists.

  Field	Type	Descriptioin
  name	string	Item name
  assetKey	string	Asset key
  tokenId	string	Token ID
  itemId	integer	Item ID
  categoryNo	integer	Category number
  mintingNo	integer	Minting number
  ownerWalletAddr	string	Owner wallet address
  ownerCharAssetKey	string	Owner character asset key
  isSbt	boolean	Whether SBT
  data	ItemSummary	Item summary data

    
• ItemHistoryMission
  Contains item's history mission information.

  Field	Type	Descriptioin
  itemAssetKey	string	Item asset key
  historyMissionId	string	History mission ID
  historyMissionTitle	string	History mission title
  characterName	string	Character name
  isFirst	boolean	Whether first achievement
  achievedAt	datetime	Achievement date

    
• ItemImage
  Contains item's image information.

  Field	Type	Descriptioin
  iconImageUrl	string	Icon image URL
  sampleImageUrl	string	Sample image URL
  hasSampleImage	boolean	Whether sample image exists

    
• ItemRequired
  Contains item's requirement conditions.

  Field	Type	Descriptioin
  level	integer	Required level
  str	integer	Required strength
  dex	integer	Required dexterity
  int	integer	Required intelligence
  luk	integer	Required luck
  job	JobRequired	Required job

    
• ItemSet
  Contains set item information.

  Field	Type	Descriptioin
  setId	integer	Set ID
  setName	string	Set name
  viewType	ViewType	Display type
  pieces	SetPiece[]	Set component items
  effects	SetEffect[]	Set effects

     
• ItemStat
  Contains composition information of individual item stats.

  Field	Type	Descriptioin
  total	integer	Total stat value
  base	integer	Base stat value
  enhance	integer	Stat gained from enhancement
  extra	integer	Stat gained from additional options

    
• ItemStats
  Contains detailed stat information of items.

  Field	Type	Descriptioin
  levelReduced	integer	Level reduction
  attackSpeed	integer	Attack speed
  knockback	integer	Knockback
  str	ItemStat	Strength stat
  dex	ItemStat	Dexterity stat
  int	ItemStat	Intelligence stat
  luk	ItemStat	Luck stat
  maxHp	ItemStat	Max HP
  maxMp	ItemStat	Max MP
  maxHpr	ItemStat	HP recovery rate
  maxMpr	ItemStat	MP recovery rate
  pad	ItemStat	Physical attack
  pdd	ItemStat	Physical defense
  mad	ItemStat	Magic attack
  bdr	ItemStat	Boss damage
  imdr	ItemStat	Ignore defense
  damr	ItemStat	Damage
  statr	ItemStat	All stats
  speed	ItemStat	Movement speed
  jump	ItemStat	Jump
  recoveryHp	integer	HP recovery
  recoveryMp	integer	MP recovery

   
• ItemStatus
  Contains item's status information.

  Field	Type	Descriptioin
  usageStatus	ItemUsageStatus	Usage status
  isMinted	boolean	Whether minted
  location	ItemLocation	Item location

    
• ItemSummary
  Contains item's summary information.

  Field	Type	Descriptioin
  potentialGrade	integer	Potential grade
  bonusPotentialGrade	integer	Additional potential grade
  starforce	integer	Starforce level
  enableStarforce	boolean	Whether starforce is available
  enablePotential	boolean	Whether potential is available
  enableExtraOption	boolean	Whether additional option is available
  maxStarforce	integer	Maximum starforce
  imageUrl	string	Image URL

    
• Job
  Contains character's job information.

  Field	Type	Descriptioin
  classCode	integer	Class code
  className	string	Class name
  jobCode	integer	Job code
  jobName	string	Job name

    
• JobRequired
  Contains job conditions required for item wearing.

  Field	Type	Descriptioin
  classCode	integer	Required class code
  className	string	Required class name
  jobCode	integer	Required job code
  jobName	string	Required job name

    
• NftItem
  Main model containing complete NFT item information.

  Field	Type	Descriptioin
  assetKey	string	Item's unique asset key
  category	Category	Item category information
  tokenInfo	TokenInfo	Token-related information
  statusV2	ItemStatus	Item status information
  owner	Owner	Owner information
  image	ItemImage	Item image information
  common	ItemCommon	Item basic information
  required	ItemRequired	Item requirement conditions
  stats	ItemStats	Item stat information
  enhance	ItemEnhance	Item enhancement information
  beauty	BeautyAttributes	Beauty attributes (if applicable)
  pet	PetAttributes	Pet attributes (if applicable)

     
• NftItemSummary
  Contains NFT item's summary information.

  Field	Type	Descriptioin
  potentialGrade	integer	Potential grade
  bonusPotentialGrade	integer	Additional potential grade
  starforce	integer	Starforce lㄴevel
  enableStarforce	boolean	Whether starforce is available
  enablePotential	boolean	Whether potential is available
  enableExtraOption	boolean	Whether additional option is available
  maxStarforce	integer	Maximum starforce
  itemName	string	Item name
  itemId	integer	Item ID
  imageUrl	string	Image URL
  tokenId	string	Token ID
  mintingNo	integer	Minting number
  isSbt	boolean	Whether SBT

    
• Owner
  Contains owner information.

  Field	Type	Descriptioin
  walletAddress	string	Wallet address

    
• PaginationParam
  Contains pagination request parameters.

  Field	Type	Descriptioin
  pageNo	integer	Page number
  pageSize	integer	Page size

    
• PaginationResult
  Contains pagination response results.

  Field	Type	Descriptioin
  totalCount	integer	Total count
  pageSize	integer	Page size
  currPageNo	integer	Current page number
  isLastPage	boolean	Whether last page

    
• Pet
  Contains pet information.

  Field	Type	Descriptioin
  itemId	integer	Pet item ID
  tokenId	string	Token ID
  assetKey	string	Asset key
  mintable	boolean	Whether mintable
  petAcc	Gear	Pet equipment
  imageUrl	string	Image URL

    
• PetAttributes
  Contains pet's attribute information.

  Field	Type	Descriptioin
  petName	string	Pet name
  petLevel	integer	Pet level
  closeness	integer	Closeness
  isMultiPet	boolean	Whether multi-pet
  petSkill	integer	Pet skill
  petOwnedSkills	PetSkill[]	List of owned pet skills

     
• PetSkill
  Contains pet skill information.

  Field	Type	Descriptioin
  petSkillItemId	integer	Pet skill item ID
  petSkillName	string	Pet skill name
  imageUrl	string	Image URL

     
• PetWearings
  Contains worn pet information

  Field	Type	Descriptioin
  pet1	Pet	Pet 1
  pet2	Pet	Pet 2
  pet3	Pet	Pet 3

    
• PlainItem
  Contains metadata information of regular items..

  Field	Type	Descriptioin
  category	Category	Category information
  common	ItemCommon	Basic information
  required	ItemRequired	Requirements
  stats	ItemBaseStats	Base stats
  image	ItemImage	Image information
  beauty	BeautyAttributes	Beauty attributes
  pet	PetAttributes	Pet attributes

    
• Potential
  Contains potential information.

  Field	Type	Descriptioin
  option1	PotentialOption	First option
  option2	PotentialOption	Second option
  option3	PotentialOption	Third option

     
• PotentialOption
  Contains individual potential option information.

  Field	Type	Descriptioin
  label	string	Option description
  code	integer	Option code
  grade	integer	Option grade

    
• QuestMetadata
  Contains quest's metadata information.

  Field	Type	Descriptioin
  questId	integer	Quest ID
  questTitle	string	Quest title
  questSummary	string	Quest summary
  questReward	string	Quest reward
  questDescriptionInProgress	string	In-progress description
  questDescriptionCompleted	string	Completion description
  reqLevel	integer	Required level
  questAreaCode	integer	Quest area code
  questAreaName	string	Quest area name
  isCollectionQuest	boolean	Whether collection quest
  collectionItemId	integer	Collection item ID
  npcImageUrl	string	NPC image URL
  selfStart	boolean	Whether auto-start

    
• QuestRecord
  Contains quest record information.

  Field	Type	Descriptioin
  questId	integer	Quest ID
  questTitle	string	Quest title
  questStatus	QuestStatus	Quest status
  completedAt	datetime	Completion date

    
• QuestSet
  Contains quest set information.

  Field	Type	Descriptioin
  questAreaCode	integer	Quest area code
  questAreaName	string	Quest area name
  questRecords	QuestRecord[]	Quest record list

    
• SetEffect
  Contains set effect information.

  Field	Type	Descriptioin
  equipCount	integer	Required equipped count
  desc	string[]	Effect description array

     
• SetPiece
  Contains set component information.

  Field	Type	Descriptioin
  representName	string	Representative name
  typeName	string	Type name
  itemId	integer	Item ID
  subItems	SetPieceSubItem[]	Sub items
  imageUrl	string	Image URL

    
• SetPieceSubItem
  Contains sub item information of set components.

  Field	Type	Descriptioin
  itemId	integer	Item ID
  itemName	string	Item name

    
• SkillMetadata
  Contains skill's metadata information.

  Field	Type	Descriptioin
  skillId	integer	Skill ID
  skillName	string	Skill name
  skillDescription	string	Skill description
  skillTier	integer	Skill tier
  skillMasterLevel	integer	Skill master level
  effectDescription	string	Effect description
  skillImageUrl	string	Skill image URL

     
• StarForce
  Contains starforce enhancement information.

  Field	Type	Descriptioin
  enhanced	integer	Current enhancement level
  maxStarforce	integer	Maximum starforce
  serialFailCount	integer	Consecutive failure count

    
• TokenInfo
  Contains token-related information.

  Field	Type	Descriptioin
  ownerWalletAddress	string	Owner wallet address
  tokenId	string	Token ID
  tokenStandard	string	Token standard
  mintingNo	integer	Minting number
  tokenType	TokenType	Token type

    
• Wearing
  Contains all equipment information worn by character.

  Field	Type	Descriptioin
  equip	EquipWearings	Equipment wearing information
  decoEquip	DecoWearings	Decorative equipment wearing information
  pet	PetWearings	Pet wearing information

    
• SetEffect
  Contains set effect information.

  Field	Type	Descriptioin
  equipCount	integer	Required equipped count
  desc	string[]	Effect description array