---
title: "포켓별 API Key 목록 조회"
method: GET
path: "/v1/pockets/api_keys"
tags: ["Exchange"]
---

# 포켓별 API Key 목록 조회

`GET /v1/pockets/api_keys`

## Request

- Base URL: `https://api.upbit.com`
- URL: `https://api.upbit.com/v1/pockets/api_keys`
- Auth: none declared

메인포켓의 API Key 권한을 사용하여 생성된 포켓별 API Key 목록과 정보를 조회하는 API입니다.

## Query parameters

- `uuids[]` string[]: 조회하고자 하는 포켓 UUID 배열. [예시] uuids[]=uuid1&uuids[]=uuid2
- `include_expired` boolean: 만료된 API Key를 조회 결과에 포함할지 여부

## Response `200`

List of pocket API keys

- PocketApiKeyGroup[]
  - `uuid` string, required: 포켓 UUID
  - `keys` PocketApiKey[], required: 해당 포켓에 발급된 API Key 목록
    - `access_key` string, required: API Key의 Access Key
    - `permissions` PocketApiKeyPermission[], required: API Key에 부여된 접근 권한 목록
    - `allowed_ips` string[], required: API 요청이 허용된 IP 주소 목록
    - `created_at` string, required: API Key가 생성된 일시. [형식] yyyy-MM-dd'T'HH:mm:ss+09:00
    - `expired_at` string, required: API Key의 만료 일시. [형식] yyyy-MM-dd'T'HH:mm:ss+09:00

## Other responses

- `400`: error object
- `403`: error object

---

[API](https://skmtc.dev/upbit/apis/exchange-api.md) - [All operations](https://skmtc.dev/upbit/apis/exchange-api/llms.txt) - [OpenAPI document](https://skmtc.dev/upbit/apis/exchange-api/revisions/150ea50e351c?raw)