API 레퍼런스  >  은행 연동

계좌 상세 조회

등록된 계좌 한 건의 상세 정보를 조회합니다.

GET https://dev.sendbill.co.kr:444/api/v1/accounts/{settingId}

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
1 settingId Long Y 계좌 설정 ID (Path). 계좌 등록·목록 조회 응답의 settingId 1 이상의 숫자
Request 샘플 ›
Request 샘플
GET https://api.sendbill.co.kr/api/v1/accounts/65

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Accept-Charset: UTF-8

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 code Integer 처리 결과 코드. 성공 시 200, 실패 시 음수
2 data Object 계좌 정보
3 data.settingId Long 계좌 설정 ID
4 data.bankCode String 은행 코드
5 data.collectCycle Integer 수집 주기 (분 단위)
6 data.accountType Integer 계좌 유형. 1 = 개인, 2 = 법인
7 data.accountAlias String 계좌 별칭. 없으면 null
8 data.accountUsage String 계좌 용도. 없으면 null
9 data.accountNo String 마스킹된 계좌번호
10 data.bankAuth Object 인증 정보. 비밀번호·본인확인 값은 반환하지 않음
11 data.bankAuth.searchType Integer 인증 방식. 1 = 웹 로그인, 2 = 본인확인
12 data.bankAuth.webId String 마스킹된 인터넷뱅킹 아이디. 본인확인 방식이면 null
13 data.bankAuth.identityType Integer 본인확인 유형. 웹 로그인 방식이면 null
14 data.createdAt String 등록일시 (YYYY-MM-DD HH:MM:SS)
15 data.updatedAt String 수정일시 (YYYY-MM-DD HH:MM:SS). 수정 전이면 null
Response JSON 샘플 › 
{
    "code": 200,
    "data": {
        "settingId": 65,
        "bankCode": "KB",
        "collectCycle": 1,
        "accountType": 2,
        "accountAlias": "운영자금",
        "accountUsage": "급여 지급",
        "accountNo": "123*******1234",
        "bankAuth": {
            "searchType": 1,
            "webId": "te*****r",
            "identityType": null
        },
        "createdAt": "2026-10-15 10:20:30",
        "updatedAt": null
    }
}