API 레퍼런스  >  은행 연동

카드 목록 조회

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

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

Request

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

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[].cardNo String 마스킹된 카드번호
6 data.items[].bankCode String 카드사 코드
7 data.items[].cardAlias String 카드 별칭. 없으면 null
8 data.items[].cardUsage String 카드 용도. 없으면 null
Response JSON 샘플 › 
{
    "code": 200,
    "data": {
        "totalCount": 1,
        "items": [
            {
                "settingId": 12,
                "cardNo": "411*********1111",
                "bankCode": "SHINHAN_CARD",
                "cardAlias": "법인카드1",
                "cardUsage": "출장비"
            }
        ]
    }
}