Neople Developers | Dungeon Fighter Online

The following is the currently available DFO Open API list.

APP/KEY

Key will be issued after login and application registration are complete.

Expand all lists

01. Server Info /df/servers

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Value|Max Value -----|----|--------|:------------:|:---------:|:---------: |||||
02. Search Character /df/servers/:serverId/characters

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Value|Max Value -----|----|--------|:------------:|:---------:|:---------: serverId|String|**Server ID** (See /df/servers API) **all** : Search for all servers|Y|| characterName|String|Character Name (Required URL encoding)|Y|| jobId|String|Character class unique code||| jobGrowId|String|Character advancement unique code(Requires jobId)||| isAllJobGrow|Boolean|Retrieve all related advancements when jobGrowId is input||false| wordType|String|Search type: Match, full [(see Search type for more details)](/developers/contents/guide/pages/all#dfo-character-wordtype)||match| limit|Integer|Number of returned rows||10|50
03. Search Character "Basic Information" /df/servers/:serverId/characters/:characterId

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
04. Search Character "Stat Information" /df/servers/:serverId/characters/:characterId/status

Request URL

Request

Response Preview

Response Body

## Please Note > Stat information is provided based on the latest in-game login and can differ or be unavailable depending on character login circumstances. Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
05. Search Character "Equipped Equipment" /df/servers/:serverId/characters/:characterId/equip/equipment

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
06. Search Character "Equipped Avatar" /df/servers/:serverId/characters/:characterId/equip/avatar

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
07. Search Character "Equipped Creature" /df/servers/:serverId/characters/:characterId/equip/creature

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
08. Search Character "Equipped Insignia" /df/servers/:serverId/characters/:characterId/equip/flag

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
09. Search Character "Equipped Talisman" /df/servers/:serverId/characters/:characterId/equip/talisman

Request URL

Request

Response Preview

Response Body

## Please Note > Item details for Talismans and Runes can be checked all at once through "Search Multiple Item Details API". Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
10. Search Character "Equipment Trait" /df/servers/:serverId/characters/:characterId/equip/equipment-trait

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
11. Search Character "Skill Style" /df/servers/:serverId/characters/:characterId/skill/style

Request URL

Request

Response Preview

Response Body

## Please Note > Skill enhancements through items and equipment are excluded. Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
12. Search Character "Buff Enhancement Skill Equipped Equipment" /df/servers/:serverId/characters/:characterId/skill/buff/equip/equipment

Request URL

Request

Response Preview

Response Body

## Please Note > Buff skill value information is provided based on the latest in-game login and can differ or be unavailable depending on character login circumstances. Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
13. Search Character "Buff Enhancement Skill Equipped Avatar" /df/servers/:serverId/characters/:characterId/skill/buff/equip/avatar

Request URL

Request

Response Preview

Response Body

## Please Note > Buff skill value information is provided based on the latest in-game login and can differ or be unavailable depending on character login circumstances. Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
14. Search Character "Buff Enhancement Skill Equipped Creature" /df/servers/:serverId/characters/:characterId/skill/buff/equip/creature

Request URL

Request

Response Preview

Response Body

## Please Note > Buff skill value information is provided based on the latest in-game login and can differ or be unavailable depending on character login circumstances. Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: serverId|String|**Server ID** (See /df/servers API) |Y| characterId|String|Character unique code|Y|
15. Search Item /df/items

Request URL

Request

Response Preview

Response Body

## Please Note > Can only search for items that can be currently obtained in-game. > Item image URL : https://img-api.dfoneople.com/df/items/:itemId Request Variable|Subvariable|Type|Description|Mandatory Status|Default Value|Max Value -----|----|--------|------------|---------|--------- limit||Integer|Number of returned rows||10|30 itemName||String|Item name(Requires URL encoding) itemName or hashtag input required|Y|| hashtag||String|Hashtag (Requires URL encoding) Processing values separated by commas (,)|Y|| wordType||String|Search type: Match, front, full [(see Search type for more details)](/developers/contents/guide/pages/all#dfo-item-wordtype)||match| q=|||||| |minLevel|Integer|Minimum equip level||| |maxLevel|Integer|Maximum equip level||| |rarity|String|[Item rarity](/developers/contents/guide/pages/all#dfo-item-rarity) (URL encoding required)|||
16. Search Character Fame /df/servers/:serverId/characters-fame

Request URL

Request

Response Preview

Response Body

## Please Note > Only characters Lv. 110 or above can be searched. > Only provide data of characters that have logged in within 90 days > Maximum search range will be limited to 10,000. ※ Requests for minFame : 30000, maxFame : 50000 will have it's range changed and provide results for minFame : 40000, maxFame : 50000. Request Variable|Type|Description|Mandatory Status|Default Value|Max Value -----|----|--------|:------------:|:---------:|:---------: serverId|String|[Server ID](/contents/guide/pages/all#DFO-server) : Search Server **all** : Search for all Servers |Y|| minFame|Integer|Fame bracket minimum||maxFame - 10000| maxFame|Integer|Fame bracket maximum||Highest Fame in the game (40,000 or higher)| jobId|String|Character class unique code||| jobGrowId|String|Character advancement unique code(Requires jobId)||| isAllJobGrow|Boolean|Retrieve all related advancements when jobGrowId is input||false| isBuff|Boolean|Search for Buffer only(true), Search for DPS only(false), Search all(no input)||| limit|Integer|Number of returned rows||10|200
17. Search Item Information /df/items/:itemId

Request URL

Request

Response Preview

Response Body

## Please Note > Equipment stats are shown based on Superior 100% grade values. > Titles, as an exception, are shown based on average Ordinary grade values. > Item image URL : https://img-api.dfoneople.com/df/items/:itemId >> talismanInfo buff column information note - The buff column shows information of the buff options based on Crusader (M) "Holy Ghost Mace skill acquisition status". - Included in explain / explainDetail for Crusader (F) and Enchantress. Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: itemId|String|Item unique code|Y|
18. Search Item Shop Sell Information /df/items/:itemId/shop

Request URL

Request

Response Preview

Response Body

## Please Note > Lv. 95 Epic and Lv. 100 or higher Unique/Legendary/Epic equipment sold in shops according to the in-game DFOpedia can be searched. Request Variable|Type|Description|Mandatory Status|Default Value ------------|:----:|:--------:|:------------:|:---------: itemId|String|Item unique code|Y|
19. Search Multiple Item Information /df/multi/items

Request URL

Request

Response Preview

Response Body

## Please Note >Up to 15 items can be searched. >Request for identical item IDs will result in results for only 1 case. > Example) https://api.dfoneople.com/df/multi/items?itemIds=93a1d27e36e3071154abfc063977a844,3efb6b1f6079c569c67b5dc7f13a2085 Request Variable|Subvariable|Type|Description|Mandatory Status|Default Value -----|----|--------|------------|--------- itemIds|String|Item unique code Processing values separated by commas (,)|Y|
20. Item Hashtag /df/item-hashtag

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Defaul Value|Max Value -----|----|--------|:------------:|:---------:|:---------: |||||
21. Search Set Items /df/setitems

Request URL

Request

Response Preview

Response Body

Requested Variable|Type|Description|Mandatory Status|Default Value|Max Value -----|----|--------|------------|---------|--------- setItemName|String|Set item name, use with URL encoding|Y|| limit|Integer|Number of returned rows||10|100 wordType|String|Search type: Match, front, full [(see Search type for more details)](/developers/contents/guide/pages/all#dfo-item-wordtype)|||
22. Search Set Item Information /df/setitems/:setItemId

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Valuable ------------|:----:|:--------:|:------------:|:---------: setItemId|String|Set Item Unique Code|Y|
23. Class Information /df/jobs

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status|Default Value|Max Value -----|----|--------|:------------:|:---------:|:---------: |||||
24. Skill List Per Class /df/skills/:jobId

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status -----|----|--------|------------|---------|--------- jobId|String|Character class unique code|Y jobGrowId|String|Character Awakening class unique code|Y
25. Search Skill Information Per Class /df/skills/:jobId/:skillId

Request URL

Request

Response Preview

Response Body

Request Variable|Type|Description|Mandatory Status -----|----|--------|------------|---------|--------- jobId|String|Character class unique code|Y skillId|String|Skill unique code|Y

API Docs

The following is the currently available DFO Open API list.

DFO Time Converter

Local Time