API 레퍼런스  >  은행 연동

계좌 목록 조회

SBKEY 업체에 등록된 계좌 목록을 조회합니다. 페이징 없이 전체 목록을 최근 등록 순으로 반환합니다.

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

Request

Request 항목 명세 ›
No 변수명 타입 길이 필수 설명 비고
요청 파라미터 없음. 경로·쿼리 파라미터와 요청 Body를 사용하지 않습니다.
Request 샘플 ›
Request 샘플
GET https://api.sendbill.co.kr/api/v1/accounts

SBKEY: xxxxxxxxxxxxxxxxxxxxxxxxx
Accept-Charset: UTF-8

Response

Response 항목 명세 ›
NO 변수명 타입 설명
1 code Integer 처리 결과 코드. 성공 시 200, 실패 시 음수
2 data.totalCount Long 계좌 수
3 data.items Array 계좌 목록
4 data.items[].settingId Long 계좌 설정 ID
5 data.items[].accountNo String 마스킹된 계좌번호
6 data.items[].bankCode String 은행 코드
7 data.items[].accountAlias String 계좌 별칭. 없으면 null
8 data.items[].accountUsage String 계좌 용도. 없으면 null
Response JSON 샘플 ›
{
    "code": 200,
    "data": {
        "totalCount": 1,
        "items": [
            {
                "settingId": 65,
                "accountNo": "123*******1234",
                "bankCode": "KB",
                "accountAlias": "운영자금",
                "accountUsage": "급여 지급"
            }
        ]
    }
}