headless문서로 돌아가기

headless Open REST API

한국 금융기관(홈택스 · 은행 · 카드사)의 거래내역 · 세금계산서 · 현금영수증을 표준 스키마로 수집하는 REST API 레퍼런스입니다. API Key 인증 후 수집 요청(data-job)을 생성하고 결과를 폴링해 내려받습니다.

엔드포인트

  • POST /api/v1/data-jobs · 수집 요청 생성
  • GET /api/v1/data-jobs · 수집 요청 목록 조회
  • GET /api/v1/data-jobs/{id} · 수집 요청 상세 조회
  • GET /api/v1/data-jobs/{id}/results · 수집 결과 조회

개발자 가이드

// POST /api/v1/data-jobs

DataJob 요청 바디

params는 선택한 schema의 요청 필드입니다. 날짜 범위가 필요한 형식은 dateRangeStart와 dateRangeEnd를 params 안에 넣습니다.

{
  "providerCode": "CB_SHINHAN",
  "schema": "bank.transactions.cb.v1",
  "params": {
    "dateRangeStart": "2026-01-01",
    "dateRangeEnd": "2026-01-31"
  }
}
전체 request/response body 보기
schemaId필수 params선택 params상세
bank.accounts.cb.v1
계좌 목록
없음없음응답 body
bank.transactions.cb.v1
입출금내역
dateRangeStartdatedateRangeEnddate
accountNumberarray<string>currencyCodestring
응답 body
card.approvals.corp.v1
법인카드 승인내역
dateRangeStartdatedateRangeEnddate
cardNumberMaskedarray<string>
응답 body
card.cards.corp.v1
법인카드 보유카드
없음없음응답 body
hometax.cash-receipts.purchase.v1
매입 현금영수증
dateRangeStartdatedateRangeEnddate
없음응답 body
hometax.cash-receipts.sales.v1
매출 현금영수증
dateRangeStartdatedateRangeEnddate
없음응답 body
hometax.tax-invoices.purchase.v1
매입 전자(세금)계산서
dateRangeStartdatedateRangeEnddate
없음응답 body
hometax.tax-invoices.sales.v1
매출 전자(세금)계산서
dateRangeStartdatedateRangeEnddate
없음응답 body