---
title: "사용자 조회"
slug: "game-gamepot-user"
tags: ["GAMEPOT"]
updated: 2026-09-17T09:16:30Z
published: 2026-09-17T09:16:30Z
canonical: "api.ncloud-docs.com/game-gamepot-user"
---

> ## 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.

# 사용자 조회

사용자 UID로 사용자를 조회합니다.

## 요청

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

| 항목 | 타입 | 필수 여부 | 설명 | 비고 |
| --- | --- | --- | --- | --- |
| projectId | String | O | GamePot SDK 의 projectId |  |
| userId | String | O | GamePot SDK의 userId |  |

### 요청 헤더

| 헤더명 | 필수 여부 | 설명 |
| --- | --- | --- |
| x-api-key | O | GamePot에서 발급하는 인증 키 |
| accept-language | X | 사용 언어 |

## 응답

| 필드명 | 타입 | 설명 |
| --- | --- | --- |
| status | Int | 결과값 (1: 성공) |
| id | String | 사용자 아이디 |
| deleted | Boolean | 회원 삭제 여부 (true : 삭제, false : 정상) |
| store_id | String | 계정 생성 시 접속한 스토어 (google...) |
| country | String | 유저 국가 코드 (ISO 3166-1 기준) |
| remoteip | String | 유저 아이피 |
| adid | String | 광고 id |
| device | String | 기기 종류 (android,ios) |
| network | String | 유저 접속 네트워크 (WI-FI...) |
| version | String | Client의 버전 정보 |
| model | String | 유저 기기 모델명 |
| token | String | 푸시 토큰 |
| push | Boolean | 푸시 동의 여부 (true : 동의, false : 비동의) |
| night | Boolean | 야간 푸시 동의 여부 (true : 동의, false : 비동의) |
| ad | Boolean | 광고성 푸시 동의 여부 (true : 동의, false : 비동의) |
| memo | String | 회원 메모 |
| device_id | String | 회원 디바이스 ID |
| createdAt | String | 회원이 생성된 날짜 |
| updatedAt | String | 회원 정보를 수정한 날짜 |
| loginedAt | String | 마지막 접속일 |
| deletedAt | String | 회원 삭제된 날짜 |
| verify | String | 본인인증 정보 |
| agree | String | 약관동의 관련 정보 |
| gdpr | String | gdpr 약관 동의 관련 정보 |

## 예시

### 요청 예시

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

### 응답 예시

```
{
  "status": 1,
  "result":{
    "id":"XXXXXXXX",
    "deleted":false,
    "store_id":"one",
    "country":"KR",
    "remoteip":"xxx.xxx.xxx.xxxx",
    "nickname":null,
    "adid":"XXXXXX-XXXX-XXXX-XXXX-XXXXXX",
    "device":"android",
    "network":"WIFI",
    "version":"11",
    "model":"SM-G977N",
    "token":"XXXXXXXX",
    "push":true,
    "push_date":{
        "on":"2023-04-21T11:22:55+09:00",
        "off":null
    },
    "night":true,
    "night_date":{
        "on":"2023-04-21T11:22:55+09:00",
        "off":"2023-04-20T11:22:58+09:00"
    },
    "ad":true,
    "memo":null,
    "device_id":"XXXXX-XXXXX-XXXXX",
    "agree":{
        "termsofuse":"Y",
        "termsofuseAt":"2023-04-21T11:22:55+09:00",
        "privacypolicy":"Y",
        "privacypolicyAt":"2023-04-21T11:22:55+09:00"
    },
    "verify":{
        "key":null,
        "updatedAt":null
    },
    "adult":null,
    "gdpr":{
        "status":4,
        "email_verified":null,
        "checked_story_category_ids":[
        "gdpr_term",
        "gdpr_privacy",
        "gdpr_push_normal",
        "gdpr_push_night"
        ]
    },
    "createdAt":"2023-04-21T11:22:55+09:00",
    "updatedAt":"2023-04-21T11:22:55+09:00",
    "loginedAt":"2023-04-21T11:22:55+09:00",
    "deletedAt":null
 }
}
```

## 오류 코드

Gamepot Open API 요청시 발생하는 공통 에러코드입니다.

| 파라미터 | 설명 |
| --- | --- |
| status | 오류 코드(1: 성공, 실패시 Error code 참고) |
| message | 오류 상세 설명 |

| 오류 코드 | 설명 |
| --- | --- |
| -1 | 대시보드에 없는 키를 사용한 경우 |
| -2 | 대시보드의 키와 헤더의 키가 다른경우 |
| -3 | 대시보드에서 삭제한 키를 사용한 경우 |
| -4 | 대시보드에서 미사용으로 처리된 키를 사용한 경우 |
| -5 | 키가 만료된 경우 |
| -6 | 프로젝트 아이디가 없는 경우 |

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