# 은행코드 조회



은행별 금융결제원 공식 코드번호를 조회합니다.



인증: Authorization: Bearer $APICK_API_KEY

본문 있는 REST 요청: multipart/form-data. GET 본문 및 MCP JSON-RPC 규격은 해당 명세를 따릅니다.

인증키는 서버에 보관하세요. 모든 예제는 정적 자료입니다.



## POST /rest/bank_code 응답 필드

- `data` (object): 조회 데이터

- `data.result` (array): 은행 코드 목록

- `data.result[].code` (string): 은행 코드

- `data.result[].content` (string): 은행명

- `data.success` (integer): 과금 여부0: 실패1: 성공3: 실패(timeout)

- `api` (object): API 호출 공통 데이터

- `api.success` (boolean): API 서버 정상 응답 여부

- `api.cost` (integer): API 호출 요금

- `api.ms` (integer): API 응답 시간

- `api.pl_id` (integer): API 결제 로그 ID

## API 요청: POST /rest/bank_code



### 입력

- `없음` (string, 선택): 



### 응답 명세

```json

{
  "type": "object",
  "properties": {
    "data": {
      "type": "object",
      "properties": {
        "result": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "code": {
                "type": "string",
                "description": "은행 코드"
              },
              "content": {
                "type": "string",
                "description": "은행명"
              }
            }
          },
          "description": "은행 코드 목록"
        },
        "success": {
          "type": "integer",
          "description": "과금 여부0: 실패1: 성공3: 실패(timeout)"
        }
      },
      "description": "조회 데이터"
    },
    "api": {
      "type": "object",
      "properties": {
        "success": {
          "type": "boolean",
          "description": "API 서버 정상 응답 여부"
        },
        "cost": {
          "type": "integer",
          "description": "API 호출 요금"
        },
        "ms": {
          "type": "integer",
          "description": "API 응답 시간"
        },
        "pl_id": {
          "type": "integer",
          "description": "API 결제 로그 ID"
        }
      },
      "description": "API 호출 공통 데이터"
    }
  }
}

```

### 정적 응답 예시

```json

{
  "data": {
    "result": [
      {
        "code": "088",
        "content": "신한"
      },
      {
        "code": "035",
        "content": "제주"
      },
      {
        "code": "004",
        "content": "국민"
      },
      {
        "code": "003",
        "content": "기업"
      },
      {
        "code": "011",
        "content": "농협"
      },
      {
        "code": "002",
        "content": "산업"
      },
      {
        "code": "007",
        "content": "수협"
      },
      {
        "code": "048",
        "content": "신협"
      },
      {
        "code": "020",
        "content": "우리"
      },
      {
        "code": "081",
        "content": "하나"
      },
      {
        "code": "027",
        "content": "한국씨티"
      },
      {
        "code": "090",
        "content": "카카오뱅크"
      },
      {
        "code": "089",
        "content": "케이뱅크"
      },
      {
        "code": "092",
        "content": "토스뱅크"
      },
      {
        "code": "039",
        "content": "경남"
      },
      {
        "code": "034",
        "content": "광주"
      },
      {
        "code": "031",
        "content": "아이엠뱅크(대구)"
      },
      {
        "code": "032",
        "content": "부산"
      },
      {
        "code": "037",
        "content": "전북"
      },
      {
        "code": "030",
        "content": "회원수협"
      },
      {
        "code": "045",
        "content": "새마을"
      },
      {
        "code": "071",
        "content": "우체국"
      },
      {
        "code": "050",
        "content": "저축은행"
      },
      {
        "code": "012",
        "content": "지역농.축협"
      },
      {
        "code": "055",
        "content": "도이치"
      },
      {
        "code": "063",
        "content": "중국"
      },
      {
        "code": "067",
        "content": "중국건설"
      },
      {
        "code": "062",
        "content": "중국공상"
      },
      {
        "code": "061",
        "content": "BNP파리바"
      },
      {
        "code": "060",
        "content": "BOA"
      },
      {
        "code": "054",
        "content": "HSBC"
      },
      {
        "code": "057",
        "content": "JP모간"
      },
      {
        "code": "023",
        "content": "SC"
      },
      {
        "code": "064",
        "content": "산림조합"
      },
      {
        "code": "278",
        "content": "신한투자증권"
      },
      {
        "code": "261",
        "content": "교보증권"
      },
      {
        "code": "227",
        "content": "다올투자증권"
      },
      {
        "code": "267",
        "content": "대신증권"
      },
      {
        "code": "287",
        "content": "메리츠증권"
      },
      {
        "code": "238",
        "content": "미래에셋증권"
      },
      {
        "code": "290",
        "content": "부국증권"
      },
      {
        "code": "240",
        "content": "삼성증권"
      },
      {
        "code": "221",
        "content": "상상인증권"
      },
      {
        "code": "291",
        "content": "신영증권"
      },
      {
        "code": "266",
        "content": "에스케이증권"
      },
      {
        "code": "209",
        "content": "유안타증권"
      },
      {
        "code": "280",
        "content": "유진투자증권"
      },
      {
        "code": "265",
        "content": "LS증권"
      },
      {
        "code": "288",
        "content": "카카오페이증권"
      },
      {
        "code": "292",
        "content": "케이프투자증권"
      },
      {
        "code": "264",
        "content": "키움증권"
      },
      {
        "code": "271",
        "content": "토스증권"
      },
      {
        "code": "294",
        "content": "우리투자증권"
      },
      {
        "code": "270",
        "content": "하나증권"
      },
      {
        "code": "262",
        "content": "아이엠증권"
      },
      {
        "code": "243",
        "content": "한국투자증권"
      },
      {
        "code": "269",
        "content": "한화투자증권"
      },
      {
        "code": "263",
        "content": "현대차증권"
      },
      {
        "code": "224",
        "content": "BNK투자증권"
      },
      {
        "code": "279",
        "content": "DB증권"
      },
      {
        "code": "225",
        "content": "IBK투자증권"
      },
      {
        "code": "218",
        "content": "KB증권"
      },
      {
        "code": "247",
        "content": "NH투자증권"
      }
    ],
    "success": 1
  },
  "api": {
    "success": true,
    "cost": 0,
    "ms": 431,
    "pl_id": -1
  }
}

```

### curl

```curl

printf '%s\r\n' '--apick-empty--' | curl --fail-with-body --request POST 'https://apick.app/rest/bank_code' \
  --header "Authorization: Bearer $APICK_API_KEY" \
  --header 'Content-Type: multipart/form-data; boundary=apick-empty' \
  --data-binary @-

```

### Node.js (서버 ESM)

```javascript

const form = new FormData();
const response = await fetch("https://apick.app/rest/bank_code", {
  method: "POST",
  headers: { Authorization: "Bearer " + process.env.APICK_API_KEY },
  body: form,
  signal: AbortSignal.timeout(120_000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}: ${await response.text()}`);
const result = await response.json();
console.log(result);

```

### python

```python

import os
import requests
response = requests.request("POST", "https://apick.app/rest/bank_code",
    headers={"Authorization": "Bearer " + os.environ["APICK_API_KEY"], "Content-Type": "multipart/form-data; boundary=apick-empty"},
    data=b"--apick-empty--\r\n",
    timeout=(10, 120))
response.raise_for_status()
result = response.json()
print(result)

```

### php

```php

<?php
$headers = ["Authorization: Bearer " . getenv("APICK_API_KEY")];
$headers[] = "Content-Type: multipart/form-data; boundary=apick-empty";
$form = "--apick-empty--\r\n";
$curl = curl_init('https://apick.app/rest/bank_code');
curl_setopt_array($curl, [
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => $headers,
    CURLOPT_POSTFIELDS => $form,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CONNECTTIMEOUT => 10, CURLOPT_TIMEOUT => 120,
]);
$body = curl_exec($curl);
if ($body === false) { throw new RuntimeException(curl_error($curl)); }
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
curl_close($curl);
if ($status >= 400) { throw new RuntimeException($body); }
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result);

```

## 코드·오류

## 상세 기능·요금

Method URL POST https://apick.app/rest/bank_code 저축은행(050) 포함 기관 저축은행 계좌는 기관별 코드가 따로 나뉘지 않고 050 하나로 조회됩니다. 아래 79개 저축은행이 모두 050에 포함되며, bank_code=050으로 조회할 수 있습니다. 권역 포함 저축은행 서울 (23개) DB, JT친애, KB, NH, OK, OSB, SBI, 대신, 더케이, 민국, HB, 스카이, 바로, 신한, 애큐온, 예가람, 웰컴, 유안타, 다올, 조은, 키움예스, 푸른, 하나 인천/경기 (19개) JT, 금화, 남양, 모아, 부림, 삼정, 상상인, 세람, 안국, 안양, 영진, 융창, 인성, 인천, 키움, 페퍼, 평택, 한국투자, 한화 부산/경남 (12개) BNK, DH, IBK, 고려, 국제, 동원제일, 솔브레인, 에스앤티, 우리, 조흥, 진주, 흥국 대구/경북/강원 (11개) CK, 대백, 대아, 대원, 드림, 라온, 머스트삼일, 엠에스, 오성, 유니온, 참 광주/전남/전북/제주 (7개) 대한, 라인, 동양, 삼호, 센트럴, 스마트, 스타 대전/충남/충북 (7개) 대명, 상상인플러스, 아산, 우리금융, 오투, 청주, 한성

## 상세 요청

Header 이름 필수 설명 Authorization O Bearer 인증키

## 상세 응답

Body 이름 타입 설명 data Object 조회 데이터 result Array 은행 코드 목록 {} Object 은행 코드 정보 code String 은행 코드 content String 은행명 success Integer 과금 여부0: 실패1: 성공3: 실패(timeout) api Object API 호출 공통 데이터 success Boolean API 서버 정상 응답 여부 cost Integer API 호출 요금 ms Integer API 응답 시간 pl_id Integer API 결제 로그 ID

## 상세 예제

요청 예시 form-data 전체 예제 보기 응답 예시 { "data": { "result": [ { "code": "088", "content": "신한" }, { "code": "035", "content": "제주" }, { "code": "004", "content": "국민" }, { "code": "003", "content": "기업" }, { "code": "011", "content": "농협" }, { "code": "002", "content": "산업" }, { "code": "007", "content": "수협" }, { "code": "048", "content": "신협" }, { "code": "020", "content": "우리" }, { "code": "081", "content": "하나" }, { "code": "027", "content": "한국씨티" }, { "code": "090", "content": "카카오뱅크" }, { "code": "089", "content": "케이뱅크" }, { "code": "092", "content": "토스뱅크" }, { "code": "039", "content": "경남" }, { "code": "034", "content": "광주" }, { "code": "031", "content": "아이엠뱅크(대구)" }, { "code": "032", "content": "부산" }, { "code": "037", "content": "전북" }, { "code": "030", "content": "회원수협" }, { "code": "045", "content": "새마을" }, { "code": "071", "content": "우체국" }, { "code": "050", "content": "저축은행" }, { "code": "012", "content": "지역농.축협" }, { "code": "055", "content": "도이치" }, { "code": "063", "content": "중국" }, { "code": "067", "content": "중국건설" }, { "code": "062", "content": "중국공상" }, { "code": "061", "content": "BNP파리바" }, { "code": "060", "content": "BOA" }, { "code": "054", "content": "HSBC" }, { "code": "057", "content": "JP모간" }, { "code": "023", "content": "SC" }, { "code": "064", "content": "산림조합" }, { "code": "278", "content": "신한투자증권" }, { "code": "261", "content": "교보증권" }, { "code": "227", "content": "다올투자증권" }, { "code": "267", "content": "대신증권" }, { "code": "287", "content": "메리츠증권" }, { "code": "238", "content": "미래에셋증권" }, { "code": "290", "content": "부국증권" }, { "code": "240", "content": "삼성증권" }, { "code": "221", "content": "상상인증권" }, { "code": "291", "content": "신영증권" }, { "code": "266", "content": "에스케이증권" }, { "code": "209", "content": "유안타증권" }, { "code": "280", "content": "유진투자증권" }, { "code": "265", "content": "LS증권" }, { "code": "288", "content": "카카오페이증권" }, { "code": "292", "content": "케이프투자증권" }, { "code": "264", "content": "키움증권" }, { "code": "271", "content": "토스증권" }, { "code": "294", "content": "우리투자증권" }, { "code": "270", "content": "하나증권" }, { "code": "262", "content": "아이엠증권" }, { "code": "243", "content": "한국투자증권" }, { "code": "269", "content": "한화투자증권" }, { "code": "263", "content": "현대차증권" }, { "code": "224", "content": "BNK투자증권" }, { "code": "279", "content": "DB증권" }, { "code": "225", "content": "IBK투자증권" }, { "code": "218", "content": "KB증권" }, { "code": "247", "content": "NH투자증권" } ], "success": 1 }, "api": { "success": true, "cost": 0, "ms": 431, "pl_id": -1 } }