---
title: "Character inquiry"
slug: "game-gamepot-player"
tags: ["GAMEPOT"]
updated: 2026-09-17T10:05:44Z
published: 2026-09-17T10:05:44Z
canonical: "api.ncloud-docs.com/game-gamepot-player"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Character inquiry

**We are preparing a localization service for the content. We will do our best to provide the localization service as soon as possible.**

Retrieves the in-game player ID.

## request

```
GET https://dashboard-api.gamepot.ntruss.com/v1/api/project/{projectId}/player/{playerID}
```

| Item | type | Required | Explanation | 비고 |
| --- | --- | --- | --- | --- |
| projectId | String | O | ProjectId in GamePot SDK |  |
| playerID | String | O | Player ID of GamePot SDK |  |

### Request header

| Header name | Required | Explanation |
| --- | --- | --- |
| x-api-key | O | Authentication key issued by GamePot |
| accept-language | X | Language used |

## answer

| Field name | type | Explanation |
| --- | --- | --- |
| status | Int | Result value (1: success) |
| id | String | User ID |
| player_id | String | Player ID |
| server_id | String | Server ID |
| name | String | Player name |
| level | String | Player level |
| userdata | String | Registered Userdata |
| ip | String | Player ip |
| createdAt | String | Player creation date |
| updatedAt | String | Player update date |
| user_id | String | Gamepot UID |

## example

### Request example

```

curl --request GET \
  --url https://dashboard-api.gamepot.ntruss.com/v1/api/project/12a0f2ff-xxxx-xxxx-xxxx-9c13ef02f5fs/player/dodo  \
  --header 'accept-language: ko' \
  --header 'x-api-key: 86dcgffae0641745432as02a8801ce5a5475f764fxxxxxxxxx'
```

### Example response

```
{
  "status": 1,
  "result": {
    "id": "xxxxxxxxxxxxxxx",
    "player_id": "Test ID",
    "server_id": "Test server",
    "name": "Test name",
    "level": "12",
    "userdata": "dododo",
    "ip": "xxx.xxx.xxx.xxx",
    "createdAt": "Fri Feb 21 2020 14:15:33 GMT+0900 (GMT+09:00)",
    "updatedAt": "Fri Feb 21 2020 14:15:33 GMT+0900 (GMT+09:00)",
    "user_id": "xxxxxxxxxxxxxxx"
  }
}
```

## Error code

Common error code that occurs when requesting Gamepot Open API.

| parameter | Explanation |
| --- | --- |
| status | Error code (1: Refer to Error code in case of success or failure ) |
| message | Error details |

| Error code | Explanation |
| --- | --- |
| -1 | If you used a key that is not on the dashboard |
| -2 | The key of the dashboard and the key of the header are different. |
| -3 | When using a key deleted from the dashboard |
| -4 | The dashboard used unused keys. |
| -5 | If the key has expired |
| -6 | If there is no project ID |

```
{
  "status": -6,
  "message": "projectId was wrong."
}
```