---
title: "사용자 정지 조회"
slug: "game-gamepot-userblockget"
updated: 2026-09-17T09:16:30Z
published: 2026-09-17T09:16:30Z
canonical: "api.ncloud-docs.com/game-gamepot-userblockget"
---

> ## 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}/block
```

| 항목 | 타입 | 필수 여부 | 설명 | 비고 |
| --- | --- | --- | --- | --- |
| 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 | 사용자 정지 정보에 대한 아이디 |
| member_id | String | 사용자 아이디 |
| deleted | Boolean | 사용자 정지 정보에 대한 삭제 유무 (true: 삭제, false: 정상) |
| type | String | 이용정지 분류 (manual: 수동, autopurchase: 자동) |
| status | Int | 상태 (1: 활성, 2: 비활성) |
| message | String | 이용정지 사유 (현재 사용되지 않음) |
| lang | String | 이용정지 메시지 언어 |
| value | String | 이용정지 사유 메시지 |
| default | Boolean | 기본 언어 설정 (디바이스의 언어값이 messageMulti에 없는 경우 true로 설정된 메시지가 기본으로 노출됨) |
| startedAt | String | 이용정지 시작일 |
| endedAt | String | 이용정지 종료일 |
| createdAt | Boolean | 이용정지 등록일 |
| updatedAt | Boolean | 이용정지 수정일 |
| deletedAt | Boolean | 이용정지 삭제일 |
| category_id | String | 이용정지 분류 아이디 |

## 예시

### 요청 예시

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

### 응답 예시

```
{
  "status": 1,
  "result": {
    "id": "xxxxxxxxxxxxxx",
    "member_id": "xxxxxxxxxxxxxx",
    "deleted": false,
    "type": "manual",
    "status": 1,
    "message": null,
    "messageMulti": [
      {
        "lang": "ko",
        "value": "테스트-ko",
        "default": true
      }
    ],
    "startedAt": "Mon May 11 2020 12:02:00 GMT+0900 (GMT+09:00)",
    "endedAt": "Mon May 25 2020 22:00:00 GMT+0900 (GMT+09:00)",
    "createdAt": "Tue May 12 2020 14:06:40 GMT+0900 (GMT+09:00)",
    "updatedAt": "Tue May 12 2020 14:06:40 GMT+0900 (GMT+09:00)",
    "deletedAt": null,
    "category_id": ""
  }
}
```

## 오류 코드

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

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

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

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