개발자 문서
API 레퍼런스

계좌 - 신한은행 간편조회

1. 신한은행 간편조회 계좌 목록 조회shinhan_easy.accounts.list

MCP 도구 이름 shinhan_easy__accounts__list

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

연결된 신한 계좌를 계좌번호와 별칭, 계좌 과목까지 한 번에 나열합니다.

  • 세션 로그인 없이 호출합니다. 조회할 때마다 콘솔에 등록한 신한은행 간편조회 아이디와 비밀번호로 로그인합니다. [신한은행 간편조회 로그인]
  • include_raw(기관 원본 값 포함 여부)는 선택입니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • shinhan_easy이 API 고정값 (기본값)

예시 : shinhan_easy

actionstring-Y호출할 작업입니다.
  • shinhan_easy.accounts.list이 API 고정값 (기본값)

예시 : shinhan_easy.accounts.list

account_link_idstring36Y등록한 자격증명을 가리키는 아이디입니다. 이 기관은 자격증명을 자동으로 고르지 않으므로 생략할 수 없습니다. 생략하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-N작업 파라미터입니다. 이 API 는 빈 객체로 호출할 수 있습니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
include_rawbooleanN기관 원본 응답을 결과의 raw 칸에 담을지 정하는 값으로, 보내지 않으면 true 입니다. 지금 조회 경로는 이 값을 쓰지 않습니다. raw 칸은 이 값과 관계없이 null 입니다
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: list-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "shinhan_easy",
  "action": "shinhan_easy.accounts.list",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {}
}'

Response

  • 아래 표의 칸은 작업이 SUCCEEDED 가 된 뒤 GET /v1/jobs/{job_id}/result 의 result.data 에 오고, 응답 예시는 작업을 제출했을 때(POST /v1/jobs)의 응답입니다.
  • result.data 의 accounts 로 연결된 계좌 목록을(계좌번호, 별칭, 계좌 과목) 확인합니다. 계좌가 없으면 accounts 는 빈 목록이고 count 는 0 입니다.
순번변수명타입설명
successboolean요청 처리 성공 여부
account_link_idstring연동 ID
countnumber조회된 계좌 수(계좌가 없으면 0)
accountsarray계좌 목록 - 계좌번호·별칭·계좌 과목을 담습니다
rawobject | null기관 원본 응답 자리 - 지금 조회 경로는 원본을 싣지 않아 include_raw 와 상관없이 null 입니다
json
{
    "job_id": "job_01JC8YH8R0E1ABCDEFGHJKMNPQ",
    "status": "QUEUED",
    "env_scope": "real_test",
    "provider": "shinhan_easy",
    "action": "shinhan_easy.accounts.list",
    "submitted_at": "2026-05-27T12:34:56+09:00"
}
순번오류 코드발생 조건
POLICY_FEATURE_DISABLED상품 실행 잠금 — 현재 이 상품은 일시 중지 상태라 요청을 처리하지 못했습니다. 다시 시도해도 해결되지 않으니 서비스문의로 알려 주세요. retryable=false.
PROVIDER_AUTH_FAILED로그인 실패 — 등록한 아이디와 비밀번호로 신한은행 인증에 실패했습니다. retryable=false.
VALIDATION_INVALID_FIELD입력값 오류 — 보낸 값이 이 액션의 요청 형식과 맞지 않습니다. 필수 칸이 빠졌거나 타입이나 범위가 맞지 않는 경우입니다.
PROVIDER_UNAVAILABLE그 밖의 오류 — 그 밖의 신한은행 오류입니다. retryable=true 로 표시되지만 원인이 값 자체라면 재시도로 풀리지 않습니다 - 메시지를 먼저 확인합니다.

MCP 도구 이름 shinhan_easy__accounts__transaction_history__search

POSThttps://api.xdata.kr/v1/jobsX-Env-Scope: real_test

현재 혜택은 요금제에서 확인해 주세요. 현재 데모 정책과 계정의 남은 양을 확인해 주세요.

기간을 지정해 신한 계좌의 입출금 내역을 건별로 받습니다.

  • 세션 로그인 없이 호출합니다. 조회할 때마다 콘솔에 등록한 신한은행 간편조회 아이디와 비밀번호로 로그인하고, bank_account_credential_id 로 고른 계좌의 등록 비밀번호를 함께 씁니다. [신한은행 간편조회 로그인]
  • sort_order(기본값 desc)·business_type·employee_yn·max_pages(기본값 20)·include_raw 는 모두 선택입니다.

Request

순번변수명필수설명
AuthorizationYAPI 자격증명입니다. client_id 와 client_secret 을 콜론으로 이어 Base64 로 인코딩해 보냅니다.

형식 : Basic base64("{client_id}:{client_secret}")

[참고] 인증

X-Env-ScopeY호출 환경입니다.
  • real_test데모 — 현재 데모 한도 확인 필요
  • production정식 — 현재 공개 요금제 전용

[참고] 환경

Idempotency-KeyY재시도 식별 키입니다. 같은 키와 같은 본문으로 다시 호출하면 기존 작업이 그대로 반환됩니다. ASCII 문자만 사용하며 UUID v4 를 권장합니다. 고객 정보는 넣지 않습니다.

[참고] 재시도

Content-TypeY요청 본문 형식입니다.
  • application/json고정값 (기본값)
X-Trace-IdN추적 아이디입니다. 지정하지 않으면 서버가 발급합니다.
순번변수명타입길이필수설명
providerstring-Y호출할 기관입니다.
  • shinhan_easy이 API 고정값 (기본값)

예시 : shinhan_easy

actionstring-Y호출할 작업입니다.
  • shinhan_easy.accounts.transaction_history.search이 API 고정값 (기본값)

예시 : shinhan_easy.accounts.transaction_history.search

account_link_idstring36Y등록한 자격증명을 가리키는 아이디입니다. 이 기관은 자격증명을 자동으로 고르지 않으므로 생략할 수 없습니다. 생략하거나 지정한 아이디를 쓸 수 없으면 접수 단계에서 400 VALIDATION_INVALID_FIELD 로 거절되고 작업은 만들어지지 않습니다. 이유와 할 일은 error.message 의 한국어 문장에 있습니다.

형식 : UUID v4

[참고] 자격증명 등록

paramsobject-Y작업 파라미터입니다. 아래 params 파라미터 표의 필수 항목을 채워 보냅니다.
encrypted_fieldsobject-N민감한 params 값을 RSA-OAEP-256 으로 암호화해 담는 객체입니다. 서버가 복호화해 params 에 합칩니다. 같은 이름을 params 와 함께 쓰지 않습니다.

[참고] 암호화

순번변수명타입필수설명
bank_account_credential_idstringY조회할 계좌의 ID 입니다. shinhan_easy.linked_accounts.list 결과의 links[].accounts[].bank_account_credential_id 값을 그대로 보내며, 요청의 account_link_id 연동에 등록된 사용 중인 계좌여야 합니다
start_datestringY조회 시작일입니다. YYYY-MM-DD 나 YYYYMMDD 형식으로 보내며 end_date 보다 늦을 수 없고, 형식이 맞지 않거나 순서가 거꾸로이면 거절합니다. 오늘(한국 시각)로부터 6개월 전보다 앞선 날짜는 입력 오류로 거절합니다
end_datestringY조회 종료일입니다. 형식은 start_date 와 같고 start_date 보다 빠를 수 없습니다
sort_orderstringN거래 정렬 순서로 desc 나 asc 를 보내며, 보내지 않으면 desc 입니다. desc 는 최근 거래부터, asc 는 오래된 거래부터 거래 일시 순으로 정렬해 돌려줍니다. 보낸 값은 결과의 query.sort_order 에 그대로 실립니다

예시 : desc

business_typestringN기관 거래내역 조회의 업무구분 값으로, 보내지 않으면 2 입니다. 지금 조회 경로는 이 값을 쓰지 않습니다

예시 : 2

employee_ynstringN기관 거래내역 조회의 직원여부 값으로, 보내지 않으면 2 입니다. 지금 조회 경로는 이 값을 쓰지 않습니다

예시 : 2

max_pagesnumberN이어서 받을 최대 쪽 수입니다. 1 이상 100 이하의 정수여야 하며 범위 밖이면 거절하고, 보내지 않으면 20 입니다. 지금 조회 경로는 이 값을 쓰지 않습니다

예시 : 20

include_rawbooleanN기관이 돌려준 거래 원본 줄을 결과의 rows_raw 칸에 담을지 정합니다. 보내지 않으면 true 이고, false 이면 rows_raw 는 빈 목록입니다. raw 칸은 이 값과 관계없이 null 입니다
output_formatsarrayN이 결과를 엑셀(xlsx) 파일로도 받으려면 적습니다. 예: ["xlsx"]. 파일은 result.artifacts 에 함께 오고, 빼면 데이터만 옵니다
  • 「<필수>」 자리는 예시 값이 없는 필수 칸입니다. 위 파라미터 표를 보고 실제 값으로 바꿔 보냅니다.
bash
curl --request POST \
  --url 'https://api.xdata.kr/v1/jobs' \
  --header 'Authorization: Basic {base64(client_id:client_secret)}' \
  --header 'X-Env-Scope: real_test' \
  --header "Idempotency-Key: search-$(date +%s)-$RANDOM" \
  --header 'Content-Type: application/json' \
  --data '{
  "provider": "shinhan_easy",
  "action": "shinhan_easy.accounts.transaction_history.search",
  "account_link_id": "9b4c3a2f-0000-4000-8000-000000000000",
  "params": {
    "bank_account_credential_id": "<필수>",
    "start_date": "<필수>",
    "end_date": "<필수>",
    "sort_order": "desc",
    "business_type": "2",
    "employee_yn": "2",
    "max_pages": 20
  }
}'

Response

  • result.data 의 rows 로 입출금 내역을 건별로 확인합니다.
  • 여러 JSON 타입이 함께 표시된 칸은 서버가 세부 타입을 고정하지 않는 기관 원문 또는 동적 값입니다.
순번변수명타입설명
successboolean조회를 마쳤다는 표지입니다. 성공 응답에서는 항상 true 입니다.
account_link_idstring조회에 쓴 연동의 ID 입니다. 요청에 보낸 값입니다.
queryobject이번 조회에 실제로 쓴 조건입니다.
query.bank_account_credential_idstring조회한 계좌의 ID 입니다. 요청에 보낸 값입니다.
query.masked_account_nostring가려진 계좌번호입니다. account.account_no 와 같은 값입니다.
query.start_datestring조회 시작일입니다. 요청에 보낸 값을 YYYY-MM-DD 모양으로 맞춘 문자열입니다.
query.end_datestring조회 종료일입니다. 요청에 보낸 값을 YYYY-MM-DD 모양으로 맞춘 문자열입니다.
query.sort_orderstring정렬 방향입니다. 요청에서 쓴 값(desc 또는 asc)이고, 보내지 않으면 desc 입니다.
accountobject조회한 계좌의 요약입니다. 지금 조회 경로에서는 account_no, account_no_display, legacy_account_no, raw_fields 네 칸만 담깁니다.
account.account_nostring가려진 계좌번호입니다.
account.account_no_displaystring가려진 계좌번호입니다. account_no 와 같은 값입니다.
account.bank_typestring | number | boolean | object | array | null기관의 「은행구분」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.legacy_account_nonull구 계좌번호 칸입니다. 이 응답에서는 항상 null 입니다.
account.legacy_account_enabledstring | number | boolean | object | array | null기관의 「구계좌사용여부」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.account_namestring | null기관의 「계좌명」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.balancenumber | null계좌 잔액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.balance_displaystring | null기관 화면에 보이는 모양의 계좌 잔액입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.customer_namestring | null기관의 「고객명」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.withdrawable_amountnumber | null출금 가능 금액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.withdrawable_amount_displaystring | null기관 화면에 보이는 모양의 출금 가능 금액입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.open_datestring | null계좌 신규 일자입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.open_date_displaystring | null기관 화면에 보이는 모양의 신규 일자입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.branch_namestring | null기관의 「계좌관리점」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.final_transaction_datestring | null최종 거래 일자입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.final_transaction_date_displaystring | null기관 화면에 보이는 모양의 최종 거래 일자입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.continuation_start_nostring | number | boolean | object | array | null기관의 「연속시작번호」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.continuation_sub_start_nostring | number | boolean | object | array | null기관의 「연속SUB시작번호」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.has_transaction_history_flagstring | number | boolean | object | array | null기관의 「거래내역여부」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.query_start_datestring | null기관이 알려 준 조회 시작일입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.query_start_date_displaystring | null기관 화면에 보이는 모양의 조회 시작일입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.query_end_datestring | null기관이 알려 준 조회 종료일입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.query_end_date_displaystring | null기관 화면에 보이는 모양의 조회 종료일입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.query_datestring | null기관이 알려 준 조회 일자입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.query_date_displaystring | null기관 화면에 보이는 모양의 조회 일자입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.query_timestring | null기관의 「조회시간」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.query_time_displaystring | null기관 화면에 보이는 모양의 조회 시간입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.repeat_countstring | number | boolean | object | array | null기관의 「반복횟수」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다. 지금 조회 경로에서는 이 칸이 오지 않습니다.
account.raw_fieldsobject항상 빈 객체입니다. 계좌 요약의 기관 원본은 담지 않습니다.
countnumberrows 에 담긴 거래의 건수입니다.
rowsarray거래내역 목록입니다. 조건에 맞는 거래가 없으면 빈 배열입니다. 지금 조회 경로에서는 sort_order 와 관계없이 기관 화면이 준 순서 그대로입니다.
rows[].transaction_datestring | null거래 일자입니다. 8자리 숫자 날짜는 YYYY-MM-DD 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다.
rows[].transaction_date_displaystring | null기관 화면에 보이는 모양의 거래 일자입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].transaction_timestring | null거래 시각입니다. 6자리 숫자 시각은 HH:MM:SS 로 바꾼 문자열이고, 그 모양이 아니면 앞뒤 공백을 뗀 기관 값이며, 비어 있으면 null 입니다.
rows[].transaction_time_displaystring | null기관 화면에 보이는 모양의 거래 시각입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].summarystring | null기관의 「적요」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].withdrawal_amountnumber | null출금액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다.
rows[].withdrawal_amount_displaystring | null기관 화면에 보이는 모양의 출금액입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].deposit_amountnumber | null입금액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다.
rows[].deposit_amount_displaystring | null기관 화면에 보이는 모양의 입금액입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].descriptionstring | null기관의 「내용」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].balancenumber | null그 거래 건의 잔액입니다. 숫자로 바꾼 값이고, 기관 값이 비었거나 숫자로 읽을 수 없으면 null 입니다.
rows[].balance_displaystring | null기관 화면에 보이는 모양의 거래 건 잔액입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].branch_or_channelstring | null기관의 「거래점」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].inout_codestring | number | boolean | object | array | null기관의 「입지구분」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].transaction_nostring | number | boolean | object | array | null기관의 「거래번호」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].sub_transaction_nostring | number | boolean | object | array | null기관의 「SUB거래번호」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].cms_codestring | null기관의 「CMS코드」 값입니다. 기관이 준 값을 바꾸지 않고 담습니다.
rows[].transaction_datetimestring | null거래 일시입니다. 거래 일자와 시각을 합친 YYYY-MM-DDTHH:MM:SS 모양의 문자열이며 시간대 표기는 없습니다. 일자나 시각을 읽을 수 없으면 null 입니다.
rows[].raw_fieldsobject기관이 준 거래 한 줄의 원본 객체입니다. 칸 이름은 기관 쪽 이름이고, include_raw 와 상관없이 담깁니다.
rows_rawarray기관이 준 거래 줄의 원본 목록입니다. include_raw 가 false 이면 빈 배열입니다.
continuationobject이어받기 정보입니다. 지금 조회 경로는 쪽을 이어받지 않으므로 아래 네 칸의 값이 늘 같습니다.
continuation.requested_pagesnumber기관에 요청한 쪽 수입니다. 지금 조회 경로에서는 항상 0 입니다.
continuation.has_moreboolean이어받을 거래가 더 남았는지를 나타냅니다. 성공 응답에서는 항상 false 입니다.
continuation.next_transaction_nostring마지막 쪽을 받을 때 쓴 이어받기 번호입니다. 지금 조회 경로에서는 항상 빈 문자열입니다.
continuation.next_sub_transaction_nostring마지막 쪽을 받을 때 쓴 이어받기 SUB 번호입니다. 지금 조회 경로에서는 항상 빈 문자열입니다.
raw_field_mapobject기관 원본 응답에서 거래 줄과 계좌 요약이 있는 위치를 가리키는 객체입니다. 지금 조회 경로에서는 raw 가 null 이라 가리키는 원본이 결과에 없습니다.
raw_field_map.rowsstring거래 줄(rows_raw)이 들어 있는 기관 응답 안의 위치입니다.
raw_field_map.accountstring계좌 요약의 원본이 들어 있는 기관 응답 안의 위치입니다.
rawobject | null기관 응답 원본입니다. 지금 조회 경로에서는 include_raw 와 관계없이 null 입니다.
raw.responsesarray쪽마다 받은 기관 응답 원본의 목록입니다. 지금 조회 경로에서는 raw 가 null 이라 오지 않습니다.
json
// result.data - 값 자리에는 각 칸의 형식을 적었습니다 (실제 값이 아닙니다)
{
  "success": "<boolean>",
  "account_link_id": "<string>",
  "query": {
    "bank_account_credential_id": "<string>",
    "masked_account_no": "<string>",
    "start_date": "<string>",
    "end_date": "<string>",
    "sort_order": "<string>"
  },
  "account": {
    "account_no": "<string>",
    "account_no_display": "<string>",
    "bank_type": "<기관이 준 값>",
    "legacy_account_no": null,
    "legacy_account_enabled": "<기관이 준 값>",
    "account_name": "<기관이 준 값>",
    "balance": "<number | null>",
    "balance_display": "<기관이 준 값>",
    "customer_name": "<기관이 준 값>",
    "withdrawable_amount": "<number | null>",
    "withdrawable_amount_display": "<기관이 준 값>",
    "open_date": "<string | null>",
    "open_date_display": "<기관이 준 값>",
    "branch_name": "<기관이 준 값>",
    "final_transaction_date": "<string | null>",
    "final_transaction_date_display": "<기관이 준 값>",
    "continuation_start_no": "<기관이 준 값>",
    "continuation_sub_start_no": "<기관이 준 값>",
    "has_transaction_history_flag": "<기관이 준 값>",
    "query_start_date": "<string | null>",
    "query_start_date_display": "<기관이 준 값>",
    "query_end_date": "<string | null>",
    "query_end_date_display": "<기관이 준 값>",
    "query_date": "<string | null>",
    "query_date_display": "<기관이 준 값>",
    "query_time": "<기관이 준 값>",
    "query_time_display": "<기관이 준 값>",
    "repeat_count": "<기관이 준 값>",
    "raw_fields": {}
  },
  "count": "<number>",
  "rows": [
    {
      "transaction_date": "<string | null>",
      "transaction_date_display": "<기관이 준 값>",
      "transaction_time": "<string | null>",
      "transaction_time_display": "<기관이 준 값>",
      "summary": "<기관이 준 값>",
      "withdrawal_amount": "<number | null>",
      "withdrawal_amount_display": "<기관이 준 값>",
      "deposit_amount": "<number | null>",
      "deposit_amount_display": "<기관이 준 값>",
      "description": "<기관이 준 값>",
      "balance": "<number | null>",
      "balance_display": "<기관이 준 값>",
      "branch_or_channel": "<기관이 준 값>",
      "inout_code": "<기관이 준 값>",
      "transaction_no": "<기관이 준 값>",
      "sub_transaction_no": "<기관이 준 값>",
      "cms_code": "<기관이 준 값>",
      "transaction_datetime": "<string | null>",
      "raw_fields": {}
    }
  ],
  "rows_raw": [],
  "continuation": {
    "requested_pages": "<number>",
    "has_more": "<boolean>",
    "next_transaction_no": "<string>",
    "next_sub_transaction_no": "<string>"
  },
  "raw_field_map": {
    "rows": "<string>",
    "account": "<string>"
  },
  "raw": {
    "responses": []
  }
}
순번오류 코드발생 조건
POLICY_FEATURE_DISABLED상품 실행 잠금 — 현재 이 상품은 일시 중지 상태라 요청을 처리하지 못했습니다. 다시 시도해도 해결되지 않으니 서비스문의로 알려 주세요. retryable=false.
PROVIDER_AUTH_FAILED로그인 실패 — 등록한 아이디와 비밀번호로 신한은행 인증에 실패했습니다. retryable=false.
VALIDATION_INVALID_FIELD계좌 자격증명 오류 — 조회에 쓸 계좌를 찾지 못했습니다. bank_account_credential_id 가 없는 계좌이거나, 이미 해제됐거나, 요청한 연동(account_link_id)의 계좌가 아닌 경우이고, 연동한 계정을 찾지 못한 경우도 같은 코드입니다. error.provider_error_ref 는 shinhan_easy.bank_account_credential 입니다. retryable=false - error.message 가 안내하는 대로 계좌 목록에서 계좌를 다시 선택하거나 계정을 먼저 연동한 뒤 다시 요청합니다.
VALIDATION_INVALID_FIELD입력값 오류 — 보낸 값이 이 액션의 요청 형식과 맞지 않습니다. 필수 칸이 빠졌거나 타입이나 범위가 맞지 않는 경우입니다.
VALIDATION_INVALID_FIELD조회 기간 초과 — start_date 가 오늘(한국 시각)로부터 6개월 전보다 앞서면 기관에 묻기 전에 거절합니다. 기간을 좁혀 다시 요청합니다. retryable=false.
VALIDATION_INVALID_FIELD고른 계좌 없음 — bank_account_credential_id 로 고른 계좌를 기관 화면의 계좌 목록에서 찾지 못해 거래내역을 열지 않았습니다. error.provider_error_ref 는 shinhan_easy.invalid_params.SHINHAN_RUNNER_ACCOUNT_NOT_IN_LIST 입니다. 재시도 불가로 표시됩니다(retryable=false) - 같은 요청을 다시 보내도 같은 목록이라 결과가 같습니다. error.message 안내대로 계좌번호를 확인하고 계좌 목록 조회에서 계좌를 다시 고릅니다.
VALIDATION_INVALID_FIELD고른 계좌가 열리지 않음 — 기관에서 열린 계좌가 고른 계좌와 달라, 다른 계좌의 거래가 고른 계좌 이름으로 나가지 않도록 조회 결과를 돌려주지 않았습니다. error.provider_error_ref 는 shinhan_easy.invalid_params.SHINHAN_RUNNER_ACCOUNT_NOT_FIRST 입니다. 재시도 불가로 표시됩니다(retryable=false). 이유와 조회할 수 있는 계좌는 error.message 가 그대로 알려 줍니다.
PROVIDER_UNAVAILABLE그 밖의 오류 — 그 밖의 신한은행 오류입니다. retryable=true 로 표시되지만 원인이 값 자체라면 재시도로 풀리지 않습니다 - 메시지를 먼저 확인합니다.